Migrate all repos into monorepo context folders

Bahn: aisupport, Analyse-O2C-C2S, awesome-bahn-mcp-servers, beam-mcp, Confluence_Bot, db-planet-mcp-server, O2C-Harness, project-audit, Projekt-KIQ-HP, teamlandkarte-mcp Dhive: Jury-Voting Privat: CV, NoteGraph (NOTE: NoteGraph needs complete redo after consolidation) Shared: AI-Orchestrator, OrgMyLife, power_skills_and_more Shared/references: symphony (read-only) Bahn repos remain available as independent remotes - this monorepo pulls them in via subtree, the originals are untouched.
2026-06-30 20:39:52 +02:00
parent 2f2b295531
commit a5f8fb49ab
1717 changed files with 447332 additions and 0 deletions
@@ -0,0 +1,130 @@
+# Dokumentation (Arc42 docs-as-code)
+
+Referenz: arc42.org, Ralf D. Müller docs-as-code Ansatz.
+
+## Verzeichnisstruktur
+
+```
+docs/
+├── README.md              ← Übersicht + Links zu allen Kapiteln
+├── arc42/
+│   ├── README.md          ← Inhaltsverzeichnis der Arc42-Doku
+│   ├── 01-introduction-and-goals.md
+│   ├── 02-constraints.md
+│   ├── 03-context-and-scope.md
+│   ├── 04-solution-strategy.md
+│   ├── 05-building-block-view.md
+│   ├── 06-runtime-view.md
+│   ├── 07-deployment-view.md
+│   ├── 08-crosscutting-concepts.md
+│   ├── 09-architecture-decisions.md
+│   ├── 10-quality.md
+│   ├── 11-risks-and-technical-debt.md
+│   └── 12-glossary.md
+└── session-notes.md
+```
+
+## README.md in jedem Verzeichnis
+
+### Root README.md
+
+Muss auf die Doku verlinken:
+
+```markdown
+## Dokumentation
+
+- [Arc42 Architekturdokumentation](docs/arc42/README.md)
+- [Session Notes](docs/session-notes.md)
+```
+
+### docs/README.md
+
+```markdown
+# Dokumentation
+
+- [Arc42 Architektur](arc42/README.md)
+- [Session Notes](session-notes.md)
+```
+
+### docs/arc42/README.md
+
+```markdown
+# Arc42 Architekturdokumentation
+
+| Kapitel | Inhalt |
+|---------|--------|
+| [01 - Einführung und Ziele](01-introduction-and-goals.md) | Aufgabenstellung, Qualitätsziele, Stakeholder |
+| [02 - Randbedingungen](02-constraints.md) | Technische, organisatorische Constraints |
+| [03 - Kontextabgrenzung](03-context-and-scope.md) | Systemkontext, externe Schnittstellen |
+| [04 - Lösungsstrategie](04-solution-strategy.md) | Fundamentale Entscheidungen |
+| [05 - Bausteinsicht](05-building-block-view.md) | Statische Zerlegung |
+| [06 - Laufzeitsicht](06-runtime-view.md) | Wichtige Abläufe |
+| [07 - Verteilungssicht](07-deployment-view.md) | Infrastruktur, Deployment |
+| [08 - Querschnittliche Konzepte](08-crosscutting-concepts.md) | Übergreifende Patterns |
+| [09 - Architekturentscheidungen](09-architecture-decisions.md) | ADRs |
+| [10 - Qualitätsanforderungen](10-quality.md) | Qualitätsbaum, Szenarien |
+| [11 - Risiken und technische Schulden](11-risks-and-technical-debt.md) | Bekannte Probleme |
+| [12 - Glossar](12-glossary.md) | Begriffe |
+```
+
+## Kapitel-Inhalte (Mindestanforderung)
+
+### 01 - Einführung und Ziele
+- Aufgabenstellung (was macht das System)
+- Qualitätsziele (Top 3)
+- Stakeholder-Tabelle
+
+### 03 - Kontextabgrenzung
+- C4 Context-Diagramm als Mermaid:
+
+```mermaid
+C4Context
+    title System Context
+    Person(user, "Benutzer")
+    System(system, "Mein Service", "Beschreibung")
+    System_Ext(ext, "Externes System")
+    Rel(user, system, "Nutzt")
+    Rel(system, ext, "Ruft auf")
+```
+
+### 05 - Bausteinsicht
+- Komponenten-Diagramm (Mermaid)
+- Beschreibung der Hauptbausteine
+
+### 06 - Laufzeitsicht
+- Sequenzdiagramm für Hauptflow (Mermaid)
+
+### 07 - Verteilungssicht
+- Deployment-Diagramm (Mermaid) wenn deployed
+
+### 09 - Architekturentscheidungen
+- Mindestens 1 ADR im Nygard-Format:
+
+```markdown
+## ADR-1: Titel
+
+### Status
+Accepted
+
+### Context
+Problem/Situation.
+
+### Decision
+Entscheidung.
+
+### Consequences
+Auswirkungen (positiv + negativ).
+```
+
+### 11 - Risiken
+- Bekannte Risiken und technische Schulden auflisten
+
+### 12 - Glossar
+- Fachbegriffe des Projekts erklären
+
+## Kontextabhängig
+
+Arc42-Doku anlegen bei:
+- Services/APIs mit Deployment → Vollständig (alle 12 Kapitel)
+- Libraries → Minimal (01, 03, 05, 09)
+- Doku-Repos → KEINE Arc42 nötig