# Seitenansicht und PDF-Export

Die Seitenansicht ist rein lesend und verändert keine Projektdaten.

## Aufruf

- Projektseite → Button **Seitenansicht** öffnet
  `/projects/:projectId/print` in einem neuen Tab.
- **Als PDF speichern / Drucken** nutzt den Druckdialog des Browsers
  (Ziel „Als PDF speichern“). Der Dokumenttitel `Leistungsbilanz – <Projekt>`
  wird als Dateiname vorgeschlagen.
- **Planformat** schaltet die Verteilerpläne zwischen A4 quer und A3 quer um.
  Deckblatt bleibt A4 hoch.
- **Büroangaben** pflegt Büroname und Büroanschrift (Planverfasser, für alle
  Projekte).
- **Logo hinterlegen / ersetzen / entfernen** verwaltet das Büro-Logo.

## Seiten

1. **Deckblatt (A4 hoch)** – tabellarisch: Projekt, Planverfasser, Dokument,
   Planstände (aus benannten Sicherungspunkten) und Inhalt. Leere Angaben
   erscheinen als orangefarbenes „[ergänzen]“.
2. **Verteilerübersicht (quer)** – Versorgungsstruktur und Tabelle je
   Verteiler mit Stromkreisanzahl, P<sub>inst</sub> (Anzahl × Leistung je
   Stück), P<sub>Geräte</sub> (mit Geräte-GZF), Verteiler-GZF,
   P<sub>gl</sub>, I<sub>B</sub> und „Σ inkl. unterlagert“.
3. **Verteilerpläne (quer, je Verteiler)** – Titelleiste mit
   Verteilernummer, Bezeichnung, Örtlichkeit, Netzart, „Gespeist von“ und
   P<sub>gl</sub>; darunter Kopfkomponenten, Gruppen, Stromkreise
   (mehrzeilige mit Sammelzeile und eingerückten Gerätezeilen),
   Gruppensummen und Verteilersumme. Fehlende Kabelangaben sind als „offen“
   markiert. Die Titelleiste steht im Tabellenkopf und wiederholt sich beim
   Drucken auf Folgeseiten.

Seitenformat, Ränder und „Seite x von y“ kommen beim Drucken aus benannten
`@page`-Regeln (`lb-portrait`, `lb-landscape`), die die Seite zur Laufzeit
einfügt. Die Bildschirmansicht zeigt Blätter in Papiergröße; die exakte
Seitenaufteilung langer Verteilerpläne entsteht erst beim Drucken.

## Vorläufige Punkte

- **Einspeisung / Hierarchie:** `fedFrom` ist Freitext. Die Übersicht ordnet
  einen Verteiler nur dann unter, wenn der Text genau der Nummer oder
  Bezeichnung eines anderen Verteilers entspricht; „Σ inkl. unterlagert“ ist
  eine einfache Summe ohne übergeordneten GZF. Die fachliche Verknüpfung
  (Verteiler und/oder speisender Stromkreis) und die Summierungslogik sind
  offen.
- **I<sub>B</sub>** ist ein symmetrischer Drehstromwert
  S / (√3 · U<sub>3~</sub>) mit S aus P / cos φ je Gerätezeile
  (fehlendes cos φ = 1) und Verteiler-GZF.
- **Corporate Design:** Farben (`--pd-*` in
  `src/frontend/print/print-document.css`) und Schrift (Arial) sind aus Logo
  und kbp-Präsentationsmaterial abgeleitet und werden durch die offizielle
  CD-Vorgabe ersetzt, falls diese abweicht.
- **Planstände:** Die Spalte „Bearbeitung“ zeigt für jeden Planstand die
  aktuelle Bearbeitung aus den Projekteinstellungen, weil Sicherungspunkte
  (noch) keinen Bearbeiter speichern.

## Datenquellen des Deckblatts

| Feld | Quelle |
|---|---|
| Bauvorhaben, Bauherr, Projektnummern, Beschreibung | Projekteinstellungen |
| Anschrift Bauvorhaben, Leistungsphase, Projektleitung, Bearbeitung | Projekteinstellungen → Abschnitt „Deckblatt“ (`siteAddress`, `workStage`, `projectLead`, `projectEditor`) |
| Büro, Anschrift Büro | Seitenansicht → „Büroangaben“ (global) |
| Stand, Datenstand, Anzahl Verteiler, Inhalt | automatisch |
| Planstände | benannte Sicherungspunkte |

Die vier Projektfelder laufen über `project.update-settings` (Schema-Version
3, Migration `0009`) und sind Teil von Snapshot-Schema 6 und Projektexport.
Im `PUT /api/projects/:projectId` sind sie optional; fehlende Felder behalten
ihren Wert.

## Büroangaben

- Tabelle `document_branding_settings` (Schlüssel/Wert, Migration `0009`),
  global wie das Logo.
- `GET /api/document-branding` liefert zusätzlich
  `office: { officeName, officeAddress }`.
- `PUT /api/document-branding/office` mit `{ "officeName", "officeAddress" }`
  (max. 200 / 500 Zeichen, leerer Text = nicht gesetzt).

## Logo

- Globale Büro-Einstellung, nicht Teil von Projekten, Revisionen, Snapshots
  oder Projektexport.
- Tabelle `document_branding_assets` (Migration `0008`).
- `GET /api/document-branding` → `{ logo: { mimeType, fileName, sizeBytes, updatedAtIso } | null }`
- `GET /api/document-branding/logo` → Bilddaten (`404` ohne Logo), mit
  `X-Content-Type-Options: nosniff` und restriktiver CSP.
- `PUT /api/document-branding/logo` mit
  `{ "fileName", "mimeType": "image/png" | "image/jpeg" | "image/svg+xml", "contentBase64" }`,
  maximal 2 MB; der Dateiinhalt wird gegen das Format geprüft.
- `DELETE /api/document-branding/logo` → `204`.

## Code

- `src/app/projects/[projectId]/print/page.tsx` – Datenladen, Werkzeugleiste,
  `@page`-Regeln
- `src/frontend/print/print-document-model.ts` – reine Berechnungen und
  Formatierung (Tests: `tests/print-document-model.test.ts`)
- `src/frontend/print/print-document.tsx` – Blätter und Tabellen
- `src/frontend/print/print-document.css` – Layout, auf `.print-view`
  begrenzt
- `src/frontend/components/distribution-board-info-card.tsx` – Infokarte im
  Bearbeiten-Dialog der Verteilung