gute

2026-07-26 18:11:57 +02:00
parent d408e01ab5
commit 21a3b34471
139 changed files with 32872 additions and 0 deletions
@@ -0,0 +1,59 @@
+# Teilaufgabe 06 – Qualität / Endcheck
+
+Lies zuerst `prompts/00-MASTER.md`. Führe diesen Check aus, wenn 01–05 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, Di–Fr 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 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