Skip to content

Topology & Architecture

flowchart LR
    UP["Upstream Presystem<br/>BMS / ITCS / DMS"]
    WS["VDV 463 WebSocket `/vdv463/ws`"]
    CMS["CMS Runtime"]
    DOC["AsyncAPI + Schema Artifacts"]

    UP -->|BootNotification / ProvideChargingRequests| WS
    CMS -->|ProvideChargingInformation| WS
    WS --> CMS
    CMS --> DOC
  • Connection direction: the upstream system initiates the WebSocket connection to the CMS.
  • Trust boundary: the standard expects TLS, HTTP Basic Authentication, and the v1.463.vdv.de subprotocol at the WebSocket boundary.
  • Repository scope: this codebase lives on the CMS side and currently focuses on message validation, placeholder confirmations, and documentation generation.
  • Documentation assets: the AsyncAPI document and raw JSON schemas are generated from the Pydantic models and message envelope definitions in the repo.