Plan Internal Application Diagrams¶

Legacy Simulation Lifecycle¶

sequenceDiagram
  participant UI as bnl ui
  participant Settings as bnl settings
  participant Compute as schedule analysis compute
  participant Route as route modelling
  participant Twin as digital twin depot

  UI->>Settings: submit simulation
  Settings->>Compute: compute trip and charging data
  Compute->>Route: route and physics calculations
  Route-->>Compute: physics outputs
  Compute-->>Settings: computed scenario data
  Settings->>Twin: run depot emulation
  Twin-->>Settings: depot outputs
  Settings-->>UI: merged response

Digital Twin Simulation Lifecycle¶

sequenceDiagram
  participant UI as bnl ui
  participant Twin as digital twin
  participant Creator as schedule creator
  participant S3 as aws s3
  participant DDB as aws dynamodb
  participant Core as manage core

  UI->>Twin: submit simulation
  Twin->>Creator: parse or load schedule data when required
  Twin->>Core: fetch shared platform context when required
  Twin->>Twin: run simulation phases
  Twin->>S3: persist run artifacts and outputs
  Twin->>DDB: persist run state and metadata
  Twin-->>UI: run response

Settings Service Internal Shape¶

flowchart TD
  Api[settings routers] --> Resources[resource modules]
  Api --> Scenarios[schedule analysis scenario modules]
  Api --> SettingsV2[settings v2 domains]
  Scenarios --> Downstream[compute and digital twin clients]
  Resources --> Storage[data stores]
  Storage --> S3[(aws s3)]
  Storage --> DDB[(aws dynamodb)]

Compute Service Internal Shape¶

flowchart TD
  Ingress[fastapi app] --> Schedule[schedule analysis]
  Ingress --> Charging[charging analysis]
  Ingress --> Depot[depot analysis]
  Ingress --> Soh[soh analysis]
  Schedule --> Helpers[compute helpers and stats]
  Charging --> Helpers
  Depot --> Helpers
  Soh --> Helpers
  Helpers --> S3[(aws s3)]

Digital Twin Internal Shape¶

flowchart TD
  App[fastapi app] --> PlanApp[plan application layer]
  PlanApp --> PlanDomain[plan domain layer]
  PlanApp --> PlanAdapters[plan adapters]
  App --> ServiceModules[service modules]
  App --> OutputModules[output service modules]
  OutputModules --> MlModels[ml model loaders]
  App --> Core[manage core integration]
  App --> Connect[manage connect integration]
  App --> SitePwr[site power monitor integration]
  App --> S3[(aws s3 persistence)]
  App --> DDB[(aws dynamodb persistence)]

Schedule Creator Internal Shape¶

flowchart LR
  Api[api routes] --> Formatter[input formatter]
  Formatter --> Parser[schedule parser]
  Parser --> Plugins[enrichment plugins]
  Plugins --> Gtfs[gtfs and transxchange sources]
  Parser --> Outputs[schedule and route outputs]
  Outputs --> S3[(aws s3)]