Google Sign-In Required

Use your company Google account to access the BetterFleet private content.

Back to private home

BetterFleet Support Private
Skip to content
BetterFleet Dev Wiki
bf-depot-sim
Initializing search
    bf-dev
    • Home
    • Product Capabilities
    • Process
    • Current Work
    • System Design
    • Software Reference
    • Operations
    bf-dev
    • Home
      • Overview
      • Manage
      • Overview
      • Product Engineering Workflow
      • Product Engineering Delivery
      • Product Engineering Workflow in Linear
        • GitLab Feature Flags
        • In-App Docs Authoring
        • Release Notes
      • Templates
      • Publishing
      • Workflow Companions
      • Overview
      • Active Artifacts
      • Backlog Artifacts
      • Archived Artifacts
      • Overview
      • Microgrid
      • OSCP
        • Challenge
        • Specification
        • Spec
        • Architecture
        • Overview
        • Script Runtime Model
        • Compose Profiles and Modes
        • Repo Topology
        • CI and Release Integration
        • Overview
        • Internal Application Diagrams
          • Overview
          • Web Model
          • Core Model
        • Service Interaction Flows
        • Data and State
          • Index
          • bf-manage-web
          • bf-manage-core
          • bf-manage-connect
          • bf-manage-sitepwrmon
          • bf-manage-incidents
          • bf-telematics
          • bf-depot-sim
            • What this service is
            • Code anatomy
            • Architectural characteristics
            • Documentation and tests in-repo
          • bf-manage-roaming
          • bf-support-microsite
          • bf-digital-twin
          • bf-schedule-creator
        • Overview
        • Internal Application Diagrams
        • Migration and Flags
        • Simulation Request Lifecycle
          • Index
          • bf-bnl-ui
          • bf-bnl-settings
          • bf-bnl-schedule-analysis-compute
          • bf-route-modelling
          • bf-schedule-creator
          • bf-digital-twin
        • Overview
        • Secrets and Env Strategy
        • Vendors and Local Dependencies
        • ADRs
        • Service Matrix
        • Cloud Dependencies
        • Ports and URLs
      • Onboarding
      • Daily Operations Runbook
        • Overview
        • Staging Hotfix Release
        • Production Hotfix Release
        • Terraform Plan Dry Runs
      • Troubleshooting
      • Testing Guide
    • What this service is
    • Code anatomy
    • Architectural characteristics
    • Documentation and tests in-repo

    bf-depot-sim¶

    What this service is¶

    bf-depot-sim is a depot and charger simulation backend used for operational testing, integration validation, and scenario-driven charger behavior emulation.

    Code anatomy¶

    • src/main.py: API factory and daemon start path.
    • src/simulation/*: simulation engine modules split across charger, fleet, power, and helper utilities.
    • src/agent/*: autonomous behavior agents and HTTP control layer for scripted/random actions.
    • src/api/*: web-service wrappers/control APIs.
    • src/config/*: configuration models and profile loading.

    Architectural characteristics¶

    • Dual mode: direct simulator execution and API-wrapped daemon mode.
    • Agent-driven scenario behavior for realistic charger lifecycle actions.
    • socat compatibility bridge used in bf-dev compose wiring for local hostname expectations.

    Documentation and tests in-repo¶

    • Detailed README with OCPP behavior notes and agent descriptions.
    • Test suites under test/charger, test/power, and test/simulation.
    Made with Material for MkDocs