Bring documentation in line with integrated features

List the building structure, room areas, rough power balance and cable
sizing in the README and documentation map, add an architecture section
for the rough power balance, correct stale snapshot schema references and
record the integrated contributor features in the backlog.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Julian Appel 2026-09-27 20:36:43 +02:00
parent dce31ee143
commit b50c00c0ac
5 changed files with 58 additions and 8 deletions

View file

@ -323,7 +323,7 @@ immutable import batches with original bytes plus the classified cell matrix,
normalized source-room mappings and external objects unique by normalized source-room mappings and external objects unique by
`(sourceId, ifcGuid)`. Source values, planning values and overrides are separate. `(sourceId, ifcGuid)`. Source values, planning values and overrides are separate.
The general external-model repository is read-only; runtime writes belong only 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/6 to typed command adapters. Snapshot/restore and portable project transfer schema versions 5-8
capture the complete external state and remap every internal UUID and link while capture the complete external state and remap every internal UUID and link while
preserving IFCGUIDs, source values, original bytes and the classified matrix. preserving IFCGUIDs, source values, original bytes and the classified matrix.
Import batches additionally store the monotonic project CSV configuration Import batches additionally store the monotonic project CSV configuration

View file

@ -15,12 +15,16 @@ des Linear-Plugins in Revit.
## Unterstützter Arbeitsablauf ## Unterstützter Arbeitsablauf
- Projekte, Verteilungen, Etagen und Räume verwalten - Projekte und Verteilungen verwalten; Gebäude, Etagen und Räume auf einer
eigenen Seite pflegen, Räume optional mit Fläche und Summen je Etage und
Gebäude
- pro Verteilung geschützte Stromkreisgruppen für Beleuchtung, 1-phasige und - pro Verteilung geschützte Stromkreisgruppen für Beleuchtung, 1-phasige und
3-phasige Stromkreise verwalten 3-phasige Stromkreise verwalten
- Hauptschalter, Überspannungsableiter, Gruppenschutz und zusätzliche - Hauptschalter, Überspannungsableiter, Gruppenschutz und zusätzliche
Verteilergeräte in der Stromkreisliste abbilden Verteilergeräte in der Stromkreisliste abbilden
- Schutzgeräte je Stromkreis und optional je Gruppe konfigurieren - Schutzgeräte je Stromkreis und optional je Gruppe konfigurieren
- Leitungsquerschnitte für einzelne Stromkreise auf Anforderung nach
DIN VDE 0298-4 berechnen und ausdrücklich übernehmen
- leere, einzeilige und mehrzeilige Stromkreise abbilden - leere, einzeilige und mehrzeilige Stromkreise abbilden
- Stromkreise und Gerätezeilen per Drag-and-drop umstrukturieren - Stromkreise und Gerätezeilen per Drag-and-drop umstrukturieren
- Projektgeräte einfügen, verknüpfen und kontrolliert synchronisieren - Projektgeräte einfügen, verknüpfen und kontrolliert synchronisieren
@ -31,6 +35,9 @@ des Linear-Plugins in Revit.
- automatische Sicherungspunkte mit begrenzter Aufbewahrung nutzen - automatische Sicherungspunkte mit begrenzter Aufbewahrung nutzen
- Seitenansicht mit Deckblatt, Verteilerübersicht und Verteilerplänen öffnen - Seitenansicht mit Deckblatt, Verteilerübersicht und Verteilerplänen öffnen
und über den Browser als PDF drucken; Büroangaben und Logo zentral pflegen und über den Browser als PDF drucken; Büroangaben und Logo zentral pflegen
- grobe Leistungsbilanzen für LPH 2/3 nach Kostengruppen führen, mit der
detaillierten Bilanz vergleichen und einzelne Zeilen als Projektgerät
übernehmen
- Revit-CSV-Dateien konfigurieren, prüfen und nach expliziter Zuordnung von - Revit-CSV-Dateien konfigurieren, prüfen und nach expliziter Zuordnung von
Räumen, Verteilungen und Projektgeräten erstmals importieren; dabei entstehen Räumen, Verteilungen und Projektgeräten erstmals importieren; dabei entstehen
noch keine Stromkreise oder Gerätezeilen noch keine Stromkreise oder Gerätezeilen
@ -152,6 +159,9 @@ vor der Baseline werden nicht unterstützt.
- [Editor-Interaktionen](docs/circuit-list-editor-interactions.md) - [Editor-Interaktionen](docs/circuit-list-editor-interactions.md)
- [API des Stromkreislisten-Editors](docs/circuit-list-editor-api.md) - [API des Stromkreislisten-Editors](docs/circuit-list-editor-api.md)
- [Seitenansicht und PDF-Export](docs/print-view.md) - [Seitenansicht und PDF-Export](docs/print-view.md)
- [Gebäudestruktur und Raumflächen](docs/building-structure.md)
- [Grobe Leistungsbilanz](docs/estimate-balance.md)
- [Leitungsberechnung](docs/cable-sizing-module.md)
- [Entwicklungs- und Contributor-Workflow](docs/development-workflow.md) - [Entwicklungs- und Contributor-Workflow](docs/development-workflow.md)
- [Bekannte Einschränkungen](docs/circuit-list-editor-known-limitations.md) - [Bekannte Einschränkungen](docs/circuit-list-editor-known-limitations.md)
- [Roadmap](docs/spec/07-implementation-phases-todo.md) - [Roadmap](docs/spec/07-implementation-phases-todo.md)

