GridPulse CSMS

Production-grade Charging Station Management System (CSMS) for heavy-duty CCS/MCS charging hubs.

Purpose

• manage thousands of charging stations
• track sessions accurately
• interoperate via standards
• scale horizontally
• be boringly reliable

Primary protocol spec: docs/spec/OCPP-2.1/

Documentation

• MANIFEST.md - Single source of truth
• ARCHITECTURE.md - System design and boundaries
• AGENTS.md - Engineering contract and ownership
• RUNBOOK.md - Operational guides and commands
• NEXT_STEPS.md - Execution plan

Getting Started

See RUNBOOK.md for full details.

Prerequisites

• Go 1.22+
• Docker

Quick Start

# Install deps
go mod tidy

# Run tests
go test ./...

# Start infra
docker compose up -d postgres nats

Architecture

Event-driven microservices:

• Gateway: OCPP websocket + validation
• Session: Charging session state machine
• Registry: Charging Station inventory + auth
• Pricing: Tariffs + cost logic
• OCPI: Roaming interoperability

See ARCHITECTURE.md for details.