158196f67b
Die Umbenennung von Gruppen in "Kategorien" war falsch: Es sind zwei
verschiedene Dinge. Sie ist zurueckgenommen, Kategorien kommen als eigene Ebene
dazu.
GRUPPE zaehlt Bestaende mehrerer Marken zusammen - Mehl von Rewe, Aldi und
Migros ergeben "5 kg Mehl". Dafuer Mindestbestand mit Einheit und EAN-Codes.
KATEGORIE ordnet allein die Artikelliste ("zeig mir alle Suesswaren"), ist
verschachtelbar wie ein Lagerort und hat weder Bestand noch EAN-Codes. Ein
Artikel kann beides, eines oder keines haben.
Die Vermischung war aelter als die Umbenennung: guessGroup in offUtils.js hat
aus der Open-Food-Facts-KATEGORIE eine GRUPPE geraten. Das ist entfernt. Die
OFF-Einordnung steuert jetzt die Kategorie, wo sie hingehoert; eine Gruppe
entsteht nur ueber einen hinterlegten Gruppen-Code oder bewusste Auswahl.
EAN-Codes an der Gruppe: Das war kein Anzeigefehler. Beim Anlegen eines Artikels
wurde ausschliesslich group_id gesetzt - ein Gruppen-Code entstand nie, die
Liste war tatsaechlich leer. Die Meldung "bereits vergeben" kam daher, dass der
Code am Artikel hing. Jetzt pflegt services/group_codes.py den Code mit: beim
Zuordnen kommt er hinzu, beim Gruppenwechsel wandert er mit, beim Entfernen der
Gruppe oder Loeschen des Artikels verschwindet er. Beim Scannen aendert sich
nichts an der Reihenfolge - der Artikel wird weiterhin zuerst gefunden; der
Gruppen-Eintrag ist Beleg in der Verwaltung und Rueckfall. Traegt man denselben
Code von Hand nach, ist das kein Fehler mehr, sondern die Auskunft, dass er ueber
den Artikel bereits dort steht.
Kategorien im Backend: neue Tabelle mit parent_id (Muster von Location),
products.category_id per ADD COLUMN IF NOT EXISTS nachgezogen, deutsche
zweistufige Startliste analog zu den eingebauten Einheiten. Die Startliste wird
nur angelegt, wenn ueberhaupt noch keine Kategorie existiert - wer sie bewusst
leerraeumt, findet sie nicht wieder. Beim Setzen einer Oberkategorie wird
geprueft, dass keine Kategorie sich selbst oder einem eigenen Nachfahren
untergeordnet wird; sonst entstuende ein Ring und jede Baumdarstellung liefe
endlos. Der Produktfilter schliesst Unterkategorien ein, category_id=0 liefert
die Artikel ohne Kategorie. Export und Import fuehren die Kategorie als Pfad
("Suesswaren & Snacks > Schokolade") in einer Spalte, damit die CSV in Excel
bedienbar bleibt.
Web: neue Seite Kategorien mit Baumdarstellung, Filter ueber der Produktliste,
getrennte Auswahlfelder im Produktformular mit je einer Zeile Erklaerung, und
beim Einlagern laesst sich eine Gruppe samt Einheit und Mindestbestand direkt
anlegen, ohne den Vorgang zu verlassen.
iOS: Kategorie-Filter ueber der Produktliste, Unterkategorien eingerueckt. Die
Artikelzeile nennt jetzt das Gebinde und warnt, wenn der Mindestbestand
unterschritten ist (rot) oder weniger als ein Viertel Luft bleibt (orange).
Getrennte Auswahlfelder fuer Kategorie und Gruppe, Gruppe direkt anlegbar.
Ausserdem die Eingabefelder in der App: .textFieldStyle(.roundedBorder) zeichnet
in der dunklen Darstellung einen fast schwarzen Kasten. Ersetzt durch eine
Systemfuellung, die sich Hell und Dunkel anpasst und zurueckhaltend bleibt.
Getestet: 54 pytest-Tests gruen, 14 davon neu (Nachfahren-Sammler, OFF-Zuordnung
inklusive Vorrang der Unterkategorie, und die komplette Codepflege an der
Gruppe). Gegen die laufende API geprueft: Startliste ohne Dubletten, Filter auf
Ober- und Unterkategorie, Ringschutz, Loeschen einer Kategorie laesst Artikel
und Unterkategorien bestehen, Export/Import-Rundlauf mit Kategoriepfad, und der
Durchlauf aus der Meldung - Artikel mit Gruppe anlegen, Code steht danach in der
Gruppe. Web-Build und iOS-Geraetebuild fehler- und warnungsfrei.
Die Oberflaechen habe ich nicht selbst bedient.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
77 lines
4.7 KiB
Markdown
77 lines
4.7 KiB
Markdown
# Project-Good – Roadmap
|
||
|
||
Selfhostbare Lebensmittel-Lagerverwaltung. Aufbau in mehreren Schritten.
|
||
|
||
## Schritt 1 – Fundament ✅
|
||
- Backend (FastAPI + PostgreSQL): Datenmodell, Auth mit Rollen (Admin/Benutzer),
|
||
Chargen mit MHD, FEFO-Auslagern, Open-Food-Facts-Lookup (v0-API) mit lokalem Fallback.
|
||
- Web-UI (React/Vite): Login, Dashboard, Ein-/Auslagern, Produkte, Lagerorte,
|
||
Benutzerverwaltung, Einkaufsliste.
|
||
- Deployment: Docker Compose + `install.sh` (Docker-/curl-Autoinstall, Secrets,
|
||
erster Admin, Health-Check), README.
|
||
- Tests: pytest für FEFO, Einheiten-Umrechnung und OFF-Mengenerkennung.
|
||
|
||
## Schritt 1b – Ausbau Web-UI ✅
|
||
- **Design:** professionelles Layout mit Seitenleiste, eigenes SVG-Icon-Set
|
||
(bewusst keine Emojis), Light-/Dark-Mode, konsistente Farbcodierung
|
||
(gelb = Warnfrist, rot = abgelaufen).
|
||
- **Gruppen:** Verwaltung, Zuordnung im Produkt, Gruppen-Mindestbestand **mit Einheit**,
|
||
Auto-Zuordnungsvorschlag aus der OFF-Kategorie.
|
||
- **Einheiten (verwaltbar):** eigene Tabelle mit Art (Anzahl/Gewicht/Volumen) und
|
||
Umrechnungsfaktor. Eingebaut: Stück, Gramm, Kilogramm, Milliliter, Liter.
|
||
Admins können weitere anlegen (z.B. Pfund = 500 g). Gilt für Produkte **und**
|
||
Gruppen-Mindestbestände; Bestände werden intern in der kanonischen Basiseinheit
|
||
(Stück/Gramm/Milliliter) gespeichert.
|
||
- **Einlagern:** Drei-Wege-Barcode-Erkennung (bekannt / bei OFF gefunden → inline
|
||
anlegen / unbekannt), mehrere Chargen je Vorgang mit eigenem MHD,
|
||
Warnung bei bereits abgelaufenem MHD.
|
||
- **Auslagern:** automatisch per FEFO **oder** gezielte Auswahl einer Charge/MHD,
|
||
auch Teilmengen.
|
||
- **Chargen bearbeiten:** Menge/MHD korrigieren und Chargen löschen (mit
|
||
Protokollierung als Korrektur-Bewegung).
|
||
- **Lagerorte:** beliebig tief verschachtelbar (Schrank → Fach → Kiste → …).
|
||
- **Mindestbestände:** je Produkt wahlweise in der Produkteinheit oder in Packungen.
|
||
- **Verlauf:** Bewegungsprotokoll (wer/was/wann), **Einstellungen:** Ablauf-Warnfrist.
|
||
- **Import / Export:** CSV (eine Zeile je Charge, in Excel bearbeitbar) und JSON
|
||
(vollständiges Backup inkl. Einheiten, Gruppen, Lagerorte). Der Import ist rein
|
||
additiv – unbekannte Produkte/Gruppen/Lagerorte werden angelegt, Chargen ergänzt,
|
||
nichts gelöscht oder überschrieben.
|
||
- **Migration:** schonendes Nachziehen neuer Spalten beim Start
|
||
(`ADD COLUMN IF NOT EXISTS`), damit bestehende Installationen ihre Daten behalten.
|
||
|
||
## Schritt 2 – Native iOS-App (SwiftUI) ✅
|
||
- Login (Server-URL + Passwort, Token im Keychain), „angemeldet bleiben“ abwählbar.
|
||
- Barcode-Scan (AVFoundation) mit Nahbereich-Autofokus, Licht und Tippen zum Scharfstellen.
|
||
- Einlagern-Flow: scannen → Lookup/Vorbefüllung → Menge + Einheit + MHD (mehrere Chargen).
|
||
- **MHD per Texterkennung** ablesbar (VisionKit); erkannte Daten werden vorgeschlagen,
|
||
nie ungefragt übernommen.
|
||
- Auslagern-Flow: scannen → Menge/Einheit, FEFO oder Chargenauswahl.
|
||
- Einkaufsliste, „bald ablaufend“ und Produktliste mit Bearbeiten.
|
||
- Home-Screen-Shortcuts und URL-Schema `projectgood://checkin` / `checkout`.
|
||
- Anzeige folgt dem Datumsformat aus den Servereinstellungen.
|
||
|
||
## Schritt 2b – MHD-Genauigkeit und Benennung ✅
|
||
- **MHD wahlweise nur mit Monat und Jahr.** Gespeichert wird weiterhin ein echtes
|
||
Datum (Monatsletzter), damit FEFO unverändert arbeitet; die Genauigkeit steht
|
||
getrennt an Charge und Produkt. Export/Import bleiben verlustfrei.
|
||
- **Kategorien als eigene Ebene neben den Gruppen.** Zuvor wurden beide Begriffe
|
||
vermischt – aus der Open-Food-Facts-Kategorie wurde sogar eine *Gruppe* geraten.
|
||
Jetzt getrennt: Die **Gruppe** zählt Bestände mehrerer Marken zusammen
|
||
(Mindestbestand, EAN-Codes), die **Kategorie** ordnet nur die Artikelliste und
|
||
ist verschachtelbar (Süßwaren → Schokolade). Mitgelieferte Startliste,
|
||
Vorschlag aus der OFF-Einordnung, Filter in App und Web.
|
||
- **EAN-Codes an der Gruppe werden automatisch gepflegt:** Beim Zuordnen eines
|
||
Artikels landet sein Code dort, beim Gruppenwechsel wandert er mit, beim
|
||
Löschen verschwindet er. Vorher blieb die Codeliste einer Gruppe leer, obwohl
|
||
Artikel darin lagen.
|
||
- **Eigenes Logo und Favicon** je Installation (Einstellungen → Darstellung).
|
||
|
||
## Schritt 3 – Weitere Ideen – offen
|
||
- **Ablauf-Push-Benachrichtigungen** via APNs (setzt die App voraus).
|
||
- **Einkaufsliste verfeinern:** Abhaken dauerhaft speichern, manuelle Einträge,
|
||
Mengenvorschläge in Packungen.
|
||
- **Statistik/Auswertung** über den Bewegungsverlauf (Verbrauch pro Zeitraum).
|
||
- **Lagerort beim Auslagern** berücksichtigen bzw. pro Charge wählbar beim Einlagern.
|
||
- **Produktbilder lokal cachen** (aktuell direkt von Open Food Facts geladen).
|
||
- **Alembic-Migrationen** statt `create_all` + Startup-ALTER, sobald das Schema stabil ist.
|