berichtsheftgenerator/prompts/00-MASTER.md

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/