Skip to content

Battery Swap Service (BSS) Model

Overview

The BSS model implements a comprehensive battery swap service within the ABS Platform, featuring FSM-driven state management, agent-based business logic, and MQTT integration for IoT coordination.

Key Architecture: FSM signal compression with 8 fundamental signals, enhanced agent v2 with centralized state management, and W1-W5 rider workflow implementation.

🔍 BSS Model vs. Ecosystem Participants

BSS (Battery Swap Service) is the service model that defines the operational and technical implementation: - Customer subscription lifecycle (signup, payment, renewal) - Service delivery workflows (W1-W5 rider workflow, attendant operations) - FSM state management (payment cycle, service cycle) - Agent behaviors (quota tracking, payment processing, inventory management)

Ecosystem Participants operating within the BSS model: - BCS (Battery Circulation Service): Asset provider that owns/manages battery assets and handles circulation logistics - SNS (Swap Network Service): Network operator that manages swap stations and customer subscriptions - Customers: End-users who subscribe to battery swap services

Note: This repository focuses on the operational/technical BSS model. Financial modeling of BCS and SNS as business units is maintained separately in the BUFM (Business Unit Financial Model) framework.

🚀 Quick Start

For Developers

  • Model Status - Complete technical status, architecture details, and implementation progress

For Business Analysis

Configuration & Data

  • Setup Data - Schema-compliant configuration files
  • Interactions - System interaction patterns and external integrations

🎯 BSS Service Features

  • Instant Battery Swaps: Fleet-based allocation via ARM microservice
  • FSM-Driven States: Payment and service cycle management
  • MQTT Integration: Real-time IoT coordination
  • Signal Compression: Clean FSM with agent complexity handling
  • Template-Driven: ServicePlanTemplate configuration system

📊 Current Status

✅ Implementation Complete - All core functionality implemented and tested ✅ Schema Compliant - Fully aligned with ABS Platform GraphQL schema ✅ DIRAC Ready - Integrated with the broader OVES digital ecosystem

For detailed status information, see model-status.md.

📈 Architecture Status

✅ FSM Signal Compression - External signals compressed to 8 fundamental FSM inputs
✅ Enhanced Agent v2 - Single delegation function with centralized state management
✅ W1-W5 Rider Workflow - Complete fleet-based implementation with ARM integration
✅ Schema Aligned - All setup data matches corrected GraphQL schema

For detailed status, implementation specifics, and next steps, see model-status.md

BSS Model: ✅ READY FOR INTEGRATION
Architecture: Architecture Overview | Platform Overview: Platform Index