chore: initial import

2026-07-24 21:37:03 +02:00
commit 45bc449ea0
53 changed files with 12329 additions and 0 deletions
@@ -0,0 +1,53 @@
+# Einheiten-Umrechnungen (nach Gramm)
+
+Sorgt dafür, dass jede Zutat, die in Rezepten mit einer Nicht-Gramm-Einheit
+vorkommt (z. B. „Stück“, „EL“, „ml“, „Prise“), eine Umrechnung **nach Gramm**
+bekommt. Gramm ist die gemeinsame Basis — steht die einmal, kann Tandoor
+zwischen allen Einheiten hin- und herrechnen und Mengen korrekt skalieren und
+auf die Einkaufsliste bringen.
+
+## Ablauf
+
+1. **Prüfen** sucht die Gramm-Einheit („g“), liest die vorhandenen Umrechnungen
+   und alle Rezepte und ermittelt, welche Zutat mit welchen Einheiten benutzt
+   wird. Geprüft wird, ob eine Einheit — auch mehrstufig über vorhandene
+   Umrechnungen — bei Gramm ankommt. Kandidat wird, was das NICHT tut:
+   * Einheiten, die in Rezepten vorkommen und keinen Weg zu Gramm haben.
+   * Einheiten aus bereits vorhandenen Umrechnungen, deren „Kette“ nirgends bei
+     Gramm endet (z. B. „1 Stück = 3 EL“, aber weder Stück noch EL kennt Gramm) —
+     diese werden ebenfalls an Gramm angebunden.
+   Kann eine Einheit Gramm schon erreichen (direkt oder über eine Kette), wird
+   nichts doppelt angelegt. Reine Gewichtseinheiten (kg, mg, Pfund …) werden
+   übersprungen — die rechnet Tandoor ohnehin um.
+2. **Werte vorschlagen** (ChatGPT) schätzt, wie viel Gramm eine typische Menge
+   wiegt (z. B. „1 Stück Zwiebel ≈ 110 g“, „1 EL Öl ≈ 9 g“).
+3. Du prüfst und passt an — Ausgangsmenge und Gramm-Gewicht sind editierbar.
+4. **Anlegen** legt die Umrechnungen in Tandoor an. Über **Sicherungen** lässt
+   sich jeder Lauf zurückspielen (die angelegten Umrechnungen werden gelöscht).
+
+## Wichtig: Schätzwerte
+
+Die KI-Werte sind **Schätzungen** für typische Größen. Tandoor rechnet damit
+Rezepte und Einkaufslisten hoch — falsche Werte pflanzen sich fort. Deshalb
+immer prüfen, bevor du sie anlegst.
+
+## Voraussetzung
+
+In Tandoor muss es eine Einheit **„g“** geben. Fehlt sie, meldet das Werkzeug
+das und legt nichts an — dann zuerst in Tandoor eine Gramm-Einheit anlegen.
+
+## Sicherheit
+
+* Zutat und Einheit stehen fest (immer nach Gramm) — die Oberfläche kann nichts
+  Fremdes unterschieben; editierbar sind nur die beiden Mengen.
+* Angelegte Umrechnungen sind über die Sicherungen wieder löschbar.
+
+## Kommandozeile
+
+```
+conversions.py pruefen
+conversions.py vorschlagen --plan <datei>
+conversions.py anwenden   --plan <datei> [--apply]
+conversions.py zurueck    --lauf <ordner> [--apply]
+conversions.py probe
+```