Add external row quantity foundation

docs/current-architecture.md

@@ -416,7 +416,9 @@ wieder her.
 verteilerweiten Gleichzeitigkeitsfaktor gemeinsam und stellt alle Werte über
 dauerhaftes Undo/Redo wieder her. Der Faktor liegt zwischen `0` und `1` und
 ist für bestehende sowie neu angelegte Verteilungen standardmäßig `1`.
-Snapshot-Schema 4 enthält zusätzlich den vollständigen externen Modellzustand
+Snapshot-Schema 5 enthält zusätzlich den manuellen Mengenanteil jeder
+Gerätezeile. Version 4 wird mit `manualQuantity = quantity` hochgestuft und
+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
@@ -477,7 +479,7 @@ Kopieren in ein Projekt erzeugt ein eigenständiges Projektgerät.
   Ein triggergeführtes Register erzwingt bereits eine normalisierte,
   stromkreislistenweite BMK-Eindeutigkeit über Stromkreise und
   Verteilerkomponenten. Snapshot- und Transfer-Integration verwenden aktuell
-  Snapshot-Schema 4. Persistente Insert/Delete/Update-Commands für
+  Snapshot-Schema 5. 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 an und bearbeitet veränderliche Gruppen- und
@@ -500,7 +502,7 @@ einschließlich BOM, CRLF und Quotierung bytegleich zurück. Der lokale Befehl
 
 `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 4,
+Entfernung zusammen mit Revision und persistentem Undo/Redo. Snapshot-Schema 5,
 Restore und portabler Projekttransfer enthalten diesen Zustand; beim Duplizieren
 werden Konfigurations-UUID und Projektlink remapped.
 
@@ -516,7 +518,9 @@ 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 v4 erfasst Originalbytes, Matrix und alle internen Links,
+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
@@ -529,6 +533,13 @@ 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.
+
+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.
 `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.

docs/spec/revit-csv-phase-14-audit-and-plan.md

@@ -313,6 +313,11 @@ 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.
 3. Verteilungsbezogenen Drawer, Filter und Vorschau der Mengenwirkung ergänzen.
 4. Einzel- und Mehrfach-Drag-and-drop samt Warnungen, Undo/Redo und Reload