Files
berichtsheftgenerator/prompts/teilaufgaben/06-qualitaet.md
T
2026-07-26 18:11:57 +02:00

60 lines
3.2 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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.
# Teilaufgabe 06 Qualität / Endcheck
Lies zuerst `prompts/00-MASTER.md`. Führe diesen Check aus, wenn 0105 weitgehend fertig sind.
## Checkliste
### Vorlage
- [x] 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)
- [x] Originale unverändert — Ordner `1./2. Ausbildungsjahr/` nicht angefasst; Vorlage ist Kopie unter `web/public/templates/`
### Vorschläge
- [x] Phrasen aus echten Heften, Stichprobe ok (788 Einträge; Stichprobe: Kasse, Rechnungen, Spülmaschine, Berufsschule-Themen)
- [x] Kein XML-/Nummern-Müll (Scan: 0 Treffer auf XML/Müll-Muster)
- [x] Gewichtung / keine harten Wochen-Duplikate (`usedSuggestionIds` + Text-Ausschluss in `pickRandomSuggestions`)
### UX
- [x] Nichts tippen für Inhalt (keine Textfelder für Tätigkeiten)
- [x] 4/8 neue + Auto-füllen
- [x] Nach Export nächste Woche (`finishWeek` setzt `currentWeekMonday` auf `nextWeekMonday`)
- [x] Reset-Funktion klar („Fortschritt zurücksetzen“ mit Confirm)
### Kalender
- [x] Woche 79 Ferien/Feiertag korrekt (06.04. Ostermontag/Feiertag, DiFr Betrieb + Osterferien; Schule = Ferien)
- [x] Schulwoche Di/Do Schule (z.B. 13.17.04.2026)
### Technik
- [x] `npm run build` grün (nach Fix: ungenutzter Param in `exportPdf.ts`, Vitest-Config aus `vite.config.ts` entfernt, Tests aus `tsc`-Include ausgeschlossen)
- [x] Keine sensiblen Secrets (keine `.env`/Keys im Workspace)
- [x] `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 25 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