bf-bnl-schedule-analysis-compute¶

What this service is¶

bf-bnl-schedule-analysis-compute is the legacy compute service for Plan simulations. It performs trip/charging/depot and SOH-related analyses and returns computed outputs to orchestrators.

Code anatomy¶

• src/app.py: FastAPI app entrypoint.
• src/scheduleAnalysis/*: schedule analysis pipeline modules.
• src/chargingAnalysis/*: charging strategy and charging-data analysis.
• src/depotAnalysis/*: depot-oriented analysis, with experiments/helpers.
• src/sohAnalysis/*: battery state-of-health analysis.
• src/stats/*: metrics/statistical utilities.

Architectural characteristics¶

• Batch/compute oriented service with scenario lock/update flow documented in README.
• Legacy Pipenv-based dependency management in-repo.

Documentation and tests in-repo¶

• README includes task execution flow diagram and local run guidance.
• Tests segmented by analysis domain with substantial fixture data.

Internal request lifecycle¶

sequenceDiagram
  participant Caller as settings service
  participant Api as compute api
  participant Schedule as schedule analysis
  participant Charging as charging analysis
  participant Depot as depot analysis
  participant Soh as soh analysis
  participant Route as route modelling
  participant S3 as aws s3

  Caller->>Api: analysis request
  Api->>Schedule: derive schedule metrics
  Api->>Charging: derive charging strategy outputs
  Api->>Depot: derive depot metrics
  Api->>Soh: derive battery soh outputs
  Charging->>Route: call route modelling when needed
  Route-->>Charging: route modelling outputs
  Api->>S3: write or read compute artifacts when configured
  Api-->>Caller: aggregated compute response