Folksonomy Engine: Difference between revisions

From Open Food Facts wiki
(edits about current progress)
Tags: Mobile edit Mobile web edit
 
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
The goal of '''Folksonomy engine''' is to unleash an ocean of new usages regarding food knowledge. Folksonomy engine allows all kind of people — citizens, researchers, journalists, professionals, artists, communities, innovators... — to enrich and use Open Food Facts, thanks to '''free tags and properties''' for your own use or to enrich the shared knowledge. Open Food Facts, as the biggest open-food database in the world, already feeds hundreds of data reuses. It will allow thousands of new apps and new usages.
[[Category:Folksonomy Engine]]
[[Category:Roadmap]]
 
{{Project|title=Folksonomy Engine|description=The goal of '''Folksonomy engine''' is to unleash an ocean of new usages regarding food knowledge. Folksonomy engine allows all kind of people — citizens, researchers, journalists, professionals, artists, communities, innovators... — to enrich and use Open Food Facts, thanks to '''free properties''' for your own use or to enrich the shared knowledge. Open Food Facts, as the biggest open-food database in the world, already feeds hundreds of data reuses. It will allow thousands of new apps and new usages.
 
Folksonomy engine project was partly funded by [https://nlnet.nl/discovery/ NLnet Search and Discovery program]|what=<br>
# An [https://api.folksonomy.openfoodfacts.org/docs API] to allow save/retry/modify property/value pairs for each product.<br>
# A user interface to for the end user, integrated to Open Food Facts.|why=unleash new usages with free properties for each product|status=<br>
# [https://api.folksonomy.openfoodfacts.org/docs Folksonomy Engine API] is up and running.<br>
# Folksonomy Engine user interface is currently tested by Open Food Facts administrators. There also a [https://github.com/openfoodfacts/folksonomy_frontend simpler interface] that can be installed as a user script.|needs=<br>
# more use cases to better understand how it will improve Open Food Facts
# dev contributors to improve UI|timeline=<br>
* 2021: project launched
* 2021-10: Folksonomy Engine API works
* 2021-11: Folksonomy Engine UI|people=<br>
* Project owner: Charles Nepote; Lucas Huber at the beginning of the project
* API dev: Christian Quest
* Product Opener integration: Charles Nepote
* With the help of: Stephane, Pierre, Alex, Tacite, ...}}


== Documentation and communication ==
== Documentation and communication ==
* [https://docs.google.com/document/d/1ADMs4ngCaz0qaw1HGdLCywyuAfB8cxhCfK9yQqI7dao/ Short presentation] (4 pages)
* [https://docs.google.com/document/d/1ADMs4ngCaz0qaw1HGdLCywyuAfB8cxhCfK9yQqI7dao/ Short presentation] (4 pages) [old documentation, to be modified]
* https://docs.google.com/document/d/1vYOAXGCatRx_wThW-JvOiM7P6VIIlweXr4uCOAhvEgU/ Folksonomy Whitepaper
* Project document Wiki page. (This current document)
* Project document Wiki page. (This current document)


Other directories/documents (if any)
Other directories/documents (if any)
* [https://drive.google.com/drive/u/0/folders/1U7OkC6ZTg3kk_3w5mPGnb1cl5mStFqBQ Main directory for documentation]
* [https://drive.google.com/drive/folders/1-Dvs8hqVkHFsPqFSGl_7Pdn36hPp7WyJ?usp=drive_link Main directory for presentation, description, documentation...]
Code and bug tracking on Github:


Slack channel: [https://app.slack.com/client/T02KVRT1Q/C01M1T2E8L8/thread/C0116U37JCE-1611738330.008000 #folksonomy_engine]
* [https://github.com/openfoodfacts/folksonomy_engine Folksonomy Engine repo]: this repository centralise issues and discussions dedicated to the whole project


== Who ==
* [https://github.com/openfoodfacts/folksonomy_api Folksonomy Engine API repo]
Skills needed (in short)
* [https://github.com/openfoodfacts/folksonomy_frontend Folksonomy Engine frontend repo]
* Project management
* Dev


Project team:
 
* Project manager: Lucas
== Get in touch ==
* Project owner: Charles
{{Box
* End-user tester: ?
| 1    =  Slack channel
* Dev: Stéphane
| 2    =  [https://openfoodfacts.slack.com/messages/C01M1T2E8L8/ #folksonomy_engine]
* Others?
}}


== Use cases ==  
== Use cases ==  
​ 1.​ Health and food safety
# ​ Health and food safety
2.​ Cooking and preparation
# ​ Cooking and preparation
  3​. Grocery Apps
# Grocery Apps
  4​. Product qualities
# Product qualities
  5​. (Bad) Food Marketing
# (Bad) Food Marketing
​  5.1.​ List properties of products targeting particular people
## ​List properties of products targeting particular people
  5.2.​ List properties of products related to consumers behavior
## ​List properties of products related to consumers behavior
 
See, [[Folksonomy Engine/Uses cases|some use cases]] we are starting to investigate.
 
We also have investigated separately [[Folksonomy Engine/Mobile use cases|mobile use cases]], as they allow very different kind of things.


== How ==
== How ==
Needed deliverables.


As of today, Open Food Facts is made of a set of predefined properties (about 20 types of properties such as the product name, the product weight, the ingredients, the nutrients, etc.).
Folksonomy engine is adding several kinds of new individual data properties to Open Food Facts or Open Products Facts. In fact, the scope of such new data properties is nearly endless, so we intend to get feedback from the community to define which one we should implement and how the user interface should look like.
Properties, or material facts, allows to specify a value or multiple values for the corresponding product.
Example: This product height is 35 cm, which ends up in a tag like [height = 35cm].
Sometimes a property can have multiple values:
Example:  This product has to be recalled if produced on 2020-03-31, 2020-04-01, 2020-04-02.
[Recall: if produced from 2020-03-31 - 2020-04-02]
== Wishful deliverables ==
Here we put wishful deliverables if any.
* Tool to monitor tag usages.
* Workshop for contributors.
== Questions/ideas ==
* What about a deliverable dedicated to communication?
* Use case in collaboration with scientists?
== Archives ==
Old timeline.
{| class="wikitable"  
{| class="wikitable"  
|- style="background-color:#c0c0c0;"
|- style="background-color:#c0c0c0;"
Line 49: Line 91:
|-
|-
| D2. Functional and technical specifications (''architecture design'') (report in wiki page)
| D2. Functional and technical specifications (''architecture design'') (report in wiki page)
| Feb.
 
| XX
* [[Folksonomy Engine/Functional use cases and specifications|Functional use cases and specifications]].
* [[Folksonomy Engine/Technical specifications|Technical specifications]].
| September
| Charles
Stéphane (Review)
Stéphane (Review)
|  
|  
Line 58: Line 103:
* CRUD interfaces in the backend (Product Opener)
* CRUD interfaces in the backend (Product Opener)
* web interfaces (in production)
* web interfaces (in production)
| March-April
| September
| Stéphane (dev)
| Christian (dev)
XX (tests)
Charles (tests)
|  
|  
|-
|-
Line 83: Line 128:
|  
|  
|}
|}
 
[[Category:Project]]
== Wishful deliverables ==
Here we put wishful deliverables if any.
* Tool to monitor tag usages.
* Workshop for contributors.
 
== Questions/ideas ==
* What about a deliverable dedicated to communication?
* Use case in collaboration with scientists?

Latest revision as of 08:23, 12 August 2024


Folksonomy Engine

Summary

The goal of Folksonomy engine is to unleash an ocean of new usages regarding food knowledge. Folksonomy engine allows all kind of people — citizens, researchers, journalists, professionals, artists, communities, innovators... — to enrich and use Open Food Facts, thanks to free properties for your own use or to enrich the shared knowledge. Open Food Facts, as the biggest open-food database in the world, already feeds hundreds of data reuses. It will allow thousands of new apps and new usages.

Folksonomy engine project was partly funded by NLnet Search and Discovery program

Description

Status:

  1. Folksonomy Engine API is up and running.
  2. Folksonomy Engine user interface is currently tested by Open Food Facts administrators. There also a simpler interface that can be installed as a user script.

People: {{{who}}}

Impact (why)

{{{impact_why}}}

Expected outcomes (what)

{{{expected_outcomes_what}}}

Timeline


  • 2021: project launched
  • 2021-10: Folksonomy Engine API works
  • 2021-11: Folksonomy Engine UI

Resources / Contributing

{{{contributing}}}

{{{resources}}}

Archives


Documentation and communication

  • Short presentation (4 pages) [old documentation, to be modified]
  • Project document Wiki page. (This current document)

Other directories/documents (if any)

Code and bug tracking on Github:


Get in touch

Slack channel

Use cases

  1. ​ Health and food safety
  2. ​ Cooking and preparation
  3. Grocery Apps
  4. Product qualities
  5. (Bad) Food Marketing
    1. ​List properties of products targeting particular people
    2. ​List properties of products related to consumers behavior

See, some use cases we are starting to investigate.

We also have investigated separately mobile use cases, as they allow very different kind of things.

How

As of today, Open Food Facts is made of a set of predefined properties (about 20 types of properties such as the product name, the product weight, the ingredients, the nutrients, etc.). Folksonomy engine is adding several kinds of new individual data properties to Open Food Facts or Open Products Facts. In fact, the scope of such new data properties is nearly endless, so we intend to get feedback from the community to define which one we should implement and how the user interface should look like.

Properties, or material facts, allows to specify a value or multiple values for the corresponding product.

Example: This product height is 35 cm, which ends up in a tag like [height = 35cm].

Sometimes a property can have multiple values:

Example: This product has to be recalled if produced on 2020-03-31, 2020-04-01, 2020-04-02. [Recall: if produced from 2020-03-31 - 2020-04-02]

Wishful deliverables

Here we put wishful deliverables if any.

  • Tool to monitor tag usages.
  • Workshop for contributors.

Questions/ideas

  • What about a deliverable dedicated to communication?
  • Use case in collaboration with scientists?

Archives

Old timeline.

Deliverable Date Who Comments
D1. Ideation document: uses cases (report in wiki page)
  • define first use cases (see D6)
Feb. XX
D2. Functional and technical specifications (architecture design) (report in wiki page) September Charles

Stéphane (Review)

D3. Server-side implementation (database and web UI): properties’ database implementation and CRUD interfaces with a minimal UI to validate the design:
  • database implementation (new database or new fields)
  • CRUD interfaces in the backend (Product Opener)
  • web interfaces (in production)
September Christian (dev)

Charles (tests)

D4. Search and discovery integration and APIs.
Making properties accessible using simple search and a discovery engine; integration with the advanced search; API access
  • all dev in the backend
April-May Stéphane (dev)

XX (tests)

D5. Mobile UI integration on the Open Food Facts apps June XX
D6. Three uses cases:
  1. move ambiguous “Nutriscore Experiment” labels in tags
  2. XXXX (to be found)
  3. XXXX (to be found)
Sep. XX