diff --git a/.env.example b/.env.example deleted file mode 100644 index 46fa42a..0000000 --- a/.env.example +++ /dev/null @@ -1,7 +0,0 @@ -# Nur beim ersten Start mit leerer Benutzertabelle erforderlich. -AUTH_BOOTSTRAP_USERNAME= -AUTH_BOOTSTRAP_PASSWORT= -AUTH_SESSION_HOURS=12 -AUTH_SESSION_MAX_DAYS=7 -# Hinter HTTPS true, bei direktem HTTP-Zugriff im LAN false. -COOKIE_SECURE=false diff --git a/.gitignore b/.gitignore index acbb157..e0ef1d2 100644 --- a/.gitignore +++ b/.gitignore @@ -1,13 +1,9 @@ node_modules/ dist/ .next/ -.env -.env.* -!.env.example # Streuprodukt von tsc; drizzle-kit liest drizzle.config.ts. /drizzle.config.js data/*.db data/backups/*.db .codex/*.log -/docs/spec/kbp-Stromkreis.xlsx -/data/revit-reference/*.xlsx +dynamo/output/ diff --git a/AGENTS.md b/AGENTS.md index 75fdcf3..704aee9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -36,16 +36,6 @@ It must support circuits, device rows, project devices, drag-and-drop restructur - General Circuit, CircuitDeviceRow, CircuitList and DistributionBoard repositories expose only active reads. Runtime writes belong in typed command repositories; direct integration fixtures belong under `tests/support`. -- Authentication: session-cookie login with two fixed roles (`admin`, `user`), - no self-signup. `src/server/auth/*` (password hashing, sessions, Express - middleware), `src/domain/services/user.service.ts`, - `src/db/repositories/user.repository.ts`. Every `/api/*` route requires a - signed-in user (`src/server/index.ts`); `/api/users/*` additionally - requires `admin`. Frontend gate: `AuthProvider` + `LoginGate` - (`src/app/layout.tsx`). Every unsafe API request also requires the explicit - `X-Leistungsbilanz-Request: 1` application header, including over plain HTTP. - Account settings are available to every signed-in user; user administration - remains admin-only. See `docs/authentication.md` for the full picture. The supported runtime model is Circuit-First. The former Consumer UI, API, tables and upgrade tooling are removed; do not reintroduce them. @@ -62,8 +52,7 @@ See `docs/current-architecture.md` for the complete module and request flow. - Device rows inside a circuit do not have their own equipment identifiers. - Protection and cable data belong to the circuit, not to individual devices. - Device-level values include quantity, power per unit, simultaneity factor, cosPhi, room data, cost group and category. -- Circuit total power is the sum of all device rows in that circuit plus the - read-only loads of logically linked downstream boards on that feeder circuit. +- Circuit total power is the sum of all device rows in that circuit. - Existing equipment identifiers must never be changed automatically. - Renumbering is always an explicit user action. @@ -295,23 +284,15 @@ 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 10 stores the Linear-XLSX configuration and -external state with Worksharing-ID identity. Empty versions 1 to 9 are upgraded; -versions containing legacy CSV configuration or external CSV state are rejected -with a German migration error. Version 9 additionally stores -`feedingDistributionBoardId` and `feedingCircuitId` on distribution boards; -versions 1 to 8 are upgraded with both references set to `null`. Version 8 -stores the optional net room area `rooms[].areaM2` (see -`docs/building-structure.md`); versions 1 to 7 are upgraded with -`areaM2 = null`. Version 7 stores the project buildings and -`floors[].buildingId`; versions 1 to 6 are upgraded with no buildings and -`buildingId = null`. Version 6 stores the +Current snapshot schema version 7 additionally stores the project buildings +and `floors[].buildingId` (see `docs/building-structure.md`); versions 1 to 6 +are upgraded with no buildings and `buildingId = null`. Version 6 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 versions 1 to 9 remain restorable when -they contain no legacy CSV state; they are upgraded while parsing. Version 5 stores +Stored named and automatic snapshots of every supported version (1 to 7) +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 @@ -323,45 +304,29 @@ supported versions contain circuit-group identity, distribution-board components separate circuit/component protection records. Portable duplicate imports remap component ids and protection-owner references together with the existing project graph. -R3 replaced the runtime configuration and persistence foundation with Linear -XLSX and exact case-sensitive Worksharing-ID identity. Migration `0014` drops -the old development-only external CSV data after resetting linked row totals to -their manual share. Snapshot schema 10, restore and project transfer use the -new state; non-empty legacy CSV snapshots and legacy CSV history entries are -rejected with a German error. The backend CSV parser and routes are removed. -R4 adds `/projects/:projectId/revit`, its revisioned XLSX settings and -server-side sample detection, and removes the old project-page CSV modal. See -`docs/spec/revit-excel-integration-requirements.md` and -`docs/spec/revit-excel-phase-14-plan.md`. -R5 adds stateless XLSX preview/planning and the six-step initial-import wizard. -`external-model.apply-initial-import` stores the configuration and complete -external model state atomically; its inverse powers persistent Undo/Redo -without parsing workbook bytes. Apply retransmits and reparses the XLSX, -verifies its preview SHA-256 and creates no circuit, equipment identifier or -CircuitDeviceRow. -R6 adds one compact project-wide external-object GET without pagination or -batch payloads. The Revit page filters and sorts it in the client and renders a -virtualized window. `external-object.update-planning` applies multi-object -board, ProjectDevice and planning-value changes as one persistent command; -linked objects are excluded because they follow their CircuitDeviceRow board. -R9 adds the complete Linear-XLSX follow-up import. It matches Worksharing-IDs -exactly, separates source decisions from return deviations, updates accepted -linked quantities atomically, retains missing objects and compacts every older -batch to metadata. `external-import.apply-follow-up` stores complete inverse -states, so Undo/Redo never parses Excel. A separately confirmed -`external-model-object.delete-missing` command removes missing objects and -adjusts linked row quantities; Undo restores objects, links and quantities. -R10 verifies the complete path through return workbook, follow-up import, -snapshot restore, portable duplicate and restart-safe Undo/Redo. A 5,000-object -synthetic workbook covers parser, command/snapshot size, transactions and the -client-side virtual window. Complete external-state inserts use bounded batches -inside their existing transaction for initial/follow-up import, restore and -duplicate. See `docs/spec/revit-excel-r10-validation.md`. - -The target configuration has no independent version counter; `expectedRevision` -invalidates stale plans, and each import batch stores a configuration copy. -Only the newest import batch retains workbook bytes and the full matrix; older -batches retain date, filename, SHA-256 and object count. +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-7, 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 +transport/column/family-rule configuration through the revision-safe endpoint, +requests a stateless preview and then shows the Phase 14.2 initial-import +decisions. Preview responses include all mapped objects, while the UI renders +only the first 25. No preview or plan creates external objects, rows, revisions +or server-side drafts. +Phase 14.2 migration `0003` provides one implicit Revit CSV source per project, +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/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 +version introduced by additive migration `0004`; it is distinct from the CSV +configuration JSON schema version. Phase 14.3 migration `0005` adds `CircuitDeviceRow.manualQuantity`, backfills existing rows from `quantity` and keeps `quantity` as the materialized total. Normal manual row inserts and quantity edits update both values together. @@ -382,12 +347,37 @@ protection and its external object links. Its history-only inverse requires the complete unchanged circuit snapshot and exact link set. Redo never recalculates the BMK. All three external assignment stores share `external-object-assignment.persistence.ts` for compatibility and link safety. -The current read-only +The read-only `GET /api/projects/:projectId/circuit-lists/:circuitListId/external-objects` -projection resolves the board through the owned CircuitList and returns compact -legacy external objects. The target Revit page will load one compact project -list and filter/sort it client-side in a virtualized table, without server -pagination or batch blobs in the DTO. +projection resolves the board through the owned CircuitList and returns only +that board's compact external objects, unassigned first. It exposes no original +CSV bytes or command payloads and returns an empty list before optional import. +Confirmed initial state is written only through +`external-import.apply-initial`. The command rechecks configuration version, +original-byte SHA-256, parsed matrix, complete IFCGUID/source values, explicit +planning overrides and internal project links in the shared transaction. It +never creates or links a CircuitDeviceRow. Its exact inverse removes the whole +unchanged external state, and Redo restores the same UUIDs and bytes. +`POST /api/projects/:projectId/external-csv/initial-import/plan` is a stateless +read path for the first wizard stage. It rejects projects with an existing +external source and returns source-room groups, exact room-number suggestions, +exact family/type groups, projected object values, issue counts and the current +floor/room/board/ProjectDevice catalogs. It creates no draft, revision or +domain row. The wide modal renders these groups and catalogs as explicit +decisions and identifies exact, ambiguous and new room matches. Missing rooms +and ProjectDevices are created through the reused project forms with mapped +Revit values as visible defaults. Each catalog creation remains its own project +command; the wizard adds and selects the result without discarding its plan. +The dedicated +`POST /api/projects/:projectId/external-csv/initial-import/apply` endpoint +retransmits and replans the file against the expected hash, configuration +version and project revision. It requires one explicit decision per source-room +and exact family/type group, blocks unclassified families, creates all stable +external UUIDs server-side and invokes `external-import.apply-initial`. +Room/default-board and optional ProjectDevice links are supported; CSV circuit +values remain source-only and every `circuitDeviceRowId` remains null. The UI +blocks unclassified families, requires a final confirmation and applies the +whole import as one persistent Undo/Redo step. The central revision boundary creates an automatic logical snapshot after each 25 new revisions and retains only the newest 12 automatic snapshots per project. Named snapshots are never removed by this retention policy. @@ -471,58 +461,30 @@ snapshot contains the group, optional component protections, complete circuits, circuit protections and all device-row link/override metadata. Delete re-captures and compares the subtree before cascading; restore preserves every UUID in foreign-key-safe order. -The project-wide circuit-tree read model exposes fixed `headerComponents`, group-owned +The circuit-tree read model exposes fixed `headerComponents`, group-owned `components`, `footerComponents`, optional group category/number and optional one-to-one protection DTOs for circuits and group components. These are the only supported circuit-protection source; no flat compatibility fields remain. -It resolves logical board feeds once for the complete project and adds each -downstream board's demand after its own board simultaneity factor to the chosen -feeding circuit as a read-only virtual row. Recursive chains and several boards -on one circuit are supported. A board-only link affects hierarchy but adds no -load until a feeding circuit is selected. -The distribution-board dialog can create one empty feeder circuit and link it -in the same `distribution-board.create-feeder-circuit` project command. Its -history inverse restores the complete previous board update before removing -only the unchanged generated circuit; Redo reuses its UUID and BMK. No -CircuitDeviceRow is created. The three-phase group is suggested, the optional -circuit display name stays empty by default, and protection remains open for -planner sizing. A circuit with exactly one downstream board and no device rows -is rendered as one compact row using the live board number/name; several -downstream boards or additional devices retain summary and child rows. Editing -the name or remark of an empty reserve circuit changes the circuit itself and -does not implicitly create a device row. 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 uses schema version 2 for the logical -`feedingDistributionBoardId` and optional matching `feedingCircuitId` together -with the existing fields. Version-1 history commands remain executable and do -not change logical feed references. The command rejects self-links, cycles and -circuits from another board. The +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` remains free text for -external feeds and notes; project-board feeds use the two UUID references. -Deleting a referenced board or feeding circuit is blocked in every direct, -subtree and history-only removal path. Board copies retain their incoming feed, -and project duplication remaps both references. +(`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. Room command schema version 2 stores the optional, -finite, non-negative net room area `areaM2`; persisted version-1 commands are -upgraded with `areaM2 = null` and exact record comparison prevents them from -silently overwriting a newer area. Room areas are maintained manually, shown -with two decimals and summarized per floor and building with a separate missing -count. Revit import and W/m² use remain follow-up work. Command inverses remove -or restore only unchanged records and reject floors with -assigned rooms/distribution boards or rooms referenced by device rows. All -write routes require `expectedRevision` and return the updated history state. +complete stable snapshots. Their inverses remove or restore only unchanged records and +reject floors with assigned rooms/distribution boards or rooms referenced by +device rows. All write routes require `expectedRevision` and return the updated +history state. Required operations: @@ -552,10 +514,9 @@ Required operations: `` 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 follows logical board ids. The overview shows power - before board GZF and demand including linked downstream boards; it does not - add a second cumulative column. Board plans render downstream-board loads as - read-only rows. `fedFrom` groups only external root feeds. +- 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 @@ -569,86 +530,62 @@ Required operations: 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 / Linear Excel External Model Work +## Revit / CSV External Model Work -Phase 14 is active and follows -`docs/spec/revit-excel-integration-requirements.md` plus -`docs/spec/revit-excel-phase-14-plan.md`. The old CSV requirements and phases -14.0–14.6 are superseded. Dynamo, Revit API and JSON transport remain excluded. +When explicitly working on Phase 14, use +`docs/spec/revit-csv-integration-requirements.md` as the detailed source of +truth together with the current architecture documents. -Critical target rules: +Critical rules: -- Exchange uses only `.xlsx` files produced and consumed by the Linear plugin. -- Revit integration remains optional. Import never creates a CircuitDeviceRow, - Circuit or equipment identifier. -- Worksharing-ID is the external key and is compared exactly and - case-sensitively. It stays separate from internal UUIDs and circuit BMKs. - IfcGUID is optional redundancy, never a key, and duplicate values are only a - warning. -- A row without Worksharing-ID is suspicious only when `Familie und Typ` is - populated. Show a warning and skip it; do not block. Other ID-less rows, - including the sample summary in column B, are skipped silently. -- Source, planning and override values remain separate. Existing ProjectDevices - remain canonical and are never silently changed. -- Multi-socket objects remain indivisible. Row quantity stays - `manualQuantity + sum(effectiveQuantity)`. -- The project configuration has no independent version counter. Preview and - apply use `expectedRevision`; import batches store a configuration copy. -- Apply retransmits and parses the workbook. Undo/Redo never reads Excel; they - apply only stored before/after states. -- Only the newest import batch retains original bytes and the full matrix; - older batches retain date, filename, SHA-256 and object count. -- The Revit object table loads one compact list, filters/sorts in the client and - renders it virtually; do not add server pagination. -- Linked objects always follow their row's distribution board. Changing a - room's default board affects only unassigned objects and is not blocked. -- Deleting a row, circuit or group warns that X Revit objects become unassigned, - detaches them in the same command and restores links on Undo. Only deletion - of referenced rooms and distribution boards is blocked. -- Missing optional return columns for designation, power, voltage or current - produce warnings and are skipped. Only missing circuit columns for the - selected combined/separate mode block export. -- Missing GZF defaults visibly to 1 without separate confirmation. -- The corrected R2 return workbook was successfully imported into Linear on - 2026-09-30; R3 through R10 and Phase 14 are complete. -- All confirmed writes use typed project commands with `expectedRevision`, - complete inverse data and the shared project-command transaction boundary. -- Do not add automatic circuit planning, Revit circuit adoption, multi-source - management, partial imports, PostgreSQL, background jobs or new permissions. +- Revit integration is optional. Do not make imported external data mandatory + for projects, rooms, project devices, circuits or device rows. +- Parse imports into staging first. Never write CSV rows directly into circuits + or device rows. +- Keep external object identity separate from internal UUIDs and circuit BMKs. + `IfcGUID` identifies the external Revit object and must never replace an + internal UUID or `equipmentIdentifier`. +- One imported Revit object may exist without a `CircuitDeviceRow`. + Import, room assignment, distribution-board assignment, classification and + ProjectDevice linking do not create a row. +- Create or change a `CircuitDeviceRow` only after an explicit user action in + the circuit-list editor. +- Several external objects may link to one `CircuitDeviceRow`, while every + external object remains individually traceable for follow-up imports and + object-specific export. +- Multi-socket Revit objects are indivisible. Their effective quantity may be + greater than one, but one external object must never be split across circuits. +- Existing ProjectDevices are canonical project templates and must not be + overwritten from Revit values. When creating a new ProjectDevice, mapped + Revit values may prefill the creation form. +- Store imported source values separately from local planning values and local + overrides. Imports never silently overwrite local values. +- Repeated imports match deterministically by project/source and `IfcGUID`. + New, changed, missing and conflicting objects require preview and explicit + user decisions. +- The first implementation assumes one complete Revit model export per project. + Do not add visible multi-source, linked-model or partial-import management. +- CSV configuration is project-scoped. Preserve title, header, blank, subtotal + and unknown rows and columns for the return export. +- Treat rows without `IfcGUID` as passthrough when they contain no object data. + Do not report Revit subtotal rows as missing-identity objects. +- Apply each confirmed import diff through a typed project command with + `expectedRevision`, complete inverse data and the shared project command + transaction boundary. +- External-model state must be added to logical project snapshots and portable + project transfer when it becomes part of the supported runtime. +- Keep CSV parsing/serialization in a transport adapter. Domain services must + not depend on CSV syntax, React, `better-sqlite3` or concrete repositories. +- Do not implement automatic circuit planning, Dynamo/API exchange, + PostgreSQL, background jobs or permissions as part of the initial CSV phase. -The real sample `docs/spec/kbp-Stromkreis.xlsx` contains project data. It is -gitignored and must never be embedded in tests or committed. Use synthetic -workbooks for automated tests and accept the real file only as an explicit -local path in the reference checker. - -## Cable Sizing Module - -`src/cable-sizing` is an agreed, separate calculator module attached to the -circuit list (see `docs/cable-sizing-module.md`). Rules: - -- The domain code stays pure: no imports from `db/`, `server/` or `frontend/`. -- It never writes project data. Results are applied only by an explicit - "Übernehmen", which runs the regular `circuit.update` command. -- It is opened from the circuit row action button "Leitungsberechnung", never - by clicking a grid cell; cable cells keep the normal spreadsheet behavior. -- It has no database table and no migration; `/api/cable-sizing/*` is - stateless. -- Current-carrying capacities and correction factors use - DIN VDE 0298-4:2023-06 with Berichtigung 1:2023-10; the exact scope and the - separate basis of voltage-drop and protection checks are documented in - `docs/cable-sizing-module.md`. Inputs outside the supported tables return no - result instead of assuming a factor of 1. Direct burial, grouped method E, - aluminium below 25 mm² and neutral-current sizing above 33 % third harmonic - remain unsupported until their required inputs or normative basis exist. -- Inputs are prefilled from the circuit (power, phase, voltage, weighted cos φ, - length, protective device) and remain editable; manual cable entry without - a calculation stays possible. +Before implementation, audit the current ProjectDevice, CircuitDeviceRow, +command, snapshot, transfer and editor drag-and-drop paths. Propose concrete +domain objects and commands before adding migrations. ## Future Sizing -Do not implement full automatic cable/protection sizing of all circuits -unless explicitly requested. The cable sizing module above only suggests -values for one circuit on demand. +Do not implement full cable/protection sizing unless explicitly requested. Keep the structure ready for it. @@ -666,37 +603,6 @@ Future sizing will need: Users must be able to override sizing suggestions. -## Estimate Balance Module (Grobe Leistungsbilanz) - -`src/estimate-balance` plus `src/shared/estimate-balance` is a separate module -for the early-phase power balance by DIN 276 cost group (see -`docs/estimate-balance.md`). Rules: - -- It has its own tables (`estimate_*`) and never writes circuit, board or - project-device data; it only reads device rows for the comparison. -- Writes use the project command mechanism (`estimate-balance.insert/.update/ - .delete` with complete documents), so revision checks and Undo/Redo apply. -- The calculation and comparison live in the import-free - `src/shared/estimate-balance/estimate-balance.ts` and are shared by API and UI; - displayed values use `roundEstimateValue`. -- It is deliberately not part of named/automatic project snapshots or snapshot - restore; those operations leave estimate balances unchanged. Portable project - transfer format version 2 includes every estimate balance and remaps balance, - group and row ids when duplicating a project. Version 1 transfers remain - importable and contain no estimate balances. -- UI: `/projects/:id/grobbilanz` (Stände) and `/grobbilanz/:balanceId` (editor, - `src/frontend/estimate-balance/`). The editor autosaves the whole document - debounced (one Undo step per save), keeps invalid raw input local, and on a - 409 reloads only if the balance itself changed; otherwise it re-saves with - the new revision. `request()` throws `ApiRequestError` (status, code). -- A single estimate row can be copied explicitly through the existing - ProjectDevice dialog. The dialog is only a prefilled proposal; creation - happens after confirmation through `project-device.insert`, with the current - project revision and normal Undo/Redo. The copy stores no link back to the - estimate row, never places a circuit row automatically, and does not change - estimate, snapshot or transfer schemas. Area rows require manual quantity - and power because W/m² remains outside the ProjectDevice model. - ## Persistence and Migration Rules - SQLite is the currently supported database. @@ -714,17 +620,14 @@ for the early-phase power balance by DIN 276 cost group (see ## Current Deferred Work +- Revit/CSV/IFCGUID round-trip, except when Phase 14 is explicitly requested and + `docs/spec/revit-csv-integration-requirements.md` is being followed - full electrical sizing - multi-user/PostgreSQL operation - supported production deployment -- second/replacement board feeds, including changeover semantics for SV/SiBe -- Revit prefill proposals for logical board feeds through the Phase 14 preview - and explicit-confirmation workflow -- configurable role/rights matrix instead of the fixed `admin`/`user` roles -- permanent account lockout (only temporary per-username login throttling - exists) -- email/one-time-link password provisioning, OIDC/Entra login -- linking user accounts to a personnel/employee master table +- 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. diff --git a/README.md b/README.md index 51a3860..2577989 100644 --- a/README.md +++ b/README.md @@ -7,27 +7,18 @@ Gerätezeilen und wiederverwendbare Projektgeräte fachlich getrennt behandelt. Das Projekt befindet sich in aktiver Entwicklung. Für SQLite stehen ein Docker-Server-Stack mit gebautem Anwendungscode und ein separater Entwicklungsstack bereit. Ein vollständig unterstütztes Produktionsdeployment -für mehrere gleichzeitig arbeitende Prozesse und ein vollständig unterstütztes -Produktionsdeployment fehlen weiterhin. Anmeldung und zwei feste Rollen sind -vorhanden. Die Backend- und Persistenzgrundlage der bisherigen -Revit-CSV-/IfcGUID-Anbindung ist durch den XLSX-Austausch des Linear-Plugins mit -Worksharing-ID als externem Schlüssel ersetzt. R0 bis R10 sind abgeschlossen; -die eigene Revit-Seite unterstützt Einstellungen, Erst- und Folgeimport, -virtuelle Objektbearbeitung, Editorzuordnung und strukturtreue Rückgabe. -Die Phase-14-Kette ist Ende zu Ende und mit 5.000 synthetischen Objekten geprüft. +und Mehrbenutzerbetrieb fehlen weiterhin. Revit-CSV-Konfiguration, Vorschau +und bestätigter Erstimport sind implementiert; die Editoroberfläche zur +Objektzuordnung, Folgeimporte und Rückexport stehen noch aus. ## Unterstützter Arbeitsablauf -- 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 +- Projekte, Verteilungen, Etagen und Räume verwalten - pro Verteilung geschützte Stromkreisgruppen für Beleuchtung, 1-phasige und 3-phasige Stromkreise verwalten - Hauptschalter, Überspannungsableiter, Gruppenschutz und zusätzliche Verteilergeräte in der Stromkreisliste abbilden - 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 - Stromkreise und Gerätezeilen per Drag-and-drop umstrukturieren - Projektgeräte einfügen, verknüpfen und kontrolliert synchronisieren @@ -38,12 +29,9 @@ Die Phase-14-Kette ist Ende zu Ende und mit 5.000 synthetischen Objekten geprüf - automatische Sicherungspunkte mit begrenzter Aufbewahrung nutzen - Seitenansicht mit Deckblatt, Verteilerübersicht und Verteilerplänen öffnen 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 -- Linear-XLSX-Dateien verlustarm lesen und schreiben; Erst- und Folgeimporte - prüfen, Revit-Objekte zuordnen und geplante Werte strukturerhaltend an - Linear zurückgeben +- Revit-CSV-Dateien konfigurieren, prüfen und nach expliziter Zuordnung von + Räumen, Verteilungen und Projektgeräten erstmals importieren; dabei entstehen + noch keine Stromkreise oder Gerätezeilen ## Technik @@ -63,8 +51,6 @@ Voraussetzungen: ```powershell git clone Set-Location leistungsbilanz-ts -$env:AUTH_BOOTSTRAP_USERNAME = "admin" -$env:AUTH_BOOTSTRAP_PASSWORT = "" docker compose up --build --detach ``` @@ -73,15 +59,9 @@ Danach: - Frontend: - API-Healthcheck: (über den Next.js-Rewrite) -Beim ersten Start erzeugen diese beiden Variablen genau einen Administrator, -solange die Benutzertabelle noch leer ist. Danach werden sie ignoriert. Für -einen dauerhaften Serverbetrieb gehören die Werte in eine nicht versionierte -`.env` neben `compose.yaml`; Details stehen unter -[Anmeldung und Benutzerverwaltung](docs/authentication.md). - -Die Express-API ist nicht auf dem Host veröffentlicht. Sämtliche fachlichen -API-Routen verlangen eine gültige Anmeldung; der Zugriff läuft über den -Rewrite im Web-Dienst. +Die Express-API ist nicht mehr auf dem Host veröffentlicht. Sie hat keine +Authentifizierung und ist nur innerhalb des Compose-Netzes erreichbar; der +Zugriff läuft über den Rewrite im Web-Dienst. Der API-Container führt ausstehende Migrationen und die Schemaprüfung beim Start automatisch aus. Die SQLite-Datei liegt auf dem Host unter @@ -127,8 +107,6 @@ Voraussetzungen: npm ci npm run db:migrate npm run db:verify:circuit-schema -$env:AUTH_BOOTSTRAP_USERNAME = "admin" -$env:AUTH_BOOTSTRAP_PASSWORT = "" npm run dev:api ``` @@ -172,14 +150,8 @@ vor der Baseline werden nicht unterstützt. - [Editor-Interaktionen](docs/circuit-list-editor-interactions.md) - [API des Stromkreislisten-Editors](docs/circuit-list-editor-api.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) -- [Anmeldung und Benutzerverwaltung](docs/authentication.md) - [Entwicklungs- und Contributor-Workflow](docs/development-workflow.md) - [Bekannte Einschränkungen](docs/circuit-list-editor-known-limitations.md) -- [Revit-Integration über Linear-Excel](docs/spec/revit-excel-integration-requirements.md) -- [Phase-14-Plan R0–R10](docs/spec/revit-excel-phase-14-plan.md) - [Roadmap](docs/spec/07-implementation-phases-todo.md) Für LLM-gestützte Änderungen enthält [AGENTS.md](AGENTS.md) die verbindlichen diff --git a/compose.dev.yaml b/compose.dev.yaml index f49e9e6..b9c64b4 100644 --- a/compose.dev.yaml +++ b/compose.dev.yaml @@ -35,12 +35,8 @@ services: PORT: "3000" CHOKIDAR_USEPOLLING: "true" LOG_LEVEL: "${LOG_LEVEL:-debug}" - AUTH_BOOTSTRAP_USERNAME: "${AUTH_BOOTSTRAP_USERNAME:-}" - AUTH_BOOTSTRAP_PASSWORT: "${AUTH_BOOTSTRAP_PASSWORT:-}" - AUTH_SESSION_HOURS: "${AUTH_SESSION_HOURS:-12}" - AUTH_SESSION_MAX_DAYS: "${AUTH_SESSION_MAX_DAYS:-7}" - COOKIE_SECURE: "${COOKIE_SECURE:-false}" - # Nur auf dem Loopback: die API darf nicht aus dem LAN erreichbar sein. + # Nur auf dem Loopback: nichts davon ist authentifiziert, die API darf + # nicht aus dem LAN erreichbar sein. ports: - "127.0.0.1:3000:3000" # Kein memswap_limit wie im Server-Stack: beim Entwickeln ist Swap als diff --git a/compose.yaml b/compose.yaml index 1de9104..3438f90 100644 --- a/compose.yaml +++ b/compose.yaml @@ -45,16 +45,8 @@ services: NODE_ENV: production PORT: "3000" LOG_LEVEL: "${LOG_LEVEL:-info}" - # AUTH_BOOTSTRAP_* legen nur den allerersten Admin an (solange die - # users-Tabelle leer ist) und gehoeren in eine lokale, nicht versionierte - # .env - siehe docs/authentication.md. - AUTH_BOOTSTRAP_USERNAME: "${AUTH_BOOTSTRAP_USERNAME:-}" - AUTH_BOOTSTRAP_PASSWORT: "${AUTH_BOOTSTRAP_PASSWORT:-}" - AUTH_SESSION_HOURS: "${AUTH_SESSION_HOURS:-12}" - AUTH_SESSION_MAX_DAYS: "${AUTH_SESSION_MAX_DAYS:-7}" - COOKIE_SECURE: "${COOKIE_SECURE:-false}" - # Nicht auf dem Host veroeffentlicht: die API wird ueber den - # Next.js-Rewrite im Web-Dienst erreicht. + # Nicht auf dem Host veroeffentlicht: die API hat keine Authentifizierung + # und wird ueber den Next.js-Rewrite im Web-Dienst erreicht. expose: - "3000" # Harte Obergrenze statt unbegrenztem Wachstum. memswap_limit == mem_limit diff --git a/docs/README.md b/docs/README.md index be55461..c7a3d88 100644 --- a/docs/README.md +++ b/docs/README.md @@ -15,36 +15,22 @@ ausdrücklich getrennt und dürfen nicht als bereits implementiert verstanden we - [Seitenansicht und PDF-Export](print-view.md) – Deckblatt, Verteilerübersicht, Verteilerpläne, Büro-Logo - [Gebäudestruktur](building-structure.md) – Gebäude → Etagen → Räume, - Raumflächen und Summen, Befehle, Snapshot-Schema 8, eigene Seite -- [Grobe Leistungsbilanz](estimate-balance.md) – LPH 2/3 nach Kostengruppen, - Rechnung, Vergleich mit der detaillierten Bilanz, Übernahme als Projektgerät + Befehle, Snapshot-Schema 7, eigene Seite - [Editor-API](circuit-list-editor-api.md) – unterstützte Circuit-First-Endpunkte - [Bekannte Einschränkungen](circuit-list-editor-known-limitations.md) – bewusst noch nicht implementierte oder begrenzte Funktionen -- [Leitungsberechnung](cable-sizing-module.md) – optionales Rechenmodul, - Rechenweg, Datenbasis und Prüfnachweis der Tabellen -- [Anmeldung und Benutzerverwaltung](authentication.md) – Rollen, Ablauf beim - Anlegen eines Zugangs, Sessions, Bootstrap-Admin ## Entwicklung und Betrieb - [Entwicklungs- und Contributor-Workflow](development-workflow.md) - [Deployment und Betrieb](deployment.md) -## Revit / Linear XLSX - -- [Projektversionen und externer Modellaustausch](project-history-and-external-model-architecture.md) -- [Revit-Integration über Linear-Excel](spec/revit-excel-integration-requirements.md) – - verbindliche Anforderungen für XLSX und Worksharing-ID -- [Phase-14-Plan R0–R10](spec/revit-excel-phase-14-plan.md) – Status, - Paketgrenzen und Linear-Freigabepunkt nach R2 -- [R0-Bestandsaudit](spec/revit-excel-r0-audit.md) -- [R10-Abnahme](spec/revit-excel-r10-validation.md) – Ende-zu-Ende- und - 5.000-Objekte-Nachweis -- [LLM-Kontext für Phase 14](revit-requirements-llm-context.md) - ## Zukunftsarchitektur +- [Projektversionen und externer Modellaustausch](project-history-and-external-model-architecture.md) +- [LLM-Kontext für die Revit-Anforderungsplanung](revit-requirements-llm-context.md) +- [Revit-CSV-Anforderungen](spec/revit-csv-integration-requirements.md) +- [Phase-14-Audit und Implementierungsplan](spec/revit-csv-phase-14-audit-and-plan.md) - [Zukünftige Dimensionierung](spec/06-future-sizing-and-calculations.md) - [Roadmap und Phasen](spec/07-implementation-phases-todo.md) - [Aktueller Produkt-Backlog](spec/08-current-product-backlog.md) diff --git a/docs/authentication.md b/docs/authentication.md deleted file mode 100644 index 32039cf..0000000 --- a/docs/authentication.md +++ /dev/null @@ -1,99 +0,0 @@ -# Anmeldung und Benutzerverwaltung - -Die Leistungsbilanz verlangt eine Anmeldung. Es gibt kein Self-Signup: jeder -Zugang wird von einem Administrator über **Config → Benutzer** angelegt. - -## Rollen - -Es gibt genau zwei Rollen (`src/shared/constants/user-roles.ts`): - -- **admin** – wie `user`, zusätzlich Zugriff auf **Config → Benutzer** -- **user** – volle Nutzung der Leistungsbilanz (Projekte, Stromkreislisten, - Grobbilanz, …) und Zugriff auf das eigene Konto, keine Benutzerverwaltung - -Es gibt (bewusst, siehe unten) keine konfigurierbare Rechte-Matrix und keine -Verknüpfung mit einer Mitarbeiter-/Personen-Stammdatentabelle. - -## Ablauf beim Anlegen eines Zugangs - -1. Ein Administrator öffnet Config → Benutzer und legt einen neuen Zugang mit - Anmeldename, Name, Rolle und einem **Startpasswort** an, das er selbst - eintippt. -2. Der Zugang startet mit `mustChangePassword = true`. -3. Beim ersten Anmelden zeigt die Oberfläche statt der App ein Formular, das - ein eigenes Passwort verlangt, bevor es weitergeht. -4. "Passwort zurücksetzen" (ebenfalls in Config → Benutzer) setzt ein neues - Startpasswort und `mustChangePassword` wieder auf `true` – z. B. wenn - jemand sein Passwort vergessen hat. - -## Technischer Aufbau - -- **Datenmodell:** Tabelle `users` (`src/db/schema/users.ts`) – - `username`, `passwordHash` (scrypt, `src/server/auth/password.ts`), `name`, - `role`, `active`, `mustChangePassword`. -- **Sessions:** In-Memory-Store (`src/server/auth/sessions.ts`), Cookie - `lb_session`, sliding expiry (`AUTH_SESSION_HOURS`, Standard 12h) mit - absoluter Obergrenze (`AUTH_SESSION_MAX_DAYS`, Standard 7). Ein - Neustart der API beendet alle Sessions – für einen Single-Container-Dienst - ein akzeptabler Kompromiss gegenüber einer persistierten Session-Tabelle. -- **Middleware:** `src/server/auth/auth.middleware.ts` schützt `/api/*` - (außer `/api/auth/login`, `/api/auth/status`, `/api/auth/logout`) und - erzwingt den Passwortwechsel, solange `mustChangePassword` gesetzt ist. - `/api/users/*` verlangt zusätzlich die Rolle `admin`. -- **Frontend:** `AuthProvider` lädt `/api/auth/me`; `LoginGate` - (`src/app/layout.tsx`) zeigt Login- bzw. Passwortformular, solange nicht - angemeldet bzw. `mustChangePassword` gesetzt ist, sonst die App. - **Konto** ist für jede angemeldete Person erreichbar; **Benutzer** nur für - Administratoren. - -## Schutzmechanismen - -| Angriff | Schutz | -|---|---| -| Passwort-Raten (online) | `LoginThrottle`: 5 Fehlversuche je Anmeldename in 15 min → HTTP 429 bis das Fenster abläuft. Schlüssel ist der Name, nicht die IP (alle Anfragen kommen über den Next-Rewrite mit derselben Quell-IP). | -| Passwort-Raten (offline, DB-Diebstahl) | scrypt (N=16384, r=8, p=1), eigenes Salt je Hash | -| Nutzernamen ausspähen (Timing) | Unbekannte Namen werden gegen einen festen Dummy-Hash geprüft – immer genau ein scrypt-Lauf; einheitliche Fehlermeldung | -| CSRF | SameSite=Lax **plus** `requireSameOriginForWrites`: jeder Schreibzugriff braucht `X-Leistungsbilanz-Request: 1`; fremde HTML-Formulare können den Header nicht setzen und ein fremder Fetch scheitert an der notwendigen CORS-Preflight-Anfrage. Ein vorhandener `Sec-Fetch-Site`-Header wird zusätzlich geprüft. | -| CSRF über reines HTTP | Der eigene Anwendungsheader gilt auch dann, wenn Browser im HTTP-LAN keinen `Sec-Fetch-Site`-Header senden. Skripte und manuelle API-Aufrufe müssen ihn bei `POST`, `PUT`, `PATCH` und `DELETE` ausdrücklich mitsenden. | -| Session-Fixation | Neue Session-ID bei jedem Login und nach jedem Passwortwechsel | -| Gestohlenes Cookie | httpOnly; gleitende Laufzeit (`AUTH_SESSION_HOURS`, 12 h) **und** harte Obergrenze (`AUTH_SESSION_MAX_DAYS`, 7 Tage) | -| Kompromittiertes Konto | Passwort-Reset und Deaktivieren beenden sofort alle Sessions des Kontos; Passwortwechsel beendet alle anderen | -| Aussperren | Der letzte aktive Admin kann weder herabgestuft noch deaktiviert werden; Prüfung und Änderung laufen atomar in einer SQLite-Transaktion. Der eigene Zugang ist in der Liste gesperrt. | -| Rechteausweitung / Mass Assignment | Rolle kommt aus der DB, nie aus der Anfrage; zod-Schemas mit `.strict()` | -| DoS über riesige Passwörter | Längengrenzen (Name 100, Passwort 200 Zeichen) vor scrypt | -| Look-alike-Namen | Anmeldename nur `a-z 0-9 . _ @ -`, klein geschrieben | -| Clickjacking | `X-Frame-Options: SAMEORIGIN`, `frame-ancestors 'self'` (next.config.mjs) | -| Speicherwachstum | Max. 20 Sessions je Nutzer, periodisches Aufräumen abgelaufener Sessions, Throttle-Tabelle begrenzt | - -**Nicht durch Code lösbar:** Ohne TLS gehen Passwort und Session-Cookie im -Klartext durchs Netz. Für Zugriff außerhalb des LANs HTTPS über einen -Reverse-Proxy vorschalten und `COOKIE_SECURE=true` setzen. - -## Bootstrap-Admin - -`AUTH_BOOTSTRAP_USERNAME` / `AUTH_BOOTSTRAP_PASSWORT` (Env-Variablen, siehe -`compose.yaml`) legen beim ersten Start einen Admin an – **nur falls die -`users`-Tabelle noch komplett leer ist**. Danach werden diese Variablen -ignoriert; jeder weitere Zugang entsteht über Config → Benutzer. Die Werte -gehören in eine lokale, nicht versionierte `.env` auf dem Deploy-Host, nicht -in `compose.yaml` selbst. - -```dotenv -AUTH_BOOTSTRAP_USERNAME=admin -AUTH_BOOTSTRAP_PASSWORT= -AUTH_SESSION_HOURS=12 -AUTH_SESSION_MAX_DAYS=7 -COOKIE_SECURE=false -``` - -Bei Zugriff über HTTPS muss `COOKIE_SECURE=true` gesetzt werden. Bei direktem -HTTP-Zugriff im LAN bleibt es `false`, da der Browser das Session-Cookie sonst -nicht speichert. - -## Bewusst nicht umgesetzt (Stand jetzt) - -- Konfigurierbare Rechte-Matrix statt fixer `admin`/`user`-Rollen -- Dauerhafte Konten-Sperre nach Fehlversuchen (es gibt nur die zeitlich - begrenzte Drosselung, siehe oben) -- E-Mail-/Einmal-Link-Passwortvergabe, OIDC/Entra-Anmeldung -- Verknüpfung von Zugängen mit einer Mitarbeiter-Stammdatentabelle diff --git a/docs/building-structure.md b/docs/building-structure.md index 2264b3f..c48e895 100644 --- a/docs/building-structure.md +++ b/docs/building-structure.md @@ -4,8 +4,7 @@ Projekte mit mehreren Gebäuden werden über eine eigene Ebene **Gebäude** gegliedert. Etagen können einem Gebäude zugeordnet sein, Räume und Verteilungen hängen wie bisher an der Etage. Das Gebäude eines Raums oder einer Verteilung ergibt sich also aus der Etage; eine zweite, konkurrierende Zuordnung gibt es -nicht. Abgestimmt in Issue #6: Das Modell ist so bestätigt, und Gebäude mit -zugeordneten Etagen lassen sich nicht löschen. +nicht. Abstimmung mit Julian: Issue #6. ## Datenmodell @@ -13,7 +12,6 @@ zugeordneten Etagen lassen sich nicht löschen. |---|---|---| | `buildings` | `id`, `project_id` (FK, cascade), `name`, `sort_order` | Gebäude eines Projekts | | `floors` | `building_id` (nullable FK → `buildings`, `ON DELETE set null`) | optionales übergeordnetes Gebäude | -| `rooms` | `area_m2` (nullable `REAL`) | optional gepflegte Netto-Raumfläche in m² | Migration `0009_buildings`. Bestehende Etagen behalten `building_id = null` und erscheinen in der Oberfläche als „Ohne Gebäude“. Es gibt keine Zwangsmigration @@ -21,11 +19,6 @@ und kein automatisch angelegtes Standardgebäude. Vor dem Anwenden der Migration auf eine bestehende Datenbank ist wie bei jeder Schemamigration eine separate Datenbanksicherung anzulegen. -Migration `0011_glossy_norman_osborn` ergänzt ausschließlich das nullable Feld -`rooms.area_m2`. Bestehende Räume behalten damit eine unbekannte Fläche. Vor -dem Anwenden auf eine bestehende Datenbank ist ebenfalls eine separate -Datenbanksicherung erforderlich. - ## Befehle, Undo/Redo Alle Änderungen laufen über die bestehende Orts-Struktur @@ -47,22 +40,17 @@ persistentem Undo/Redo: Vorwärts- und Inversbefehle sind Version 2. Das ist bei linearer Historie exakt: Wird ein Gebäude später zugeordnet, liegt dieser neuere Befehl im Undo-Stapel vor dem alten Befehl und wird zuerst zurückgenommen. -- Raumbefehle `project-room.insert/.update/.delete` haben seit Schema-Version - **2** das Feld `areaM2`. Version-1-Befehle werden beim Einlesen mit - `areaM2 = null` hochgestuft. Vor einem alten Update oder Delete wird weiterhin - der vollständige erwartete Datensatz verglichen; eine inzwischen vorhandene - Fläche kann deshalb nicht unbemerkt gelöscht werden. +- Raumbefehle bleiben unverändert (Version 1). ## Snapshots und Transfer -Projekt-Snapshot-Schema **8** enthält zusätzlich `rooms[].areaM2`. Version 7 -wird mit `areaM2 = null` hochgestuft; die älteren unterstützten Versionen 1–6 -werden außerdem mit leerer Gebäudeliste und `buildingId = null` hochgestuft. -Gespeicherte Sicherungspunkte bleiben wiederherstellbar. Die Relationen werden -geprüft (Gebäude gehört zum Projekt, `buildingId` verweist auf ein Gebäude des -Snapshots). Restore und Projekttransfer erhalten die Raumfläche. Das portable -Transferformat bleibt Version 2, weil es den versionierten Projektsnapshot -bereits einbettet; beim Duplizieren werden nur IDs und Relationen umgesetzt. +Projekt-Snapshot-Schema **7** enthält `buildings` und `floors[].buildingId`. +Alle älteren unterstützten Versionen (1–6) werden beim Einlesen mit leerer +Gebäudeliste und `buildingId = null` hochgestuft; gespeicherte Sicherungspunkte +bleiben wiederherstellbar. Die Relationen werden geprüft (Gebäude gehört zum +Projekt, `buildingId` verweist auf ein Gebäude des Snapshots). Restore löscht +und schreibt Gebäude zusammen mit den Etagen; der Projekt-Transfer vergibt neue +Gebäude-IDs und stellt die Etagenverweise um. ## API @@ -74,10 +62,6 @@ bereits einbettet; beim Duplizieren werden nur IDs und Relationen umgesetzt. - `POST/PUT /api/projects/:projectId/floors[/:floorId]` akzeptieren zusätzlich optional `buildingId` (`string | null`). Fehlt das Feld, bleibt beim Bearbeiten das bisherige Gebäude erhalten; ältere Clients funktionieren unverändert. -- `POST/PUT /api/projects/:projectId/rooms[/:roomId]` akzeptieren zusätzlich - optional `areaM2` (`number | null`, endlich und ≥ 0). Beim Anlegen bedeutet - ein fehlendes Feld `null`; beim Bearbeiten bleibt die vorhandene Fläche - erhalten, wenn das Feld fehlt. ## Oberfläche @@ -89,24 +73,9 @@ nur dessen Etagen, Klick auf eine Etage nur deren Räume, „Alle“ hebt den Fi auf. Hinzufügen, Bearbeiten und Löschen laufen über Icon-Buttons wie in der Stromkreisliste. -Der Raumdialog pflegt die optionale **Fläche [m²]** mit deutscher -Dezimaltrennzeichen-Eingabe. Gemeint ist die Netto-Raumfläche, wie sie der -Revit-Raumparameter „Fläche“ liefert, nicht eine Flächenart nach DIN 277. Die -Fläche wird ohne fachliche Rundung gespeichert und mit zwei Nachkommastellen -angezeigt. Die Gebäudestruktur zeigt die Fläche je Raum sowie Summen je Etage, -je Gebäude, „Ohne Etage“ und „Ohne Gebäude“. Fehlende Flächen werden nicht als -Nullfläche ausgegeben, sondern separat gezählt, damit Teilsummen erkennbar -bleiben. - ## Offen -- Revit: Eine Übernahme des Gebäudes aus Revit ist derzeit nicht geplant. Die - abgeschlossene Phase 14 verwendet Linear-XLSX; das Modell steht der expliziten - Raumzuordnung im Importwizard nicht im Weg. -- Raumflächen werden derzeit ausschließlich manuell gepflegt. Ein späterer - Revit-Abgleich muss die Phase-14-Regeln mit externem Modellzustand, Vorschau - und ausdrücklicher Bestätigung einhalten. -- Eine W/m²-Auswertung oder Übernahme der Raumfläche in Flächenlasten ist nicht - Teil dieser Funktion; das ist Folgethema von Issue #20. +- Revit: Das Gebäude kann später aus einem Revit-Parameter kommen und über die + bestehende CSV-Zuordnung gemappt werden (Frage an Julian in Issue #6). - Sortierung von Gebäuden per Drag-and-drop ist noch nicht umgesetzt; neue Gebäude werden hinten angehängt. diff --git a/docs/cable-sizing-module.md b/docs/cable-sizing-module.md deleted file mode 100644 index cd8b08d..0000000 --- a/docs/cable-sizing-module.md +++ /dev/null @@ -1,109 +0,0 @@ -# Leitungsberechnung - -Das optionale Modul gibt für einen einzelnen Stromkreis eine prüfbare -Querschnittsempfehlung aus. Es schreibt selbst keine Projektdaten. Erst die -ausdrückliche Aktion **Übernehmen** aktualisiert `cableCrossSection`, -`cableType` und `cableLength` über den vorhandenen Befehl `circuit.update`. -Revisionen sowie Undo/Redo bleiben dadurch erhalten. - -Eine automatische Bemessung aller Stromkreise ist weiterhin nicht Bestandteil -des Moduls. - -## Aufbau - -```text -src/cable-sizing/domain/cable-sizing-calculation.ts Berechnung und Tabellen -src/cable-sizing/domain/cable-sizing-contracts.ts API-Validierung -src/server/controllers/cable-sizing.controller.ts zustandslose Endpunkte -src/server/routes/cable-sizing.routes.ts Router -src/frontend/components/cable-sizing-api.ts Fetch-Client -src/frontend/components/cable-sizing-defaults.ts Vorbelegung -src/frontend/components/cable-sizing-modal.tsx Dialog -tests/cable-sizing-calculation.test.ts Tabellen und Grenzfälle -``` - -Das Domänenmodul hängt weder von Datenbank, Server noch React ab. Die API ist -zustandslos. Im Stromkreis-Editor öffnet ein Rechner-Symbol den Dialog; die -Kabelzellen behalten ihr übliches Spreadsheet-Verhalten. - -## Eingaben - -Aus dem Stromkreis werden Leistung, Phasen, Spannung, leistungsgewichtetes -cos φ, Leitungslänge und ein vorhandenes Überstromschutzorgan vorbelegt. Der -Planer wählt Verlegeart, Isolierstoff, Leitermaterial, Temperatur, Häufung, -zulässigen Spannungsfall und bei Drehstrom den Anteil der dritten Harmonischen. - -Eine Leitungslänge von `0 m` ist zulässig. Der Dialog weist sichtbar darauf -hin, dass dann kein Spannungsfall angesetzt wird. - -## Normative Grundlage und Grenzen - -Die Strombelastbarkeiten und Korrekturfaktoren wurden gegen -**DIN VDE 0298-4 (VDE 0298-4):2023-06** einschließlich -**Berichtigung 1:2023-10** geprüft: - -- Strombelastbarkeit: Tabellen 3 bis 6. -- Temperaturfaktoren: Tabellen 17 und 20. -- Häufung A1 bis C: Tabelle 22 nach der korrigierten Zuordnung. -- Häufung D: Tabelle 26 für sich berührende Rohre oder Kanäle im Erdreich. -- Oberschwingungen: Anhang B, insbesondere Tabelle B.1. - -Unterstützt werden A1, A2, B1, B2, C, D und E. D bezeichnet ausschließlich -mehradrige Kabel oder Mantelleitungen im Rohr beziehungsweise Kanal im -Erdreich. Direkte Erdverlegung wird nicht angeboten, weil DIN VDE 0298-4 dafür -auf die Kabel-Produktnorm DIN VDE 0276-603 verweist. - -Für Verlegeart E hängen Häufungsfaktoren von Trägerart, Abstand und Anzahl der -Kabelpritschen ab. Diese Angaben gehören noch nicht zum Eingabemodell. Daher -ist E nur für einen einzelnen Stromkreis berechenbar. Für D sind höchstens -sechs gehäufte Stromkreise durch die verwendete Tabellenzeile abgedeckt. - -Aluminium wird erst ab 25 mm² angeboten, weil die verwendeten Tabellen keine -kleineren Aluminiumquerschnitte enthalten. Bei mehr als 33 % dritter -Harmonischer ist der Neutralleiterstrom Bemessungsgrundlage. Solange dieser -nicht als Zahlenwert eingegeben und berechnet wird, liefert das Modul keine -Empfehlung. - -Die Berechnung des Spannungsfalls ist eine vereinfachte Ergänzung mit -Leitfähigkeit bei Betriebstemperatur; Reaktanz wird vernachlässigt. Ihre -Planungsgrenzen folgen nicht allein aus DIN VDE 0298-4. Auch die Koordination -mit Leitungsschutzschaltern und gG-Sicherungen gehört zur -Überstromschutzbemessung und ist getrennt von der Strombelastbarkeit zu -beurteilen. Der Dialog bezeichnet diese Ergebnisse deshalb nicht als vollständig -normative Leitungsbemessung. - -## Rechenweg - -1. Betriebsstrom `I_B` aus Leistung, Spannung, cos φ und Phasenzahl. -2. Erforderliche Belastbarkeit aus `I_B` und gegebenenfalls dem vorhandenen - Schutzorgan. -3. Tabellenwert `I_z` multipliziert mit Temperatur-, Häufungs- und gegebenenfalls - Oberschwingungsfaktor. -4. Vereinfachter Spannungsfall für jeden verfügbaren Querschnitt. -5. Empfehlung als größerer Querschnitt aus Belastbarkeit und Spannungsfall. -6. Bei einphasigen Stromkreisen Anhebung auf den vereinbarten praktischen - Mindestquerschnitt von 2,5 mm². - -Temperaturen und Häufungen zwischen Tabellenwerten werden zum nächsten -ungünstigeren Tabellenwert gerundet. Außerhalb des belegten Tabellenbereichs -wird keine Empfehlung ausgegeben. Ein abweichender Querschnitt kann weiterhin -manuell eingetragen und bewusst übernommen werden. - -## Nicht enthalten - -- direkte Erdverlegung -- detaillierte Anordnung mehrerer Kabel bei Verlegeart E -- Neutralleiterbemessung bei mehr als 33 % dritter Harmonischer -- Kurzschlussfestigkeit, Schleifenimpedanz, Abschaltbedingungen und Selektivität -- abweichender Bodenwärmewiderstand sowie Verlegearten F und G -- automatische Berechnung oder Änderung mehrerer Stromkreise - -## API - -`POST /api/cable-sizing/calculate` berechnet zustandslos. Die Verlegeart ist -`A1 | A2 | B1 | B2 | C | D | E`; `lengthM` darf `0` sein. Das Ergebnis enthält -`supported: false` und einen der Gründe `temperature`, `grouping` oder -`harmonics`, wenn keine belastbare Empfehlung möglich ist. - -`GET /api/cable-sizing/laying-methods` und -`GET /api/cable-sizing/insulation-materials` liefern die Auswahllisten. diff --git a/docs/circuit-list-editor-api.md b/docs/circuit-list-editor-api.md index c88e4aa..156be62 100644 --- a/docs/circuit-list-editor-api.md +++ b/docs/circuit-list-editor-api.md @@ -59,24 +59,6 @@ this value for optimistic concurrency checks. - clients cannot submit arbitrary `project.restore-state` payloads through the generic command endpoint -Grobbilanzen sind bewusst kein Teil dieser logischen Snapshots. Der portable -Projektexport unter `GET /projects/:projectId/export` verwendet dagegen -Transferformat 2 und enthält alle Grobbilanzen. Die beiden Importwege -`POST /projects/:projectId/import` und `POST /projects/import` prüfen ihre -Prüfsumme; Ersetzen übernimmt die Grobbilanzen atomar und mit Undo/Redo, -Duplizieren vergibt neue IDs. Transferformat 1 bleibt ohne Grobbilanzen -importierbar. - -Das aktuelle Projekt-Snapshot-Schema 10 enthält Linear-XLSX-Zustand und die in -Schema 9 eingeführten logischen Einspeisungsverweise der Verteilungen; -Versionen 1–8 werden mit leeren Verweisen hochgestuft. Schema 8 -enthält außerdem die optionale Netto-Raumfläche `rooms[].areaM2`. -Snapshot-Versionen 1–7 werden dafür mit -`areaM2 = null` hochgestuft. Restore, Export und Import erhalten vorhandene -Flächen und Einspeisungsverweise; beim Duplizieren werden Board- und Circuit-IDs -neu zugeordnet. Eine eigene Transferformat-Version ist nicht nötig, weil Format 2 den -versionierten Projektsnapshot einbettet. - The public dispatcher supports the Circuit and CircuitDeviceRow commands `circuit.update`, `circuit.insert`, `circuit.delete`, `circuit-device-row.update`, `circuit-device-row.insert`, @@ -232,12 +214,6 @@ A stale `expectedRevision` returns HTTP `409` with `PROJECT_REVISION_CONFLICT`. Undo or redo without an eligible stack entry returns HTTP `409` with `PROJECT_HISTORY_OPERATION_UNAVAILABLE`. -## Estimate Balance (Grobe Leistungsbilanz) - -Separate module under `/projects/:projectId/estimate-balances`; complete -documents are written through `estimate-balance.insert/.update/.delete` project -commands. Endpoints, payloads and calculation rules: `docs/estimate-balance.md`. - ## Circuit-First Endpoints ### Distribution Board Setup @@ -258,37 +234,23 @@ commands. Endpoints, payloads and calculation rules: `docs/estimate-balance.md`. - stale revisions return `409 PROJECT_REVISION_CONFLICT` - `PUT /projects/:projectId/distribution-boards/:distributionBoardId` - body: - `{ "floorId": null, "supplyType": "AV", "simultaneityFactor": 1, "feedingDistributionBoardId": "board_hv", "feedingCircuitId": "circuit_out", "expectedRevision": 13 }` + `{ "floorId": null, "supplyType": "AV", "simultaneityFactor": 1, "expectedRevision": 13 }` - optional info-card fields: `boardNumber` (max. 50), `location`, `fedFrom` (max. 200 each) and `remark` (max. 2000); strings are trimmed and an empty string is stored as `null` - - `feedingDistributionBoardId` and `feedingCircuitId` are optional nullable - fields. A feeding circuit requires a feeding board and must belong to it; - self-links and cycles are rejected. A board-only link creates hierarchy - without assigning its load to an upstream circuit. - - executes `distribution-board.update` schema version 2; all submitted values, including the + - executes `distribution-board.update`; all submitted values, including the submitted info fields, are restored together by persistent Undo/Redo - - `fedFrom` remains free text for external feeds such as HAK, metering, - transformer or generator and for supplementary notes -- The project-command endpoint additionally accepts - `distribution-board.create-feeder-circuit` with an empty complete circuit - snapshot and an embedded version-2 `distribution-board.update`. Both writes - are one transaction, revision and Undo step. The generated circuit has no - device row; Redo keeps its UUID and BMK. The history-only inverse - `distribution-board.remove-feeder-circuit` restores the previous board values - and removes only the unchanged circuit. + - `fedFrom` is free text until the logical feed link is modeled - `POST /projects/:projectId/distribution-boards/:distributionBoardId/copy` - body: `{ "name": "UV-02 Kopie", "expectedRevision": 14 }` - duplicates the complete distribution-board subtree with new owning UUIDs - while preserving project-device, room and incoming feeding links + while preserving project-device and room links - response includes the new `distributionBoard`, its `circuitList`, the revision and current history state - `DELETE /projects/:projectId/distribution-boards/:distributionBoardId` - body: `{ "expectedRevision": 15 }` - removes the complete, exactly captured distribution-board subtree in one transaction - - rejects deletion while another board references this board or one of its - circuits as a feeder; circuit and populated-group deletion use the same guard - response includes `distributionBoardId`, the revision and current history state - Copy and deletion use `distribution-board.insert-subtree` and @@ -321,43 +283,29 @@ commands. Endpoints, payloads and calculation rules: `docs/estimate-balance.md`. - rejects floors with assigned rooms or distribution boards - `POST /projects/:projectId/rooms` - body: - `{ "floorId": "floor_1", "roomNumber": "001", "roomName": "Technik", "areaM2": 18.75, "expectedRevision": 14 }` - - executes `project-room.insert` command version 2 with a stable room id; - `floorId` and `areaM2` are optional. An omitted or explicit `null` area - creates a room without area; a value must be finite and non-negative. + `{ "floorId": "floor_1", "roomNumber": "001", "roomName": "Technik", "expectedRevision": 14 }` + - executes `project-room.insert` with a stable room id; `floorId` is optional + and must belong to the project when present - response: `{ "room": { ... }, "revision": { ... }, "history": { ... } }` - `PUT /projects/:projectId/rooms/:roomId` - body: - `{ "floorId": null, "roomNumber": "101", "roomName": "Büro", "areaM2": null, "expectedRevision": 16 }` - - updates number, name, optional floor and area as one persistent version-2 - command. If `areaM2` is omitted, the current area is retained; `null` - explicitly clears it. + `{ "floorId": null, "roomNumber": "101", "roomName": "Büro", "expectedRevision": 16 }` + - updates number, name and optional floor as one persistent command - `DELETE /projects/:projectId/rooms/:roomId` - body: `{ "expectedRevision": 17 }` - rejects rooms referenced by device rows - Persistent Undo/Redo restores exact previous and target records without silently clearing foreign keys. -- Stored version-1 room commands remain executable and are upgraded with - `areaM2 = null`. Exact expected-record checks reject an old update or delete - if a newer command has added an area, so legacy history cannot silently - erase it. - Stale revisions return `409 PROJECT_REVISION_CONFLICT`. ### Tree Endpoint -- `GET /projects/:projectId/circuit-trees` - - returns all circuit trees for one project from one project-wide read and is - used by the print view and feeding-board selection - `GET /projects/:projectId/circuit-lists/:circuitListId/tree` - Purpose: returns fixed header components, grouped sections with optional protection components, complete circuit/device-row blocks and auxiliary footer components. Circuit and component protection devices use their separate one-to-one DTOs. Calculated row, circuit, section and board totals - remain included. Circuit totals contain the demand of linked downstream - boards. `downstreamBoardLoads` exposes those contributions as read-only - values; the grid combines exactly one downstream board without device rows - into the circuit row and keeps child rows for mixed or multiple loads. - `feedingReference` resolves the current board/circuit labels by id. + remain included. Response sketch: @@ -463,55 +411,40 @@ inverse command. The former direct restore/reconnect endpoints are removed. `displayName` is included in the comparison but is not selected by default in the UI. Updating a project device never triggers synchronization implicitly. -## Cable Sizing (optional module) +## Revit CSV Foundation -Stateless calculator endpoints mounted at `/api/cable-sizing`. They neither -read nor write project data; applying a result uses `circuit.update` through -`POST /projects/:projectId/commands`. +- `GET /projects/:projectId/external-csv/configuration` + - returns the complete versioned project configuration or `null` +- `PUT /projects/:projectId/external-csv/configuration` + - request: `expectedRevision` and the complete validated configuration + - executes `external-csv-configuration.update` + - returns configuration, revision and project history state +- `POST /projects/:projectId/external-csv/preview` + - request: file name and Base64-encoded CSV content up to 18 MB + - requires a stored project configuration + - returns transport metadata, SHA-256, row classifications, suspect row + numbers and mapped source values for every recognized IFC object + - does not persist a draft, mutate project state or create a revision +- `POST /projects/:projectId/external-csv/initial-import/plan` + - reparses the file and returns grouped room/family decisions plus current + room, distribution-board and ProjectDevice catalogs + - is stateless and rejects an already imported external source +- `POST /projects/:projectId/external-csv/initial-import/apply` + - requires the expected revision, configuration version, file hash and one + decision for every room and exact family/type group + - reparses the file, blocks unknown family/type values and executes + `external-import.apply-initial` as one undoable project revision + - creates no Circuit or CircuitDeviceRow +- `GET /projects/:projectId/circuit-lists/:circuitListId/external-objects` + - resolves the circuit list's distribution board server-side + - returns only external objects assigned to that board, with unassigned + objects first, their source room/marker values and current row-link status + - returns an empty list when the optional Revit import does not exist + - is read-only and exposes no stored command payloads or import bytes -- `POST /cable-sizing/calculate` - - request: phase, mode (`power` | `current`), powerKw or currentA, cosPhi, - voltage, lengthM, layingMethod (`A1` | `A2` | `B1` | `B2` | `C` | `D` | - `E`), conductorMaterial, insulation (`pvc` | `xlpe`), - ambientTemperatureC, groupingCircuits, maxVoltageDropPercent, - harmonicNeutralLoad, optional `existingProtection` - (`{ ratedCurrentA, kind: "breaker" | "fuse" }`) and circuitCategory - - returns `{ "result": { ... }, "alerts": [ ... ] }`; `result.supported` - is `false` with `unsupportedReason` when temperature or grouping lie - outside the tables or the neutral current needed above 33 % third - harmonic is unavailable - - unknown fields are rejected (`400`) -- `GET /cable-sizing/laying-methods` -- `GET /cable-sizing/insulation-materials` - -Full request example and calculation rules: `docs/cable-sizing-module.md`. - -## Revit / Linear XLSX - -- `GET|PUT /projects/:projectId/external-model/configuration` reads or writes - the complete XLSX configuration. PUT requires `expectedRevision`. -- `POST /projects/:projectId/external-model/configuration/detect` detects the - sheet layout and columns from an uploaded `.xlsx` sample without persisting. -- `GET /projects/:projectId/external-model/import-status` returns the latest - batch metadata, object count and current missing-object count. -- `POST .../initial-import/plan|apply` provides the stateless initial plan and - its confirmed atomic application. Apply retransmits and reparses the XLSX. -- `POST .../follow-up-import/plan|apply` classifies exact Worksharing-ID - additions, source changes, unchanged and missing objects. Apply requires the - preview hash and source decisions and updates linked row quantities atomically. -- `GET|PUT .../external-model/objects` loads one compact project list and - applies revision-safe multi-object planning changes. -- `POST .../objects/assign-row|assign-new-row|assign-new-circuit|detach-row` - changes external-object row assignments through persistent commands. -- `POST .../objects/delete-missing` requires `confirmed: true`, deletes only - objects marked missing and adjusts linked row quantities in the same command. -- `POST .../external-model/return-workbook` creates the structure-preserving - return XLSX for all, deviating or selected objects. -- `GET .../external-model/export-batches` returns append-only export metadata. - -Uploads accept only `.xlsx` up to 10 MiB. Worksharing-IDs are exact and -case-sensitive; IfcGUID is optional and non-unique. Undo/Redo uses persisted -command states and never reparses workbook bytes. +Parser errors expose stable codes such as `header-not-found`, +`ambiguous-header`, `invalid-ifc-guid` and `duplicate-ifc-guid`. The confirmed +import uploads and parses the file again and verifies its hash. ## Document Branding (print view) diff --git a/docs/circuit-list-editor-known-limitations.md b/docs/circuit-list-editor-known-limitations.md index f9fecb5..3e70e76 100644 --- a/docs/circuit-list-editor-known-limitations.md +++ b/docs/circuit-list-editor-known-limitations.md @@ -9,20 +9,16 @@ - Named and automatic logical project snapshots can be listed and restored through the project page with persistent Undo/Redo. Automatic snapshots are created every 25 revisions and only their newest 12 entries are retained. -- Die Linear-XLSX-Anbindung bis R10 ist umgesetzt: Erst- und Folgeimport, - Objektplanung und Editorzuordnung, strukturtreue Rückgabe sowie bestätigtes - Löschen fehlender Objekte verwenden persistente Commands. Die vollständige - Kette ist mit 5.000 synthetischen Objekten sowie Snapshot-, Transfer- und - Neustarttests geprüft. +- The Revit/CSV foundation and confirmed initial import are implemented. + Existing-row assignment, move and detach plus creation of an external-only + row in an existing or newly created circuit have atomic persistent commands. + Their API planning and editor UI, follow-up import, conflict review and return + export are pending. - Persistence currently targets local SQLite; PostgreSQL is an architectural option, not an implemented runtime. - The global device library supports basic CRUD and copy operations, but has no versioning, permissions or controlled synchronization model. -- There is no automatic sizing of all circuits. The optional cable sizing - module suggests a cross-section for one circuit on demand using - DIN VDE 0298-4:2023-06 with Berichtigung 1:2023-10. It excludes direct - burial, grouped method E and neutral-current sizing above 33 % third - harmonic, and it does not check short-circuit withstand, disconnection time - or selectivity. See `docs/cable-sizing-module.md`. +- Final electrical sizing logic is not implemented yet. +- No full norm-compliant voltage-drop and protection-dimensioning calculation flow yet. - Sorting is view-only until users explicitly apply sorted order. - Complete-circuit drag supports one circuit at a time between groups of the same category. Cross-category moves and multi-circuit moves across group @@ -31,13 +27,10 @@ - Protection and cable values are planner-owned manual selections. The later sizing/warning engine does not yet validate them against load, length or voltage-drop rules. -- One logical incoming feed per distribution board is supported. A second or - replacement feed with changeover semantics (for example SV/SiBe) is still a - follow-up. `fedFrom` remains the free-text field for external sources and - supplementary notes. Revit does not yet propose logical feed links. -- A logical link without a selected feeding circuit appears in the hierarchy, - but deliberately contributes no load to an upstream circuit until the planner - selects that circuit (see `docs/print-view.md`). +- Distribution-board `fedFrom` is free text. The print overview derives its + supply structure and "Σ inkl. unterlagert" only from exact text matches with + board numbers/names and adds values without an upstream simultaneity factor + (see `docs/print-view.md`). - The print view uses a kbp corporate design derived from logo and presentation material. Snapshots do not record an editor, so the cover's Planstände list shows the project's current editor for every entry. On screen, long diff --git a/docs/current-architecture.md b/docs/current-architecture.md index d7f28cb..1840d59 100644 --- a/docs/current-architecture.md +++ b/docs/current-architecture.md @@ -33,15 +33,6 @@ mit Hot Reload. Das Frontend leitet `/api/*` über `API_INTERNAL_URL` an die API weiter; beim gebauten Stand wird das Ziel zur Build-Zeit festgelegt. Die Datenbank liegt über einen Host-Mount außerhalb des Containers. -Vor allen fachlichen `/api/*`-Routen liegt die Cookie-basierte Anmeldung aus -`src/server/auth`. Nur Login, Status und Logout sind ohne Session erreichbar. -Schreibzugriffe verlangen zusätzlich den Anwendungsheader -`X-Leistungsbilanz-Request: 1`, damit der Schutz auch beim HTTP-Zugriff im LAN -ohne Fetch-Metadata-Header greift. `/api/users/*` ist Administratoren -vorbehalten. Konten sind globale Betriebsdaten und gehören nicht zu -Projektkommandos, Snapshots oder Projekttransfers. Sessions liegen im Speicher -des einzelnen API-Prozesses und enden bei dessen Neustart. - Neue IDs für Stromkreise, Gerätezeilen, Gruppen und Verteilerkomponenten erzeugt der Editor über `src/frontend/utils/client-id.ts` (`createClientId`). Die Hilfsfunktion nutzt `crypto.randomUUID()`, sofern verfügbar, andernfalls @@ -52,13 +43,8 @@ vor dem Command und bleiben über Undo/Redo unverändert. ## Wichtige Einstiegspunkte - `src/app/projects/page.tsx` – Projektliste und globale Gerätebibliothek -- `src/app/projects/[projectId]/page.tsx` – Projektstammdaten, Verteilungen - 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]/page.tsx` – Projektstammdaten, Verteilungen, + Räume und Projektgeräte - `src/app/projects/[projectId]/circuit-lists/[circuitListId]/tree-edit/page.tsx` – unterstützte Editorroute - `src/frontend/components/circuit-tree-editor.tsx` – Editorzustand, @@ -66,11 +52,6 @@ vor dem Command und bleiben über Undo/Redo unverändert. - `src/frontend/components/circuit-grid-*.ts` – reine Grid-Projektion, Zellbesitz, Einfügen und Sicherheitsregeln - `src/frontend/utils/api.ts` – typisierte Frontend-API-Aufrufe -- `src/frontend/components/AuthProvider.tsx` und `LoginGate.tsx` – Anmeldung - und erzwungener Wechsel eines Startpassworts -- `src/server/auth/` – Passwort-Hashing, Sessions und Zugriffsschutz -- `src/domain/services/user.service.ts` und `src/domain/ports/user.store.ts` – - kontobezogene Regeln und schmale Persistenzgrenze - `src/server/index.ts` und `src/server/routes/` – API-Komposition - `src/domain/services/` – fachliche Command- und Synchronisierungsregeln - `src/server/composition/` – Verdrahtung fachlicher Services mit konkreten @@ -309,20 +290,15 @@ Projektdaten und erzeugen keine Revisionen. Das Löschen eines Projektgeräts erfordert eine Bestätigung mit dessen Namen und verwendet weiterhin den bestehenden persistenten Projektbefehl. -`GET /api/projects/:projectId/export` verpackt den vollständigen portablen -Projektzustand in ein format- und schema-versioniertes JSON-Dokument mit -SHA-256-Prüfsumme. Transferformat 2 enthält zusätzlich alle Grobbilanzen, -ohne sie in das logische Snapshot-Schema aufzunehmen; Format 1 bleibt ohne -Grobbilanzen importierbar. `POST /api/projects/:projectId/import` prüft Format, -Snapshot-Relationen, Grobbilanzen und Prüfsumme vor jedem Schreibzugriff. Der -Modus `replace` läuft über `project.restore-state` Version 2 und ersetzt den -Projektzustand und die Grobbilanzen atomar und dauerhaft rückgängig machbar. -Normale Snapshot-Restores verwenden weiterhin Version 1 und lassen -Grobbilanzen unverändert. Der Modus `duplicate` ordnet Projekt-, +`GET /api/projects/:projectId/export` verpackt denselben vollständigen +Projektzustand in ein portables, format- und schema-versioniertes JSON-Dokument +mit SHA-256-Prüfsumme. `POST /api/projects/:projectId/import` prüft Format, +Snapshot-Relationen und Prüfsumme vor jedem Schreibzugriff. Der Modus `replace` +läuft über `project.restore-state` und ist dadurch eine atomare, dauerhaft +rückgängig machbare Projektrevision. Der Modus `duplicate` ordnet Projekt-, Struktur-, Gruppen-, Verteilerkomponenten-, Raum-, Stromkreis- und -Gerätezeilen-UUIDs sowie Schutzgeräte-Referenzen und die IDs aller Grobbilanzen -vollständig neu zu und legt die Kopie mit Revision `0` in einer Transaktion an. -Fachliche Verknüpfungen +Gerätezeilen-UUIDs sowie Schutzgeräte-Referenzen vollständig neu zu und legt +die Kopie mit Revision `0` in einer Transaktion an. Fachliche Verknüpfungen innerhalb des unterstützten Laufzeitmodells bleiben erhalten. Die Projektübersicht verwendet dafür den separaten Collection-Endpunkt @@ -482,50 +458,16 @@ Derselbe Befehl versioniert die Felder der Verteiler-Infokarte (`boardNumber`, `location`, `fedFrom`, `remark`, Migration `0007`). Die Infokarte liegt im Bearbeiten-Dialog der Verteilung; die Werte sind lokale Planungswerte und sollen später über den Revit-Abgleich nur nach Vorschau und -ausdrücklicher Bestätigung vorbelegt werden. `fedFrom` bleibt Freitext für -externe Einspeisungen und Hinweise. -`distribution-board.update` verwendet Schema-Version 2 für die optionalen -logischen Verweise `feedingDistributionBoardId` und `feedingCircuitId`. -Version-1-Befehle aus der Historie bleiben ausführbar und verändern diese -Verweise nicht. Der speisende Stromkreis muss zur speisenden Verteilung gehören; -Selbstverweise und Zyklen werden abgelehnt. Löschbefehle für referenzierte -Verteilungen und Stromkreise, einschließlich Unterbaum- und Undo-Pfaden, werden -vor der Datenbankänderung fachlich gesperrt. -Im Bearbeiten-Dialog kann nach Auswahl der speisenden Verteilung direkt ein -neuer Einspeiseabgang geplant werden. Die Oberfläche schlägt die dreiphasige -Gruppe und das nächste BMK vor. Der Befehl -`distribution-board.create-feeder-circuit` legt den leeren Stromkreis an und -wendet die vollständige Verteilungsänderung in derselben Transaktion und -Revision an; es entsteht keine Gerätezeile. Schutz und Leitung bleiben bewusst -offen, weil sie aus Last und Verlegebedingungen geplant werden müssen. Undo -stellt zuerst die vorherigen Verteilungswerte wieder her und entfernt danach -nur den unveränderten erzeugten Stromkreis; Redo verwendet UUID und BMK erneut. -Bei genau einer gespeisten Unterverteilung ohne Gerätezeilen projiziert das -Grid nur eine kompakte Stromkreiszeile mit dem über die ID aufgelösten -Verteilernamen. Erst mehrere Unterverteilungen oder zusätzliche Geräte erzeugen -Sammel- und Unterzeilen. Anzeigename und Bemerkung eines leeren -Reservestromkreises gehören zum Stromkreis und erzeugen beim Bearbeiten keine -Gerätezeile. -Die projektweite Circuit-Tree-Projektion berechnet rekursiv die Lasten aller -Verteilungen. Die Leistung einer Unterverteilung nach ihrem eigenen -Verteiler-GZF wird als virtuelle, schreibgeschützte Zeile genau dem gewählten -Abgang zugerechnet. Eine Verknüpfung ohne Stromkreis bildet nur die Hierarchie. -Snapshot-Schema 10 enthält zusätzlich die Linear-XLSX-Konfiguration und den -externen Zustand mit Worksharing-ID-Identität. Leere Versionen 1–9 werden -hochgestuft; Versionen mit tatsächlichem Legacy-CSV-Zustand werden abgelehnt. -Snapshot-Schema 9 enthält die beiden Einspeisungsverweise; Versionen 1–8 werden -mit `null` hochgestuft. Restore und Projektduplizierung erhalten beziehungsweise -remappen die Verweise. Snapshot-Schema 8 enthält zusätzlich die optionale Netto-Raumfläche -`rooms[].areaM2`; Versionen 1–7 werden dafür mit `null` hochgestuft. -Snapshot-Schema 7 enthält die Gebäude und die Gebäudezuordnung der Etagen; -ältere Versionen werden ohne Gebäude hochgestuft. +ausdrücklicher Bestätigung vorbelegt werden. `fedFrom` ist vorerst Freitext. +Snapshot-Schema 7 enthält zusätzlich die Gebäude und die Gebäudezuordnung +der Etagen; ältere Versionen werden ohne Gebäude hochgestuft. Snapshot-Schema 6 enthält diese Felder und die Deckblattangaben des Projekts; ältere Versionen werden mit `null` hochgestuft. Snapshot-Schema 5 enthält zusätzlich den manuellen Mengenanteil jeder Gerätezeile. Version 4 wird mit `manualQuantity = quantity` hochgestuft und -enthielt bereits den damaligen externen CSV-Modellzustand -aus Quelle, Batches, Raum-Mappings und Objekten. Es enthielt außerdem die -damalige projektweite Revit-CSV-Konfiguration, die Gebäudekennzeichnung sowie den Gleichzeitigkeitsfaktor, +enthält bereits den vollständigen externen Modellzustand +aus Quelle, Batches, Raum-Mappings und Objekten. Es enthält außerdem die +projektweite Revit-CSV-Konfiguration, die Gebäudekennzeichnung sowie den Gleichzeitigkeitsfaktor, Gruppenkategorie und -nummer, Verteilerkomponenten sowie die getrennten 1:1-Schutzgerätedaten. Capture, benannte und automatische Snapshots, Wiederherstellung, Undo/Redo und beide @@ -536,12 +478,7 @@ Baseline-Version 1 wird zusätzlich mit `isPublicBuilding = false` hochgestuft; dieser Baseline werden nicht eingelesen. Persistente Insert-, Update- und Delete-Commands versionieren Anlage, Bearbeitung und Löschung von Geschossen und Räumen mit stabilen UUIDs und -exakten Vorher-/Nachher-Snapshots. Raumbefehle verwenden Version 2 und führen -die nullable, nicht negative Netto-Raumfläche `areaM2`; Version-1-Befehle -werden mit `null` hochgestuft und bleiben durch den vollständigen -Snapshotvergleich konfliktfest. Der Raumdialog pflegt die Fläche manuell mit -deutscher Dezimaleingabe, die Gebäudestruktur zeigt zwei Nachkommastellen sowie -Summen und die Anzahl fehlender Flächen je Etage und Gebäude. Ein Geschoss wird nur +exakten Vorher-/Nachher-Snapshots. Ein Geschoss wird nur entfernt, solange ihm weder ein Raum noch eine Verteilung zugeordnet wurde. Ein Raum wird nur entfernt, solange keine CircuitDeviceRow auf ihn verweist. Alle Schreibendpunkte verlangen `expectedRevision` und liefern den aktualisierten @@ -562,36 +499,6 @@ werden als Diff angezeigt und nur für ausdrücklich gewählte Felder und Zeilen Die globale Gerätebibliothek ist ein einfacher, datenbankweiter Vorlagenbestand. Kopieren in ein Projekt erzeugt ein eigenständiges Projektgerät. -## Leitungsberechnung - -Das optionale Modul `src/cable-sizing` berechnet auf Anforderung eine -Querschnittsempfehlung für einen Stromkreis. Strombelastbarkeit, Temperatur -und Häufung beruhen auf DIN VDE 0298-4:2023-06 einschließlich -Berichtigung 1:2023-10; Spannungsfall und Schutzorgan werden ergänzend und mit -den in der Moduldokumentation beschriebenen Grenzen geprüft. Die -Domänenlogik ist rein, `POST /api/cable-sizing/calculate` ist zustandslos und -es gibt keine eigene Tabelle. Der Editor öffnet den Dialog über den Button -„Leitungsberechnung“ in der Aktionsspalte; „Übernehmen“ schreibt Kabeltyp, -Querschnitt und Länge über den regulären `circuit.update`-Befehl, also mit -Revision und Undo/Redo. Details, Rechenweg und Prüfnachweis der Tabellen: -`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 - SQLite ist die aktuell unterstützte Datenbank. @@ -626,7 +533,7 @@ Oberfläche: `/projects/:projectId/grobbilanz`. Details: `toLowerCase()` gegen das vollständige Register der Stromkreisliste und wird von jedem Anlage-/Umbenennungspfad für Stromkreise und Verteilerkomponenten aufgerufen, auch dort, wo zuvor kein Vorab-Check existierte. Snapshot- und - Transfer-Integration verwenden aktuell Snapshot-Schema 10. Persistente + Transfer-Integration verwenden aktuell Snapshot-Schema 6. Persistente Insert/Delete/Update-Commands für veränderliche Verteilerkomponenten, Gruppen einschließlich befüllter Unterbäume sowie vollständige Gruppensortierung sind integriert. Der Editor zeigt die geschützte Struktur @@ -643,67 +550,141 @@ PostgreSQL ist bewusst nicht implementiert. Die Domainregeln und Transaktionsgrenzen sollen portabel bleiben; Schema und Betriebsmodell benötigen bei einem späteren Wechsel trotzdem einen eigenen PostgreSQL-Adapter. -## Revit-Anbindung: Linear-XLSX nach R10 +## Revit-CSV-Grundlage -R3 hat den Backend- und Persistenz-Cutover abgeschlossen. Migration `0014` -entfernt die alten externen CSV-Entwicklungsdaten, nachdem verknüpfte -Gerätezeilen auf `manualQuantity` zurückgesetzt wurden. Die neue -`external_model_configurations`-Tabelle besitzt keinen eigenen Versionszähler; -Änderungen laufen als Projekt-Commands über `expectedRevision`. +Der reine Adapter unter `src/external-model/csv` validiert die projektweite +Transport- und Mappingkonfiguration und parst UTF-8-CSV verlustarm in eine +klassifizierte Zellmatrix. Er erkennt Metadaten, Header, Passthrough-, Objekt- +und Verdachtszeilen, prüft IFCGUIDs und serialisiert unveränderte Revit-Exporte +einschließlich BOM, CRLF und Quotierung bytegleich zurück. Der lokale Befehl +`npm run revit:verify-reference` prüft die bereitgestellte Referenzdatei. -Externe Objekte werden je Quelle durch `worksharing_id` exakt und -case-sensitiv identifiziert. `ifc_guid` ist nullable und nicht eindeutig. -Importbatches speichern eine Konfigurationskopie; nur der neueste Batch darf -Originalbytes und die vollständige XLSX-Matrix enthalten, ältere Batches nur -Datum, Dateiname, SHA-256 und Objektzahl. Snapshot-Schema 10, Restore und -Projekttransfer verwenden diesen Zustand und remappen alle internen -Konfigurations-, Gerätearten-, Regel- und Objekt-UUIDs. Leere Snapshots 1–9 -werden hochgestuft; alte Snapshots mit CSV-Konfiguration oder externem -CSV-Zustand sowie alte CSV-History-Commands werden mit einer deutschen Meldung -abgelehnt. +`external_csv_configurations` enthält höchstens eine versionierte Konfiguration +je Projekt. `external-csv-configuration.update` schreibt Anlage, Änderung oder +Entfernung zusammen mit Revision und persistentem Undo/Redo. Snapshot-Schema 6, +Restore und portabler Projekttransfer enthalten diesen Zustand; beim Duplizieren +werden Konfigurations-UUID und Projektlink remapped. -Der XLSX-Adapter liegt unter `src/external-model/xlsx`. Der Backend-CSV-Parser, -seine Endpunkte und Laufzeitverträge sind entfernt. Die Route -`/projects/:projectId/revit` enthält Einstellungen, Importstatus und den -sechsstufigen Erstimportwizard. +Migration `0003` ergänzt die relationale Grundlage für genau eine implizite +`revit_csv`-Quelle je Projekt, geordnete Importbatches, normalisierte +Quellraummappings und über `(sourceId, ifcGuid)` eindeutige externe Objekte. +Batches halten Konfigurationssnapshot, Originalbytes und die klassifizierte +Zellmatrix zusammen. Migration `0004` ergänzt die monotone projektweite +Konfigurationsversion am Batch, getrennt von der Schema-Version des +Konfigurationsformats. Quellwerte, lokale Planungswerte und Override-Metadaten +der Objekte sind getrennt; optionale Links auf Raum, Verteilung, ProjectDevice +und CircuitDeviceRow bleiben nullable. `ExternalModelStateRepository` liest den +vollständigen Zustand deterministisch und unterscheidet unbekannte von noch +nicht importierten Projekten. Der letzte bestätigte Batch wird aus der +Batchreihenfolge abgeleitet statt redundant an der Quelle gespeichert. +Snapshot/Transfer v5 erfasst zusätzlich `manualQuantity`; Version 4 wird mit +dem bisherigen Gesamtwert als manuellem Anteil hochgestuft. Originalbytes, +Matrix und alle internen Links werden weiterhin vollständig erfasst, +stellt sie in Fremdschlüsselreihenfolge wieder her und remappt beim +Projektduplikat jede interne UUID; IFCGUID und Quelltransport bleiben +unverändert. `external-import.apply-initial` ist die atomare Schreibgrenze für +einen bestätigten Erstimport. Vor dem Insert prüft sie den aktuellen +Konfigurationsstand, SHA-256 und Base64-Kanonizität, parst die Originalbytes +erneut, vergleicht Matrix, vollständige IFCGUID-Menge und Quellwerte und +validiert alle Raum-, Verteiler- und ProjectDevice-Links gegen das Projekt. +Nicht explizit als Override markierte Planungswerte müssen dem regelbasierten +Vorschlag entsprechen. Der Command erzeugt und verknüpft ausdrücklich keine +CircuitDeviceRow; Undo entfernt den vollständigen unveränderten Importzustand, +Redo verwendet dieselben UUIDs und Bytes. Bloße Vorschau und Importplanung +erzeugen weiterhin keine dieser Zeilen. -`POST /api/projects/:projectId/external-model/initial-import/plan` liest eine -lokale XLSX zustandslos, gruppiert Quellräume und exakte Familie-und-Typ-Werte -und liefert die vorhandenen Raum-, Verteiler- und ProjectDevice-Kataloge. -Unbekannte Familien bleiben blockierend; fehlender GZF wird sichtbar mit 1 -vorbelegt. `apply` erhält die Datei erneut, parst sie erneut und vergleicht den -Vorschau-SHA-256. Der Command `external-model.apply-initial-import` speichert -die dabei verwendete Konfiguration und den vollständigen externen Zustand in -derselben Transaktion. Er erzeugt weder CircuitDeviceRows noch Circuits oder -BMKs. Seine vollständige Inverse macht Undo/Redo nach Neustart möglich, ohne -Workbookbytes erneut einzulesen oder zu parsen. - -R6 bis R9 ergänzen die einmal geladene, clientseitig gefilterte und -virtualisierte Projektobjektliste, revisionierte Sammelplanung, atomare -Zuordnung im Stromkreislisteneditor, strukturtreue Rückgabe und den -vollständigen Folgeimport. Der Folgeimport trennt fachliche Quelländerungen -von noch nicht nach Revit übernommenen Rückgabewerten, aktualisiert akzeptierte -Mengen samt Row-Summe und markiert fehlende Objekte ohne ihren Link zu lösen. -Eine gesondert bestätigte Aktion löscht fehlende Objekte samt Mengenübergang; -Undo stellt Objekt, Link und Menge wieder her. - -R10 weist den Ablauf über Rückgabe, Folgeimport, Snapshot-Restore, -Projektduplikat und Undo/Redo nach Datenbankneustart nach. Persistenzpfade für -vollständige externe Zustände schreiben große Mengen in begrenzten -SQLite-Blöcken. Der synthetische Abnahmetest verarbeitet 5.000 Objekte; Details -und Messwerte stehen in -[R10-Abnahme](spec/revit-excel-r10-validation.md). - -## Historische CSV-Unterlagen - -Der vor R3 vorhandene CSV-/IfcGUID-Laufzeitpfad ist entfernt. Seine damalige -Ausgangslage bleibt ausschließlich im [R0-Audit](spec/revit-excel-r0-audit.md) -und in den als abgelöst markierten CSV-Spezifikationen nachvollziehbar. Alte -CSV-Snapshots und CSV-History werden weiterhin ausdrücklich abgelehnt. +Migration `0005` trennt bei `CircuitDeviceRow` den manuellen Mengenanteil vom +weiterhin materialisierten Gesamtwert. Bestehende Daten werden mit +`manualQuantity = quantity` übernommen. Die Fachregel für spätere externe +Zuordnungs-Commands lautet `quantity = manualQuantity + Summe der +effectiveQuantity aller verknüpften ExternalModelObjects`; Link und beide +Mengenwerte müssen innerhalb desselben Projekt-Commands wechseln. +`external-object.update-row-assignment` ist diese atomare Schreibgrenze für +bestehende Gerätezeilen. Sie weist mehrere externe Einzelobjekte zu, verschiebt +sie zwischen vorhandenen Rows oder löst ihre Links. Vor dem Schreiben werden +die vollständigen erwarteten Row- und Objektsnapshots, Projektzugehörigkeit, +Verteilung, Gruppenkategorie, Raum und Selektionskennzeichen geprüft. +Abweichende lokale Planungswerte benötigen eine explizite Konfliktbestätigung; +unterschiedliche Räume, Kategorien oder Selektionskennzeichen werden nicht +still zusammengeführt. Alle betroffenen materialisierten Mengen werden aus dem +unveränderten manuellen Anteil und sämtlichen Ziel-Objektlinks validiert. Die +Gegenrichtung enthält dieselben vollständigen Snapshots und funktioniert nach +Neustart; beim Lösen des letzten Objekts bleibt die Row bestehen. +`external-object.assign-to-new-row` fügt unzugeordnete Objekte atomar als neue +Gerätezeile in einen vorhandenen Stromkreis ein. Der manuelle Anteil dieser Row +ist null; Gesamtmenge, Raum, Verteilung, Kategorie, Selektionskennzeichen und +Planungswerte werden vor dem Schreiben geprüft. Undo löst exakt diese Objekte +und löscht die erzeugte Row nur, wenn sie und ihre Linkmenge unverändert sind. +Der Löschbefehl ist ausschließlich für die Projekthistorie zugelassen; eine +normale spätere Trennung lässt die Row gemäß der allgemeinen Zuordnungsregel +bestehen. +`external-object.assign-to-new-circuit` erzeugt einen neuen Stromkreis mit +vorab festgeschriebenem BMK, abgeleiteter Projektspannung, genau einer +externen Row und verpflichtendem Standardschutz zusammen mit den Objektlinks. +Verteilungs-, Gruppen-, Raum-, Mengen- und Planungsregeln werden vor dem Insert +gegen den aktuellen Projektstand geprüft. Der historische Gegenbefehl ist kein +allgemeiner Löschpfad: Er entfernt den vollständigen Circuit-Teilbaum nur bei +unverändertem Snapshot und unveränderter Objektlinkmenge. Redo verwendet exakt +dieselben IDs, dasselbe BMK und denselben Schutzsnapshot. +Die drei Zuordnungsadapter teilen sich +`external-object-assignment.persistence.ts` für Snapshotvergleich, +Kompatibilitätsregeln und link-sichere Updates. +`GET /api/projects/:projectId/circuit-lists/:circuitListId/external-objects` +liefert die verteilungsbezogene Read-Projektion für den späteren Editor-Drawer. +Die CircuitList bestimmt den Verteiler serverseitig; die Antwort enthält nur +dessen externe Objekte, sortiert unzugeordnet vor zugeordnet, sowie kompakte +Quell-, Raum-, Planungs- und Linkangaben. Originalbytes und vollständige +Command-Snapshots werden nicht an diese Oberfläche gegeben. Ohne optionalen +Revit-Import ist die Projektion leer. +`GET` und `PUT /api/projects/:projectId/external-csv/configuration` lesen oder +ändern die Konfiguration; der PUT plant Identität und nächsten +Konfigurationsstand serverseitig und verwendet den typisierten Command. +`POST /api/projects/:projectId/external-csv/preview` nimmt Dateiname und +Base64-kodierte CSV bis 18 MB entgegen. Der zustandsfreie Service liefert Hash, +Dialekt, Header, Klassifikationszahlen, Verdachtszeilen und gemappte +Objektquellwerte. Er schreibt weder Entwurf noch Projektdaten. +`POST /api/projects/:projectId/external-csv/initial-import/plan` verwendet +denselben begrenzten Transport, setzt eine gespeicherte Konfiguration und einen +noch leeren externen Projektzustand voraus und bleibt ebenfalls zustandsfrei. +Die Antwort gruppiert Quellräume, schlägt bei genau einer identischen +Raumnummer den vorhandenen Raum vor, gruppiert exakte Familie-und-Typ-Werte, +liefert regelbasierte Objektplanungswerte und Konfliktzahlen und enthält die +vorhandenen Ebenen, Räume, Verteilungen und ProjectDevices als Auswahlkataloge. +Unbekannte Familien, ungültige Leistungen/Mengen und Objekte ohne Raum bleiben +sichtbare Warnungen; es wird keine Entscheidung automatisch bestätigt. +`POST /api/projects/:projectId/external-csv/initial-import/apply` nimmt Datei, +erwarteten Hash, Konfigurationsversion und Projektrevision erneut entgegen. +Vollständige Entscheidungen ordnen jeden Quellraum optional einem vorhandenen +Raum und einer Standardverteilung sowie jede exakte Familiengruppe optional +einem vorhandenen ProjectDevice zu. Unklassifizierte Familien oder fehlende +Gruppenentscheidungen blockieren. Der Server parst und plant erneut, erzeugt +stabile interne UUIDs und übergibt den vollständigen Zustand an +`external-import.apply-initial`; CSV-Stromkreiswerte bleiben reine Quellwerte +und alle `circuitDeviceRowId` bleiben `null`. +Die Projektseite öffnet über „Revit-CSV“ ein deutsches Modal für Dialekt, +Spaltenzuordnung, zusätzliche Quellfelder und exakte Familie-und-Typ-Regeln. +Nach dem revisionierten Speichern kann eine lokale CSV gewählt und über den +zustandsfreien Endpunkt geprüft werden. Die Oberfläche zeigt Kennzahlen und nur +die ersten 25 erkannten Objekte; die vollständigen Objekte bleiben in der +Response verfügbar, ohne alle Zeilen in den DOM einzufügen. Der anschließende +Erstimport-Wizard gruppiert Quellräume und exakte Familie-und-Typ-Werte. Er +zeigt eindeutige, mehrdeutige und neue Raumtreffer, lässt vorhandene Räume, +Standardverteilungen und ProjectDevices explizit zuordnen und blockiert die +Übernahme bei unklassifizierten Familien. Erst nach einem Bestätigungsdialog +wird der vollständige Import als eine persistente, rückgängig machbare +Projektrevision angewendet. Dabei entstehen keine Stromkreise oder Gerätezeilen. +Fehlende Räume und ProjectDevices können direkt aus der jeweiligen Gruppe über +die regulären Projektformulare angelegt werden. Revit-Werte befüllen diese +Formulare vor, werden aber vor dem Speichern sichtbar vom Nutzer bestätigt. +Die Kataloganlage ist jeweils ein eigener Projekt-Command; der Wizard übernimmt +den neuen Datensatz anschließend in seinen lokalen Auswahlkatalog und markiert +ihn für die betroffene Gruppe. ## Noch nicht unterstützt - Mehrbenutzerbetrieb und Konfliktauflösung +- Editor-Oberfläche für die vorhandene Zuordnungslogik, Folgeimport und + strukturtreuer Revit-Rückexport - vollständige elektrische Dimensionierung - Produktionsdeployment diff --git a/docs/deployment.md b/docs/deployment.md index 89c99a3..0b5baba 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -16,10 +16,10 @@ und macOS keine inotify-Events durchreichen; das kostet dauerhaft CPU, auch ohne Benutzeraktivität. Dieser Stack gehört deshalb nur auf einen Entwicklungsrechner. -Beide Stacks enthalten Anmeldung mit festen Rollen, aber weder TLS, einen -vorgeschalteten Reverse Proxy noch ein zentral betriebenes Datenbanksystem. -Passwörter und Session-Cookies werden bei reinem HTTP unverschlüsselt -übertragen. Der Stack darf deshalb nicht öffentlich erreichbar gemacht werden. +Beide Stacks enthalten weder TLS, Authentifizierung, einen vorgeschalteten +Reverse Proxy noch ein zentral betriebenes Datenbanksystem. Die oben genannten +Container-Schutzmaßnahmen ersetzen diese Funktionen nicht. Der Stack darf +deshalb nicht öffentlich erreichbar gemacht werden. ## Topologie @@ -29,10 +29,9 @@ Passwörter und Session-Cookies werden bei reinem HTTP unverschlüsselt | Express API | 3000 | nicht veröffentlicht (Server) / `127.0.0.1:3000` (Dev) | `GET /health` | `./data:/app/data` | | SQLite | Datei | – | Integritäts-/FK-Prüfung via Backup und Skript | `data/leistungsbilanz.db` | -Die Express-API wird im Server-Stack nicht auf dem Host veröffentlicht -(`expose` statt `ports`). Alle fachlichen API-Routen verlangen eine aktive -Session; Schreibzugriffe zusätzlich den Anwendungsheader -`X-Leistungsbilanz-Request: 1`. Erreichbar ist die API nur aus dem +Die Express-API wird im Server-Stack nicht mehr auf dem Host veröffentlicht +(`expose` statt `ports`). Sie hat keine Authentifizierung; jeder, der sie +erreicht, kann jedes Projekt lesen und ändern. Erreichbar ist sie nur aus dem Compose-Netz, praktisch also über den Next.js-Rewrite. Im Entwicklungs-Stack hängen beide Ports am Loopback und sind nicht aus dem LAN erreichbar. @@ -73,26 +72,6 @@ Verwendete Umgebungsvariablen: JSON-Loggers (`error`, `warn`, `info`, `verbose`, `debug`), Standard `info`. Setzbar über eine `.env`-Datei neben `compose.yaml` oder `LOG_LEVEL=verbose docker compose up`. -- `AUTH_BOOTSTRAP_USERNAME` und `AUTH_BOOTSTRAP_PASSWORT` – erzeugen nur bei - leerer Benutzertabelle den ersten Administrator; das Startpasswort hat - mindestens 12 Zeichen. -- `AUTH_SESSION_HOURS` – Inaktivitätsgrenze einer Session, Standard 12 Stunden. -- `AUTH_SESSION_MAX_DAYS` – absolute Session-Laufzeit, Standard 7 Tage. -- `COOKIE_SECURE` – hinter HTTPS `true`; beim direkten HTTP-Zugriff im LAN - `false`, da Browser das Cookie sonst nicht speichern. - -Vor dem ersten Start müssen mindestens die Bootstrap-Werte in einer lokalen, -nicht versionierten `.env` neben `compose.yaml` gesetzt werden: - -```dotenv -AUTH_BOOTSTRAP_USERNAME=admin -AUTH_BOOTSTRAP_PASSWORT= -``` - -Nach dem ersten erfolgreichen Start werden diese Werte ignoriert, solange -mindestens ein Benutzer existiert. Weitere Zugänge legt ein Administrator in -**Config → Benutzer** an. Details stehen in -[Anmeldung und Benutzerverwaltung](authentication.md). Beim API-Start laufen zuerst die Migrationen und die Schemaprüfung (`scripts/run-migrations.js` und `scripts/db-verify-circuit-schema.js`, im @@ -158,8 +137,7 @@ bleibt `sh` der Vordergrundprozess, und `SIGTERM` erreicht Node nie. Vor einer produktiven Installation werden mindestens benötigt: - TLS-Termination und Reverse Proxy -- zentraler Identitätsanbieter oder eine feinere Rechte-Matrix, falls die zwei - festen Rollen später nicht ausreichen +- Authentifizierung, Autorisierung und Benutzer-/Rollenmodell - definierte Secrets- und Konfigurationsverwaltung - persistenter, gesicherter Datenbankbetrieb - kontrollierter einmaliger Migrationsschritt vor dem API-Rollout diff --git a/docs/estimate-balance.md b/docs/estimate-balance.md deleted file mode 100644 index c68758d..0000000 --- a/docs/estimate-balance.md +++ /dev/null @@ -1,151 +0,0 @@ -# Grobe Leistungsbilanz (LPH 2/3) - -Eigenes Modul für die Leistungsbilanz der Vor- und Entwurfsplanung, gegliedert -nach Kostengruppen (DIN 276, KG 400). Es gibt dort noch keine Verteilungen und -Stromkreise: Jedes Gewerk trägt unter seiner Kostengruppe Verbraucher als -Stückzahl mit Einzelleistung oder als Fläche mit W/m² ein. Aufbau und Rechnung -folgen der bisherigen Excel-Vorlage „Leistungsbilanz – KG400“. Abstimmung: -Issue #7. - -Das Modul ist **nicht** mit der Stromkreisstruktur verknüpft. Es liest die -Gerätezeilen nur für den Vergleich „geschätzt ↔ detailliert“ und schreibt -nichts automatisch in Stromkreislisten, Verteilungen oder Projektgeräte. Eine -ausdrückliche Einzelaktion kann die Werte einer Grobbilanz-Zeile als Vorschlag -in den bestehenden Projektgeräte-Dialog übernehmen; erst dessen Bestätigung -legt über `project-device.insert` ein unplatziertes Projektgerät an. - -## Aufbau - -``` -src/shared/estimate-balance/estimate-balance.ts Datenform, Rechnung, Vergleich (rein, ohne Imports) -src/estimate-balance/domain/estimate-balance-command.model.ts Snapshot-Schema (Zod), Befehle -src/estimate-balance/domain/estimate-balance-project-command.store.ts Store-Port -src/estimate-balance/api/estimate-balance-request.schemas.ts Request-Schemas -src/db/schema/estimate-balances.ts Tabellen (Migration 0010) -src/db/repositories/estimate-balance*.ts Lesen, Schreiben, Befehls-Store -src/server/controllers/estimate-balance.controller.ts API -src/app/projects/[projectId]/grobbilanz/ Übersicht der Stände und Editor -src/frontend/estimate-balance/ Editor-Komponenten und Helfer -``` - -Die gemeinsame Datei unter `src/shared/estimate-balance` hat keine Imports, weil -das Frontend sie direkt nutzt (Turbopack löst die `.js`-Suffixe der API nicht auf). - -## Datenmodell - -| Tabelle | Inhalt | -|---|---| -| `estimate_balances` | ein **Stand** je Projekt (z. B. Vorplanung, Entwurfsplanung): Name, LPH, Datum, Reserve AV/SV in %, Sortierung | -| `estimate_groups` | Kostengruppe (`"410"` … `"480"`, `""` für „Allgemein“), Titel, „bearbeitet von“, Sortierung | -| `estimate_rows` | Versorgung (Auswahl ELT/MSR oder Freitext), Verbraucher/Fläche, Anzahl bzw. Fläche, Einheit (`piece` = St., `area` = m²), Anschluss (fest/Steckdose), Einzelleistung in W bzw. W/m², GLF, cos φ, SV ja/nein, Anmerkung | - -Neue Stände entstehen aus der Vorlage KG 400 (410 Sanitär, 420 Wärme, 430 Luft, -434 Kälte, 440 Starkstrom, 450 Schwachstrom, 460 Förder, 470 Nutzungsspezifisch, -480 GA, Allgemein; Reserve AV 10 %), leer oder als Kopie eines bestehenden -Stands mit neuen IDs. Stände bleiben bearbeitbar; ein zusätzlicher Status oder -eine Bearbeitungssperre ist derzeit nicht vorgesehen. - -## Rechnung - -- Zeile: P = Anzahl bzw. Fläche × Einzelleistung × GLF, S = P / cos φ. -- **AV** enthält alle Verbraucher (Normalversorgung). **SV** listet zusätzlich - die Zeilen mit „SV = ja“, die auch aus der Sicherheitsstromversorgung versorgt - werden müssen. Das ist die Lesart der Vorlage; die Regel liegt in - `calculateEstimateRow` und lässt sich dort zentral ändern. -- Summen je Kostengruppe, Gesamtsumme, Reserve in % (AV und SV getrennt), - Leistung inklusive Reserve und Maximalstrom I = S / (√3 · U) mit der - Drehstromspannung aus den Projekteinstellungen. -- Anzeige wie in der Tabellenkalkulation gerundet (`roundEstimateValue`, - 40,175 → 40,18). Der Test `tests/estimate-balance.test.ts` rechnet das - Beispiel der Vorlage vollständig nach (143,24 kW, 148,48 kVA, mit 10 % - Reserve 157,56 kW / 163,33 kVA, 235,75 A). - -## Vergleich geschätzt ↔ detailliert - -`GET …/comparison` summiert alle Gerätezeilen aller Stromkreislisten des -Projekts (Anzahl × Leistung je Stück × Geräte-GZF, wie der Stromkreisbaum) und -ordnet sie über das Feld **Kostengruppe** der Gerätezeile zu. Maßgeblich ist das -längste passende Präfix: `434` → Gruppe 434, `431` → Gruppe 430, `444` → 440. -Zeilen ohne passende Kostengruppe erscheinen als „nicht zugeordnet“. Der -Verteiler-GZF wird auf keiner Seite angewendet; ein fehlendes cos φ zählt als 1. -Verglichen wird die AV-Leistung (kW) mit Differenz absolut und in %. - -## Übernahme als Projektgerät - -Die Zeilenaktion „Als Projektgerät übernehmen“ ist eine einmalige, ausdrücklich -bestätigte Kopie. Vor dem Öffnen des Dialogs werden ausstehende Änderungen der -Grobbilanz gespeichert. Das Anlegen läuft anschließend mit der aktuellen -Projektrevision über den normalen Projektgeräte-Befehl und ist dadurch wie ein -manuell angelegtes Projektgerät rückgängig machbar. - -- Name und Anzeigename kommen aus dem Zeilennamen; Kostengruppe, GZF, cos φ und - Anmerkung werden vorgeschlagen. `fixed` und `socket` erscheinen als - „Festanschluss“ und „Steckdose“. -- W werden für Stückzeilen in kW umgerechnet. Die Projektgeräte-Anzahl ist 1, - weil das Projektgerät als Vorlage für eine spätere Gerätezeile dient; die - ursprüngliche Stückzahl bleibt im Herkunftshinweis sichtbar. -- Die Kategorie ist mangels Phaseninformation in der Grobbilanz mit - „1-phasig“ vorbelegt und muss im Dialog fachlich geprüft werden. -- Flächenzeilen dürfen übernommen werden. Anzahl und Leistung je Stück bleiben - leer und müssen manuell angegeben werden, da das Projektgerät noch keine - Einheit W/m² kennt (siehe Issue #20). -- SV wird nur im Herkunftshinweis gezeigt. Die tatsächliche Versorgungsart - gehört zur Verteilung. -- Gleichnamige vorhandene Projektgeräte erzeugen eine Warnung, sperren das - Anlegen aber nicht. - -Zwischen Grobbilanz-Zeile und Projektgerät wird keine Verbindung gespeichert. -Es gibt keine Stapelübernahme und keine automatische Platzierung in einer -Verteilung oder einem Stromkreis. Snapshot-, Transfer- und -Grobbilanz-Befehlsformate ändern sich dadurch nicht. - -## Befehle, Undo/Redo - -Alle Änderungen laufen über den bestehenden Projekt-Befehlsmechanismus mit -Revision, Inverse und persistentem Undo/Redo: - -- `estimate-balance.insert` / `estimate-balance.delete` mit dem vollständigen - Stand (Gruppen und Zeilen) -- `estimate-balance.update` mit vollständigem `expected`/`target`-Dokument; der - Store prüft, dass der gespeicherte Stand genau `expected` entspricht, und - ersetzt ihn atomar. Die Inverse ist das vertauschte Paar. - -Der Editor speichert das ganze Dokument verzögert (Autosave); jeder -Speichervorgang ist ein Undo-Schritt. Unveränderte Dokumente erzeugen keine -Revision (`{ unchanged: true }`). - -## Projekttransfer und bewusste Abgrenzung - -- Das reguläre SQLite-Datenbank-Backup sichert die Grobbilanz-Tabellen zusammen - mit allen übrigen Anwendungsdaten. -- Benannte und automatische Projektsnapshots enthalten keine Grobbilanzen; das - Snapshot-Schema bleibt Version 7. Snapshot-Restore und dessen Undo/Redo lassen - vorhandene Grobbilanzen unverändert. -- Der portable Projektexport enthält alle Grobbilanzen ab Transferformat 2. - Ersetzen übernimmt sie atomar und rückgängig machbar; Duplizieren vergibt neue - IDs für Bilanz, Gruppen und Zeilen. Alte Transferdateien in Version 1 bleiben - importierbar und enthalten definitionsgemäß keine Grobbilanzen. -- Keine Rechte je Gewerk; „bearbeitet von“ ist ein Freitext je Kostengruppe. -- Kostengruppen der Gerätezeilen sind nicht normiert; der Vergleich arbeitet - mit Präfixen. -- Der erste Vergleich zeigt die geschätzte und detaillierte AV-Wirkleistung in - kW. SV- und kVA-Vergleiche können später ergänzt werden. -- Eine Stromkreisnummer gehört nicht zur Grobbilanz, weil sie eine frühe - Abschätzung ohne Stromkreisplanung ist. - -## API - -- `GET /api/projects/:projectId/estimate-balances` -- `POST /api/projects/:projectId/estimate-balances` – - `{ "expectedRevision": 7, "name": "Entwurfsplanung", "workStage": "LPH 3", "dateIso": "2026-09-26", "template": "kg400" }` - (`template`: `kg400` | `empty` | `copy` mit `copyFromBalanceId`) -- `GET /api/projects/:projectId/estimate-balances/:balanceId` -- `PUT /api/projects/:projectId/estimate-balances/:balanceId` – - `{ "expectedRevision": 8, "balance": { …vollständiges Dokument… } }` -- `DELETE /api/projects/:projectId/estimate-balances/:balanceId` – `{ "expectedRevision": 9 }` -- `GET /api/projects/:projectId/estimate-balances/:balanceId/comparison` - -Validierung: Name 1–200 Zeichen, getrimmte Texte, Anzahl/Fläche und -Einzelleistung ≥ 0, GLF 0–1, cos φ > 0 bis 1, Reserve 0–100 %, Datum -`YYYY-MM-DD`, eindeutige Gruppen- und Zeilen-IDs, unbekannte Felder werden -abgelehnt. diff --git a/docs/print-view.md b/docs/print-view.md index 04b266d..eba91ed 100644 --- a/docs/print-view.md +++ b/docs/print-view.md @@ -5,9 +5,8 @@ Die Aktionen für Büroangaben und Logo speichern dagegen globale Einstellungen. Projekt- und Verteilerangaben werden in den jeweiligen Bearbeitungsdialogen über Projektbefehle mit Undo/Redo gepflegt. -Beim Laden werden alle Stromkreislisten in einer projektweiten Abfrage gelesen; -deren Projektrevision und ein abschließend erneut gelesener Projektstand werden -verglichen. Ändert sich das Projekt +Beim Laden werden die Projektrevisionen aller Stromkreislisten und ein +abschließend erneut gelesener Projektstand verglichen. Ändert sich das Projekt währenddessen, wird statt eines gemischten Datenstands eine Aufforderung zum Neuladen angezeigt. Eine bereits geladene Seitenansicht aktualisiert sich nicht automatisch bei späteren Änderungen in einem anderen Tab. @@ -32,15 +31,12 @@ automatisch bei späteren Änderungen in einem anderen Tab. erscheinen als orangefarbenes „[ergänzen]“. 2. **Verteilerübersicht (quer)** – Versorgungsstruktur und Tabelle je Verteiler mit Stromkreisanzahl, Pinst (Anzahl × Leistung je - Stück, nur lokale Geräte), Leistung vor Verteiler-GZF einschließlich - gespeister Unterverteilungen, Verteiler-GZF, Pgl einschließlich - Unterverteilungen und IB. Die Hierarchie folgt den logischen IDs. + Stück), PGeräte (mit Geräte-GZF), Verteiler-GZF, + Pgl, IB und „Σ inkl. unterlagert“. 3. **Verteilerpläne (quer, je Verteiler)** – Titelleiste mit Verteilernummer, Bezeichnung, Örtlichkeit, Netzart, „Gespeist von“ und Pgl; darunter Kopfkomponenten, Gruppen, Stromkreise - (reine 1:1-Einspeiseabgänge kompakt in einer Zeile; sonst mehrzeilig mit - Sammelzeile, eingerückten Gerätezeilen und schreibgeschützten - Unterverteilungszeilen), + (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. @@ -50,25 +46,19 @@ Seitenformat, Ränder und „Seite x von y“ kommen beim Drucken aus benannten einfügt. Die Bildschirmansicht zeigt Blätter in Papiergröße; die exakte Seitenaufteilung langer Verteilerpläne entsteht erst beim Drucken. -## Berechnung und offene Punkte +## Vorläufige Punkte -- **Einspeisung / Hierarchie:** `feedingDistributionBoardId` bestimmt die - Hierarchie. Ist zusätzlich `feedingCircuitId` gesetzt, fließt die Leistung - der Unterverteilung nach deren eigenem Verteiler-GZF als virtuelle Last in - genau diesen Abgang ein. Ketten werden rekursiv berechnet; mehrere - Unterverteilungen an einem Abgang sind erlaubt. Ohne Abgang bleibt es bei der - Hierarchie ohne Leistungsaufschlag. `fedFrom` bezeichnet nur externe Quellen - oder ergänzende Hinweise. -- **Keine Doppelzählung:** Die Abgangs- und Verteilersummen enthalten die - Unterverteilungsleistung bereits. Deshalb gibt es keine zusätzliche Spalte - „Σ inkl. unterlagert“. Die Summenzeile verwendet für hierarchische Leistungen - nur Wurzelverteilungen; Pinst summiert weiterhin die lokalen Geräte. -- **IB:** S entsteht aus Σ(P / cos φ) für Geräte und den wirksamen - cos φ der Unterverteilungen, jeweils mit dem fachlich zugehörigen GZF. Bei - einem 1-phasigen speisenden Abgang gilt I = S / U1~, sonst - I = S / (√3 · U3~). Für externe oder nur bis zur Verteilung - bekannte Einspeisungen bleibt die bisherige Darstellung als symmetrischer - Drehstromwert bestehen. +- **Einspeisung / Hierarchie:** `fedFrom` ist Freitext. Die Übersicht ordnet + einen Verteiler nur dann unter, wenn der Text eindeutig der Nummer oder + Bezeichnung eines anderen Verteilers entspricht (ohne Beachtung von + Groß-/Kleinschreibung und äußeren Leerzeichen). Mehrdeutige Treffer bleiben + ohne Zuordnung; „Σ inkl. unterlagert“ ist + eine einfache Summe ohne übergeordneten GZF. Die fachliche Verknüpfung + (Verteiler und/oder speisender Stromkreis) und die Summierungslogik sind + offen. +- **IB** ist ein symmetrischer Drehstromwert + S / (√3 · U3~) 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 @@ -128,12 +118,10 @@ ihren Wert. ## Bestehende Datenbanken -Vor dem Anwenden der additiven Migrationen einschließlich `0012` eine verifizierte +Vor dem Anwenden der additiven Migrationen `0007` und `0008` eine verifizierte Datenbanksicherung mit `npm run db:backup` erstellen. Die neuen Projekt- und Verteilerfelder bleiben bei bestehenden Datensätzen zunächst leer (`null`). -Snapshot-Schema 10 enthält den aktuellen Projektzustand; die in Schema 9 -eingeführten Einspeisungsverweise werden in den unterstützten Versionen 1–8 -mit leeren Verweisen hochgestuft. Restore und -Projektkopie erhalten beziehungsweise remappen die neuen Angaben. Globale -Büroangaben und Logo gehören zur Datenbanksicherung, nicht +Snapshot-Schema 6 enthält beide Feldgruppen; die unterstützten Versionen 1–5 +werden beim Lesen hochgestuft. Restore und Projektkopie erhalten die neuen +Angaben. Globale Büroangaben und Logo gehören zur Datenbanksicherung, nicht zum logischen Projektsnapshot oder Projekttransfer. diff --git a/docs/project-history-and-external-model-architecture.md b/docs/project-history-and-external-model-architecture.md index 3629c23..a7c1300 100644 --- a/docs/project-history-and-external-model-architecture.md +++ b/docs/project-history-and-external-model-architecture.md @@ -9,8 +9,7 @@ This document records architectural direction for future work. It is not a final - persist undo/redo across page reloads and application restarts - provide a project-wide version history with named restore points - preserve an auditable sequence of user, import, migration and restore operations -- support the Revit/Linear-XLSX round-trip using stable, exact - Worksharing-ID-based external identity +- support future Revit/CSV round-trips using stable IFCGUID-based links - keep the persistence boundary replaceable so PostgreSQL can be adopted later ## Separate Concerns @@ -112,12 +111,7 @@ Implemented automatic-snapshot policy: - automatic capture and retention run inside the same transaction as the triggering project revision -## Revit / Linear Excel Round-Trip Direction - -Phase 14 is active and follows the -[Linear-Excel requirements](spec/revit-excel-integration-requirements.md) and -[R0–R10 plan](spec/revit-excel-phase-14-plan.md). The CSV/IFCGUID runtime has -been removed; the implemented runtime uses Linear XLSX and exact Worksharing-ID. +## Revit / CSV / IFCGUID Round-Trip Direction External model exchange should use explicit staging and link entities instead of writing imported rows directly into circuits. @@ -126,12 +120,9 @@ Conceptual entities: - `ExternalModelSource` - identifies a Revit/IFC model or another external source within a project - `ExternalImportBatch` - - file name, checksum, import time, object count and processing status - - only the latest batch keeps original workbook bytes, matrix and the - configuration copy; older batches keep date, filename, checksum and count + - file name, checksum, import time, format/version and processing status - `ExternalModelObject` - - exact case-sensitive Worksharing-ID as external identity - - optional IfcGUID as non-unique source redundancy + - stable IFCGUID and optional Revit element identifiers - source attributes and last-seen import batch - `ExternalObjectLink` - explicit relationship to a project device, circuit device row or another future domain entity @@ -142,33 +133,13 @@ Conceptual entities: Required behavior: -- Worksharing-ID uniqueness is scoped to the external source and uses exact, - case-sensitive comparison. IfcGUID is not a matching key. +- IFCGUID uniqueness is scoped to project and external model source. - Parsing writes to staging first. - Users preview additions, changes, missing objects and conflicts before applying them. - Applying an import creates one project revision and one auditable change set. - Imported source values and locally assigned planning values remain distinguishable. -- Export retains Worksharing-ID so Linear can match rows deterministically. -- Missing objects and duplicate/conflicting Worksharing-IDs are reported, - never silently reassigned. - -R10 verifies the complete implemented path through initial import, planning, -row assignment, return workbook, follow-up import, snapshot restore, portable -duplicate and restart-safe Undo/Redo. Large state replacement uses bounded -SQLite insert batches so imports, restores and duplicates do not exceed the -driver's SQL-variable limit. - -The project configuration has no separate revision counter. Stateless plans -and apply requests bind to `expectedRevision`; every applied import batch holds -its configuration copy. Apply reparses the retransmitted workbook. Undo and -Redo operate only on persisted complete before/after states and never parse an -Excel file. - -Deleting a linked row, circuit or group detaches affected Revit objects in the -same typed command after an explicit warning; its inverse restores all links. -Only deleting referenced rooms and distribution boards is blocked. Linked -objects always derive their board from their row, while a room default-board -change affects only unassigned objects. +- Export retains IFCGUID and source identifiers so Revit parameters can be matched deterministically. +- Missing objects and duplicate/conflicting identifiers are reported, never silently reassigned. ## SQLite and PostgreSQL Direction @@ -317,8 +288,7 @@ Remaining constraints before completing project version history: boundary; extend it whenever further project mutations are introduced - project creation remains initialization at revision zero, while global device templates remain outside any single project history -- do not model Worksharing-ID or IfcGUID as an overloaded circuit equipment - identifier or an internal relation id +- do not model IFCGUID as an overloaded circuit equipment identifier - keep database backup/restore checks separate from project history tests ## Deferred Decisions @@ -326,6 +296,5 @@ Remaining constraints before completing project version history: - whether large snapshot payloads remain in PostgreSQL or move to object storage - branch visualization after undo followed by new edits - user/role model and actor attribution -- Linear-XLSX compatibility beyond the observed sample and any future - project-independent mapping profiles +- supported Revit CSV dialects and parameter mapping UI - PostgreSQL deployment topology and migration date diff --git a/docs/revit-requirements-llm-context.md b/docs/revit-requirements-llm-context.md index b9f84b2..314820b 100644 --- a/docs/revit-requirements-llm-context.md +++ b/docs/revit-requirements-llm-context.md @@ -1,17 +1,269 @@ -# LLM-Kontext für die Revit-Integration +# Kontext für die Revit-Anforderungsplanung -Die frühere Revit-/CSV-Anforderungsplanung ist abgelöst und Phase 14 ist mit -R10 abgeschlossen. Für Arbeiten an der Linear-XLSX-Anbindung sind vollständig -zu lesen: +## Zweck dieser Datei -- [Revit-Integration über Linear-Excel](spec/revit-excel-integration-requirements.md) -- [R0–R10-Plan](spec/revit-excel-phase-14-plan.md) -- [R0-Bestandsaudit](spec/revit-excel-r0-audit.md) -- [R10-Abnahme](spec/revit-excel-r10-validation.md) -- [Aktuelle Systemarchitektur](current-architecture.md) -- [Projekt-History und externer Modellzustand](project-history-and-external-model-architecture.md) +Diese Datei ist eine kompakte Übergabe an ein anderes LLM. Sie soll dabei +helfen, gemeinsam mit dem Anwender die fachlichen und technischen Anforderungen +für einen zukünftigen Revit-Datenaustausch zu klären. -Bei Widersprüchen gilt das Anforderungsdokument. CSV, IfcGUID als Schlüssel, -Dynamo, Revit-API und JSON-Transport sind keine Zielpfade. Der CSV-Laufzeitpfad -ist entfernt; alte CSV-Snapshots und CSV-History werden mit einer deutschen -Migrationsmeldung abgelehnt. +Die Revit-Schnittstelle ist **noch nicht implementiert**. Das LLM soll zunächst +den tatsächlichen Arbeitsablauf erfragen, Unklarheiten sichtbar machen und +daraus eine neue, überprüfbare Arbeitsanweisung erstellen. Es soll weder ein +Dateiformat noch ein Datenbankschema oder eine UI ungefragt festlegen. + +## Produkt und fachliches Modell + +Leistungsbilanz ist eine Webanwendung für die elektrische Ausführungsplanung. +Ihr Kern ist ein tabellenähnlicher Stromkreislisten-Editor für Verteilungen. + +Das unterstützte Laufzeitmodell ist: + +```text +Project +├── Floor +│ └── Room +├── ProjectDevice +└── DistributionBoard + └── CircuitList + └── CircuitSection + └── Circuit + └── CircuitDeviceRow +``` + +Wichtige fachliche Grenzen: + +- Ein `Circuit` ist nicht dasselbe wie eine Gerätezeile. +- Ein Stromkreis kann null, eine oder mehrere `CircuitDeviceRow` enthalten. +- BMK (`equipmentIdentifier`), Schutz- und Kabeldaten gehören zum Stromkreis. +- Menge, Einzelleistung, Gleichzeitigkeitsfaktor, cosPhi, Raum, Kostengruppe + und Kategorie gehören zur Gerätezeile. +- Ein `ProjectDevice` ist eine wiederverwendbare, projektbezogene Vorlage. +- Eine Gerätezeile kann mit einem Projektgerät verknüpft sein, behält aber + lokale Werte und ausdrücklich erfasste Abweichungen. +- Änderungen eines Projektgeräts überschreiben verknüpfte Zeilen niemals + automatisch. Eine Synchronisierung benötigt Vorschau und Benutzerauswahl. +- Manuelle, nicht mit einem Projektgerät verknüpfte Gerätezeilen sind regulär + erlaubt. +- Bestehende BMKs und stabile UUIDs dürfen nicht automatisch verändert werden. +- Neunummerierung ist immer eine ausdrückliche Benutzeraktion. +- `IFCGUID` darf nicht als BMK oder als Ersatz für eine interne UUID verwendet + werden. + +Für einen späteren Revit-Austausch besonders relevante Daten sind: + +- Projekt: Name, interne/externe Projektnummer, Bauherr, Beschreibung, + Kennzeichnung als öffentliches Gebäude und Projektspannungen. +- Geschoss und Raum: interne UUID, Name beziehungsweise Raumnummer und + Raumname. +- Verteilung: interne UUID, Name, Etage, Netzart und Gleichzeitigkeitsfaktor. +- Stromkreis: interne UUID, BMK, Anzeigename, Bereich, Schutz-, Kabel-, + Spannungs-, Steuerungs-, Status- und Bemerkungsdaten. +- Gerätezeile: interne UUID, optionale Projektgeräteverknüpfung, Name, + Anzeigename, Phasenart, Anschlussart, Kostengruppe, Kategorie, Geschoss, + Raum, Menge, Einzelleistung, Gleichzeitigkeitsfaktor, cosPhi und Bemerkung. +- Projektgerät: interne UUID sowie die wiederverwendbaren Gerätewerte. + +Die Phasenart ist fachlich `1-phasig` oder `3-phasig`. Die Spannung wird daraus +und aus den Projekteinstellungen abgeleitet; freie Sonderspannungen sind im +aktuellen Produkt nicht vorgesehen. + +## Aktuelle technische Architektur + +- Frontend: Next.js App Router, React und TypeScript unter `src/app` und + `src/frontend`. +- API: Express und Zod unter `src/server`. +- Fachregeln und typisierte Commands: `src/domain`. +- Persistenz: SQLite, Drizzle und Repository-Adapter unter `src/db`. +- Laufzeitkomposition konkreter Repositories: + `src/server/composition`. +- Lokaler Betrieb: Browser/Next.js auf Port 3001, Express-API auf Port 3000, + SQLite-Datei unter `data/leistungsbilanz.db`. +- Docker Compose wird für die lokale Entwicklung unterstützt. +- PostgreSQL und Mehrbenutzerbetrieb sind noch nicht umgesetzt. + +Der zentrale Editor liegt unter: + +```text +src/app/projects/[projectId]/circuit-lists/[circuitListId]/tree-edit/page.tsx +src/frontend/components/circuit-tree-editor.tsx +``` + +Frontend-Aktionen werden als validierte API-Commands ausgeführt. Fachregeln +liegen in Domain-Services; konkrete SQLite-Zugriffe bleiben in +Persistenzadaptern. Neue Revit-Fachlogik darf deshalb nicht direkt von +`better-sqlite3`, React-Komponenten oder globalen Datenbankinstanzen abhängen. + +## Revisionen, Undo/Redo und Sicherungspunkte + +Alle normalen projektbezogenen Änderungen laufen über eine gemeinsame +Command- und Transaktionsgrenze: + +```text +Fachänderung + inverses Kommando + Revision + Undo/Redo-Übergang +``` + +Diese Bestandteile werden atomar geschrieben oder vollständig zurückgerollt. +Jedes Projekt besitzt eine monoton steigende `currentRevision`. Schreibbefehle +geben die erwartete Revision mit, damit veraltete Clients keine neueren +Änderungen überschreiben. + +Undo/Redo ist projektweit persistent und funktioniert nach Reload oder +Anwendungsneustart. Zusätzlich gibt es: + +- eine unveränderliche Revisions-Timeline; +- benannte und automatische logische Projektsnapshots; +- wiederherstellbare Snapshots mit Prüfsumme; +- einen portablen, versionierten JSON-Projekttransfer. + +Ein angewendeter Revit-Import muss später dieselbe Integritätsgrenze verwenden: +Die bestätigten Änderungen sollen als ein nachvollziehbarer Projekt-Command +beziehungsweise als ein fachlich definierter Änderungssatz atomar, +revisioniert und rückgängig machbar sein. + +## Klare Abgrenzung zum vorhandenen JSON-Projekttransfer + +Der vorhandene JSON-Export/-Import überträgt den vollständigen internen +Projektzustand. Er dient Sicherung, Wiederherstellung und Duplizierung eines +Projekts innerhalb von Leistungsbilanz. + +Dieser Projekttransfer ist **kein** Revit-Austauschformat. Er enthält interne +Strukturen und UUIDs und soll nicht ohne bewusste Entscheidung als Grundlage +für CSV-Dateien oder Revit-Parameter verwendet werden. + +Der zukünftige Revit-Workflow soll dagegen externe Modellobjekte anhand stabiler +externer Identitäten wiedererkennen, ausgewählte Planungswerte zuordnen und +Ergebnisse so exportieren, dass Revit sie wieder den richtigen Objekten +zuweisen kann. + +## Bereits vereinbarte Leitplanken für den externen Modellaustausch + +Diese Punkte gelten als Architekturvorgaben, noch nicht als fertiges +Implementierungsdesign: + +- Ein Import schreibt niemals ungeprüft direkt in Stromkreise oder + Gerätezeilen. +- Eingelesene Daten landen zuerst in einem Staging-/Vorschaubereich. +- Vor der Übernahme werden neue, geänderte, fehlende, doppelte und + widersprüchliche Objekte angezeigt. +- Wiederholte Importe müssen Objekte deterministisch anhand der externen Quelle + und einer stabilen Identität, voraussichtlich IFCGUID, erkennen. +- Die Eindeutigkeit einer IFCGUID ist mindestens auf Projekt und externe + Modellquelle begrenzt; die genaue Quellendefinition ist noch zu klären. +- Importierte Quellwerte und lokal in Leistungsbilanz geplante Werte müssen + unterscheidbar bleiben. +- Lokale Planungswerte dürfen niemals still überschrieben werden. +- Verknüpfungen zwischen externen Objekten und internen Fachobjekten müssen + ausdrücklich modelliert werden. +- Fehlende oder widersprüchliche Identitäten werden gemeldet und niemals + automatisch einem anderen Objekt zugeordnet. +- Ein Export bewahrt IFCGUID und erforderliche Quellidentitäten, damit Revit + die Werte deterministisch zurückschreiben kann. +- Ein Export bezieht sich auf eine bekannte Projektrevision. +- Große Datenmengen allein erzwingen noch keinen Wechsel von SQLite zu + PostgreSQL. PostgreSQL wird relevant bei Mehrbenutzerbetrieb, zentralem + Serverbetrieb oder unabhängigen Hintergrundjobs. + +Als mögliche, aber noch nicht beschlossene Konzepte wurden bisher genannt: + +- `ExternalModelSource` +- `ExternalImportBatch` +- `ExternalModelObject` +- `ExternalObjectLink` +- `ExternalParameterMapping` +- `ExternalExportBatch` + +Diese Namen beschreiben Verantwortlichkeiten. Das andere LLM darf sie +hinterfragen und verbessern, soll sie aber nicht als bereits vorhandene +Tabellen behandeln. + +## Auftrag an das andere LLM + +Erarbeite die Anforderungen dialogorientiert mit dem Anwender. Beginne mit dem +realen Ablauf in Revit und kläre danach schrittweise mindestens: + +1. Welche Revit-Objekte beziehungsweise Kategorien werden exportiert? +2. Wie entsteht die Ausgangsdatei in Revit und wie sieht sie technisch aus + (CSV-Dialekt, Trennzeichen, Encoding, Dezimalformat, Kopfzeilen, + Revit-Versionen)? +3. Welche Identitäten stehen zur Verfügung: IFCGUID, Revit `ElementId`, + Typ-ID, Modell-/Dateikennung oder weitere Schlüssel? +4. Wie werden Hauptmodell, Teilmodelle, verknüpfte Modelle, Modellkopien und + aktualisierte Revit-Dateien unterschieden? +5. Welche Parameter kommen aus Revit und welche Werte werden ausschließlich in + Leistungsbilanz geplant? +6. Welche internen Ziele können externe Objekte erhalten: Projektgerät, + Gerätezeile, Stromkreis, Raum, Verteilung oder weitere Entitäten? +7. Werden externe Objekte einzeln oder gesammelt einem Stromkreis, + Projektgerät, Raum oder einer Verteilung zugeordnet? +8. Welche Werte sollen nach Revit zurückgeschrieben werden, in welchen + Einheiten und unter welchen Revit-Parameternamen? +9. Muss die ursprüngliche Datei einschließlich unbekannter Spalten, + Zeilenreihenfolge und Formatierung erhalten werden, oder darf eine neue + Rückgabedatei erzeugt werden? +10. Wie sollen Spalten-/Parametermappings erstellt, gespeichert, + wiederverwendet und zwischen Projekten geteilt werden? +11. Was gilt bei erneutem Import für neue, geänderte, gelöschte, verschobene, + doppelte oder nicht mehr sichtbare Revit-Objekte? +12. Wer gewinnt bei Konflikten zwischen neuem Revit-Wert und lokaler Änderung? + Welche Konflikte dürfen automatisch gelöst werden und welche benötigen + eine Auswahl? +13. Welche Vorschau, Filter, Sammelaktionen und Bestätigungen benötigt der + Anwender vor der Übernahme? +14. Welche fachlichen Validierungen und Pflichtfelder müssen eine Übernahme + verhindern oder nur eine Warnung erzeugen? +15. Welche Dateigrößen, Objektzahlen und Laufzeiten sind realistisch? +16. Müssen Import und Export synchron im Browser laufen oder werden später + Hintergrundjobs benötigt? +17. Welche Informationen müssen für Nachvollziehbarkeit, Undo/Redo, + Versionshistorie und Support gespeichert werden? +18. Welche konkreten End-to-End-Beispiele und Fehlerfälle dienen als + Abnahmekriterien? + +Stelle Rückfragen in kleinen, zusammenhängenden Blöcken. Unterscheide in deinen +Notizen ausdrücklich: + +- vom Anwender bestätigte Anforderungen; +- sinnvolle Vorschläge; +- offene Entscheidungen; +- technische Folgerungen; +- bewusst nicht betrachtete spätere Ausbaustufen. + +## Erwartetes Ergebnis der Anforderungsrunde + +Erstelle am Ende eine neue Arbeitsanweisung für das implementierende LLM. Sie +soll mindestens enthalten: + +- Ziel, Umfang und ausdrücklich ausgeschlossene Funktionen; +- vollständigen Anwenderworkflow für Erstimport, Zuordnung, Folgeimport und + Rückexport; +- vereinbartes Dateiformat mit einem anonymisierten Beispiel; +- Feld- und Einheitenmapping einschließlich Richtung und Datenhoheit; +- Identitäts-, Matching- und Quellmodell; +- Regeln für neue, geänderte, fehlende und doppelte Objekte; +- Konflikt-, Validierungs- und Freigaberegeln; +- UI-Ablauf für Staging, Vorschau, Zuordnung und Bestätigung; +- Anforderungen an Revision, Atomarität, Undo/Redo und Audit; +- vorgeschlagene Modul- und Persistenzgrenzen, ohne bestehende + Architekturregeln zu umgehen; +- schrittweise Implementierungsphasen mit überprüfbaren Abnahmekriterien; +- offene Punkte, die vor dem jeweiligen Implementierungsschritt geklärt werden + müssen. + +Die Arbeitsanweisung soll noch keinen Code enthalten. Sie muss klar markieren, +welche Entscheidungen der Anwender tatsächlich getroffen hat und welche Teile +nur Architekturvorschläge des LLM sind. + +## Weiterführende Projektdokumente + +- `AGENTS.md` – verbindliche Domänen- und Implementierungsregeln +- `docs/current-architecture.md` – vollständiger aktueller Laufzeit- und + Command-Pfad +- `docs/project-history-and-external-model-architecture.md` – bisherige + Zukunftsrichtung für Versionierung, externes Modell und PostgreSQL +- `docs/spec/01-domain-context.md` – fachlicher Kontext +- `docs/spec/03-data-model-concept.md` – Datenmodellkonzept +- `docs/spec/05-linked-devices-and-sync.md` – Regeln für Projektgeräte und + kontrollierte Synchronisierung +- `docs/spec/07-implementation-phases-todo.md` – Roadmap, insbesondere Phase 14 +- `docs/circuit-list-editor-known-limitations.md` – noch nicht implementierte + Funktionen diff --git a/docs/spec/07-implementation-phases-todo.md b/docs/spec/07-implementation-phases-todo.md index 5968766..b665e85 100644 --- a/docs/spec/07-implementation-phases-todo.md +++ b/docs/spec/07-implementation-phases-todo.md @@ -532,37 +532,32 @@ Acceptance criteria: ## Phase 14: External Model Round-Trip -Status: abgeschlossen am 30.09.2026 mit R10. Siehe -[R10-Abnahme](revit-excel-r10-validation.md). +Status: Phase 14.2 (persistente externe Objekte und bestätigter Erstimport) ist +implementiert. Editor-Zuordnung, Rückexport und Folgeimport folgen. Siehe +[Phase-14-Audit und Implementierungsplan](revit-csv-phase-14-audit-and-plan.md) +und die verbindlichen +[Revit-CSV-Anforderungen](revit-csv-integration-requirements.md). -Status: R0 ist mit Korrekturen freigegeben; R1 stellt die Dokumentation auf -Linear-XLSX und Worksharing-ID um. Die frühere CSV-Planung 14.0–14.6 ist -abgelöst und wird nicht fortgeschrieben. +Goal: -Verbindliche Quellen: +Exchange model objects and planning parameters with Revit or comparable tools through CSV or another agreed format. -- [Revit-Integration über Linear-Excel](revit-excel-integration-requirements.md) -- [R0–R10-Plan](revit-excel-phase-14-plan.md) -- [R0-Bestandsaudit](revit-excel-r0-audit.md) +Tasks: -Die Umsetzung erfolgt ausschließlich in den Paketen R0–R10. R2 endet mit -einer aus der realen Musterdatei erzeugten Rückgabedatei. Der Nutzer muss sie -erfolgreich in Linear importieren, bevor R3 beginnt. Bei einem Fehlschlag wird -zuvor eine direkte OOXML-Änderung des Originalworkbooks als Alternative -vorgelegt. +- model external sources, import batches and stable IFCGUID objects +- stage and validate imports before applying them +- show additions, changes, missing objects and conflicts +- link external objects explicitly to project-domain entities +- apply an import as one auditable project revision +- configure inbound and outbound parameter mappings +- export against a known project revision while preserving IFCGUID -Kernabnahme der Phase: +Acceptance criteria: -- Worksharing-ID ist der exakte, case-sensitive externe Schlüssel; -- XLSX-Kopfkommentare, Struktur, Formate und unbekannte Spalten bleiben beim - Rückexport erhalten; -- Import erzeugt keine Rows und überschreibt keine lokale Planung still; -- Zuordnung, Löschung, Folgeimport und Undo/Redo sind atomar und nach Neustart - reproduzierbar; -- Undo/Redo liest keine Excel-Datei; -- nur der letzte Importbatch enthält Workbook und Matrix vollständig; -- mehrere Tausend Objekte bleiben über eine clientseitig gefilterte, - virtualisierte Liste bedienbar. +- repeated imports match objects deterministically by source and IFCGUID +- imports never silently overwrite local planning values +- users approve the diff before it changes the project +- exported data can be assigned back to the correct Revit objects PostgreSQL should be introduced when shared multi-user operation, background jobs or operational scale justify it. External-object count alone does not require an immediate migration. diff --git a/docs/spec/08-current-product-backlog.md b/docs/spec/08-current-product-backlog.md index dda8fbb..c90dd24 100644 --- a/docs/spec/08-current-product-backlog.md +++ b/docs/spec/08-current-product-backlog.md @@ -46,10 +46,7 @@ requirements and intended sequencing, not proof of implementation. - [x] Phase E: editor projection and editing. - [x] Phase F: documentation and full GUI verification. - [ ] Keep full electrical sizing and cable-dimensioning rules separate until - the planner supplies the calculation requirements. The optional per-circuit - cable sizing module (`docs/cable-sizing-module.md`) exists; its supported - tables were confirmed against DIN VDE 0298-4:2023-06 with - Berichtigung 1:2023-10. Unsupported arrangements stay explicitly blocked. + the planner supplies the calculation requirements. - Detailed specification: `docs/spec/09-distribution-board-components-and-protection-groups.md` @@ -135,26 +132,6 @@ The pre-release cleanup established the following compatibility boundary: - [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. -## 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. -- [x] Logical distribution-board feed link with an optional feeding circuit, - recursive load rollup and deletion guards (#3). - -Open follow-ups (Gitea issues): bill of quantities export (#5), area-based loads in W/m² for -ProjectDevices and device rows (#20). - ## Recommended Sequence 1. [x] Distribution-board floor and supply fields. @@ -162,7 +139,6 @@ ProjectDevices and device rows (#20). 3. [x] Snapshot-to-revision descriptions and history presentation. 4. [x] Distribution-board power summary and project column layout. -The Revit/Linear-XLSX round-trip was completed separately in Phase 14. It uses -exact Worksharing-ID identity and must not be inferred from these unrelated -backlog tasks. See -[the R0–R10 plan](revit-excel-phase-14-plan.md). +The Revit/CSV/IFCGUID round-trip follows the distribution-board component +foundation as a separate jointly planned phase and must not be inferred from +these tasks. diff --git a/docs/spec/revit-csv-integration-requirements.md b/docs/spec/revit-csv-integration-requirements.md index 7889566..973c1a6 100644 --- a/docs/spec/revit-csv-integration-requirements.md +++ b/docs/spec/revit-csv-integration-requirements.md @@ -1,8 +1,1373 @@ -# Abgelöst: Revit-CSV-Anforderungen +# Revit-CSV-Integration – Anforderungen und Implementierungsanweisung -Diese CSV-/IfcGUID-Spezifikation ist seit 29.09.2026 abgelöst. Die verbindliche -Quelle ist [Revit-Integration über Linear-Excel](revit-excel-integration-requirements.md). +## 1. Status und Verbindlichkeit -Der historische Inhalt bleibt im Git-Verlauf bis einschließlich Commit -`ae318a5` erhalten. Er darf nicht mehr als Implementierungsanweisung oder -Statusquelle verwendet werden. +Dieses Dokument ist die verbindliche fachliche und technische Arbeitsgrundlage für **Phase 14: External Model Round-Trip**. + +Es unterscheidet ausdrücklich zwischen: + +- **Bestätigte Anforderung:** vom Anwender festgelegtes Verhalten. +- **Bestehende Architekturvorgabe:** bereits geltende Regel des Projekts. +- **Implementierungsvorschlag:** empfohlene technische Aufteilung, noch kein unveränderliches Datenbankschema. +- **Offene Entscheidung:** darf erst in der jeweils genannten Phase konkretisiert werden. + +Codex darf aus diesem Dokument kein vollständiges Event-Sourcing, keine PostgreSQL-Migration, keine automatische Stromkreisplanung und keine direkte Dynamo-Anbindung ableiten. + +Vor Implementierungsbeginn sind insbesondere zu lesen: + +- `AGENTS.md` +- `docs/current-architecture.md` +- `docs/spec/03-data-model-concept.md` +- `docs/spec/05-linked-devices-and-sync.md` +- `docs/project-history-and-external-model-architecture.md` +- `docs/spec/07-implementation-phases-todo.md` +- `docs/circuit-list-editor-known-limitations.md` + +## 2. Ziel + +Die Anwendung soll Revit-Objekte der Kategorie **Elektroinstallation** über eine CSV-Datei einlesen, dauerhaft anhand ihrer `IfcGUID` erkennen und mit der manuellen Elektroplanung in Leistungsbilanz verbinden. + +Der Workflow soll insbesondere vermeiden, dass Stromkreiskennzeichnungen und Leistungen für jedes Revit-Objekt händisch nachgetragen werden müssen. + +Der Nutzer soll: + +1. Revit-Objekte importieren, +2. Räume aus dem Import anlegen oder vorhandenen Räumen zuordnen, +3. Räume und einzelne Objekte Verteilungen zuordnen, +4. Objekte klassifizieren und optional mit `ProjectDevice`-Vorlagen verknüpfen, +5. noch nicht verschaltete Objekte im Stromkreislisteneditor manuell Stromkreisen und Gerätezeilen zuweisen, +6. Stromkreiskennzeichnung und Leistung in eine strukturgleiche Rückgabe-CSV schreiben, +7. denselben vollständigen Modellstand später erneut importieren und Änderungen kontrolliert abgleichen. + +## 3. Grundlegende Produktgrenzen + +### 3.1 Revit bleibt optional + +**Bestätigte Anforderung** + +Leistungsbilanz muss vollständig ohne Revit-Integration nutzbar bleiben. + +- Projekte, Ebenen, Räume, Verteilungen, Projektgeräte, Stromkreise und Gerätezeilen bleiben manuell anlegbar. +- Ein Projekt darf ausschließlich manuelle Daten, ausschließlich verknüpfte Revit-Daten oder eine Mischung enthalten. +- Revit ist nur für die Existenz und die Quellattribute der tatsächlich verknüpften Modellobjekte führend. +- Revit ist nicht die alleinige Quelle des gesamten Leistungsbilanzprojekts. + +### 3.2 Circuit-First-Modell bleibt unverändert + +**Bestehende Architekturvorgabe** + +```text +Project +├── Floor +│ └── Room +├── ProjectDevice +└── DistributionBoard + └── CircuitList + └── CircuitSection + └── Circuit + └── CircuitDeviceRow +``` + +- Ein `Circuit` ist nicht dasselbe wie eine `CircuitDeviceRow`. +- BMK, Schutz- und Kabeldaten gehören zum Stromkreis. +- Menge, Leistung, Gleichzeitigkeitsfaktor, cosPhi, Raum, Kostengruppe und Kategorie gehören zur Gerätezeile. +- Ein importiertes Revit-Objekt darf vor seiner Stromkreiszuordnung eigenständig existieren. +- Der Import legt nicht automatisch Stromkreise oder Gerätezeilen an. + +### 3.3 Stable IDs und BMK + +**Bestehende Architekturvorgabe** + +- `IfcGUID` ersetzt niemals eine interne UUID. +- `IfcGUID` wird niemals als Stromkreis-BMK verwendet. +- Bestehende interne UUIDs und BMKs dürfen nicht automatisch geändert werden. +- Neunummerierung bleibt eine ausdrückliche Benutzeraktion. +- Import, Sortierung, Verschieben und Folgeabgleich führen nicht automatisch zu einer Neunummerierung. + +## 4. Umfang der ersten Ausbaustufe + +### 4.1 Enthalten + +**Bestätigte Anforderungen** + +- projektweite CSV- und Mappingkonfiguration; +- Import vollständiger CSV-Dateien; +- Import von Revit-Objekten der Kategorie `Elektroinstallation`; +- deterministische Identifikation über `IfcGUID`; +- Import beziehungsweise Verknüpfung von Räumen; +- manuelle Verknüpfung von Räumen mit Ebenen; +- manuelle Anlage der Verteilungen; +- Standardverteilung je Raum und abweichende Verteilung je Objekt; +- exakte Klassifizierung über den CSV-Wert `Familie und Typ`; +- konfigurierbare Behandlung von Einzel- und Mehrfachsteckdosen; +- optionale Verknüpfung importierter Objekte mit vorhandenen `ProjectDevice`-Vorlagen; +- Erstellen neuer `ProjectDevice`-Vorlagen aus ausgewählten Importobjekten; +- lokale Planungswerte und Abweichungen bereits vor der Stromkreiszuordnung; +- projektweites Import-, Staging- und Abgleichs-UI; +- Bereich für unzugeordnete externe Objekte im Stromkreislisteneditor; +- manuelle Zuordnung zu bestehenden Gerätezeilen, bestehenden Stromkreisen oder neuen Stromkreisen; +- Rückexport von vollständiger Stromkreiskennzeichnung und elektrischer Leistung; +- Erhaltung der ursprünglichen CSV-Struktur; +- kontrollierter Folgeimport mit Einzel- und Sammelentscheidungen; +- atomare, revisionierte und rückgängig machbare Übernahmen. + +### 4.2 Ausdrücklich nicht enthalten + +**Bestätigte Anforderungen** + +- automatische Stromkreisbildung in der ersten Ausbaustufe; +- automatische Übernahme späterer Stromkreisvorschläge; +- Import von Verteilungen aus Revit; +- Import einer separaten MEP-Raumliste; +- Teilimporte einzelner Ansichten oder Geschosse; +- Verwaltung mehrerer sichtbarer Modellquellen; +- direkte Dynamo- oder API-Synchronisation; +- PostgreSQL- oder Mehrbenutzerbetrieb; +- automatische Reservekreisbildung; +- automatische elektrische Dimensionierung; +- automatische Konfliktentscheidung; +- automatische Freigabe oder Wiederverwendung leer gewordener Stromkreisnummern; +- Platzhalter, Teiltextsuche oder reguläre Ausdrücke in der ersten Familie-und-Typ-Klassifizierung. + +## 5. Begriffe + +### 5.1 Externes Modellobjekt + +Ein importiertes Revit-Exemplar mit eigener `IfcGUID`. + +Es ist weder automatisch ein `ProjectDevice` noch automatisch eine `CircuitDeviceRow`. + +### 5.2 Quellwert + +Ein Wert, der aus der zuletzt akzeptierten Revit-CSV stammt. + +Beispiele: + +- Revit-Raumnummer; +- Revit-Raumname; +- Familie und Typ; +- CAx-Auswahlkenner; +- vorhandene Stromkreiskennzeichnung; +- vorhandene elektrische Leistung. + +### 5.3 Lokaler Planungswert + +Ein in Leistungsbilanz bestätigter beziehungsweise bearbeiteter Wert. + +Lokale Planungswerte dürfen durch Importe niemals still überschrieben werden. + +### 5.4 Wirksame Menge + +Die fachliche Menge, die für Gerätezeile, Leistungsberechnung und Steckdosenbegrenzung zählt. + +Beispiel: + +```text +2 Doppelsteckdosen + 2 Einzelsteckdosen += 4 Revit-Objekte += 6 physische Steckdosen += wirksame Menge 6 +``` + +## 6. Revit-CSV-Vertrag + +### 6.1 Konfigurierbare Transporteigenschaften + +**Bestätigte Anforderung** + +Die Konfiguration gilt projektweit und muss über eine GUI bearbeitbar sein. + +Mindestens konfigurierbar: + +- Encoding; +- Trennzeichen; +- Dezimaltrennzeichen; +- Zahlenformat; +- Einheit und Umrechnungsregel für Leistung; +- Spaltenname für `IfcGUID`; +- Spaltenname für Raumnummer; +- Spaltenname für Raumname; +- Spaltenname für `Familie und Typ`; +- Spaltenname für `CAx_Auswahlkenner`; +- Spaltenname für Stromkreiskennzeichnung; +- Spaltenname für elektrische Leistung; +- Spaltenname für den Mengenparameter einer Mehrfachsteckdose; +- weitere Quellspalten-zu-internen-Feld-Mappings. + +Erste Standardwerte: + +```text +Encoding: UTF-8 +Trennzeichen: ; +Leistung in Revit: W +``` + +### 6.2 Tatsächlich beobachtetes CSV-Profil + +Die bereitgestellte Referenzdatei besitzt: + +```text +Encoding: UTF-8 mit BOM +Zeilenende: CRLF +Trennzeichen: Semikolon +Quotierung: alle Felder in doppelten Anführungszeichen +Zeile 1: Titel-/Metadatenzeile +Zeile 2: Kopfzeile mit 12 Spalten +Zeile 3: vollständig leere Zeile +Objektzeilen mit IfcGUID: 897 +Summen-/Gruppierungszeilen ohne IfcGUID: 211 +Nichtleere doppelte IfcGUIDs: keine +``` + +Beispiel einer nicht als Objekt zu importierenden Summenzeile: + +```text +"UV_AV_DG_01-1F1: 8";"";"";"";"";"";"";"";"";"";"";"" +``` + +Die Implementierung darf daher nicht annehmen, dass: + +- die Kopfzeile immer die erste Dateizeile ist; +- jede Zeile nach der Kopfzeile ein Objekt ist; +- jede fehlende `IfcGUID` automatisch ein fehlerhaftes Objekt darstellt. + +### 6.3 Erkennen der Kopfzeile + +**Implementierungsvorschlag** + +Die Kopfzeile wird anhand der projektweit konfigurierten erforderlichen Spaltennamen gesucht. + +- Genau eine passende Kopfzeile: verwenden. +- Keine passende Kopfzeile: Import blockieren. +- Mehrere passende Kopfzeilen: Import blockieren und Auswahl beziehungsweise Konfiguration verlangen. +- Zeilen vor und nach der Kopfzeile bleiben als Transportbestandteil erhalten. + +### 6.4 Zeilenklassen + +**Implementierungsvorschlag** + +Jede CSV-Zeile wird genau einer Klasse zugeordnet: + +1. `metadata` + Zeile vor der Kopfzeile oder sonstige nicht tabellarische Metadaten. + +2. `header` + Erkannte Kopfzeile. + +3. `passthrough` + Leer-, Summen-, Gruppierungs- oder sonstige Zeile ohne externe Objektidentität, die nicht wie ein unvollständiges Objekt wirkt. + +4. `object` + Zeile mit nichtleerer, syntaktisch akzeptierter `IfcGUID`. + +5. `suspect-object` + Zeile ohne `IfcGUID`, aber mit befüllten objekttragenden Feldern wie Raum, Familie und Typ oder Auswahlkenner. + +`passthrough`-Zeilen werden unverändert erhalten und erzeugen keine externen Objekte. + +`suspect-object`-Zeilen werden als Konflikt angezeigt und nicht automatisch verworfen. + +### 6.5 Strukturtreuer Rückexport + +**Bestätigte Anforderung** + +Der Rückexport basiert auf der zuletzt akzeptierten vollständigen CSV und muss erhalten: + +- identische Anzahl und Reihenfolge der Zeilen; +- identische Anzahl und Reihenfolge der Spalten; +- Titel-, Leer-, Summen- und sonstige Passthrough-Zeilen; +- unbekannte beziehungsweise nicht gemappte Spalten; +- unveränderte Werte in nicht zu schreibenden Zellen; +- `IfcGUID` jeder Objektzeile; +- vorhandene Transportmerkmale, soweit technisch zuverlässig erkennbar. + +Mindestens zu erhalten sind: + +```text +BOM-Status +Encoding +Zeilenende +Trennzeichen +Spaltenreihenfolge +Zeilenreihenfolge +Titelzeilen +Leerzeilen +Summenzeilen +``` + +Nur explizit als Ausgangsparameter gemappte Zellen von erkannten Objektzeilen dürfen ergänzt oder überschrieben werden. + +Eine vollständig neu zusammengestellte Tabelle mit nur den fachlich verwendeten Spalten ist unzulässig. + +### 6.6 Anonymisiertes Beispiel + +```csv +"Projekt-Export";"";"";"";"" +"Stromkreis";"Raumnummer";"Raumname";"Familie und Typ";"Auswahlkenner";"Leistung";"IfcGUID" +"";"";"";"";"";"";"" +"UV_AV_01-2F1";"01/101";"Technik";"Steckdose: Doppelsteckdose";"Arbeitsplatz";"";"0AbCdEfGhIjKlMnOpQrStu" +"UV_AV_01-2F1: 2";"";"";"";"";"";"" +``` + +Die letzte Zeile ist eine Passthrough-Summenzeile, kein externes Modellobjekt. + +## 7. Identität und Matching + +### 7.1 Externe Identität + +**Bestätigte Anforderung** + +- `IfcGUID` ist der stabile Schlüssel für ein Revit-Objekt. +- Ein Objekt bleibt auch bei geänderten Quellwerten über seine `IfcGUID` bekannt. +- Doppelte nichtleere `IfcGUIDs` innerhalb eines Imports sind ein blockierender Konflikt. +- Eine fehlende `IfcGUID` in einer echten Objektzeile verhindert die automatische Verknüpfung. + +### 7.2 Quellmodell + +**Bestätigte Anforderung plus Architekturfolgerung** + +Für die erste Ausbaustufe gibt es pro Leistungsbilanzprojekt genau einen vollständigen Revit-Modellstrom. + +Die technische Architektur darf trotzdem eine implizite externe Quelle vorsehen, damit `IfcGUID` nicht global oder projektübergreifend eindeutig sein muss. + +Empfohlene Semantik: + +```text +Project +└── implicit ExternalModelSource + └── ExternalModelObject identified by IfcGUID +``` + +Es gibt in der ersten Ausbaustufe keine sichtbare Verwaltung von Hauptmodellen, Teilmodellen oder verknüpften Modellen. + +### 7.3 Interne Identität + +Jedes externe Objekt erhält zusätzlich eine stabile interne UUID. + +Diese UUID wird für interne Relationen, Commands, Snapshots und Undo/Redo verwendet. + +## 8. Datenhoheit + +### 8.1 Revit-geführt + +Revit ist zunächst führend für: + +- Existenz des externen Objekts; +- `IfcGUID`; +- Familie und Typ; +- Revit-Raumnummer und Revit-Raumname als Quellwerte; +- CAx-Auswahlkenner als Quellwert; +- sonstige ausschließlich aus Revit importierte Attribute. + +### 8.2 Leistungsbilanz-geführt + +Leistungsbilanz ist nach Bestätigung führend für: + +- interne Raum- und Ebenenverknüpfung; +- Standard- und Objektverteilung; +- Klassifizierung; +- `ProjectDevice`-Verknüpfung; +- lokale Planungswerte; +- Stromkreiszuordnung; +- `CircuitDeviceRow`-Zuordnung; +- Stromkreis-BMK; +- elektrische Planungsleistung; +- GZF, cosPhi, Kostengruppe, Kategorie und weitere lokale Gerätewerte. + +### 8.3 Konfliktregel + +Kein Folgeimport darf lokale Planungswerte automatisch überschreiben. + +Der Nutzer entscheidet je Konflikt oder per Sammelaktion zwischen: + +- Revit-Änderung übernehmen; +- lokalen Wert beibehalten; +- manuell einen dritten Wert festlegen. + +## 9. Projektweite Revit-Konfiguration + +### 9.1 Mapping + +Die Projektkonfiguration muss die CSV-Spalten auf interne Bedeutungen abbilden. + +Der CAx-Auswahlkenner muss mindestens als sichtbarer, filterbarer und gruppierbarer Wert verfügbar sein. Er kann als Vorschlag für einen Anzeigenamen verwendet werden. + +### 9.2 Familie-und-Typ-Regeln + +**Bestätigte Anforderung** + +In der ersten Ausbaustufe gilt ausschließlich exakter Textvergleich. + +Eine Regel kann mindestens festlegen: + +- exakter CSV-Wert `Familie und Typ`; +- interner Gerätetyp beziehungsweise fachliche Kategorie; +- Anschlussart; +- ProjectDevice-Kategorie `lighting`, `single_phase` oder `three_phase`; +- Mengenregel: + - feste Menge `1`; + - Menge aus gemappter CSV-Spalte; +- optional vorgeschlagener Anzeigename beziehungsweise Mappingquelle. + +Mehrere unterschiedliche Revit-Familien und -Typen dürfen demselben internen Gerätetyp zugeordnet werden. + +Beispiele: + +```text +_E_CAx Steckdose_AP: Steckdose Aufputz +→ interner Gerätetyp Steckdose +→ single_phase +→ Menge 1 +``` + +```text +_E_CAx Mehrfachsteckdose: Doppelsteckdose +→ interner Gerätetyp Steckdose +→ single_phase +→ Menge aus konfigurierter Anzahl-Spalte +``` + +### 9.3 Zugriff + +Der Konfigurationsbereich ist zunächst für alle Nutzer zugänglich, da noch kein Rollen- oder Rechtesystem existiert. + +## 10. Externes Objekt und Planungszustand + +### 10.1 Notwendige fachliche Informationen + +**Implementierungsvorschlag, kein finales Schema** + +Ein persistiertes externes Objekt benötigt mindestens: + +- interne UUID; +- Projekt- und implizite Quellenzugehörigkeit; +- `IfcGUID`; +- Referenz auf die aktuelle beziehungsweise zuletzt akzeptierte Quellzeile; +- importierte Quellwerte; +- zuletzt akzeptierte Quellwerte für den Folgeabgleich; +- verknüpften internen Raum, optional; +- Standardverteilung des Raums; +- abweichende Objektverteilung, optional; +- Klassifizierung; +- wirksame Menge; +- lokale Planungswerte; +- lokale Override-Metadaten; +- optionales `linkedProjectDeviceId`; +- optionalen Link zu einer `CircuitDeviceRow`; +- letzten Sichtbarkeits-/Importstatus; +- letzten gesehenen Importbatch; +- Konfliktstatus. + +### 10.2 Kein automatischer Row-Lebenszyklus + +Folgende Aktionen erzeugen keine `CircuitDeviceRow`: + +- CSV einlesen; +- Raum zuordnen; +- Verteilung zuordnen; +- klassifizieren; +- ProjectDevice verknüpfen; +- lokale Planungswerte bearbeiten. + +Eine Gerätezeile entsteht ausschließlich durch ausdrückliche Zuordnung im Stromkreislisteneditor. + +## 11. ProjectDevice-Verknüpfung + +### 11.1 Vorhandenes ProjectDevice + +Importierte Objekte dürfen mit einem vorhandenen `ProjectDevice` verknüpft werden. + +Das vorhandene `ProjectDevice` wird durch Revit-Werte niemals automatisch verändert. + +Die bestehende Regel bleibt verbindlich: + +- `ProjectDevice` ist die kanonische Projektvorlage; +- lokale Werte und Overrides bleiben möglich; +- Änderungen am ProjectDevice werden nie still synchronisiert; +- Synchronisierung benötigt Vorschau und Auswahl. + +### 11.2 Neues ProjectDevice aus Importobjekten + +**Bestätigte Anforderung** + +Der Nutzer darf im Importwizard ein neues `ProjectDevice` erstellen. + +Das Erstellformular darf anhand der gemappten Werte der ausgewählten Revit-Objekte vorausgefüllt werden. + +Mögliche Vorbelegungen: + +- `name`; +- `displayName`; +- Kategorie; +- Anschlussart; +- Kostengruppe; +- Einzelleistung; +- Gleichzeitigkeitsfaktor; +- cosPhi; +- Bemerkung. + +Die Kategorie des ProjectDevices bestimmt gemäß bestehendem Modell die Phasenart. Es darf kein paralleles, widersprüchliches Phasenmodell eingeführt werden. + +Bei einer Mehrfachauswahl mit unterschiedlichen Quellwerten muss die UI Abweichungen anzeigen. Sie darf nicht willkürlich einen Wert wählen. + +### 11.3 Lokale Werte vor der Stromkreiszuordnung + +Importierte Objekte dürfen bereits vor der Stromkreiszuordnung lokale Planungswerte und lokale Abweichungen vom verknüpften ProjectDevice besitzen. + +Beim späteren Erzeugen einer Gerätezeile werden diese bestätigten Objektplanungswerte als Ausgangswerte verwendet. + +## 12. Erstimport-Workflow + +### 12.1 Öffnen und Konfiguration + +1. Nutzer öffnet die projektweite Revit-Integration. +2. Falls keine gültige Mappingkonfiguration existiert, wird zuerst die Konfiguration geöffnet. +3. Nutzer lädt eine vollständige CSV hoch. +4. Parser erkennt Transportparameter und Kopfzeile. +5. Datei wird ohne fachliche Projektschreibvorgänge geparst und validiert. + +### 12.2 Vorschau + +Die Vorschau zeigt mindestens: + +- Anzahl erkannter Objektzeilen; +- Anzahl Passthrough-Zeilen; +- Anzahl verdächtiger Objektzeilen; +- fehlende und doppelte `IfcGUIDs`; +- unbekannte Familie-und-Typ-Werte; +- neue und bereits bekannte Räume; +- vorhandene Stromkreiswerte; +- nicht parsebare Leistungen oder Mengen. + +### 12.3 Raumwizard + +Räume werden aus den importierten Objektzeilen abgeleitet. + +Der Nutzer kann: + +- einen neuen internen Raum anlegen; +- einen importierten Raum mit einem vorhandenen internen Raum verknüpfen; +- mehrere Räume sortiert nach Raumnummer bearbeiten; +- Räume einer Ebene zuordnen. + +Die Raumnummer ist zunächst das primäre Matchingmerkmal. + +Eine eigene Revit-Raum-GUID ist nicht erforderlich. + +### 12.4 Verteilungen + +Verteilungen werden manuell angelegt. + +Der Nutzer kann: + +- einem Raum eine Standardverteilung zuweisen; +- mehrere Räume gesammelt einer Verteilung zuweisen; +- einzelne Objekte abweichend einer anderen Verteilung zuweisen; +- Objekte ohne MEP-Raum manuell einer Verteilung zuweisen. + +Neue Objekte eines bereits bekannten Raums erhalten die bestehende Standardverteilung als Vorschlag. + +### 12.5 Klassifizierung und ProjectDevices + +Der Nutzer kann: + +- Objekte nach Raum, Familie und Typ, CAx-Auswahlkenner und Status filtern; +- Familie-und-Typ-Werte klassifizieren; +- mehrere Objekte mit einem vorhandenen ProjectDevice verknüpfen; +- unmittelbar ein neues ProjectDevice erstellen; +- lokale Werte bearbeiten. + +### 12.6 Bereits gefüllte Stromkreiskennzeichnung + +Enthält eine Objektzeile bereits eine Stromkreiskennzeichnung, muss der Wizard fragen, wie sie behandelt wird. + +Möglichkeiten: + +- vorhandenen Wert nur als Quellwert behalten; +- vorhandene Zuordnung übernehmen; +- vorhandenen Wert ignorieren. + +Eine Übernahme ist nur zulässig, wenn: + +- die Präfix-Verteilung eindeutig vorhanden ist; +- die Zuordnung zur Raum- beziehungsweise Objektverteilung passt oder ausdrücklich bestätigt wird; +- der Stromkreis eindeutig vorhanden oder bewusst anzulegen ist; +- keine widersprüchliche Zuordnung entsteht. + +Keine Variante darf still gewählt werden. + +### 12.7 Übernahme + +Die bestätigte Erstübernahme schreibt mindestens: + +- Importbatch; +- vollständige Transportgrundlage für den Rückexport; +- externe Objekte; +- Quellwerte; +- Raum- und Verteilungslinks; +- Klassifizierungen; +- ProjectDevice-Links; +- lokale Planungswerte; +- Konfliktentscheidungen. + +Die Übernahme ist ein atomarer Projekt-Command mit `expectedRevision`. + +Sie erzeugt genau eine Projektrevision und einen Undo-Schritt. + +Nach erfolgreicher Übernahme erscheinen ausreichend klassifizierte, einer Verteilung zugeordnete und noch nicht verschaltete Objekte im Stromkreislisteneditor. + +## 13. UI 1 – Import-, Staging- und Abgleichswizard + +### 13.1 Pflichtfunktionen + +- sortierbare tabellarische Darstellung für mehrere Tausend Objekte; +- Volltextsuche; +- Filter nach Raum, Raumname, Familie und Typ, CAx-Auswahlkenner, Verteilung, ProjectDevice, Stromkreis und Status; +- Mehrfachauswahl; +- Shift-Bereichsauswahl; +- Auswahl aller gefilterten Treffer; +- Auswahl vollständiger Räume oder Gruppen; +- Sammelzuordnung zu Raum, Ebene, Verteilung, Klassifizierung und ProjectDevice; +- Erstellen eines ProjectDevices; +- Bearbeiten lokaler Planungswerte; +- Vergleich Quellwert gegen lokalen Wert; +- Konfliktentscheidungen einzeln und gesammelt; +- Vorschau des Änderungssatzes vor Übernahme. + +### 13.2 Sichtbare Objektinformationen + +Mindestens: + +- `IfcGUID`; +- Familie und Typ; +- CAx-Auswahlkenner; +- Revit-Raumnummer und Raumname; +- interner Raum und Ebene; +- Standardverteilung; +- tatsächliche Objektverteilung; +- Klassifizierung; +- wirksame Menge; +- verknüpftes ProjectDevice; +- lokaler Anzeigename; +- lokale Leistung; +- zugeordneter Stromkreis; +- zugeordnete CircuitDeviceRow; +- Import- und Konfliktstatus. + +### 13.3 Statusfilter + +Mindestens: + +- neu; +- bekannt und unverändert; +- geändert; +- Raum geändert; +- im vollständigen Folgeimport nicht enthalten; +- ohne Raum; +- ohne Verteilung; +- ohne Klassifizierung; +- ohne ProjectDevice; +- ohne Stromkreis; +- vollständig zugeordnet; +- konfliktbehaftet. + +`Ohne ProjectDevice` ist kein Fehler. + +## 14. UI 2 – Unzugeordnete Objekte im Stromkreislisteneditor + +### 14.1 Sichtbarkeit + +Der Editor zeigt einen separaten Bereich beziehungsweise Drawer mit Objekten, die: + +- der aktuellen Verteilung zugeordnet sind; +- noch mit keiner `CircuitDeviceRow` verknüpft sind; +- ausreichend klassifiziert sind; +- keinen blockierenden Konflikt besitzen. + +### 14.2 Darstellung und Filter + +Mindestens sichtbar: + +- Raum; +- Familie und Typ; +- CAx-Auswahlkenner; +- interner Gerätetyp; +- ProjectDevice; +- wirksame Menge; +- Einzelleistung; +- Objektgesamtleistung; +- Kategorie beziehungsweise Phasenart; +- Anschlussart; +- Status. + +Filter und Mehrfachauswahl müssen auch hier für große Mengen geeignet sein. + +### 14.3 Drag-and-drop-Semantik + +**Bestätigte Anforderung** + +Der Drop-Zielbereich bestimmt die fachliche Aktion. + +#### Drop auf bestehende CircuitDeviceRow + +- ausgewählte externe Objekte werden mit genau dieser Zeile verknüpft; +- Menge und Gesamtleistung werden neu berechnet; +- die Anwendung wählt niemals selbst eine andere passende Zeile. + +#### Drop auf bestehenden Circuit + +- in diesem Stromkreis wird eine neue CircuitDeviceRow angelegt; +- dies gilt auch, wenn bereits eine ähnliche Zeile vorhanden ist. + +#### Drop auf freien Zielbereich für neuen Circuit + +- ein neuer Circuit wird über den bestehenden Circuit-Insert-/Move-Mechanismus angelegt; +- mindestens eine neue CircuitDeviceRow wird erzeugt; +- BMK-Erzeugung folgt den bestehenden expliziten Regeln des Editors; +- keine Nachbarstromkreise werden neu nummeriert. + +Die gesamte jeweilige Aktion einschließlich externer Links, Mengenänderung, Circuit-/Row-Erzeugung, Revision und History-Transition ist atomar. + +### 14.4 Keine automatische Zusammenführung + +Gleiche Eigenschaften dürfen Hinweise und Vorschläge erzeugen. + +Die Anwendung darf externe Objekte aber nicht ohne Benutzeraktion automatisch: + +- zusammenführen; +- einer bestehenden Gerätezeile hinzufügen; +- in einen Stromkreis verschieben; +- auf mehrere Gerätezeilen verteilen. + +## 15. Gerätezeilen, Aggregation und Mehrfachsteckdosen + +### 15.1 Einzelobjekte bleiben erhalten + +Jedes Revit-Objekt bleibt intern separat anhand seiner `IfcGUID` nachvollziehbar, auch wenn mehrere Objekte in einer Gerätezeile aggregiert dargestellt werden. + +### 15.2 Mehrfachsteckdose + +**Bestätigte Anforderungen** + +- Eine Mehrfachsteckdose ist ein Revit-Objekt. +- Ihr Mengenparameter enthält die Anzahl physischer Schukosteckdosen. +- Eine Doppelsteckdose zählt als zwei Steckdosen. +- Das Objekt ist unteilbar und darf nicht auf mehrere Stromkreise verteilt werden. +- Die Leistung wird je physischer Steckdose angesetzt. +- Die Objektgesamtleistung ist `wirksame Menge × powerPerUnit`. + +### 15.3 Gerätezeilenmenge + +Die Menge einer CircuitDeviceRow ist die Summe der wirksamen Mengen aller mit ihr verknüpften externen Objekte plus gegebenenfalls manuell geführter Anteile, sofern das vorhandene Datenmodell dies eindeutig unterscheiden kann. + +Beispiel: + +```text +2 Doppelsteckdosen + 2 Einzelsteckdosen +→ 4 ExternalModelObjects +→ CircuitDeviceRow.quantity = 6 +``` + +### 15.4 Getrennte Gerätezeilen + +**Bestätigte Anforderungen** + +Unterschiedliche Räume werden in getrennten Gerätezeilen dargestellt. + +Unterschiedliche CAx-Auswahlkenner werden in getrennten Gerätezeilen dargestellt. + +Beispiel: + +```text +Circuit UV_AV_01-2F1 +- Raum 01/101: 4 × Arbeitsplatzsteckdose +- Raum 01/101: 2 × Mediensteckdose +- Raum 01/102: 1 × Arbeitsplatzsteckdose +``` + +Der Nutzer darf trotz gleicher Werte bewusst mehrere getrennte Gerätezeilen erzeugen. + +### 15.5 Raumübergreifende Stromkreise + +Raumübergreifende Stromkreise bleiben manuell zulässig und werden über mehrere Gerätezeilen übersichtlich dargestellt. + +Die spätere automatische Stromkreisvorschlagsfunktion darf nur raumbezogene Vorschläge erzeugen. + +## 16. Folgeimport + +### 16.1 Annahme + +Jeder Folgeimport enthält erneut den vollständigen relevanten Modellstand der Kategorie `Elektroinstallation`. + +Teilimporte sind in der ersten Ausbaustufe nicht zulässig beziehungsweise werden nicht als Löschgrundlage verwendet. + +### 16.2 Vergleichszustände + +Mindestens zu erkennen: + +- bekannte `IfcGUID`, unveränderte Quellwerte; +- neue `IfcGUID`; +- bekannte `IfcGUID` mit geänderten Quellwerten; +- geänderter Revit-Raum; +- geänderte Stromkreiskennzeichnung; +- geänderte Leistung; +- zuvor bekannte `IfcGUID` fehlt; +- doppelte `IfcGUID`; +- verdächtige Objektzeile ohne `IfcGUID`. + +### 16.3 Fehlende Objekte + +Fehlt eine bekannte `IfcGUID`, wird das Objekt nur als `nicht mehr im aktuellen vollständigen Export enthalten` markiert. + +Es wird nicht automatisch: + +- gelöscht; +- aus seiner Gerätezeile entfernt; +- aus seinem Stromkreis entfernt; +- von seinem ProjectDevice getrennt. + +Erst nach ausdrücklicher Bestätigung wird das externe Objekt entfernt beziehungsweise als gelöscht übernommen. + +Danach: + +- wird sein Link zur CircuitDeviceRow entfernt; +- werden Menge und Leistung der Zeile neu berechnet; +- bleibt ein dadurch leer gewordener Circuit bestehen; +- wird seine BMK nicht automatisch freigegeben oder neu vergeben. + +### 16.4 Raumänderung + +Eine Raumänderung wird anhand derselben `IfcGUID` erkannt und als Konflikt angezeigt. + +Sie wird nicht automatisch übernommen. + +### 16.5 Alle Änderungen sind nutzergesteuert + +Der Nutzer kann Konflikte: + +- einzeln behandeln; +- gruppiert behandeln; +- Revit-Werte übernehmen; +- lokale Werte behalten; +- manuell überschreiben. + +Die bestätigte Übernahme eines Folgeimports ist ein atomarer Projekt-Command und eine Projektrevision. + +## 17. Rückexport + +### 17.1 Grundlage + +Der Export verwendet den zuletzt akzeptierten vollständigen Importbatch und eine bekannte aktuelle Projektrevision. + +Ein Export verändert die Projektrevision nicht. + +### 17.2 Stromkreiskennzeichnung + +Für jedes einem Stromkreis zugeordnete externe Objekt wird geschrieben: + +```text + +``` + +Beispiel: + +```text +UV_AV_DG_01-2F1 +``` + +Die genaue Trennlogik folgt dem tatsächlich im Projekt verwendeten Verteilerpräfix und Stromkreis-BMK; es darf kein zweites unabhängiges Nummerierungssystem eingeführt werden. + +### 17.3 Leistung + +Die Rückgabe erfolgt in Watt. + +Für eine Mehrfachsteckdose wird die objektbezogene Gesamtleistung geschrieben: + +```text +Objektleistung = wirksame Menge des Revit-Objekts × powerPerUnit +``` + +Bei normalen Einzelobjekten ist die wirksame Menge `1`. + +### 17.4 Objektbezogene Ausgabe + +Sind mehrere Revit-Objekte mit einer gemeinsamen CircuitDeviceRow verknüpft: + +- erhält jedes Objekt seine eigene ursprüngliche CSV-Zeile; +- erhält jedes Objekt dieselbe Stromkreiskennzeichnung; +- erhält jedes Objekt seine eigene Objektgesamtleistung; +- bleibt seine `IfcGUID` unverändert. + +### 17.5 Exportnachweis + +**Implementierungsvorschlag** + +Ein Exportbatch speichert mindestens: + +- Projekt-ID; +- Projektrevision; +- zugrunde liegenden Importbatch; +- Zeitstempel; +- Dateiname; +- Prüfsumme; +- verwendete Mappingkonfiguration beziehungsweise deren Version. + +Dies ist Auditmetadaten und kein Ersatz für die Projekt-Revisionshistorie. + +## 18. Validierungen + +### 18.1 Blockierende Fehler + +Mindestens: + +- CSV kann mit der Konfiguration nicht geparst werden; +- erforderliche Kopfzeile ist nicht eindeutig; +- erforderliche Spalte fehlt; +- doppelte nichtleere `IfcGUID` unter Objektzeilen; +- ungültige oder nicht serialisierbare Projektwerte; +- stale `expectedRevision`; +- Verknüpfung zu einem anderen Projekt; +- Drop-Ziel gehört nicht zur zugeordneten Verteilung beziehungsweise Liste; +- Mehrfachsteckdose würde intern auf mehrere Stromkreise aufgeteilt; +- atomare Command-Vorbedingungen stimmen nicht mehr. + +### 18.2 Warnungen beziehungsweise aufzulösende Konflikte + +Mindestens: + +- unbekannter Familie-und-Typ-Wert; +- Objekt ohne Raum; +- Raumänderung; +- bestehende abweichende Stromkreiskennzeichnung; +- abweichende Revit-Leistung; +- Objekt im Folgeimport nicht enthalten; +- ausgewählte Objekte besitzen unterschiedliche lokale Planungswerte; +- vorhandene Stromkreiszuordnung passt nicht zur Verteilung; +- verdächtige Objektzeile ohne `IfcGUID`. + +## 19. Revision, Undo/Redo und Audit + +### 19.1 Gemeinsame Transaktionsgrenze + +**Bestehende Architekturvorgabe** + +Alle bestätigten projektbezogenen Änderungen laufen über: + +```text +domain mutation ++ inverse command ++ project revision ++ undo/redo transition +``` + +Sie werden gemeinsam über die bestehende Projekt-Command-Transaktionsgrenze committed oder vollständig zurückgerollt. + +Neue Revit-Fachlogik darf nicht direkt von React, `better-sqlite3`, globalen Datenbankinstanzen oder konkreten SQLite-Repositories abhängen. + +### 19.2 Neue logische Commands + +**Implementierungsvorschlag** + +Mindestens getrennte Command-Verantwortlichkeiten: + +- Revit-Projektkonfiguration ändern; +- akzeptierten Erstimport anwenden; +- akzeptierten Folgeimport anwenden; +- externe Objektplanungswerte ändern; +- externe Objekte mit ProjectDevices verknüpfen oder trennen; +- externe Objekte einer bestehenden CircuitDeviceRow zuweisen; +- externe Objekte als neue CircuitDeviceRow einem Circuit zuweisen; +- externe Objekte mit neuem Circuit und neuer Row zuweisen; +- externe Objektzuordnung aus einer Row lösen; +- externes Objekt nach bestätigtem Fehlen löschen. + +Die konkreten Command-Namen und Payloads sind beim Implementierungsaudit festzulegen. + +### 19.3 Undo + +Undo muss insbesondere wiederherstellen: + +- externe Objekte und Quellstände; +- Raum-, Verteilungs- und ProjectDevice-Links; +- lokale Planungswerte und Overrides; +- CircuitDeviceRow-Verknüpfungen; +- Mengen und Leistungen; +- erzeugte Row- und Circuit-UUIDs; +- Importstatus. + +Undo darf keine BMKs neu berechnen. + +## 20. Snapshots und portabler Projekttransfer + +**Bestehende Architekturfolgerung** + +Sobald die Revit-Integration unterstützt wird, gehört ihr bestätigter Projektzustand zum vollständigen logischen Projektzustand. + +Snapshot- und JSON-Transfer-Schema müssen deshalb nach einem bewussten Schema-Versionswechsel mindestens erhalten: + +- projektweite Revit-Konfiguration; +- Mappingregeln; +- Familie-und-Typ-Regeln; +- externe Objekte; +- Quell- und Planungswerte; +- Raum-, Verteilungs-, ProjectDevice- und CircuitDeviceRow-Links; +- relevante Importbatch-Grundlagen für den Rückexport; +- Konflikt- und Sichtbarkeitsstatus. + +Beim Duplizieren eines Projekts: + +- werden alle internen UUIDs remapped; +- bleiben externe `IfcGUIDs` als Quellidentitäten erhalten; +- werden interne Links auf die remappten Projektobjekte aktualisiert. + +Vorhandene Snapshot-Migrationen dürfen nicht still verändert werden. Es ist eine additive neue Schema-Version erforderlich. + +## 21. Modul- und Persistenzgrenzen + +### 21.1 Verbindliche Grenzen + +- Parsing und Serialisierung sind keine React-Aufgabe. +- CSV-Dialektlogik ist kein Bestandteil von Circuit-Domain-Services. +- Domain-Services kennen keine konkreten SQLite-Repositories. +- Controller importieren keinen globalen Datenbankclient. +- Writes erfolgen ausschließlich über typisierte Commands. +- Reads verwenden schmale, fachlich benannte Repositories. +- Server-Komposition erzeugt und injiziert konkrete Adapter. +- SQLite bleibt der unterstützte Adapter. +- PostgreSQL wird nicht in dieser Phase eingeführt. + +### 21.2 Empfohlene Verantwortlichkeiten + +**Implementierungsvorschlag** + +```text +CSV transport adapter +- dialect detection +- header and row classification +- lossless-enough matrix preservation +- mapped value parsing +- return serialization + +External model domain +- identity and matching +- source versus planning values +- conflict calculation +- object lifecycle +- aggregation invariants + +Application services / commands +- import preview +- first import apply +- follow import apply +- link and unlink operations +- export projection + +Persistence adapters +- project configuration +- import/export batches +- external objects +- links and accepted source state + +Frontend +- project configuration UI +- staging wizard +- unassigned-object editor drawer +``` + +Die Namen sind Verantwortlichkeiten, keine vorab beschlossenen Tabellen- oder Ordnernamen. + +## 22. Performanceanforderungen + +**Bestätigte Anforderung** + +Das UI muss mehrere Tausend Objektzeilen praktisch bearbeitbar machen. + +Mindestens: + +- keine vollständige DOM-Darstellung aller Zeilen, falls dies die Bedienbarkeit beeinträchtigt; +- server- oder clientseitige effiziente Sortierung und Filterung; +- stabile Mehrfachauswahl; +- Sammelaktionen auf gefilterte Treffer; +- keine fachliche Änderung beim bloßen Filtern und Sortieren; +- keine automatische Neunummerierung; +- Import und Export dürfen zunächst synchron laufen, solange reale Projektdateien zuverlässig verarbeitet werden. + +Die Referenzdatei mit rund 900 Objektzeilen und über 1.100 Gesamtzeilen ist als Mindest-Integrationstest zu verwenden. + +## 23. Implementierungsphasen + +### Phase 14.0 – Audit und Verträge + +Ziel: + +- aktuelle ProjectDevice-, Row-, Command-, Snapshot- und Editorpfade prüfen; +- konkretes Datenmodell und Command-Schnittstellen vorschlagen; +- keine Implementierung vor Freigabe des Auditberichts. + +Lieferung: + +- Keep/Refactor/Add-Liste; +- vorgeschlagene Domainobjekte; +- vorgeschlagene Commands; +- Snapshot-/Transfer-Auswirkungen; +- Risiken bei Row-Mengen und lokalen Objektwerten. + +Abnahme: + +- keine bestehende Architekturregel wird umgangen; +- offene Punkte sind klar als solche markiert. + +### Phase 14.1 – CSV-Konfiguration und Parser + +Ziel: + +- projektweite Mappingkonfiguration; +- Parser und Serializer für das beobachtete CSV-Profil; +- reine Vorschau ohne Projektschreibvorgang. + +Abnahme: + +- Referenzdatei wird mit 897 Objektzeilen und 211 Passthrough-Summenzeilen erkannt; +- Titel-, Leer- und Summenzeilen bleiben erhalten; +- nichtleere `IfcGUIDs` sind eindeutig; +- Rückserialisierung ohne fachliche Änderungen erhält Struktur und Zellenwerte; +- Parser besitzt fokussierte Tests für BOM, CRLF, Semikolon, Quotierung und Kopfzeile in Zeile 2. + +### Phase 14.2 – Externe Objekte und Erstimport + +Ziel: + +- persistente externe Objekte; +- Raum-, Ebenen-, Verteilungs-, Klassifizierungs- und ProjectDevice-Verknüpfung; +- atomare Importübernahme. + +Abnahme: + +- Import erzeugt keine CircuitDeviceRow; +- Raum- und Verteilungszuordnung kann gespeichert werden; +- neues ProjectDevice kann vorausgefüllt erstellt werden; +- vorhandenes ProjectDevice wird nicht durch Revit-Werte verändert; +- Import ist ein Undo-Schritt; +- Undo entfernt den vollständigen bestätigten Importzustand. + +### Phase 14.3 – Stromkreislisteneditor + +Ziel: + +- unzugeordnete externe Objekte je Verteilung; +- Drag-and-drop zu Row, Circuit oder neuem Circuit; +- Aggregation und Mehrfachsteckdosen. + +Abnahme: + +- Drop auf Row ergänzt genau diese Row; +- Drop auf Circuit erzeugt eine neue Row; +- Drop auf neuen Zielbereich erzeugt Circuit und Row atomar; +- 2 Doppel- plus 2 Einzelsteckdosen ergeben Menge 6; +- keine Mehrfachsteckdose kann geteilt werden; +- verschiedene Räume und Auswahlkenner bleiben in getrennten Rows; +- Undo stellt externe Links, Mengen, Row-/Circuit-UUIDs und BMKs exakt wieder her. + +### Phase 14.4 – Rückexport + +Ziel: + +- strukturtreue Revit-Rückgabe-CSV. + +Abnahme: + +- Zeilen- und Spaltenzahl sowie Reihenfolge entsprechen der Ausgangsdatei; +- unbekannte Spalten und Passthrough-Zeilen bleiben erhalten; +- Stromkreis und Leistung werden ausschließlich in gemappte Objektzellen geschrieben; +- jedes Objekt behält seine `IfcGUID`; +- Mehrfachsteckdosen erhalten ihre Objektgesamtleistung in Watt; +- Export referenziert eine bekannte Projektrevision. + +### Phase 14.5 – Folgeimport und Konflikte + +Ziel: + +- additions, changes, missing objects and conflicts; +- Einzel- und Sammelentscheidungen. + +Abnahme: + +- neue Objekte werden erkannt; +- Raumänderungen werden konfliktbehaftet angezeigt; +- fehlende Objekte werden nicht automatisch entfernt; +- lokale Werte werden nicht automatisch überschrieben; +- bestätigte Änderungen sind ein atomarer Undo-Schritt; +- unveränderte Objekte erzeugen keine unnötigen Domainänderungen. + +### Phase 14.6 – Snapshot, Transfer und Härtung + +Ziel: + +- vollständige Projektportabilität; +- Performance und End-to-End-Tests. + +Abnahme: + +- Snapshot/Restore erhält sämtliche externe Links und Exportgrundlagen; +- Projektduplikat remapped interne UUIDs und behält `IfcGUIDs`; +- Undo/Redo funktioniert nach Reload; +- Referenz-CSV durchläuft Erstimport, Row-Zuordnung, Export, Folgeimport und Restore; +- vollständige Test- und Build-Suite läuft erfolgreich. + +## 24. End-to-End-Abnahmeszenarien + +### Szenario A – Gemischte Steckdosen + +Aus Revit: + +```text +Raum 01/101 +- 2 Doppelsteckdosen, jeweils Menge 2 +- 2 Einzelsteckdosen, jeweils Menge 1 +- gleicher CAx-Auswahlkenner +``` + +Erwartung: + +- 4 externe Objekte; +- wirksame Menge 6; +- Nutzer zieht alle Objekte auf eine neue Row; +- Row zeigt `6 × Steckdose`; +- alle vier CSV-Zeilen erhalten denselben Stromkreis; +- Doppelsteckdosen erhalten jeweils `2 × powerPerUnit` als Objektleistung; +- Einzelsteckdosen erhalten jeweils `1 × powerPerUnit`. + +### Szenario B – Gleiches ProjectDevice in mehreren Räumen + +Aus Revit: + +- gleicher Leuchtentyp in drei Technikräumen. + +Erwartung: + +- Nutzer wählt alle Leuchten raumübergreifend; +- erstellt ein neues, aus Revit-Werten vorausgefülltes ProjectDevice; +- alle Objekte werden damit verknüpft; +- es wird noch keine CircuitDeviceRow erzeugt; +- später entstehen je Raum getrennte Rows, sofern die Objekte verschiedenen Räumen zugeordnet werden. + +### Szenario C – Raumübergreifender Putzsteckdosenstromkreis + +- mehrere Räume mit jeweils wenigen Putzsteckdosen; +- Nutzer ordnet sie manuell demselben Circuit zu; +- pro Raum entsteht eine getrennte Row; +- alle Objekte erhalten dieselbe Stromkreiskennzeichnung. + +### Szenario D – Folgeimport mit Raumänderung + +- bekannte `IfcGUID`; +- Revit-Raumnummer ist geändert. + +Erwartung: + +- Objekt wird nicht neu angelegt; +- Raumänderung wird als Konflikt angezeigt; +- bestehende interne Raum-, Verteilungs- und Stromkreiszuordnung bleibt unverändert; +- Nutzer kann die Änderung einzeln oder gesammelt übernehmen. + +### Szenario E – Fehlendes Objekt + +- eine zuvor bekannte `IfcGUID` fehlt im vollständigen Folgeimport. + +Erwartung: + +- Objekt wird als fehlend markiert; +- Row-Menge und Leistung bleiben zunächst unverändert; +- erst bestätigte Löschung entfernt Link und Mengenanteil; +- Circuit bleibt auch bei leerer Row beziehungsweise nach Row-Entfernung bestehen; +- BMK wird nicht automatisch wiederverwendet. + +### Szenario F – Bestehende Stromkreiskennzeichnung beim Erstimport + +- Revit-Zeile enthält bereits `UV_AV_01-2F3`. + +Erwartung: + +- Wizard zeigt den Wert; +- Nutzer kann Quellwert behalten, Zuordnung übernehmen oder ignorieren; +- keine Option wird automatisch gewählt; +- unpassende Verteilung oder fehlender Circuit erzeugt Konflikt beziehungsweise bewusste Anlageentscheidung. + +### Szenario G – CSV-Passthrough + +- Titelzeile; +- Kopfzeile in Zeile 2; +- Leerzeile; +- Objektzeilen; +- Summenzeile ohne `IfcGUID`. + +Erwartung: + +- nur Objektzeilen erzeugen externe Objekte; +- Summenzeile erzeugt keine Fehlermeldung; +- Rückexport enthält alle Zeilen an derselben Position. + +## 25. Noch offene, phasengebundene Entscheidungen + +Diese Punkte blockieren die Erstellung dieser Spezifikation nicht. + +### Vor Phase 14.2 zu entscheiden + +- konkrete Benennung der neuen Domainobjekte und Tabellen; +- ob Importentwürfe vor der endgültigen Übernahme serverseitig gespeichert werden; +- genaue Versionierung der Mappingkonfiguration; +- genaue Speicherung der Original-CSV: vollständige Rohdatei, logische Zellmatrix oder Kombination. + +### Vor Phase 14.3 zu entscheiden + +- visuelle Position des Objekt-Drawers; +- Verhalten einer Mehrfachauswahl mit widersprüchlichen Planungswerten; +- Warnungsdialog bei fachlich unpassender Row; +- Verhalten, wenn eine Row manuelle Mengenanteile und externe Objekte kombiniert; +- genaue UI für das Lösen einer einzelnen externen Objektverknüpfung aus einer aggregierten Row. + +### Vor Phase 14.4 zu entscheiden + +- exaktes Revit-Zahlenformat für Dezimalwerte; +- genaue Formatierung von Wattwerten, zum Beispiel `1000 W` oder `1000`; +- Umgang mit Objekten ohne Stromkreis beim Rückexport: leeres Feld oder unveränderter Quellwert; +- Dateinamenschema der Rückgabe. + +### Spätere Ausbaustufen + +- automatische raumbezogene Stromkreisvorschläge; +- projektübergreifend wiederverwendbare Mappingprofile; +- Teilmodelle und mehrere externe Quellen; +- Dynamo/API/JSON-Transportadapter; +- Rollen und Berechtigungen; +- Hintergrundjobs; +- PostgreSQL. + +## 26. Arbeitsweise für Codex + +Vor jeder Phase: + +1. relevante bestehende Module auditieren; +2. angeben, was erhalten, erweitert oder ersetzt wird; +3. betroffene Commands, Snapshots und Transferformate nennen; +4. Migration und Rückwärtsverträglichkeit erläutern; +5. fokussierte Tests festlegen. + +Während der Implementierung: + +- kleine reviewbare Arbeitspakete; +- keine fachlichen Writes außerhalb der Command-Grenze; +- keine automatische BMK-Änderung; +- keine stillen Revit- oder ProjectDevice-Synchronisationen; +- keine ungefragte PostgreSQL- oder Dynamo-Implementierung; +- keine Kopplung von Domainlogik an CSV, React oder SQLite. + +Nach jedem Arbeitspaket: + +- fokussierte Tests; +- `npm test`; +- `npm run build:api`; +- `npm run build:web`; +- `npm run typecheck:scripts`; +- `npx tsc --noEmit -p tsconfig.next.json`; +- Dokumentation des neuen unterstützten Laufzeitpfads aktualisieren. diff --git a/docs/spec/revit-csv-phase-14-audit-and-plan.md b/docs/spec/revit-csv-phase-14-audit-and-plan.md index 2d116b2..be50eb1 100644 --- a/docs/spec/revit-csv-phase-14-audit-and-plan.md +++ b/docs/spec/revit-csv-phase-14-audit-and-plan.md @@ -1,8 +1,402 @@ -# Abgelöst: alter Phase-14-CSV-Plan +# Phase 14: Audit- und Implementierungsplan für die Revit-CSV-Anbindung -Die Phasen 14.0–14.6 und ihre Erledigt-Markierungen sind abgelöst. Für die -Umstellung auf Linear-Excel gelten der [R0–R10-Plan](revit-excel-phase-14-plan.md) -und die [neuen Anforderungen](revit-excel-integration-requirements.md). +## Status -Der historische Inhalt bleibt im Git-Verlauf bis einschließlich Commit -`ae318a5` erhalten und darf nicht fortgeschrieben werden. +Phase 14.0 ist abgeschlossen und freigegeben. Dieses Dokument beschreibt den +gegen den aktuellen Code geprüften Zielzuschnitt. Phase 14.1 ist abgeschlossen. +Phase 14.2 hat mit den externen Domänenverträgen, Identitätsregeln und dem +additiven Persistenzschema begonnen; eine bestätigte Importübernahme existiert +noch nicht. + +Fachliche Quelle bleibt +[Revit-CSV-Integration – Anforderungen und Implementierungsanweisung](revit-csv-integration-requirements.md). +Dieses Dokument konkretisiert dafür Namen, Modulgrenzen, Persistenz und die +Reihenfolge kleiner Arbeitspakete. + +## Ergebnis des Bestandsaudits + +### Beibehalten + +- Das Circuit-First-Modell bleibt unverändert: Ein `Circuit` besitzt null bis + viele `CircuitDeviceRow`-Datensätze. +- `ProjectDevice` bleibt die kanonische projektweite Vorlage. Ein Import darf + diese Datensätze weder erzeugen noch ändern, solange der Nutzer dies nicht + ausdrücklich bestätigt. +- `CircuitDeviceRow.linkedProjectDeviceId` bleibt die optionale Verbindung + zwischen einer Gerätezeile und genau einer Projektgerätevorlage. +- Die bestehenden getrennten Drag-and-drop-Pfade für Projektgeräte, + Gerätezeilen und Stromkreise bleiben bestehen. Externe Objekte erhalten einen + vierten, fachlich eigenen Pfad. +- Alle bestätigten Änderungen verwenden typisierte Commands mit + `expectedRevision`, vollständiger Gegenrichtung und + `project-command-transaction.persistence.ts` als gemeinsamer + Transaktionsgrenze. +- Snapshot-Erfassung, Restore und Projektduplikat bleiben explizite Adapter mit + fester Fremdschlüsselreihenfolge und UUID-Remapping. +- SQLite und die heutige Server-Komposition bleiben der einzige unterstützte + Laufzeitadapter. + +### Erweitern oder gezielt refaktorieren + +- `ProjectStateSnapshot` und der portable Projekttransfer werden additiv um den + bestätigten externen Projektzustand erweitert. Bereits veröffentlichte + Snapshot-Versionen werden nicht verändert. +- Der Command-Dispatcher erhält schmale Stores für externe Konfiguration, + Importübernahme, Objektplanung und Row-Zuordnung. Controller erhalten keine + konkreten SQLite-Abhängigkeiten. +- Der Stromkreislisteneditor erhält später einen separaten Drawer für + unzugeordnete externe Objekte. Die bestehende Projektgeräteauswahl wird nicht + dafür zweckentfremdet. +- Vor der ersten externen Row-Zuordnung wird die Mengenhoheit einer + `CircuitDeviceRow` explizit gemacht; Details stehen unter „Mengenmodell“. + +### Hinzufügen + +- verlustarmer CSV-Transportadapter außerhalb von React und Circuit-Domain; +- projektweite, versionierte Revit-CSV-Konfiguration; +- eine zunächst implizite externe Modellquelle je Projekt; +- Importbatches einschließlich Originaltransport und akzeptiertem + Konfigurationsstand; +- persistente externe Objekte mit `IfcGUID`, getrennten Quell- und + Planungswerten und einzelnem Lebenszyklus; +- Quellraum-Mappings auf interne Räume und Standardverteilungen; +- explizite Verknüpfungen zu `ProjectDevice`, `CircuitDeviceRow` und optionaler + abweichender Verteilung; +- Vorschau-, Konflikt- und Exportprojektionen als reine Anwendungsservices; +- fokussierte Parser-, Command-, Transaktions-, Snapshot-, Transfer- und + End-to-End-Tests. + +### Entfernen + +Es existiert kein unterstützter Revit-Laufzeitpfad. Deshalb wird in Phase 14 +kein bestehender Fachpfad entfernt und keine Legacy-Kompatibilität eingeführt. + +## Vorgeschlagenes Domänenmodell + +Die Namen sind ab Phase 14.1 verbindliche Arbeitsnamen. Tabellen verwenden die +jeweilige englische Pluralform in `snake_case`. + +### `ExternalModelSource` + +- stabile interne UUID; +- `projectId`; +- technischer Name und Quelltyp `revit_csv`; +- der zuletzt bestätigte Importbatch wird aus der geordneten Batchhistorie + abgeleitet und nicht als redundanter Zeiger gespeichert. + +In der ersten Ausbaustufe wird genau eine Quelle je Projekt automatisch +angelegt. Es gibt bewusst keine sichtbare Mehrquellenverwaltung. Die +Eindeutigkeit eines externen Objekts ist trotzdem von Anfang an +`(sourceId, ifcGuid)`. + +### `ExternalCsvConfiguration` + +- stabile UUID und `projectId` mit genau einer aktiven Konfiguration; +- Konfigurationsschema-Version; +- CSV-Dialekt: Encoding, BOM, Trennzeichen, Zeilenende, Quote-Zeichen, + Dezimalformat und Kopfzeilenerkennung; +- exakte Spaltenzuordnung; +- geordnete, exakte Familie-und-Typ-Regeln; +- monotoner Konfigurationsstand. + +Eine Änderung ersetzt den vollständigen erwarteten Konfigurationssnapshot in +einem Command. Jeder bestätigte Importbatch speichert zusätzlich den dabei +verwendeten Konfigurationssnapshot. Damit bleiben ältere Importe erklärbar, +ohne eine zweite veränderbare Historientabelle einzuführen. + +### `ExternalImportBatch` + +- stabile UUID, `projectId`, `sourceId`, Importart und Zeitstempel; +- Dateiname, SHA-256 und zugehörige Projektrevision; +- verwendete monotone Konfigurationsversion und vollständiger + Konfigurationssnapshot; +- Originaldatei als Bytes; +- verlustarme logische Zellmatrix mit Zeilenklassen und Dialektmetadaten. + +Die Kombination aus Originalbytes und Matrix ist bewusst gewählt: Die Bytes +belegen den unveränderten Eingang, die Matrix erlaubt einen gezielten +Rückexport einzelner gemappter Objektzellen, ohne unbekannte Spalten, +Titelzeilen, Leerzeilen oder Summenzeilen neu zu interpretieren. + +### `ExternalRoomMapping` + +- stabile UUID, `sourceId` und normalisierter Quellraumschlüssel; +- Quellgeschoss-, Raumnummer- und Raumname-Snapshot; +- optionales `roomId`; +- optionale `defaultDistributionBoardId`. + +Das Mapping bleibt Teil der optionalen externen Integration. Dadurch erhält +das allgemeine Raummodell keine Revit-spezifische Pflichtbeziehung. + +### `ExternalModelObject` + +- stabile interne UUID, `projectId`, `sourceId` und unveränderte `ifcGuid`; +- letzter gesehener und letzter akzeptierter Importbatch; +- akzeptierte Quellwerte getrennt als strukturierter Snapshot; +- lokale Planungswerte für Anzeigename, Kategorie, Anschlussart, wirksame + Menge, Leistung je Einheit, Gleichzeitigkeitsfaktor, `cosPhi`, Kostengruppe + und Bemerkung; +- explizite Override-Metadaten; +- optionales `externalRoomMappingId`; +- optionale abweichende `distributionBoardId`; +- optionales `linkedProjectDeviceId`; +- optionales `circuitDeviceRowId`; +- Anwesenheitsstatus für bestätigte fehlende Objekte. + +Die n:1-Beziehung entsteht durch `circuitDeviceRowId` am Einzelobjekt: Viele +einzeln nachverfolgbare IFC-Objekte dürfen genau einer Gerätezeile zugeordnet +sein. Eine Mehrfachsteckdose bleibt ein einzelnes Objekt und trägt ihre +wirksame Menge größer eins. + +Konflikte werden soweit möglich aus akzeptiertem Quellstand, neuem +Vorschaustand und lokalen Overrides berechnet. Nur ein vom Nutzer bestätigter +Anwesenheits- oder Planungszustand wird persistiert. + +## Mengenmodell der Gerätezeile + +Die heutige `CircuitDeviceRow.quantity` unterscheidet nicht zwischen manueller +Menge und verknüpften IFC-Objekten. Ohne Erweiterung könnte das Lösen eines +Objekts manuelle Mengen löschen oder doppelt zählen. + +Vor Phase 14.3 wird deshalb `manualQuantity` ergänzt: + +```text +quantity = manualQuantity + + Summe(effectiveQuantity aller verknüpften ExternalModelObjects) +``` + +- Bei der Migration erhält jede bestehende Row + `manualQuantity = quantity`; ihr Ergebnis bleibt unverändert. +- Eine ausschließlich aus externen Objekten erstellte Row startet mit + `manualQuantity = 0`. +- `quantity` bleibt zunächst der materialisierte Gesamtwert für bestehende + Berechnungen, Filter und Exporte und wird im selben Command aktualisiert. +- Ein externes Objekt wird nie geteilt und kann höchstens einer Row zugeordnet + sein. +- Objekte dürfen nur aggregiert werden, wenn die rowbestimmenden lokalen Werte + übereinstimmen. Widersprüchliche Werte werden in der ersten Ausbaustufe nicht + automatisch vereinheitlicht, sondern benötigen getrennte Rows oder eine + ausdrückliche Nutzerentscheidung. +- Eine bestehende Row mit manueller Menge darf externe Objekte aufnehmen; beim + Lösen bleibt der manuelle Anteil erhalten. + +Für die UI vor Phase 14.3 bleibt noch festzulegen, ob eine nach dem Lösen leere +Row stehen bleibt oder nach gesonderter Bestätigung gelöscht wird. Ein stiller +Row-Lebenszyklus ist ausgeschlossen. + +## Command-Schnittstellen + +Alle Payloads tragen `schemaVersion: 1`, vollständige erwartete und gewünschte +Snapshots und werden mit der aktuellen Projektrevision geplant. Große +Importcommands dürfen umfangreich sein; sie müssen für Redo deterministisch +bleiben und dürfen spätere Quellstände nicht erneut auswerten. + +- `external-csv-configuration.update`: vollständige projektweite + Konfiguration ändern. +- `external-import.apply-initial`: Quelle, Batch, Raum-Mappings, externe + Objekte und bestätigte Links atomar einfügen. +- `external-import.apply-follow-up`: neuen Batch und die vollständigen + erwarteten/gewünschten Änderungen bestehender, neuer und fehlender Objekte + atomar übernehmen. +- `external-model-object.update-planning`: lokale Werte und Overrides eines + oder mehrerer Objekte ändern. +- `external-model-object.update-project-device-link`: ProjectDevice-Links + explizit setzen oder lösen, ohne das ProjectDevice zu verändern. +- `external-object.update-row-assignment`: Ein oder mehrere Objekte einer + bestehenden Row zuweisen, zwischen bestehenden Rows verschieben oder lösen + und alle betroffenen materialisierten Mengen atomar aktualisieren. +- `external-object.assign-to-new-row`: stabile neue Row einfügen, + Objekte verknüpfen und gegebenenfalls den Reserve-Status aktualisieren. +- `external-object.assign-to-new-circuit`: stabilen Circuit samt Schutz, + Row und Objektlinks in einem Schritt einfügen. Das geplante BMK wird im + Command gespeichert und bei Redo nicht neu berechnet. +- `external-model-object.delete-missing`: nur ausdrücklich bestätigte, + weiterhin unveränderte fehlende Objekte löschen. + +Die Erzeugung eines neuen `ProjectDevice` verwendet weiterhin den vorhandenen +`project-device.insert`-Command. Revit-Werte füllen lediglich das sichtbare +Formular vor; erst dessen Bestätigung erzeugt die Vorlage. CSV-Vorschau und +Rückexport sind reine Leseoperationen. Append-only Exportnachweise verändern +keine Projektrevision und laufen über einen eigenen Audit-Store. + +## Snapshot-, Transfer- und Migrationsfolgen + +- Phase 14.1 führt Migration `0002` für die Konfiguration ein und erhöht das + Project-State-Snapshot-Schema additiv von 2 auf 3. Der Upgrader von Version 2 + ergänzt `externalCsvConfiguration = null`. +- Phase 14.2 führt Migration `0003` für Quelle, Batches, Raum-Mappings und + Objekte ein und erhöht das Snapshot-Schema von 3 auf 4. Der Upgrader ergänzt + leere externe Collections. +- Phase 14.3 führt die additive Row-Spalte `manual_quantity` ein. Bestehende + Werte werden einmalig aus `quantity` übernommen. +- Snapshot-Capture und Restore erhalten Konfiguration, Quelle, bestätigte + Batches, Raum-Mappings und Objekte in expliziter FK-Reihenfolge. +- Beim Projektduplikat werden alle neuen internen UUIDs und internen Links + remappt. `IfcGUID`, Quellwerte, Transportmatrix und unbekannte CSV-Inhalte + bleiben unverändert. +- Der Transfer-Envelope kann Version 1 bleiben; die enthaltene + Project-State-Schema-Version wird additiv erhöht. +- Vorhandene Migrationen und Snapshot-Upgrader werden nicht editiert. + +## Implementierungsfolge + +### 14.1 – CSV-Konfiguration und reine Vorschau + +1. Transport-Domainverträge, Dialekt- und Mappingvalidatoren sowie kleine + synthetische Fixtures ergänzen. **Erledigt.** +2. Zustandsfreien Parser und Serializer mit Round-trip-Tests für UTF-8-BOM, + CRLF, Semikolon, vollständige Quotierung, Kopfzeile in Zeile 2 sowie + Titel-, Leer-, Objekt- und Passthrough-Zeilen implementieren. **Erledigt für + synthetische Testdaten; die Referenzdatei steht noch aus.** +3. Konfiguration über Migration, Snapshot v3, Transfer und den Command + `external-csv-configuration.update` persistieren. **Erledigt.** +4. Vorschau-Endpunkt und deutschen Projekt-Wizard ergänzen. **Erledigt:** + Konfigurations-Read/Write- und zustandsfreier Vorschau-Endpunkt sowie das + deutsche Konfigurations-/Vorschaumodal. Der Server speichert keinen Entwurf: Bei + Bestätigung wird die Datei erneut übertragen, erneut geparst und ihr Hash + gegen die Vorschau geprüft. + +**Phase 14.1 ist damit technisch abgeschlossen.** Die fachliche GUI-Abnahme +erfolgt vor Beginn der persistenten externen Objekte aus Phase 14.2. + +Abnahme: fokussierte Tests, vollständige Tests und alle vorgeschriebenen +Build-/Typecheck-Schritte. Die lokal bereitgestellte Referenz-CSV wird mit +`npm run revit:verify-reference` auf 897 Objektzeilen, 211 nichtleere +Passthrough-Summenzeilen und einen bytegleichen Round-trip geprüft. Da die +Referenzdatei reale Modelldaten enthalten kann, wird sie nicht automatisch in +einen Commit aufgenommen. + +### 14.2 – Persistente Objekte und Erstimport + +1. Schema, Repositories und reine Identitäts-/Matchingregeln ergänzen. + **Erledigt:** Migration `0003`, vollständiger externer Read-State sowie + exaktes IFCGUID-, Raum- und Familie-und-Typ-Matching sind vorhanden. Es gibt + weiterhin keinen Import-Write außerhalb eines Commands. +2. Snapshot v4, Restore und Projektduplikat samt UUID-Remapping ergänzen. + **Erledigt:** Version 3 wird mit leerem externem Zustand hochgestuft; + Capture, Restore, Undo/Redo und beide Transfermodi erhalten Originalbytes, + Matrix und sämtliche internen Links. Duplikate remappen alle internen UUIDs, + lassen IFCGUID und Quelltransport jedoch unverändert. +3. Erstimport-Command mit echten SQLite-Commit-/Rollback-Tests ergänzen. + **Erledigt:** `external-import.apply-initial` wechselt ausschließlich + zwischen leerem und vollständig bestätigtem externem Zustand. Er prüft + Konfigurationsversion, Original-Hash, erneut geparste Matrix, vollständige + IFCGUID-Menge, Quellwerte, explizite Overrides und projektinterne Links. + Der Command verbietet CircuitDeviceRow-Links, ist ein atomarer Undo-Schritt + und verwendet für Redo dieselben UUIDs und Bytes. Migration `0004` ergänzt + die zuvor noch fehlende monotone Konfigurationsversion am Batch; `0003` + bleibt unverändert. +4. Raum-, Verteilungs-, Klassifizierungs- und ProjectDevice-Schritte im Wizard + ergänzen; der Import selbst erzeugt keine CircuitDeviceRow. **Erledigt:** + Der zustandsfreie Planungs-Endpunkt liefert gruppierte Quellräume mit + exaktem Raumnummernvorschlag, Familie-und-Typ-Gruppen, Objektvorschläge, + Warnungszahlen sowie vorhandene Ebenen, Räume, Verteilungen und + ProjectDevices. Er blockiert nach einem bereits bestätigten Erstimport und + schreibt weder Entwurf noch Projektzustand. Der dedizierte + Endpunkt verlangt denselben Datei-Hash und Konfigurationsstand wie die + Planung, vollständige Entscheidungen für alle Quellräume und exakten + Familie-und-Typ-Gruppen und baut daraus serverseitig stabile UUIDs. Nicht + klassifizierte Familien blockieren. Raum-/Standardverteiler- und optionale + ProjectDevice-Links werden bestätigt, Stromkreis- und Row-Links bleiben + ausgeschlossen. Das breite Projektmodal zeigt Raumtreffer und Warnungen, + bietet die vorhandenen Raum-, Verteiler- und ProjectDevice-Kataloge an und + verlangt vor der atomaren Übernahme eine ausdrückliche Bestätigung. Fehlende + Räume und ProjectDevices lassen sich über die regulären, vorausgefüllten + Projektformulare anlegen und werden danach unmittelbar ausgewählt. Diese + Kataloganlagen bleiben eigenständige, rückgängig machbare Projektrevisionen. + +Vor Beginn werden die oben vorgeschlagenen Namen, die erneute Dateiübertragung +statt serverseitiger Entwürfe, die Konfigurationsversionierung und die +Kombination aus Originalbytes und Matrix als Entscheidungen bestätigt. + +### 14.3 – Editor und explizite Zuordnung + +1. `manualQuantity` und Mengeninvarianten migrieren und testen. + **Erledigt:** Migration `0005` übernimmt für jede bestehende Gerätezeile + `manualQuantity = quantity`. Neue normale Zeilen und Mengenänderungen führen + beide Werte gemeinsam; Snapshot/Transfer v5 erhält den Anteil und stuft v4 + verlustfrei hoch. Die reine Mengenregel validiert den materialisierten Wert + als manuellen Anteil plus Summe der unteilbaren externen Objektmengen. +2. Commands für vorhandene Row, neue Row, neuen Circuit und Lösen ergänzen. + **Teilweise erledigt:** `external-object.update-row-assignment` deckt + Zuweisung zu vorhandenen Rows, Verschieben zwischen vorhandenen Rows und + Lösen ab. Der Command prüft Projekt, Verteilung, Gruppenkategorie, Raum, + Selektionskennzeichen und Planungswerte, verlangt für bestätigbare + Planungsabweichungen eine explizite Objektliste und aktualisiert Links und + Gesamtmengen in einer SQLite-Transaktion. Seine exakte Gegenrichtung ist + dauerhaft Undo/Redo-fähig. Beim Lösen bleibt die Row mit ihrem manuellen + Mengenanteil bestehen. `external-object.assign-to-new-row` ergänzt die + Zuordnung ungebundener Objekte als neue Row in einem vorhandenen Circuit. + Diese Row erhält eine stabile ID und `manualQuantity = 0`; ihr historischer + Gegenbefehl entfernt sie nur, solange Row und Objektlinks vollständig + unverändert sind. Ein direktes Löschen über diesen internen Gegenbefehl ist + als Nutzeraktion gesperrt. `external-object.assign-to-new-circuit` schließt + den dritten Zielpfad: Ein serverseitig vorgeplanter Circuit mit festem BMK, + Standardschutz und genau einer externen Row wird gemeinsam mit den + Objektlinks eingefügt. Seine Historiengegenrichtung prüft den vollständigen + Circuit-Snapshot und die exakte Linkmenge, bevor sie den Teilbaum entfernt. + BMK und UUIDs bleiben bei Redo unverändert. Damit ist die persistente + Command-Grundlage dieses Schritts abgeschlossen; API-Planung und UI folgen. +3. Verteilungsbezogenen Drawer, Filter und Vorschau der Mengenwirkung ergänzen. + **Begonnen:** Die reine Read-Projektion und der projekt-/listenbezogene + GET-Endpunkt liefern ausschließlich Objekte des zugehörigen Verteilers, + unzugeordnete Objekte zuerst, einschließlich Quellraum, Selektionsmarker, + Planungswerten und aktuellem Row-Link. API-Client und DTOs sind vorhanden; + Drawer, Filter und Mengenwirkung folgen. +4. Einzel- und Mehrfach-Drag-and-drop samt Warnungen, Undo/Redo und Reload + testen. + +Vor Beginn werden Drawerposition, Verhalten widersprüchlicher Mehrfachauswahl, +Warnungsdialoge und der Lebenszyklus leerer Rows festgelegt. + +### 14.4 – Strukturtreuer Rückexport + +1. Exportprojektion gegen eine bekannte Projektrevision ergänzen. +2. Nur gemappte Objektzellen in einer Kopie der akzeptierten Matrix ersetzen. +3. Dialekt, Reihenfolge, unbekannte Zellen und Passthrough-Zeilen erhalten. +4. Download und append-only Exportnachweis ergänzen. + +Zahlenformat, leere Stromkreiswerte und Dateiname werden vorher fachlich +festgelegt. + +### 14.5 – Folgeimport und Konflikte + +1. Deterministischen Diff nach `(sourceId, ifcGuid)` ergänzen. +2. Neu, geändert, unverändert, fehlend und konfliktbehaftet projizieren. +3. Einzel- und Sammelentscheidungen im Wizard ergänzen. +4. Akzeptierten Diff als einen atomaren Command mit vollständigem Undo/Redo + übernehmen. + +### 14.6 – Härtung und End-to-End-Abnahme + +1. Alle Szenarien A bis G der verbindlichen Spezifikation automatisieren. +2. Referenzdatei über Vorschau, Erstimport, Zuordnung, Export, Folgeimport, + Snapshot/Restore und Projektduplikat prüfen. +3. Abfrageindizes und große Payloads mit mehreren tausend Objekten messen. +4. Architektur-, API-, Betriebs- und Nutzerdokumentation auf den tatsächlich + ausgelieferten Stand nachziehen. + +## Risiken und Schutzmaßnahmen + +- **Mengenverlust:** `manualQuantity` trennt manuelle und externe Anteile; + Commands ändern Links und materialisierte Menge gemeinsam. +- **Stilles Überschreiben:** Quellwerte, lokale Werte und Overrides sind + getrennt; jede Übernahme benötigt eine Nutzerentscheidung. +- **ProjectDevice-Verfälschung:** Links ändern niemals die kanonische Vorlage; + deren bestehende Commands bleiben alleinige Schreibgrenze. +- **Nicht reproduzierbarer Export:** Jeder Batch hält Originalbytes, Matrix, + Dialekt, Konfiguration, Hash und Projektrevision. +- **Sehr große Undo-Payloads:** Importcommands speichern vollständige + erwartete/Zielzustände. Größe und Transaktionsdauer werden in 14.2 gemessen, + nicht durch indirekte oder nachträglich neu berechnete Payloads optimiert. +- **BMK-Drift:** Neue BMKs werden einmal bei der Planung berechnet und im + Command gespeichert; Import, Sortierung und Redo nummerieren nie implizit. +- **Vertrauliche Referenzdaten:** Der Referenzprüfer läuft lokal gegen die + bereitgestellte CSV. Vor einer Aufnahme dieser Datei in Git ist gesondert zu + klären, ob sie ausreichend anonymisiert und zur Weitergabe freigegeben ist. + +## Freigabepunkt + +Mit der Freigabe dieses Audits beginnt Arbeitspaket 14.1.1: reine +Transportverträge, Validatoren und synthetische CSV-Fixtures. Dieses Paket +ändert weder Datenbank noch GUI und führt keine Projektschreibvorgänge aus. diff --git a/docs/spec/revit-excel-integration-requirements.md b/docs/spec/revit-excel-integration-requirements.md deleted file mode 100644 index effceb6..0000000 --- a/docs/spec/revit-excel-integration-requirements.md +++ /dev/null @@ -1,501 +0,0 @@ -# Revit-Integration über Linear-Excel – verbindliche Anforderungen - -Stand: 29.09.2026. Dieses Dokument ist die fachliche und technische -Arbeitsgrundlage für die neue Phase 14. Es ersetzt die frühere CSV-/IfcGUID- -Spezifikation. Der Umsetzungsstand steht im -[R0–R10-Plan](revit-excel-phase-14-plan.md); der geprüfte Ausgangszustand im -[R0-Audit](revit-excel-r0-audit.md). - -## 1. Ziel und Grenzen - -Der Austausch mit Revit erfolgt ausschließlich über den XLSX-Export/-Import -des Linear-Plugins. Eine vollständige Revit-Bauteilliste wird importiert, in -Leistungsbilanz geplant und mit gleichem Tabellenaufbau an Linear -zurückgegeben. Linear ordnet enthaltene Zeilen anhand der Worksharing-ID zu. - -Nicht Teil dieser Phase sind Dynamo, Revit-API, JSON-Transport, automatische -Stromkreisbildung, Übernahme vorhandener Revit-Stromkreiswerte, -Teilimporte, mehrere Modellquellen, PostgreSQL und neue Rollen/Rechte. - -Die Integration bleibt optional. Manuelle Projekte, Räume, ProjectDevices, -Stromkreise und Gerätezeilen funktionieren ohne externes Modell. Der -Circuit-First-Aufbau, stabile interne UUIDs und BMKs, ausdrückliche -Neunummerierung sowie die gemeinsame Project-Command-Transaktionsgrenze -bleiben unverändert. - -## 2. Verbindliche fachliche Regeln - -- Import erzeugt keine `CircuitDeviceRow`, keinen `Circuit` und kein BMK. -- Quellwerte, lokale Planungswerte und Overrides bleiben getrennt. -- Ein Folgeimport überschreibt keine lokale Planung still. -- Fehlende Objekte werden markiert und erst nach ausdrücklicher Bestätigung - entfernt. -- Mehrfachsteckdosen sind unteilbare externe Objekte. Ihre wirksame Menge kann - größer als eins sein. -- Die Row-Menge ist - `manualQuantity + Summe(effectiveQuantity der verknüpften Objekte)`. -- Nach einer Row-Zuordnung ist die `CircuitDeviceRow` die Planungsebene für - alle verknüpften Objekte. -- Bestehende ProjectDevices bleiben kanonische Vorlagen und werden durch - Importe nie verändert. -- Sortieren, Filtern, Importieren, Zuordnen und Verschieben nummeriert keine - Stromkreise automatisch neu. - -## 3. Linear-XLSX-Profil - -Die lokale Referenzdatei `docs/spec/kbp-Stromkreis.xlsx` enthält vertrauliche -Projektdaten. Sie wird nicht committed und nicht in Tests eingebettet. Tests -erzeugen synthetische Workbooks. Der lokale Referenzprüfer erhält den Pfad als -Argument. - -Beobachtetes Profil: - -- genau ein Arbeitsblatt; Blattname nach Excel-Regel maximal 31 Zeichen; -- Kopfzeile in Zeile 1, Zeile 2 leer, Daten ab Zeile 3, erste Datenspalte A; -- Spalte A `Worksharing-ID` im Format `-<8 Hex>`; -- Parameterbindungen stehen als klassische Excel-Kommentare in den übrigen - Kopfzellen; -- Zahlen sind typisierte Excel-Zahlen; importierte Werte bleiben unverändert, - fachlich verwendete Leistung wird auf 0,01 W projiziert; -- Objektzeilen dürfen keinen MEP-Raum besitzen; -- eine Schluss-/Summenzeile ohne ID kann vorkommen und wird weder importiert - noch zurückgegeben. - -Die Referenzdatei enthält 487 Objektzeilen, eindeutige Worksharing-IDs und -keine doppelten nichtleeren IfcGUIDs bei exaktem, case-sensitivem Vergleich. -Ihre Summenzeile steht in Spalte B (`CAx_Auswahlkenner`), während -`Familie und Typ` leer ist. - -### Zeilen ohne Worksharing-ID - -Nur eine Zeile ohne Worksharing-ID, aber mit befülltem Feld -`Familie und Typ`, gilt als verdächtige Objektzeile. Sie erzeugt einen Hinweis -und wird übersprungen; sie blockiert den Import nicht. Andere Zeilen ohne ID, -einschließlich einer nur in Spalte B befüllten Summenzeile, werden ohne Hinweis -übersprungen. Eine Objektzeile ist für den Import eine Zeile mit nichtleerer -Worksharing-ID. - -Worksharing-ID und IfcGUID werden stets exakt, ordinal und mit -Groß-/Kleinschreibung verglichen. Es findet kein Trimmen, Normalisieren oder -Case-Folding für die Identität statt. Eine nichtleere Worksharing-ID mit -unerlaubten äußeren Leerzeichen oder falschem Format blockiert. Doppelte -Worksharing-IDs blockieren. IfcGUID ist optional, kein Schlüssel und darf -doppelt vorkommen; Duplikate erzeugen lediglich einen Hinweis. - -## 4. Upload und Transportadapter - -Der Server akzeptiert ausschließlich Dateien mit Endung `.xlsx` bis 10 MiB. -`.xls` und `.xlsm` werden abgelehnt. Parsing findet serverseitig statt. Nach -dem Einlesen gelten feste Zeilen-, Spalten- und Zellgrenzen, die in R2 anhand -synthetischer Grenztests festgelegt und zentral definiert werden. Es gibt in -dieser Phase keinen eigenen ZIP-Prüfer und keinen Parser-Worker. - -Der Adapter unter `src/external-model/xlsx` liest eine transportneutrale -Zellmatrix. Eine Zelle ist `string`, `number`, `boolean` oder `empty`. -Zusätzlich werden Blattname, Originalzeilennummer, Kopfzeilenkommentare, -Spaltenbreiten und die für Hinweise nötigen Formelmetadaten erfasst. -Domain-Services kennen weder ExcelJS noch XLSX, React oder SQLite. - -Formeln werden niemals ausgeführt. Ist ein gecachter skalarer Wert vorhanden, -wird er verwendet und als Hinweis ausgewiesen. Fehlt er oder ist er ein -Fehlerwert, bleibt das Feld leer; bei der Worksharing-ID oder einem anderen -Pflichtfeld blockiert dies die betreffende Objektzeile beziehungsweise den -Import. - -Genau eine gepflegte Bibliothek wird ergänzt. Vorgesehen ist `exceljs`, sofern -R2 die Node-24-Verträglichkeit und den Roundtrip von Kopfkommentaren, -Blattname, Spaltenbreiten, Formaten und Zelltypen bestätigt. - -## 5. Projektkonfiguration - -Die Konfiguration ist projektweit, revisionssicher und besitzt keine eigene -Versionszählung. Jeder Plan und jedes Apply tragen `expectedRevision`. -Da die Projektrevision auch bei Undo/Redo strikt steigt, wird ein alter Plan -automatisch ungültig. Jeder Importbatch speichert eine vollständige Kopie der -beim Import verwendeten Konfiguration. - -Das Einstellungsmodal auf der Revit-Seite erkennt aus einer zustandslos -hochgeladenen Musterdatei Kopfzeile, erste Datenzeile und erste Datenspalte. -Diese Werte bleiben editierbar; Standard ist 1 / 3 / A. Es gibt nur ein Feld -für die Identitätsspalte: `columns.worksharingId`. Ein separates -`layout.idColumn` existiert nicht. - -Zielvertrag: - -```ts -interface ExternalModelConfiguration { - schemaVersion: 1; - layout: { - headerRow: number; - firstDataRow: number; - firstDataColumn: number; - }; - circuitMode: "combined" | "separate"; - columns: { - worksharingId: string; - ifcGuid: string | null; - roomNumber: string | null; - roomName: string | null; - familyAndType: string; - selectionMarker: string | null; - socketCount: string | null; - sourceRemark: string | null; - circuitCombined: string | null; - boardName: string | null; - circuitIdentifier: string | null; - designation: string | null; - electricalPowerW: string | null; - voltageV: string | null; - currentA: string | null; - }; - deviceTypes: DeviceTypeConfiguration[]; - familyTypeRules: FamilyTypeRule[]; -} -``` - -Standardzuordnung: - -| Schlüssel | Bedeutung | Standardspalte | -| --- | --- | --- | -| `worksharingId` | externe Identität, Pflicht | `Worksharing-ID` | -| `ifcGuid` | optionale Redundanz | `IfcGUID` | -| `roomNumber` | Raumnummer | `MEP-Raum: Nummer` | -| `roomName` | Raumname | `MEP-Raum: Name` | -| `familyAndType` | Familie und Typ, Pflicht | `Familie und Typ` | -| `selectionMarker` | CAx-Auswahlkenner | `CAx_Auswahlkenner` | -| `socketCount` | Anzahl Einzelsteckdosen | `CAX_AnzahlObjekte` | -| `sourceRemark` | Anmerkung | `CAx_Anmerkung` | -| `circuitCombined` | Stromkreis gesamt | `kbp_Stromkreisnummer` | -| `boardName` | Verteiler | `kbp-E-Verteiler` | -| `circuitIdentifier` | Stromkreis-BMK | `kbp-E-Stromkreis` | -| `designation` | Bezeichnung | `kbp-E-Bezeichnung` | -| `electricalPowerW` | elektrische Leistung [W] | `kbp-E-Elektrische Leistung` | -| `voltageV` | Spannung [V] | `kbp-E-Spannung` | -| `currentA` | Stromstärke [A] | `kbp-E-Stromstärke` | - -`worksharingId` und `familyAndType` sind Pflichtmappings. Im Modus -`combined` ist `circuitCombined` für den Rückexport Pflicht; im Modus -`separate` sind `boardName` und `circuitIdentifier` Pflicht. Fehlende optionale -Rückgabespalten `designation`, `electricalPowerW`, `voltageV` und `currentA` -werden mit Hinweis übersprungen und blockieren den Export nicht. - -Jedes interne Feld besitzt im Modal ein Dropdown aus den Kopfzellen und eine -freie Eingabe. Exakte kbp-Standardnamen werden vorbelegt. Typ und Einheit aus -dem Linear-Kommentar werden angezeigt. Nicht gemappte Spalten bleiben beim -Rückexport unverändert. - -## 6. Gerätearten und Familie-und-Typ-Regeln - -Eine Geräteart besitzt stabile interne UUID, Name, Kategorie -`lighting | single_phase | three_phase` sowie optionale Standardwerte für -Leistung je Einheit in W, GZF, cosPhi und Kostengruppe. Jede exakte -`Familie und Typ`-Regel verweist auf genau eine Geräteart und verwendet die -Mengenregel `1` oder `socketCount`. - -Mehrere Revit-Familien dürfen auf dieselbe Geräteart zeigen. Jedes Revit- -Objekt bleibt trotzdem einzeln über seine Worksharing-ID nachverfolgbar. -Unbekannte Familien müssen im Importwizard zugeordnet oder über eine neue -Geräteart klassifiziert werden; andernfalls blockiert Apply. - -Planungsstartwerte folgen dieser Reihenfolge: - -1. ausdrücklich verknüpftes ProjectDevice; -2. Geräteart-Standard; -3. leer. - -Der Anzeigename wird aus CAx-Auswahlkenner, dann Geräteartname, dann -`Familie und Typ` vorgeschlagen. Ein fehlender GZF wird mit `1` vorbelegt, -ohne zusätzliche Bestätigung. Standardwerte sind Startwerte, keine dauerhafte -Synchronisierung. - -## 7. Persistenter externer Zustand - -Pro Projekt existiert genau eine implizite Revit-XLSX-Quelle. Ein externes -Objekt besitzt eine interne UUID und ist je `(sourceId, worksharingId)` -eindeutig. `worksharingId` ist NOT NULL; `ifcGuid` ist nullable und nicht -eindeutig. Interne Relationen verwenden ausschließlich interne UUIDs. - -Gespeichert werden: - -- akzeptierte Quellwerte einschließlich aller Rückgabefelder; -- lokale Planungswerte und Override-Felder; -- Geräteart; -- optionales Raum-Mapping, abweichender Verteiler, ProjectDevice und - `CircuitDeviceRow`; -- Anwesenheitsstatus und Verweis auf den zuletzt relevanten Import; -- effektive Menge als fachlicher Wert des unteilbaren Objekts. - -Der effektive Verteiler eines verknüpften Objekts ist immer der Verteiler -seiner Row. Für ein unzugeordnetes Objekt gilt zuerst die explizite -Objektabweichung, danach der Standardverteiler seines Raum-Mappings. Ändert -sich der Standardverteiler eines Raums, betrifft das nur unzugeordnete -Objekte; verknüpfte Objekte bleiben über ihre Row unverändert und die Änderung -wird deshalb nicht gesperrt. - -## 8. Importbatch-Aufbewahrung, Snapshot und Transfer - -Der aktive Projektzustand enthält den letzten Importbatch vollständig: -Originalbytes, klassifizierte Matrix, Dateiname, SHA-256, Zeitpunkt, -Objektzahl, Importart, Projektrevision und Konfigurationskopie. Ältere Batches -werden zu Metadaten reduziert: Datum, Dateiname, SHA-256 und Objektzahl. -Sie enthalten keine Originalbytes, Matrix oder Konfigurationskopie mehr. - -Snapshot-Schema 10 und portabler Projekttransfer übernehmen genau diese -Aufteilung. Beim Duplizieren werden alle internen UUIDs und Links remapped; -Worksharing-IDs, optionale IfcGUIDs, Quellwerte und das letzte Workbook bleiben -unverändert. - -Versionen 1–9 ohne externe CSV-Daten werden verlustfrei auf Version 10 -hochgestuft. Enthält ein alter Stand eine CSV-Konfiguration oder einen nicht -leeren CSV-Zustand, wird er mit klarer deutscher Fehlermeldung abgelehnt. -Alte CSV-History-Commands werden ebenfalls vor jedem Write abgelehnt und nie -stillschweigend übersprungen. - -## 9. Erstimport - -Der Ablauf ist Upload → zustandslose Vorschau/Planung → erneute -Dateiübertragung bei Apply. Apply prüft SHA-256, `expectedRevision`, -Konfigurationskopie, Matrix und sämtliche Entscheidungen erneut. Nur Apply -liest die Excel-Datei erneut ein. - -Undo und Redo lesen keine Excel-Datei und parsen keine gespeicherten Bytes. -Sie arbeiten ausschließlich auf den im Command gespeicherten vollständigen -Vorher-/Nachher-Zuständen. Dadurch bleiben sie nach Neustart deterministisch -und unabhängig vom Parser. - -Der Wizard umfasst: - -1. Vorschau mit Objektzahl, übersprungenen und verdächtigen Zeilen, - doppelten Worksharing-IDs, doppelten IfcGUID-Hinweisen, unbekannten - Familien, nicht lesbaren Zahlen und Formeln; -2. Räume anlegen oder vorhandenen Räumen/Ebenen zuordnen; -3. Standardverteiler je Raum, Sammelzuordnung, Objektabweichungen und Objekte - ohne Raum; -4. Familien exakt Gerätearten und einer Mengenregel zuordnen; -5. optional vorhandene oder neu angelegte ProjectDevices verknüpfen; -6. Zusammenfassung und ausdrückliche Bestätigung. - -Die Übernahme ist ein atomarer Command und ein Undo-Schritt. Im Import -entstehen keine Rows. Neu angelegte Räume und ProjectDevices verwenden ihre -vorhandenen Commands und bleiben eigene Undo-Schritte. - -## 10. Objektplanung und Revit-Seite - -Route: `/projects/:projectId/revit`, erreichbar aus der Projektnavigation. -Der Revit-Button und das CSV-Modal auf der Projektübersicht entfallen. - -Die Seite besitzt: - -- Statuskarte mit letztem Import, Objektzahl, ohne Verteiler, ohne - Stromkreis, fehlend und Abweichung zu Revit; -- Aktionen `Import`, `Rückgabe-Excel`, `Einstellungen`; -- einklappbare Geräteart-/Familienregel-Übersicht; -- kompakte Objekttabelle mit Suche, Spaltenfiltern, Sortierung, - Mehrfachauswahl und Sammelzuordnung für Verteiler, ProjectDevice und - Planungswerte. - -Die kompakte Liste wird einmal geladen, vollständig im Client gefiltert und -sortiert und virtualisiert dargestellt. Es gibt keine Server-Pagination. -Originalbytes, Matrix und Command-Payloads gehören nicht in dieses DTO. - -Vor Row-Zuordnung lassen sich Leistung je Einheit, GZF, cosPhi, -Kostengruppe, Anzeigename und Bemerkung einzeln oder gesammelt ändern. -Geänderte Felder werden Overrides. Nach Row-Zuordnung werden diese Werte im -Grid an der Row bearbeitet. Beim ausdrücklichen Lösen erhält das Objekt die -aktuellen Row-Werte als Planungswerte und entsprechende Overrides. - -## 11. Editor-Zuordnung und Löschen - -Umsetzungsstand R7: Der Stromkreislisteneditor lädt die kompakte Projektliste -gemeinsam mit dem Baum, gruppiert unzugeordnete Objekte des aktuellen -Verteilers im Client und bietet Gruppen sowie einzelne Worksharing-IDs als -Drag-Quelle an. Drop auf Row, Circuit und freien Gruppenbereich verwendet die -drei persistenten Zuordnungscommands. Row-Badges zeigen die Linkzahl; Lösen -kopiert die aktuellen Row-Planungswerte als Overrides. Row-, Circuit- und -Gruppenlöschungen speichern die vollständigen Linkübergänge im Forward- und -Inverse-Command. Raum- und Verteilerlöschungen prüfen externe Referenzen -explizit. - -Der rechte, überlagernde Editorbereich zeigt unzugeordnete konfliktfreie -Objekte des aktuellen Verteilers. Gruppierungsschlüssel sind interner Raum, -Auswahlkenner, Geräteart, Kategorie, identische Planungswerte und kompatibler -ProjectDevice-Link. Die Anzeige nennt Summe der wirksamen Mengen und Zahl der -externen Objekte. Gruppen sind aufklappbar; Einzel- und Mehrfachauswahl sowie -Filter bleiben möglich. - -Drag-and-drop: - -- auf vorhandene Row: genau diese Row; -- auf Circuit: neue Row mit `manualQuantity = 0`; -- auf freien Bereich: neuer Circuit, Schutz und Row in einem Command. - -Neue IDs und BMK werden einmal geplant; Redo rechnet sie nicht neu. Neue Rows -übernehmen den bestätigten Gruppenzustand und die Summe der effektiven Mengen. -An Rows zeigt ein Hinweis die Zahl verknüpfter Revit-Objekte; einzelne Objekte -können ausdrücklich gelöst werden. - -Wird eine Row, ein Circuit oder eine Gruppe mit verknüpften Revit-Objekten -gelöscht, zeigt die UI vor Bestätigung: -`X Revit-Objekte werden wieder unzugeordnet`. Derselbe Löschcommand löst die -Objekte, entfernt die Struktur und speichert alle Links in seiner Inversen. -Undo stellt Struktur und Links exakt wieder her. Diese Löschungen werden nicht -gesperrt. - -Das Löschen eines Verteilers oder Raums mit referenzierten externen Objekten -bleibt gesperrt. Der Nutzer muss die Verknüpfungen beziehungsweise Zuordnungen -zuvor ausdrücklich ändern. Die Regel gilt auch für Unterbaum- und History- -Pfade. - -## 12. Rückgabe-Excel - -Umsetzungsstand R8: Die Revit-Objekttabelle bietet alle drei Rückgabeumfänge -an und lädt eine aus dem letzten vollständigen Import erzeugte XLSX herunter. -Die Serverprojektion verwendet für verknüpfte Objekte die aktuellen Row- und -Circuit-Werte, für freie Objekte die Planungswerte und schreibt Zahlen als -Excel-Zahlen. Hinweise zu nicht berechenbaren Werten und fehlenden optionalen -Spalten werden nach dem Download angezeigt. Der append-only Exportnachweis -liegt außerhalb von Projektrevision, Undo/Redo, Snapshots und Transfer. - -Der Export ist eine Leseoperation ohne Projektrevision. Ein append-only -Nachweis speichert Projektrevision, zugrunde liegenden letzten Import, -Zeitpunkt, Dateiname, SHA-256, Konfigurationskopie beziehungsweise ihren Hash -und Objektzahl. - -Umfang: - -- alle im letzten Import vorhandenen Objekte (Standard); -- nur Objekte mit Abweichung zum zuletzt importierten Revit-Wert; -- Auswahl aus der Objekttabelle. - -Die Rückgabe basiert auf einer Kopie des zuletzt importierten Workbooks. -Zeilen oberhalb der ersten Datenzeile, Kopfkommentare, Formate, -Spaltenbreiten, Blattname und Spaltenreihenfolge bleiben erhalten. Danach -folgen nur die gewählten Objektzeilen in ihrer Originalreihenfolge. Alle -Spalten bleiben enthalten; Summenzeilen entfallen. - -Stromkreiswerte: - -- `combined`: `DistributionBoard.name + Circuit.equipmentIdentifier`, ohne - Trennzeichen; -- `separate`: Verteilername und unverändertes BMK in getrennten Spalten; -- ohne Circuit: Stromkreisfeld beziehungsweise beide Felder leer. - -Die Wahl des Verteilerwerts liegt in genau einer Funktion und verwendet -zunächst `DistributionBoard.name`. - -Weitere Rückgabewerte: - -- Bezeichnung = Row-`displayName`, ohne Row Planungs-Anzeigename; -- Leistung [W] = effektive Menge × Einzelleistung, ohne GZF; -- Spannung = Circuit-Spannung, sonst Projektstandard der Kategorie; -- Strom = `P / (U × cosPhi)` beziehungsweise - `P / (sqrt(3) × U × cosPhi)`, auf 0,01 A; -- nicht berechenbar = leere Zelle plus Hinweis. - -Zahlen werden als Excel-Zahlen geschrieben. Fehlende optionale Zielspalten -werden mit Hinweis ausgelassen. Nur fehlende Stromkreisspalten des gewählten -Modus blockieren. Dateiname: -`_Revit-Rueckgabe_.xlsx`. - -## 13. Verbindliche R2-Abnahme mit Linear - -R2 endet mit einer Rückgabedatei, die aus der lokalen realen Musterdatei -erzeugt wurde und einige klar identifizierbare Rückgabewerte verändert. Diese -Datei wird nicht committed. Der Nutzer testet sie in Linear. R3 darf erst nach -erfolgreichem Linear-Rückimport beginnen. - -Die korrigierte R2-Rückgabedatei wurde am 30.09.2026 erfolgreich in Linear -eingelesen. Damit ist diese Abnahme erfüllt und R3 freigegeben. - -Scheitert der Linear-Import, wird vor R3 eine Alternative zur Freigabe -vorgelegt: Die Original-XLSX wird direkt auf OOXML-Ebene kopiert und nur die -erforderlichen Zellwerte/-typen sowie Zeilenbereiche angepasst. Die -Alternative bleibt hinter demselben transportneutralen Adaptervertrag. - -## 14. Folgeimport - -Jeder Import ist eine vollständige Projektbauteilliste. Matching erfolgt -ausschließlich über exakt und case-sensitiv verglichene Worksharing-ID. - -- neu: Wizard-Schritte nur für neue Objekte und unbekannte Familien; -- geänderte Quellwerte: Einzel- oder Sammelentscheidung; -- akzeptierte Mengenänderung: verknüpfte Row-Menge im selben Command; -- fehlend: markieren, Link und Menge zunächst beibehalten; -- Löschen: erst nach gesonderter Bestätigung; -- abweichende Rückgabefelder: Hinweis `in Revit noch nicht aktualisiert`, - keine Übernahmeentscheidung. - -`external-import.apply-follow-up` ist atomar und ein Undo-Schritt. -Unveränderte Objekte erzeugen keine unnötigen Objekt- oder Row-Änderungen. -Der neue vollständige Batch wird letzter Batch; der zuvor letzte Batch wird -auf Metadaten reduziert. - -Umsetzungsstand R9: Der sechsstufige Folgeimportwizard, die erneute -Apply-Prüfung, die getrennte Rückgabeabweichungsanzeige und der atomare -`external-import.apply-follow-up`-Command sind umgesetzt. Akzeptierte -Mengenänderungen aktualisieren verknüpfte Row-Summen im selben Command. -Fehlende Objekte bleiben zunächst samt Link und Menge erhalten und erscheinen -in der virtuellen Objekttabelle als `fehlend`. Ihre gesondert bestätigte -Löschung verwendet `external-model-object.delete-missing`; Undo stellt -Objekte, Links und Row-Mengen exakt wieder her. - -## 15. Commands, Persistenz und Sicherheit - -Projektbezogene Writes verwenden typisierte Commands mit vollständiger -Gegenrichtung, `expectedRevision`, Anmeldung, CSRF-Header und -`project-command-transaction.persistence.ts`. Dazu gehören mindestens: - -- `external-model-configuration.update`; -- `external-import.apply-initial`; -- `external-import.apply-follow-up`; -- `external-model-object.update-planning`; -- `external-model-object.update-distribution-board`; -- `external-model-room-mapping.update`; -- `external-model-object.update-project-device-link`; -- `external-object.update-row-assignment`; -- `external-object.assign-to-new-row`; -- `external-object.assign-to-new-circuit`; -- `external-model-object.delete-missing`; -- die erweiterten Row-/Circuit-/Gruppen-Löschcommands mit Objekt-Link- - Transitionen. - -Die Konfiguration selbst ist Teil der erwarteten/gewünschten Snapshots, aber -hat keinen eigenen monotonen Zähler. Importbatches halten eine unveränderliche -Konfigurationskopie. Preview/Plan sind zustandslos. Apply überträgt und parst -die Datei erneut; Undo/Redo führt nur gespeicherte Zustandsübergänge aus. - -Neue Migrationen sind additiv. Vor Anwendung wird die Datenbank gesichert und -das generierte SQL geprüft. Da nur Entwicklungsdaten existieren, darf die -Migration alte externe CSV-Daten verwerfen. Vor dem Löschen externer Objekte -werden betroffene Row-Mengen auf `manualQuantity` zurückgesetzt. Der Verlust -des alten externen Entwicklungszustands wird dokumentiert. - -## 16. Abnahme und Leistung - -Die Oberfläche muss mehrere Tausend Objekte flüssig bedienen. R10 misst -Import, Command-/Snapshot-Größe, Speicherbedarf und Client-Interaktion mit -synthetischen großen Workbooks. Die virtualisierte Tabelle rendert nur den -sichtbaren Ausschnitt, während Filterung, Sortierung und Auswahl auf der einmal -geladenen kompakten Liste arbeiten. - -Umsetzungsstand R10: Die vollständige Kette ist mit dateibasierter SQLite- -Persistenz und Neustart getestet. Der synthetische Lasttest verarbeitet 5.000 -Objekte, misst Transport, Planung, Transaktionen, Command-/Snapshotgröße, -Heap und Clientprojektion und prüft Restore sowie Projektduplikat. Große -Zustandsersetzungen verwenden begrenzte Insertblöcke innerhalb derselben -atomaren Transaktion. Die Ergebnisse sind in der -[R10-Abnahme](revit-excel-r10-validation.md) dokumentiert. - -Jedes Paket R1–R10 führt fokussierte Tests sowie aus: - -```text -npm test -npm run build:api -npm run build:web -npm run typecheck:scripts -npx tsc --noEmit -p tsconfig.next.json -``` - -Jedes Paket erhält einen eigenen knappen imperativen Commit. Die konkrete -Paketfolge und ihre Freigabepunkte stehen im -[R0–R10-Plan](revit-excel-phase-14-plan.md). diff --git a/docs/spec/revit-excel-phase-14-plan.md b/docs/spec/revit-excel-phase-14-plan.md deleted file mode 100644 index 5039852..0000000 --- a/docs/spec/revit-excel-phase-14-plan.md +++ /dev/null @@ -1,237 +0,0 @@ -# Phase 14 neu – Plan für die Linear-Excel-Anbindung - -Verbindliche Fachgrundlage: -[Revit-Integration über Linear-Excel](revit-excel-integration-requirements.md). -Der alte CSV-Plan 14.0–14.6 ist abgelöst und wird nicht fortgeschrieben. - -## Status - -| Paket | Status | Ergebnis / Freigabepunkt | -| --- | --- | --- | -| R0 | abgeschlossen und freigegeben | Bestandsaudit, Zielmodell, Migration und Risiken; Freigabekorrekturen in R1 eingearbeitet. | -| R1 | abgeschlossen | Anforderungen, Plan und Architektur auf Excel/Worksharing-ID umgestellt; alle Pflichtprüfungen bestanden. | -| R2 | abgeschlossen und freigegeben | XLSX-Adapter, Parser, synthetische Fixtures, lokaler Referenzprüfer und reale Rückgabedatei sind erstellt; der korrigierte Rückimport wurde am 30.09.2026 erfolgreich in Linear getestet. | -| R3 | abgeschlossen | Konfiguration ohne eigene Revision, Worksharing-ID-Datenmodell, Migration 0014, Snapshot 10, Transfer und Backend-CSV-Entfernung sind umgesetzt und geprüft. | -| R4 | abgeschlossen | Revit-Seite, Navigation und revisionierte XLSX-Einstellungen mit Musterdateiprüfung sind umgesetzt; das alte Projektseitenmodal ist entfernt. | -| R5 | abgeschlossen | Zustandslose XLSX-Vorschau, sechsstufiger Erstimportwizard und atomarer Importcommand mit parserfreiem Undo/Redo. | -| R6 | abgeschlossen | Projektweite kompakte Objektliste, clientseitige Filter/Sortierung, Virtualisierung und revisionierte Sammeländerungen. | -| R7 | abgeschlossen | Gruppierter Editorbereich, drei Drag-and-drop-Ziele, Row-Indikator, ausdrückliches Lösen und atomare Löschübergänge mit exaktem Undo/Redo. | -| R8 | abgeschlossen | Rückgabe-Excel für alle, abweichende oder ausgewählte Objekte und append-only Exportnachweis sind umgesetzt. | -| R9 | abgeschlossen | Vollständiger Folgeimport nach exakter Worksharing-ID mit Quellentscheidungen, fehlenden Objekten, bestätigtem Löschen und persistentem Undo/Redo. | -| R10 | abgeschlossen | Ende-zu-Ende-Kette, 5.000-Objekte-Lasttest, gebatchte Zustandspersistenz und Abschlussdokumentation. | - -## R0 – Audit - -Ergebnis: [R0-Audit](revit-excel-r0-audit.md). Die Freigabe vom 29.09.2026 -enthält 13 Korrekturen. Bei Abweichungen zwischen dem historischen Audit und -der aktuellen Anforderung gilt das neue Anforderungsdokument. - -## R1 – Dokumentation - -Lieferumfang: - -- neues verbindliches Excel-Anforderungsdokument; -- dieser R0–R10-Plan; -- alte CSV-Anforderungen und alter Plan als kurze Ablösungshinweise; -- LLM-Kontext auf die neue Quelle der Wahrheit kürzen; -- `AGENTS.md`, aktuelle Architektur, History-/External-Model-Architektur, - Roadmap, README, Dokumentationsindex und bekannte Einschränkungen anpassen; -- reale Musterdatei per `.gitignore` vom Commit ausschließen; -- alle internen Links auf die neuen Dokumente umstellen. - -Keine Laufzeit-, Schema- oder UI-Änderung. Abnahme: keine aktive Dokumentation -nennt CSV/IfcGUID als künftigen Transport beziehungsweise Schlüssel; der -aktuell noch vorhandene Legacy-Code bleibt als solcher klar benannt. - -## R2 – XLSX-Transportadapter - -Dateien/Module: neues `src/external-model/xlsx`, synthetische Testfixtures und -ein auf XLSX umgestellter Referenzprüfer mit Dateipfadargument. Eine neue -direkte Bibliothek (`exceljs`, vorbehaltlich der Tests), keine DB-Änderung. - -Abnahme: - -- Kopfzeilenkommentare, Blattname, Spaltenbreiten, Formate und Zelltypen - überleben einen strukturellen Roundtrip; -- erste Datenzeile/-spalte und Mappings funktionieren ohne separates - `layout.idColumn`; -- Worksharing-ID/IfcGUID werden exakt und case-sensitiv behandelt; -- Zeile ohne ID und ohne `Familie und Typ` wird übersprungen, die Muster- - Summenzeile B490 blockiert nicht; -- Zeile ohne ID mit `Familie und Typ` erzeugt Hinweis und wird übersprungen; -- maximal 10 MiB, nur `.xlsx`, Zeilen-/Spaltengrenzen nach dem Einlesen; -- keine Formelausführung; -- lokale Referenzprüfung bestätigt 487 Objekte und keine ID-Duplikate; -- aus der realen Musterdatei entsteht lokal eine nicht versionierte - Rückgabedatei mit einigen geänderten Werten. - -Danach stoppt die Arbeit. Der Nutzer testet diese Datei in Linear. Erst sein -erfolgreicher Rückimport gibt R3 frei. Scheitert er, wird vor R3 ein konkreter -OOXML-Patchadapter vorgeschlagen, der das Originalworkbook direkt ändert. - -Implementierungsstand vom 30.09.2026: Der Adapter liegt unter -`src/external-model/xlsx`, der Referenzprüfer unter -`scripts/verify-revit-reference-xlsx.ts`. Er hat aus der lokalen Musterdatei -die ignorierte Datei -`data/revit-reference/kbp-Stromkreis-R2-Rueckgabe.xlsx` erzeugt. Die Datei -enthält 487 Objektzeilen in Originalreihenfolge, keine Summenzeile und gezielte -Änderungen an den ersten drei Objekten. Synthetische Tests decken Zelltypen, -Zahlenformate, Formelergebnisse, Kommentare, Breiten, Auswahl, exakte -ID-Vergleiche und Grenzen ab. - -Für den Adapter ist `exceljs@4.4.0` als direkte Abhängigkeit aufgenommen. Der -Produktionsaudit meldet dafür ausschließlich `uuid@8.3.2`: Die gemeldete -Schwachstelle betrifft die UUID-Funktionen v3/v5 mit übergebenem Puffer; -ExcelJS verwendet die Abhängigkeit nur für UUID v4 bei erweiterten bedingten -Formatierungen. Dieser Adapter ruft keine UUID-Funktion auf. Weitere gemeldete -Auditbefunde gehören zu bereits vorhandenen Abhängigkeiten und werden nicht im -fachlich begrenzten R2-Paket aktualisiert. - -## R3 – Datenmodell und Backend-Cutover - -- Konfiguration ohne eigene Versionszählung; -- `worksharing_id NOT NULL`, Unique je Quelle; `ifc_guid` nullable ohne Unique; -- additive Migration nach vorherigem DB-Backup; alte externe Entwicklungsdaten - verwerfen und Row-Mengen vorher auf `manualQuantity` zurücksetzen; -- Batch-Aufbewahrung: nur letzter Batch vollständig, ältere nur Metadaten; -- Snapshot 10, Restore und Transfer; alte CSV-Zustände/History klar ablehnen; -- Backend-CSV-Parser, Endpunkte und Verträge entfernen; -- Apply parst erneut; Undo/Redo verwenden ausschließlich gespeicherte - Vorher-/Nachher-Zustände. - -Risiken: Migration mit verknüpften Row-Mengen, alte History-Spitzen und -vollständiges UUID-Remapping. Pflicht: echte SQLite-Commit-/Rollback-Tests. - -## R4 – Revit-Seite und Einstellungen - -- Route `/projects/:projectId/revit` und Navigationseintrag; -- Status-/Aktionsgrundgerüst; -- Einstellungsmodal mit Musterdateierkennung, Layout und Feldzuordnung; -- Stromkreismodus `combined | separate`; -- Projektseiten-Button und `revit-csv-modal.tsx` entfernen; -- nur deutsche UI-Texte und bestehende Icon-/Kartenregeln. - -## R5 – Erstimport - -- Vorschau und Plan mit erneuter Dateiübertragung beim Apply; -- Räume, Verteiler, Gerätearten, exakte Familienregeln und optionale - ProjectDevices; -- fehlender GZF als sichtbarer Startwert `1`, ohne Zusatzbestätigung; -- Warn-/Überspringregel für ID-lose Zeilen; -- ein atomarer Importcommand, keine Row-/Circuit-Erzeugung; -- Undo/Redo aus Commandzuständen ohne Workbook-Parsing. - -Implementierungsstand vom 30.09.2026: Vorschau und Apply verwenden die -projektweite XLSX-Konfiguration; Apply überträgt und parst die Datei erneut und -vergleicht den SHA-256 der Vorschau. Der Wizard führt über Vorschau, Räume, -Standardverteiler einschließlich Objekten ohne Raum, exakte Familienregeln, -optionale ProjectDevices und Bestätigung. Unbekannte Familien können als -Geräteart mit stabilen Client-UUIDs und sichtbarem GZF-Startwert 1 klassifiziert -werden. `external-model.apply-initial-import` schreibt Konfiguration, Quelle, -vollständigen letzten Batch, Raumzuordnungen und Objekte in einer Revision; -alle `circuitDeviceRowId` bleiben `null`. Seine Inverse speichert beide -Zustände vollständig, sodass Undo/Redo weder Datei noch Parser benötigen. - -## R6 – Objekttabelle und Sammelaktionen - -- kompakte Objektliste einmal laden; -- clientseitig suchen, filtern und sortieren; -- virtualisierte Darstellung ohne Server-Pagination; -- stabile Mehrfachauswahl und Sammelaktionen für Verteiler, ProjectDevice und - Objektplanungswerte; -- Standardverteileränderung wirkt nur auf unzugeordnete Objekte; verknüpfte - Objekte folgen unverändert ihrer Row. - -Implementierungsstand vom 30.09.2026: Der projektweite GET-Endpunkt liefert -eine kompakte Liste ohne Batchbytes, Matrix oder Pagination. Die Revit-Seite -sucht, filtert und sortiert vollständig im Client und rendert nur den -sichtbaren Ausschnitt. Eine stabile Mehrfachauswahl ändert Verteiler, -ProjectDevice, Leistung und GZF in einem persistenten -`external-object.update-planning`-Command. Verknüpfte Objekte sind für diese -Sammelaktionen gesperrt und folgen weiterhin ausschließlich ihrer Row. - -## R7 – Stromkreislisteneditor - -- gruppierter rechter Revit-Bereich mit Anzahl-Badge; -- Drop auf Row, Circuit oder freien Bereich über vorhandene, angepasste - Commands; -- Row-Indikator, Objektanzeige und Lösen mit Übernahme aktueller Row-Werte; -- Row-/Circuit-/Gruppen-Löschcommands lösen verknüpfte Objekte atomar und - zeigen `X Revit-Objekte werden wieder unzugeordnet`; -- Undo stellt Objektlinks exakt wieder her; -- nur Raum-/Verteilerlöschung mit externen Referenzen bleibt gesperrt. - -## R8 – Rückgabe-Excel - -- alle / abweichende / ausgewählte Objekte; -- zuletzt importiertes Workbook als strukturelle Grundlage; -- Stromkreisfelder des gewählten Modus sind Pflicht; -- fehlende optionale Bezeichnung-/Leistung-/Spannung-/Stromspalten nur als - Hinweis überspringen; -- typisierte Zahlen, gemeinsame Export-/Abweichungsprojektion; -- append-only Exportnachweis ohne Projektrevision. - -R8 baut auf der in R2 durch Linear bestätigten Transportstrategie auf. - -Umsetzungsstand: Die Revit-Objekttabelle erzeugt die Rückgabe revisionssicher -aus dem letzten vollständigen Import. Die gemeinsame Projektion berechnet -Stromkreis, Bezeichnung, Leistung, Spannung und Strom; der XLSX-Adapter erhält -Struktur und Formate und meldet fehlende optionale Spalten. Jeder erfolgreiche -Download wird außerhalb von Projektcommands, Snapshots und Transfers mit -Revision, Importbatch, Konfigurationskopie und Prüfsummen protokolliert. - -## R9 – Folgeimport - -- exaktes, case-sensitives Matching nach Worksharing-ID; -- neu, geändert, unverändert, fehlend und Rückgabefeldabweichungen; -- Entscheidungen nur für fachliche Quelländerungen; -- akzeptierte Mengenänderungen und Row-Summen atomar; -- fehlende Objekte nicht automatisch lösen oder löschen; -- neuer letzter Vollbatch, vorheriger Batch auf Metadaten reduzieren; -- ein persistenter Undo-Schritt ohne Excel-Parsing bei Undo/Redo. - -Umsetzungsstand vom 30.09.2026: Vorschau und Apply klassifizieren die vollständige -XLSX nach exakter Worksharing-ID als neu, geändert, unverändert oder fehlend -und weisen Rückgabefeldabweichungen getrennt aus. Der Wizard fordert -Entscheidungen nur für fachliche Quelländerungen an. Apply überträgt und parst -die Datei erneut, aktualisiert akzeptierte Mengen samt verknüpfter Row-Summe -atomar und speichert den neuen Vollbatch; alle älteren Batches werden auf ihre -Metadaten reduziert. Fehlende Objekte behalten zunächst Link und Menge. Eine -gesondert bestätigte Aktion kann sie anschließend mit passender -Row-Mengenänderung löschen. Beide Commands besitzen vollständige Inversen; -Undo/Redo liest keine XLSX-Datei. - -## R10 – Härtung - -Ende-zu-Ende-Test: - -```text -Import → Objektplanung → Row-Zuordnung → Rückgabe → Folgeimport - → Snapshot/Restore → Projektduplikat → Undo/Redo nach Neustart -``` - -Zusätzlich: mehrere Tausend synthetische Objekte, virtualisierte UI, -Speicher-/Payload-/Transaktionsmessungen, Löschwarnungen samt Link-Inversen, -alte CSV-Ablehnungen und Dokumentation auf den ausgelieferten Stand. - -Umsetzungsstand vom 30.09.2026: Der dateibasierte Integrationstest deckt die -vollständige Kette bis zu Undo/Redo nach einem Datenbankneustart ab. Ein -synthetisches Workbook mit 5.000 Objekten durchläuft Erst- und Folgeimport, -Snapshot-Restore, Projektduplikat sowie die extrahierte Clientfilter- und -Virtualisierungslogik. Die dabei gefundene SQLite-Grenze ungebatchter Inserts -ist für alle vollständigen External-Model-Zustandspfade behoben. Messwerte und -Abnahme stehen in [R10-Abnahme](revit-excel-r10-validation.md). Phase 14 ist -damit abgeschlossen. - -## Pflichtprüfungen je Paket R1–R10 - -```text -fokussierte Tests -npm test -npm run build:api -npm run build:web -npm run typecheck:scripts -npx tsc --noEmit -p tsconfig.next.json -``` - -Jedes Paket wird mit einer knappen imperativen Commit-Message abgeschlossen. diff --git a/docs/spec/revit-excel-r0-audit.md b/docs/spec/revit-excel-r0-audit.md deleted file mode 100644 index 84acc5a..0000000 --- a/docs/spec/revit-excel-r0-audit.md +++ /dev/null @@ -1,528 +0,0 @@ -# R0 – Audit der Linear-Excel-Anbindung - -Stand: 29.09.2026. Geprüfter Code: `cf022b2`. - -**Status: R0 abgeschlossen und mit Korrekturen für R1 freigegeben.** Dieser Bericht -ist ein Umsetzungsvorschlag, kein Nachweis einer bereits implementierten -Excel-Anbindung. Der neue Nutzerauftrag ersetzt die CSV-/IfcGUID-Vorgaben und -die alte Phasenliste 14.0–14.6. R1 bereinigt die bestehenden Dokumente; R0 -ändert weder Laufzeitcode noch Datenbank noch Oberfläche. - -Die 13 Freigabekorrekturen vom 29.09.2026 sind in den -[verbindlichen Anforderungen](revit-excel-integration-requirements.md) und im -[R0–R10-Plan](revit-excel-phase-14-plan.md) eingearbeitet. Bei Abweichungen -gelten diese beiden R1-Dokumente. - -## 1. Geprüfter Bestand und Keep/Change/Remove - -Gelesene Grundlagen: `AGENTS.md`, `docs/current-architecture.md`, -`docs/project-history-and-external-model-architecture.md`, -`docs/spec/revit-csv-integration-requirements.md` und -`docs/spec/revit-csv-phase-14-audit-and-plan.md`. Der alte Plan widerspricht -sich bereits intern: Sein Status nennt die Erstübernahme noch nicht vorhanden, -während Implementierung und Tests sie nachweisen. Alte Erledigt-Markierungen -werden deshalb nicht übernommen. - -| Bereich / Codebeleg | Entscheidung | Begründung und Änderung | -| --- | --- | --- | -| `src/db/repositories/project-command-transaction.persistence.ts` | Keep | Eine Grenze für Fachänderung, Inverse, Revision und History; auch automatische Snapshots bleiben darin. | -| `src/db/repositories/external-model-state.repository.ts`, `src/db/schema/external-*.ts` | Change | Quelle, Batches, Raum-Mappings und Objekte wiederverwenden; neue Identität, Konfiguration und typisierte Matrix. Schlanke Objekt-Reads von großen Batch-Blobs trennen. | -| `src/domain/models/external-initial-import-project-command.model.ts`, zugehöriger Store | Change | Vollständiger erwarteter/Zielzustand und Row-freier Import bleiben; Worksharing-ID, Gerätearten und atomare Regelübernahme ergänzen. | -| `src/external-model/application/external-initial-import-plan.ts`, `external-initial-import-target.ts` | Change | Raumvorschläge, Kataloge, vollständige Entscheidungen und stabile UUIDs behalten. Objektentscheidungen und Gerätearten ergänzen. | -| `src/db/repositories/external-object-assignment.persistence.ts` und drei Zuordnungs-Stores | Change | Mengeninvariante und exakte Inversen behalten; Geräteart, effektiven Verteiler, Anwesenheit und Übernahme der Row-Werte beim Lösen ergänzen. | -| `CircuitDeviceRow.manualQuantity`, bestehende Mengenprüfungen | Keep | `quantity = manualQuantity + Summe(externer effektiver Mengen)`; Mehrfachsteckdosen bleiben unteilbar. | -| `src/external-model/application/external-circuit-list-objects.ts` | Change | Listen-/Projektprüfung behalten; vollständige Planungswerte, Geräteart, effektiver Verteiler, Status und Row-Anzahlen liefern. | -| `src/domain/models/project-state-snapshot.model.ts`, Snapshot-Persistenz und Transfer | Change | Schema 10; historische CSV-Zustände ausdrücklich ablehnen; alle neuen internen Referenzen remappen. | -| `src/external-model/csv/*`, CSV-Preview, CSV-Validierungen und Controller | Remove/replace | XLSX ersetzt CSV vollständig; kein zweiter aktiver Transportpfad. | -| `src/frontend/components/revit-csv-modal.tsx`, Einbindung auf Projektseite | Remove/replace | Eigene Revit-Seite; Einstellungen nur im Modal, Import in eigenem Wizard. | -| `src/frontend/components/Sidebar.tsx`, `src/frontend/utils/api.ts`, `src/frontend/types.ts` | Change | Route `revit`, neue DTOs und Endpunkte, CSV-Imports entfernen. | -| `src/frontend/components/circuit-tree-editor.tsx`, Grid-Drop-/Projektionsmodule | Change | Separater externer Drag-Payload; Row-, Circuit- und Freiplatz-Ziele bewusst unterscheiden. Bestehende Grid-Bedienung behalten. | -| Raum-/ProjectDevice-Formulare und Commands | Keep | Sichtbar vorbelegte, ausdrücklich bestätigte Anlage als eigener Undo-Schritt. | -| `scripts/verify-revit-reference-csv.ts`, Transporttests | Replace | Pfadargument für lokalen XLSX-Prüfer; ausschließlich synthetische Workbooks in Tests. | - -### Konkrete Lücken gegenüber dem Auftrag - -- `external-model-contracts.ts` importiert heute CSV-Verträge. Die neutralen - Konfigurations-/Matrixverträge gehören künftig in `external-model/domain`; - nur `external-model/xlsx` darf ExcelJS kennen. -- `ifc_guid` ist derzeit NOT NULL und je Quelle eindeutig; Matching, - Snapshots, DTOs und Commands setzen diese Identität voraus. -- `internalDeviceType` ist derzeit ein freier String in Planungswerten. - Es gibt keinen Geräteart-Katalog mit stabilen IDs und Standardwerten. -- Der Erstimport setzt den ProjectDevice-Link, verwendet im Target aber - weiterhin `suggestedPlanningValues`. Die neue Priorität ProjectDevice vor - Geräteart muss ausdrücklich implementiert werden; ein Link allein genügt - nicht. Revit-Leistung wird künftig nicht automatisch zum Planungswert. -- Der Import-Target setzt `distributionBoardId = null`; die Raumvorgabe liegt - separat im Mapping. Projektion und Zuordnungsprüfung vergleichen heute - direkt das Objektfeld. Eine zentrale Auflösung des effektiven Verteilers - fehlt und ist vor der Editor-Nutzung erforderlich. -- Die bisherige Row-Zuordnung darf laut Validator am Objekt ausschließlich - `circuitDeviceRowId` ändern; der Store schreibt auch nur dieses Feld. - Lösen mit aktuellen Row-Planungswerten benötigt eine neue Command-Version. -- Die Kompatibilitätsprüfung vergleicht Raum, Kategorie, Auswahlkenner und - Planungswerte, aber keine stabile Geräteart. Unterschiedliche Gerätearten - dürfen nicht versehentlich in dieselbe Row aggregiert werden. -- Rows speichern `powerPerUnit` in **kW**, externe Planung - `powerPerUnitW` in **W**. Eine zentrale bidirektionale Konvertierung ist - nötig; Exportleistung darf nicht um Faktor 1000 falsch sein. -- Externe FKs auf Row, ProjectDevice, Raum-Mapping und Verteiler verwenden - teilweise `ON DELETE SET NULL`. Bestehende allgemeine Löschpfade sichern - externe Objektübergänge nicht durchgängig in ihren Inversen. Auch - Unterbaum-/History-Löschungen müssen abgesichert werden. -- Ein Editor-Drawer, projektweite Objekttabelle, Exportnachweis und - ausführbarer Folgeimport fehlen. `follow_up` als vorhandener Enumwert ist - kein implementierter Folgeimport. -- Konfigurationsversionen steigen heute nur bei normalen Updates gegenüber - dem aktuellen Wert; Undo setzt alte Versionen zurück. Für eine tatsächlich - monotone Generation muss diese Semantik korrigiert werden. -- XLSX-Parsing ist asynchron. Das heutige erneute synchrone CSV-Parsing - innerhalb der SQLite-Transaktion darf nicht einfach durch `await` ersetzt - werden. - -## 2. Prüfung der lokalen Musterdatei - -`docs/spec/kbp-Stromkreis.xlsx` wurde ausschließlich lesend auf ZIP-/OOXML- -Ebene untersucht; keine Inhalte wurden hochgeladen oder in Fixtures kopiert. -Die Datei ist unversioniert und darf nicht committed werden. - -| Befund | Ergebnis | -| --- | --- | -| Dateigröße / entpackte ZIP-Einträge | 56.765 / 337.740 Bytes | -| Arbeitsblätter / Blattnamenlänge | 1 / 31 Zeichen | -| Zellbereich | A1:O490 | -| Kopfzeile / Leerzeile / Objekte / Abschluss | 1 / 2 / 3–489 / 490 | -| Objektidentitäten | 487 syntaktisch passende Worksharing-IDs, keine Duplikate | -| Kopfzeilenkommentare | 14, zu den 14 Spalten nach der ID-Spalte | -| Fehlende Raumangaben | 67 Objekte ohne Raumnummer und Raumname | -| IfcGUID-Duplikate | Keine bei exaktem, case-sensitivem Vergleich | -| Formeln | Keine; synthetische Tests dafür erforderlich | -| Spaltendefinitionen | 16, obwohl nur 15 Datenspalten vorhanden sind | - -Das beobachtete Profil aus dem Auftrag wird damit bestätigt. Zusätzliche -Spaltenformatdefinitionen dürfen beim Export nicht auf die gemappten Spalten -gekürzt werden. Das Muster enthält die neuen getrennten Stromkreisfelder und -die Bezeichnung noch nicht. Fehlende Rückgabespalten werden angezeigt; sie -dürfen nicht ohne Linear-Parameterbindung erfunden werden. - -Die frühere Angabe von zwei IfcGUID-Duplikatgruppen war falsch: PowerShells -standardmäßiges Gruppieren verglich ohne Beachtung der Groß-/Kleinschreibung. -Ein erneuter ordinaler, case-sensitiver Vergleich ergab keine Duplikate. Die -Summenzeile hat nur in B490 einen Wert; `Familie und Typ` ist leer. - -Nicht nachgewiesen: erfolgreicher Rückimport in Linear, dessen genaue -Auswertung der Kommentar-/VML-Metadaten und der ExcelJS-Roundtrip. R2 endet -deshalb mit einer aus der Musterdatei erzeugten Rückgabedatei und einem -verbindlichen Linear-Test durch den Nutzer vor R3. - -## 3. Bibliothek, Adapter und Uploadgrenzen - -**Vorschlag: genau eine neue direkte Abhängigkeit `exceljs`.** Seine -öffentliche API unterstützt XLSX, Zellnotizen, Formate, Spaltenbreiten und -typisierte Werte. Das passt zum beobachteten klassischen Kommentarformat. -Version und transitive Abhängigkeiten werden in R2 festgeschrieben und -geprüft. Die veröffentlichte Version ist laut Paketregister 4.4.0; eine -aktuelle Releasepflege ist damit nicht bewiesen. Dies ist ein ausdrückliches -Wartungsrisiko, kein als erfüllt abgehakter Bibliotheksnachweis. - -Quellen, am 29.09.2026 geprüft: -[ExcelJS-Projekt](https://github.com/exceljs/exceljs), -[offizielle Paketdokumentation](https://www.npmjs.com/package/exceljs). -Keine Bibliothek wird in R0 installiert. R2 muss vor Integration Kommentar- -Roundtrip, Node-24-Verträglichkeit und Abhängigkeitsrisiken prüfen; bei einem -Blocker wird die Bibliotheksentscheidung neu vorgelegt. - -Vorgeschlagene Grenzen, zentral konfiguriert und synthetisch getestet: - -- ausschließlich `.xlsx`, kein `.xls` oder `.xlsm`; -- maximal 10 MiB Upload; -- genau ein Arbeitsblatt und keine Formelausführung; -- feste Zeilen-, Spalten- und Zellgrenzen nach dem Einlesen. - -Es gibt keinen eigenen ZIP-Prüfer und keinen Parser-Worker. - -Neutrale Matrix: Blattname, Kopfzeilen-/Startpositionen, Spaltenmetadaten -(Index, Name, Kommentartext, erkannter Parametertyp/Einheit), geordnete -Zeilen mit Originalzeilennummer und Klasse sowie Zellen als diskriminierte -Union `string | number | boolean | empty`. Formeltext und Cache-Status sind -optionale Transportmetadaten; fachlich zählt nur der gecachte skalare Wert. -Fehlender Cache oder Fehlerwert erzeugt einen Hinweis bzw. bei Pflichtfeldern -einen Blocker. Originalbytes bleiben unverändert gespeichert. - -Eine Zeile ohne Worksharing-ID ist nur verdächtig, wenn `Familie und Typ` -gefüllt ist. Sie erzeugt einen Hinweis und wird übersprungen, ohne zu -blockieren. Andere ID-lose Zeilen, auch die Summenzeile mit Inhalt in B, -werden still übersprungen. Nicht passende nichtleere IDs blockieren. -Worksharing-ID und IfcGUID bleiben als Quelltext erhalten und werden exakt, -ordinal und case-sensitiv verglichen; ungültige äußere Leerzeichen werden -gemeldet statt still korrigiert. IfcGUID wird optional gespeichert, doppelte -Werte sind nur Hinweise. -Numerische Projektion rundet Leistung auf 0,01 W, nicht die gespeicherte -Quellzelle. Mengen aus `socketCount` müssen positive ganze Zahlen sein. - -Rückgabe lädt eine Kopie der Originalbytes, bewahrt den Bereich oberhalb der -ersten Datenzeile samt Kommentaren, Formatierung und Spaltenbreiten und -ersetzt den Datenbereich durch gewählte Objektzeilen in Originalreihenfolge. -Alle Spalten bleiben enthalten; Summenzeilen entfallen. Unveränderte Zellen -behalten ihre importierten Werte und Typen. Formeln in Objektzeilen werden -als gecachte Werte ausgegeben, damit Zeilenauswahl keine falschen relativen -Bezüge erzeugt; dies wird vor Export als Hinweis ausgewiesen. Keine Formeln -werden berechnet. Roundtrip bedeutet strukturelle/semantische Gleichheit, -nicht identische ZIP-Bytes. - -## 4. Konfigurationsschema - -Neuer neutraler Vertrag `ExternalModelConfiguration`, Schema-Version 1: - -```ts -{ - schemaVersion: 1, - layout: { - headerRow: 1, firstDataRow: 3, firstDataColumn: 1 - }, - circuitMode: "combined" | "separate", - columns: { - worksharingId: string, familyAndType: string, - ifcGuid: string | null, roomNumber: string | null, - roomName: string | null, selectionMarker: string | null, - socketCount: string | null, sourceRemark: string | null, - circuitCombined: string | null, boardName: string | null, - circuitIdentifier: string | null, designation: string | null, - electricalPowerW: string | null, voltageV: string | null, - currentA: string | null - }, - deviceTypes: [{ - id: UUID, name: string, - category: "lighting" | "single_phase" | "three_phase", - defaults: { - powerPerUnitW: number | null, simultaneityFactor: number | null, - cosPhi: number | null, costGroup: string | null - } - }], - familyTypeRules: [{ - id: UUID, exactFamilyAndType: string, deviceTypeId: UUID, - quantityRule: "one" | "socketCount" - }] -} -``` - -Zeilen/Spalten sind intern 1-basiert; UI stellt Spalten als A, B, … dar. -Es gibt nur `columns.worksharingId` und kein separates `layout.idColumn`. -Jede gemappte Kopfzeile muss eindeutig auflösbar sein; -doppelte Ausgabebelegungen werden abgelehnt. Freie Eingabe bleibt zulässig, -aber ein nicht existierender Name erzeugt vor Import/Export einen konkreten -Fehler. Erkennung und Vorbelegung nutzen die exakten Standardnamen aus dem -Auftrag. Unbekannte Spalten bleiben ohne Mapping erhalten. - -Geräteart-IDs sind interne UUIDs, keine Namen als Relationsschlüssel. Regeln -sind exakt und je Familien-/Typtext eindeutig; jede importierte Familie muss -eine Geräteart haben. Gerätearten und Regeln werden als ein versioniertes -Konfigurationsaggregat gespeichert. Keine zusätzliche Gerätearttabelle ist -für diesen Umfang nötig; Validatoren erzwingen referenzielle Integrität. -Referenzierte Gerätearten können nicht kommentarlos entfernt werden. - -Startwerte: je Feld ProjectDevice vor Geräteart vor leer. Anzeigename: -Auswahlkenner, sonst Geräteartname, sonst Familie/Typ. Quellleistung bleibt -Quelle; eine Übernahme geschieht nur als sichtbare Planungsentscheidung. -Fehlender GZF wird sichtbar mit `1` vorbelegt, ohne zusätzliche Bestätigung. -Geräteart- -Änderungen schreiben keine vorhandenen Objekt-Overrides oder Rows um. - -## 5. Konkretes Persistenzschema - -Bestehende UUID-/Projekt-FKs und Eigentumsprüfungen werden beibehalten. -`JSON` bezeichnet validierten JSON-Text in SQLite, nicht ExcelJS-Objekte. - -| Tabelle | Zielspalten / Constraints | -| --- | --- | -| `external_model_configurations` (ersetzt CSV-Tabelle) | `id TEXT PK`, `project_id TEXT NOT NULL UNIQUE FK projects`, `configuration JSON NOT NULL`. Enthält obiges vollständiges Aggregat; keine eigene Versionszählung. | -| `external_model_sources` | `id`, `project_id UNIQUE`, `name`, `source_type = revit_xlsx`. Genau eine implizite Quelle je Projekt. | -| `external_import_batches` | Letzter Batch vollständig mit IDs, Importart, Zeit, Dateiname, SHA-256, Objektzahl, `applied_project_revision`, `configuration_snapshot JSON`, `original_bytes BLOB`, `document JSON`; ältere Batches nur als Metadaten Datum, Dateiname, SHA-256 und Objektzahl. | -| `external_room_mappings` | Vorhandene Felder einschließlich normalisiertem Quellraumschlüssel, `room_id`, `default_distribution_board_id`; UNIQUE `(source_id, normalized_source_room_key)` bleibt. | -| `external_model_objects` | Bestehende interne IDs/Links; neu `worksharing_id TEXT NOT NULL`, UNIQUE `(source_id, worksharing_id)`; `ifc_guid TEXT NULL`, ohne Unique; `device_type_id TEXT NOT NULL` als validierter Verweis in das Konfigurationsaggregat. | -| Objektzustand | `accepted_source_values JSON` mit rohen typisierten Werten für Raum, Familie/Typ, Marker, Menge, Bemerkung und alle Rückgabefelder; `planning_values JSON` mit Anzeigename, Kategorie, Anschlussart, effektiver Menge, Einzelleistung W, nullable GZF/cosPhi/Kostengruppe/Bemerkung; `overridden_fields JSON`; bisherige Batch-/Raum-/Board-/ProjectDevice-/Row-Verweise und `presence_status` bleiben. | -| `external_export_batches` (neu) | `id TEXT PK`, `project_id FK`, `project_revision INTEGER`, `import_batch_id TEXT`, `exported_at_iso TEXT`, `file_name TEXT`, `sha256 TEXT`, `configuration_snapshot/hash`, `scope TEXT`, `object_count INTEGER`. Append-only Audit-Store. | - -`import_batch_id` des Exportnachweises ist absichtlich eine historische UUID -ohne löschenden FK: Undo eines Imports oder Snapshot-Restore darf den Nachweis -nicht entfernen. Exportnachweise liegen außerhalb rücksetzbarer Fachsnapshots -und werden beim Projektduplikat nicht als dort erfolgte Exporte ausgegeben. -Sie bleiben beim Originalprojekt erhalten; diese Abgrenzung wird in R1 -dokumentiert. Nur der letzte Importbatch gehört mit Bytes und Matrix zu -Snapshot/Transfer; ältere Batches werden dort nur als Metadaten erhalten. - -Indices: bisherige Projekt-/Presence-, Board- und Row-Indices behalten; -zusätzlich `(project_id, device_type_id)`, `external_room_mapping_id`, -`linked_project_device_id`, Export `(project_id, exported_at_iso)`. -Cross-Project-Links und Geräteart-Verweise prüft jeder Command in der -Transaktion; bloße Existenz eines UUID-FK genügt nicht. - -Effektiver Verteiler: ein gemeinsamer Resolver verwendet bei verknüpften -Objekten die Row/Circuit-Verteilung, sonst die Objektabweichung, sonst die -Raumvorgabe. `distributionBoardId = null` bedeutet Raumvorgabe verwenden; -bei fehlender Vorgabe ist das Objekt ohne Verteiler. Eine Änderung des -Raum-Standardverteilers betrifft nur unzugeordnete Objekte; verknüpfte Objekte -folgen immer der Row-Verteilung und blockieren diese Änderung nicht. - -Planungswerte bleiben von Quellwerten getrennt. Nach Row-Zuordnung sind -Objekt-Planungswerte eingefrorene Startwerte; Anzeige, Abweichung und Export -verwenden die Row. Beim Lösen werden aktuelle Row-Werte einschließlich -Einheitenkonvertierung in die Objektplanung übernommen und als explizite -Overrides markiert. Effektive Objektmenge wird nicht durch die Row-Gesamtmenge -ersetzt. Die Row und ihr manueller Anteil bleiben erhalten. - -## 6. Commands und Transaktionsgrenze - -Alle öffentlichen Fach-Writes verlangen `expectedRevision`, Anmeldung und -`X-Leistungsbilanz-Request: 1`. `expectedRevision` gehört wie bisher zum -Ausführungsumschlag. Jede Transition enthält vollständige erwartete/Ziel- -Snapshots der betroffenen Datensätze, keine ungesicherten Teilpatches. - -| Command | Payload-Skizze und Gegenrichtung | -| --- | --- | -| `external-model-configuration.update` v1 | `{ expected, target }` einschließlich Layout, Mapping, Gerätearten und Regeln. Inverse tauscht den vollständigen Fachinhalt; keine eigene Konfigurationsversion. | -| `external-import.apply-initial` v2 | `{ expectedConfiguration, targetConfiguration, expected, target }`. Quelle, Batch, Mapping, Objekte und neue Regeln zusammen; Inverse stellt leeren externen und vorherigen Konfigurationsinhalt wieder her. Keine Rows. | -| `external-import.apply-follow-up` v1 | `{ configuration: transition, batch: transition, roomMappings: transitions, objects: transitions, rows: quantityTransitions, decisions }`; Server erzeugt deterministischen Diff und alle UUIDs. Inverse tauscht alle betroffenen Zustände. | -| `external-model-object.update-planning` v1 | `{ objects: transitions }`; nur ungebundene Objekte; geänderte Felder in Overrides. Einzel-/Sammelbearbeitung identischer Regeln. | -| `external-model-object.update-distribution-board` v1 | `{ objects: transitions }`; explizite Objektabweichung, Projekt-/Row-Konsistenz. | -| `external-model-room-mapping.update` v1 | `{ mappings: transitions }`; interner Raum/Standardverteiler; betroffene Objekt-/Row-Konsistenz mitprüfen. | -| `external-model-object.update-project-device-link` v1 | `{ objects: transitions, confirmedPlanningFields }`; keine Vorlagenänderung; neue Startwerte nur für ausdrücklich bestätigte Felder. Gebundene Objekte werden über ihre Row bearbeitet. | -| `external-object.update-row-assignment` v2 | `{ rows: transitions, objects: transitions, confirmedConflictObjectIds }`; Linkwechsel, materialisierte Mengen, beim Lösen aktuelle Row-Planungswerte; vollständige Inverse. | -| `external-object.assign-to-new-row` v2 | Bestehender vollständiger Row-/Objekt-/Reserveplan mit neuen Objektverträgen; history-only Inverse entfernt nur exakt unveränderte Erzeugnisse. | -| `external-object.assign-to-new-circuit` v2 | Bestehender Circuit-/Protection-/Row-/Objektplan; BMK einmal planen und festschreiben, gleiche UUIDs bei Redo. | -| `external-model-object.delete-missing` v1 | `{ objects: transitionsToNull, rows: quantityTransitions }`; ausschließlich ausdrücklich bestätigte weiterhin fehlende Objekte, kein Row-/Circuit-Löschen; Inverse stellt IDs, Links und Mengen wieder her. | - -Bestehende `project-device.insert`, Room-/Floor-Commands bleiben eigenständige -Undo-Schritte. Familien-/Geräteartentscheidungen im Wizard sind lokale -Entwürfe und werden erst mit dem Import atomar persistiert. Nach separater -Kataloganlage aktualisiert der Wizard die Projektrevision und plant neu, -ohne lokale Entscheidungen zu verlieren. - -Die Konfiguration hat keine eigene Versionszählung. Vorschau und Apply binden -sich an `expectedRevision`; weil auch Undo/Redo neue, strikt steigende -Projektrevisionen erzeugen, wird ein veralteter Plan eindeutig ungültig. -Importbatches speichern eine vollständige Konfigurationskopie. Prüfen: -Änderung → Undo → anderer Zweig darf niemals denselben Plan wieder gültig -machen. - -XLSX wird vor der synchronen SQLite-Transaktion in einer serverinternen -Vorbereitung geparst. Apply überträgt Bytes erneut; Hash, Matrix und -Entscheidungen werden erneut validiert. Im Store werden Revision, -Konfigurationsinhalt, erwartete Objekte, Links und vollständiger -vorbereiteter Plan atomar geprüft. Vorbereitete Daten sind keine vom Client -behauptete Validierung: Generic-Command-Requests dürfen Importcommands nicht -an dieser serverseitigen Vorbereitung vorbeischleusen. Undo/Redo lesen und -parsen keine Excel-Datei; sie wenden ausschließlich die gespeicherten -Vorher-/Nachher-Zustände an. Keine asynchronen Callbacks in -`better-sqlite3`-Transaktionen. - -Row-/Circuit-/Gruppen-Löschcommands erfassen verknüpfte Objekte vollständig. -Nach der Warnung `X Revit-Objekte werden wieder unzugeordnet` lösen sie die -Links im selben Command; ihre Inverse stellt sie exakt wieder her. Sperren -bleiben nur für das Löschen referenzierter Verteiler und Räume und gelten auch -in Unterbaum- und History-only-Pfaden. - -## 7. Migration, Snapshot 10, History und Transfer - -Neue additive Migration nach `0013_users` (voraussichtlich `0014`, Nummer -beim Beginn von R3 erneut prüfen). Bestehende SQL-/Metadateien unverändert. - -1. Vor R3-Anwendung API-Schreibzugriffe stoppen und `npm run db:backup` - ausführen; verifiziertes Backup samt Wiederherstellungsmöglichkeit sichern. - R0 verändert keine DB und benötigt daher kein Migrationsbackup. -2. Vorhandene externe CSV-Entwicklungsdaten dürfen gemäß Auftrag verworfen - werden. Zuerst je verknüpfter Row `quantity = manual_quantity` setzen; - sonst bliebe nach Entfernen der externen Objekte eine Phantomlast. - Rows, Circuits, manuelle Anteile, UUIDs und BMKs bleiben bestehen. -3. Externe Objekte → Mappings → Batches → Quellen → CSV-Konfiguration in - FK-sicherer Reihenfolge entfernen. Tabellen gezielt neu aufbauen, wo - SQLite NOT-NULL-/Unique-Änderungen dies erfordern. Neue Zieltabellen und - Indices erstellen. Keine leeren Worksharing-IDs als Backfill erfinden. -4. Generiertes SQL und Drizzle-Metadaten prüfen; saubere und bestehende - Test-DBs migrieren; FK-/Integritätsprüfung und Mengenabgleich ausführen. - Der Reset ist eine dokumentierte einmalige Entwicklungsmigration, - kein stiller Laufzeit-Import. -5. Alte Revisionsdaten nicht umschreiben, keine CSV-History heimlich - überspringen. An der Ausführungsgrenze alte CSV-Konfigurationscommands, - Initial-/Zuordnungscommands v1 einschließlich ihrer History-Inversen und - Restores mit CSV-Inhalt vor jedem Write ablehnen. - -Fehlermeldung für History: -„Dieser Verlaufsschritt verwendet die frühere CSV-/IfcGUID-Anbindung und -kann mit der Excel-Anbindung nicht ausgeführt werden.“ -Der History-Status sollte den blockierten obersten Schritt samt Grund zeigen; -keine automatisch geleerten Stacks und keine Änderung bei Ablehnung. Frühere -allgemeine Commands können nach dem Reset zusätzlich an ihren exakten -Vorbedingungen scheitern; das bleibt eine sichere, sichtbare Ablehnung. - -Snapshot v10 enthält aktive Excel-Konfiguration, Gerätearten/Regeln, Quelle, -den letzten Batch mit Originalbytes/Matrix, ältere Batches nur als Metadaten -sowie Raum-Mappings, Objekte und Links. -Upgrade v1–9: bestehende nicht-externe Upgrader erhalten. Nur wenn -`externalCsvConfiguration` fehlt/null ist **und** der externe Zustand leer -ist, verlustfrei auf v10 heben. Auch eine gespeicherte CSV-Konfiguration -allein zählt als nicht leerer CSV-Zustand und wird nicht still verworfen. -Snapshot-Checksumme am gespeicherten Original vor Upgrade prüfen. - -Fehlermeldung: -„Dieser Projektstand enthält Daten der früheren CSV-/IfcGUID-Anbindung. -Eine automatische Übernahme in die Excel-Anbindung ist nicht möglich. -Bitte verwenden Sie einen Projektstand ohne CSV-Daten.“ - -Der aktuelle portable Transfer ist bereits **Format 2** (Grobbilanzen), -nicht Format 1 wie im alten Audit. Envelope 2 und dessen Format-1-Lesepfad -bleiben; enthaltenes Projektzustandsschema wird 10. Duplizieren remappt -Projekt-, Konfigurations-, Geräteart-, Regel-, Quellen-, Batch-, Mapping-, -Objekt-UUIDs und alle internen Links, auch in Konfigurationssnapshots der -Batches. Worksharing-IDs, optionale IfcGUIDs und Originalbytes bleiben -unverändert. Grobbilanzen und globale Office-/Auth-Daten behalten ihre -bisherige Abgrenzung. Exportnachweise werden nicht als neue Projektexporte -dupliziert. - -## 8. Read-Modelle, Oberfläche und Rückgabe - -Vorgeschlagene API-Basis `/api/projects/:projectId/revit`: -`configuration` (GET/PUT), `profile/preview` (POST, zustandslos), -`initial-import/plan|apply`, `follow-up-import/plan|apply` (POST), -`status` und `objects` (GET), `return-workbook` (POST mit Export-Audit). -Der bestehende listenbezogene External-Objects-GET bleibt erhalten. -Objektmutationen verwenden den vorhandenen Project-Command-Endpunkt mit -neuen typisierten Verträgen. CSV-Endpunkte werden entfernt, keine Aliasse. - -Export verwendet `expectedRevision` für einen konsistent gelesenen Stand; -die Datei-Erzeugung erfolgt außerhalb des kurzen Read-Snapshots. Danach -separater append-only Audit-Write, ohne Projektrevision oder Undo-Schritt. -Bei Auditfehler kein Erfolg/download; ein Eintrag belegt Dateierzeugung, -nicht einen tatsächlich abgeschlossenen Browserdownload. - -Die Revit-Seite lädt einmal eine kompakte Objektliste. Filterung und Sortierung -laufen im Client; die Tabelle wird virtualisiert und verwendet keine Server- -Pagination. Filter-/Sortierzustand, UUID-Auswahl und Sammelaktionen sind -unabhängig vom DOM. „Alle gefilterten“ wird vor einer Mutation zu einer -expliziten ID-Auswahl an der aktuellen Revision aufgelöst. Große Auswahlmengen -werden nicht in getrennte Undo-Schritte aufgeteilt. Kein vollständiges -Batch-Blob im DTO. - -Einstellungen verwenden Musterdatei-Erkennung mit editierbaren Positionen, -Feld-Dropdowns/freier Eingabe und Kommentar-Typ-/Einheitenanzeige. Regeln -entstehen im Wizard und sind auf der Seite einklappbar nachbearbeitbar. -Fehlende Raumangaben bleiben zulässig, Board-Zuordnung ist auch ohne Raum -möglich. ProjectDevice-Zuordnung bleibt optional. - -Rechter Editor-Drawer: nur vorhandene, ungebundene konfliktfreie Objekte des -effektiven Verteilers. Gruppierung nach internem Raum, Auswahlkenner, -Geräteart-ID, Kategorie und identischen Planungswerten; unterschiedliche -ProjectDevice-Links bleiben ebenfalls getrennt, da eine Row nur einen Link -haben kann. Effektive Einzelmengen sind kein Gleichheitsfeld: Einfach- und -Mehrfachsteckdosen sollen gemeinsam gruppierbar sein. Anzeige enthält -Mengensumme und Objektanzahl. Fachlich heterogene Auswahl darf nicht -willkürlich auf eine einzelne Row zusammenfallen; Konfliktanzeige verlangt -eine kompatible Auswahl. Row-Indikator öffnet Objekte und explizites Lösen. - -Eine Funktion `getRevitBoardName(board)` liefert ausschließlich `board.name`. -Gemeinsam: Name + unverändertes `equipmentIdentifier`, ohne Separator. -Getrennt: Name und BMK in eigene Parameter. Ohne Circuit bleiben beide -Stromkreiswerte leer, auch wenn ein Planungsverteiler bekannt ist. - -Exportprojektion und Abweichungsanzeige teilen dieselbe reine Funktion: -Row-Anzeigename/-Leistung bei Link, sonst Objektplanung; Objektleistung in W -= effektive Menge × Einzelleistung (Row-kW vorher × 1000), ohne GZF. -Spannung vom Circuit, sonst Projektstandard passend zur Kategorie. -Strom aus Objektleistung, U, cosPhi und Phasenart; Drehstrom mit Faktor √3, -auf 0,01 A. Fehlende/ungültige Werte ergeben leer plus Hinweis. Nullleistung -bleibt bei gültigem Nenner numerisch 0. Kein still angenommenes cosPhi. -Abweichungsvergleich normalisiert Zahlpräzision, Leere und skalare Typen -gegen den **zuletzt importierten**, nicht den zuletzt exportierten Stand. - -Umfang: alle im letzten Batch vorhandenen Objekte / abweichende / explizite -Auswahl. Fehlende Objekte haben keine aktuelle Originalzeile und werden -nicht künstlich wieder eingefügt. Alle Spalten bleiben, nicht ausgegebene -Parameter behalten importierte Werte. Fehlende optionale Spalten für -Bezeichnung, Leistung, Spannung und Strom werden mit Hinweis übersprungen. -Nur fehlende Stromkreisspalten des gewählten Modus blockieren. Dateiname gemäß -Auftrag mit bereinigtem Projektnamen und Tagesdatum. - -Folgeimport matcht ausschließlich Worksharing-ID. Ein neuer Batch speichert -immer den vollständigen letzten Quellstand. Unveränderte Objekte werden -nicht allein zum Fortschreiben von `lastSeenImportBatchId` neu geschrieben; -aktuelle Sichtbarkeit/Quellwerte kommen aus Batch/Matrix. Akzeptierte -Planungsgrundlage und letzte importierte Beobachtung sind getrennt. -Raum-/Familien-/Marker-/Mengenänderungen brauchen Entscheidungen. Bei -unvereinbarer Row-Zuordnung blockiert die Übernahme bis zum ausdrücklichen -Lösen/Umordnen, statt Rows automatisch zu erzeugen. Übernommene Mengen -ändern alle betroffenen Row-Summen im selben Importcommand. Fehlend setzt -nur den Status, erhält vorerst Link und Menge. Rückgabefeld-Abweichungen -sind Hinweise, keine Übernahmeentscheidungen. Ein völlig unveränderter -Folgeimport erzeugt einen nachvollziehbaren Batch, aber keine unnötigen -Objekt-/Row-Updates. - -## 9. Pakete, Verifikation und Risiken - -R0 liefert nur diesen Bericht und einen eigenen Commit. R1–R10 starten erst -nach Freigabe; keine Fortschreibung der alten 14.0–14.6-Liste. - -| Paket | Arbeit und entscheidende Abnahme | -| --- | --- | -| R1 | Neue Excel-Anforderungen und R0–R10-Plan; alte Dokumente archivieren/auf Verweise kürzen; AGENTS, Architektur, History-Doku, Phase-14-Abschnitt, LLM-Kontext und alle Links nachziehen. Referenzdatei gezielt ignorieren. | -| R2 | XLSX-Adapter und lokaler Referenzprüfer mit Pfadargument. Synthetischer Roundtrip für Kommentare, Blattname, Spaltenbreiten, Typen, Header-/Startpositionen, unbekannte Spalten, Auswahl und Summenausschluss. Aus der lokalen Musterdatei entsteht eine Rückgabedatei mit geänderten Werten. Danach Nutzerabnahme in Linear; R3 bleibt bis zum Erfolg gesperrt. Bei Fehlschlag vor R3 OOXML-Direktänderung als Alternative vorlegen. Keine DB-Änderung. | -| R3 | Neue Konfiguration/Identität, additive Migration, Snapshot 10, Transfer und History-Ablehnungen; Backend-CSV entfernen. Parser-Vorbereitung von synchroner Transaktion trennen. | -| R4 | Revit-Seite, Navigation, Einstellungen; Projektseitenmodal und dessen CSV-Frontend-Verträge entfernen. | -| R5 | Erstimport mit atomaren Regeln, Geräten, Raum-/Board- und Objektentscheidungen; ProjectDevice-Vorbelegung nach Priorität; ein Import-Undo-Schritt. | -| R6 | Kompakte Objekt-Reads, clientseitige Filter/Sortierung, Virtualisierung, Sammel-Commands und Overrides. | -| R7 | Gruppierung, Drag-and-drop, Row-Indikatoren und Lösen inklusive aktueller Row-Werte; drei Drop-Ziele, atomare Objektlösung beim Row-/Circuit-/Gruppen-Löschen und Reload/Undo/Redo. | -| R8 | Drei Exportumfänge, gemeinsame Abweichungsprojektion, typisierte Rückgabe, append-only Nachweis und Linear-Strukturabnahme. | -| R9 | Kontrollierter Folgeimport, fehlende Objekte, explizites Löschen, mengenwirksame Entscheidungen und atomare Inverse. | -| R10 | Vollständige synthetische Ende-zu-Ende-Kette einschließlich Neustart, Snapshot/Restore und Duplikat; mehrere Tausend Objekte; Doku auf ausgelieferten Stand. | - -Die temporäre Grenze zwischen R3 und R4 wird ausdrücklich behandelt: -Buildfähige, nicht aktive Kompatibilitätstypen für das alte Modal dürfen bis -R4 bestehen, aber kein aktiver CSV-Backendpfad. Veraltete Projektaktion bis -zur neuen Seite deaktivieren/entfernen, keinen funktionslosen Upload anbieten. -Die Dokumentation darf Zwischenstände nicht als fertigen Workflow ausweisen. - -Pflicht je R1–R10: fokussierte Tests, `npm test`, `npm run build:api`, -`npm run build:web`, `npm run typecheck:scripts`, -`npx tsc --noEmit -p tsconfig.next.json`, je ein knapper imperativer Commit. -R0: 31 vorhandene Tests aus sechs Dateien erfolgreich ausgeführt: -`external-model-foundation`, `external-initial-import-plan`, -`external-initial-import-project-command.repository`, -`external-object-row-assignment-project-command.repository`, -`external-circuit-list-objects`, -`external-csv-configuration-project-command.repository` (je `.test.ts`). -Diese decken vorhandene Commit-/Rollback-, Undo-/Redo-, Snapshot-/Transfer- -Grundlagen ab, nicht die neue Excel-Funktion. Der erste Start scheiterte an -Sandbox-`spawn EPERM`; derselbe Lauf außerhalb der Sandbox bestand. -Vollständige Builds/Tests sind für diesen reinen R0-Bericht nicht ausgeführt. - -Zusätzlich erforderliche neue Prüfungen: - -- Migration mit externen Row-Anteilen; keine Phantomlast und unveränderte BMKs. -- v1–9 ohne CSV verlustfrei, mit CSV klare Ablehnung; alte Command-Inversen - und alte Restore-Payloads ebenfalls ohne Teilwrites ablehnen. -- Config-Änderung/Undo/Neuzweig invalidiert alte Pläne über `expectedRevision`; Apply mit anderem - Dateiinhalt, fehlenden Entscheidungen oder fremden UUIDs rollt vollständig - zurück. Später Historyfehler rollt auch Regeln, Links und Mengen zurück. -- Gebundene Row ändern → Export → Lösen → Undo/Redo behält fachliche Werte. -- Mehrfachsteckdosen: unterschiedliche effektive Mengen, identische - Einzelwerte, richtige Gruppierung und objektweise Rückgabeleistung. -- Row-/Circuit-/Gruppen-Löschen löst externe Links im Command und stellt sie - per Undo wieder her. Raum-/Verteilerlöschen mit Referenzen blockiert. -- Export-Audit scheitert: keine fachliche Revision; SHA-256 entspricht exakt - den gelieferten Bytes. Snapshot/Restore entfernt keine Exportnachweise. -- 5.000/10.000 synthetische Objekte: Parserzeit, Peak-Speicher, Payloadgröße, - Command-/Snapshot-Dauer und UI-Reaktionszeit messen; nur sichtbare Zeilen im - DOM, stabile Auswahl über virtuelle Bereiche. - -Wesentliche Restrisiken: Linear-Kommentarbindung ist nur anhand des -Exports beobachtet; ExcelJS-Releasepflege und Roundtrip sind in R2 zu -belegen. Große Originaldateien vervielfachen sich in History/Snapshots; -Limits und Messungen müssen reale Speichergrößen berücksichtigen. Die -CSV-Entwicklungsbereinigung ist absichtlich verlustbehaftet, aber auf den -externen Zustand begrenzt und nur nach verifiziertem Backup zulässig. -Fehlende Zielparameter im Muster verlangen einen neuen vollständigen -Linear-Export, keine geratenen GUID-Kommentare. - -**Freigabepunkt:** R0 wurde am 29.09.2026 mit den in R1 dokumentierten -Korrekturen freigegeben. R2 besitzt einen neuen verbindlichen Freigabepunkt: -Vor Beginn von R3 muss der Nutzer die in R2 erzeugte Rückgabedatei erfolgreich -in Linear getestet haben. diff --git a/docs/spec/revit-excel-r10-validation.md b/docs/spec/revit-excel-r10-validation.md deleted file mode 100644 index 0bdc392..0000000 --- a/docs/spec/revit-excel-r10-validation.md +++ /dev/null @@ -1,60 +0,0 @@ -# R10-Abnahme der Linear-XLSX-Anbindung - -Stand: 30.09.2026. R10 schließt Phase 14 mit synthetischen, reproduzierbaren -Integrations- und Lasttests ab. Die reale Musterdatei wird dafür nicht benötigt -und bleibt unversioniert. - -## Ende-zu-Ende-Nachweis - -`tests/revit-xlsx-end-to-end.test.ts` verwendet eine dateibasierte SQLite- -Datenbank und prüft in einer Kette: - -```text -Erstimport → Objektplanung → Row-Zuordnung → Rückgabe-XLSX - → Folgeimport → Snapshot/Restore → Projektduplikat - → Datenbankneustart → Undo → Redo -``` - -Der Test bestätigt insbesondere die materialisierte Row-Menge, die Reduktion -des älteren Importbatches auf Metadaten, das Remapping aller internen UUIDs im -Duplikat und parserfreies Undo/Redo nach dem Neustart. - -## Last- und Größenmessung - -`tests/revit-xlsx-scale.test.ts` erzeugt 5.000 synthetische Objekte in einer -Linear-kompatiblen XLSX. Der Test misst Erst- und Folgeimport, Command- und -Snapshotgröße, Heap-Wachstum sowie clientseitiges Filtern, Sortieren und das -virtuelle Fenster. Er führt außerdem Snapshot-Restore und Projektduplikat mit -dem vollständigen Zustand aus. - -Messung auf der Entwicklungsumgebung am 30.09.2026: - -| Messwert | Ergebnis | -| --- | ---: | -| Objekte | 5.000 | -| XLSX-Datei | 191.019 Bytes | -| Erstimport-Command | 15.598.253 Bytes | -| logischer Projektsnapshot | 15.598.071 Bytes | -| XLSX-Erstplanung | 6.831 ms | -| atomare Erstimporttransaktion | 672 ms | -| XLSX-Folgeplanung | 6.303 ms | -| atomare Folgeimporttransaktion | 887 ms | -| Clientfilter, Sortierung und Fenster | 37 ms | -| Heap-Zuwachs des erfolgreichen Gesamtlaufs | 154.125.568 Bytes | - -Der Heap-Wert ist wegen Garbage Collection und der absichtlich verwendeten -In-Memory-Datenbank nicht deterministisch. Wiederholte Auditläufe lagen unter -der Testobergrenze von 768 MiB. Das virtuelle Fenster enthält bei 520 px Höhe -maximal 22 statt 5.000 Zeilen. - -## Gefundene und behobene Grenze - -Der erste 5.000-Objekte-Lauf scheiterte an einem ungebatchten SQLite- -Mehrfach-Insert. `insertManyInBatches` begrenzt nun die Insertblöcke für -Erstimport, Folgeimport, Snapshot-Restore und Projektduplikat. Alle Blöcke -bleiben Teil der jeweiligen bestehenden Transaktion; ein Fehler rollt weiterhin -die gesamte Operation zurück. - -Die vorhandenen Tests decken außerdem die deutschen Ablehnungen alter -CSV-Snapshots und CSV-History, Löschwarnungen, atomare Link-Inversen und den -Schutz referenzierter Räume und Verteiler ab. diff --git a/dynamo/01_check_model_identity.py b/dynamo/01_check_model_identity.py new file mode 100644 index 0000000..a3fe009 --- /dev/null +++ b/dynamo/01_check_model_identity.py @@ -0,0 +1,385 @@ +"""Read-only Revit 2026 model-identity diagnostics for a Dynamo Python node. + +Optional Dynamo input: + IN[0]: output directory or complete .json file path + +The script intentionally performs no Revit transaction and changes no model +data. OUT contains a compact summary plus the complete report. +""" + +import datetime +import json +import os +import platform +import sys +import tempfile +import traceback + +import clr + +clr.AddReference("RevitAPI") +clr.AddReference("RevitServices") + +from Autodesk.Revit.DB import ModelPathUtils, StorageType # noqa: E402 +from RevitServices.Persistence import DocumentManager # noqa: E402 + + +CHECKED_PARAMETER_NAMES = ("LB_ModelId", "LB_ProjectId") + + +def safe_text(value): + if value is None: + return None + try: + return str(value) + except Exception: + return None + + +def element_id_text(element_id): + if element_id is None: + return None + try: + return str(element_id.Value) + except Exception: + try: + return str(element_id.IntegerValue) + except Exception: + return safe_text(element_id) + + +def forge_type_id_text(value): + if value is None: + return None + try: + return value.TypeId + except Exception: + return safe_text(value) + + +def parameter_value(parameter): + result = { + "hasValue": False, + "raw": None, + "display": None, + } + try: + result["hasValue"] = bool(parameter.HasValue) + except Exception: + pass + + try: + storage_type = parameter.StorageType + if storage_type == StorageType.String: + result["raw"] = parameter.AsString() + elif storage_type == StorageType.Integer: + result["raw"] = int(parameter.AsInteger()) + elif storage_type == StorageType.Double: + result["raw"] = float(parameter.AsDouble()) + elif storage_type == StorageType.ElementId: + result["raw"] = element_id_text(parameter.AsElementId()) + except Exception as error: + result["readError"] = safe_text(error) + + try: + result["display"] = parameter.AsValueString() + except Exception: + pass + return result + + +def describe_parameter(parameter): + definition = None + try: + definition = parameter.Definition + except Exception: + pass + + name = None + if definition is not None: + try: + name = definition.Name + except Exception: + pass + + is_shared = False + try: + is_shared = bool(parameter.IsShared) + except Exception: + pass + + shared_guid = None + if is_shared: + try: + shared_guid = str(parameter.GUID) + except Exception: + pass + + data_type = None + group_type = None + if definition is not None: + try: + data_type = forge_type_id_text(definition.GetDataType()) + except Exception: + pass + try: + group_type = forge_type_id_text(definition.GetGroupTypeId()) + except Exception: + pass + + unit_type = None + try: + unit_type = forge_type_id_text(parameter.GetUnitTypeId()) + except Exception: + pass + + try: + storage_type = str(parameter.StorageType) + except Exception: + storage_type = None + + try: + is_read_only = bool(parameter.IsReadOnly) + except Exception: + is_read_only = None + + try: + user_modifiable = bool(parameter.UserModifiable) + except Exception: + user_modifiable = None + + return { + "name": name, + "parameterId": element_id_text(getattr(parameter, "Id", None)), + "isShared": is_shared, + "sharedGuid": shared_guid, + "storageType": storage_type, + "dataTypeId": data_type, + "groupTypeId": group_type, + "unitTypeId": unit_type, + "isReadOnly": is_read_only, + "userModifiable": user_modifiable, + "value": parameter_value(parameter), + } + + +def sorted_parameters(element): + parameters = [] + try: + parameters = [describe_parameter(parameter) for parameter in element.Parameters] + except Exception: + return [] + return sorted( + parameters, + key=lambda parameter: ( + (parameter.get("name") or "").casefold(), + parameter.get("parameterId") or "", + ), + ) + + +def named_parameter_occurrences(element, parameter_name): + result = [] + try: + parameters = element.GetParameters(parameter_name) + if parameters is not None: + result = [describe_parameter(parameter) for parameter in parameters] + except Exception: + parameter = None + try: + parameter = element.LookupParameter(parameter_name) + except Exception: + pass + if parameter is not None: + result = [describe_parameter(parameter)] + return result + + +def loaded_assembly_versions(): + result = {} + try: + from System import AppDomain + + for assembly in AppDomain.CurrentDomain.GetAssemblies(): + try: + name = assembly.GetName() + simple_name = str(name.Name) + if simple_name in ( + "DynamoCore", + "DynamoCoreWpf", + "DynamoRevitDS", + "RevitAPI", + "RevitServices", + ): + result[simple_name] = str(name.Version) + except Exception: + continue + except Exception: + pass + return dict(sorted(result.items())) + + +def get_cloud_identity(document): + result = {"isModelInCloud": False} + try: + result["isModelInCloud"] = bool(document.IsModelInCloud) + except Exception: + return result + if not result["isModelInCloud"]: + return result + + try: + model_path = document.GetCloudModelPath() + result["userVisiblePath"] = ModelPathUtils.ConvertModelPathToUserVisiblePath( + model_path + ) + for property_name, output_name in ( + ("GetProjectGUID", "projectGuid"), + ("GetModelGUID", "modelGuid"), + ): + try: + result[output_name] = str(getattr(model_path, property_name)()) + except Exception: + pass + except Exception as error: + result["readError"] = safe_text(error) + return result + + +def get_worksharing_identity(document): + result = {"isWorkshared": False} + try: + result["isWorkshared"] = bool(document.IsWorkshared) + except Exception: + return result + if not result["isWorkshared"]: + return result + + try: + model_path = document.GetWorksharingCentralModelPath() + result["centralModelPath"] = ModelPathUtils.ConvertModelPathToUserVisiblePath( + model_path + ) + except Exception as error: + result["readError"] = safe_text(error) + return result + + +def resolve_output_path(configured_path, report_name): + timestamp = datetime.datetime.now().strftime("%Y%m%d-%H%M%S") + default_directory = os.path.join(tempfile.gettempdir(), "leistungsbilanz-dynamo") + raw_path = safe_text(configured_path) + if raw_path is None or not raw_path.strip(): + directory = default_directory + file_path = os.path.join(directory, report_name + "-" + timestamp + ".json") + else: + expanded = os.path.abspath(os.path.expandvars(os.path.expanduser(raw_path.strip()))) + if expanded.lower().endswith(".json"): + file_path = expanded + directory = os.path.dirname(file_path) + else: + directory = expanded + file_path = os.path.join(directory, report_name + "-" + timestamp + ".json") + if not directory: + directory = os.getcwd() + if not os.path.isdir(directory): + os.makedirs(directory) + return file_path + + +def write_json(file_path, payload): + temporary_path = file_path + ".tmp" + with open(temporary_path, "w", encoding="utf-8", newline="\n") as output: + json.dump(payload, output, ensure_ascii=False, indent=2, sort_keys=True) + output.write("\n") + os.replace(temporary_path, file_path) + + +def get_input(index, default=None): + values = globals().get("IN", []) + try: + value = values[index] + return default if value is None else value + except Exception: + return default + + +def build_report(): + document = DocumentManager.Instance.CurrentDBDocument + if document is None: + raise RuntimeError("No active Revit document is available.") + + project_information = document.ProjectInformation + if project_information is None: + raise RuntimeError("The active document has no Project Information element.") + + application = document.Application + checked_parameters = { + name: named_parameter_occurrences(project_information, name) + for name in CHECKED_PARAMETER_NAMES + } + warnings = [] + for name in CHECKED_PARAMETER_NAMES: + occurrences = checked_parameters[name] + populated = [ + parameter + for parameter in occurrences + if parameter.get("value", {}).get("raw") not in (None, "") + ] + if not occurrences: + warnings.append(name + " is not bound to Project Information.") + elif not populated: + warnings.append(name + " exists but has no value on Project Information.") + elif len(occurrences) > 1: + warnings.append(name + " occurs more than once; use a shared-parameter GUID later.") + + return { + "reportSchemaVersion": 1, + "generatedAt": datetime.datetime.now(datetime.timezone.utc).isoformat(), + "readOnly": True, + "environment": { + "revitVersionNumber": safe_text(getattr(application, "VersionNumber", None)), + "revitVersionName": safe_text(getattr(application, "VersionName", None)), + "revitSubVersionNumber": safe_text( + getattr(application, "SubVersionNumber", None) + ), + "pythonImplementation": safe_text(getattr(sys.implementation, "name", None)), + "pythonVersion": platform.python_version(), + "assemblies": loaded_assembly_versions(), + }, + "document": { + "title": safe_text(document.Title), + "pathName": safe_text(document.PathName), + "isFamilyDocument": bool(document.IsFamilyDocument), + "cloud": get_cloud_identity(document), + "worksharing": get_worksharing_identity(document), + }, + "modelIdentityCandidates": { + "projectInformationUniqueId": safe_text(project_information.UniqueId), + "projectInformationElementId": element_id_text(project_information.Id), + "checkedProjectParameters": checked_parameters, + }, + "projectInformationParameters": sorted_parameters(project_information), + "warnings": warnings, + } + + +try: + report = build_report() + output_path = resolve_output_path(get_input(0), "model-identity") + write_json(output_path, report) + OUT = { + "ok": True, + "filePath": output_path, + "projectInformationUniqueId": report["modelIdentityCandidates"][ + "projectInformationUniqueId" + ], + "warnings": report["warnings"], + "report": report, + } +except Exception as error: + OUT = { + "ok": False, + "error": safe_text(error), + "traceback": traceback.format_exc(), + } diff --git a/dynamo/02_export_electrical_fixture_parameter_inventory.py b/dynamo/02_export_electrical_fixture_parameter_inventory.py new file mode 100644 index 0000000..440a222 --- /dev/null +++ b/dynamo/02_export_electrical_fixture_parameter_inventory.py @@ -0,0 +1,517 @@ +"""Export all Electrical Fixtures instance/type parameters from Revit 2026. + +Optional Dynamo inputs: + IN[0]: output directory or complete .json file path + IN[1]: include empty parameters (default True) + IN[2]: maximum aggregated sample values (default 5) + +The script is read-only and performs no Revit transaction. +""" + +import datetime +import json +import os +import platform +import sys +import tempfile +import traceback + +import clr + +clr.AddReference("RevitAPI") +clr.AddReference("RevitServices") + +from Autodesk.Revit.DB import ( # noqa: E402 + BuiltInCategory, + FilteredElementCollector, + ModelPathUtils, + StorageType, +) +from RevitServices.Persistence import DocumentManager # noqa: E402 + + +def safe_text(value): + if value is None: + return None + try: + return str(value) + except Exception: + return None + + +def element_id_text(element_id): + if element_id is None: + return None + try: + return str(element_id.Value) + except Exception: + try: + return str(element_id.IntegerValue) + except Exception: + return safe_text(element_id) + + +def forge_type_id_text(value): + if value is None: + return None + try: + return value.TypeId + except Exception: + return safe_text(value) + + +def parameter_value(parameter): + result = {"hasValue": False, "raw": None, "display": None} + try: + result["hasValue"] = bool(parameter.HasValue) + except Exception: + pass + + try: + storage_type = parameter.StorageType + if storage_type == StorageType.String: + result["raw"] = parameter.AsString() + elif storage_type == StorageType.Integer: + result["raw"] = int(parameter.AsInteger()) + elif storage_type == StorageType.Double: + result["raw"] = float(parameter.AsDouble()) + elif storage_type == StorageType.ElementId: + result["raw"] = element_id_text(parameter.AsElementId()) + except Exception as error: + result["readError"] = safe_text(error) + + try: + result["display"] = parameter.AsValueString() + except Exception: + pass + return result + + +def describe_parameter(parameter, scope): + definition = None + try: + definition = parameter.Definition + except Exception: + pass + + name = None + data_type = None + group_type = None + if definition is not None: + try: + name = definition.Name + except Exception: + pass + try: + data_type = forge_type_id_text(definition.GetDataType()) + except Exception: + pass + try: + group_type = forge_type_id_text(definition.GetGroupTypeId()) + except Exception: + pass + + is_shared = False + try: + is_shared = bool(parameter.IsShared) + except Exception: + pass + + shared_guid = None + if is_shared: + try: + shared_guid = str(parameter.GUID) + except Exception: + pass + + unit_type = None + try: + unit_type = forge_type_id_text(parameter.GetUnitTypeId()) + except Exception: + pass + + try: + storage_type = str(parameter.StorageType) + except Exception: + storage_type = None + + try: + is_read_only = bool(parameter.IsReadOnly) + except Exception: + is_read_only = None + + try: + user_modifiable = bool(parameter.UserModifiable) + except Exception: + user_modifiable = None + + return { + "scope": scope, + "name": name, + "parameterId": element_id_text(getattr(parameter, "Id", None)), + "isShared": is_shared, + "sharedGuid": shared_guid, + "storageType": storage_type, + "dataTypeId": data_type, + "groupTypeId": group_type, + "unitTypeId": unit_type, + "isReadOnly": is_read_only, + "userModifiable": user_modifiable, + "value": parameter_value(parameter), + } + + +def has_meaningful_value(parameter_description): + value = parameter_description.get("value", {}) + return bool(value.get("hasValue")) or value.get("raw") not in (None, "") or value.get( + "display" + ) not in (None, "") + + +def read_parameters(element, scope, include_empty): + result = [] + try: + for parameter in element.Parameters: + description = describe_parameter(parameter, scope) + if include_empty or has_meaningful_value(description): + result.append(description) + except Exception as error: + return [], [safe_text(error)] + result.sort( + key=lambda parameter: ( + (parameter.get("name") or "").casefold(), + parameter.get("parameterId") or "", + ) + ) + return result, [] + + +def read_space(element, document): + try: + space = element.Space + except Exception as error: + return None, safe_text(error) + if space is None: + return None, None + + level_name = None + try: + level = document.GetElement(space.LevelId) + level_name = None if level is None else safe_text(level.Name) + except Exception: + pass + + return { + "uniqueId": safe_text(space.UniqueId), + "elementId": element_id_text(space.Id), + "number": safe_text(getattr(space, "Number", None)), + "name": safe_text(getattr(space, "Name", None)), + "levelName": level_name, + }, None + + +def read_family_identity(element, document): + symbol = None + try: + symbol = element.Symbol + except Exception: + try: + symbol = document.GetElement(element.GetTypeId()) + except Exception: + pass + + family_name = None + type_name = None + type_unique_id = None + type_element_id = None + if symbol is not None: + try: + family_name = safe_text(symbol.Family.Name) + except Exception: + family_name = safe_text(getattr(symbol, "FamilyName", None)) + type_name = safe_text(getattr(symbol, "Name", None)) + type_unique_id = safe_text(getattr(symbol, "UniqueId", None)) + type_element_id = element_id_text(getattr(symbol, "Id", None)) + + return { + "familyName": family_name, + "typeName": type_name, + "typeUniqueId": type_unique_id, + "typeElementId": type_element_id, + }, symbol + + +def parameter_inventory_key(parameter): + stable_id = parameter.get("sharedGuid") or parameter.get("parameterId") or "" + return "|".join( + ( + parameter.get("scope") or "", + stable_id, + parameter.get("name") or "", + parameter.get("dataTypeId") or "", + ) + ) + + +def sample_value_key(value): + return json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":")) + + +def add_to_inventory(inventory, parameter, max_samples): + key = parameter_inventory_key(parameter) + entry = inventory.get(key) + if entry is None: + entry = { + "scope": parameter.get("scope"), + "name": parameter.get("name"), + "parameterId": parameter.get("parameterId"), + "isShared": parameter.get("isShared"), + "sharedGuid": parameter.get("sharedGuid"), + "storageType": parameter.get("storageType"), + "dataTypeId": parameter.get("dataTypeId"), + "groupTypeId": parameter.get("groupTypeId"), + "unitTypeId": parameter.get("unitTypeId"), + "occurrenceCount": 0, + "populatedCount": 0, + "sampleValues": [], + "_sampleKeys": set(), + } + inventory[key] = entry + entry["occurrenceCount"] += 1 + if has_meaningful_value(parameter): + entry["populatedCount"] += 1 + value = parameter.get("value") + value_key = sample_value_key(value) + if len(entry["sampleValues"]) < max_samples and value_key not in entry["_sampleKeys"]: + entry["_sampleKeys"].add(value_key) + entry["sampleValues"].append(value) + + +def finalize_inventory(inventory): + result = [] + for entry in inventory.values(): + clean_entry = dict(entry) + clean_entry.pop("_sampleKeys", None) + result.append(clean_entry) + return sorted( + result, + key=lambda entry: ( + entry.get("scope") or "", + (entry.get("name") or "").casefold(), + entry.get("sharedGuid") or entry.get("parameterId") or "", + ), + ) + + +def loaded_assembly_versions(): + result = {} + try: + from System import AppDomain + + for assembly in AppDomain.CurrentDomain.GetAssemblies(): + try: + name = assembly.GetName() + simple_name = str(name.Name) + if simple_name in ( + "DynamoCore", + "DynamoCoreWpf", + "DynamoRevitDS", + "RevitAPI", + "RevitServices", + ): + result[simple_name] = str(name.Version) + except Exception: + continue + except Exception: + pass + return dict(sorted(result.items())) + + +def resolve_output_path(configured_path): + timestamp = datetime.datetime.now().strftime("%Y%m%d-%H%M%S") + default_directory = os.path.join(tempfile.gettempdir(), "leistungsbilanz-dynamo") + raw_path = safe_text(configured_path) + if raw_path is None or not raw_path.strip(): + directory = default_directory + file_path = os.path.join( + directory, "electrical-fixture-parameters-" + timestamp + ".json" + ) + else: + expanded = os.path.abspath(os.path.expandvars(os.path.expanduser(raw_path.strip()))) + if expanded.lower().endswith(".json"): + file_path = expanded + directory = os.path.dirname(file_path) + else: + directory = expanded + file_path = os.path.join( + directory, "electrical-fixture-parameters-" + timestamp + ".json" + ) + if not directory: + directory = os.getcwd() + if not os.path.isdir(directory): + os.makedirs(directory) + return file_path + + +def write_json(file_path, payload): + temporary_path = file_path + ".tmp" + with open(temporary_path, "w", encoding="utf-8", newline="\n") as output: + json.dump(payload, output, ensure_ascii=False, indent=2, sort_keys=True) + output.write("\n") + os.replace(temporary_path, file_path) + + +def get_input(index, default=None): + values = globals().get("IN", []) + try: + value = values[index] + return default if value is None else value + except Exception: + return default + + +def build_report(include_empty, max_samples): + document = DocumentManager.Instance.CurrentDBDocument + if document is None: + raise RuntimeError("No active Revit document is available.") + if document.IsFamilyDocument: + raise RuntimeError("Open a Revit project document, not a family document.") + + application = document.Application + collector = ( + FilteredElementCollector(document) + .OfCategory(BuiltInCategory.OST_ElectricalFixtures) + .WhereElementIsNotElementType() + ) + source_elements = list(collector) + source_elements.sort(key=lambda element: safe_text(element.UniqueId) or "") + + elements = [] + types_by_unique_id = {} + inventory = {} + errors = [] + elements_without_space = 0 + + for element in source_elements: + element_errors = [] + try: + family_identity, symbol = read_family_identity(element, document) + instance_parameters, parameter_errors = read_parameters( + element, "instance", include_empty + ) + element_errors.extend(parameter_errors) + for parameter in instance_parameters: + add_to_inventory(inventory, parameter, max_samples) + + type_unique_id = family_identity.get("typeUniqueId") + if symbol is not None and type_unique_id and type_unique_id not in types_by_unique_id: + type_parameters, type_errors = read_parameters(symbol, "type", include_empty) + element_errors.extend(type_errors) + for parameter in type_parameters: + add_to_inventory(inventory, parameter, max_samples) + types_by_unique_id[type_unique_id] = { + **family_identity, + "parameters": type_parameters, + } + + space, space_error = read_space(element, document) + if space_error: + element_errors.append("MEP Space: " + space_error) + if space is None: + elements_without_space += 1 + + elements.append( + { + "uniqueId": safe_text(element.UniqueId), + "elementId": element_id_text(element.Id), + "categoryName": safe_text( + None if element.Category is None else element.Category.Name + ), + "family": family_identity, + "space": space, + "instanceParameters": instance_parameters, + "warnings": element_errors, + } + ) + except Exception as error: + errors.append( + { + "uniqueId": safe_text(getattr(element, "UniqueId", None)), + "elementId": element_id_text(getattr(element, "Id", None)), + "error": safe_text(error), + } + ) + + return { + "reportSchemaVersion": 1, + "generatedAt": datetime.datetime.now(datetime.timezone.utc).isoformat(), + "readOnly": True, + "complete": len(errors) == 0, + "scope": { + "builtInCategory": "OST_ElectricalFixtures", + "wholeDocument": True, + "elementTypesExcluded": True, + "includeEmptyParameters": include_empty, + }, + "environment": { + "revitVersionNumber": safe_text(getattr(application, "VersionNumber", None)), + "revitVersionName": safe_text(getattr(application, "VersionName", None)), + "revitSubVersionNumber": safe_text( + getattr(application, "SubVersionNumber", None) + ), + "pythonImplementation": safe_text(getattr(sys.implementation, "name", None)), + "pythonVersion": platform.python_version(), + "assemblies": loaded_assembly_versions(), + }, + "document": { + "title": safe_text(document.Title), + "pathName": safe_text(document.PathName), + "projectInformationUniqueId": safe_text(document.ProjectInformation.UniqueId), + }, + "summary": { + "elementCount": len(source_elements), + "exportedElementCount": len(elements), + "typeCount": len(types_by_unique_id), + "parameterDefinitionCount": len(inventory), + "elementsWithoutMepSpace": elements_without_space, + "elementErrorCount": len(errors), + }, + "parameterInventory": finalize_inventory(inventory), + "types": sorted( + types_by_unique_id.values(), + key=lambda entry: ( + (entry.get("familyName") or "").casefold(), + (entry.get("typeName") or "").casefold(), + entry.get("typeUniqueId") or "", + ), + ), + "elements": elements, + "errors": errors, + } + + +try: + include_empty_input = get_input(1, True) + include_empty = bool(include_empty_input) + try: + max_samples = int(get_input(2, 5)) + except Exception: + max_samples = 5 + max_samples = max(0, min(max_samples, 50)) + + report = build_report(include_empty, max_samples) + output_path = resolve_output_path(get_input(0)) + write_json(output_path, report) + OUT = { + "ok": True, + "filePath": output_path, + "complete": report["complete"], + "summary": report["summary"], + "errors": report["errors"], + } +except Exception as error: + OUT = { + "ok": False, + "error": safe_text(error), + "traceback": traceback.format_exc(), + } diff --git a/dynamo/README.md b/dynamo/README.md new file mode 100644 index 0000000..800eded --- /dev/null +++ b/dynamo/README.md @@ -0,0 +1,69 @@ +# Revit 2026 / Dynamo diagnostics + +This directory contains self-contained Python scripts for a Dynamo **Python +Script** node. They use only Dynamo's built-in Revit integration, the Revit API +and the Python standard library. No Dynamo package is required. + +The scripts are read-only. They do not start a Revit transaction and do not +change the open model. + +## Python engine + +Use the built-in `CPython3` engine in Revit 2026. Autodesk ships Dynamo with +Revit; optional PythonNet3 packages are not required by these diagnostics. + +## 01 - Check model identity + +File: `01_check_model_identity.py` + +The script reports: + +- Revit, Dynamo and Python versions; +- `ProjectInformation.UniqueId` as a native model-identity candidate; +- all occurrences and values of `LB_ModelId` and `LB_ProjectId` on Project + Information; +- all Project Information parameters; +- optional cloud/worksharing identity information when the API exposes it. + +Input `IN[0]` is optional. It may be either an output directory or a complete +`.json` file path. With no input, the report is written below the current +Windows temporary directory in `leistungsbilanz-dynamo`. + +## 02 - Inventory Electrical Fixtures parameters + +File: `02_export_electrical_fixture_parameter_inventory.py` + +The script reads every instance of +`BuiltInCategory.OST_ElectricalFixtures` in the complete current document. It +exports: + +- element, family, type and MEP Space identities; +- every instance parameter and value; +- every unique family-type parameter and value; +- an aggregated parameter inventory with occurrence counts and sample values; +- per-element warnings instead of aborting at the first unreadable element. + +Inputs: + +- `IN[0]` (optional): output directory or complete `.json` path; +- `IN[1]` (optional): include empty parameters, default `true`; +- `IN[2]` (optional): maximum sample values per aggregated parameter, default + `5`. + +The default output location is again the Windows temporary directory. The +generated report can contain model paths and project-specific parameter values; +review it before sharing or committing it. + +## Running a script + +1. Open the target model in Revit 2026. +2. Open Dynamo from **Manage > Visual Programming > Dynamo**. +3. Create a graph and add a **Python Script** node. +4. Select the `CPython3` engine for the node. +5. Copy the complete content of the desired `.py` file into the node. +6. Optionally connect a String node containing the output path to `IN[0]`. +7. Run the graph and inspect `OUT` for status, counts and the generated path. + +For the first test, run `01_check_model_identity.py` in the Revit main model. +Then run the parameter inventory. Keep both generated JSON files so their +structure can be checked before the production snapshot DTO is finalized. diff --git a/next.config.mjs b/next.config.mjs index a6cb01e..e0610b9 100644 --- a/next.config.mjs +++ b/next.config.mjs @@ -11,22 +11,6 @@ const nextConfig = { typescript: { tsconfigPath: "./tsconfig.next.json", }, - poweredByHeader: false, - // Clickjacking: the Config pages hold admin actions, so no foreign page - // may frame the app. Same-origin framing stays allowed. - async headers() { - return [ - { - source: "/:path*", - headers: [ - { key: "X-Frame-Options", value: "SAMEORIGIN" }, - { key: "Content-Security-Policy", value: "frame-ancestors 'self'" }, - { key: "X-Content-Type-Options", value: "nosniff" }, - { key: "Referrer-Policy", value: "same-origin" }, - ], - }, - ]; - }, async rewrites() { return [ { diff --git a/package-lock.json b/package-lock.json index 9d27840..417421b 100644 --- a/package-lock.json +++ b/package-lock.json @@ -12,7 +12,6 @@ "better-sqlite3": "^12.9.0", "bootstrap": "^5.3.8", "drizzle-orm": "^0.45.2", - "exceljs": "^4.4.0", "express": "^5.2.1", "lucide-react": "^1.14.0", "next": "^16.2.4", @@ -876,47 +875,6 @@ "node": ">=18" } }, - "node_modules/@fast-csv/format": { - "version": "4.3.5", - "resolved": "https://registry.npmjs.org/@fast-csv/format/-/format-4.3.5.tgz", - "integrity": "sha512-8iRn6QF3I8Ak78lNAa+Gdl5MJJBM5vRHivFtMRUWINdevNo00K7OXxS2PshawLKTejVwieIlPmK5YlLu6w4u8A==", - "license": "MIT", - "dependencies": { - "@types/node": "^14.0.1", - "lodash.escaperegexp": "^4.1.2", - "lodash.isboolean": "^3.0.3", - "lodash.isequal": "^4.5.0", - "lodash.isfunction": "^3.0.9", - "lodash.isnil": "^4.0.0" - } - }, - "node_modules/@fast-csv/format/node_modules/@types/node": { - "version": "14.18.63", - "resolved": "https://registry.npmjs.org/@types/node/-/node-14.18.63.tgz", - "integrity": "sha512-fAtCfv4jJg+ExtXhvCkCqUKZ+4ok/JQk01qDKhL5BDDoS3AxKXhV5/MAVUZyQnSEd2GT92fkgZl0pz0Q0AzcIQ==", - "license": "MIT" - }, - "node_modules/@fast-csv/parse": { - "version": "4.3.6", - "resolved": "https://registry.npmjs.org/@fast-csv/parse/-/parse-4.3.6.tgz", - "integrity": "sha512-uRsLYksqpbDmWaSmzvJcuApSEe38+6NQZBUsuAyMZKqHxH0g1wcJgsKUvN3WC8tewaqFjBMMGrkHmC+T7k8LvA==", - "license": "MIT", - "dependencies": { - "@types/node": "^14.0.1", - "lodash.escaperegexp": "^4.1.2", - "lodash.groupby": "^4.6.0", - "lodash.isfunction": "^3.0.9", - "lodash.isnil": "^4.0.0", - "lodash.isundefined": "^3.0.1", - "lodash.uniq": "^4.5.0" - } - }, - "node_modules/@fast-csv/parse/node_modules/@types/node": { - "version": "14.18.63", - "resolved": "https://registry.npmjs.org/@types/node/-/node-14.18.63.tgz", - "integrity": "sha512-fAtCfv4jJg+ExtXhvCkCqUKZ+4ok/JQk01qDKhL5BDDoS3AxKXhV5/MAVUZyQnSEd2GT92fkgZl0pz0Q0AzcIQ==", - "license": "MIT" - }, "node_modules/@img/colour": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.1.0.tgz", @@ -1629,87 +1587,6 @@ "node": ">= 0.6" } }, - "node_modules/archiver": { - "version": "5.3.2", - "resolved": "https://registry.npmjs.org/archiver/-/archiver-5.3.2.tgz", - "integrity": "sha512-+25nxyyznAXF7Nef3y0EbBeqmGZgeN/BxHX29Rs39djAfaFalmQ89SE6CWyDCHzGL0yt/ycBtNOmGTW0FyGWNw==", - "license": "MIT", - "dependencies": { - "archiver-utils": "^2.1.0", - "async": "^3.2.4", - "buffer-crc32": "^0.2.1", - "readable-stream": "^3.6.0", - "readdir-glob": "^1.1.2", - "tar-stream": "^2.2.0", - "zip-stream": "^4.1.0" - }, - "engines": { - "node": ">= 10" - } - }, - "node_modules/archiver-utils": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/archiver-utils/-/archiver-utils-2.1.0.tgz", - "integrity": "sha512-bEL/yUb/fNNiNTuUz979Z0Yg5L+LzLxGJz8x79lYmR54fmTIb6ob/hNQgkQnIUDWIFjZVQwl9Xs356I6BAMHfw==", - "license": "MIT", - "dependencies": { - "glob": "^7.1.4", - "graceful-fs": "^4.2.0", - "lazystream": "^1.0.0", - "lodash.defaults": "^4.2.0", - "lodash.difference": "^4.5.0", - "lodash.flatten": "^4.4.0", - "lodash.isplainobject": "^4.0.6", - "lodash.union": "^4.6.0", - "normalize-path": "^3.0.0", - "readable-stream": "^2.0.0" - }, - "engines": { - "node": ">= 6" - } - }, - "node_modules/archiver-utils/node_modules/readable-stream": { - "version": "2.3.8", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz", - "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==", - "license": "MIT", - "dependencies": { - "core-util-is": "~1.0.0", - "inherits": "~2.0.3", - "isarray": "~1.0.0", - "process-nextick-args": "~2.0.0", - "safe-buffer": "~5.1.1", - "string_decoder": "~1.1.1", - "util-deprecate": "~1.0.1" - } - }, - "node_modules/archiver-utils/node_modules/safe-buffer": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", - "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", - "license": "MIT" - }, - "node_modules/archiver-utils/node_modules/string_decoder": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", - "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", - "license": "MIT", - "dependencies": { - "safe-buffer": "~5.1.0" - } - }, - "node_modules/async": { - "version": "3.2.6", - "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz", - "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==", - "license": "MIT" - }, - "node_modules/balanced-match": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", - "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", - "license": "MIT" - }, "node_modules/base64-js": { "version": "1.5.1", "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", @@ -1753,28 +1630,6 @@ "node": "20.x || 22.x || 23.x || 24.x || 25.x" } }, - "node_modules/big-integer": { - "version": "1.6.52", - "resolved": "https://registry.npmjs.org/big-integer/-/big-integer-1.6.52.tgz", - "integrity": "sha512-QxD8cf2eVqJOOz63z6JIN9BzvVs/dlySa5HGSBH5xtR8dPteIRQnBxxKqkNTiT6jbDTF6jAfrd4oMcND9RGbQg==", - "license": "Unlicense", - "engines": { - "node": ">=0.6" - } - }, - "node_modules/binary": { - "version": "0.3.0", - "resolved": "https://registry.npmjs.org/binary/-/binary-0.3.0.tgz", - "integrity": "sha512-D4H1y5KYwpJgK8wk1Cue5LLPgmwHKYSChkbspQg5JtVuR5ulGckxfR62H3AE9UDkdMC8yyXlqYihuz3Aqg2XZg==", - "license": "MIT", - "dependencies": { - "buffers": "~0.1.1", - "chainsaw": "~0.1.0" - }, - "engines": { - "node": "*" - } - }, "node_modules/bindings": { "version": "1.5.0", "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz", @@ -1793,12 +1648,6 @@ "readable-stream": "^3.4.0" } }, - "node_modules/bluebird": { - "version": "3.4.7", - "resolved": "https://registry.npmjs.org/bluebird/-/bluebird-3.4.7.tgz", - "integrity": "sha512-iD3898SR7sWVRHbiQv+sHUtHnMvC1o3nW5rAcqnq3uOn07DSAppZYUkIGslDz6gXC7HfunPe7YVBgoEJASPcHA==", - "license": "MIT" - }, "node_modules/body-parser": { "version": "2.2.2", "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.2.2.tgz", @@ -1840,16 +1689,6 @@ "@popperjs/core": "^2.11.8" } }, - "node_modules/brace-expansion": { - "version": "1.1.21", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.21.tgz", - "integrity": "sha512-9zeA+KLZNNzglF2TPKRQEDyx6Yby7daAkuy8MiPzpXPsYDWi/DRM8jmwUDxokQjYqBpv5DgPiwD4h4ZZSy1Ujw==", - "license": "MIT", - "dependencies": { - "balanced-match": "^1.0.0", - "concat-map": "0.0.1" - } - }, "node_modules/buffer": { "version": "5.7.1", "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz", @@ -1873,38 +1712,12 @@ "ieee754": "^1.1.13" } }, - "node_modules/buffer-crc32": { - "version": "0.2.13", - "resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-0.2.13.tgz", - "integrity": "sha512-VO9Ht/+p3SN7SKWqcrgEzjGbRSJYTx+Q1pTQC0wrWqHx0vpJraQ6GtHx8tvcg1rlK1byhU5gccxgOgj7B0TDkQ==", - "license": "MIT", - "engines": { - "node": "*" - } - }, "node_modules/buffer-from": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz", "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==", "dev": true }, - "node_modules/buffer-indexof-polyfill": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/buffer-indexof-polyfill/-/buffer-indexof-polyfill-1.0.2.tgz", - "integrity": "sha512-I7wzHwA3t1/lwXQh+A5PbNvJxgfo5r3xulgpYDB5zckTu/Z9oUK9biouBKQUjEqzaz3HnAT6TYoovmE+GqSf7A==", - "license": "MIT", - "engines": { - "node": ">=0.10" - } - }, - "node_modules/buffers": { - "version": "0.1.1", - "resolved": "https://registry.npmjs.org/buffers/-/buffers-0.1.1.tgz", - "integrity": "sha512-9q/rDEGSb/Qsvv2qvzIzdluL5k7AaJOTrw23z9reQthrbF7is4CtlT0DXyO1oei2DCp4uojjzQ7igaSHp1kAEQ==", - "engines": { - "node": ">=0.2.0" - } - }, "node_modules/bytes": { "version": "3.1.2", "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz", @@ -1959,18 +1772,6 @@ } ] }, - "node_modules/chainsaw": { - "version": "0.1.0", - "resolved": "https://registry.npmjs.org/chainsaw/-/chainsaw-0.1.0.tgz", - "integrity": "sha512-75kWfWt6MEKNC8xYXIdRpDehRYY/tNSgwKaJq+dbbDcxORuVrrQ+SEHoWsniVn9XPYfP4gmdWIeDk/4YNp1rNQ==", - "license": "MIT/X11", - "dependencies": { - "traverse": ">=0.3.0 <0.4" - }, - "engines": { - "node": "*" - } - }, "node_modules/chownr": { "version": "1.1.4", "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz", @@ -1981,27 +1782,6 @@ "resolved": "https://registry.npmjs.org/client-only/-/client-only-0.0.1.tgz", "integrity": "sha512-IV3Ou0jSMzZrd3pZ48nLkT9DA7Ag1pnPzaiQhpW7c3RbcqqzvzzVu+L8gfqMp/8IM2MQtSiqaCxrrcfu8I8rMA==" }, - "node_modules/compress-commons": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/compress-commons/-/compress-commons-4.1.2.tgz", - "integrity": "sha512-D3uMHtGc/fcO1Gt1/L7i1e33VOvD4A9hfQLP+6ewd+BvG/gQ84Yh4oftEhAdjSMgBgwGL+jsppT7JYNpo6MHHg==", - "license": "MIT", - "dependencies": { - "buffer-crc32": "^0.2.13", - "crc32-stream": "^4.0.2", - "normalize-path": "^3.0.0", - "readable-stream": "^3.6.0" - }, - "engines": { - "node": ">= 10" - } - }, - "node_modules/concat-map": { - "version": "0.0.1", - "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", - "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", - "license": "MIT" - }, "node_modules/content-disposition": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.1.0.tgz", @@ -2038,49 +1818,12 @@ "node": ">=6.6.0" } }, - "node_modules/core-util-is": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz", - "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==", - "license": "MIT" - }, - "node_modules/crc-32": { - "version": "1.2.2", - "resolved": "https://registry.npmjs.org/crc-32/-/crc-32-1.2.2.tgz", - "integrity": "sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ==", - "license": "Apache-2.0", - "bin": { - "crc32": "bin/crc32.njs" - }, - "engines": { - "node": ">=0.8" - } - }, - "node_modules/crc32-stream": { - "version": "4.0.3", - "resolved": "https://registry.npmjs.org/crc32-stream/-/crc32-stream-4.0.3.tgz", - "integrity": "sha512-NT7w2JVU7DFroFdYkeq8cywxrgjPHWkdX1wjpRQXPX5Asews3tA+Ght6lddQO5Mkumffp3X7GEqku3epj2toIw==", - "license": "MIT", - "dependencies": { - "crc-32": "^1.2.0", - "readable-stream": "^3.4.0" - }, - "engines": { - "node": ">= 10" - } - }, "node_modules/csstype": { "version": "3.2.3", "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", "dev": true }, - "node_modules/dayjs": { - "version": "1.11.23", - "resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.23.tgz", - "integrity": "sha512-QDTCU0M0MxR3hQfnlDJfwekQiaanm1ubOD231u73WBckQ/fsamwRLiE2GBz6D3a/xF1NgfiDLJjXBa1hYOYTtQ==", - "license": "MIT" - }, "node_modules/debug": { "version": "4.4.3", "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", @@ -2287,45 +2030,6 @@ "node": ">= 0.4" } }, - "node_modules/duplexer2": { - "version": "0.1.4", - "resolved": "https://registry.npmjs.org/duplexer2/-/duplexer2-0.1.4.tgz", - "integrity": "sha512-asLFVfWWtJ90ZyOUHMqk7/S2w2guQKxUI2itj3d92ADHhxUSbCMGi1f1cBcJ7xM1To+pE/Khbwo1yuNbMEPKeA==", - "license": "BSD-3-Clause", - "dependencies": { - "readable-stream": "^2.0.2" - } - }, - "node_modules/duplexer2/node_modules/readable-stream": { - "version": "2.3.8", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz", - "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==", - "license": "MIT", - "dependencies": { - "core-util-is": "~1.0.0", - "inherits": "~2.0.3", - "isarray": "~1.0.0", - "process-nextick-args": "~2.0.0", - "safe-buffer": "~5.1.1", - "string_decoder": "~1.1.1", - "util-deprecate": "~1.0.1" - } - }, - "node_modules/duplexer2/node_modules/safe-buffer": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", - "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", - "license": "MIT" - }, - "node_modules/duplexer2/node_modules/string_decoder": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", - "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", - "license": "MIT", - "dependencies": { - "safe-buffer": "~5.1.0" - } - }, "node_modules/ee-first": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz", @@ -2428,26 +2132,6 @@ "node": ">= 0.6" } }, - "node_modules/exceljs": { - "version": "4.4.0", - "resolved": "https://registry.npmjs.org/exceljs/-/exceljs-4.4.0.tgz", - "integrity": "sha512-XctvKaEMaj1Ii9oDOqbW/6e1gXknSY4g/aLCDicOXqBE4M0nRWkUu0PTp++UPNzoFY12BNHMfs/VadKIS6llvg==", - "license": "MIT", - "dependencies": { - "archiver": "^5.0.0", - "dayjs": "^1.8.34", - "fast-csv": "^4.3.1", - "jszip": "^3.10.1", - "readable-stream": "^3.6.0", - "saxes": "^5.0.1", - "tmp": "^0.2.0", - "unzipper": "^0.10.11", - "uuid": "^8.3.0" - }, - "engines": { - "node": ">=8.3.0" - } - }, "node_modules/expand-template": { "version": "2.0.3", "resolved": "https://registry.npmjs.org/expand-template/-/expand-template-2.0.3.tgz", @@ -2498,19 +2182,6 @@ "url": "https://opencollective.com/express" } }, - "node_modules/fast-csv": { - "version": "4.3.6", - "resolved": "https://registry.npmjs.org/fast-csv/-/fast-csv-4.3.6.tgz", - "integrity": "sha512-2RNSpuwwsJGP0frGsOmTb9oUF+VkFSM4SyLTDgwf2ciHWTarN0lQTC+F2f/t5J9QjW+c65VFIAAu85GsvMIusw==", - "license": "MIT", - "dependencies": { - "@fast-csv/format": "4.3.5", - "@fast-csv/parse": "4.3.6" - }, - "engines": { - "node": ">=10.0.0" - } - }, "node_modules/file-uri-to-path": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz", @@ -2557,12 +2228,6 @@ "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz", "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==" }, - "node_modules/fs.realpath": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", - "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==", - "license": "ISC" - }, "node_modules/fsevents": { "version": "2.3.3", "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", @@ -2577,22 +2242,6 @@ "node": "^8.16.0 || ^10.6.0 || >=11.0.0" } }, - "node_modules/fstream": { - "version": "1.0.12", - "resolved": "https://registry.npmjs.org/fstream/-/fstream-1.0.12.tgz", - "integrity": "sha512-WvJ193OHa0GHPEL+AycEJgxvBEwyfRkN1vhjca23OaPVMCaLCXTd5qAu82AjTcgP1UJmytkOKb63Ypde7raDIg==", - "deprecated": "This package is no longer supported.", - "license": "ISC", - "dependencies": { - "graceful-fs": "^4.1.2", - "inherits": "~2.0.0", - "mkdirp": ">=0.5 0", - "rimraf": "2" - }, - "engines": { - "node": ">=0.6" - } - }, "node_modules/function-bind": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", @@ -2653,27 +2302,6 @@ "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz", "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==" }, - "node_modules/glob": { - "version": "7.2.3", - "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", - "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", - "deprecated": "Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me", - "license": "ISC", - "dependencies": { - "fs.realpath": "^1.0.0", - "inflight": "^1.0.4", - "inherits": "2", - "minimatch": "^3.1.1", - "once": "^1.3.0", - "path-is-absolute": "^1.0.0" - }, - "engines": { - "node": "*" - }, - "funding": { - "url": "https://github.com/sponsors/isaacs" - } - }, "node_modules/gopd": { "version": "1.2.0", "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", @@ -2685,12 +2313,6 @@ "url": "https://github.com/sponsors/ljharb" } }, - "node_modules/graceful-fs": { - "version": "4.2.11", - "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", - "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", - "license": "ISC" - }, "node_modules/has-symbols": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", @@ -2766,23 +2388,6 @@ } ] }, - "node_modules/immediate": { - "version": "3.0.6", - "resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz", - "integrity": "sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==", - "license": "MIT" - }, - "node_modules/inflight": { - "version": "1.0.6", - "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", - "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==", - "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.", - "license": "ISC", - "dependencies": { - "once": "^1.3.0", - "wrappy": "1" - } - }, "node_modules/inherits": { "version": "2.0.4", "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", @@ -2806,190 +2411,6 @@ "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz", "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==" }, - "node_modules/isarray": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz", - "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==", - "license": "MIT" - }, - "node_modules/jszip": { - "version": "3.10.2", - "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.2.tgz", - "integrity": "sha512-3l+rb15IOWtUhU0H5MFqES/T6Kh7abYwjosBey/vD6hDt8zoEffkSC5Ws5SGtgVw3gBx2NEbhTeSW1+kWkpyTQ==", - "license": "(MIT OR GPL-3.0-or-later)", - "dependencies": { - "lie": "~3.3.0", - "pako": "~1.0.2", - "readable-stream": "~2.3.6", - "setimmediate": "^1.0.5" - } - }, - "node_modules/jszip/node_modules/readable-stream": { - "version": "2.3.8", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz", - "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==", - "license": "MIT", - "dependencies": { - "core-util-is": "~1.0.0", - "inherits": "~2.0.3", - "isarray": "~1.0.0", - "process-nextick-args": "~2.0.0", - "safe-buffer": "~5.1.1", - "string_decoder": "~1.1.1", - "util-deprecate": "~1.0.1" - } - }, - "node_modules/jszip/node_modules/safe-buffer": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", - "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", - "license": "MIT" - }, - "node_modules/jszip/node_modules/string_decoder": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", - "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", - "license": "MIT", - "dependencies": { - "safe-buffer": "~5.1.0" - } - }, - "node_modules/lazystream": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/lazystream/-/lazystream-1.0.1.tgz", - "integrity": "sha512-b94GiNHQNy6JNTrt5w6zNyffMrNkXZb3KTkCZJb2V1xaEGCk093vkZ2jk3tpaeP33/OiXC+WvK9AxUebnf5nbw==", - "license": "MIT", - "dependencies": { - "readable-stream": "^2.0.5" - }, - "engines": { - "node": ">= 0.6.3" - } - }, - "node_modules/lazystream/node_modules/readable-stream": { - "version": "2.3.8", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz", - "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==", - "license": "MIT", - "dependencies": { - "core-util-is": "~1.0.0", - "inherits": "~2.0.3", - "isarray": "~1.0.0", - "process-nextick-args": "~2.0.0", - "safe-buffer": "~5.1.1", - "string_decoder": "~1.1.1", - "util-deprecate": "~1.0.1" - } - }, - "node_modules/lazystream/node_modules/safe-buffer": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", - "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", - "license": "MIT" - }, - "node_modules/lazystream/node_modules/string_decoder": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", - "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", - "license": "MIT", - "dependencies": { - "safe-buffer": "~5.1.0" - } - }, - "node_modules/lie": { - "version": "3.3.0", - "resolved": "https://registry.npmjs.org/lie/-/lie-3.3.0.tgz", - "integrity": "sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==", - "license": "MIT", - "dependencies": { - "immediate": "~3.0.5" - } - }, - "node_modules/listenercount": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/listenercount/-/listenercount-1.0.1.tgz", - "integrity": "sha512-3mk/Zag0+IJxeDrxSgaDPy4zZ3w05PRZeJNnlWhzFz5OkX49J4krc+A8X2d2M69vGMBEX0uyl8M+W+8gH+kBqQ==", - "license": "ISC" - }, - "node_modules/lodash.defaults": { - "version": "4.2.0", - "resolved": "https://registry.npmjs.org/lodash.defaults/-/lodash.defaults-4.2.0.tgz", - "integrity": "sha512-qjxPLHd3r5DnsdGacqOMU6pb/avJzdh9tFX2ymgoZE27BmjXrNy/y4LoaiTeAb+O3gL8AfpJGtqfX/ae2leYYQ==", - "license": "MIT" - }, - "node_modules/lodash.difference": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/lodash.difference/-/lodash.difference-4.5.0.tgz", - "integrity": "sha512-dS2j+W26TQ7taQBGN8Lbbq04ssV3emRw4NY58WErlTO29pIqS0HmoT5aJ9+TUQ1N3G+JOZSji4eugsWwGp9yPA==", - "license": "MIT" - }, - "node_modules/lodash.escaperegexp": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/lodash.escaperegexp/-/lodash.escaperegexp-4.1.2.tgz", - "integrity": "sha512-TM9YBvyC84ZxE3rgfefxUWiQKLilstD6k7PTGt6wfbtXF8ixIJLOL3VYyV/z+ZiPLsVxAsKAFVwWlWeb2Y8Yyw==", - "license": "MIT" - }, - "node_modules/lodash.flatten": { - "version": "4.4.0", - "resolved": "https://registry.npmjs.org/lodash.flatten/-/lodash.flatten-4.4.0.tgz", - "integrity": "sha512-C5N2Z3DgnnKr0LOpv/hKCgKdb7ZZwafIrsesve6lmzvZIRZRGaZ/l6Q8+2W7NaT+ZwO3fFlSCzCzrDCFdJfZ4g==", - "license": "MIT" - }, - "node_modules/lodash.groupby": { - "version": "4.6.0", - "resolved": "https://registry.npmjs.org/lodash.groupby/-/lodash.groupby-4.6.0.tgz", - "integrity": "sha512-5dcWxm23+VAoz+awKmBaiBvzox8+RqMgFhi7UvX9DHZr2HdxHXM/Wrf8cfKpsW37RNrvtPn6hSwNqurSILbmJw==", - "license": "MIT" - }, - "node_modules/lodash.isboolean": { - "version": "3.0.3", - "resolved": "https://registry.npmjs.org/lodash.isboolean/-/lodash.isboolean-3.0.3.tgz", - "integrity": "sha512-Bz5mupy2SVbPHURB98VAcw+aHh4vRV5IPNhILUCsOzRmsTmSQ17jIuqopAentWoehktxGd9e/hbIXq980/1QJg==", - "license": "MIT" - }, - "node_modules/lodash.isequal": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/lodash.isequal/-/lodash.isequal-4.5.0.tgz", - "integrity": "sha512-pDo3lu8Jhfjqls6GkMgpahsF9kCyayhgykjyLMNFTKWrpVdAQtYyB4muAMWozBB4ig/dtWAmsMxLEI8wuz+DYQ==", - "deprecated": "This package is deprecated. Use require('node:util').isDeepStrictEqual instead.", - "license": "MIT" - }, - "node_modules/lodash.isfunction": { - "version": "3.0.9", - "resolved": "https://registry.npmjs.org/lodash.isfunction/-/lodash.isfunction-3.0.9.tgz", - "integrity": "sha512-AirXNj15uRIMMPihnkInB4i3NHeb4iBtNg9WRWuK2o31S+ePwwNmDPaTL3o7dTJ+VXNZim7rFs4rxN4YU1oUJw==", - "license": "MIT" - }, - "node_modules/lodash.isnil": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/lodash.isnil/-/lodash.isnil-4.0.0.tgz", - "integrity": "sha512-up2Mzq3545mwVnMhTDMdfoG1OurpA/s5t88JmQX809eH3C8491iu2sfKhTfhQtKY78oPNhiaHJUpT/dUDAAtng==", - "license": "MIT" - }, - "node_modules/lodash.isplainobject": { - "version": "4.0.6", - "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz", - "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==", - "license": "MIT" - }, - "node_modules/lodash.isundefined": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/lodash.isundefined/-/lodash.isundefined-3.0.1.tgz", - "integrity": "sha512-MXB1is3s899/cD8jheYYE2V9qTHwKvt+npCwpD+1Sxm3Q3cECXCiYHjeHWXNwr6Q0SOBPrYUDxendrO6goVTEA==", - "license": "MIT" - }, - "node_modules/lodash.union": { - "version": "4.6.0", - "resolved": "https://registry.npmjs.org/lodash.union/-/lodash.union-4.6.0.tgz", - "integrity": "sha512-c4pB2CdGrGdjMKYLA+XiRDO7Y0PRQbm/Gzg8qMj+QH+pFVAoTp5sBpO0odL3FjoPCGjK96p6qsP+yQoiLoOBcw==", - "license": "MIT" - }, - "node_modules/lodash.uniq": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/lodash.uniq/-/lodash.uniq-4.5.0.tgz", - "integrity": "sha512-xfBaXQd9ryd9dlSDvnvI0lvxfLJlYAZzXomUYzLKtUeOQvOP5piqAWuGtrhWeqaXK9hhoM/iyJc5AV+XfsX3HQ==", - "license": "MIT" - }, "node_modules/lucide-react": { "version": "1.14.0", "resolved": "https://registry.npmjs.org/lucide-react/-/lucide-react-1.14.0.tgz", @@ -3059,18 +2480,6 @@ "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/minimatch": { - "version": "3.1.5", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", - "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", - "license": "ISC", - "dependencies": { - "brace-expansion": "^1.1.7" - }, - "engines": { - "node": "*" - } - }, "node_modules/minimist": { "version": "1.2.8", "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", @@ -3079,18 +2488,6 @@ "url": "https://github.com/sponsors/ljharb" } }, - "node_modules/mkdirp": { - "version": "0.5.6", - "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz", - "integrity": "sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw==", - "license": "MIT", - "dependencies": { - "minimist": "^1.2.6" - }, - "bin": { - "mkdirp": "bin/cmd.js" - } - }, "node_modules/mkdirp-classic": { "version": "0.5.3", "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz", @@ -3194,15 +2591,6 @@ "node": ">=10" } }, - "node_modules/normalize-path": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", - "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", - "license": "MIT", - "engines": { - "node": ">=0.10.0" - } - }, "node_modules/object-inspect": { "version": "1.13.4", "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz", @@ -3233,12 +2621,6 @@ "wrappy": "1" } }, - "node_modules/pako": { - "version": "1.0.11", - "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz", - "integrity": "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==", - "license": "(MIT AND Zlib)" - }, "node_modules/parseurl": { "version": "1.3.3", "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz", @@ -3247,15 +2629,6 @@ "node": ">= 0.8" } }, - "node_modules/path-is-absolute": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", - "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==", - "license": "MIT", - "engines": { - "node": ">=0.10.0" - } - }, "node_modules/path-to-regexp": { "version": "8.4.2", "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.4.2.tgz", @@ -3323,12 +2696,6 @@ "node": ">=10" } }, - "node_modules/process-nextick-args": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz", - "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==", - "license": "MIT" - }, "node_modules/proxy-addr": { "version": "2.0.7", "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz", @@ -3432,36 +2799,6 @@ "node": ">= 6" } }, - "node_modules/readdir-glob": { - "version": "1.1.3", - "resolved": "https://registry.npmjs.org/readdir-glob/-/readdir-glob-1.1.3.tgz", - "integrity": "sha512-v05I2k7xN8zXvPD9N+z/uhXPaj0sUFCe2rcWZIpBsqxfP7xXFQ0tipAd/wjj1YxWyWtUS5IDJpOG82JKt2EAVA==", - "license": "Apache-2.0", - "dependencies": { - "minimatch": "^5.1.0" - } - }, - "node_modules/readdir-glob/node_modules/brace-expansion": { - "version": "2.1.7", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.7.tgz", - "integrity": "sha512-uZbew1NqdmPDTMJ8ah1y+b+9QEJrfkXFk3RcTQw3X0jW/xRUvFKsg1CfQdSYGdTbXZWExtU3J3ccxtnfw1Fi0g==", - "license": "MIT", - "dependencies": { - "balanced-match": "^1.0.0" - } - }, - "node_modules/readdir-glob/node_modules/minimatch": { - "version": "5.1.9", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz", - "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==", - "license": "ISC", - "dependencies": { - "brace-expansion": "^2.0.1" - }, - "engines": { - "node": ">=10" - } - }, "node_modules/resolve-pkg-maps": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz", @@ -3471,19 +2808,6 @@ "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1" } }, - "node_modules/rimraf": { - "version": "2.7.1", - "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.7.1.tgz", - "integrity": "sha512-uWjbaKIK3T1OSVptzX7Nl6PvQ3qAGtKEtVRjRuazjfL3Bx5eI409VZSqgND+4UNnmzLVdPj9FqFJNPqBZFve4w==", - "deprecated": "Rimraf versions prior to v4 are no longer supported", - "license": "ISC", - "dependencies": { - "glob": "^7.1.3" - }, - "bin": { - "rimraf": "bin.js" - } - }, "node_modules/router": { "version": "2.2.0", "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz", @@ -3523,18 +2847,6 @@ "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==" }, - "node_modules/saxes": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/saxes/-/saxes-5.0.1.tgz", - "integrity": "sha512-5LBh1Tls8c9xgGjw3QrMwETmTMVk0oFgvrFSvWx62llR2hcEInrKNZ2GZCCuuy2lvWrdl5jhbpeqc5hRYKFOcw==", - "license": "ISC", - "dependencies": { - "xmlchars": "^2.2.0" - }, - "engines": { - "node": ">=10" - } - }, "node_modules/scheduler": { "version": "0.27.0", "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.27.0.tgz", @@ -3594,12 +2906,6 @@ "url": "https://opencollective.com/express" } }, - "node_modules/setimmediate": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz", - "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==", - "license": "MIT" - }, "node_modules/setprototypeof": { "version": "1.2.0", "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", @@ -3859,15 +3165,6 @@ "node": ">=6" } }, - "node_modules/tmp": { - "version": "0.2.7", - "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.2.7.tgz", - "integrity": "sha512-e0votIpp4Uo2AJYSzVHV6xCcawuiez3DzqDAbrTc3YxBkplN6e+dM13ZeIcZnDg/QpSuU2zfZ3rzwY8ukEnaXw==", - "license": "MIT", - "engines": { - "node": ">=14.14" - } - }, "node_modules/toidentifier": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz", @@ -3876,15 +3173,6 @@ "node": ">=0.6" } }, - "node_modules/traverse": { - "version": "0.3.9", - "resolved": "https://registry.npmjs.org/traverse/-/traverse-0.3.9.tgz", - "integrity": "sha512-iawgk0hLP3SxGKDfnDJf8wTz4p2qImnyihM5Hh/sGvQ3K37dPi/w8sRhdNIxYA1TwFwc5mDhIJq+O0RsvXBKdQ==", - "license": "MIT/X11", - "engines": { - "node": "*" - } - }, "node_modules/tslib": { "version": "2.8.1", "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", @@ -4418,69 +3706,11 @@ "node": ">= 0.8" } }, - "node_modules/unzipper": { - "version": "0.10.14", - "resolved": "https://registry.npmjs.org/unzipper/-/unzipper-0.10.14.tgz", - "integrity": "sha512-ti4wZj+0bQTiX2KmKWuwj7lhV+2n//uXEotUmGuQqrbVZSEGFMbI68+c6JCQ8aAmUWYvtHEz2A8K6wXvueR/6g==", - "license": "MIT", - "dependencies": { - "big-integer": "^1.6.17", - "binary": "~0.3.0", - "bluebird": "~3.4.1", - "buffer-indexof-polyfill": "~1.0.0", - "duplexer2": "~0.1.4", - "fstream": "^1.0.12", - "graceful-fs": "^4.2.2", - "listenercount": "~1.0.1", - "readable-stream": "~2.3.6", - "setimmediate": "~1.0.4" - } - }, - "node_modules/unzipper/node_modules/readable-stream": { - "version": "2.3.8", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz", - "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==", - "license": "MIT", - "dependencies": { - "core-util-is": "~1.0.0", - "inherits": "~2.0.3", - "isarray": "~1.0.0", - "process-nextick-args": "~2.0.0", - "safe-buffer": "~5.1.1", - "string_decoder": "~1.1.1", - "util-deprecate": "~1.0.1" - } - }, - "node_modules/unzipper/node_modules/safe-buffer": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", - "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", - "license": "MIT" - }, - "node_modules/unzipper/node_modules/string_decoder": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", - "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", - "license": "MIT", - "dependencies": { - "safe-buffer": "~5.1.0" - } - }, "node_modules/util-deprecate": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==" }, - "node_modules/uuid": { - "version": "8.3.2", - "resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz", - "integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==", - "deprecated": "uuid@10 and below is no longer supported. For ESM codebases, update to uuid@latest. For CommonJS codebases, use uuid@11 (but be aware this version will likely be deprecated in 2028).", - "license": "MIT", - "bin": { - "uuid": "dist/bin/uuid" - } - }, "node_modules/vary": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz", @@ -4494,47 +3724,6 @@ "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==" }, - "node_modules/xmlchars": { - "version": "2.2.0", - "resolved": "https://registry.npmjs.org/xmlchars/-/xmlchars-2.2.0.tgz", - "integrity": "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==", - "license": "MIT" - }, - "node_modules/zip-stream": { - "version": "4.1.1", - "resolved": "https://registry.npmjs.org/zip-stream/-/zip-stream-4.1.1.tgz", - "integrity": "sha512-9qv4rlDiopXg4E69k+vMHjNN63YFMe9sZMrdlvKnCjlCRWeCBswPPMPUfx+ipsAWq1LXHe70RcbaHdJJpS6hyQ==", - "license": "MIT", - "dependencies": { - "archiver-utils": "^3.0.4", - "compress-commons": "^4.1.2", - "readable-stream": "^3.6.0" - }, - "engines": { - "node": ">= 10" - } - }, - "node_modules/zip-stream/node_modules/archiver-utils": { - "version": "3.0.4", - "resolved": "https://registry.npmjs.org/archiver-utils/-/archiver-utils-3.0.4.tgz", - "integrity": "sha512-KVgf4XQVrTjhyWmx6cte4RxonPLR9onExufI1jhvw/MQ4BB6IsZD5gT8Lq+u/+pRkWna/6JoHpiQioaqFP5Rzw==", - "license": "MIT", - "dependencies": { - "glob": "^7.2.3", - "graceful-fs": "^4.2.0", - "lazystream": "^1.0.0", - "lodash.defaults": "^4.2.0", - "lodash.difference": "^4.5.0", - "lodash.flatten": "^4.4.0", - "lodash.isplainobject": "^4.0.6", - "lodash.union": "^4.6.0", - "normalize-path": "^3.0.0", - "readable-stream": "^3.6.0" - }, - "engines": { - "node": ">= 10" - } - }, "node_modules/zod": { "version": "4.4.1", "resolved": "https://registry.npmjs.org/zod/-/zod-4.4.1.tgz", diff --git a/package.json b/package.json index 17837f1..414eb53 100644 --- a/package.json +++ b/package.json @@ -24,10 +24,10 @@ "test": "node scripts/run-tests.mjs", "test:watch": "node scripts/run-tests.mjs --watch", "db:generate": "drizzle-kit generate", - "db:migrate": "node scripts/run-migrations.js", + "db:migrate": "drizzle-kit migrate", "db:backup": "tsx scripts/db-backup.ts", "db:verify:circuit-schema": "node scripts/db-verify-circuit-schema.js", - "revit:verify-reference": "tsx scripts/verify-revit-reference-xlsx.ts" + "revit:verify-reference": "tsx scripts/verify-revit-reference-csv.ts" }, "keywords": [], "author": "", @@ -36,7 +36,6 @@ "better-sqlite3": "^12.9.0", "bootstrap": "^5.3.8", "drizzle-orm": "^0.45.2", - "exceljs": "^4.4.0", "express": "^5.2.1", "lucide-react": "^1.14.0", "next": "^16.2.4", diff --git a/scripts/db-verify-circuit-schema.js b/scripts/db-verify-circuit-schema.js index fa91cc4..947767a 100644 --- a/scripts/db-verify-circuit-schema.js +++ b/scripts/db-verify-circuit-schema.js @@ -6,9 +6,6 @@ const db = new Database(dbPath, { readonly: true }); const requiredTables = [ "buildings", - "estimate_balances", - "estimate_groups", - "estimate_rows", "circuit_sections", "circuits", "circuit_device_rows", diff --git a/scripts/run-migrations.js b/scripts/run-migrations.js index 3a6fc84..ebbed8a 100644 --- a/scripts/run-migrations.js +++ b/scripts/run-migrations.js @@ -4,65 +4,13 @@ const Database = require('better-sqlite3'); const fs = require('node:fs'); const path = require('node:path'); -const dataDir = path.resolve( - process.env.LEISTUNGSBILANZ_DATA_DIR || 'data' -); +const dataDir = path.resolve('data'); if (!fs.existsSync(dataDir)) fs.mkdirSync(dataDir, { recursive: true }); -const databasePath = path.join(dataDir, 'leistungsbilanz.db'); +const sqlite = new Database(path.join(dataDir, 'leistungsbilanz.db')); +const db = drizzle(sqlite); -async function run() { - const sqlite = new Database(databasePath); - try { - if (requiresLinearXlsxBackup(sqlite)) { - const backupDir = path.join(dataDir, 'backups'); - fs.mkdirSync(backupDir, { recursive: true }); - const timestamp = new Date().toISOString().replace(/[:.]/g, '-'); - const backupPath = path.join( - backupDir, - `leistungsbilanz-before-linear-xlsx-${timestamp}.db` - ); - await sqlite.backup(backupPath); - verifyBackup(backupPath); - console.log(`Verified pre-migration backup created: ${backupPath}`); - } +migrate(db, { migrationsFolder: path.resolve('src/db/migrations') }); +sqlite.close(); - migrate(drizzle(sqlite), { - migrationsFolder: path.resolve('src/db/migrations'), - }); - } finally { - sqlite.close(); - } - console.log('Migrations applied'); -} - -function requiresLinearXlsxBackup(sqlite) { - const tables = new Set( - sqlite.prepare("SELECT name FROM sqlite_master WHERE type = 'table'") - .all() - .map((row) => row.name) - ); - return tables.has('external_csv_configurations') && - !tables.has('external_model_configurations'); -} - -function verifyBackup(backupPath) { - const backup = new Database(backupPath, { readonly: true, fileMustExist: true }); - try { - const integrity = backup.pragma('integrity_check', { simple: true }); - const foreignKeyViolations = backup.pragma('foreign_key_check'); - if (integrity !== 'ok' || foreignKeyViolations.length > 0) { - throw new Error( - `Pre-migration backup verification failed: integrity=${integrity}, ` + - `foreign-key violations=${foreignKeyViolations.length}` - ); - } - } finally { - backup.close(); - } -} - -run().catch((error) => { - console.error('Migration failed:', error instanceof Error ? error.message : error); - process.exit(1); -}); +console.log('Migrations applied'); diff --git a/scripts/verify-revit-reference-csv.ts b/scripts/verify-revit-reference-csv.ts new file mode 100644 index 0000000..07d605b --- /dev/null +++ b/scripts/verify-revit-reference-csv.ts @@ -0,0 +1,81 @@ +import assert from "node:assert/strict"; +import { readFileSync } from "node:fs"; +import { resolve } from "node:path"; +import { createHash } from "node:crypto"; +import { createDefaultExternalCsvConfiguration } from "../src/external-model/csv/external-csv-contracts.js"; +import { + parseExternalCsv, + serializeExternalCsv, +} from "../src/external-model/csv/external-csv-transport.js"; +import { createExternalCsvPreview } from "../src/external-model/application/external-csv-preview.js"; + +const filePath = resolve( + process.argv[2] ?? "docs/spec/ELT Stromkreisnummernvergabe-Check_DIV.csv" +); +const source = readFileSync(filePath); +const configuration = createDefaultExternalCsvConfiguration({ + ifcGuid: "IfcGUID", + roomNumber: "MEP-Raum: Nummer", + roomName: "MEP-Raum: Name", + familyAndType: "Familie und Typ", + selectionMarker: "CAx_Auswahlkenner", + circuitIdentifier: "kbp_Stromkreisnummer", + power: "kbp-E-Elektrische Leistung", + quantity: null, +}); +configuration.additionalSourceMappings = [ + { sourceColumn: "CAx_Anmerkung", targetField: "sourceRemark" }, + { sourceColumn: "kbp-E-Spannung", targetField: "sourceVoltage" }, + { sourceColumn: "kbp-E-Stromstärke", targetField: "sourceCurrent" }, + { sourceColumn: "kbp-E-Versorgung von ELT", targetField: "sourceElectricalSupply" }, + { sourceColumn: "kbp-E-Versorgung von MSR/GLT", targetField: "sourceControlSupply" }, +]; + +const document = parseExternalCsv(source, configuration); +const counts = Object.fromEntries( + ["metadata", "header", "passthrough", "object", "suspect-object"].map( + (classification) => [ + classification, + document.rows.filter((row) => row.classification === classification).length, + ] + ) +); +const nonEmptyPassthroughRows = document.rows.filter( + (row) => + row.classification === "passthrough" && + row.cells.some((cell) => cell.value !== "") +).length; +const serialized = serializeExternalCsv(document); +const preview = createExternalCsvPreview({ + fileName: filePath, + bytes: source, + configuration, +}); + +assert.equal(counts.object, 897, "Expected 897 object rows."); +assert.equal(preview.objectCount, 897, "Expected 897 preview objects."); +assert.equal(nonEmptyPassthroughRows, 211, "Expected 211 non-empty passthrough rows."); +assert.equal(counts["suspect-object"], 0, "Expected no suspect object rows."); +assert.equal( + Buffer.compare(Buffer.from(serialized), source), + 0, + "Expected a byte-identical CSV round-trip." +); + +const sha256 = createHash("sha256").update(source).digest("hex"); +process.stdout.write( + `${JSON.stringify( + { + file: filePath, + bytes: source.length, + sha256, + dialect: document.dialect, + rows: counts, + nonEmptyPassthroughRows, + roundTripByteIdentical: true, + previewObjectCount: preview.objectCount, + }, + null, + 2 + )}\n` +); diff --git a/scripts/verify-revit-reference-xlsx.ts b/scripts/verify-revit-reference-xlsx.ts deleted file mode 100644 index ed568d4..0000000 --- a/scripts/verify-revit-reference-xlsx.ts +++ /dev/null @@ -1,162 +0,0 @@ -import assert from "node:assert/strict"; -import { createHash } from "node:crypto"; -import { mkdirSync, readFileSync, writeFileSync } from "node:fs"; -import { dirname, resolve } from "node:path"; -import ExcelJS from "exceljs"; -import { - createDefaultExternalXlsxTransportConfiguration, - type ExternalXlsxScalar, -} from "../src/external-model/xlsx/external-xlsx-contracts.js"; -import { - createExternalXlsxReturn, - parseExternalXlsx, -} from "../src/external-model/xlsx/external-xlsx-transport.js"; - -async function main() { -const inputPath = resolve( - process.argv[2] ?? "docs/spec/kbp-Stromkreis.xlsx" -); -const outputPath = resolve( - process.argv[3] ?? "data/revit-reference/kbp-Stromkreis-R2-Rueckgabe.xlsx" -); -assert.notEqual( - inputPath, - outputPath, - "Eingabe- und Ausgabedatei müssen verschieden sein." -); - -const source = readFileSync(inputPath); -const configuration = createDefaultExternalXlsxTransportConfiguration(); -const document = await parseExternalXlsx({ - fileName: inputPath, - bytes: source, - configuration, -}); -const objectRows = document.rows.filter((row) => row.classification === "object"); -const suspectRows = document.rows.filter( - (row) => row.classification === "suspect-object" -); -const worksharingIdColumn = document.columns.find( - (column) => column.header === configuration.columns.worksharingId -)?.columnNumber; -assert.ok(worksharingIdColumn, "Worksharing-ID-Spalte wurde nicht aufgelöst."); - -assert.equal(objectRows.length, 487, "Es werden 487 Objektzeilen erwartet."); -assert.equal(suspectRows.length, 0, "Es werden keine verdächtigen Zeilen erwartet."); -assert.equal( - document.columns.filter((column) => column.comment !== null).length, - 14, - "Es werden 14 Kopfzeilenkommentare erwartet." -); -assert.equal( - document.issues.filter((issue) => issue.code === "duplicate-ifc-guid").length, - 0, - "Die Musterdatei darf keine exakten IfcGUID-Duplikate enthalten." -); - -const testValues = [ - { - circuitCombined: "UV_R2_TEST-2F1", - electricalPowerW: 111, - voltageV: 230, - currentA: 0.48, - }, - { - circuitCombined: "UV_R2_TEST-2F2", - electricalPowerW: 222, - voltageV: 230, - currentA: 0.97, - }, - { - circuitCombined: "UV_R2_TEST-3F1", - electricalPowerW: 333, - voltageV: 400, - currentA: 0.48, - }, -] satisfies Record[]; - -const updates = testValues.map((values, index) => { - const value = objectRows[index]?.cells[worksharingIdColumn - 1]?.value; - if (typeof value !== "string") { - throw new Error("Worksharing-ID muss Text sein."); - } - return { worksharingId: value, values }; -}); -const result = await createExternalXlsxReturn({ - fileName: inputPath, - bytes: source, - configuration, - updates, -}); -assert.equal(result.exportedObjectCount, 487); -mkdirSync(dirname(outputPath), { recursive: true }); -writeFileSync(outputPath, result.bytes); - -const outputDocument = await parseExternalXlsx({ - fileName: outputPath, - bytes: result.bytes, - configuration, -}); -assert.equal( - outputDocument.rows.filter((row) => row.classification === "object").length, - 487 -); -assert.equal( - outputDocument.rows.some((row) => row.classification !== "object"), - false, - "Die Rückgabedatei darf keine Summen- oder Hinweiszeilen enthalten." -); -assert.equal(outputDocument.sheetName, document.sheetName); -assert.deepEqual( - outputDocument.columns, - document.columns, - "Kopfzeilen, Kommentare und Spaltenbreiten müssen erhalten bleiben." -); -assert.deepEqual( - outputDocument.rows.slice(updates.length).map((row) => row.cells), - objectRows.slice(updates.length).map((row) => row.cells), - "Nicht geänderte Objektzellen müssen Wert, Typ und Zahlenformat behalten." -); -const outputWorkbook = new ExcelJS.Workbook(); -await outputWorkbook.xlsx.load(result.bytes as never); -const commentedCells: string[] = []; -outputWorkbook.worksheets[0].eachRow({ includeEmpty: true }, (row) => { - row.eachCell({ includeEmpty: true }, (cell) => { - if (cell.note !== undefined) commentedCells.push(cell.address); - }); -}); -assert.equal( - commentedCells.length, - 14, - "Nur die 14 Kopfzellen dürfen Kommentare enthalten." -); -assert.equal( - commentedCells.every((address) => address.endsWith("1")), - true, - "Datenzellen dürfen keine Kommentare enthalten." -); - -process.stdout.write( - `${JSON.stringify( - { - input: inputPath, - output: outputPath, - inputBytes: source.length, - outputBytes: result.bytes.length, - inputSha256: createHash("sha256").update(source).digest("hex"), - outputSha256: createHash("sha256").update(result.bytes).digest("hex"), - sheetName: document.sheetName, - objectCount: objectRows.length, - headerCommentCount: document.columns.filter( - (column) => column.comment !== null - ).length, - exactDuplicateIfcGuidCount: 0, - changedObjectCount: updates.length, - }, - null, - 2 - )}\n` -); -} - -void main(); diff --git a/src/app/config/benutzer/page.tsx b/src/app/config/benutzer/page.tsx deleted file mode 100644 index 134890d..0000000 --- a/src/app/config/benutzer/page.tsx +++ /dev/null @@ -1,325 +0,0 @@ -"use client"; - -import { useCallback, useEffect, useState } from "react"; -import { userApi, type UserDto, type UserRole } from "../../../frontend/utils/auth-api"; -import { useAuth } from "../../../frontend/components/AuthProvider"; -import { USER_ROLES, USER_ROLE_LABEL } from "../../../shared/constants/user-roles"; - -const zeitpunkt = new Intl.DateTimeFormat("de-DE", { - dateStyle: "short", - timeStyle: "short", -}); - -export default function BenutzerPage() { - const { user: currentUser } = useAuth(); - const [users, setUsers] = useState([]); - const [loading, setLoading] = useState(true); - const [error, setError] = useState(null); - const [busyUserId, setBusyUserId] = useState(null); - const [resetPasswordFor, setResetPasswordFor] = useState(null); - - const load = useCallback(async () => { - setLoading(true); - try { - const rows = await userApi.list(); - setUsers(rows); - setError(null); - } catch (err) { - setError(err instanceof Error ? err.message : "Benutzer konnten nicht geladen werden."); - } finally { - setLoading(false); - } - }, []); - - useEffect(() => { - void load(); - }, [load]); - - async function withBusy(userId: string, action: () => Promise) { - setBusyUserId(userId); - setError(null); - try { - await action(); - } catch (err) { - setError(err instanceof Error ? err.message : "Aktion fehlgeschlagen."); - } finally { - setBusyUserId(null); - } - } - - async function changeRole(item: UserDto, role: UserRole) { - await withBusy(item.id, async () => { - const updated = await userApi.update(item.id, { role }); - setUsers((list) => list.map((row) => (row.id === updated.id ? updated : row))); - }); - } - - async function toggleActive(item: UserDto) { - await withBusy(item.id, async () => { - const updated = await userApi.update(item.id, { active: !item.active }); - setUsers((list) => list.map((row) => (row.id === updated.id ? updated : row))); - }); - } - - return ( -
-
-

- Benutzer -

-
-

- Es gibt kein Self-Signup: Jeder Zugang wird hier bewusst von einem - Administrator angelegt. Das Startpasswort wird direkt eingetragen; die - Person muss es beim ersten Anmelden durch ein eigenes ersetzen. -

- - { - setUsers((list) => [...list, created]); - }} - /> - - {error &&

{error}

} - {loading &&

Lädt…

} - - {!loading && users.length > 0 && ( - - - - - - - - - - - - - - {users.map((item) => { - const isSelf = item.id === currentUser?.id; - const busy = busyUserId === item.id; - return ( - - - - - - - - - - ); - })} - -
NameAnmeldenameRolleAktivStatusAngelegtAktionen
{item.name}{item.username} - - - void toggleActive(item)} - /> - {item.mustChangePassword ? "Muss Passwort setzen" : "In Ordnung"}{zeitpunkt.format(new Date(item.createdAt))} - -
- )} - - {!loading && users.length === 0 &&

Noch keine Benutzer angelegt.

} - - {resetPasswordFor && ( - setResetPasswordFor(null)} - onDone={(updated) => { - setUsers((list) => list.map((row) => (row.id === updated.id ? updated : row))); - setResetPasswordFor(null); - }} - /> - )} -
- ); -} - -function NeuerBenutzerFormular({ onCreated }: { onCreated: (created: UserDto) => void }) { - const [username, setUsername] = useState(""); - const [name, setName] = useState(""); - const [role, setRole] = useState("user"); - const [initialPassword, setInitialPassword] = useState(""); - const [error, setError] = useState(null); - const [submitting, setSubmitting] = useState(false); - - async function handleSubmit(event: React.FormEvent) { - event.preventDefault(); - setSubmitting(true); - setError(null); - try { - const created = await userApi.create({ username, name, role, initialPassword }); - onCreated(created); - setUsername(""); - setName(""); - setRole("user"); - setInitialPassword(""); - } catch (err) { - setError(err instanceof Error ? err.message : "Benutzer konnte nicht angelegt werden."); - } finally { - setSubmitting(false); - } - } - - return ( -
-
- - setUsername(event.target.value)} - required - /> -
-
- - setName(event.target.value)} - required - /> -
-
- - -
-
- - setInitialPassword(event.target.value)} - minLength={8} - required - /> -
-
- -
- {error && ( -
-

{error}

-
- )} -
- ); -} - -function PasswortZuruecksetzenDialog({ - item, - onClose, - onDone, -}: { - item: UserDto; - onClose: () => void; - onDone: (updated: UserDto) => void; -}) { - const [newPassword, setNewPassword] = useState(""); - const [error, setError] = useState(null); - const [submitting, setSubmitting] = useState(false); - - async function handleSubmit(event: React.FormEvent) { - event.preventDefault(); - setSubmitting(true); - setError(null); - try { - const updated = await userApi.resetPassword(item.id, newPassword); - onDone(updated); - } catch (err) { - setError(err instanceof Error ? err.message : "Passwort konnte nicht zurückgesetzt werden."); - } finally { - setSubmitting(false); - } - } - - return ( -
-
-

Passwort zurücksetzen für {item.name}

-
- - setNewPassword(event.target.value)} - minLength={8} - autoFocus - required - /> -
- {error &&

{error}

} -
- - -
-
-
- ); -} diff --git a/src/app/config/konto/page.tsx b/src/app/config/konto/page.tsx deleted file mode 100644 index 2b58ee7..0000000 --- a/src/app/config/konto/page.tsx +++ /dev/null @@ -1,103 +0,0 @@ -"use client"; - -import { useState } from "react"; -import { authApi } from "../../../frontend/utils/auth-api"; -import { useAuth } from "../../../frontend/components/AuthProvider"; -import { USER_ROLE_LABEL } from "../../../shared/constants/user-roles"; - -export default function KontoPage() { - const { user } = useAuth(); - const [currentPassword, setCurrentPassword] = useState(""); - const [newPassword, setNewPassword] = useState(""); - const [newPasswordRepeat, setNewPasswordRepeat] = useState(""); - const [error, setError] = useState(null); - const [success, setSuccess] = useState(false); - const [submitting, setSubmitting] = useState(false); - - async function handleSubmit(event: React.FormEvent) { - event.preventDefault(); - if (newPassword !== newPasswordRepeat) { - setError("Die beiden neuen Passwörter stimmen nicht überein."); - return; - } - setSubmitting(true); - setError(null); - setSuccess(false); - try { - await authApi.changePassword(currentPassword, newPassword); - setCurrentPassword(""); - setNewPassword(""); - setNewPasswordRepeat(""); - setSuccess(true); - } catch (err) { - setError(err instanceof Error ? err.message : "Passwort konnte nicht geändert werden."); - } finally { - setSubmitting(false); - } - } - - return ( -
-

Konto

- {user && ( -

- Angemeldet als {user.name} ({user.username}) ·{" "} - {USER_ROLE_LABEL[user.role]} -

- )} - -

Passwort ändern

-
-
- - setCurrentPassword(event.target.value)} - autoComplete="current-password" - required - /> -
-
- - setNewPassword(event.target.value)} - autoComplete="new-password" - minLength={8} - required - /> -
-
- - setNewPasswordRepeat(event.target.value)} - autoComplete="new-password" - minLength={8} - required - /> -
- {error &&

{error}

} - {success &&

Passwort wurde geändert.

} - -
-
- ); -} diff --git a/src/app/config/layout.tsx b/src/app/config/layout.tsx deleted file mode 100644 index 72d9b6d..0000000 --- a/src/app/config/layout.tsx +++ /dev/null @@ -1,52 +0,0 @@ -"use client"; - -import Link from "next/link"; -import { usePathname, useRouter } from "next/navigation"; -import { useEffect } from "react"; -import { useAuth } from "../../frontend/components/AuthProvider"; -import { - getConfigRedirect, - getConfigTabs, -} from "../../frontend/utils/config-access"; - -export default function ConfigLayout({ children }: { children: React.ReactNode }) { - const pathname = usePathname(); - const router = useRouter(); - const { status, isAdmin } = useAuth(); - const tabs = getConfigTabs(isAdmin); - const redirectTarget = getConfigRedirect(pathname, isAdmin); - - useEffect(() => { - if (status !== "signed-in") return; - if (redirectTarget) router.replace(redirectTarget); - }, [status, redirectTarget, router]); - - if ( - status !== "signed-in" || - redirectTarget !== null - ) { - return null; - } - - return ( -
-
-

Config

-
- - - - {children} -
- ); -} diff --git a/src/app/config/page.tsx b/src/app/config/page.tsx deleted file mode 100644 index 3c9d8fd..0000000 --- a/src/app/config/page.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export default function ConfigPage() { - return null; -} diff --git a/src/app/globals.css b/src/app/globals.css index 67985f4..d5f9f4a 100644 --- a/src/app/globals.css +++ b/src/app/globals.css @@ -323,24 +323,23 @@ a { } .sidebar-footer { - padding-top: 12px; + padding: 12px; border-top: 1px solid rgba(255, 255, 255, 0.12); } -/* Square and icon-only so it fits next to Abmelden in .sidebar-bottom-row. */ .sidebar-theme-toggle { display: flex; align-items: center; - justify-content: center; - flex: 0 0 auto; - width: 36px; - height: 36px; - padding: 0; + gap: 10px; + padding: 10px 14px; border-radius: 8px; color: #c7d6e0; font-size: 0.92rem; + font-weight: 500; border: 1px solid rgba(255, 255, 255, 0.16); background: rgba(255, 255, 255, 0.06); + width: 100%; + text-align: left; cursor: pointer; } @@ -452,25 +451,13 @@ a { background: var(--color-bg); } -.filter-panel-row { +.filter-panel-header { display: flex; align-items: center; gap: 10px; } -/* Expanded: the fields carry a label above their input, so toggle and - count sit on the input line (bottom) instead of the label line. */ -.filter-panel-row-expanded { - align-items: flex-end; -} - -.filter-panel-row-expanded .filter-panel-toggle, -.filter-panel-row-expanded .filter-panel-count { - margin-bottom: calc((2.1rem - 24px) / 2); -} - -.filter-panel-row .filter-panel-toggle { - flex: 0 0 auto; +.filter-panel-header .filter-panel-toggle { width: 24px; height: 24px; padding: 0; @@ -480,7 +467,7 @@ a { color: var(--color-ink-soft); } -.filter-panel-row .filter-panel-toggle:hover { +.filter-panel-header .filter-panel-toggle:hover { background: var(--color-surface); } @@ -515,11 +502,10 @@ a { .filter-bar { display: flex; - flex: 1 1 auto; - min-width: 0; flex-wrap: wrap; align-items: flex-end; gap: var(--space-sm) var(--space-md); + margin-top: 0.5rem; } .filter-bar-field, @@ -1128,17 +1114,6 @@ a.kpi:hover { border-style: dashed; } -.project-device-item > summary { - display: flex; - flex-direction: column; - gap: 0.1rem; - cursor: grab; -} - -.project-device-item > summary::marker { - color: var(--text-faint); -} - .sidebar-actions { display: flex; flex-direction: column; @@ -1562,24 +1537,10 @@ a.kpi:hover { background: var(--panel-bg-subtle); } -.tree-grid .feeder-circuit-row td:nth-child(2) { - font-weight: 600; -} - .tree-grid .device-row td:first-child { color: var(--text-faint); } -.tree-grid .downstream-board-load-row td { - background: var(--panel-bg-subtle); - color: var(--text-muted); - font-style: italic; -} - -.tree-grid .downstream-board-load-row td:nth-child(2) { - padding-left: 1.5rem; -} - .tree-grid .empty-circuit-row td { background: var(--panel-bg-subtle); } @@ -2041,842 +2002,3 @@ button.structure-entry-main:focus-visible { color: var(--color-ink-soft); font-size: 0.9rem; } - -/* ── Grobe Leistungsbilanz ──────────────────────────────────────────── */ -/* Tabelle im Stil der Büro-Vorlage „Leistungsbilanz – KG400“: kompakte - Zellen-Inputs statt Bootstrap-Formularfelder, Druck als A4 quer. */ - -.estimate-toolbar { - display: flex; - align-items: center; - flex-wrap: wrap; - gap: var(--space-sm); -} - -.estimate-save-status { - display: inline-flex; - align-items: center; - flex-wrap: wrap; - gap: var(--space-sm); - font-size: 0.8rem; -} - -.estimate-save-badge { - display: inline-block; - padding: 0.2rem 0.55rem; - border-radius: 999px; - font-weight: 600; - border: 1px solid var(--color-border); - color: var(--color-ink-soft); - background: var(--color-bg); -} - -.estimate-save-badge.is-saved { - color: var(--color-signal-dark); - border-color: var(--color-signal); -} - -.estimate-save-badge.is-busy { - color: var(--color-warn); - border-color: var(--color-warn); -} - -.estimate-save-badge.is-error { - color: var(--color-danger); - border-color: var(--color-danger); - background: var(--color-danger-bg); -} - -.estimate-save-hint { - color: var(--color-danger); -} - -.estimate-header-fields { - display: flex; - flex-wrap: wrap; - gap: var(--space-sm) var(--space-lg); - margin-bottom: var(--space-md); -} - -.estimate-header-field { - display: flex; - align-items: center; - gap: var(--space-sm); - min-width: 10rem; -} - -.estimate-header-field.is-wide { - flex: 1 1 18rem; -} - -.estimate-header-label { - font-size: 0.7rem; - letter-spacing: 0.06em; - text-transform: uppercase; - font-weight: 600; - color: var(--color-ink-soft); -} - -.estimate-header-value { - font-weight: 600; -} - -.estimate-header-input { - font-size: 0.95rem; - font-weight: 600; - border-color: var(--panel-border); -} - -.estimate-sheet-wrap { - overflow-x: auto; -} - -.estimate-sheet { - width: 100%; - min-width: 1400px; - table-layout: fixed; - border-collapse: collapse; - font-size: 0.82rem; - background: var(--panel-bg); - color: var(--text-strong); -} - -.estimate-comparison { - min-width: 640px; - table-layout: auto; -} - -.estimate-sheet th, -.estimate-sheet td { - border: 1px solid var(--panel-border); - padding: 2px 4px; - vertical-align: middle; -} - -.estimate-sheet thead th { - background: var(--surface-header-row); - font-size: 0.72rem; - font-weight: 700; - text-align: center; - line-height: 1.2; -} - -.estimate-th-hint { - display: block; - font-size: 0.68rem; - font-weight: 400; - color: var(--text-faint); -} - -.estimate-col-kg { width: 3rem; } -.estimate-col-supply { width: 4rem; } -.estimate-col-name { width: auto; } -.estimate-col-quantity { width: 4.8rem; } -.estimate-col-unit { width: 3.8rem; } -.estimate-col-connection { width: 5rem; } -.estimate-col-power { width: 6.4rem; } -.estimate-col-gzf { width: 6.8rem; } -.estimate-col-cosphi { width: 3.8rem; } -.estimate-col-result { width: 4.6rem; } -.estimate-col-sv { width: 3.2rem; } -.estimate-col-remark { width: 9rem; } -.estimate-col-actions { width: 4.5rem; } - -.estimate-cell-input, -.estimate-cell-select { - width: 100%; - min-width: 0; - border: 1px solid transparent; - border-radius: 3px; - background: transparent; - color: inherit; - font: inherit; - padding: 1px 4px; - line-height: 1.4; -} - -.estimate-cell-select { - padding-right: 0; - cursor: pointer; -} - -.estimate-cell-input:hover:not(:disabled), -.estimate-cell-select:hover:not(:disabled) { - border-color: var(--panel-border-strong); -} - -.estimate-cell-input:focus, -.estimate-cell-select:focus { - outline: none; - border-color: var(--accent-blue); - background: var(--panel-bg); - box-shadow: 0 0 0 2px var(--accent-blue-soft-bg); -} - -.estimate-cell-input.is-numeric { - text-align: right; - font-variant-numeric: tabular-nums; -} - -.estimate-cell-input.is-invalid, -.estimate-cell-input.is-invalid:focus, -.estimate-cell-input.is-invalid:hover { - border-color: var(--color-danger); - background: var(--color-danger-bg); -} - -.estimate-cell-input::placeholder { - color: var(--text-faint); - opacity: 0.7; -} - -.estimate-unit-input, -.estimate-gzf-input { - display: flex; - align-items: center; - gap: 2px; -} - -.estimate-unit-label { - flex: 0 0 auto; - font-size: 0.7rem; - color: var(--text-faint); - min-width: 1.9rem; -} - -.estimate-amev-button { - flex: 0 0 auto; - border: 1px solid var(--panel-border-strong); - border-radius: 3px; - background: var(--panel-bg-subtle); - color: var(--text-subtle); - font-size: 0.6rem; - font-weight: 700; - letter-spacing: 0.03em; - padding: 1px 3px; - line-height: 1.3; -} - -.estimate-amev-button:hover:not(:disabled) { - border-color: var(--accent-blue); - color: var(--accent-blue); -} - -.estimate-number { - text-align: right; - font-variant-numeric: tabular-nums; - white-space: nowrap; -} - -.estimate-number.is-muted { - color: var(--text-faint); -} - -.estimate-number.is-over { - color: var(--color-attention-dark); -} - -.estimate-number.is-under { - color: var(--color-signal-dark); -} - -.estimate-center { - text-align: center; -} - -.estimate-cost-group-cell { - font-weight: 700; - text-align: center; - font-variant-numeric: tabular-nums; -} - -.estimate-group-title-row td { - background: var(--surface-component-header); - font-weight: 700; -} - -.estimate-group-title { - display: flex; - align-items: center; - flex-wrap: wrap; - gap: var(--space-xs) var(--space-lg); -} - -.estimate-group-name { - font-size: 0.9rem; -} - -.estimate-group-editor { - display: inline-flex; - align-items: center; - gap: var(--space-xs); - font-weight: 400; - font-size: 0.75rem; - color: var(--text-muted); -} - -.estimate-group-editor .estimate-cell-input { - width: 12rem; -} - -.estimate-group-actions { - display: flex; - justify-content: flex-end; - gap: 2px; -} - -.estimate-row-actions { - display: flex; - justify-content: center; - gap: 2px; - white-space: nowrap; -} - -.estimate-group-title-row .estimate-actions-cell { - width: auto; - white-space: nowrap; -} - -.estimate-icon-button { - display: inline-flex; - align-items: center; - justify-content: center; - padding: 0.15rem 0.3rem; - line-height: 1; -} - -.estimate-actions-cell { - text-align: center; -} - -.estimate-empty-row td { - color: var(--text-faint); - font-style: italic; -} - -.estimate-subtotal-row td { - background: var(--panel-bg-subtle); - font-weight: 700; -} - -.estimate-total-label { - text-align: right; - font-weight: 700; -} - -.estimate-total-hint { - font-weight: 400; - color: var(--text-faint); -} - -.estimate-total-row td { - background: var(--surface-header-row); - font-weight: 600; -} - -.estimate-total-row.is-strong td { - font-weight: 800; - border-top: 2px solid var(--panel-border-strong); -} - -.estimate-add-group-row td { - background: var(--panel-bg); - padding: var(--space-sm) 4px; -} - -.estimate-unassigned-row td { - font-style: italic; - color: var(--text-muted); -} - -.estimate-collapse-toggle { - display: inline-flex; - align-items: center; - gap: var(--space-xs); - border: 0; - background: transparent; - color: inherit; - font: inherit; - font-weight: 700; - padding: 0; -} - -.estimate-list-table .estimate-number { - font-variant-numeric: tabular-nums; -} - -/* Druck-Textwerte: auf dem Bildschirm unsichtbar, im Druck statt Inputs */ -.estimate-print-value { - display: none; -} - -/* Ausrichtung: alle Zellen zentriert, nur „Verbraucher / Flächen“, die - Gruppentitel und die Summenbeschriftungen stehen links bzw. rechts. */ -.estimate-sheet td, -.estimate-sheet td.estimate-number, -.estimate-sheet .estimate-cell-input, -.estimate-sheet .estimate-cell-input.is-numeric { - text-align: center; -} - -.estimate-sheet .estimate-cell-select { - text-align: center; - text-align-last: center; -} - -.estimate-sheet .estimate-unit-input, -.estimate-sheet .estimate-gzf-input { - justify-content: center; -} - -.estimate-sheet td.estimate-name-cell, -.estimate-sheet td.estimate-name-cell .estimate-cell-input, -.estimate-sheet .estimate-group-title-row td:not(.estimate-cost-group-cell), -.estimate-comparison td:nth-child(2) { - text-align: left; -} - -.estimate-sheet td.estimate-total-label { - text-align: right; -} - -/* Druck im kbp-CD der Seitenansicht (src/frontend/print/print-document.css): - gleiche Farben, Schrift, Titelblock und Fußzeile. Die Fußzeile mit - Seitenzahlen setzt EstimatePrintHeader als @page-Regel mit Projektdaten. */ -.estimate-print-titleblock { - display: none; -} - -@page estimate-balance { - size: A4 landscape; - margin: 10mm 10mm 13mm; -} - -@media print { - body:has(.estimate-print-root) .sidebar, - .estimate-print-root .estimate-no-print, - .estimate-print-root .estimate-page-header, - .estimate-print-root .estimate-header-fields, - .estimate-print-root .alert, - .estimate-print-root input, - .estimate-print-root select, - .estimate-print-root button { - display: none !important; - } - - html:has(.estimate-print-root), - body:has(.estimate-print-root), - body:has(.estimate-print-root) .app-shell, - body:has(.estimate-print-root) .app-shell-content { - background: #fff !important; - } - - /* Der Dunkelmodus setzt color-scheme: dark; Chrome färbt damit auch den - Seitenrand dunkel. Im Druck gilt immer das helle Schema. */ - html:has(.estimate-print-root) { - color-scheme: light !important; - } - - .estimate-print-root .estimate-group-editor.is-empty { - display: none; - } - - /* Verbraucher bekommt den Platz; Anmerkungen bleiben schmal. */ - .estimate-sheet .estimate-col-name { - width: 52mm; - } - - .estimate-sheet .estimate-col-remark { - width: 24mm; - } - - .estimate-sheet .estimate-col-supply { - width: 13mm; - } - - body:has(.estimate-print-root) .app-shell { - display: block; - } - - .estimate-print-root { - --ep-blue: #476088; - --ep-lilac: #9198c4; - --ep-line: #d6dae5; - --ep-tint: #f5f6fa; - --ep-text: #2b2b2b; - --ep-muted: #6b7280; - --ep-accent: #c9782a; - page: estimate-balance; - padding: 0 !important; - max-width: none; - color: var(--ep-text); - font-family: Arial, "Helvetica Neue", Helvetica, sans-serif; - color-scheme: light; - } - - .estimate-print-root * { - -webkit-print-color-adjust: exact; - print-color-adjust: exact; - } - - .estimate-print-root .estimate-print-value { - display: inline; - } - - /* Titelblock wie der Plankopf der Seitenansicht */ - .estimate-print-titleblock { - display: grid; - grid-template-columns: 30mm 1fr auto auto; - margin-bottom: 4mm; - border: 1.5px solid var(--ep-blue); - background: #fff; - font-size: 8.5pt; - break-inside: avoid; - } - - .estimate-print-titleblock > * { - padding: 2.5mm 3.5mm; - border-left: 1px solid var(--ep-line); - } - - .estimate-print-titleblock > :first-child { - border-left: none; - } - - .estimate-print-logo { - display: flex; - align-items: center; - justify-content: center; - min-height: 16mm; - color: var(--ep-blue); - font-weight: bold; - text-align: center; - } - - .estimate-print-logo img { - max-width: 100%; - max-height: 10mm; - } - - .estimate-print-kicker { - color: var(--ep-muted); - font-size: 7pt; - letter-spacing: 0.05em; - text-transform: uppercase; - } - - .estimate-print-heading { - display: flex; - align-items: baseline; - flex-wrap: wrap; - gap: 1mm 4mm; - margin-top: 1mm; - } - - .estimate-print-stand { - color: var(--ep-blue); - font-size: 16pt; - font-weight: bold; - } - - .estimate-print-project { - font-size: 12pt; - font-weight: bold; - } - - .estimate-print-meta { - display: grid; - grid-template-columns: auto auto; - gap: 0.8mm 4mm; - align-content: center; - margin: 0; - font-size: 7.5pt; - } - - .estimate-print-meta div { - display: contents; - } - - .estimate-print-meta dt { - color: var(--ep-muted); - font-weight: normal; - } - - .estimate-print-meta dd { - margin: 0; - font-weight: bold; - } - - .estimate-print-meta.is-tinted { - background: var(--ep-tint); - } - - /* Karten und Ränder der Bildschirmansicht entfallen */ - .estimate-print-root .card { - border: 0; - box-shadow: none !important; - background: transparent; - } - - .estimate-print-root .card-body, - .estimate-print-root .card-header { - padding: 0; - background: transparent; - border: 0; - } - - .estimate-print-root .estimate-comparison-card { - margin-top: 6mm; - break-inside: avoid; - } - - .estimate-print-root .estimate-comparison-card .card-header { - margin-bottom: 2mm; - color: var(--ep-blue); - font-size: 10pt; - font-weight: bold; - } - - .estimate-sheet-wrap { - overflow: visible; - } - - /* Tabelle */ - .estimate-sheet { - min-width: 0; - table-layout: auto; - font-size: 7.4pt; - line-height: 1.2; - background: #fff; - color: var(--ep-text); - } - - .estimate-sheet th, - .estimate-sheet td { - border: 1px solid var(--ep-line) !important; - padding: 0.7mm 1.5mm; - background: #fff; - color: var(--ep-text); - } - - .estimate-sheet thead { - display: table-header-group; - } - - .estimate-sheet thead th { - background: var(--ep-blue) !important; - border-color: var(--ep-blue) !important; - color: #fff !important; - font-weight: bold; - vertical-align: bottom; - } - - .estimate-sheet thead .estimate-th-hint { - color: #dfe3f0 !important; - } - - .estimate-group-title-row td { - background: var(--ep-tint) !important; - border-top: 1.5px solid var(--ep-lilac) !important; - font-weight: bold; - } - - .estimate-group-title-row .estimate-cost-group-cell { - color: var(--ep-blue) !important; - } - - .estimate-group-title-row .estimate-group-editor { - color: var(--ep-muted); - font-weight: normal; - } - - .estimate-subtotal-row td { - border-bottom: 1.5px solid var(--ep-line) !important; - font-weight: bold; - } - - .estimate-subtotal-row .estimate-total-label { - color: var(--ep-muted); - } - - .estimate-total-row td { - background: var(--ep-tint) !important; - font-weight: bold; - } - - .estimate-total-row.is-strong td { - background: var(--ep-blue) !important; - border-color: var(--ep-blue) !important; - color: #fff !important; - } - - .estimate-total-row .estimate-total-hint { - color: var(--ep-muted); - font-weight: normal; - } - - .estimate-total-row.is-strong .estimate-total-hint { - color: #dfe3f0; - } - - .estimate-comparison .is-over { - color: var(--ep-accent) !important; - font-weight: bold; - } - - .estimate-comparison .is-under { - color: var(--ep-blue) !important; - font-weight: bold; - } - - .estimate-group-title-row, - .estimate-subtotal-row, - .estimate-total-row, - .estimate-row { - break-inside: avoid; - } - - .estimate-group-title-row { - break-after: avoid; - } - - /* Summen einmal am Ende, nicht auf jeder Seite */ - .estimate-sheet tfoot { - display: table-row-group; - break-inside: avoid; - } - - .estimate-col-actions { - width: 0; - } - - .estimate-unit-input, - .estimate-gzf-input { - justify-content: center; - } -} - -/* ── Anmeldung (Sidebar-Config-Link, Identität, Login-Gate) ─────────── */ - -.sidebar-nav-bottom { - flex: 0 0 auto; - border-top: 1px solid rgba(255, 255, 255, 0.12); -} - -.sidebar-identity { - display: flex; - flex-direction: column; - gap: 1px; - padding: 8px 14px 10px; -} - -.sidebar-identity-label { - font-size: 0.66rem; - letter-spacing: 0.08em; - text-transform: uppercase; - color: rgba(199, 214, 224, 0.7); -} - -.sidebar-identity-name { - font-size: 0.88rem; - font-weight: 600; - color: #fff; - overflow: hidden; - text-overflow: ellipsis; - white-space: nowrap; -} - -/* Toggle (square) and Abmelden (fills the rest) share one row. */ -.sidebar-bottom-row { - display: flex; - align-items: stretch; - gap: 8px; - padding: 0 14px 12px; -} - -.sidebar-logout { - display: flex; - align-items: center; - justify-content: center; - flex: 1 1 auto; - min-width: 0; - padding: 8px 14px; - border-radius: 8px; - color: #c7d6e0; - font-size: 0.85rem; - font-weight: 500; - border: 1px solid rgba(255, 255, 255, 0.16); - background: transparent; - cursor: pointer; -} - -.sidebar-logout:hover { - background: rgba(255, 255, 255, 0.1); - color: #fff; -} - -.sidebar-collapsed .sidebar-identity { - display: none; -} - -.sidebar-collapsed .sidebar-bottom-row { - justify-content: center; - padding-inline: 0; -} - -.login-gate-screen { - min-height: 100vh; - display: flex; - align-items: center; - justify-content: center; - padding: var(--space-md); - background: linear-gradient( - 160deg, - var(--color-primary-deep) 0%, - var(--color-primary-dark) 45%, - var(--color-primary) 100% - ); -} - -.login-gate-card { - width: 100%; - max-width: 360px; - padding: 28px 26px; -} - -.config-tabs { - display: flex; - gap: 4px; - border-bottom: 1px solid var(--color-border, rgba(0, 0, 0, 0.12)); - margin-bottom: var(--space-md); -} - -.config-tab { - padding: 8px 16px; - border-radius: 6px 6px 0 0; - color: inherit; - text-decoration: none; - font-size: 0.9rem; - font-weight: 500; - opacity: 0.7; -} - -.config-tab:hover { - opacity: 1; - text-decoration: none; -} - -.config-tab.active { - opacity: 1; - box-shadow: inset 0 -2px 0 var(--color-primary); -} - -.modal-backdrop-inline { - position: fixed; - inset: 0; - background: rgba(0, 0, 0, 0.45); - display: flex; - align-items: center; - justify-content: center; - z-index: 1050; -} diff --git a/src/app/layout.tsx b/src/app/layout.tsx index c830c99..cd2407b 100644 --- a/src/app/layout.tsx +++ b/src/app/layout.tsx @@ -3,8 +3,6 @@ import Script from "next/script"; import "bootstrap/dist/css/bootstrap.min.css"; import "./globals.css"; import { AppShell } from "../frontend/components/AppShell"; -import { AuthProvider } from "../frontend/components/AuthProvider"; -import { LoginGate } from "../frontend/components/LoginGate"; export const metadata: Metadata = { title: "Leistungsbilanz", @@ -38,11 +36,7 @@ export default function RootLayout({ children }: Readonly<{ children: React.Reac - - - {children} - - + {children} ); diff --git a/src/app/projects/[projectId]/grobbilanz/[balanceId]/page.tsx b/src/app/projects/[projectId]/grobbilanz/[balanceId]/page.tsx deleted file mode 100644 index 933449d..0000000 --- a/src/app/projects/[projectId]/grobbilanz/[balanceId]/page.tsx +++ /dev/null @@ -1,896 +0,0 @@ -"use client"; - -import Link from "next/link"; -import { useParams, useRouter } from "next/navigation"; -import { type MouseEvent, useCallback, useEffect, useRef, useState } from "react"; -import { - ArrowLeft, - ChevronDown, - ChevronRight, - Printer, - Redo2, - RefreshCw, - Undo2, -} from "lucide-react"; -import { - ApiRequestError, - createProjectDevice, - getEstimateBalance, - getEstimateComparison, - getProject, - getProjectHistory, - isRevisionConflictError, - listProjectDevices, - redoProjectCommand, - undoProjectCommand, - updateEstimateBalance, -} from "../../../../../frontend/utils/api"; -import type { - EstimateBalanceDto, - EstimateComparisonDto, - CreateProjectDeviceInput, - ProjectDto, - ProjectDeviceDto, - ProjectHistoryStateDto, -} from "../../../../../frontend/types"; -import type { - EstimateGroupSnapshot, - EstimateRowSnapshot, -} from "../../../../../shared/estimate-balance/estimate-balance"; -import { GzfPickerModal } from "../../../../../frontend/components/gzf-picker-modal"; -import { ProjectDeviceModal } from "../../../../../frontend/components/project-device-modal"; -import { - addEstimateGroup, - estimateBalanceFingerprint, - estimateTextLimits, - normalizeEstimateSortOrder, - toSaveableEstimateBalance, - updateEstimateGroup, - updateEstimateRow, - validateEstimateBalance, -} from "../../../../../frontend/estimate-balance/estimate-balance-document"; -import { - formatGermanNumber, - formatIsoDateGerman, -} from "../../../../../frontend/estimate-balance/estimate-balance-format"; -import { createEstimateProjectDeviceInitialValues } from "../../../../../frontend/estimate-balance/estimate-project-device-prefill"; -import { - EstimateBalanceSheet, - type EstimateBalanceUpdate, -} from "../../../../../frontend/estimate-balance/estimate-balance-sheet"; -import { EstimateComparisonTable } from "../../../../../frontend/estimate-balance/estimate-comparison-table"; -import { DraftInput } from "../../../../../frontend/estimate-balance/estimate-draft-input"; -import { EstimatePrintHeader } from "../../../../../frontend/estimate-balance/estimate-print-header"; -import { - EstimateGroupModal, - type EstimateGroupFormValues, -} from "../../../../../frontend/estimate-balance/estimate-group-modal"; - -const AUTOSAVE_DELAY_MS = 800; -const CONFLICT_MESSAGE = "Die Bilanz wurde zwischenzeitlich geändert und neu geladen."; - -type SaveStatus = "saved" | "pending" | "saving" | "error" | "invalid"; - -type GroupDialog = { group: EstimateGroupSnapshot | null }; -type ProjectDeviceDialog = { - group: EstimateGroupSnapshot; - row: EstimateRowSnapshot; -}; - -function errorMessage(error: unknown, fallback: string) { - return error instanceof Error && error.message ? error.message : fallback; -} - -function isNotFoundError(error: unknown) { - return error instanceof ApiRequestError && error.status === 404; -} - -export default function EstimateBalanceEditorPage() { - const params = useParams<{ projectId: string; balanceId: string }>(); - const { projectId, balanceId } = params; - const router = useRouter(); - - const [project, setProject] = useState(null); - const [draft, setDraft] = useState(null); - const [history, setHistory] = useState(null); - const [comparison, setComparison] = useState(null); - const [comparisonError, setComparisonError] = useState(null); - const [isComparisonOpen, setIsComparisonOpen] = useState(false); - const [saveStatus, setSaveStatus] = useState("saved"); - const [saveError, setSaveError] = useState(null); - const [error, setError] = useState(null); - const [notice, setNotice] = useState(null); - const [isLoading, setIsLoading] = useState(true); - const [isMissing, setIsMissing] = useState(false); - const [isHistoryBusy, setIsHistoryBusy] = useState(false); - const [invalidFieldKeys, setInvalidFieldKeys] = useState>( - () => new Set() - ); - const [groupDialog, setGroupDialog] = useState(null); - const [gzfTarget, setGzfTarget] = useState<{ groupId: string; rowId: string } | null>( - null - ); - const [projectDeviceDialog, setProjectDeviceDialog] = - useState(null); - const [projectDevices, setProjectDevices] = useState([]); - const [isPreparingProjectDevice, setIsPreparingProjectDevice] = useState(false); - const [isSavingProjectDevice, setIsSavingProjectDevice] = useState(false); - - // Refs carry the latest values into timers, unload handlers and chained - // async saves without re-creating them. - const draftRef = useRef(null); - const revisionRef = useRef(null); - const savedFingerprintRef = useRef(null); - const saveInFlightRef = useRef | null>(null); - const saveTimerRef = useRef | null>(null); - - useEffect(() => { - draftRef.current = draft; - }, [draft]); - - const applyServerBalance = useCallback((balance: EstimateBalanceDto) => { - const normalized = normalizeEstimateSortOrder(balance); - savedFingerprintRef.current = estimateBalanceFingerprint(normalized); - draftRef.current = normalized; - setDraft(normalized); - setSaveStatus("saved"); - setSaveError(null); - }, []); - - const reloadComparison = useCallback(async () => { - try { - setComparison(await getEstimateComparison(projectId, balanceId)); - setComparisonError(null); - } catch (err) { - setComparisonError( - errorMessage(err, "Der Vergleich konnte nicht geladen werden.") - ); - } - }, [balanceId, projectId]); - - /** Reloads project, document and history; replaces the local draft. */ - const reloadAll = useCallback(async () => { - const balanceRequest = getEstimateBalance(projectId, balanceId); - // Handled below; avoids an "unhandled rejection" while project/history load. - balanceRequest.catch(() => undefined); - // Project and history are applied even when the balance is missing, so - // Redo stays available after its creation was undone. - const [currentProject, currentHistory] = await Promise.all([ - getProject(projectId), - getProjectHistory(projectId).catch(() => null), - ]); - setProject(currentProject); - revisionRef.current = currentHistory?.currentRevision ?? currentProject.currentRevision; - setHistory(currentHistory); - const balance = await balanceRequest; - applyServerBalance(balance); - setIsMissing(false); - void reloadComparison(); - }, [applyServerBalance, balanceId, projectId, reloadComparison]); - - const handleReloadError = useCallback((err: unknown) => { - if (isNotFoundError(err)) { - setIsMissing(true); - setDraft(null); - draftRef.current = null; - return; - } - setError(errorMessage(err, "Die grobe Leistungsbilanz konnte nicht geladen werden.")); - }, []); - - useEffect(() => { - if (!projectId || !balanceId) { - return; - } - setIsLoading(true); - reloadAll() - .then(() => setError(null)) - .catch(handleReloadError) - .finally(() => setIsLoading(false)); - }, [balanceId, handleReloadError, projectId, reloadAll]); - - const clearSaveTimer = useCallback(() => { - if (saveTimerRef.current) { - clearTimeout(saveTimerRef.current); - saveTimerRef.current = null; - } - }, []); - - /** - * Saves the current draft if it differs from the last saved state. Saves - * never overlap: a save requested while another runs waits for it and then - * saves whatever changed in the meantime. Resolves to false when the draft - * could not be saved. - */ - const saveNow = useCallback(async (): Promise => { - clearSaveTimer(); - while (saveInFlightRef.current) { - await saveInFlightRef.current; - } - const current = draftRef.current; - const revision = revisionRef.current; - if (!current || revision === null) { - return true; - } - const fingerprint = estimateBalanceFingerprint(current); - if (fingerprint === savedFingerprintRef.current) { - setSaveStatus("saved"); - return true; - } - const problems = validateEstimateBalance(current); - if (problems.length) { - setSaveStatus("invalid"); - setSaveError(problems.join(" ")); - return false; - } - const body = toSaveableEstimateBalance(current); - - /** - * Another command changed the project revision. When this document is - * still unchanged on the server (e.g. an edit in a circuit list), the - * draft is kept and saved again; otherwise the server state wins. - */ - async function resolveConflict(): Promise<"retry" | "reloaded"> { - const [currentProject, serverBalance, currentHistory] = await Promise.all([ - getProject(projectId), - getEstimateBalance(projectId, balanceId), - getProjectHistory(projectId).catch(() => null), - ]); - setProject(currentProject); - setHistory(currentHistory); - revisionRef.current = currentHistory?.currentRevision ?? currentProject.currentRevision; - if (estimateBalanceFingerprint(serverBalance) === savedFingerprintRef.current) { - return "retry"; - } - applyServerBalance(serverBalance); - setNotice(CONFLICT_MESSAGE); - void reloadComparison(); - return "reloaded"; - } - - const run = (async () => { - setSaveStatus("saving"); - for (let attempt = 0; ; attempt += 1) { - try { - const result = await updateEstimateBalance( - projectId, - body, - attempt === 0 ? revision : revisionRef.current ?? revision - ); - if (!("unchanged" in result)) { - revisionRef.current = result.history.currentRevision; - setHistory(result.history); - setProject((currentProject) => - currentProject - ? { ...currentProject, currentRevision: result.history.currentRevision } - : currentProject - ); - } - // The sent document is the saved state; the local draft is kept so - // typing is never interrupted by the server's copy. - savedFingerprintRef.current = fingerprint; - setSaveError(null); - const latest = draftRef.current; - if (latest && estimateBalanceFingerprint(latest) !== fingerprint) { - setSaveStatus("pending"); - } else { - setSaveStatus("saved"); - } - void reloadComparison(); - return true; - } catch (err) { - if (isRevisionConflictError(err)) { - try { - if (attempt === 0 && (await resolveConflict()) === "retry") { - continue; - } - if (attempt > 0) { - await reloadAll(); - setNotice(CONFLICT_MESSAGE); - } - } catch (reloadError) { - handleReloadError(reloadError); - } - return false; - } - if (isNotFoundError(err)) { - handleReloadError(err); - return false; - } - setSaveStatus("error"); - setSaveError(errorMessage(err, "Die Änderungen konnten nicht gespeichert werden.")); - return false; - } - } - })(); - saveInFlightRef.current = run; - try { - return await run; - } finally { - saveInFlightRef.current = null; - } - }, [ - applyServerBalance, - balanceId, - clearSaveTimer, - handleReloadError, - projectId, - reloadAll, - reloadComparison, - ]); - - // Debounced autosave after every change of the draft. - useEffect(() => { - if (!draft) { - return; - } - if (estimateBalanceFingerprint(draft) === savedFingerprintRef.current) { - return; - } - setSaveStatus((status) => (status === "saving" ? status : "pending")); - clearSaveTimer(); - saveTimerRef.current = setTimeout(() => { - saveTimerRef.current = null; - void saveNow(); - }, AUTOSAVE_DELAY_MS); - return clearSaveTimer; - }, [clearSaveTimer, draft, saveNow]); - - // Save immediately when the tab is hidden; on unload/unmount send the last - // change with keepalive so it survives the page. - useEffect(() => { - function hasUnsavedDraft() { - const current = draftRef.current; - return Boolean( - current && estimateBalanceFingerprint(current) !== savedFingerprintRef.current - ); - } - function sendKeepalive(): boolean { - const current = draftRef.current; - const revision = revisionRef.current; - if ( - !current || - revision === null || - saveInFlightRef.current || - validateEstimateBalance(current).length - ) { - return false; - } - savedFingerprintRef.current = estimateBalanceFingerprint(current); - void updateEstimateBalance(projectId, toSaveableEstimateBalance(current), revision, { - keepalive: true, - }).catch(() => undefined); - return true; - } - function handleVisibilityChange() { - if (document.visibilityState === "hidden" && hasUnsavedDraft()) { - void saveNow(); - } - } - function handleBeforeUnload(event: BeforeUnloadEvent) { - if (!hasUnsavedDraft() || sendKeepalive()) { - return; - } - // A save is still running or the draft is invalid: let the browser ask. - event.preventDefault(); - event.returnValue = ""; - } - document.addEventListener("visibilitychange", handleVisibilityChange); - window.addEventListener("beforeunload", handleBeforeUnload); - return () => { - document.removeEventListener("visibilitychange", handleVisibilityChange); - window.removeEventListener("beforeunload", handleBeforeUnload); - // In-app navigation (e.g. sidebar) unmounts the editor. - if (hasUnsavedDraft()) { - sendKeepalive(); - } - }; - }, [projectId, saveNow]); - - const handleChange: EstimateBalanceUpdate = useCallback((update) => { - setNotice(null); - setDraft((current) => (current ? update(current) : current)); - }, []); - - const handleValidityChange = useCallback((fieldKey: string, isValid: boolean) => { - setInvalidFieldKeys((current) => { - if (isValid ? !current.has(fieldKey) : current.has(fieldKey)) { - return current; - } - const next = new Set(current); - if (isValid) { - next.delete(fieldKey); - } else { - next.add(fieldKey); - } - return next; - }); - }, []); - - async function handleHistory(direction: "undo" | "redo") { - setError(null); - setNotice(null); - setIsHistoryBusy(true); - try { - // Pending edits are saved first so they become their own undo step. - await saveNow(); - const revision = revisionRef.current; - if (revision === null) { - return; - } - const result = - direction === "undo" - ? await undoProjectCommand(projectId, revision) - : await redoProjectCommand(projectId, revision); - revisionRef.current = result.history.currentRevision; - setHistory(result.history); - await reloadAll(); - } catch (err) { - if (isRevisionConflictError(err)) { - await reloadAll().catch(handleReloadError); - setNotice(CONFLICT_MESSAGE); - } else if (isNotFoundError(err)) { - handleReloadError(err); - } else { - setError( - errorMessage( - err, - direction === "undo" - ? "Die letzte Änderung konnte nicht rückgängig gemacht werden." - : "Die letzte Änderung konnte nicht wiederholt werden." - ) - ); - } - } finally { - setIsHistoryBusy(false); - } - } - - async function handleBackClick(event: MouseEvent) { - const current = draftRef.current; - if (!current || estimateBalanceFingerprint(current) === savedFingerprintRef.current) { - return; - } - event.preventDefault(); - await saveNow(); - router.push(`/projects/${projectId}/grobbilanz`); - } - - function handleSaveGroup(values: EstimateGroupFormValues) { - const editingGroup = groupDialog?.group ?? null; - handleChange((current) => - editingGroup - ? updateEstimateGroup(current, editingGroup.id, values) - : addEstimateGroup(current, values).balance - ); - setGroupDialog(null); - } - - function handleSelectGzf(value: number) { - if (gzfTarget) { - handleChange((current) => - updateEstimateRow(current, gzfTarget.groupId, gzfTarget.rowId, { - simultaneityFactor: value, - }) - ); - } - setGzfTarget(null); - } - - async function handleOpenProjectDevice(groupId: string, rowId: string) { - setError(null); - setNotice(null); - setIsPreparingProjectDevice(true); - try { - if (!(await saveNow())) { - setError( - "Die Grobbilanz muss zuerst fehlerfrei gespeichert werden, bevor ein Projektgerät angelegt werden kann." - ); - return; - } - const current = draftRef.current; - const group = current?.groups.find((entry) => entry.id === groupId); - const row = group?.rows.find((entry) => entry.id === rowId); - if (!group || !row) { - setError("Die gewählte Grobbilanz-Zeile ist nicht mehr vorhanden."); - return; - } - const existingDevices = await listProjectDevices(projectId); - setProjectDevices(existingDevices); - setProjectDeviceDialog({ group, row }); - } catch (err) { - setError( - errorMessage(err, "Der Projektgeräte-Dialog konnte nicht vorbereitet werden.") - ); - } finally { - setIsPreparingProjectDevice(false); - } - } - - async function handleCreateProjectDevice(input: CreateProjectDeviceInput) { - const revision = revisionRef.current; - if (!projectDeviceDialog || revision === null) return; - setError(null); - setIsSavingProjectDevice(true); - try { - if (!(await saveNow())) { - setError( - "Die Grobbilanz muss zuerst fehlerfrei gespeichert werden, bevor das Projektgerät angelegt werden kann." - ); - return; - } - const currentRevision = revisionRef.current; - if (currentRevision === null) return; - const result = await createProjectDevice(projectId, input, currentRevision); - revisionRef.current = result.history.currentRevision; - setHistory(result.history); - setProject((currentProject) => - currentProject - ? { ...currentProject, currentRevision: result.history.currentRevision } - : currentProject - ); - setProjectDevices((current) => [...current, result.projectDevice]); - setProjectDeviceDialog(null); - setNotice(`Projektgerät „${result.projectDevice.displayName}“ wurde angelegt.`); - } catch (err) { - if (isRevisionConflictError(err)) { - await reloadAll().catch(handleReloadError); - setError( - "Der Projektstand hat sich zwischenzeitlich geändert. Der aktuelle Stand wurde geladen; bitte das Projektgerät erneut speichern." - ); - } else { - setError(errorMessage(err, "Das Projektgerät konnte nicht angelegt werden.")); - } - } finally { - setIsSavingProjectDevice(false); - } - } - - const isEditingDisabled = - !draft || isHistoryBusy || isPreparingProjectDevice || isSavingProjectDevice; - const invalidCount = invalidFieldKeys.size; - const listHref = `/projects/${projectId}/grobbilanz`; - - return ( -
- {project && draft ? : null} -
-
- void handleBackClick(event)} - title="Zurück zur Übersicht der Stände" - > -
-
- void saveNow()} - status={saveStatus} - /> -
- - -
- -
-
- - {notice ? ( -
- {notice} -
- ) : null} - {error ? ( -
- {error} -
- ) : null} - {isLoading ? ( -

- Grobe Leistungsbilanz wird geladen … -

- ) : null} - {isMissing ? ( -
- Dieser Stand existiert nicht (mehr), z. B. weil er gelöscht oder sein Anlegen - rückgängig gemacht wurde.{" "} - Zur Übersicht der Stände -
- ) : null} - - {draft && project ? ( - <> -
-
-
-
- Projekt - {project.name} -
- - - -
- setGroupDialog({ group: null })} - onChange={handleChange} - onEditGroup={(group) => setGroupDialog({ group })} - onOpenGzfPicker={(groupId, rowId) => setGzfTarget({ groupId, rowId })} - onTakeOverRow={(groupId, rowId) => - void handleOpenProjectDevice(groupId, rowId) - } - onValidityChange={handleValidityChange} - threePhaseVoltageV={project.threePhaseVoltageV} - /> -
-
- -
-
- - {isComparisonOpen ? ( - - ) : null} -
- {isComparisonOpen ? ( -
- {comparisonError ? ( -
- {comparisonError} -
- ) : null} - {comparison ? : null} -

- Detailliert = Summe der Gerätezeilen aller Stromkreislisten (Anzahl × - Leistung × Geräte-GZF), zugeordnet über die Kostengruppe; ohne - Verteiler-GZF. -

-
- ) : null} -
- - ) : null} - - {groupDialog ? ( - setGroupDialog(null)} - onSave={handleSaveGroup} - /> - ) : null} - {gzfTarget ? ( - setGzfTarget(null)} onSelect={handleSelectGzf} /> - ) : null} - {projectDeviceDialog ? ( - - } - existingDevices={projectDevices} - globalDevices={[]} - initialValues={createEstimateProjectDeviceInitialValues( - projectDeviceDialog.group, - projectDeviceDialog.row - )} - isSaving={isSavingProjectDevice} - onClose={() => setProjectDeviceDialog(null)} - onImportGlobal={async () => undefined} - onSave={handleCreateProjectDevice} - /> - ) : null} -
- ); -} - -function EstimateProjectDeviceContext({ - balanceName, - group, - row, -}: { - balanceName: string; - group: EstimateGroupSnapshot; - row: EstimateRowSnapshot; -}) { - const originalUnit = row.unit === "area" ? "m²" : "St."; - const powerUnit = row.unit === "area" ? "W/m²" : "W"; - return ( - <> -
- Herkunft: Stand „{balanceName}“, Kostengruppe{" "} - {group.costGroup || "ohne Nummer"}. -
-
- Originalwerte: {formatGermanNumber(row.quantity, 0, 3)} {originalUnit} ×{" "} - {formatGermanNumber(row.powerPerUnitW, 0, 3)} {powerUnit}, GZF{" "} - {formatGermanNumber(row.simultaneityFactor, 0, 3)}, cos φ{" "} - {formatGermanNumber(row.cosPhi, 0, 3)}. -
-
- {row.unit === "area" - ? "Das Projektgerät dient als Vorlage. Für Flächenwerte sind Anzahl und Leistung je Stück manuell einzutragen." - : "Das Projektgerät ist eine Vorlage mit Anzahl 1."}{" "} - Kategorie bitte prüfen. - {row.safetySupply - ? " SV ist nur ein Hinweis; die Versorgungsart wird an der Verteilung festgelegt." - : ""} -
- - ); -} - -function SaveStatusBadge({ - error, - invalidCount, - onRetry, - status, -}: { - error: string | null; - invalidCount: number; - onRetry: () => void; - status: SaveStatus; -}) { - const label = - status === "saving" - ? "Wird gespeichert …" - : status === "pending" - ? "Ungespeicherte Änderungen" - : status === "error" - ? "Nicht gespeichert – Fehler" - : status === "invalid" - ? "Nicht gespeichert – ungültige Eingaben" - : "Gespeichert"; - const tone = - status === "error" || status === "invalid" - ? "is-error" - : status === "saved" - ? "is-saved" - : "is-busy"; - return ( -
- - {label} - - {invalidCount ? ( - - {invalidCount === 1 - ? "1 ungültige Eingabe wird nicht gespeichert" - : `${invalidCount} ungültige Eingaben werden nicht gespeichert`} - - ) : null} - {status === "error" ? ( - - ) : null} -
- ); -} diff --git a/src/app/projects/[projectId]/grobbilanz/page.tsx b/src/app/projects/[projectId]/grobbilanz/page.tsx deleted file mode 100644 index 4b2cf81..0000000 --- a/src/app/projects/[projectId]/grobbilanz/page.tsx +++ /dev/null @@ -1,292 +0,0 @@ -"use client"; - -import Link from "next/link"; -import { useParams, useRouter } from "next/navigation"; -import { useCallback, useEffect, useState } from "react"; -import { ArrowLeft, Copy, FolderOpen, Plus, Trash2 } from "lucide-react"; -import { - createEstimateBalance, - deleteEstimateBalance, - getProject, - listEstimateBalances, -} from "../../../../frontend/utils/api"; -import type { - CreateEstimateBalanceInput, - EstimateBalanceDto, - ProjectCommandResultDto, - ProjectDto, -} from "../../../../frontend/types"; -import { calculateEstimateBalance } from "../../../../shared/estimate-balance/estimate-balance"; -import { - EstimateBalanceCreateModal, - type EstimateBalanceCreateDefaults, -} from "../../../../frontend/estimate-balance/estimate-balance-create-modal"; -import { createCopyName } from "../../../../frontend/estimate-balance/estimate-balance-document"; -import { - formatIsoDateGerman, - formatKw, -} from "../../../../frontend/estimate-balance/estimate-balance-format"; - -function countRows(balance: EstimateBalanceDto) { - return balance.groups.reduce((sum, group) => sum + group.rows.length, 0); -} - -export default function EstimateBalanceListPage() { - const params = useParams<{ projectId: string }>(); - const projectId = params.projectId; - const router = useRouter(); - const [project, setProject] = useState(null); - const [balances, setBalances] = useState([]); - const [createDefaults, setCreateDefaults] = - useState(null); - const [error, setError] = useState(null); - const [isLoading, setIsLoading] = useState(true); - const [isSaving, setIsSaving] = useState(false); - - const reload = useCallback(async () => { - const [currentProject, loadedBalances] = await Promise.all([ - getProject(projectId), - listEstimateBalances(projectId), - ]); - setProject(currentProject); - setBalances([...loadedBalances].sort((left, right) => left.sortOrder - right.sortOrder)); - }, [projectId]); - - useEffect(() => { - if (!projectId) { - return; - } - setIsLoading(true); - reload() - .then(() => setError(null)) - .catch((err: unknown) => - setError( - err instanceof Error - ? err.message - : "Grobe Leistungsbilanzen konnten nicht geladen werden." - ) - ) - .finally(() => setIsLoading(false)); - }, [projectId, reload]); - - async function runCommand( - execute: (expectedRevision: number) => Promise, - fallbackMessage: string - ): Promise { - if (!project) { - return null; - } - setIsSaving(true); - setError(null); - try { - const result = await execute(project.currentRevision); - setProject((current) => - current ? { ...current, currentRevision: result.history.currentRevision } : current - ); - await reload(); - return result; - } catch (err) { - setError(err instanceof Error ? err.message : fallbackMessage); - // Refresh revision and list so a stale state does not block the next - // attempt; the command error stays visible. - await reload().catch(() => undefined); - return null; - } finally { - setIsSaving(false); - } - } - - async function handleCreate(input: CreateEstimateBalanceInput) { - const result = await runCommand( - (expectedRevision) => createEstimateBalance(projectId, input, expectedRevision), - "Stand konnte nicht angelegt werden." - ); - if (result) { - setCreateDefaults(null); - router.push(`/projects/${projectId}/grobbilanz/${result.balance.id}`); - } - } - - async function handleDelete(balance: EstimateBalanceDto) { - if ( - !window.confirm( - `Stand „${balance.name}“ der groben Leistungsbilanz wirklich löschen?` - ) - ) { - return; - } - await runCommand( - (expectedRevision) => deleteEstimateBalance(projectId, balance.id, expectedRevision), - "Stand konnte nicht gelöscht werden." - ); - } - - const isBusy = isSaving || !project; - const voltage = project?.threePhaseVoltageV ?? 400; - - return ( -
-
-
- -
- -
- - {error ? ( -
- {error} -
- ) : null} - {isLoading ? ( -

- Grobe Leistungsbilanzen werden geladen … -

- ) : null} - -
-
-

- Stände - {balances.length} -

-
- {balances.length ? ( -
- - - - - - - - - - - - - - - {balances.map((balance) => { - const result = calculateEstimateBalance(balance, voltage); - const href = `/projects/${projectId}/grobbilanz/${balance.id}`; - const rowCount = countRows(balance); - return ( - - - - - - - - - - - ); - })} - -
StandLPHDatumAV kWAV kVASV kWSV kVAAktionen
- - {balance.name} - -
- {balance.groups.length} Kostengruppen ·{" "} - {rowCount === 1 ? "1 Zeile" : `${rowCount} Zeilen`} -
- 		{balance.workStage ?? "–"}{formatIsoDateGerman(balance.dateIso)} - {formatKw(result.withReserve.av.kw)} - - {formatKw(result.withReserve.av.kva)} - - {formatKw(result.withReserve.sv.kw)} - - {formatKw(result.withReserve.sv.kva)} - -
- -
-
-

- Leistungen jeweils inklusive Reserve. -

-
- ) : !isLoading ? ( -
-

- Noch kein Stand vorhanden. Mit „Neuer Stand“ eine grobe Leistungsbilanz auf - Basis der Vorlage KG 400 anlegen. -

-
- ) : null} -
- - {createDefaults ? ( - setCreateDefaults(null)} - onCreate={(input) => void handleCreate(input)} - /> - ) : null} -
- ); -} diff --git a/src/app/projects/[projectId]/page.tsx b/src/app/projects/[projectId]/page.tsx index 5eb864e..ed03cd9 100644 --- a/src/app/projects/[projectId]/page.tsx +++ b/src/app/projects/[projectId]/page.tsx @@ -5,7 +5,7 @@ import { useParams } from "next/navigation"; import { FormEvent, useEffect, useMemo, useState } from "react"; import { ArrowLeft, - FileSpreadsheet, + FileUp, Library, Link2, ListTree, @@ -47,16 +47,15 @@ import { import { copyGlobalDeviceToProject, copyDistributionBoard, - createFeederCircuitAndUpdateDistributionBoard, copyProjectDeviceToGlobal, createDistributionBoard, createProjectDevice, + createRoom, deleteProjectDevice, deleteDistributionBoard, disconnectProjectDeviceRows, exportProjectTransfer, getProject, - getProjectCircuitTrees, getProjectDeviceSyncPreview, listBuildings, listCircuitLists, @@ -71,17 +70,10 @@ import { updateProjectDevice, updateProjectSettings, } from "../../../frontend/utils/api"; -import { createClientId } from "../../../frontend/utils/client-id"; -import { formatValue } from "../../../frontend/utils/circuit-grid-model"; -import { - buildFeederCircuitSnapshot, - getDefaultFeederCircuitSection, - getNextFeederCircuitIdentifier, -} from "../../../frontend/utils/distribution-board-feeder-circuit"; import type { BuildingDto, CircuitListDto, - CircuitTreeResponseDto, + CreateRoomInput, CreateProjectDeviceInput, DistributionBoardDto, FloorDto, @@ -113,6 +105,7 @@ import { } from "../../../frontend/components/project-settings-modal"; import { FormModal } from "../../../frontend/components/form-modal"; import { ProjectDeviceModal } from "../../../frontend/components/project-device-modal"; +import { RevitCsvModal } from "../../../frontend/components/revit-csv-modal"; import { FloorSelectOptions } from "../../../frontend/components/floor-select-options"; const projectDeviceSyncFieldLabels: Record = { @@ -151,7 +144,6 @@ const boardFilterCollapsedStorageKey = "leistungsbilanz:overview-filter-collapsed:distribution-boards"; const projectDeviceFilterCollapsedStorageKey = "leistungsbilanz:overview-filter-collapsed:project-devices"; -const createFeederCircuitSelectValue = "__create_feeder_circuit__"; export default function ProjectDetailPage() { const params = useParams<{ projectId: string }>(); @@ -159,7 +151,6 @@ export default function ProjectDetailPage() { const [project, setProject] = useState(null); const [boards, setBoards] = useState([]); const [circuitLists, setCircuitLists] = useState([]); - const [circuitTrees, setCircuitTrees] = useState([]); const [buildings, setBuildings] = useState([]); const [floors, setFloors] = useState([]); const [rooms, setRooms] = useState([]); @@ -179,14 +170,6 @@ export default function ProjectDetailPage() { setEditingBoardSimultaneityFactor, ] = useState("1"); const [editingBoardCopyName, setEditingBoardCopyName] = useState(""); - const [editingFeedingBoardId, setEditingFeedingBoardId] = useState(""); - const [editingFeedingCircuitId, setEditingFeedingCircuitId] = useState(""); - const [isCreatingFeederCircuit, setIsCreatingFeederCircuit] = - useState(false); - const [editingFeederCircuitSectionId, setEditingFeederCircuitSectionId] = - useState(""); - const [editingFeederCircuitDisplayName, setEditingFeederCircuitDisplayName] = - useState(""); const [editingBoardInfo, setEditingBoardInfo] = useState( toDistributionBoardInfoDraft({ @@ -197,6 +180,7 @@ export default function ProjectDetailPage() { }) ); const [isProjectSettingsOpen, setIsProjectSettingsOpen] = useState(false); + const [isRevitCsvOpen, setIsRevitCsvOpen] = useState(false); const [structureModal, setStructureModal] = useState<"board" | null>(null); const [isProjectDeviceModalOpen, setIsProjectDeviceModalOpen] = useState(false); @@ -225,7 +209,6 @@ export default function ProjectDetailPage() { getProject(projectId), listDistributionBoards(projectId), listCircuitLists(projectId), - getProjectCircuitTrees(projectId), listBuildings(projectId), listFloors(projectId), listRooms(projectId), @@ -236,7 +219,6 @@ export default function ProjectDetailPage() { currentProject, distributionBoards, loadedCircuitLists, - loadedCircuitTrees, loadedBuildings, loadedFloors, loadedRooms, @@ -246,7 +228,6 @@ export default function ProjectDetailPage() { setProject(currentProject); setBoards(distributionBoards); setCircuitLists(loadedCircuitLists); - setCircuitTrees(loadedCircuitTrees.trees); setBuildings(loadedBuildings); setFloors(loadedFloors); setRooms(loadedRooms); @@ -329,63 +310,6 @@ export default function ProjectDetailPage() { () => new Map(circuitLists.map((circuitList) => [circuitList.distributionBoardId, circuitList])), [circuitLists] ); - const circuitTreeByBoardId = useMemo( - () => new Map(circuitTrees.map((tree) => [tree.distributionBoardId, tree])), - [circuitTrees] - ); - const feedingBoardOptions = useMemo(() => { - if (!editingBoard) return []; - const boardById = new Map(boards.map((board) => [board.id, board])); - return boards.filter((candidate) => { - if (candidate.id === editingBoard.id) return false; - const visited = new Set(); - let current: DistributionBoardDto | undefined = candidate; - while (current && current.feedingDistributionBoardId && !visited.has(current.id)) { - if (current.feedingDistributionBoardId === editingBoard.id) return false; - visited.add(current.id); - current = boardById.get(current.feedingDistributionBoardId); - } - return true; - }); - }, [boards, editingBoard]); - const selectedFeedingTree = editingFeedingBoardId - ? circuitTreeByBoardId.get(editingFeedingBoardId) - : undefined; - const selectedFeedingCircuits = useMemo( - () => - selectedFeedingTree?.sections.flatMap((section) => - section.circuits.map((circuit) => ({ circuit, section })) - ) ?? [], - [selectedFeedingTree] - ); - const selectedFeedingCircuit = selectedFeedingCircuits.find( - ({ circuit }) => circuit.id === editingFeedingCircuitId - ); - const feederCircuitSections = - selectedFeedingTree?.sections.filter( - (section) => section.category !== undefined - ) ?? []; - const selectedNewFeederCircuitSection = feederCircuitSections.find( - (section) => section.id === editingFeederCircuitSectionId - ); - const newFeederCircuitIdentifier = selectedNewFeederCircuitSection - ? getNextFeederCircuitIdentifier(selectedNewFeederCircuitSection) - : null; - const selectedFeedingCircuitCategory = - selectedFeedingCircuit?.section.category ?? - (isCreatingFeederCircuit - ? selectedNewFeederCircuitSection?.category - : undefined); - const selectedFeedingBoard = boards.find( - (board) => board.id === editingFeedingBoardId - ); - const selectedFeedingCircuitUseCount = editingFeedingCircuitId - ? boards.filter( - (board) => - board.id !== editingBoard?.id && - board.feedingCircuitId === editingFeedingCircuitId - ).length - : 0; const enabledBoardSupplyTypes = project?.enabledDistributionBoardSupplyTypes ?? []; const usedBoardSupplyTypes = useMemo( @@ -405,21 +329,6 @@ export default function ProjectDetailPage() { [boards] ); - function formatBoardFeedingReference(board: DistributionBoardDto) { - if (!board.feedingDistributionBoardId) return board.fedFrom ?? "–"; - const feedingBoard = boards.find( - (candidate) => candidate.id === board.feedingDistributionBoardId - ); - if (!feedingBoard) return "Unbekannte Verteilung"; - const boardLabel = feedingBoard.boardNumber ?? feedingBoard.name; - if (!board.feedingCircuitId) return boardLabel; - const circuit = circuitTreeByBoardId - .get(feedingBoard.id) - ?.sections.flatMap((section) => section.circuits) - .find((candidate) => candidate.id === board.feedingCircuitId); - return `${boardLabel}${circuit?.equipmentIdentifier ?? ""}`; - } - function applyProjectRevision(currentRevision: number) { setProject((current) => current ? { ...current, currentRevision } : current @@ -449,7 +358,6 @@ export default function ProjectDetailPage() { ]); setCircuitLists(await listCircuitLists(projectId)); applyProjectRevision(result.history.currentRevision); - setCircuitTrees((await getProjectCircuitTrees(projectId)).trees); setBoardName(""); setBoardFloorId(""); setBoardSupplyType( @@ -580,11 +488,6 @@ export default function ProjectDetailPage() { ); setEditingBoardCopyName(`${board.name} Kopie`); setEditingBoardInfo(toDistributionBoardInfoDraft(board)); - setEditingFeedingBoardId(board.feedingDistributionBoardId ?? ""); - setEditingFeedingCircuitId(board.feedingCircuitId ?? ""); - setIsCreatingFeederCircuit(false); - setEditingFeederCircuitSectionId(""); - setEditingFeederCircuitDisplayName(""); } function openBoardCreator() { @@ -613,56 +516,25 @@ export default function ProjectDetailPage() { setIsSaving(true); setError(null); try { - const boardInput = { - floorId: editingBoardFloorId || null, - supplyType: editingBoardSupplyType, - simultaneityFactor, - feedingDistributionBoardId: editingFeedingBoardId || null, - feedingCircuitId: editingFeedingCircuitId || null, - ...fromDistributionBoardInfoDraft(editingBoardInfo), - }; - let result; - if (isCreatingFeederCircuit) { - if (!editingFeedingBoardId || !selectedFeedingTree) { - throw new Error("Bitte eine speisende Verteilung wählen."); - } - if (!selectedNewFeederCircuitSection) { - throw new Error( - "Bitte eine Stromkreisgruppe für den neuen Abgang wählen." - ); - } - const circuit = buildFeederCircuitSnapshot({ - id: createClientId(), - tree: selectedFeedingTree, - sectionId: selectedNewFeederCircuitSection.id, - displayName: editingFeederCircuitDisplayName, - }); - result = await createFeederCircuitAndUpdateDistributionBoard( - projectId, - editingBoard.id, - { - ...boardInput, - feedingDistributionBoardId: editingFeedingBoardId, - feedingCircuitId: circuit.id, - }, - circuit, - project.currentRevision - ); - } else { - result = await updateDistributionBoard( - projectId, - editingBoard.id, - boardInput, - project.currentRevision - ); - } + const result = await updateDistributionBoard( + projectId, + editingBoard.id, + { + floorId: editingBoardFloorId || null, + supplyType: editingBoardSupplyType, + simultaneityFactor, + ...fromDistributionBoardInfoDraft(editingBoardInfo), + }, + project.currentRevision + ); + setBoards((current) => + current.map((board) => + board.id === result.distributionBoard.id + ? result.distributionBoard + : board + ) + ); applyProjectRevision(result.history.currentRevision); - const [updatedBoards, updatedTrees] = await Promise.all([ - listDistributionBoards(projectId), - getProjectCircuitTrees(projectId), - ]); - setBoards(updatedBoards); - setCircuitTrees(updatedTrees.trees); setEditingBoard(null); } catch (err) { setError( @@ -675,6 +547,22 @@ export default function ProjectDetailPage() { } } + async function handleCreateRevitRoom(input: CreateRoomInput) { + if (!projectId || !project) throw new Error("Projekt ist nicht geladen."); + const result = await createRoom(projectId, input, project.currentRevision); + setRooms((current) => [...current, result.room]); + applyProjectRevision(result.history.currentRevision); + return result; + } + + async function handleCreateRevitProjectDevice(input: CreateProjectDeviceInput) { + if (!projectId || !project) throw new Error("Projekt ist nicht geladen."); + const result = await createProjectDevice(projectId, input, project.currentRevision); + setProjectDevices((current) => [...current, result.projectDevice]); + applyProjectRevision(result.history.currentRevision); + return result; + } + async function handleCopyBoard() { if ( !projectId || @@ -702,7 +590,6 @@ export default function ProjectDetailPage() { result.circuitList, ]); applyProjectRevision(result.history.currentRevision); - setCircuitTrees((await getProjectCircuitTrees(projectId)).trees); setEditingBoard(null); } catch (err) { setError( @@ -746,7 +633,6 @@ export default function ProjectDetailPage() { ) ); applyProjectRevision(result.history.currentRevision); - setCircuitTrees((await getProjectCircuitTrees(projectId)).trees); setEditingBoard(null); } catch (err) { setError( @@ -977,13 +863,15 @@ export default function ProjectDetailPage() {