Add Revit initial import wizard

2026-08-02 17:52:21 +02:00
parent 8646f346e6
commit ab2449419b
10 changed files with 481 additions and 32 deletions
@@ -404,7 +404,17 @@ project device never triggers synchronization implicitly.
  - 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

 Parser errors expose stable codes such as `header-not-found`,
-`ambiguous-header`, `invalid-ifc-guid` and `duplicate-ifc-guid`. A later
-confirmed import must upload and parse the file again and verify its hash.
+`ambiguous-header`, `invalid-ifc-guid` and `duplicate-ifc-guid`. The confirmed
+import uploads and parses the file again and verifies its hash.
@@ -9,7 +9,8 @@
 - 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.
- No Revit/CSV/IFCGUID import and export workflow is implemented yet.
+- The Revit/CSV foundation and confirmed initial import are implemented. Row
+  assignment, 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.
@@ -527,9 +527,8 @@ 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. Ein aufrufender Import-Endpunkt und
-der mehrstufige Wizard sind noch nicht implementiert; bloße Vorschau erzeugt
-weiterhin keine dieser Zeilen.
+Redo verwendet dieselben UUIDs und Bytes. Bloße Vorschau und Importplanung
+erzeugen weiterhin keine dieser Zeilen.
 `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.
@@ -560,13 +559,18 @@ 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.
+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.

 ## Noch nicht unterstützt

 - Mehrbenutzerbetrieb und Konfliktauflösung
- bestätigter Revit-Erstimport und vollständiger CSV-/IFCGUID-Round-trip über
-  die vorhandene Transport- und Persistenzgrundlage hinaus
+- Folgeimport, Editor-Zuordnung und strukturtreuer Revit-Rückexport
 - vollständige elektrische Dimensionierung
 - Produktionsdeployment

@@ -532,8 +532,8 @@ Acceptance criteria:

 ## Phase 14: External Model Round-Trip

-Status: Phase 14.0 (Audit und Verträge) ist dokumentiert und wartet vor der
-Laufzeitimplementierung auf Freigabe. Siehe
+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).
@@ -288,19 +288,20 @@ einen Commit aufgenommen.
   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. **Begonnen:**
+   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. Entscheidungs-UI und Apply-
-   Endpunkt stehen noch aus. **Backend-Apply erledigt:** Der dedizierte
+   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. Die Entscheidungs-UI steht noch aus.
+   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.

 Vor Beginn werden die oben vorgeschlagenen Namen, die erneute Dateiübertragung
 statt serverseitiger Entwürfe, die Konfigurationsversionierung und die