Integrate print view and document branding

AGENTS.md

@@ -284,8 +284,13 @@ not change the project revision or undo/redo stacks. Restoring a server-stored
 snapshot verifies its checksum and the current-state hash, replaces supported
 project data atomically and records a new `restore` revision with a complete
 inverse command. Restore can therefore be undone and redone after a restart.
-Current snapshot schema version 5 additionally stores the manual quantity share
-of every CircuitDeviceRow. Version 4 snapshots are upgraded with
+Current snapshot schema version 6 additionally stores the distribution-board
+info fields `boardNumber`, `location`, `fedFrom` and `remark` and the project
+cover fields `siteAddress`, `workStage`, `projectLead` and `projectEditor`;
+all older supported versions are upgraded with `null` for these fields.
+Stored named and automatic snapshots of every supported version (1 to 6)
+remain restorable; they are upgraded while parsing. Version 5 stores
+the manual quantity share of every CircuitDeviceRow. Version 4 snapshots are upgraded with
 `manualQuantity = quantity`; they already contain the complete confirmed
 external-model source, import batches, room mappings and objects. Version 3
 snapshots are upgraded with an empty external-model state; version 2 snapshots
@@ -299,7 +304,7 @@ project graph.
 Project-wide Revit CSV configuration uses
 `external-csv-configuration.update`. Its complete expected/target snapshot is
 persisted through the shared project-command transaction, so create, update,
-delete, Undo and Redo are revision-safe. Snapshot schema 5, restore and portable
+delete, Undo and Redo are revision-safe. Snapshot schema 5/6, restore and portable
 project duplication preserve the configuration; duplication remaps its internal
 id and project link.
 The project page exposes the Revit CSV modal. It edits the complete
@@ -313,7 +318,7 @@ immutable import batches with original bytes plus the classified cell matrix,
 normalized source-room mappings and external objects unique by
 `(sourceId, ifcGuid)`. Source values, planning values and overrides are separate.
 The general external-model repository is read-only; runtime writes belong only
-to typed command adapters. Snapshot/restore and portable project transfer schema version 5
+to typed command adapters. Snapshot/restore and portable project transfer schema version 5/6
 capture the complete external state and remap every internal UUID and link while
 preserving IFCGUIDs, source values, original bytes and the classified matrix.
 Import batches additionally store the monotonic project CSV configuration
@@ -402,6 +407,10 @@ Project settings use the persistent `project.update-settings` command. Project
 metadata, the public-building classification, both voltage defaults and the
 enabled distribution-board supply types change in one revision and Undo/Redo
 restores them together; the project PUT route requires `expectedRevision`.
+Schema version 3 additionally carries the print cover fields `siteAddress`,
+`workStage`, `projectLead` and `projectEditor` (migration `0008`); version 2
+(without them) and baseline version 1 stay executable and keep the current
+cover values. The PUT route accepts the cover fields optionally.
 The public-building flag is the future sizing input for requiring halogen-free
 cables and lines. The system catalog is `AV`, `SV`, `EV`,
 `USV`, `MSR`, `SiBe`; at least one must be enabled and a type used by a board
@@ -456,6 +465,18 @@ the only supported circuit-protection source; no flat compatibility fields remai
 Distribution-board floor assignment and a project-enabled supply type use
 `distribution-board.update`; both values are snapshot/export fields and one
 persistent undo step.
+The same command (still schema version 1, additively extended) carries the
+board info-card fields `boardNumber`, `location`, `fedFrom` and `remark`
+(migration `0007`). They are nullable, trimmed planner values; the PUT route
+only includes submitted info fields in the command and its inverse. An empty
+board with info values is no longer an unchanged setup, so history deletion of
+it is rejected like a changed simultaneity factor. Populated-subtree commands
+stored before these fields existed are normalized to `null` values
+(`normalizeDistributionBoardSubtreeSnapshot`). `fedFrom` is deliberately free
+text: the logical link to the feeding board/circuit is an open design decision.
+These fields are intended to be prefillable from Revit parameters later, but
+only through the Phase 14 rules (preview, explicit confirmation, no silent
+overwrite).
 Floor and room setup uses persistent insert, update and delete commands with
 complete stable snapshots. Their inverses remove or restore only unchanged records and
 reject floors with assigned rooms/distribution boards or rooms referenced by
@@ -477,6 +498,35 @@ Required operations:
 - synchronization changes
 
 
+## Print View (Seitenansicht)
+
+- Route `src/app/projects/[projectId]/print/page.tsx`, opened from the project
+  page button "Seitenansicht". Read-only: it only uses existing GET endpoints.
+- Pure read model `src/frontend/print/print-document-model.ts` (tested in
+  `tests/print-document-model.test.ts`); React sheets in
+  `src/frontend/print/print-document.tsx`; styles scoped to `.print-view` in
+  `src/frontend/print/print-document.css`.
+- Pages: cover (A4 portrait, tabular), board overview with structure and
+  power sums, one plan per board (A4/A3 landscape) whose title block sits in
+  `<thead>` so it repeats on printed pages. PDF export uses the browser print
+  dialog; page size, margins and "Seite x von y" come from injected named
+  `@page` rules (`lb-portrait`, `lb-landscape`).
+- The board hierarchy and "Σ inkl. unterlagert" in the overview are
+  PRELIMINARY (text match of `fedFrom` against board number/name, plain sum,
+  no upstream simultaneity factor). Replace this once the feed link is modeled.
+- Colors/fonts follow the kbp corporate design (`--pd-*` variables in
+  `print-document.css`). Empty cover values are shown as
+  "[ergänzen]"; the Planstände editor column shows the project's current
+  `projectEditor` because snapshots do not record an editor.
+- The document logo and the office profile (office name/address on the
+  cover) are global office branding: tables `document_branding_assets`
+  (migration `0007`) and `document_branding_settings` (migration `0008`),
+  endpoints `GET|PUT|DELETE /api/document-branding/logo`,
+  `PUT /api/document-branding/office` and `GET /api/document-branding`.
+  It is intentionally outside project revisions, snapshots and transfer.
+  Uploads are PNG/JPEG/SVG up to 2 MB with a content signature check; the logo
+  is served with `nosniff` and a restrictive CSP.
+
 ## Revit / CSV External Model Work
 
 When explicitly working on Phase 14, use
@@ -572,6 +622,9 @@ Users must be able to override sizing suggestions.
 - full electrical sizing
 - multi-user/PostgreSQL operation
 - supported production deployment
+- logical feed link between distribution boards (`fedFrom` stays free text
+  until the project owner decides whether it references a board, a feeding
+  circuit or both) and the resulting hierarchical power summation
 
 Do not implement these while working on an unrelated phase.