Doku-Archiv

Das zentrale, durchsuchbare Archiv für Silverscale Family Hub und die Lidl-Plus → Grocy-Pipeline. Hier liegen die technischen Dokumente, die Recherchen und die Testpläne an einem Ort — selbst gehostet auf dem VPS, im Look der App.

Dieses Archiv wird von docs/build.py aus dem Repo generiert. Dev-Dokus werden beim Build direkt aus den Quelldateien gesammelt (MANIFEST in build.py), Recherchen/Testpläne liegen als Quellen unter docs/content/.

Kategorien

🛠 Dev / LLM-Doku

Architektur-Entscheidungen (ADRs), Pipeline-Handoff, Runbook, iOS-Shell, Tagesreports, UI-Audits und die technischen Recherchen. Das ist die Wahrheit für jede neue Session.

🔬 Recherchen

Tiefenrecherchen zu Plattform- und Produktfragen: Apple Developer Program, Doku-Hosting, sowie das Design-Doc zu Mitteilungen/Vorrat/Live Activities (mit Mockups).

🧪 Testpläne

Die Gerätetest-Wellen für die iPhone-App (Phase 0+1, Welle 2, Welle 3) — als interaktive HTML-Artefakte.

👤 User-Doku

Hilfe für Familie Fisch in der App selbst. Folgt nach dem Polishing.

Wie ergänze ich Dokus?

1. Dev-Doku, die im Repo lebt: Zeile im MANIFEST in docs/build.py ergänzen (Quellpfad → Kategorie/Slug/Titel).
2. Recherche/Testplan/freie Seite: Markdown- oder HTML-Datei direkt in den passenden docs/content/<kategorie>/-Ordner legen.
3. python3 docs/build.py ausführen → docs/site/ wird neu gebaut.

Der Workflow „MD reinlegen + build.py" reicht. Bilder daneben in einen img/-Ordner legen und relativ (img/foo.png) referenzieren.