bf-digital-twin (Manage Role)¶

What this service is in Manage mode¶

In Manage mode, bf-digital-twin is mostly a shared dependency that exposes modeling/simulation capabilities consumed by selected Manage flows and integrations.

Core anatomy (shared with Plan)¶

• src/app.py: FastAPI app and lifecycle.
• src/plan/*: domain-driven plan modules (adapters, application, domain, models).
• src/service/*: functional service modules (depot, trip, vehicle, charge_point, weather, geography, hvac).
• src/output_service/*: output-oriented APIs (time_to_charge, range_remaining).
• src/ml_models/*: ML estimator packaging and model support.

Manage-relevant characteristics¶

• Depends on Manage services (bf-manage-core, bf-manage-connect, bf-manage-sitepwrmon) in this local stack.
• Acts as a cross-domain integration point, so regressions can impact both Manage and Plan local environments.
• Persists simulation artifacts and run metadata via AWS S3 and DynamoDB.

Cloud dependency map¶

flowchart LR
  DT[bf-digital-twin] --> S3[(aws s3)]
  DT --> DDB[(aws dynamodb)]
  DT --> Core[bf-manage-core]
  DT --> Connect[bf-manage-connect]
  DT --> SitePwr[bf-manage-sitepwrmon]