# Kapitelstruktur - Mapping Fortna-Referenz

Abgeleitet aus dem realen Projekt Fortna (doc/Fortna.txt, 374 Dateien, 123 Ordner).
Angepasst auf deutsche Ordnernamen, Sprachtrennung auf Top-Level.

## Kapitel-Uebersicht

| Nr | Ordner | Inhalt | Fortna-Quelle |
|----|--------|--------|---------------|
| 00 | `00_inhaltsverzeichnis` | Inhaltsverzeichnis, Dokumentennotizen | 00_CONTENTS_NOTES |
| 01 | `01_zertifikate` | CE/UKCA-Konformitaetserklaerungen, Konfigurationsbeschreibung | 01_CERTIFICATES |
| 02 | `02_sicherheit` | Allgemeine Sicherheit, Normen, Risikobewertung | (neu, teilweise 04_TECHNICAL_DOC) |
| 03 | `03_anlagenbeschreibung` | Maschinenmodule (via meta.yaml eingefuegt) | (neu) |
| 04 | `04_betrieb` | Betriebsanleitung | 02_INSTRUCTIONS (Betriebsanleitung) |
| 05 | `05_wartung` | Wartungsanleitung, Schmierplan | 02_INSTRUCTIONS (Wartungsanleitung) |
| 06 | `06_steuerung` | Funktionsbeschreibungen Steuerung | 02_INSTRUCTIONS (Funktion_Steuerung_*) |
| 07 | `07_ersatzteile` | Ersatzteillisten | 03_SPARE_PARTS |
| 08 | `08_lieferantendoku` | Lieferantendokumentation | 05_SUPPLIER_DOC |
| 09 | `09_technische_unterlagen` | Layouts, Schaltplaene, Not-/Bereichsstopp | 04_TECHNICAL_DOC |
| 10 | `10_anhang` | Pruefberichte, Abnahmeprotokolle | 04_TECHNICAL_DOC/REPORTS |

## Detailstruktur

### 00_inhaltsverzeichnis

Wird vom Build-Prozess generiert. Enthaelt Gesamtinhaltsverzeichnis und ggf. Dokumentennotizen/Revisionshistorie.

### 01_zertifikate

```text
01_zertifikate/
  konformitaetserklaerung/   # CE-/UKCA-Erklaerungen (Fortna: 01_SCHOENENBERGER)
  konfigurationsbeschreibung/ # Konfigurationsbeschreibung fuer CE (Fortna: 02_KONFIGURATIONSBESCHREIBUNG)
```

Fortna-Beispieldokumente:
- EC Declaration of Conformity_V2_EN.pdf
- Konfigurationsbeschreibung_fuer_CE_V2.pdf

### 02_sicherheit

```text
02_sicherheit/
  allgemein/          # Allgemeine Sicherheitshinweise
  normen/             # CE (EU), UKCA (UK) - je nach normen_region in anlage.json
  risikobewertung/    # Risikomatrizen, Gefahrenanalysen
```

### 03_anlagenbeschreibung

Keine feste Unterstruktur - Module werden hier durch den Build-Prozess via meta.yaml eingefuegt. Jedes Modul liefert seine Beschreibung, technische Daten etc.

### 04_betrieb

```text
04_betrieb/
  betriebsanleitung/  # Fortna: 01_BETRIEBSANLEITUNG_500592_V2.3.pdf
```

Fortna-Beispieldokumente:
- BETRIEBSANLEITUNG_500592_V2.3.pdf

### 05_wartung

```text
05_wartung/
  wartungsanleitung/  # Fortna: 02_WARTUNGSANLEITUNG_500592_V2.2.pdf
  schmierplan/        # Schmierstellen, Intervalle, Schmiermittel
```

### 06_steuerung

```text
06_steuerung/
  (pro Steuerungssystem ein Unterordner)
  ils/                # Fortna: 03_FUNKTION_STEUERUNG_ILS_500592_V2.1.pdf
  omniflo/            # Fortna: 04_FUNKTION_STEUERUNG_OMNIFLO_500592_V1.0.pdf
  loading_loop/       # Fortna: 05_FUNKTION_STEUERUNG_LoadingLoop_500592_V2.2.pdf
```

