Rewrite project documentation

2026-07-23 21:05:43 +02:00
parent 30d6f1a2e1
commit 6b6d2c2a42
17 changed files with 535 additions and 221 deletions
@@ -0,0 +1,48 @@
+# Dokumentationsübersicht
+
+Diese Seite ist der Einstieg in die Projektdokumentation. Aussagen zum aktuellen
+System stehen unter „Aktuell“. Zukunftsentwürfe und historische Unterlagen sind
+ausdrücklich getrennt und dürfen nicht als bereits implementiert verstanden werden.
+
+## Aktuell
+
+- [Aktuelle Systemarchitektur](current-architecture.md) – Laufzeit, Modulgrenzen,
+  Datenfluss und unterstützte Codepfade
+- [Stromkreislisten-Architektur](circuit-list-editor-architecture.md) –
+  fachliches Modell und Grid-Aufteilung
+- [Editor-Interaktionen](circuit-list-editor-interactions.md) – Tastatur,
+  Drag-and-drop, Sortierung, Filterung und Undo/Redo
+- [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
+
+## Entwicklung und Betrieb
+
+- [Entwicklungs- und Contributor-Workflow](development-workflow.md)
+- [Deployment und Betrieb](deployment.md)
+- [Lokale Circuit-First-Datenbankmigration](local-db-circuit-first-migration.md)
+- [Retained Legacy-Datenmigration](circuit-list-editor-migration.md) –
+  ausschließlich für Upgrades alter Datenbanken
+
+## Zukunftsarchitektur
+
+- [Projektversionen und externer Modellaustausch](project-history-and-external-model-architecture.md)
+- [Zukünftige Dimensionierung](spec/06-future-sizing-and-calculations.md)
+- [Roadmap und Phasen](spec/07-implementation-phases-todo.md)
+
+## Fachliche Referenzspezifikation
+
+Die folgenden Dokumente beschreiben Zielregeln und Anforderungen. Nicht jeder
+Punkt ist bereits umgesetzt; der aktuelle Stand ergibt sich aus Architektur,
+Limitierungen und Roadmap.
+
+- [Domänenkontext](spec/01-domain-context.md)
+- [Funktionale Anforderungen](spec/02-functional-requirements.md)
+- [Datenmodellkonzept](spec/03-data-model-concept.md)
+- [UI- und Interaktionsanforderungen](spec/04-ui-interaction-requirements.md)
+- [Verknüpfte Projektgeräte und Synchronisierung](spec/05-linked-devices-and-sync.md)
+
+## Archiv
+
+- [Frühe Codex-Promptvorlagen](archive/initial-codex-prompts.md) – historischer
+  Arbeitsstand, keine aktuelle Implementierungsanweisung