# Planungspipeline — Flussdiagramm

Dieses Diagramm ist **nicht normativ**; bei Abweichung gilt Kanonik `ebenenvertrag.md` im Vault `wissen-ki-und-mehr/01_Bildung/20_Planung/planung-pipeline/`.

Stand: 14.09.2026. **Kompakt (Chat):** [`planung-pipeline-fluss-kompakt.md`](planung-pipeline-fluss-kompakt.md) · Druck/HTML: [`planung-pipeline-fluss.html`](planung-pipeline-fluss.html) · Hub [`schuljahresablauf.html`](Sj_2026-2027/Lein/schuljahresablauf.html).

---

## Gesamtfluss (kompakt)

Siehe [`planung-pipeline-fluss-kompakt.md`](planung-pipeline-fluss-kompakt.md).

## Gesamtfluss (ausführlich)

```mermaid
flowchart TB
  subgraph S0["Stufe 0 — Materialfundament"]
    direction TB
    E0[Erfassen<br/>DUA / PDF]
    X0[Extrahieren<br/>pdf_extraktor.py]
    A0[Spread-Analyse<br/>JSON pro Doppelseite]
    I0[index.json<br/>status: ready]
    K0[kapitelkarte.md<br/>aus Analysen]
    E0 --> X0 --> A0 --> I0 --> K0
  end

  subgraph S1["Stufe 1 — Schuljahr"]
    J1[stoffverteilung-schuljahr-*.md<br/>Zeitgerüst, LeBe]
  end

  subgraph S2["Stufe 2 — Epoche"]
    E2[stoffverteilung-bis-*.md<br/>Ferienschnitt, Sequenz-Index]
    U2[kapiteluebersicht-bis-*.md<br/>Analyse-Status optional]
  end

  subgraph S3["Stufe 3 — Sequenz"]
  direction TB
    B3{Briefing?}
    SK3[Stoffkern]
    LW3[Lernweg]
    M3[Methodenprofil]
    S3F[einheit-*-ueberblick.md<br/>SMART, UE-Tabelle]
    B3 -->|neuer Gehalt| SK3
    B3 -->|Skip| S3F
    SK3 --> LW3 --> M3 --> S3F
  end

  subgraph S4["Stufe 4 — Stunde"]
    direction TB
    B4{Briefing?}
    SK4[Stoffkern-Schnitt]
    LW4[Lernweg-Schnitt]
    M4[Methodenentscheidung]
    ST4[stunde-*.md<br/>Verlauf (Spread-Analysen gelesen)]
    P4[Pultblatt]
    T4[Transparenz-Tafel]
    B4 -->|neuer Gehalt| SK4
    B4 -->|Skip| ST4
    SK4 --> LW4 --> M4 --> ST4 --> P4 --> T4
  end

  subgraph NACH["Eigene Läufe"]
    SUS[SuS-Material HTML<br/>Print-Guardrail]
  end

  HUB[schuljahresablauf-hub]

  K0 -.->|optional| J1
  K0 -.->|optional| E2
  I0 -.->|Gate Deutsch| S3
  J1 --> E2
  E2 --> S3
  S3F --> S4
  E2 --> HUB
  S3F --> HUB
  ST4 --> HUB
  ST4 --> SUS

  style S0 fill:#e8f4fc,stroke:#2563eb
  style I0 fill:#fef3c7,stroke:#d97706
  style K0 fill:#fef3c7,stroke:#d97706
```

---

## Gates und Skills

Gate je Fach und Stufe: Vault `material-fundament.md` (Ordner `planung-pipeline` im Workspace `wissen-ki-und-mehr`).

```mermaid
flowchart LR
  subgraph Skills
    MF[material-fundament]
    UP[unterrichtsplanung-pipeline]
    SH[schuljahresablauf-hub]
    PD[stunden-pult-druck]
    TT[stunden-transparenz-tafel]
    PG[arbeitsblatt-print-guardrail]
  end

  MF -->|index.json ready| UP
  UP -->|Stufe 3/4| SH
  UP -->|Stufe 4| PD --> TT
  UP -.->|nach Stufe 4| PG

  style MF fill:#dbeafe
  style UP fill:#dcfce7
```

---

## Briefing (Stufe 3 und 4)

```mermaid
flowchart TD
  R[Ready: Dateien + Spread-Analyse] --> S{Skip Briefing?}
  S -->|ja| W[Artefakt schreiben]
  S -->|unklar| F[nachfragen]
  F --> S
  S -->|nein: neuer Gehalt| G[Briefing stoppen]
  G --> H{passt?}
  H -->|warten| G
  H -->|ja| K[Stoffkern, Lernweg]
  H -->|Escape: Kopfzeile| K
  K --> M[Methodenprofil / Methodenentscheidung]
  M --> W
  W --> P[Pult / Transparenz / Planungsübersicht]
```

Briefing ist **kein** Ersatz für Stufe 0. Stoffkern baut auf Materialanalyse, nicht auf Inhaltsverzeichnis.

---

## Artefakt-Kette (Dateien)

```mermaid
flowchart LR
  IDX[index.json]
  KK[kapitelkarte.md]
  EP[Epoche .md]
  SEQ[einheit-ueberblick.md]
  STD[stunde-*.md]
  HTML[SuS-HTML]

  IDX --> KK
  KK --> SEQ
  EP --> SEQ
  SEQ --> STD
  STD --> HTML

  style IDX fill:#fef3c7
  style KK fill:#fef3c7
```

**Nicht in der Planungsübersicht:** `index.json`, `kapitelkarte.md`, `kapiteluebersicht-bis-*.md`.