ankn
a5f8fb49ab
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.
77 lines
2.6 KiB
Markdown
77 lines
2.6 KiB
Markdown
---
|
|
inclusion: always
|
|
---
|
|
|
|
# BEAM Domänenwissen
|
|
|
|
## Was ist BEAM?
|
|
|
|
BEAM (Business Enterprise Architecture Management) ist die Architektur-Plattform der Deutschen Bahn, basierend auf LeanIX. Sie dokumentiert die IT-Landschaft mit Anwendungen, Domänen, IT-Komponenten, Schnittstellen und Diagrammen.
|
|
|
|
URL: https://db.leanix.net (intern: http://db.de/beam)
|
|
|
|
## Zentrale Konzepte
|
|
|
|
### Fact Sheets
|
|
|
|
Fact Sheets sind die Kernobjekte in BEAM. Jedes hat eine UUID und optional eine externe Beam-ID.
|
|
|
|
| Typ | Beam-ID Format | Beispiel | Beschreibung |
|
|
|-----|---------------|----------|--------------|
|
|
| Application | A-XXXXXX | A-106614 | Anwendung/Software-System |
|
|
| BusinessCapability | P.X.XX.XX.XX | P.F.05.05.04 | Fachliche Domäne/Capability |
|
|
| ITComponent | — | — | Technische Infrastruktur-Komponente |
|
|
| Interface | — | — | Schnittstelle zwischen Anwendungen |
|
|
| DataObject | — | — | Datenobjekt |
|
|
|
|
### Lebenszyklus
|
|
|
|
Jedes Fact Sheet hat einen Lebenszyklus-Status:
|
|
- `plan` → Plan
|
|
- `phaseIn` → Einführungsphase
|
|
- `active` → Aktiv
|
|
- `phaseOut` → Ausgliederungsphase
|
|
- `endOfLife` → Lebensende
|
|
|
|
### Supporttyp (Domänen-Zuordnung)
|
|
|
|
Anwendungen werden Domänen mit einem Supporttyp zugeordnet:
|
|
- `leading` → Führend (Hauptanwendung der Domäne)
|
|
- `supports` → Unterstützt (Hilfsanwendung)
|
|
|
|
### Diagramme
|
|
|
|
Diagramme in BEAM sind als "Bookmarks" gespeichert und enthalten mxGraph-XML (draw.io-kompatibel). Sie werden über die Documents-Relation eines Fact Sheets verknüpft. Typische Diagrammtypen:
|
|
- System Context (C4-Modell)
|
|
- Verteilungssicht (PROD/TST/ABN)
|
|
- Schnittstellen
|
|
|
|
## BEAM GraphQL API
|
|
|
|
Endpunkt: `https://db.leanix.net/services/pathfinder/v1/graphql`
|
|
|
|
Wichtige Queries:
|
|
- `allFactSheets(filter, first)` — Suche mit Volltextfilter
|
|
- `factSheet(id)` — Einzelnes Fact Sheet mit Relationen
|
|
- Relationen: `relApplicationToBusinessCapability`, `relBusinessCapabilityToApplication`, `relApplicationToITComponent`, `relToSuccessor`
|
|
|
|
## BEAM Bookmarks API (Diagramme)
|
|
|
|
Endpunkt: `https://db.leanix.net/services/pathfinder/v1/bookmarks/{id}`
|
|
|
|
Gibt ein JSON-Objekt zurück mit:
|
|
- `data.name` — Diagrammname
|
|
- `data.groupKey` — Typ (z.B. "freedraw")
|
|
- `data.state.graphXml` — mxGraph-XML (draw.io-kompatibel)
|
|
- `data.description` — Beschreibung
|
|
- `data.referencedFactSheetIds` — Verknüpfte Fact Sheets
|
|
|
|
## Terminologie-Mapping
|
|
|
|
Der MCP-Server mappt LeanIX-interne Begriffe auf BEAM-Terminologie:
|
|
- Application → Anwendung
|
|
- BusinessCapability → Domäne
|
|
- ITComponent → IT-Komponente
|
|
- Interface → Integration (Schnittstelle)
|
|
- lxState APPROVED → Bestätigt
|