Manage Architecture¶

Scope¶

Manage mode supports fleet operations workflows centered on bf-manage-web and bf-manage-core.

Service Topology¶

flowchart LR
  Web[bf-manage-web] --> Core[bf-manage-core]
  Web --> Connect[bf-manage-connect]
  Web --> Incidents[bf-manage-incidents]
  Web --> SitePwr[bf-manage-sitepwrmon]
  Web --> Telematics[bf-telematics]
  Web --> Depot[bf-depot-sim]
  Web --> DT[bf-digital-twin]

  Core --> PG[(postgresql)]
  Core --> MQ[(rabbitmq)]
  Core --> Valkey[(valkey)]
  Core --> S3[(aws s3)]
  Core --> DDB[(aws dynamodb)]
  Core --> Sched[bf-schedule-creator]

  Incidents --> PGI[(postgresql-incidents)]
  Connect --> Core
  SitePwr --> Core
  Telematics --> Core
  Depot --> Connect
  DT --> Core
  DT --> Connect
  DT --> SitePwr

Runtime Characteristics¶

• Browser-facing URLs are localhost mapped host ports
• Internal service-to-service URLs use Compose DNS names
• Most Python services use uv run uvicorn --reload during development
• The stack is stateful due to persistent volumes for DB/MQ/cache

See Also¶

• Manage Product Capabilities
• Internal Application Diagrams
• Authorization and Permissions Overview
• Service Interaction Flows
• Data and State
• Manage Service Catalog