83 lines
3.1 KiB
Markdown
83 lines
3.1 KiB
Markdown
# KitchenStock ❤️ – Veganes Küchen- & Vorratsmanagement für Amy & Mandy
|
||
|
||
Ein modernes, helles und schnelles Web-App-System für euren veganen Vorrat, eure Einkaufsliste und KI-Rezepttipps.
|
||
|
||
|
||
|
||
|
||
|
||
---
|
||
|
||
## ✨ Features
|
||
|
||
- 🌿 **100% Vegan Guard**: Automatische Warnanzeige (`🚨 NICHT VEGAN!`), falls versehentlich ein tierisches Produkt gewählt wird.
|
||
- 🏬 **Supermarkt-Vorauswahl**: Filtert die Einkaufsliste & Vorschläge direkt nach **REWE**, **Kaufland**, **Lidl** und **ALDI**.
|
||
- 📦 **130+ Vegane Marken-Produkte**: Vorinstallierter Katalog mit REWE Beste Wahl, Kaufland K-PLANT BASED, Lidl Vemondo, ALDI MYVAY, Alpro, Oatly, Rügenwalder Mühle, Billie Green, Beyond Meat, Simply V & Violife.
|
||
- 🎚️ **Gramm-Schritt-Slider**: Realistische Vorrats-Anpassung in `[50g, 100g, 250g, 500g, 1000g]` Schritten (und 1-Stück für Flaschen/Packungen).
|
||
- 💡 **KI-Rezepttipps per 1-Tap**: Blitzschnelle 100% vegane Rezeptidee auf jeder Vorratskarte.
|
||
- 🤖 **Gemma 31B KI-Küche**: Token-sparendes KI-Modell für Wochenpläne, Resteverwertung & Einkaufsberater.
|
||
- 🕒 **Zuletzt benutzte Artikel**: Merkt sich eure Lieblingszutaten für 1-Tap Nachbestellung.
|
||
|
||
---
|
||
|
||
## 🖥️ Lokales Server-Deployment (Self-Hosted)
|
||
|
||
Ihr könnt die App ganz einfach auf eurem **eigenen lokalen Server** (Home-Server, Raspberry Pi, Ubuntu/Debian Linux, Windows Server, Synology NAS) betreiben.
|
||
|
||
### Methode 1: PM2 / Direct Node.js (Empfohlen)
|
||
|
||
Voraussetzung: Node.js (v18+) auf dem Server installiert.
|
||
|
||
```bash
|
||
# 1. Repository auf den Server klonen
|
||
git clone https://github.com/immissmandy/Kitchen.git
|
||
cd Kitchen
|
||
|
||
# 2. .env.local anlegen
|
||
cat <<EOT > .env.local
|
||
GEMINI_API_KEY=AQ.Ab8RN6IF-hRoe09JrDVAAktkIAPu400_bnh8egCVa8nuTYyAPQ
|
||
GEMINI_MODEL=gemma-2-27b-it
|
||
NEXT_PUBLIC_APP_URL=http://<EURE_SERVER_IP>:3000
|
||
EOT
|
||
|
||
# 3. Abhängigkeiten installieren & Production Build erstellen
|
||
npm install
|
||
npm run build
|
||
|
||
# 4. PM2 Process Manager installieren & App starten (Dauerhafter Hintergrundbetrieb)
|
||
npm install -g pm2
|
||
pm2 start npm --name "kitchen-stock" -- start
|
||
|
||
# 5. Automatischer Server-Neustart aktivieren
|
||
pm2 startup
|
||
pm2 save
|
||
```
|
||
|
||
Die App ist jetzt dauerhaft unter `http://<EURE_SERVER_IP>:3000` im Heimnetzwerk erreichbar!
|
||
|
||
---
|
||
|
||
### Methode 2: Docker Compose (1-Klick Container)
|
||
|
||
Falls ihr Docker auf eurem Heimserver nutzt (Synology, Unraid, Portainer, Docker Desktop):
|
||
|
||
```bash
|
||
# 1. Repository klonen
|
||
git clone https://github.com/immissmandy/Kitchen.git
|
||
cd Kitchen
|
||
|
||
# 2. Container starten
|
||
docker compose up -d --build
|
||
```
|
||
|
||
Fertig! Der Docker-Container startet automatisch neu, wenn der Server neu gestartet wird.
|
||
|
||
---
|
||
|
||
## 🌐 Zugriff im Heimnetzwerk & SSL
|
||
|
||
Damit Amy & Mandy die App bequem auf dem Smartphone öffnen können:
|
||
|
||
1. **Im Heimnetzwerk**: Öffnet am Smartphone einfach `http://192.168.178.X:3000` (IP-Adresse eures Servers).
|
||
2. **Unterwegs (Optional)**: Nutzt kostenlos **Cloudflare Tunnel** oder Nginx Reverse Proxy mit Let's Encrypt SSL.
|