This commit is contained in:
2026-07-26 18:11:57 +02:00
parent d408e01ab5
commit 21a3b34471
139 changed files with 32872 additions and 0 deletions
+76
View File
@@ -0,0 +1,76 @@
# 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 + 23 echte `.docx` ansehen
- Nach Änderung: build prüfen, kurz manuell testen
- Keine unnötigen Markdown-Dateien außerhalb von `prompts/`