bf-manage-connect¶

What this service is¶

bf-manage-connect is the charging-protocol integration backend. It brokers OCPP interactions between charge point devices and the BetterFleet platform.

Code anatomy¶

• src/main.py: FastAPI app entrypoint.
• src/core_connection/*: integration to core platform workflows.
• src/ocpp_connection/*: OCPP connection/session lifecycle management.
• src/ocpp_handlers/v1_6 and src/ocpp_handlers/v2_0_1: protocol-version-specific message handling.
• src/auth, src/admin, src/_config, src/_helpers: shared cross-cutting modules.

Architectural characteristics¶

• Protocol adapter service with clear version partitioning for OCPP 1.6 and 2.0.1.
• Strong testing focus around protocol handling and fake apps/clients for simulation.

Documentation and tests in-repo¶

• docs/connect.md, docs/arch.md, OCPP reference documents in docs/OCPP-2.0.1/.
• Tests under test/ocpp_connection and test/ocpp_handlers/*.

Internal request lifecycle¶

sequenceDiagram
  participant Device as charger device
  participant Conn as ocpp connection
  participant Handler as ocpp handler
  participant CoreLink as core connection
  participant Core as manage core

  Device->>Conn: protocol message
  Conn->>Handler: dispatch by protocol version
  Handler->>CoreLink: translate to platform action
  CoreLink->>Core: call core endpoint
  Core-->>CoreLink: operation result
  CoreLink-->>Handler: response payload
  Handler-->>Device: protocol response