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
BetterFleet Product Ontology
Initializing search
    bf-dev
    • Home
    • Process
    • Products
    • Reference
    • Decisions
    • Work
    • Operations
    bf-dev
    • Home
      • Process Handbook
      • BetterFleet Workflow Map
      • Product Development System
      • Product Engineering Workflow
        • Process Workflows
        • Work Intake and Weekly Planning
        • Product Engineering Workflow in Linear
        • Product Engineering Delivery
        • Agent Guidance
        • Workflow
        • Skills
        • Skill Sources
        • Process Guides
        • GitLab Feature Flags
        • In-App Docs Authoring
        • Release Notes
        • Process Templates
        • Release Plan: <title>
      • Process Publishing
      • Product overview
        • General Reference
          • Core Domain Training
          • System Topology
          • Two-Axis Ontology Model
          • Ontology Primer
          • Worked Example
          • Evidence, Ownership, and Lineage
          • Energy Management
          • Standards and Protocol Map
          • Charging, Roaming, and Commercial Model
          • Charge Planning and Operations
          • Cross-Cutting Domains
          • Domain Coverage Matrix
        • BetterFleet Product Ontology
          • Organising Principle: Domain Independence
          • Domains and Sub-Themes
          • Analytical Lenses
            • Domain Lens
            • Physical Lens
            • Persona Lens
            • Marketing Lens
          • Feature Definition Principles
        • Core Operations Data Ontology
        • BetterFleet R&D Plan
        • Index
        • Architecture
        • Manage Product Capabilities
        • Manage Data and State
        • Manage Service Interaction Flows
        • Manage Reference
        • Manage Internal Application Diagrams
          • Manage Authorization And Permissions
          • bf-manage-core Auth and Authorization Model
          • Manage Authorization and Permissions
          • bf-manage-web Auth and Permission Model
          • Manage Service Catalog
          • bf-depot-sim
          • bf-digital-twin (Manage Role)
          • bf-fleet-health
          • bf-manage-connect
          • bf-manage-core
          • bf-manage-incidents
          • bf-manage-roaming
          • bf-manage-sitepwrmon
          • bf-manage-web
          • bf-schedule-creator (Manage Role)
          • bf-support-microsite
          • bf-telematics
        • Index
        • Architecture
        • Plan Reference
        • Plan Internal Application Diagrams
        • Plan Migration and Flags
        • Plan Simulation Request Lifecycle
          • Plan Service Catalog
          • bf-bnl-schedule-analysis-compute
          • bf-bnl-settings
          • bf-bnl-ui
          • bf-digital-twin (Plan Role)
          • bf-route-modelling
          • bf-schedule-creator (Plan Role)
      • Where to Ask Product Questions
      • Reference
        • Platform Reference
        • Platform Architecture
        • Script Runtime Model
        • Compose Profiles and Modes
        • Repository Map
        • Monolithic Git Transition FAQ
        • Monolithic Git Sizing
        • CI and Release Integration
        • Shared Reference
        • Shared Infrastructure Architecture
        • Secrets and Env Strategy
        • Vendors and Local Dependencies
        • System Reference
        • Cloud Data Dependencies
        • Ports and URLs
        • Service Matrix
          • API Docs
          • OCPI API Docs
          • OCPP API Docs
          • OSCP API Docs
          • VDV API Docs
          • Yard State API Docs
        • System Design
        • System Design: BBA Microgrid Controller Generic Packet Translation
        • System Design: Depot Simulation
        • System Design: IoT Sensor Packet
        • System Design: Microgrid Energy Orchestration
          • System Design: OCPP Profile 3 And ISO 15118 PKI
          • Architecture: BetterFleet OCPP Profile 3 and ISO 15118 PKI
          • Specification: BetterFleet OCPP Profile 3 and ISO 15118 Certificate Lifecycle Management
          • System Design: On-Prem Control
          • Challenge
          • Specification: BetterFleet On-Prem Continuity Control
          • System Design: OSCP
          • OSCP Protocol Documentation
          • Depot Sim Testing Requirements
          • System Design: OSCP Flexibility Provider Domain
      • Decisions
        • Architecture Decision Records
        • 0001 - Record architecture decisions
        • 0002 - Cognito for Authentication and Authorisation
        • 0003 - AWS Amplify for Authentication
        • 0004 - DynamoDB for default database
        • 0005 - Data Persistence
        • 0006 - Trunk-Based Development
        • 0007 - Generalised principle for automation
        • 0008 - Naming Repositories, Services, and URLs
        • 0009 - Use Timezone Aware DateTimes and UTC
        • 0010 - Use semantic release
        • 0011 - Centralized feature flag repository
        • 0012 - Use Named Exports in Storybook
        • 0013 - RESTful TITLE GraphQL
        • 0014 - Service Granularity
        • 0015 - Async/co-routine exception handling pattern
        • 0016 - Logging & log levels
        • 0017 - Instantiated Models
        • 0018 - Repository Pattern for Database Access
        • 0019 - Use of Design Tokens in TypeScript React Application
        • 0020 - API backwards compatibility and versioning
        • 0021 - Alembic Migration strategy
        • 0022 - Consistent react-hook-form usage
        • 0023 - Domain Event-Driven Architecture
        • 0024 - Domain Event Bus Tech Stack
        • 0025 - No enum types in DB table columns
        • 0026 - In-Memory Ormar Stores for Repository testing
        • 0027 - Storing Tab State in Query and Local Storage
        • 0028 - Adopt OpenTelemetry Semantic Conventions for Structured Logging
        • 0029 - Adopt RFC 9457 for HTTP Error Responses
        • 0030 - Use GitLab registry and Terraform state for ECS services
        • 0031 - Adopt DDD, Hexagonal Architecture, and CQRS for Python Domain Services
      • Work
        • Active Work
          • Work: Bba Microgrid Controller
          • Implementation Specification: BBA Microgrid Controller
          • BBA Microgrid Controller Deliverables (Stories)
          • Work: BFDev Monolithic Git
          • Challenge
          • Specification: BFDev Monolithic Git v2
          • BFDev Monolithic Git v2 Stories
          • Work: Complex Circuit Load Balancing
          • Implementation Specification: Complex Circuit Load Balancing
          • Complex Circuit Load Balancing Deliverables (Stories)
            • COR-10 and COR-11 Consolidation Review
          • Work: Dispatch Reliability and Reconciliation
          • Challenge
          • Specification: Dispatch Reliability and Reconciliation
          • Dispatch Reliability and Reconciliation (Unit User Stories)
            • Dispatch populated vehicle cards grey surface snapshot
            • Dispatch Visual Review
          • Work: Enable Scheduled Managed Charger Access
          • Challenge: Enable Scheduled Managed Charger Access
          • Specification Exploration Dossier: Enable Scheduled Managed Charger Access
          • Specification Review: Enable Scheduled Managed Charger Access
          • Specification: Enable Scheduled Managed Charger Access
          • Work: Guided Cut-Off and Release Orchestration
          • Specification: Guided Cut-Off and Release Orchestration
          • Guided Cut-Off and Release Orchestration (Unit User Stories)
          • Work: Production Deployment Validation
          • Challenge
          • Work: Scheduled Report Parity
          • Specification: Scheduled Report Parity
          • Work: Telematics
          • Telematics EventBridge Path
          • Telematics Ingress Architecture
          • Specification: Telematics Migration into bf-manage-core with 5-Minute Freshness and Health Visibility
          • Telematics Core Migration MVP (Implementation-Time BDD)
          • Work: Vector Derms
          • Implementation Specification: Vector DERMS
          • Vector DERMS Deliverables (Stories)
          • Work: Visiting Vehicle Charging Visibility
          • Specification: Visiting Vehicle Charging Visibility
          • Visiting Vehicle Charging Visibility (Unit User Stories)
          • Work: Workspace Owned Stripe Roaming
          • Specification: Workspace-Owned Stripe Credentials for Roaming Payments
        • Backlog Work
          • Work: Microgrid
          • Microgrid Backlog Stories
          • Work: Mobile Ops Companion
          • Challenge
          • Specification: Mobile Operations Companion v1
          • Mobile Operations Companion Deliverables (Stories)
          • Work: Oscp
          • OSCP Backlog Stories
        • Archived Work
          • Work: Code Canonical Orchestration
          • Challenge
          • Specification: Product Engineering Workflow
          • Product Engineering Workflow Deliverables (Unit User Stories)
          • Work: Release Notes Automation
          • Release Plan: Release Notes Automation
          • Release Notes Automation Backlog Stories
      • Operations
      • Onboarding Runbook
        • Operations Runbooks
        • Production Hotfix Release
        • Staging Hotfix Release
        • Manage Staging Release Validation
        • Terraform Plan Dry Runs
        • Operations Tooling
        • Code Indexing
        • Operations Evidence
        • Database Restoration Test Report
      • Daily Operations Runbook
      • Testing Guide
      • Troubleshooting
    • Organising Principle: Domain Independence
    • Domains and Sub-Themes
    • Analytical Lenses
      • Domain Lens
      • Physical Lens
      • Persona Lens
      • Marketing Lens
    • Feature Definition Principles
    1. Home
    2. Products
    3. General
    general reference

    BetterFleet Product Ontology¶

    Organising Principle: Domain Independence¶

    Each domain represents a real-world problem space that exists independently of BetterFleet. It should be recognizable to an EV fleet operator, grid engineer, or charge point operator regardless of which software they use.

    This is the distinction between an ontology and a taxonomy:

    • An ontology maps the domain relationships.
    • A taxonomy classifies BetterFleet features.

    An ontology-first approach means:

    • Domain names are stable as the product grows, so new features slot into existing domains rather than forcing renames.
    • The structure can be shared with customers, analysts, and partners without being BetterFleet-specific.
    • It serves as a durable foundation for roadmapping and capability conversations.
    • It supports clearer, cleaner, more independent feature definitions.

    Each domain also has sub-themes that make the ontology usable for finer-grained planning and analysis.

    For internal product questions, use Where to Ask Product Questions to map these domains to Slack channels.

    Domains and Sub-Themes¶

    Domain What it describes Sub-themes
    Smart Charging Controlling chargers and directing energy to vehicles using strategies such as load balancing, prioritisation, and scheduling. Charger Control; Load Management; Protocol & Interoperability
    Energy & Cost Management Where energy comes from, how it is priced, and how cost and carbon are optimised, including tariffs, V2G, demand response, and storage integration. Site Energy & Infrastructure; Advanced Energy & Grid
    Operations & Dispatch Day-to-day fleet and depot management, including vehicle readiness, scheduling integration, geo-tracking, and multi-depot visibility. Fleet & Vehicle Management; Depot & Integration; Dispatch & Scheduling
    Roaming & Shared Charging Access, interoperability, and billing across charger networks, including inter-fleet, public access, and intra-fleet cost allocation. Network Access & Interoperability; Commercial Settlement & Shared Charging
    Incidents & Notifications Detection, alerting, and resolution of faults and events, including real-time alerts, diagnostics, and support ticketing. Alerting; Detection; Incident & Resolution Management
    Reporting & Insights Historical data, analytics, and compliance output, including session logs, dashboards, and cost/carbon reporting. Fleet & Charging Analytics; Operational Dashboards; Cost, Carbon & Compliance
    Resilience & Security Platform integrity, including uptime, failover, data protection, access control, and compliance certifications. Platform Reliability & Safety; Security & Access Control
    Accessibility & Usability User experience, onboarding, and support, including UI/UX design, documentation, and customer success. User Experience; Onboarding & Support
    mindmap
      root((BetterFleet
      Ontology))
        Smart Charging
          Charger Control
          Load Management
          Protocol & Interoperability
        Energy & Cost Management
          Site Energy & Infrastructure
          Advanced Energy & Grid
        Operations & Dispatch
          Depot & Integration
          Dispatch & Scheduling
          Fleet & Vehicle Management
        Roaming & Shared Charging
          Out of Depot
          3rd party in Depot
        Incidents & Notifications
          Alerting
          Detection
          Incident & Resolution Mgmt
        Reporting & Insights
          Cost, Carbon & Compliance
          Fleet & Charging Analytics
          Operational Dashboards
        Resilience & Security
          Platform Reliability & Safety
          Security & Access Control
        Accessibility & Usability
          Onboarding & Support
          User Experience

    Analytical Lenses¶

    Domain Lens¶

    Question: What problem space does this feature address?

    This is the primary organising lens. It is stable, internal, and used for roadmapping and development planning. It maps to how engineers and product managers think about the system.

    Physical Lens¶

    Question: What asset in the physical or operational chain does this feature act on?

    Seven nodes: Vehicle · Charger · Site · Grid · Fleet · Network · Organisation

    This lens is useful for identifying gaps, planning integrations, and communicating with infrastructure and operations stakeholders. It shows where product capability sits in the charge-to-dispatch flow.

    Persona Lens¶

    Question: Who is the primary user of this feature?

    Six personas: Depot Operator · Fleet Manager · Energy Manager · IT / Security · Finance / Sustainability · Commercial / Network

    This lens is useful for UX prioritisation, sales packaging, and identifying underserved user types.

    Marketing Lens¶

    Question: What outcome does this feature enable for a buyer?

    Five outcome clusters: Fleet Readiness · Cost & Carbon Control · Operational Visibility · Trusted Platform · Unlock Your Infrastructure

    This lens is useful for go-to-market messaging, sales decks, and RFP responses. It is derived from the domain ontology rather than driving it, so marketing language remains grounded in product reality.

    Feature Definition Principles¶

    A clean feature entry satisfies four conditions:

    Single domain. The feature belongs unambiguously to one domain. If it could reasonably be placed in two, it is doing double duty and should be split. The test is whether two different product managers would independently file it in the same place.

    Single primary actor. The feature has one primary persona. If it serves two fundamentally different users in different ways, it is usually two features with shared implementation rather than one feature with two users.

    Atomic capability. The feature describes one thing the user can do, not a bundle of related behaviors. Names joined by & or and are usually candidates for splitting unless they are always delivered together and never used independently.

    Testable scope. A clean feature can be scoped into a ticket without ambiguity about what is and is not included. If the boundary requires a paragraph of explanation, the definition is too broad.

    Made with Material for MkDocs
    BFDev Docs Assistant
    New conversation?
    Ask one focused question at a time, this helps the assistant provide accurate answers about what's been implemented in BetterFleet.