ChefStack Pro

ChefStack Pro ist eine produktionsorientierte Web-App für Küchenchefs und Teams:

• echte Benutzerkonten mit Passwort
• Rollen: Owner, Küchenchef, Team
• zentrale PostgreSQL-Datenbank
• Live-Synchronisation über Server-Sent Events
• Rezepte mit Zutaten, Arbeitsschritten und Mengenfaktor 0.1 bis 99.9
• To-do-Markierung je Zutat
• gemeinsame Bedarfsübersicht
• Datei-Upload mit serverseitiger Speicherung
• OCR/Text-Extraktion für Bilder, PDFs und Textdateien
• Audit-Log
• Export/Backup-Endpunkt
• Docker- und Cloud-Deployment vorbereitet

Lokal mit Docker starten

docker compose up --build

Dann öffnen:

http://localhost:3000

Beim ersten Start zeigt ChefStack die Ersteinrichtung an. Dort wird der erste Owner-Account erstellt.

Öffentlich deployen

Render Blueprint

1. Dieses Projekt in ein GitHub-Repository hochladen.
2. Render öffnen.
3. New → Blueprint.
4. Repository auswählen.
5. Deploy starten.

Die Datei render.yaml enthält:

• Web-Service
• PostgreSQL-Datenbank
• persistente Disk für Uploads
• automatisch generiertes JWT_SECRET

Fly.io

1. PostgreSQL bereitstellen oder externe Datenbank verwenden.
2. DATABASE_URL und JWT_SECRET als Secrets setzen.
3. Volume erstellen.
4. Deploy:

fly deploy

Eigener Server

docker compose up -d --build

Danach Reverse Proxy mit HTTPS davorschalten, z. B. Caddy, Traefik oder Nginx.

Wichtige Produktionsschritte

Vor Livebetrieb:

1. JWT_SECRET wirklich geheim und lang setzen.
2. Datenbankpasswort ändern.
3. HTTPS aktivieren.
4. Regelmäßige PostgreSQL-Backups aktivieren.
5. Upload-Volume sichern.
6. Admin-/Owner-Passwort stark wählen.
7. Zugriff nur an berechtigte Mitarbeiter geben.
8. Optional: eigene Domain einrichten.

OCR-Hinweis

Die App nutzt serverseitig tesseract.js für Bilder und pdf-parse für PDFs. Für sehr hohe Erkennungsqualität in großen Küchenbetrieben sollte später ein professioneller OCR-Service ergänzt werden, z. B. Google Vision, AWS Textract oder Azure AI Vision.

Datenmodell

Die wichtigsten Tabellen:

• users
• recipes
• audit_logs

Zutaten und Anhänge werden als JSONB im Rezept gespeichert. Das ist für diese Version robust und einfach zu betreiben. Für sehr große Installationen kann man Zutaten später in eigene relationale Tabellen normalisieren.

Rollen

• Owner: alles
• Küchenchef: Rezepte, Dateien, Teammitglieder, Export
• Team: ansehen und To-dos aktualisieren

Backup

In der App: Tab „Export“.

Zusätzlich produktiv:

• PostgreSQL Dumps
• Volume-/Object-Storage-Backups für Uploads