Unterordner werden projektspezifisch angelegt je nach verbauten Steuerungssystemen.

### 07_ersatzteile

Ersatzteillisten, ggf. mit Explosionszeichnungen.

Fortna-Beispiel: SPARE_PARTS_500592_EN_V2.1.pdf

### 08_lieferantendoku

```text
08_lieferantendoku/
  antriebe/                  # SEW, NORD, Leantechnik (Anleitungen + Datenblaetter)
  elektrik/                  # Siemens, Leuze, Cognex, Werma, Phoenix, Murrelektronik, etc.
  pneumatik/                 # Aventics, ITS
  stahlbau/                  # MiTek (As-Built, Statik, Zertifikate, Handover)
  sicherheitseinrichtungen/  # ABS Sicherheitslinie, Schmersal etc.
```

Fortna-Lieferanten (Beispiele):
- SEW: Motor/Getriebe-Anleitungen, Movimot-DBC
- NORD: Getriebe/Motor LoadingLoop
- Siemens: 60+ Datenblaetter (SPS, HMI, Schuetze, Sicherungen)
- Leuze: Sensoren (Datenblaetter + CE-Zertifikate)
- Cognex: Scanner (DM280, DM370 Referenzhandbuecher)
- MiTek: Stahlbau (As-Built, Structural Calcs, Steel/Bolt/Paint Certs, RAMS, Handover)
- ABS: Sicherheitslinie (Anleitungen, Montage, Pruefbuch, Zeichnungen, Zertifikate)
- Aventics: Pneumatik (Filter, Druckregler, Absperrventil, Verteiler)

### 09_technische_unterlagen

```text
09_technische_unterlagen/
  layouts/
    mechanisch/       # Fortna: 04_TECHNICAL_DOC/01_LAYOUT/01_MECHANICAL
    elektrisch/       # Fortna: 04_TECHNICAL_DOC/01_LAYOUT/02_ELECTRICAL
  schaltplaene/       # Fortna: 04_DIAGRAMS (pro Steuerungsbereich/Controlarea)
  notstopp/           # Fortna: 03_EMERGENCY_STOP (Plaene + E-Stop-Matrix)
  bereichsstopp/      # Fortna: 02_AREA_STOP
```

Fortna-Beispieldokumente:
- Layout: 500592_10_5.14_Layout_V2.1_EN.pdf, Bereiche_V2.1_EN.pdf
- Schaltplaene: Circuit diagrams_Controlarea 1-7_EN.pdf (je Steuerungsbereich)
- Notstopp: ES500592_10_5-14_ILS-OF_cpl.-E-Stop-[EN].pdf + Emergency_Stop_Matrix_V1.5.pdf
- Bereichsstopp: ES500592_10_5-14_ILS-OF-Area-Stop-cpl.-[EN].pdf

### 10_anhang

```text
10_anhang/
  pruefberichte/       # Fortna: 04_TECHNICAL_DOC/05_REPORTS
  abnahmeprotokolle/   # Abnahmedokumentation
```

Fortna-Beispieldokumente:
- Schutz_gegen_automatischen_Wiederanlauf_V1.1.pdf
- Drehrichtung_Asynchronmotoren.pdf
- Erprobung_Anzeige_Bediengeraete.pdf

## Sprachtrennung

Fortna verwendet Unterordner pro Sprache innerhalb jedes Kapitels:
`01_DE_original/`, `02_EN/`, `03_CZ/`

Neues Konzept: Pro Sprache ein kompletter Dokumentenbaum auf Top-Level:
- `chapters/` = Deutsche Dokumentation (Standard/Master)
- Zukuenftig: `chapters_en/`, `chapters_cz/` etc. als eigenstaendige Kopien

Fallback-Mechanismus: Fehlt ein Dokument in einer Fremdsprache, wird die deutsche Version verwendet.


## Heutige Checkliste für die nötigen Dokumente aus der Automation