View file

@ -15,9 +15,9 @@ ausdrücklich getrennt und dürfen nicht als bereits implementiert verstanden we
- [Seitenansicht und PDF-Export](print-view.md) – Deckblatt, - [Seitenansicht und PDF-Export](print-view.md) – Deckblatt,
Verteilerübersicht, Verteilerpläne, Büro-Logo Verteilerübersicht, Verteilerpläne, Büro-Logo
- [Gebäudestruktur](building-structure.md) – Gebäude → Etagen → Räume, - [Gebäudestruktur](building-structure.md) – Gebäude → Etagen → Räume,
Befehle, Snapshot-Schema 7, eigene Seite Raumflächen und Summen, Befehle, Snapshot-Schema 8, eigene Seite
- [Grobe Leistungsbilanz](estimate-balance.md) – LPH 2/3 nach Kostengruppen, - [Grobe Leistungsbilanz](estimate-balance.md) – LPH 2/3 nach Kostengruppen,
Rechnung, Vergleich mit der detaillierten Bilanz Rechnung, Vergleich mit der detaillierten Bilanz, Übernahme als Projektgerät
- [Editor-API](circuit-list-editor-api.md) – unterstützte Circuit-First-Endpunkte - [Editor-API](circuit-list-editor-api.md) – unterstützte Circuit-First-Endpunkte
- [Bekannte Einschränkungen](circuit-list-editor-known-limitations.md) – - [Bekannte Einschränkungen](circuit-list-editor-known-limitations.md) –
bewusst noch nicht implementierte oder begrenzte Funktionen bewusst noch nicht implementierte oder begrenzte Funktionen

View file

