Files
berichtsheftgenerator/prompts/teilaufgaben/01-word-vorlage.md
T
2026-07-26 18:11:57 +02:00

61 lines
2.3 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 01 Echte Word-Vorlage nutzen
Lies zuerst `prompts/00-MASTER.md`. Dann setze genau diese Aufgabe um.
## Problem
Der aktuelle Export in `web/src/lib/exportDocx.ts` baut ein **neues** Dokument mit der `docx`-Library.
Das sieht **nicht** aus wie die echten Hefte in:
- `1. Ausbildungsjahr/*.docx`
- `2. Ausbildungsjahr/*.docx`
## Ziel
Neue Berichtshefte müssen die **identische Vorlage** der bestehenden Ausbildungsnachweise verwenden.
## Vorgehen
1. Nimm eine saubere Vorlage aus den vorhandenen Heften, z.B.
`2. Ausbildungsjahr/Berichtsheft 23.03 - 27.03.2026 (77).docx`
Kopiere sie nach `web/public/templates/ausbildungsnachweis.docx` (oder `web/src/assets/templates/`).
2. Analysiere `word/document.xml`: Welche Textstellen müssen ersetzt werden?
- Abteilung / Nr. / Zeitraum / Ausbildungsjahr
- Name / Datum
- Tägliche Tätigkeiten (Bullet-Liste)
- Lfd. Nr. Ausbildungsrahmenplan
- Thema der Woche
- Berufsschule (Themen oder „Ferien“)
- Unterschriftsdatum
3. Implementiere Befüllung durch **Vorlagen-Kopie + Textersetzung** (bevorzugt):
- Option A: `docxtemplater` + `pizzip` mit Platzhaltern in einer vorbereiteten Template-Kopie
- Option B: ZIP öffnen, in `document.xml` gezielt ersetzen, wieder packen
- Option C: `docx-templates` / ähnlich
**Nicht** akzeptabel: komplett neues Layout mit `new Document({...})` ohne die Original-Styles/Tabellen.
4. Erhalte:
- Schriften, Abstände, Tabellen, Ränder der Vorlage
- Zweispaltige/strukturierte IHK-Optik wie in den Originalen
- Dateiname: `Berichtsheft DD.MM - DD.MM.YYYY (N).docx`
5. Speichern/Download im Browser; Originale nicht überschreiben.
Optional zusätzlich nach `export/2. Ausbildungsjahr/` schreiben, wenn Node-seitig möglich Download reicht.
6. Feiertage in der Tätigkeitsliste wie in Originalen vermerken (z.B. `Freitag Feiertag`).
## Abnahme
- [ ] Exportierte DOCX neben ein Original legen → optisch gleich (Vorlage erkennbar)
- [ ] Inhalte der aktuellen Woche stehen korrekt drin
- [ ] `npm run build` ok
- [ ] Kurzer Hinweis in Commit-/Antwort: welcher Template-Pfad genutzt wird
## Nicht tun
- Eigenes „ähnliches“ Layout designen
- PDF in dieser Teilaufgabe priorisieren (kommt in 05)
- Alte Hefte im Quellordner ändern