Changes

Jump to navigation Jump to search
m
no edit summary
Line 2: Line 2:     
= Server-side =
 
= Server-side =
   
<span id="a-new-api-simplify-and-unify-the-open-food-facts-api-used-by-200-apps"></span>
 
<span id="a-new-api-simplify-and-unify-the-open-food-facts-api-used-by-200-apps"></span>
 
=== A New API: Simplify and unify the Open Food Facts API used by 200+ apps ===
 
=== A New API: Simplify and unify the Open Food Facts API used by 200+ apps ===
   
<span id="description"></span>
 
<span id="description"></span>
 
==== Description ====
 
==== Description ====
   −
Open Food Facts provides a free and open API to read, search and write products data and photos. This API powers more than 200 apps developed by 3rd parties, and is also used by many tools like our AI platform Robotoff and our power contribution tool Hunger Games. Our API is unfortunately very difficult to understand and use as it evolved organically in the last 10 years. It's not 1 API in fact, it's several APIs to do different things, and we have multiple versions of those APIs, each with a different state of features and documentation. This project aims to bring &quot;A New API&quot; to our many reusers. An API that is simple, unified, easy to understand and use, well documented (with OpenAPI) and well tested.
+
Open Food Facts provides a free and open API to read, search and write products data and photos. This API powers more than 200 apps developed by 3rd parties, and is also used by many tools like our AI platform Robotoff and our power contribution tool Hunger Games. Our API is unfortunately very difficult to understand and use as it evolved organically in the last 10 years. It's not 1 API in fact, it's several APIs to do different things, and we have multiple versions of those APIs, each with a different state of features and documentation. This project aims to bring &quot;A New API&quot; to our many reusers. An API that is simple, unified, easy to understand and use, well documented (with OpenAPI) and well tested.<span id="expected-outcomes"></span>
 
  −
<span id="expected-outcomes"></span>
   
==== Expected outcomes ====
 
==== Expected outcomes ====
   Line 17: Line 13:     
This project is about revisiting one by one all existing APIs to:
 
This project is about revisiting one by one all existing APIs to:
 
+
# Decide which feature should be added, changed (or maybe even removed)
<ol style="list-style-type: decimal;">
+
# Define the API for each feature (e.g. method, path, parameters, query and response headers and bodies etc.) and document it using OpenAPI. (This step is critical to ensure that the API will be both useful and used, and will need to be done in coordination with existing users of the API.)
<li><blockquote><p>Decide which feature should be added, changed (or maybe even removed)</p></blockquote></li>
+
# Implement the API for the feature and add integration tests for it
<li><blockquote><p>Define the API for each feature (e.g. method, path, parameters, query and response headers and bodies etc.) and document it using OpenAPI.<br />
  −
This step is critical to ensure that the API will be both useful and used, and will need to be done in coordination with existing users of the API.</p></blockquote></li>
  −
<li><blockquote><p>Implement the API for the feature and add integration tests for it</p></blockquote></li></ol>
      
APIs that needs to be converted to API v3:
 
APIs that needs to be converted to API v3:
   −
<ul>
+
* Product image upload, selection and crop
<li><blockquote><p>Product image upload, selection and crop</p></blockquote></li>
+
* Full support for product write (should be done incrementally)
<li><blockquote><p>Full support for product write (should be done incrementally)</p></blockquote></li>
+
* Search
<li><blockquote><p>Search</p></blockquote></li>
+
* Taxonomy read
<li><blockquote><p>Taxonomy read</p></blockquote></li>
+
* User creation and profile edition
<li><blockquote><p>User creation and profile edition</p></blockquote></li>
+
* Authentification<span id="project-information"></span>
<li><blockquote><p>Authentification</p></blockquote></li></ul>
  −
 
  −
<span id="project-information"></span>
   
==== Project information ====
 
==== Project information ====
 
