Lars/mitai-jinkendo
1
0
Fork 0
Code Issues 21 Pull Requests Actions Packages Projects Releases 5 Wiki Activity
c1873a47b1
mitai-jinkendo/.claude/docs/technical/BLS_FOOD_REFERENCE.md
Lars c1873a47b1
All checks were successful
Deploy Development / deploy (push) Successful in 1m4s
Details
Build Test / pytest-backend (push) Successful in 9s
Details
Build Test / lint-backend (push) Successful in 0s
Details
Build Test / build-frontend (push) Successful in 22s
Details
fix: Zuordnungen zuverlässig speichern und Mengen-Varianten zusammenfassen 
Mapping bleibt erhalten, auch wenn der Nährwert-Rebuild länger dauert. Offene Liste führt 1 ml/2 ml Olivenöl als ein Lebensmittel. Dazu JSON-Sicherung, eigener Katalogeintrag und Gramm-pro-Einheit.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-12 15:49:14 +02:00

2.3 KiB
Raw Blame History

BLS Food Reference – technische Spec

Stand: 2026-09-12 · Migration 062 + 063

Tabellen

  • food_attributes — dynamischer Stoff-/Merkmalskatalog (attr_key, data_type, origin)
  • food_catalog — Lebensmittel (bls_code UNIQUE bei official_bls; manuell ohne BLS-Code)
  • food_attribute_values — typisiertes EAV
  • food_name_mappings — FDDB-Name → food_id (User / global)
  • nutrition_items — Tagebuchzeilen inkl. logged_at
  • nutrition_daily_nutrients — Tages-Rollup numerischer Attribute
  • nutrition_day_marks — fasting | incomplete
  • food_recipes / food_recipe_ingredients — FDDB-Listen; nutrition_items.recipe_id

Layer 1

  • data_layer/food_mapping.py — Normalisierung, Lookup, Learn, Apply, Delete
  • data_layer/nutrition_items.py — Ingest, drei Makro-Summen, Policy, resolve_*_attributes
  • data_layer/food_recipes.py — Listen-Upsert, Link auf Tagebuchzeilen, Rezept-Makros (Skala: gegessen_g / Summe Zutaten, sonst 1/Portionen)
  • bls/recipe_parser.py — produkte-Feld: Split nur vor nächstem \d+ (g|kg|ml|l) (Kommas im Namen bleiben)

Import

BLS: Admin-Upload Components + Daten-XLSX (backend/bls/parser.py). Upsert über bls_code / attr_key, nie Delete+Insert offizieller Zeilen.

FDDB: Items persistieren; nutrition_log nur bei leerem Tag oder laut Policy / Bestätigung.

Router

  • /api/bls/* — Suche, eigene Foods, eigene Mappings
  • /api/admin/bls/* — Import, Katalog, Attribute
  • /api/admin/food-mappings — Admin-CRUD
  • /api/nutrition/* — Items, Unmapped, Bulk-Map, Marken, Konflikt-Resolve
  • GET /api/nutrition/recipes, POST /api/nutrition/recipes/import-fddb-lists, POST /api/nutrition/recipes/{id}/apply
  • Unmapped = Tagebuchzeilen ohne food_id/recipe_id plus Rezeptzutaten ohne Mapping
  • Frontend: FoodSearchModal (Name-Suche, eigener Eintrag, Gramm/Einheit), Listen-Import auf dem Tab Zuordnen
  • Mapping-Schreiben und Nährwert-Rebuild sind getrennte Transaktionen (Rebuild darf das Mapping nicht zurückrollen)
  • food_name_mappings.grams_per_unit / source_unit (Migration 064)
  • GET/POST /api/nutrition/food-knowledge — portable JSON (mitai-food-knowledge v1): manuelle Foods, Mappings (über bls_code / Name, keine UUIDs), Listen. Import löst Katalog auf dem Zielsystem auf (BLS muss dort importiert sein).