Privates Rezeptarchiv von Hans Döbel, auf Deutsch. Jedes Rezept ist eine Markdown-Datei. Eine SQLite-Datenbank baut daraus Wochenplan und Einkaufsliste.
rezepte/ eine Datei pro Rezept
db/schema.sql Tabellen, Einheiten, View für die Einkaufsliste
db/seed.sql Daten, im Gleichschritt mit den Markdown-Dateien
db/shopping_list.sql Beispielabfrage für den hinterlegten Wochenplan
db/build_db.py erzeugt db/kochbuch.sqlite und druckt die Liste
db/README.md Schema und der Weg nach Postgres/Neon
AGENTS.md Regeln für neue Rezepte
db/kochbuch.sqlite wird nicht eingecheckt. Sie lässt sich jederzeit aus den SQL-Dateien neu bauen, und eine Binärdatei würde das Repo aufblähen und sich schlecht zusammenführen lassen. Bilder und andere Binärdateien sind über .gitignore ausgeschlossen.
rezepte/<slug>.mdnachAGENTS.mdanlegen. Die Original-Rezeptseite prüfen; Urheber, Website und direkte URL identisch insourceundrecipes.sourceerfassen. Unter dem Titel einen sichtbaren Quellenlink setzen. Bei nicht öffentlichen Quellen die tatsächliche Herkunft nennen, keine URL erfinden.- Dieselben Angaben in
db/seed.sqlergänzen: Rezept, Zutatenzeilen, Tags. Vorhandene Zutaten wiederverwenden. - Datenbank neu bauen und die Einkaufsliste prüfen:
python3 db/build_db.py --checkOhne --check druckt das Skript die Liste für den Beispielzeitraum (16.–22. November 2026). Ein anderer Zeitraum:
python3 db/build_db.py 2026-11-16 2026-11-22
python3 db/build_db.py 2026-11-16 2026-11-22 --ohne-vorrat--ohne-vorrat lässt Zutaten weg, die im Haushalt meist schon da sind (Salz, Mehl, Zucker, Staubzucker).
Dieselbe Abfrage direkt in SQLite, nachdem die Datei erzeugt wurde:
sqlite3 -header -column db/kochbuch.sqlite < db/shopping_list.sqlEin Eintrag im Wochenplan nennt Datum, Mahlzeit, Rezept und die gewünschten Portionen. Die View v_meal_plan_lines rechnet die Mengen mit gewünschte Portionen / Rezeptportionen um. Die Beispielabfrage summiert danach pro Zutat, Variante und Einheit und gruppiert nach Supermarkt-Abteilung.
Der hinterlegte Plan enthält Kaiserschmarrn für 2 Personen am 16. November 2026. Feinkristallzucker steht zweimal im Rezept (30 g im Teig, 50 g zum Karamellisieren) und erscheint auf der Liste als 80 g.
Schema, Einheiten, nicht numerische Angaben und der Umzug auf Postgres (zum Beispiel Neon) stehen in db/README.md.
Die Original-Rezeptdaten von Rainbow Plant Life, Babish und Joshua Weissman stehen unter quellen/. Abdeckung, Unterschiede zu den deutschen Kochbuch-Rezepten und die Wiederholung des Abrufs sind in quellen/README.md dokumentiert. Die ersten fünf Rainbow-Plant-Life-Rezepte sind außerdem auf Deutsch in rezepte/ und in der Zutaten-Datenbank erfasst.
Offline prüfen:
python3 scripts/check_sources.py
python3 -m unittest discover -s scripts -v
python3 db/build_db.py --checkGitHub Actions führt bei jedem Pull Request und bei Änderungen auf main vier unabhängige Prüfungen parallel aus: Markdown-Formatierung mit markdownlint-cli2, Rezeptformat samt Quellen und Datenbankabgleich, Integrität des Quellenarchivs und Regressionstests. Fehler in einem Job brechen die anderen nicht ab. Diese Regeln werden vom Code durchgesetzt und benötigen keine Agenten- oder Skill-Anweisungen. Husky-Hooks sind nicht nötig.
Node.js 24 und Python 3.10+ genügen für dieselben Prüfungen lokal:
npm ci --ignore-scripts
npm run lint
npm testnpm run lint führt die drei Linter parallel aus und meldet einen Fehler, sobald mindestens eine Prüfung fehlschlägt. Einzeln laufen sie über npm run lint:markdown, npm run lint:recipes und npm run lint:sources. Die Markdown-Regeln stehen in .markdownlint-cli2.jsonc; das Rezeptformat wird in scripts/lint_recipes.py geprüft. Online-Rezepte brauchen eine direkte HTTPS-Quelle und denselben sichtbaren Link. Eigene Rezepte, Fotos und Familienrezepte müssen ihre nicht öffentliche Herkunft ausdrücklich nennen. Die vorhandene Kaiserschmarrn-Transkription hat eine eng begrenzte Ausnahme für ihre belegte Quelle ohne nachweisbare URL.