### 1. Layout Elektrik

- Elektrolayout
- Layout Kabelpritsche und Erdung

### 2. Schaltplan & Pneumatikplan

- Schaltplan (WSCAD Elektrisch)
- Pneumatikplan (WSCAD Elektrisch)
- PDF-Ausgabe
- Projektsicherung im WSCAD-Format

### 3. Layout Pneumatik

- Verschlauchungsplan

### 4. Ersatzteilliste Elektrik

- Ersatzteilliste für elektrische Komponenten als PDF-Dokument

### 5. Dokumentationen Elektrolieferanten

- Ablage der Datenblätter
- Dokumentationen der Elektrolieferanten

### 6. Netzwerkstrukturplanung

- Netzwerkstrukturplanung (ProNetPlan / WSCAD)

### 7. Betriebsanleitung Steuerung

- Bedienhandbuch
- Steuerungsanleitung

### 8. Software-Daten SPS

- SPS-Projektdaten mit Sicherung
- PDF-Ausdruck des SPS-Programms

### 9. Sicherheitsausdruck SPS

- Sicherheitsausdruck der SPS-Software

### 10. Prüfprotokoll externe Gewerke

- Prüfprotokolle für externe Gewerke im eigenen Lieferumfang (z. B. Brandschutztüre)

### 11. Sistema Sicherheitsbetrachtung

- Sicherheitsbetrachtung gemäß Sistema als PDF-Dokument

### 12. Prüfprotokolle Schaltschränke

- Prüfprotokolle der Schaltschrankprüfung als PDF-Dokument

### 13. Lizenzen

- Softwarelizenzen (z. B. Sinamics, TIA Portal, OPC UA)

### 14. Abschaltmatrix

- Emergency-Stop-Matrix (Abschaltmatrix) als PDF-Dokument

### 15. Layout Sicherheitsbereiche

- Layout der Sicherheitsbereiche zur Abschaltmatrix

### 16. Validierungsprotokolle

Unterschriebene Validierungsprotokolle, bestehend aus:

#### 16.1 Prüfprotokoll ortsfester Arbeitsmittel
- Elektrische Prüfung ortsfester Arbeitsmittel

#### 16.2 Erprobung Wiederanlauf
- Schutz gegen automatischen Wiederanlauf

#### 16.3 Erprobung Drehrichtung Motoren
- Test der Drehrichtung der Asynchronmotoren

#### 16.4 Berechnung Fehlerschleifenimpedanz / Validierung Erdung
- Berechnung der Fehlerschleifenimpedanz
- Erdungsvalidierung

#### 16.5 Erprobung Anzeige- und Bediengeräte
- Test der Anzeige- und Bediengeräte


# Fragen und TODOs

- [ ] Wie ist der Standardablauf der Dokumentation bisher? 
- [ ] Wer ist wann daran bei einem einfach Projekt daran beteiligt?
- [ ] Was wäre bei einer Automatisierung der Dokumentations- Erstellung für die wünschenswert?
- [ ] Welche Ausnahmen sind üblich, fehlt oft oder ist nicht immer dabei? 
- [ ] für wen ist die Dokumentation gedacht, bzw. was erwarten diese Leute zu finden?
- [ ] Welche Detailierungstiefe bei den Produkten ist nötig oder gewollt?
- [ ] soll die aktuelle Kapitelstruktur mit nur 4 Kapiteln beibehalten werden oder könnten wir dies auf ca. 7 - 10 Kapitel erweitern (siehe Vorschlag)?
- [ ] in welchem Kapitel sollen die jeweiligen Dokumente aus der Automation landen?
- [ ] Wie läuft die Ersatzteilfindung nach der Dokumentation statt?
- [ ] Wie die Behandlung einer Anlage bei Fehler oder Störungen?
- [ ] Welche Daten des Produktprogrammes sollen in die Dokumentation eingang finden?
- [ ] Welche Abteilung liefert normalerweise was in der Dokumentation (Liste Automation ist vorhanden, Was passiert bei Sonderkonstruktionen)?