---
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