1
0
Fork 0
mirror of https://github.com/s-frick/effigenix.git synced 2026-03-28 20:39:57 +01:00
effigenix/backend/docs/mvp/2026-02-15-fleischerei-erp-feature-definition.md
Sebastian Frick c2c48a03e8 refactor: restructure repository with separate backend and frontend directories
- Move Java backend to backend/ directory
- Create frontend/ directory for TypeScript TUI and future WebUI
- Update .gitignore for Node.js and worktrees
- Update README.md with new repository structure
- Copy documentation to backend/
2026-02-17 22:08:51 +01:00

1002 lines
35 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Fleischerei-ERP: Feature-Definition für MVP und Erweiterung
**Datum:** 2026-02-15
**Zielgruppe MVP:** Kleinere Fleischereibetriebe mit 1-2 Filialen
**Zielgruppe Erweiterung:** Größere Betriebe mit mehreren Filialen
---
## Überblick
Dieses Dokument beschreibt die Anforderungen an Effigenix als MVP (Minimal Viable Product)
### Kernziele der Software
1. **ERP-Grundlagen** für Stammdatenverwaltung, Auftragsabwicklung und Fakturierung
2. **Branchen-spezifische Funktionen** für QM/Compliance (HACCP), Rezeptur-Management, Deklaration
3. **Mehrwert durch Datenanalyse** - Verkaufstrends zur Vermeidung von Überproduktion
4. **Integration** mit Waagen/Kassen und FIBU/Steuerberater
5. **Compliance** mit gesetzlichen Anforderungen (HACCP, GoBD, TSE)
### Wichtige Architektur-Prinzipien
- **Automatische Berechnungen** wo möglich (Nährwerte, Allergene, Kosten aus Rezepturen)
- **Vollständiges HACCP-Konzept** als Kernmehrwert für kleine Betriebe
- **Benutzerfreundlichkeit** - vordefinierte Rollen, automatische Prozesse
- Lückenlose **Rückverfolgbarkeit** (Rohstoff-Charge → Produktion → Verkauf)
---
## Offene Punkte & Research-Bedarf
### 1. Auftragsarten - Details klären
Wir haben im Termin 14.02.2026 im Bereich Grundlagen Auftragserfassung dokumentiert. Welche Auftragsarten sind für die Zielgruppe des MVP relevant?
- **Vorbestellungen** (Endkunden)
- **B2B-Aufträge**: Rahmenverträge, Lieferpläne, Abrufaufträge
- Beides
### 2. HACCP - Gesetzliche Anforderungen recherchieren
- **TODO:** Was ist für kleinere Betriebe (1-2 Filialen) gesetzlich zwingend vorgeschrieben?
- Welche Dokumentationen sind Pflicht vs. "Best Practice"?
- Anforderungen an Audit-Vorbereitung
---
## Epic 1: ERP Grundlagen
**Ziel:** Basis-ERP-Funktionen für Stammdatenverwaltung, Auftragsabwicklung und Fakturierung.
### 1.1 Artikelstamm
**User Stories:**
- Als Verwaltung kann ich Artikel mit Stammdaten anlegen und bearbeiten (Name, Beschreibung, Artikelnummer)
- Als Verwaltung kann ich Verkaufseinheiten mit flexiblen Preismodellen definieren
- Als Verwaltung kann ich Artikel kategorisieren (Produktgruppen, Warengruppen)
**Preismodelle für Verkaufseinheiten:**
| Verkaufseinheit | Preisberechnung | Beispiel | Waagen-Integration |
| -------------------- | ------------------------------------------- | ------------------------------------- | ----------------------------------- |
| **Stück (fix)** | Fester Stückpreis | Schnitzel: 3,50€ | Nein |
| **kg** | Preis/kg × Gewicht | Hackfleisch: 8,50€/kg × 0,5kg = 4,25€ | Ja (Waage misst Gewicht) |
| **100g** | Preis/100g × (Gewicht/100) | Aufschnitt: 1,20€/100g × 250g = 3,00€ | Ja (Waage misst Gewicht) |
| **Stück (variabel)** | Preis/kg × tatsächliches Gewicht des Stücks | Braten: 12€/kg × 2,3kg = 27,60€ | Ja (Waage misst Gewicht des Stücks) |
**Akzeptanzkriterien:**
- Ein Artikel kann mehrere Verkaufseinheiten haben (z.B. Wurst: am Stück ODER pro 100g)
- Preismodell pro Verkaufseinheit definierbar (fix oder gewichtsbasiert)
- Waagen-Integration: Bei gewichtsbasierten Preismodellen misst Waage und berechnet Endpreis automatisch
- Umrechnungen zwischen Einheiten erfolgen automatisch (z.B. kg ↔ g ↔ 100g)
### 1.2 Lieferantenstamm
**User Stories:**
- Als Verwaltung kann ich Lieferanten mit Stammdaten anlegen (Name, Adresse, Kontakt, Zahlungsziel)
- Als Verwaltung kann ich Artikel Lieferanten zuordnen mit Konditionen (Preis, Lieferzeit, Mindestmenge)
- Als Verwaltung kann ich Qualitätsnachweise pro Lieferant verwalten (Bio-, Regional-, Tierwohl-Zertifikate, Veterinärbescheinigungen)
- Als Verwaltung kann ich Lieferanten bewerten (Qualität, Pünktlichkeit, Preis-Leistung)
**Akzeptanzkriterien:**
- Zertifikate mit Gültigkeitsdatum und Erinnerung bei Ablauf
- Bewertungen sind dokumentiert und auswertbar
- Lieferant-Artikel-Zuordnung mit Preishistorie
### 1.3 Kundenstamm
**User Stories:**
- Als Verwaltung kann ich Kunden mit Stammdaten anlegen (Name, Adresse, Kontakt, Zahlungsbedingungen)
- Als Verwaltung kann ich Lieferdetails hinterlegen (abweichende Lieferadresse, Liefertage, Ansprechpartner vor Ort)
- Als Verwaltung kann ich Rahmenverträge verwalten (vereinbarte Preise, Mengen, Lieferrhythmus)
- Als Verwaltung kann ich Kundenpräferenzen dokumentieren (Bio, Regional, Tierwohl, besondere Anforderungen)
**Akzeptanzkriterien:**
- Rahmenverträge sind im Auftrag automatisch verfügbar (Sonderpreise)
- Kundenpräferenzen können bei Artikelauswahl gefiltert werden
### 1.4 Auftragserfassung
**User Stories:**
- Als Verkauf kann ich Vorbestellungen für Endkunden erfassen (z.B. Partyplatten, größere Mengen für Feiern)
- Als Verwaltung kann ich B2B-Aufträge erfassen (Restaurants, Kantinen, Catering)
- Als Verkauf erfasse ich Ladenverkäufe über die Kassenanbindung (siehe Epic 2)
**Akzeptanzkriterien:**
- Vorbestellungen mit Abholdatum und Benachrichtigung
- B2B-Aufträge mit Liefertermin und -adresse
- Rahmenvertragspreise werden automatisch verwendet
**Offene Punkte:**
- Details zu Auftragsarten und Workflows klären
### 1.5 Lieferschein & Rechnung
**User Stories:**
- Als Verwaltung kann ich Lieferscheine erstellen (mit oder ohne Rechnungsfunktion)
- Als Verwaltung kann ich Rechnungen erstellen (separat oder zusammen mit Lieferschein)
- Als Verwaltung kann ich den Workflow je nach Kunde/Auftrag wählen (z.B. B2B: Lieferschein + Monatssammelrechnung, Endkunde: Lieferschein = Rechnung)
- Als Verwaltung kann ich Gutschriften erstellen (Retouren, Mängel, Preisnachlässe)
**Akzeptanzkriterien:**
- Flexible Workflows je nach Kundentyp
- Gutschriften referenzieren Original-Rechnung
- Dokumente sind revisionssicher archiviert (siehe Epic 12)
---
## Epic 2: Waagen/Kassen-Anbindung
**Ziel:** Integration mit Laden-Waagen und Kassensystemen (Bizerba, Mettler) für nahtlosen Verkaufsprozess.
### 2.1 Stammdaten-Synchronisation
**User Stories:**
- Als System werden Artikel automatisch an Waagen/Kassen übertragen
- Als System werden Preisänderungen automatisch synchronisiert
- Als System werden Rezeptur-Informationen für Etikettendruck bereitgestellt
**Akzeptanzkriterien:**
- Synchronisation erfolgt automatisch bei Änderungen (Freigabeprozess?)
- Unterstützung für Bizerba und Mettler-Waagen
### 2.2 Bondaten-Rückfluss
**User Stories:**
- Als System importiere ich Verkaufsdaten (Bondaten) aus der Kasse ins ERP
- Als System buche ich Verkäufe automatisch aus dem Bestand ab
- Als System stelle ich Verkaufsdaten für Auswertungen bereit
**Akzeptanzkriterien:**
- Bondaten werden täglich/regelmäßig importiert
- Verkaufsdaten sind in Reporting verfügbar (siehe Epic 9)
### 2.3 TSE-Prüfung
**TODO** TSE Anforderungen recherchieren.
**User Stories:**
- Als System prüfe ich die TSE-Compliance der Kassensysteme
- Als Verwaltung kann ich TSE-Nachweise für Betriebsprüfung bereitstellen
**Akzeptanzkriterien:**
- TSE-Prüfung dokumentiert (gesetzliche Anforderung Deutschland)
### 2.4 Etikettendruck an Waage
**User Stories:**
- Als Verkauf drucke ich an der Waage ein Etikett mit aktuellem Gewicht und berechnetem Preis
- Als System stelle ich alle Pflichtangaben bereit (Name, Zutaten, Allergene, Hersteller, MHD)
- Als System berechne ich Nährwerte automatisch aus Rezeptur
- Als System drucke ich Qualitätssiegel (Bio, Regional, Tierwohl) auf Etikett
- Als System drucke ich Chargen-/Produktionsnummer für Rückverfolgbarkeit
**Akzeptanzkriterien:**
- Etikett ist rechtlich konform (alle Pflichtangaben)
- Nährwerte werden automatisch aus Rezeptur berechnet (siehe Epic 4 und 6)
- Waage integriert Gewicht in Etikett
---
## Epic 3: QM & Compliance (HACCP)
**Ziel:** Vollständiges HACCP-Konzept und Compliance-Management für Fleischerei-spezifische gesetzliche Anforderungen.
**Kernmehrwert:** Gerade kleinere Betriebe sollen hier massiv entlastet werden. HACCP-Dokumentation ist oft komplex und zeitaufwendig - die Software macht es einfach und automatisch.
### 3.1 Temperaturprotokollierung
**User Stories:**
- Als Produktion kann ich Kühltemperaturen dokumentieren (Kühlschränke, Kühlräume, Theken)
- Als System warne ich bei Grenzwertüberschreitungen (optional für späteren Ausbau)
- Als Verwaltung kann ich Temperaturprotokolle für Audits generieren
**Akzeptanzkriterien:**
- Temperaturmessung mit Datum, Uhrzeit, Gerät, Messwert, Person
- Grenzwerte pro Gerät definierbar
- Protokolle als PDF für Audit exportierbar
### 3.2 Reinigungspläne & -nachweise
**User Stories:**
- Als Verwaltung kann ich Reinigungspläne erstellen (täglich, wöchentlich, monatlich)
- Als Produktion kann ich durchgeführte Reinigungen dokumentieren (Datum, Person, Checkliste abgehakt)
- Als Verwaltung kann ich Soll-Ist-Vergleich der Reinigungen einsehen
**Akzeptanzkriterien:**
- Reinigungsplan mit Checklisten (was muss gereinigt werden)
- Erinnerungen an fällige Reinigungen
- Nachweis für Audits
### 3.3 Wareneingangskontrolle
**User Stories:**
- Als Produktion/Verwaltung kann ich beim Wareneingang Temperatur prüfen und dokumentieren
- Als Produktion/Verwaltung kann ich Sichtkontrolle dokumentieren (Frische, Verpackung, etc.)
- Als Produktion/Verwaltung kann ich MHD prüfen
- Als Produktion/Verwaltung kann ich Dokumente zuordnen (Lieferschein, Veterinärbescheinigung, Zertifikate fotografieren/hochladen)
- Als Produktion/Verwaltung kann ich Lieferanten-Chargennummer erfassen für Rückverfolgbarkeit
**Akzeptanzkriterien:**
- Wareneingangskontrolle mit Checkliste (Temperatur, Sichtkontrolle, MHD, Dokumente)
- Fotos/PDFs können zugeordnet werden
- Chargen-Zuordnung für lückenlose Rückverfolgbarkeit (siehe Epic 4.3)
### 3.4 Probenentnahme & Analysen
**User Stories:**
- Als Produktion kann ich Probenentnahmen dokumentieren (Datum, Artikel, Charge, Grund)
- Als Verwaltung kann ich Analyseergebnisse zuordnen (Labor-Befunde)
**Akzeptanzkriterien:**
- Probenentnahme mit Referenz zu Charge
- Analyseergebnisse dokumentiert
### 3.5 Schulungsverwaltung
**User Stories:**
- Als Verwaltung kann ich Schulungsnachweise speichern (Zertifikate hochladen/fotografieren)
- Als Verwaltung kann ich Schulungspläne mit Erinnerungen verwalten (Auffrischungsfristen)
- Als Verwaltung kann ich interne Schulungen dokumentieren (Datum, Teilnehmer, Thema, Schulender)
**Akzeptanzkriterien:**
- Schulungsnachweis pro Mitarbeiter mit Gültigkeitsdatum
- Erinnerung bei Ablauf
- Interne Schulungen dokumentiert für Audit-Nachweis
### 3.6 Wartungsverwaltung
**User Stories:**
- Als Verwaltung kann ich Geräte-Stammdaten anlegen (Kühlschränke, Produktionsmaschinen, Slicer, etc.)
- Als Verwaltung kann ich Wartungsintervalle definieren (jährlich, halbjährlich, etc.)
- Als System erinnere ich an fällige Wartungen
- Als Produktion/Verwaltung kann ich Wartungen dokumentieren (Datum, Durchführer, Befund, externe Firma)
- Als Produktion/Verwaltung kann ich ungeplante Reparaturen/Störungen dokumentieren
**Akzeptanzkriterien:**
- Geräte-Stammdaten mit Seriennummer, Hersteller, Standort
- Wartungsintervalle automatisch berechnet
- Wartungs- und Reparatur-Historie für Audit-Nachweis
### 3.7 Standardarbeitsanweisungen (SOPs)
**User Stories:**
- Als Verwaltung kann ich SOPs hinterlegen und verwalten (PDFs, Dokumente)
- Als Verwaltung kann ich SOPs Mitarbeitern zuordnen (wer muss welche SOP kennen)
- Als Verwaltung kann ich Versionshistorie von SOPs verwalten
**Akzeptanzkriterien:**
- SOPs mit Versionierung
- Mitarbeiter-Zuordnung dokumentiert
### 3.8 Audit-Vorbereitung
**User Stories:**
- Als Verwaltung kann ich automatische HACCP-Reports generieren
- Als Verwaltung habe ich alle Nachweise zentral verfügbar
- Als Verwaltung kann ich Reports als PDF exportieren
**Akzeptanzkriterien:**
- Alle HACCP-relevanten Daten in Reports verfügbar (Temperatur, Reinigung, Schulungen, Wartungen)
- Export für Auditor
**Research-Bedarf:**
- Gesetzliche Anforderungen für kleinere Betriebe recherchieren
- Was ist Pflicht, was ist "Best Practice"?
---
## Epic 4: Rezeptur- & Stammdatenmanagement
**Ziel:** Verwaltung von Rezepturen mit mehrstufigen Strukturen, Ausbeute-Berechnung und Chargen-Tracking für Rückverfolgbarkeit.
### 4.1 Rezepturverwaltung
**User Stories:**
- Als Produktion kann ich mehrstufige Rezepturen anlegen (Zwischenprodukte als Zutaten, z.B. "Gewürzmischung A" in mehreren Wurstrezepten)
- Als Produktion kann ich Rezepturvarianten verwalten (z.B. Bio-Variante, Standard-Variante)
**Akzeptanzkriterien:**
- Rezepturen mit beliebiger Verschachtelungstiefe
- Zwischenprodukte können in mehreren Rezepturen verwendet werden
- Änderungen an Zwischenprodukten wirken sich auf alle verwendenden Rezepturen aus
### 4.2 Ausbeute-Berechnung
**User Stories:**
- Als Produktion kann ich Verarbeitungsverluste in Rezepturen hinterlegen (Knochen, Fett-Trimmen, Gewichtsverlust beim Räuchern)
- Als System berechne ich Netto-Ausbeute aus Brutto-Input
- Als Produktion sehe ich bei Produktionsplanung, wie viel Rohmaterial ich wirklich brauche
**Akzeptanzkriterien:**
- Ausbeute in % definierbar
- Automatische Berechnung: Wenn 100kg Endprodukt, bei 80% Ausbeute → 125kg Rohmaterial nötig
### 4.3 Chargen-Tracking
**User Stories:**
- Als System vergebe ich für jede Produktion eine eindeutige Chargennummer
- Als System dokumentiere ich, welche Rohstoff-Charge in welcher Produktion verwendet wurde
- Als System ermögliche ich lückenlose Rückverfolgbarkeit: Rohstoff-Charge (Wareneingang) → Produktions-Charge → Verkauf/Kunde
**Akzeptanzkriterien:**
- Jede Produktion = Charge mit Nummer, Datum, Rezeptur, Menge
- Verknüpfung Rohstoff-Chargen → Produktions-Charge
- Im Falle eines Rückrufs: Welche Endprodukt-Chargen sind von einer Rohstoff-Charge betroffen?
### 4.4 Kalkulationsgrundlagen
**User Stories:**
- Als Verwaltung kann ich aus Rezeptur + aktuellen Rohstoffpreisen die Kosten berechnen
- Als System schlage ich Verkaufspreis vor (Kosten + Ziel-Marge)
- Als Verwaltung sehe ich Preishistorie für Rohstoffe
- Als System warne ich bei Margen-Erosion (Rohstoffpreis steigt, Verkaufspreis nicht angepasst)
**Akzeptanzkriterien:**
- Kostenberechnung berücksichtigt alle Rezeptur-Ebenen (inkl. Zwischenprodukte)
- Warnung wenn Marge unter Zielmarge fällt
- Preishistorie visualisiert (Chart)
---
## Epic 5: Beschaffung & Rohstoffmanagement
**Ziel:** Einkaufsunterstützung mit Bedarfsplanung aus Produktionsbedarf und Wareneingangskontrolle.
### 5.1 Bedarfsplanung
**User Stories:**
- Als Verwaltung sehe ich Bedarfsvorschläge aus Rezepturen und geplanten Produktionen
- Als System berechne ich: "Du brauchst 150kg Schweineschulter diese Woche" basierend auf Produktionsplan
- Als System berücksichtige ich aktuelle Lagerbestände (nur Differenz bestellen)
**Akzeptanzkriterien:**
- Bedarfsberechnung aus Produktionsplan (siehe Epic 7)
- Abgleich mit Lagerbestand
- Vorschlag: "Bestelle X kg Artikel Y"
### 5.2 Bestellwesen
**User Stories:**
- Als Verwaltung kann ich Bestellungen an Lieferanten erstellen
- Als Verwaltung sehe ich Bestellstatus (bestellt, bestätigt, geliefert, offen)
- Als Verwaltung kann ich Teillieferungen erfassen
**Akzeptanzkriterien:**
- Bestellung mit Lieferant, Artikeln, Mengen, Liefertermin
- Bestellhistorie pro Lieferant
- Offene Bestellungen übersichtlich
### 5.3 Wareneingang
**User Stories:**
- Als Produktion/Verwaltung erfasse ich Wareneingang (Lieferant, Datum, Artikel, Menge)
- Als Produktion/Verwaltung führe ich Qualitätsprüfung durch (siehe Epic 3.3)
- Als System buche ich Bestand ein
**Akzeptanzkriterien:**
- Wareneingang erfasst mit Bezug zu Bestellung
- Qualitätsprüfung (Temperatur, Sichtkontrolle, MHD) dokumentiert
- Dokumente zugeordnet (Lieferschein, Zertifikate)
- Chargen-Zuordnung (siehe Epic 4.3)
- Bestand automatisch eingebucht (siehe Epic 8)
### 5.4 Lieferanten-Qualitätsmanagement
**User Stories:**
- Als Verwaltung prüfe ich Qualitätsnachweise pro Lieferung (Zertifikate vorhanden und gültig)
- Als Verwaltung dokumentiere ich Abweichungen/Mängel
- Als System fließen Qualitätsdaten in Lieferanten-Bewertung ein (siehe Epic 1.2)
**Akzeptanzkriterien:**
- Checkliste bei Wareneingang: Zertifikate prüfen
- Abweichungen dokumentiert
- Bewertung automatisch beeinflusst
---
## Epic 6: Kundenanforderungen & Deklaration
**Ziel:** Rechtskonforme Deklaration mit automatischer Berechnung aus Rezepturen, Qualitätssiegel-Management und Etikettierung.
### 6.1 Allergenkennzeichnung
**User Stories:**
- Als Verwaltung hinterlege ich 14 EU-Haupt-Allergene in Zutaten-Stammdaten
- Als System berechne ich Allergene automatisch auf Endprodukt (aus Rezeptur-Zutaten)
- Als Verwaltung kann ich Spurenkennzeichnung definieren ("Kann Spuren von X enthalten" bei gemeinsamer Verarbeitung)
- Als System generiere ich eine Allergen-Matrix (Übersichtstabelle: welches Produkt enthält welche Allergene) für Kunden/Aushang
**Akzeptanzkriterien:**
- Allergene werden aus Rezepturen automatisch vererbt (Zutat mit Sellerie → Endprodukt mit Sellerie)
- Spurenkennzeichnung manuell hinzufügbar
- Allergen-Matrix als Aushang druckbar
### 6.2 Nährwertberechnung
**User Stories:**
- Als Verwaltung hinterlege ich Nährwerte in Zutaten-Stammdaten (Kalorien, Fett, Eiweiß, Kohlenhydrate, Salz, etc.)
- Als System berechne ich Nährwerte automatisch für Endprodukt aus Rezeptur
- Als System generiere ich Nährwerttabelle für Etiketten (pro 100g und pro Portion)
**Akzeptanzkriterien:**
- Nährwerte werden gewichtet nach Rezeptur-Anteilen berechnet
- Nährwerttabelle rechtlich konform (EU-Lebensmittelinformationsverordnung)
### 6.3 Qualitätssiegel-Management
**User Stories:**
- Als Verwaltung kann ich Qualitätssiegel verwalten (Bio-Zertifizierung, Regional-Label, Tierwohl-Stufen)
- Als Verwaltung ordne ich Siegel Artikeln/Rezepturen/Lieferanten zu
- Als System prüfe ich automatisch Siegel-Anforderungen (z.B. nur Bio wenn alle Zutaten Bio)
- Als Verwaltung verwalte ich Zertifikate mit Gültigkeit und Erneuerungsfristen
**Akzeptanzkriterien:**
- System warnt, wenn Bio-Siegel bei Endprodukt, aber nicht-Bio-Zutat verwendet
- Zertifikate mit Ablaufdatum und Erinnerung
- Siegel auf Etiketten druckbar
### 6.4 Herkunftskennzeichnung
**User Stories:**
- Als Verwaltung hinterlege ich Herkunftsland/-region für Rohstoffe
- Als System leite ich Herkunft automatisch aus Rezeptur und Lieferanten-Info ab
- Als Verwaltung kann ich "Regional"-Nachweis führen (z.B. alle Zutaten aus Umkreis X km)
**Akzeptanzkriterien:**
- Herkunft auf Etiketten druckbar
- Regional-Nachweis dokumentiert
### 6.5 Etiketten-Generierung
**User Stories:**
- Als System generiere ich Etiketten mit allen Pflichtangaben (Name, Preis, Zutaten, Allergene, Hersteller, MHD)
- Als System füge ich Nährwerttabelle hinzu
- Als System drucke ich Qualitätssiegel (Bio, Regional, Tierwohl)
- Als System drucke ich Herkunft
- Als System drucke ich Chargen-/Produktionsnummer
- Als Verkauf drucke ich Etikett an Waage mit aktuellem Gewicht (siehe Epic 2.4)
**Akzeptanzkriterien:**
- Etikett rechtlich konform (alle Pflichtangaben)
- Integration mit Waagen (siehe Epic 2.4)
- Etikett-Vorlagen konfigurierbar
---
## Epic 7: Produktionsplanung & -steuerung
**Ziel:** Produktionsplanung mit manueller Steuerung plus Verkaufstrends-Analyse zur Vermeidung von Überproduktion.
**Kernmehrwert:** Viele Metzger wissen nicht genau, wie viel sie wirklich abverkaufen und was das für ihre Planung bedeuten sollte. Überproduktion (z.B. zu viel geschlachtet, teure Teile eingefroren für günstige Wurst) ist ein echtes Problem. Die Software hilft, datenbasiert zu planen statt nach "Bauchgefühl".
### 7.1 Produktionsplan erstellen
**User Stories:**
- Als Produktion erstelle ich manuelle Produktionsliste (Koch/Metzgermeister plant täglich/wöchentlich)
- Als Produktion lege ich fest: Artikel, Menge, Termin
- Als Produktion kann ich mehrere Produktionsaufträge parallel planen
**Akzeptanzkriterien:**
- Produktionsplan übersichtlich (Kalenderansicht, Listenansicht)
- Produktionsaufträge bearbeitbar
### 7.2 Verkaufstrends-Analyse
**User Stories:**
- Als Produktion sehe ich Analyse vergangener Verkaufsdaten (täglich, wöchentlich, saisonal)
- Als System schlage ich Produktionsmengen vor basierend auf Durchschnittswerten ("Mittwochs verkauft ihr im Schnitt 25kg Bratwurst")
- Als System warne ich vor Überproduktion (geplante Menge deutlich über Durchschnitt)
**Akzeptanzkriterien:**
- Verkaufstrends visualisiert (Charts)
- Produktionsvorschläge konkret ("Empfohlen: 25kg Bratwurst, du planst 40kg - Warnung")
- Saisonale Unterschiede berücksichtigt (Grillsaison vs. Winter)
### 7.3 Produktionsauftrag
**User Stories:**
- Als System generiere ich aus Produktionsplan einen Produktionsauftrag
- Als System berechne ich Materialbedarf aus Rezeptur (inkl. Ausbeute)
- Als System vergebe ich Chargen-Nummer
- Als Produktion sehe ich Status-Tracking (geplant, in Produktion, fertig)
**Akzeptanzkriterien:**
- Produktionsauftrag mit Rezeptur, Materialliste, Menge, Termin
- Materialbedarf berücksichtigt Ausbeute (siehe Epic 4.2)
- Chargen-Nummer eindeutig
### 7.4 Produktionsrückmeldung
**User Stories:**
- Als Produktion erfasse ich tatsächlich produzierte Menge
- Als Produktion dokumentiere ich Ausschuss/Schwund
- Als System schließe ich Charge ab und gebe sie für Verkauf frei
- Als System buche ich Bestand ein (Endprodukt) und ab (Rohstoffe)
**Akzeptanzkriterien:**
- Produktionsrückmeldung mit Ist-Menge, Ausschuss, Datum, Person
- Abweichungen von Soll-Menge dokumentiert
- Bestandsbuchungen automatisch (siehe Epic 8)
- Charge abgeschlossen und rückverfolgbar
---
## Epic 8: Bestandsführung & Inventur
**Ziel:** Vollständige Bestandsführung für Rohstoffe UND Eigenproduktion mit Chargen- und MHD-Tracking.
### 8.1 Bestandsverwaltung Rohstoffe
**User Stories:**
- Als System führe ich Lagerbestände für Rohstoffe und Zukaufware (Fleisch, Gewürze, Verpackung)
- Als System führe ich Chargen (welche Lieferanten-Charge liegt im Lager)
- Als System führe ich MHD pro Charge
- Als Verwaltung kann ich mehrere Lagerorte definieren (Kühlraum, Tiefkühler, Trockenlager)
**Akzeptanzkriterien:**
- Bestand chargengenau geführt
- MHD pro Charge
- Mehrere Lagerorte unterscheidbar
### 8.2 Bestandsverwaltung Eigenproduktion
**User Stories:**
- Als System führe ich Bestände für produzierte Waren (Wurst, Aufschnitt, etc.)
- Als System führe ich Chargen (welche Produktions-Charge)
- Als System führe ich MHD
- Als System unterscheide ich Theken-/Verkaufsbestand vs. Lagerbestand
**Akzeptanzkriterien:**
- Eigenproduktion chargengenau geführt
- MHD pro Charge
- Theke vs. Lager unterscheidbar
### 8.3 Bestandsbewegungen
**User Stories:**
- Als System buche ich Wareneingang ein (siehe Epic 5.3)
- Als System buche ich Produktion (verbrauche Rohstoffe, produziere Endprodukte, siehe Epic 7.4)
- Als System buche ich Verkauf ab (aus Bondaten, siehe Epic 2.2)
- Als System buche ich Interfilial-Transfer (zwischen Filialen, siehe Epic 11.4)
- Als Verwaltung kann ich Schwund/Verderb manuell ausbuchen
**Akzeptanzkriterien:**
- Alle Bestandsbewegungen nachvollziehbar (Wer, Was, Wann, Warum)
- Bestandshistorie pro Artikel/Charge
### 8.4 MHD-Warnungen
**User Stories:**
- Als System warne ich automatisch bei ablaufendem MHD (z.B. 3 Tage vorher)
- Als System priorisiere ich Verkauf nach FEFO (First-Expired-First-Out)
- Als Verkauf sehe ich bei Artikelauswahl, welche Charge zuerst verkauft werden sollte
**Akzeptanzkriterien:**
- Warnungen rechtzeitig (konfigurierbar)
- FEFO-Priorisierung sichtbar
### 8.5 Inventur
**User Stories:**
- Als Verwaltung kann ich Inventur starten (Inventur-Modus)
- Als Produktion/Verwaltung erfasse ich Ist-Bestände
- Als System zeige ich Soll-Ist-Vergleich
- Als Verwaltung dokumentiere ich Inventurdifferenzen und buche sie aus
- Als Verwaltung sehe ich Inventur-Historie
**Akzeptanzkriterien:**
- Inventur-Modus: Nur Erfassung, keine anderen Buchungen möglich
- Differenzen dokumentiert mit Grund (Schwund, Verderb, Zählfehler, etc.)
- Inventur-Historie für Audits
---
## Epic 9: Reporting & Auswertungen
**Ziel:** Umfassende Auswertungen für Betriebsführung, Compliance und Einkauf.
### 9.1 Verkaufsstatistik
**User Stories:**
- Als Verwaltung sehe ich Verkaufszahlen nach Artikel, Produktgruppe, Zeitraum
- Als Verwaltung kann ich Tages-, Wochen-, Monats-, Jahresauswertungen abrufen
- Als Verwaltung sehe ich Filial-Vergleiche (bei Mehrfilialen)
- Als Verwaltung sehe ich Bestseller-Analysen
**Akzeptanzkriterien:**
- Verkaufsstatistik als Tabelle und Chart
- Filterbar nach Zeitraum, Artikel, Filiale
- Export als PDF/Excel
### 9.2 Deckungsbeitragsrechnung
**User Stories:**
- Als Verwaltung sehe ich Verkaufspreis vs. Rohstoffkosten pro Artikel
- Als Verwaltung sehe ich Profitabilität nach Artikel, Produktgruppe
- Als Verwaltung identifiziere ich Verlustbringer (Artikel mit negativer Marge)
- Als Verwaltung sehe ich Margen-Entwicklung über Zeit
**Akzeptanzkriterien:**
- Deckungsbeitrag berechnet aus Verkaufspreis - Kosten (aus Rezeptur)
- Visualisierung (welcher Artikel bringt wie viel Marge)
- Warnung bei Verlustbringern
### 9.3 HACCP-Berichte
**User Stories:**
- Als Verwaltung generiere ich Temperaturprotokolle (Zeitraum-Reports)
- Als Verwaltung generiere ich Reinigungsnachweise (Soll-Ist-Abgleich)
- Als Verwaltung generiere ich Schulungsübersicht (wer hat was wann)
- Als Verwaltung generiere ich Wartungsübersicht (fällige/überfällige Wartungen)
- Als Verwaltung generiere ich Audit-Ready-Reports (alle Nachweise auf einen Blick)
**Akzeptanzkriterien:**
- Alle HACCP-Reports als PDF exportierbar
- Audit-Ready: Alle Nachweise für einen Zeitraum gebündelt
### 9.4 Warenwirtschafts-Reports
**User Stories:**
- Als Verwaltung sehe ich Lagerbestände aktuell und historisch
- Als Verwaltung sehe ich Umschlagshäufigkeit (Lagerdauer pro Artikel)
- Als Verwaltung sehe ich Schwund-Analysen (wo geht Ware verloren)
- Als Verwaltung sehe ich MHD-Übersicht (was läuft bald ab)
- Als Verwaltung sehe ich Artikelverfügbarkeit (was ist knapp)
**Akzeptanzkriterien:**
- Lagerbestände mit Chargen und MHD
- Schwund-Analyse: Differenz zwischen Soll (aus Produktion/Einkauf) und Ist (Verkauf)
- MHD-Übersicht sortiert nach Ablaufdatum
### 9.5 Einkaufs-Reports
**User Stories:**
- Als Verwaltung sehe ich Bestellhistorie
- Als Verwaltung sehe ich Lieferanten-Performance (Liefertreue, Qualität)
- Als Verwaltung sehe ich Preisentwicklungen für Rohstoffe
- Als Verwaltung sehe ich Einkaufsvolumen pro Lieferant
**Akzeptanzkriterien:**
- Preisentwicklungen als Chart (Rohstoff-Preis über Zeit)
- Lieferanten-Performance mit Bewertung
---
## Epic 10: Benutzerverwaltung & Rollen
**Ziel:** Rollenbasierte Zugriffskontrolle mit vordefinierten Rollen und granularem Rechtesystem.
### 10.1 Benutzerverwaltung
**User Stories:**
- Als Chef kann ich Benutzer anlegen, bearbeiten, deaktivieren
- Als Chef pflege ich Benutzer-Stammdaten (Name, E-Mail, etc.)
- Als Chef ordne ich Benutzer Filialen zu (bei Mehrfilialen)
**Akzeptanzkriterien:**
- Benutzer mit Login (Username/Passwort oder E-Mail)
- Benutzer deaktivierbar (nicht löschbar wegen Audit-Trail)
### 10.2 Rollen-Konzept
**User Stories:**
- Als Chef ordne ich Benutzern vordefinierte Rollen zu: **Verkauf**, **Produktion**, **Verwaltung**, **Chef**
- Als System steuere ich Zugriff basierend auf Rollen
**Rollen-Definition:**
| Rolle | Berechtigungen (Beispiele) |
| -------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Verkauf** | Aufträge erfassen, Lagerbestand einsehen, **keine** Preisänderung, **keine** Stammdatenpflege |
| **Produktion** | Produktionsplan erstellen, Rezepturen einsehen, Produktionsrückmeldung, HACCP-Protokolle ausfüllen, Wareneingangskontrolle |
| **Verwaltung** | Stammdaten pflegen (Artikel, Lieferanten, Kunden), Rechnungen erstellen, Reports, Einkauf, **keine** Rezepturänderung |
| **Chef** | Vollzugriff auf alle Funktionen |
**Akzeptanzkriterien:**
- Rollen sind klar definiert
- Rechte werden durchgesetzt (User sieht nur, was er darf)
### 10.3 Flexibles Rechtesystem (technische Basis)
**User Stories:**
- Als System basiere ich Rollen auf granularen Rechten pro Feature/Funktion
- Als System ermögliche ich spätere Custom-Rollen für größere Betriebe (nicht MVP)
**Akzeptanzkriterien:**
- Technisch: Rechte pro Feature konfigurierbar (z.B. "Artikel anlegen", "Preise ändern", "Rezepturen bearbeiten", "HACCP-Protokolle einsehen")
- MVP: Nur vordefinierte Rollen sichtbar, keine Custom-Rollen
---
## Epic 11: Mehrfilialen-Management
**Ziel:** Unterstützung für Betriebe mit 1-2 Filialen (MVP) bis hin zu größeren Filialnetzen mit zentraler Produktion.
### 11.1 Filialen-Stammdaten
**User Stories:**
- Als Verwaltung kann ich Filialen anlegen und verwalten
- Als Verwaltung pflege ich Adresse, Öffnungszeiten, Ansprechpartner
- Als Verwaltung definiere ich Filialtyp (Produktion + Verkauf, nur Verkauf, nur Produktion/Zentrale)
**Akzeptanzkriterien:**
- Filialen unterscheidbar
- Filialtyp steuert verfügbare Funktionen
### 11.2 Gemeinsamer Artikelstamm
**User Stories:**
- Als Verwaltung pflege ich Artikelstamm zentral für alle Filialen
- Als Verwaltung kann ich filial-spezifische Preise definieren (optional)
- Als Verwaltung kann ich filial-spezifisches Sortiment definieren (welche Filiale führt welche Artikel)
**Akzeptanzkriterien:**
- Ein Artikelstamm, mehrere Filialen
- Filial-spezifische Preise/Sortiment konfigurierbar
### 11.3 Filial-spezifische Bestandsführung
**User Stories:**
- Als System führe ich Bestände pro Filiale getrennt
- Als Verwaltung sehe ich Lagerbestände pro Filiale
- Als System habe ich getrennte Lagerorte pro Filiale
**Akzeptanzkriterien:**
- Bestände filial-getrennt
- Auswertungen pro Filiale und konsolidiert möglich
### 11.4 Interfilial-Transfers
**User Stories:**
- Als Verwaltung kann ich Ware zwischen Filialen umbuchen
- Als System erstelle ich Transfer-Beleg (von Filiale A nach Filiale B)
- Als System buche ich Bestände automatisch (Filiale A: -X, Filiale B: +X)
**Akzeptanzkriterien:**
- Transfer mit Artikel, Menge, Datum, von/nach Filiale
- Bestandsbuchungen automatisch
- Transfer-Historie nachvollziehbar
### 11.5 Zentrale Produktion mit Belieferung
**User Stories:**
- Als Produktion (Zentrale) produziere ich für mehrere Filialen
- Als System erstelle ich Lieferscheine für Filial-Belieferung
- Als System buche ich Produktionsausstoß in Zentrale ein und Lieferung an Filialen um
- Als Produktionsplanung berücksichtige ich Bedarf aller Filialen
**Akzeptanzkriterien:**
- Produktionsplanung zeigt Bedarf aller Filialen
- Lieferscheine für interne Lieferungen
- Bestandsbuchungen zwischen Filialen
### 11.6 Filialübergreifende Auswertungen
**User Stories:**
- Als Verwaltung/Chef sehe ich konsolidierte Reports über alle Filialen
- Als Verwaltung/Chef kann ich einzelne Filialen separat auswerten
- Als Verwaltung/Chef sehe ich Filial-Vergleiche (Umsatz, Marge, Bestseller)
**Akzeptanzkriterien:**
- Alle Reports (Epic 9) filial-übergreifend und filial-spezifisch
- Filial-Vergleiche visualisiert
---
## Epic 12: Dokumentenarchivierung & GoBD
**Ziel:** Revisionssichere Archivierung aller Geschäftsdokumente gemäß GoBD (Grundsätze zur ordnungsmäßigen Führung und Aufbewahrung von Büchern, Aufzeichnungen und Unterlagen in elektronischer Form).
### 12.1 Dokumentenverwaltung
**User Stories:**
- Als System archiviere ich automatisch alle im System erzeugten Dokumente (Rechnungen, Lieferscheine, Gutschriften, Produktionsdokumente, HACCP-Protokolle, etc.)
- Als Verwaltung kann ich externe Dokumente hochladen (Eingangsrechnungen, Lieferscheine, Zertifikate, Verträge)
- Als Verwaltung kann ich Dokumente kategorisieren (Dokumenten-Typen)
**Akzeptanzkriterien:**
- Alle Dokumente zentral gespeichert
- Dokumente mit Metadaten (Datum, Typ, Bezug zu Kunde/Lieferant/Artikel, etc.)
### 12.2 Revisionssichere Archivierung
**User Stories:**
- Als System stelle ich sicher, dass Dokumente nachträglich nicht geändert/gelöscht werden können (GoBD-konform)
- Als System erstelle ich Versionierung bei Dokumenten-Ersetzung (z.B. Stornorechnung ersetzt Original-Rechnung)
- Als System führe ich Audit-Trail (wer hat wann was gemacht: Dokument hochgeladen, angesehen, exportiert)
**Akzeptanzkriterien:**
- Dokumente unveränderbar (technisch sichergestellt)
- Versionierung nachvollziehbar (Original-Rechnung + Storno-Rechnung beide archiviert)
- Audit-Trail für alle Dokumenten-Aktionen
### 12.3 Suchfunktion
**User Stories:**
- Als Verwaltung kann ich Volltextsuche in Dokumenten durchführen
- Als Verwaltung kann ich filtern nach Datum, Typ, Kunde, Lieferant, Betrag
- Als Verwaltung habe ich schnellen Zugriff auf Dokumente (für Prüfer/Steuerberater)
**Akzeptanzkriterien:**
- Volltextsuche funktioniert in PDFs und gescannten Dokumenten (OCR)
- Filter kombinierbar
- Suchergebnisse mit Vorschau
### 12.4 Automatische Löschfristen
**User Stories:**
- Als Verwaltung hinterlege ich gesetzliche Aufbewahrungsfristen pro Dokumenten-Typ (z.B. 10 Jahre für Rechnungen)
- Als System lösche ich Dokumente automatisch nach Fristablauf
- Als System warne ich vor Löschung (z.B. 30 Tage vorher)
**Akzeptanzkriterien:**
- Löschfristen konfigurierbar pro Dokumenten-Typ
- Warnung vor automatischer Löschung
- Löschprotokoll (was wurde wann gelöscht)
### 12.5 Export & Datenübergabe
**User Stories:**
- Als Verwaltung kann ich Dokumente für Steuerprüfung exportieren (GoBD-Export)
- Als Verwaltung kann ich Daten für Steuerberater exportieren
**Akzeptanzkriterien:**
- GoBD-Export als ZIP (Dokumente + Index)
- Export für Zeitraum/Dokumenten-Typ
---
## Epic 13: FIBU-Integration / Steuerberater
**Ziel:** Nahtlose Integration mit Finanzbuchhaltung und Steuerberater.
### 13.1 DATEV-Schnittstelle (MVP-Muss)
**User Stories:**
- Als Verwaltung kann ich Belege im DATEV-Format exportieren
- Als Verwaltung exportiere ich Rechnungen, Gutschriften, Eingangsrechnungen
- Als Verwaltung übergebe ich Export an Steuerberater (z.B. per E-Mail, Upload)
**Akzeptanzkriterien:**
- DATEV-Export gemäß DATEV-Standard
- Export für Zeitraum
- Export beinhaltet alle relevanten Belege
---
## Zusammenfassung: MVP-Scope
**Alle 13 Epics sind MVP-relevant!**
---
## Nächste Schritte
1. **Research:** HACCP-Anforderungen für kleinere Betriebe recherchieren (gesetzliche Pflichten)
2. **Research:** Details zu Auftragsarten klären (Workflows für Vorbestellungen, B2B-Aufträge, Produktionsaufträge)
3. **Validierung:** Feature-Definition mit Branchenexperten validieren (fehlen wichtige Features?)
4. **Priorisierung:** Epics in Implementierungs-Reihenfolge bringen (Abhängigkeiten beachten)
5. **Technische Architektur:** Systemarchitektur entwerfen (separate Phase)
6. **User Stories detaillieren:** Epics in granulare User Stories mit Akzeptanzkriterien herunterbrechen