berichtsheftgenerator/prompts/teilaufgaben/06-qualitaet.md

Teilaufgabe 06 – Qualität / Endcheck

Lies zuerst prompts/00-MASTER.md. Führe diesen Check aus, wenn 01–05 weitgehend fertig sind.

Checkliste

Vorlage

• DOCX basiert auf echter Vorlage aus Jahr 1/2 (nicht freies Layout) — web/public/templates/ausbildungsnachweis.docx + PizZip-Befüllung in exportDocx.ts
• Optischer Vergleich: neues Heft vs. Berichtsheft 23.03 - 27.03.2026 (77).docx — manuell noch offen (Browser-Smoke/Download in dieser Session nicht möglich)
• Originale unverändert — Ordner 1./2. Ausbildungsjahr/ nicht angefasst; Vorlage ist Kopie unter web/public/templates/

Vorschläge

• Phrasen aus echten Heften, Stichprobe ok (788 Einträge; Stichprobe: Kasse, Rechnungen, Spülmaschine, Berufsschule-Themen)
• Kein XML-/Nummern-Müll (Scan: 0 Treffer auf XML/Müll-Muster)
• Gewichtung / keine harten Wochen-Duplikate (usedSuggestionIds + Text-Ausschluss in pickRandomSuggestions)

UX

• Nichts tippen für Inhalt (keine Textfelder für Tätigkeiten)
• 4/8 neue + Auto-füllen
• Nach Export nächste Woche (finishWeek setzt currentWeekMonday auf nextWeekMonday)
• Reset-Funktion klar („Fortschritt zurücksetzen“ mit Confirm)

Kalender

• Woche 79 Ferien/Feiertag korrekt (06.04. Ostermontag/Feiertag, Di–Fr Betrieb + Osterferien; Schule = Ferien)
• Schulwoche Di/Do Schule (z. B. 13.–17.04.2026)

Technik

• npm run build grün (nach Fix: ungenutzter Param in exportPdf.ts, Vitest-Config aus vite.config.ts entfernt, Tests aus tsc-Include ausgeschlossen)
• Keine sensiblen Secrets (keine .env/Keys im Workspace)
• localStorage-Key stabil dokumentiert (berichtsheft-generator-v2 → prompts/README.md + exportierte STORAGE_KEY)

Smoke-Test (manuell)

1. App starten (cd web && npm run dev)
2. Fortschritt zurücksetzen
3. Woche 79 → automatisch füllen → DOCX+PDF
4. Datei öffnen und mit Original vergleichen
5. Prüfen, dass Woche 80 erscheint

Status Smoke: Dev-Server gestartet; UI-Automatisierung (Browser-MCP) in dieser Session nicht verfügbar. Logik für Schritte 2–5 per Code/Kalender-Tests abgesichert; Schritt 4 (optischer DOCX-Vergleich) bleibt manuell.

Ergebnis

Stand Endcheck (26.07.2026):

Erfüllt

• Vorlage-Pipeline: echte DOCX-Kopie + XML-Befüllung (nicht mehr new Document freies Layout)
• UX/Kalender/Vorschläge/Build/localStorage wie oben abgehakt
• Woche 79/80-Regeln und Feiertagszeile durch calendar.test.ts spezifiziert

Noch offen

1. Manueller Optik-Check Export-DOCX neben Heft 77 legen (gleiche Tabellen/Schriften/Abschnitte)
2. Vitest-Integration in vite.config.ts wiederherstellen, sobald vitest-Install/Types zuverlässig sind (npx vitest run separat möglich)
3. Optional: vollständigen UI-Smoke (Reset → Auto-füllen → Export → Woche 80) einmal im Browser durchklicken

Nächste Schritte

1. Ein Export aus Woche 79 erzeugen und optisch mit 2. Ausbildungsjahr/Berichtsheft 23.03 - 27.03.2026 (77).docx vergleichen
2. Bei Abweichungen nur exportDocx.ts / Template-Befüllung nachschärfen (Originale nicht ändern)
3. Vitest sauber verdrahten (defineConfig aus vitest/config + Types), wenn npm-Install stabil ist