Schritt 1: Fundament der Lebensmittel-Lagerverwaltung (Pantry)

Backend (FastAPI + PostgreSQL): Chargen mit MHD, FEFO-Auslagern,
Einheiten-Umrechnung (Stueck/g/ml + Packungen), Open-Food-Facts-Lookup
mit lokalem Fallback, JWT-Auth mit Rollen (Admin/Nutzer), erster Admin
beim Setup, Einkaufsliste, Ablaufwarnung, Lagerorte, pytest fuer FEFO.

Web-UI (React/Vite): Login, Dashboard, Ein-/Auslagern, Produkte,
Lagerorte, Benutzerverwaltung, Einkaufsliste - rollenabhaengig.

Deploy: docker-compose + install.sh (Docker-Autoinstall, Secrets),
README und Roadmap fuer Schritt 2 (iOS) und Schritt 3.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

README.md

@@ -0,0 +1,98 @@
+# 🥫 Pantry – Selfhostbare Lebensmittel-Lagerverwaltung
+
+Ein selbst gehosteter Dienst zur Verwaltung deines Lebensmittelvorrats:
+Ein-/Auslagern per Barcode, MHD-/Ablaufverwaltung mit Chargen, Mindestbestände,
+automatische Einkaufsliste – mit **Web-UI** und (in Vorbereitung) **nativer iOS-App**.
+
+> Dies ist **Schritt 1** (Fundament). Der komplette Fahrplan steht in
+> [docs/ROADMAP.md](docs/ROADMAP.md).
+
+## Features (Schritt 1)
+- **Barcode-Lookup** über [Open Food Facts](https://world.openfoodfacts.org) mit
+  lokalem Fallback (unbekannte Produkte selbst anlegen).
+- **Chargen mit MHD:** Jedes Einlagern erzeugt eine Charge mit eigenem
+  Mindesthaltbarkeitsdatum. Beim Auslagern wird automatisch die zuerst ablaufende
+  Charge zuerst entnommen (**FEFO** – First Expired, First Out).
+- **Einheiten:** Basiseinheit Stück / Gramm / Milliliter plus optionale
+  Packungsgröße → Ein-/Auslagern in Packungen **oder** Teilmengen (z. B. 200 g).
+- **Mindestbestände** pro Produkt → automatische **Einkaufsliste**.
+- **Ablaufwarnung** für bald ablaufende Chargen (Frist konfigurierbar).
+- **Lagerorte** (flach; Unterlagerorte folgen in Schritt 3).
+- **Mehrbenutzer mit Rollen:**
+  - **Admin** – verwaltet Produkte, Lagerorte, Benutzer, Mindestbestände.
+  - **Nutzer** – nur ein-/auslagern und ansehen.
+  - Bewegungen werden protokolliert (wer hat wann was ein-/ausgelagert).
+
+## Architektur
+| Teil    | Technik                              |
+|---------|--------------------------------------|
+| Backend | Python · FastAPI · SQLAlchemy        |
+| DB      | PostgreSQL                           |
+| Web-UI  | React · Vite (via nginx ausgeliefert)|
+| iOS     | SwiftUI (Schritt 2)                  |
+| Deploy  | Docker Compose · `install.sh`        |
+
+```
+backend/   FastAPI-App + Tests
+web/        React/Vite SPA
+deploy/     docker-compose.yml, install.sh, .env.example
+docs/       Roadmap
+```
+
+## Installation (selfhosted, Linux)
+Voraussetzung: eine Linux-Maschine (Server, NAS, Raspberry Pi …). Docker wird bei
+Bedarf automatisch installiert.
+
+```bash
+git clone <dieses-repo> pantry
+cd pantry/deploy
+chmod +x install.sh
+./install.sh            # interaktiv – fragt Port & Admin-Passwort
+# oder vollautomatisch mit generiertem Admin-Passwort:
+# ./install.sh --yes
+```
+
+Nach dem Start:
+- Web-UI: `http://<server-ip>:8080` (Port konfigurierbar)
+- Anmeldung mit dem im Installer angezeigten Admin-Benutzer/Passwort.
+
+Verwaltung:
+```bash
+cd deploy
+docker compose logs -f     # Logs ansehen
+docker compose down        # stoppen
+docker compose up -d       # starten
+```
+
+Die Konfiguration liegt in `deploy/.env` (Passwörter, Port, JWT-Secret). Für den
+Produktivbetrieb bitte hinter einen HTTPS-Reverse-Proxy (z. B. Caddy/Traefik) stellen.
+
+## Entwicklung (ohne Docker)
+**Backend:**
+```bash
+cd backend
+python -m venv .venv && source .venv/bin/activate
+pip install -r requirements.txt
+# lokale SQLite-DB nutzen:
+export DATABASE_URL="sqlite:///./pantry.db"
+uvicorn app.main:app --reload
+```
+API-Doku dann unter `http://localhost:8000/docs`.
+
+**Web:**
+```bash
+cd web
+npm install
+npm run dev     # http://localhost:5173, proxyt /api → localhost:8000
+```
+
+**Tests:**
+```bash
+cd backend
+pip install -r requirements.txt
+pytest            # prüft FEFO-Abbuchung und Einheiten-Umrechnung
+```
+
+## Nächste Schritte
+Native iOS-App (Schritt 2) und fortgeschrittene Features (Gruppen-Intelligenz,
+Unterlagerorte, Push-Benachrichtigungen …) – siehe [docs/ROADMAP.md](docs/ROADMAP.md).