# templates-de — Deutschsprachige slohmaier Dokument-Vorlagen

Zentrale Sammlung wiederverwendbarer Dokument-Vorlagen. Sowohl Word (für formelle
Freigabe / ISO-9001-Audits / Kunden-Lieferung) als auch Markdown (für lebendige
Engineering-Artefakte mit Git-Diff und Traceability).

> **Herkunft (2026-07-31):** Dieser Ordner lag bis dahin als `vorlagen/` im
> ownCloud-Share `~/ownCloud/Persönlich/slohmaier.com/` — ohne Versionskontrolle.
> Er ist hierher gezogen, weil dieses Repo laut eigener Beschreibung bereits
> „ASPICE 4.0 / ISO 26262 Methodik, **Vorlagen**, Tools" hält; ein zweiter
> Vorlagen-Ort wäre ein Duplikat gewesen.
>
> **Verhältnis zu `templates/` und `templates-word/`:** Das sind dieselben
> Vorlagen, seit Commit `247b831` ins Englische übersetzt und umbenannt
> (`*-vorlage` → `*-template`). `templates-de/` ist der deutschsprachige
> Stand. Beide sind gültig — wähle die Sprache, in der das Dokument geliefert
> wird. Wer eine Vorlage inhaltlich ändert, muss beide Sprachstände nachziehen.
>
> `slohmaier-doc-template.docx` ist **nicht** mit umgezogen: die ownCloud-Datei
> war byte-identisch (MD5 `31b2d074…`) mit dem bereits im Repo liegenden
> `templates-word/slohmaier-doc-template.docx`.

## Struktur

```
templates-de/
├── business/                       Vertrieb + Kommunikation
│   ├── angebot-vorlage.{md,docx}
│   └── angebot-beispiel.html
│
├── projekt/                        Projektplanung (für jedes neue Projekt)
│   ├── PID-vorlage.{md,docx}              Project Initiation Document
│   ├── PM-Plan-vorlage.{md,docx}          Projektmanagement-Plan
│   ├── QA-Plan-vorlage.{md,docx}          Qualitätssicherungs-Plan
│   ├── SWE-Plan-vorlage.{md,docx}         Software Development Plan
│   └── Test-Plan-vorlage.{md,docx}        Teststrategie
│
├── qualitaet/                      QM / Audit / Compliance
│   ├── Review-Protokoll-vorlage.{md,docx}
│   ├── Non-Conformity-vorlage.{md,docx}
│   ├── MISRA-Deviation-Permit-vorlage.{md,docx}
│   └── MISRA-Deviation-Record-vorlage.{md,docx}
│
└── engineering/                    Anforderungen + Architektur (nur Markdown)
    ├── SA-vorlage.md                       System-Architektur-Element
    ├── SWA-vorlage.md                      Software-Architektur-Element
    └── Traceability-Matrix-vorlage.md
```

## Master-Word-Template

`../templates-word/slohmaier-doc-template.docx` ist die Grundlage aller
Word-Vorlagen. Enthält:

- Deckblatt (Projekt, Dokument-ID, Version, Klassifikation)
- Document Control (Freigaben, Änderungshistorie, Verteiler) — ISO-9001-konform
- Auto-Verzeichnisse (Inhalt, Abbildungen, Tabellen, Abkürzungen)
- Formatvorlagen: H1–H4, Body, Code, Note, Warning, Requirement
- Header/Footer mit Projekt, Dokument-ID, Klassifikation, Seitennummer

Bei neuem formellem Dokument: **Master-Template kopieren → ausfüllen.** Oder die
fertigen `*-vorlage.docx` als Startpunkt nehmen, die schon den passenden Inhalt
strukturiert haben.

## Word vs Markdown — welches Format wann?

| Verwendung                                | Format    |
|-------------------------------------------|-----------|
| Freigabe, Unterschrift, Audit-Lieferung   | **Word**  |
| Lebendige Anforderungen, Doorstop-Diff    | **Markdown** |
| Architektur mit PlantUML, in Gitea geprüft| **Markdown** |
| Kunden-PDF aus Engineering-Markdown       | Markdown + pandoc-Export |

## Source-of-Truth & Neugenerierung

Die Word-Vorlagen werden aus den Markdown-Vorlagen per pandoc generiert. Der
Source liegt in **diesem** Repo — seit dem Umzug gibt es keine ownCloud-Kopie
mehr, aus der man nachziehen müsste.

- **Methodik-Repo:** https://gitea.slohmaier.com/slohmaier/dev-process
- **Lokal:** `~/git/dev-process/`
- **Generieren (englischer Stand):** `python3 tools/build_word_template.py && bash tools/generate_word_templates.sh`

Wenn du die Vorlagen anpasst:
1. Markdown editieren — `templates/<datei>.md` (EN) bzw. `templates-de/<bereich>/<datei>.md` (DE)
2. Word-Versionen mit den Skripten oben neu erzeugen
3. Beide Versionen committen + pushen

> Die Generator-Skripte in `tools/` erzeugen bislang nur den englischen Stand
> nach `templates-word/`. Die `.docx` unter `templates-de/` sind der zuletzt
> von Hand erzeugte deutsche Stand und werden noch nicht automatisch gebaut.

## Einsatz im neuen Projekt

```bash
# Beispiel-Workflow
git clone https://gitea.slohmaier.com/slohmaier/dev-process.git ~/git/dev-process
mkdir mein-neues-projekt && cd mein-neues-projekt && mkdir -p docs
cp ~/git/dev-process/templates-de/projekt/PID-vorlage.docx      docs/PID.docx
cp ~/git/dev-process/templates-de/projekt/SWE-Plan-vorlage.docx docs/SWE-Plan.docx
# ... ausfüllen mit Projekt-Inhalt
```

Beispiel eines vollständig angewandten Templates: https://gitea.slohmaier.com/slohmaier/demo-epb