@ -43,8 +43,13 @@ vor dem Command und bleiben über Undo/Redo unverändert.
## Wichtige Einstiegspunkte ## Wichtige Einstiegspunkte
- `src/app/projects/page.tsx` – Projektliste und globale Gerätebibliothek - `src/app/projects/page.tsx` – Projektliste und globale Gerätebibliothek
- `src/app/projects/[projectId]/page.tsx` – Projektstammdaten, Verteilungen, - `src/app/projects/[projectId]/page.tsx` – Projektstammdaten, Verteilungen
Räume und Projektgeräte und Projektgeräte
- `src/app/projects/[projectId]/struktur/page.tsx` – Gebäude, Etagen, Räume
und Raumflächen
- `src/app/projects/[projectId]/grobbilanz/` – Stände und Editor der groben
Leistungsbilanz
- `src/app/projects/[projectId]/print/page.tsx` – Seitenansicht und PDF-Export
- `src/app/projects/[projectId]/circuit-lists/[circuitListId]/tree-edit/page.tsx` - `src/app/projects/[projectId]/circuit-lists/[circuitListId]/tree-edit/page.tsx`
– unterstützte Editorroute – unterstützte Editorroute
- `src/frontend/components/circuit-tree-editor.tsx` – Editorzustand, - `src/frontend/components/circuit-tree-editor.tsx` – Editorzustand,
@ -525,6 +530,22 @@ Querschnitt und Länge über den regulären `circuit.update`-Befehl, also mit
Revision und Undo/Redo. Details, Rechenweg und Prüfnachweis der Tabellen: Revision und Undo/Redo. Details, Rechenweg und Prüfnachweis der Tabellen:
`docs/cable-sizing-module.md`. `docs/cable-sizing-module.md`.
## Grobe Leistungsbilanz
Das Modul `src/estimate-balance` mit der importfreien Rechnung in
`src/shared/estimate-balance` führt Leistungsbilanzen für LPH 2/3 nach
DIN-276-Kostengruppen in eigenen Tabellen (`estimate_*`, Migration `0010`).
Es ist nicht mit der Stromkreisstruktur verknüpft und liest Gerätezeilen nur
für den Vergleich „geschätzt ↔ detailliert“ über das längste passende
Kostengruppen-Präfix. Schreibzugriffe laufen über `estimate-balance.insert`,
`.update` und `.delete` mit vollständigen Dokumenten, also mit Revision und
Undo/Redo. Grobbilanzen sind Teil von Transferformat 2, aber bewusst nicht Teil
der logischen Snapshots; ein Restore lässt sie unverändert. Einzelne Zeilen
lassen sich über den vorbelegten Projektgeräte-Dialog ausdrücklich als
Projektgerät kopieren (`project-device.insert`, ohne gespeicherte Verknüpfung).
Oberfläche: `/projects/:projectId/grobbilanz`. Details:
`docs/estimate-balance.md`.
## Persistenz und Migration ## Persistenz und Migration
- SQLite ist die aktuell unterstützte Datenbank. - SQLite ist die aktuell unterstützte Datenbank.
@ -559,7 +580,7 @@ Revision und Undo/Redo. Details, Rechenweg und Prüfnachweis der Tabellen:
`toLowerCase()` gegen das vollständige Register der Stromkreisliste und wird `toLowerCase()` gegen das vollständige Register der Stromkreisliste und wird
von jedem Anlage-/Umbenennungspfad für Stromkreise und Verteilerkomponenten von jedem Anlage-/Umbenennungspfad für Stromkreise und Verteilerkomponenten
aufgerufen, auch dort, wo zuvor kein Vorab-Check existierte. Snapshot- und aufgerufen, auch dort, wo zuvor kein Vorab-Check existierte. Snapshot- und
Transfer-Integration verwenden aktuell Snapshot-Schema 6. Persistente Transfer-Integration verwenden aktuell Snapshot-Schema 8. Persistente
Insert/Delete/Update-Commands für veränderliche Verteilerkomponenten, Insert/Delete/Update-Commands für veränderliche Verteilerkomponenten,
Gruppen einschließlich befüllter Unterbäume sowie vollständige Gruppen einschließlich befüllter Unterbäume sowie vollständige
Gruppensortierung sind integriert. Der Editor zeigt die geschützte Struktur Gruppensortierung sind integriert. Der Editor zeigt die geschützte Struktur
@ -591,7 +612,7 @@ einschließlich BOM, CRLF und Quotierung bytegleich zurück. Der lokale Befehl
`external_csv_configurations` enthält höchstens eine versionierte Konfiguration `external_csv_configurations` enthält höchstens eine versionierte Konfiguration
je Projekt. `external-csv-configuration.update` schreibt Anlage, Änderung oder je Projekt. `external-csv-configuration.update` schreibt Anlage, Änderung oder
Entfernung zusammen mit Revision und persistentem Undo/Redo. Snapshot-Schema 6, Entfernung zusammen mit Revision und persistentem Undo/Redo. Snapshot-Schema 5–8,
Restore und portabler Projekttransfer enthalten diesen Zustand; beim Duplizieren Restore und portabler Projekttransfer enthalten diesen Zustand; beim Duplizieren
werden Konfigurations-UUID und Projektlink remapped. werden Konfigurations-UUID und Projektlink remapped.

View file

@ -135,6 +135,25 @@ The pre-release cleanup established the following compatibility boundary:
- [x] Keep column visibility and order as a project-specific UI preference so - [x] Keep column visibility and order as a project-specific UI preference so
all distribution boards in the same project open with the same columns. all distribution boards in the same project open with the same columns.
## Integrated Contributor Features (September 2026)
- [x] Client ids without secure-context browser APIs (`createClientId`).
- [x] Icon actions, compact column headers and the AMEV picker in the circuit
list; icon actions and collapsible filters on the project overview.
- [x] Print view with cover, board overview, board plans, board info card and
office branding.
- [x] Buildings above floors and a dedicated building structure page.
- [x] Optional net room area with sums per floor and building.
- [x] Optional cable-sizing module for one circuit on demand
(DIN VDE 0298-4:2023-06 with Berichtigung 1).
- [x] Rough power balance for LPH 2/3 by cost group, including the comparison
with the detailed balance and the explicit copy of one row as a
ProjectDevice.
Open follow-ups (Gitea issues): logical feed link between distribution boards
(#3), bill of quantities export (#5), area-based loads in W/m² for
ProjectDevices and device rows (#20).
## Recommended Sequence ## Recommended Sequence
1. [x] Distribution-board floor and supply fields. 1. [x] Distribution-board floor and supply fields.