# Movyneo — Open Food Facts derivative database

This repository contains the Open Food Facts–derived portion of the product
database shipped inside the **Movyneo** iOS app. It is published under the
Open Database License (ODbL) v1.0, as required by §4.6: if you publicly use a
Produced Work made from a Derivative Database, you must also offer recipients a
machine-readable copy of that Derivative Database.

So this is not a gesture — it is the licence working as intended.

## Licence

This database is licensed under **ODbL v1.0**. Full text: [`LICENSE.txt`](LICENSE.txt).

    Contains information from Open Food Facts (https://world.openfoodfacts.org),
    which is made available under the Open Database License (ODbL) v1.0.

You may use, modify and redistribute this data. In return: attribute the source
(§4.2), license your derivatives alike (§4.4), and do not restrict access with
technological measures (§4.7).

## Contents

| File | Rows | Description |
|---|---|---|
| `foods.csv.gz` | 42,989 | Products with nutrition values per 100 g |
| `barcodes.csv.gz` | 42,989 | Barcode → product mapping |
| `portions.csv.gz` | 79,465 | Portion definitions (name, grams, default flag) |

Checksums and provenance: `MANIFEST.json`.

## Scope — what is here, what is not

**Included:** Open Food Facts–sourced records only (`source = 'off'`).

**Excluded:** USDA FoodData Central records (US public domain, not subject to
ODbL) and the app's own recipe content (original work). Mixing them in would
present non-ODbL data as if it were ODbL-licensed.

**Our own enrichments are included** — we populated the `category` and
`search_terms` columns and they are left in. §4.6 asks for the derivative
database "including any additional Contents"; withholding our enrichment would
defeat the purpose of share-alike.

Two columns are deliberately absent: `source` (constant `off`) and `popularity`
(zero on every OFF row, never populated).

## Honest notes about the data

- **Nutrition values are per 100 g/ml.** `nutrients_json` carries micronutrients;
  its keys follow the app's internal schema, not Open Food Facts'.
- **Accuracy is not guaranteed.** Open Food Facts is crowd-sourced; entries may
  be incomplete or wrong. `micro_coverage` (0–1) indicates micronutrient
  completeness, `trust` indicates the record class.
- **Not suitable for medical use.**
- Records are market-specific: the `locale` column shows where a record came from.

## Updates

The app's database is rebuilt for each release, and this package is regenerated
with it. The generator lives in the app repository:
`tools/food-pipeline/export_odbl.py`.

## Upstream

Open Food Facts — https://world.openfoodfacts.org
To contribute or correct a product, write to them directly; corrections flow
into the next package.

---

Generated 2026-08-12 · database version 1 ·
[Türkçe](README.tr.md)