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
Implementation Specification: Vector DERMS
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
          • 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
    • Summary
    • System Design References
    • Project Goal
    • In Scope
    • Story Scope
    • Cross-Project Microgrid Dependencies
    • Vector-Specific Short-Term Variations
    • Explicitly Out of Scope for This Project
    • Backlog Link

    Implementation Specification: Vector DERMS¶

    Summary¶

    This implementation specification defines the project-scoped delivery for the Vector DERMS milestone.

    It is an incremental delivery plan against the long-lived OSCP and microgrid system designs. It captures the Vector-specific scope, partner-profile constraints, and short-term implementation choices needed to deliver the first OSCP integration without changing the long-term system design direction.

    System Design References¶

    • Primary system design: docs/system-design/oscp/spec.md
    • Dependent system design: docs/system-design/microgrid/spec.md

    Project Goal¶

    Deliver a Vector-compatible OSCP Flexibility Provider integration that binds Vector group_id values to managed microgrid scopes, manages connection configuration and lifecycle, translates incoming forecasts into microgrid OperatingEnvelope constraints, and publishes outbound metering, adjustment, and compliance messages through the OSCP domain.

    In Scope¶

    • OSCP configuration entity covering group binding to a managed microgrid scope and connection profile management.
    • OSCP operations visibility, registration, handshake, heartbeat, and lifecycle state.
    • Protocol-agnostic OperatingEnvelope translation for OSCP forecast effects, initially applied by updating legacy circuit available-capacity values associated with the mapped managed scope when that scope corresponds to a grid-connection circuit.
    • Forecast intake and translation into the microgrid OperatingEnvelope boundary.
    • Outbound group and asset measurement publication through the interim dispatcher.
    • Manual adjustment flow and compliance-error publication.
    • Vector-specific measurement profile behavior.

    Story Scope¶

    • All stories in stories.md in this folder.

    Cross-Project Microgrid Dependencies¶

    • Microgrid Provisioning and Management
    • External Capability Status to Microgrid Card
    • Microgrid Status Summary View
    • Manage UI Cycle and Breach Visibility

    Vector-Specific Short-Term Variations¶

    • The first rollout uses the Vector partner profile on top of the generic OSCP system design.
    • measurement_configuration=INTERMITTENT is required for this project.
    • The Vector profile uses UpdateAssetMeasurements as a partner-profile deviation from the canonical Capacity Provider measurement path.
    • OAuth Client Credentials and required static header behavior are part of this project scope as partner-profile configuration concerns.
    • Quarter-hour aligned metering windows and initial_measure_time behavior are required in this project even though the system design keeps that logic generic.
    • The first OperatingEnvelope implementation writes through to legacy circuit available-capacity fields and uses legacy UI surfaces for operator visibility when the managed scope maps to a legacy grid-connection circuit.

    Explicitly Out of Scope for This Project¶

    • Generalized Capacity Optimizer support.
    • Broader multi-partner OSCP profile support beyond what is needed for Vector.
    • Complex multi-branch load-balancing redesign beyond the explicit OperatingEnvelope story and the listed cross-project dependencies.
    • A canonical microgrid operating-envelope history or detail view beyond what is required for the interim legacy-circuit path.

    Backlog Link¶

    • Future OSCP stories not assigned to this project should be tracked under docs/artifacts/backlog/oscp/stories.md.
    Made with Material for MkDocs