# MASTER PROMPT – Berichtsheft Generator Du bist der Implementierungs-Agent für den **Berichtsheft-Generator** von Nico Baumann. ## Produktziel Lokale Website (`web/`), mit der man **Wochen-Ausbildungsnachweise** erzeugt – ohne selbst zu tippen. - Ausbildung: **Kaufmann/Kauffrau für Büromanagement** in einer **Kfz-Firma** - Name: **Nico Baumann**, Abteilung **43180** - Start nach letztem fertigen Heft: nach **03.04.2026** → Woche **Nr. 79** (`06.04.–10.04.2026`) - Nur **Wochenberichtshefte** (keine Tages-UI zum Schreiben) - User wählt nur **Vorschläge** (4 random / mehr / auto-füllen) - Export: **DOCX + PDF** - Nach fertiger Woche → automatisch **nächste Woche** ## Harte Regeln 1. **Echte Word-Vorlage nutzen** Die bestehenden Dateien in `1. Ausbildungsjahr/` und `2. Ausbildungsjahr/` sind die Vorlage. Nicht ein eigenes, „ähnliches“ Layout erfinden. Export muss Layout, Schriften, Tabellen, Abschnitte und Feldstruktur der echten Hefte übernehmen (Kopie einer Vorlage + Inhalte ersetzen). 2. **Vorschläge nur aus echten Heften** Formulierungen, Länge, Ton, typische Tätigkeiten und Schulthemen müssen aus den vorhandenen Berichtsheften kommen (extrahieren + stilgleiche Varianten). Keine generischen Büro-Klischees, die in den Heften nicht vorkommen. 3. **Nichts tippen** Keine freien Textfelder für Tätigkeiten. Nur Vorschläge antippen / neu würfeln / auto-füllen. 4. **Kalender** - Di + Do = Berufsschule - BW-Schulferien = ganze Woche Betrieb (auch Di/Do) - Feiertage BW markieren - Sa/So überspringen 5. **Bestehende Hefte nicht überschreiben** Originale in `1. Ausbildungsjahr/` / `2. Ausbildungsjahr/` bleiben unangetastet. Neue Exporte z. B. nach `export/2. Ausbildungsjahr/`. 6. **Sprache** UI und Nutzerkommunikation auf Deutsch. Code/Kommentare klar und knapp. 7. **Plan-Datei** `.cursor/plans/*.plan.md` nicht editieren, außer der User verlangt es. ## Aktueller Stand (Ist) - Vite + React + TS in `web/` - Wochen-UI existiert, Vorschläge ~788, teilweise aus Extraktion - **Problem:** DOCX wird mit `docx`-Library neu gebaut → sieht **nicht** wie die echte Vorlage aus - **Problem:** Vorschläge können noch besser an Stil/Frequenz/Vollständigkeit der echten Hefte ## Soll (Priorität) 1. Word-Export = echte Vorlage befüllen 2. Vorschlägequalität massiv anheben (nur echte Phrasen + kontrollierte Varianten) 3. UI weiter vereinfachen (Woche → Vorschläge → Export) 4. PDF optisch möglichst nah an derselben Struktur ## Definition of Done (gesamt) - [ ] DOCX öffnet sich und sieht aus wie ein Heft aus Jahr 1/2 (gleiche Vorlage) - [ ] Dateiname wie bisher: `Berichtsheft DD.MM - DD.MM.YYYY (N).docx` - [ ] Vorschläge wirken wie aus Nicos Heften (Wörter, Orte, Abläufe) - [ ] User muss nichts tippen - [ ] Eine fertige Woche → nächste Woche - [ ] Di/Do Schule, Ferien = Betrieb - [ ] `npm run build` erfolgreich ## Arbeitsweise - Eine Teilaufgabe nach der anderen aus `prompts/teilaufgaben/` - Vor Code: relevante Dateien + 2–3 echte `.docx` ansehen - Nach Änderung: build prüfen, kurz manuell testen - Keine unnötigen Markdown-Dateien außerhalb von `prompts/`