Platform for producers - Cheatsheet

Some details about the internals of the Producers Platform that can be of interest to admins and developers.

Introduction to the Producers Platform

On the Producers Platform, each food manufacturer can have its own mini Open Food Facts with only its products.

Producers can:

• import product data and photos in a variety of ways
• get reports on data quality and product quality (and even suggestions on how they could improve it)
• publish their product data and photos in the public Open Food Facts database

How it works

Organizations

Users on Open Food Facts can declare themselves as professional users representing a company or brand. They can associate their account with an organization (only one) by editing their profile (or when they create their account).

If the organization does not exist yet, it is created right away. Otherwise, an e-mail is sent to the producers platform admins, and admins can edit the user profile to add him/her to the organization.

There isn't currently a user management system to allow the creators of organization to manage users, review and accept requests by other users to join their organization, or invite other users.

Importing data and photos to the producers platform

GS1 GSDN imports

Mapping of GS1 organization identifiers (GLN, Party Name) to OFF organizations

In GS1 data, organizations are identified with a GLN, that is associated to a "party name".

GS1 product data often has organizations identified as the "brand owner" and/or as the "information provider".

e.g.

      "brandOwner" : {
         "gln" : "3010836800139",
         "partyName" : "BONDUELLE SAS"
      },
      "informationProviderOfTradeItem" : {
         "gln" : "3010836800139",
         "partyName" : "BONDUELLE EUROPE LONG LIFE"
      },

We currently use the informationProviderOfTradeItem if it is present and not empty.

By default, we map the party name to create the OFF organization id. e.g. "BONDUELLE EUROPE LONG LIFE" becomes org-bonduelle-europe-long-life.

In practice, some GS1 data may have different party names for the same GLN (e.g. the CodeOnline data above), and some big organizations have different GLNs for different lines of products.

Admins of the producers platform can edit organization profiles to list the different GLNs that the organization should be associated with.

Exporting data and photos from the producers platform to the public database

Data sources

Data sources are available in the product JSON and can be listed through the /data-sources facet.

Product owners

Owners are available in the product JSON and can be listed through the /owners facet.

In the public database, the owner field is imported from the producers platform only for organizations that correspond to producers. It is not kept when the owner is an user, or an organization that corresponds to a label or an external database (e.g. org-label-biopartenaire or org-database-usda).

Technical details

The producers platform is a separate instance of Product Opener. It differs from the public instance in that products are always associated with 1 owner, which can be an organization or an user.

The owners thare users are only used in very rare instances, e.g. for users that need to import a lot of product photos that they took.

The owner id is of the form org-organization-id or user-user-id (e.g. org-nestle-france or user-stephane).

For each product, the owner id is stored in the "owner" field, and in the "owners_tags" array (with only one entry). The "owners_tags" field is used to make the /owners facet work without extra code (this may change in the future).

Each product is stored in /srv/off-pro/products/[owner-id]/ (instead of /srv/off/products/ on the public platform). Similarly, images are in /srv/off-pro/html/images/products/[owner-id]/.