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-bnl-ui
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
          • 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
            • What this service is
            • Code anatomy
            • Architectural characteristics
            • Documentation and tests in-repo
          • 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-bnl-ui¶

    What this service is¶

    bf-bnl-ui is the Plan frontend. It provides schedule/resource/simulation workflows and routes requests to either legacy Plan backends or digital twin APIs depending on migration flags.

    Code anatomy¶

    • src/api/endpoints.ts: API path selection logic for legacy vs digital twin modes.
    • src/hooks/useAxios.ts, src/hooks/usePlanDigitalTwinMigration.tsx: base URL routing and feature-flag behavior.
    • src/components/pages/plan-v2/*: newer Plan v2 flows.
    • src/services/*: domain-specific service hooks for vehicles, depots, scenarios, parser, reports, and energy data.
    • src/router/* and src/context/*: route and app context boundaries.

    Architectural characteristics¶

    • Flag-driven dual-backend client behavior (plan-digital-twin-migration).
    • Hybrid codebase with legacy and plan-v2 page structures.
    • Hook/service-heavy architecture for API interaction boundaries.

    Documentation and tests in-repo¶

    • Endpoint and migration behavior heavily represented in hooks and endpoint tests.
    • UI tests under src/__tests__ and module tests in API/hooks areas.
    Made with Material for MkDocs