Files
Orchestrator/bahn/beam-mcp/.kiro/steering/beam-domain.md
T
ankn a5f8fb49ab 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

2.6 KiB

inclusion
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