+
* repository: [https://github.com/openfoodfacts/openfoodfacts-server <u>https://github.com/openfoodfacts/openfoodfacts-server</u>]
<ul>
+
* Slack channels: #product-opener
<li><blockquote><p>repository: [https://github.com/openfoodfacts/openfoodfacts-server <u>https://github.com/openfoodfacts/openfoodfacts-server</u>]</p></blockquote></li>
+
* Potential mentors: Stéphane, Alex
<li><blockquote><p>Slack channels: #product-opener</p></blockquote></li>
+
* Project duration: 350 hours
<li><blockquote><p>Potential mentors: Stéphane, Alex</p></blockquote></li>
+
* Skills required: Perl
<li><blockquote><p>Project duration: 350 hours</p></blockquote></li>
+
* Difficulty rating: Medium
<li><blockquote><p>Skills required: Perl</p></blockquote></li>
  −
<li><blockquote><p>Difficulty rating: Medium</p></blockquote></li></ul>
      
<span id="bring-taxonomy-editor-to-a-fully-usable-tool"></span>
 
<span id="bring-taxonomy-editor-to-a-fully-usable-tool"></span>
 
=== Bring Taxonomy editor to a fully usable tool ===
 
=== Bring Taxonomy editor to a fully usable tool ===
   
<span id="description-1"></span>
 
<span id="description-1"></span>
 
==== Description ====
 
==== Description ====
Line 57: Line 44:  
While effective for the application, this format is quite cumbersome to edit for contributors.
 
While effective for the application, this format is quite cumbersome to edit for contributors.
   −
Taxonomy editor was started during last Google Summer of code. Thanks to the work of Aadarsh, we got a first demonstration of the product, and it’s been in continuous development since then. But a boost would be needed to make it a really usable project.
+
Taxonomy editor was started during last Google Summer of code. Thanks to the work of Aadarsh, we got a first demonstration of the product, and it’s been in continuous development since then. But a boost would be needed to make it a really usable project.<span id="expected-outcomes-1"></span>
 
  −
<span id="expected-outcomes-1"></span>
   
==== Expected outcomes ====
 
==== Expected outcomes ====
   Line 66: Line 51:  
From there, according to the pace of the projects many more features could be added which would be of great benefit: embarked assistance integrating tools (eg. searching / linking to wikidata, or wiktionary), integration of the products database (eg. seeing which entries need to be added or translated first), navigation in the taxonomy.
 
From there, according to the pace of the projects many more features could be added which would be of great benefit: embarked assistance integrating tools (eg. searching / linking to wikidata, or wiktionary), integration of the products database (eg. seeing which entries need to be added or translated first), navigation in the taxonomy.
   −
An important aspect: as this tool is meant to live a long time quality and maintainability of the project is important.
+
An important aspect: as this tool is meant to live a long time quality and maintainability of the project is important.<span id="project-information-1"></span>
 
  −
<span id="project-information-1"></span>
   
==== Project information ====
 
==== Project information ====
 
+
* repository: [https://github.com/openfoodfacts/taxonomy-editor/ <u>https://github.com/openfoodfacts/taxonomy-editor/</u>]
<ul>
+
* Slack channels: #taxonomy-editor
<li><blockquote><p>repository: [https://github.com/openfoodfacts/taxonomy-editor/ <u>https://github.com/openfoodfacts/taxonomy-editor/</u>]</p></blockquote></li>
+
* Potential mentors: Daniel, Alex
<li><blockquote><p>Slack channels: #taxonomy-editor</p></blockquote></li>
+
* Project duration: 350 hours
<li><blockquote><p>Potential mentors: Daniel, Alex</p></blockquote></li>
+
* Skills required: Reactjs / Python / Neo4j
<li><blockquote><p>Project duration: 350 hours</p></blockquote></li>
+
* Difficulty rating: Medium<span id="improve-our-producer-platform-to-the-next-level"></span>
<li><blockquote><p>Skills required: Reactjs / Python / Neo4j</p></blockquote></li>
  −
<li><blockquote><p>Difficulty rating: Medium</p></blockquote></li></ul>
  −
 
  −
<span id="section"></span>
  −
===  ===
  −
 
  −
<span id="section-1"></span>
  −
=== <br />
  −
===
  −
 
  −
<span id="improve-our-producer-platform-to-the-next-level"></span>
   
=== Improve our producer platform to the next level ===
 
=== Improve our producer platform to the next level ===
   Line 96: Line 68:  
Thanks to the support of the national French public health agency Santé Publique France, the platform is already alive and working. Though it is a bit rough for our users that are not tech savvy, also there are a lot of features which could help adoption and lessen the support needed to operate it.
 
Thanks to the support of the national French public health agency Santé Publique France, the platform is already alive and working. Though it is a bit rough for our users that are not tech savvy, also there are a lot of features which could help adoption and lessen the support needed to operate it.
   −
Technically the producer platform uses the same code base as the main website.
+
Technically the producer platform uses the same code base as the main website.<span id="expected-outcomes-2"></span>
 
  −
<span id="expected-outcomes-2"></span>
   
==== Expected outcomes ====
 
==== Expected outcomes ====
    
The project will bring many new features to the producer platform. Here are some of the current priorities: add more inline help, make UX more convenient, support advanced updates patterns on fields, add a workflow to product edition, connect to our internal CRM (allow automating many tasks), collect more statistics on usage, support more fields and format for data import, more robust import/publishing workflows and add more tests.
 
The project will bring many new features to the producer platform. Here are some of the current priorities: add more inline help, make UX more convenient, support advanced updates patterns on fields, add a workflow to product edition, connect to our internal CRM (allow automating many tasks), collect more statistics on usage, support more fields and format for data import, more robust import/publishing workflows and add more tests.
   −
Extended goals include adding rules to help producers make products with better Eco-score, advanced features to make editing products easier (like picture upload).
+
Extended goals include adding rules to help producers make products with better Eco-score, advanced features to make editing products easier (like picture upload).<span id="project-information-2"></span>
 
  −
<span id="project-information-2"></span>
   
==== Project information ====
 
==== Project information ====
 +
* presentation of the platform: https://world.pro.openfoodfacts.org/
 +
* repository: https://github.com/openfoodfacts/openfoodfacts-server/
 +
* Slack channels: #productopener
 +
* Potential mentors: Stephane, Alex
 +
* Project duration: 350 hours
 +
* Skills required: Perl
 +
* Difficulty rating: Medium
   −
<ul>
  −
<li><blockquote><p>presentation of the platform: https://world.pro.openfoodfacts.org/</p></blockquote></li>
  −
<li><blockquote><p>repository: https://github.com/openfoodfacts/openfoodfacts-server/</p></blockquote></li>
  −
<li><blockquote><p>Slack channels: #productopener</p></blockquote></li>
  −
<li><blockquote><p>Potential mentors: Stephane, Alex</p></blockquote></li>
  −
<li><blockquote><p>Project duration: 350 hours</p></blockquote></li>
  −
<li><blockquote><p>Skills required: Perl</p></blockquote></li>
  −
<li><blockquote><p>Difficulty rating: Medium</p></blockquote></li></ul>
  −
  −
<span id="section-2"></span>
  −
===  ===
  −
  −
<span id="section-3"></span>
  −
=== <br />
  −
===
  −
  −
<span id="data-quality-moderation-hub"></span>
   
=== Data Quality &amp; Moderation Hub ===
 
=== Data Quality &amp; Moderation Hub ===
   
<span id="description-3"></span>
 
<span id="description-3"></span>
 
==== Description ====
 
==== Description ====
Line 132: Line 89:  
Open Food Facts infrastructure is currently focused on reflecting the current state of the database, which is its primary goal. However, it would be beneficial to introduce a queue/backlog system to coordinate the efforts of users in data cleaning and moderation.
 
Open Food Facts infrastructure is currently focused on reflecting the current state of the database, which is its primary goal. However, it would be beneficial to introduce a queue/backlog system to coordinate the efforts of users in data cleaning and moderation.
   −
The system currently provides some level of coordination through the facets, indicating missing nutritional data and providing a list of products that need completion. However, this system lacks flexibility.
+
The system currently provides some level of coordination through the facets, indicating missing nutritional data and providing a list of products that need completion. However, this system lacks flexibility.<span id="expected-outcomes-3"></span>
 
  −
<span id="expected-outcomes-3"></span>
   
==== Expected outcomes ====
 
==== Expected outcomes ====
   Line 142: Line 97:     
<ol style="list-style-type: decimal;">
 
<ol style="list-style-type: decimal;">
<li><blockquote><p>select nutritional table image</p></blockquote></li>
+
* select nutritional table image
<li><blockquote><p>crop nutritional table image</p></blockquote></li>
+
* crop nutritional table image
<li><blockquote><p>fill nutriments</p></blockquote></li></ol>
+
* fill nutriments</ol>
    
The MVP would include a back-end with an API for moderation, providing a table with information such as barcode, image_id, type_of_problem, author (including Robotoff), and moderation status (has_been_moderated). The front-end would allow users to delete pictures and mark elements as moderated.
 
The MVP would include a back-end with an API for moderation, providing a table with information such as barcode, image_id, type_of_problem, author (including Robotoff), and moderation status (has_been_moderated). The front-end would allow users to delete pictures and mark elements as moderated.
    
The next steps would involve supporting questions from users and allowing moderators to answer them. This would include:
 
The next steps would involve supporting questions from users and allowing moderators to answer them. This would include:
 +
* Extending the database to save questions
 +
* Send emails with the answer from moderation interface
 +
* Add buttons in main website to send questions<span id="project-information-3"></span>
 +
==== Project information ====
 +
* repository: https://github.com/openfoodfacts/hunger-games/
 +
* Slack channels: #hunger-games #robotoff #data-quality
 +
* Potential mentors: Raphael, Charles, Pierre, Alex
 +
* Project duration: 350 hours
 +
* Skills required: PostgreSQL, Python, Frontend (React/ReactNative or Flutter)
 +
* Difficulty rating: Medium<span id="impact-metrics-for-open-food-facts"></span>
 +
=== Impact and contribution metrics for Open Food Facts ===
 +
 +
==== Description ====
 +
Open Food Facts is the hub of a lot of interactions: visitors, various re-use, contributions, data import, machine learning predictions and human validation, moderation, etc. We currently have different systems interacting together, but we strive at having precise and reliable real time indicators. We would like to improve metrics (specially on contributions) to be able to measure our global impact as well as news coverage or new features impacts but also to fuel other important features like gamification or moderation.
   −
<ul>
+
==== Expected Outcomes ====
<li><blockquote><p>Extending the database to save questions</p></blockquote></li>
+
The project is a bit of a patchwork of elements to assemble together but a very clear goal:
<li><blockquote><p>Send emails with the answer from moderation interface</p></blockquote></li>
+
 
<li><blockquote><p>Add buttons in main website to send questions</p></blockquote></li></ul>
+
* fix and upgrade openfoodfacts-events project to be really usable, it will be a very useful data source. Also extends its use in the existing tools, if relevant.
 +
* make openfoodfacts-server logs more significant events to either influxdb or to openfoodfacts-events
 +
* write and run scripts to import data from previous years (as much as possible)
 +
* build flexible and informative dashboards for the project
 +
* (stretch goal 1) bootstrap the gamification
 +
* (stretch goal 2) build a personal contributor dashboard
   −
<span id="project-information-3"></span>
   
==== Project information ====
 
==== Project information ====
 +
As the project involves several competences you will need to be a fast learner able to quickly crawl an existing project and documentations. Also you have to be motivated by the ultimate goal of all those metrics to be able to grasp the righ way of doing them.
 +
 +
* main repository: https://github.com/openfoodfacts/openfoodfacts-events
 +
* secondary repositories: https://github.com/openfoodfacts/openfoodfacts-server https://github.com/openfoodfacts/openfoodfacts-infrastructure/tree/develop/docker/metrics 
 +
* Slack channels: #productopener #gamification
 +
* Potential mentors: Vova, Alex, Stephane, Pierre
 +
* Project duration: 350 hours
 +
* Skills required (some might be learned): PostgreSQL, Python, InfluxDB,  Grafana, Perl
 +
* Difficulty rating: Easy
 +
<span id="mobile-side"></span>
 +
= Mobile-side =
 +
Coming soon
   −
<ul>
+
[[Category:GSOC]]
<li><blockquote><p>repository: https://github.com/openfoodfacts/hunger-games/</p></blockquote></li>
  −
<li><blockquote><p>Slack channels: #hunger-games #robotoff #data-quality</p></blockquote></li>
  −
<li><blockquote><p>Potential mentors: Raphael, Charles, Pierre, Alex</p></blockquote></li>
  −
<li><blockquote><p>Project duration: 350 hours</p></blockquote></li>
  −
<li><blockquote><p>Skills required: PostgreSQL, Python, Frontend (React/ReactNative or Flutter)</p></blockquote></li>
  −
<li><blockquote><p>Difficulty rating: Medium</p></blockquote></li></ul>
 
75

edits

Navigation menu