Architektur
Die Grundstruktur sieht so aus:
Architektur
1. Zielbild
Die Grundstruktur sieht so aus:
Jira Ticket / Feature Request
|
v
Pull Request im Repository
|
v
AURA PR Check
|
| prüft:
| - Wurde relevante Doku angepasst?
| - Wurde ein C4-Diagramm angepasst?
| - Ist ein ADR nötig?
| - Haben sich APIs oder Events geändert?
| - Haben sich Abhängigkeiten geändert?
| - Ist Ownership klar?
| - Gibt es Architekturdrift?
v
Merge nach main
|
v
AURA Ingest
|
| erzeugt Architecture Snapshot
| inklusive Repo, Commit, PR, Owner, Status
v
AURA Knowledge Store
|
+--> MkDocs Webseite
+--> Suchindex / Embeddings
+--> Service Graph
+--> MCP Server
+--> AI Assistant
2. Zentrale Bausteine
AURA besteht aus mehreren klar getrennten Bausteinen.
Repository Documentation Standard
|
v
AURA PR Check
|
v
AURA Ingest Service
|
v
AURA Knowledge Store
|
+--> AURA Web Portal
+--> AURA Search Index
+--> AURA Service Graph
+--> AURA AI Context Layer
+--> AURA MCP Server
| Baustein | Verantwortung | Detailseite |
|---|---|---|
| Repository Documentation Standard | Normierte Doku-Struktur in jedem Repo | Repository-Standard |
| AURA PR Check | Prüft architekturrelevante Doku-Änderungen | PR Check |
| AURA Ingest Service | Zieht Artefakte nach Merge in main | Ingest und Portal |
| AURA Knowledge Store | Versionierte Wissensbasis (Git, Index, Graph) | Ingest und Portal |
| AURA Web Portal | Menschliche Sicht (MkDocs) | Ingest und Portal |
| AURA Search Index | Volltext- und Vektorsuche | KI und MCP |
| AURA Service Graph | Modell der Service-Abhängigkeiten | Governance und Drift |
| AURA AI Context Layer | KI-tauglicher, zitierbarer Kontext | KI und MCP |
| AURA MCP Server | Schnittstelle für KI-Assistenten | KI und MCP |
3. AURA als Architektur-Compiler
AURA kann als eine Art Compiler verstanden werden.
Input
Repo-Dokumentation
architecture.yaml
C4-Diagrammquellen
ADRs
OpenAPI/AsyncAPI
Jira-Links
PR-/Commit-Metadaten
Ownership-Daten
Verarbeitung
Validierung
Normalisierung
Snapshot-Erstellung
Indexierung
Graph-Aufbau
KI-Kontextaufbereitung
Drift-Erkennung
Output
MkDocs Webseite
Service Catalog
Architecture Map
Dependency Graph
ADR Index
API/Event Index
AI Context Layer
MCP Resources
MCP Tools
Qualitätsberichte
PR-Kommentare
4. AURA-Repository
AURA kann ein eigenes Repository besitzen. Dieses Repository enthält nicht die primäre Wahrheit, sondern die aggregierte, generierte und versionierte zentrale Sicht.
Mögliche Struktur:
aura-repository/
/snapshots
/payment-service
snapshot.yaml
overview.md
context.md
containers.md
adr-index.md
/user-service
snapshot.yaml
overview.md
context.md
/generated
/mkdocs
/service-graph
/search-index
mkdocs.yml
Wichtig ist, dass klar zwischen Quell-Repositories und AURA-Snapshots unterschieden wird.
Weiterlesen
- Nächste Seite: Repository-Standard — der Input des Compilers im Detail
- Ingest und Portal — die Verarbeitung und Outputs
- KI und MCP — der KI-bezogene Output