# steve-community/steve architecture

> Architecture diagram of the GitHub repository steve-community/steve, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/steve-community/steve
- Repository: https://github.com/steve-community/steve

## Overview

SteVe is an OCPP central-system server and web administration platform for managing charging stations, RFID tags, transactions, reservations, and configuration. The principal workflow is station registration and OCPP connection, message processing, and persistence/status reporting; administrators can also issue remote OCPP operations through the UI or REST API. The graph includes the documented SOAP and WebSocket/JSON protocol branches and the core administration capabilities. Links to unsampled subsystems are shown only where the README or SOURCE INDEX supports them; incomplete excerpts limit finer call-flow detail.

Main entry points: [`src/main/java/de/rwth/idsg/steve/service/CentralSystemService16_Service.java`](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/CentralSystemService16_Service.java) (Central system services), [`src/main/java/de/rwth/idsg/steve/repository/impl`](https://github.com/steve-community/steve/tree/master/src/main/java/de/rwth/idsg/steve/repository/impl) (Repositories), [`src/main/java/de/rwth/idsg/steve/web/controller`](https://github.com/steve-community/steve/tree/master/src/main/java/de/rwth/idsg/steve/web/controller) (Web administration), [`src/main/java/de/rwth/idsg/steve/service/ChargePointServiceClient.java`](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/ChargePointServiceClient.java) (Remote operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Admin access"]
  node_web["Web administration"]
  node_api["REST API"]
  node_auth["User authentication"]
end

subgraph group_station["Station operations"]
  node_station_mgmt["Station management"]
  node_tag_mgmt["RFID tag services"]
  node_ocpp_ops["Remote operations"]
  node_operation_controller["Operations API"]
  node_ocpp_service["Central system services"]
end

subgraph group_protocol["OCPP communication"]
  node_soap["SOAP endpoints"]
  node_websocket["WebSocket endpoints"]
  node_incoming["Incoming pipeline"]
  node_outgoing["Outgoing pipeline"]
  node_ocpp_protocol["Version and transport<br/>[OcppProtocol.java]"]
  node_tasks["OCPP task handlers"]
end

subgraph group_data["Persistence and services"]
  node_db[("MySQL / MariaDB")]
  node_repositories["Repositories"]
  node_transaction_service["Transaction reporting"]
  node_notification["Notifications"]
end

node_operator(("Operator"))
node_station_actor(("Charge point"))

node_operator -->|"uses"| node_web
node_operator -.->|"calls"| node_api
node_api -->|"authenticates"| node_auth
node_web -.->|"manages stations"| node_station_mgmt
node_web -.->|"manages tags"| node_tag_mgmt
node_api -->|"routes operations"| node_operation_controller
node_operation_controller -->|"delegates"| node_ocpp_ops
node_web -.->|"issues commands"| node_ocpp_ops
node_ocpp_ops -->|"creates tasks"| node_tasks
node_ocpp_ops -->|"loads operation data"| node_repositories
node_station_actor -->|"sends SOAP"| node_soap
node_station_actor -->|"connects JSON"| node_websocket
node_soap -.->|"dispatches OCPP"| node_ocpp_service
node_websocket -.->|"dispatches messages"| node_incoming
node_incoming -->|"handles calls"| node_ocpp_service
node_incoming -->|"selects version"| node_ocpp_protocol
node_ocpp_service -->|"checks registration"| node_station_mgmt
node_ocpp_service -->|"records events"| node_repositories
node_ocpp_service -->|"authorizes tags"| node_tag_mgmt
node_ocpp_ops -.->|"sends commands"| node_outgoing
node_outgoing -->|"transmits JSON"| node_station_actor
node_station_mgmt -->|"reads station data"| node_repositories
node_tag_mgmt -.->|"reads tag data"| node_repositories
node_repositories -.->|"reads and writes"| node_db
node_ocpp_service -->|"publishes events"| node_notification
node_web -.->|"views reports"| node_transaction_service
node_transaction_service -.->|"queries transactions"| node_repositories

click node_web "https://github.com/steve-community/steve/tree/master/src/main/java/de/rwth/idsg/steve/web/controller"
click node_api "https://github.com/steve-community/steve/tree/master/src/main/java/de/rwth/idsg/steve/web/api"
click node_auth "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/config/ApiAuthenticationManager.java"
click node_station_mgmt "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/ChargePointService.java"
click node_tag_mgmt "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/OcppTagService.java"
click node_ocpp_ops "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/ChargePointServiceClient.java"
click node_operation_controller "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/web/api/OcppOperationsController.java"
click node_ocpp_service "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/CentralSystemService16_Service.java"
click node_soap "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/ocpp/soap/CentralSystemService16_SoapServer.java"
click node_websocket "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/ocpp/ws/WebSocketEndpoint.java"
click node_incoming "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/ocpp/ws/pipeline/IncomingPipeline.java"
click node_outgoing "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/ocpp/ws/pipeline/OutgoingPipeline.java"
click node_ocpp_protocol "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/ocpp/OcppProtocol.java"
click node_tasks "https://github.com/steve-community/steve/tree/master/src/main/java/de/rwth/idsg/steve/ocpp/task"
click node_repositories "https://github.com/steve-community/steve/tree/master/src/main/java/de/rwth/idsg/steve/repository/impl"
click node_transaction_service "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/TransactionReportService.java"
click node_notification "https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/NotificationService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_api,node_auth toneBlue
class node_station_mgmt,node_tag_mgmt,node_ocpp_ops,node_operation_controller,node_ocpp_service toneAmber
class node_soap,node_websocket,node_incoming,node_outgoing,node_ocpp_protocol,node_tasks toneMint
class node_db,node_repositories,node_transaction_service,node_notification toneRose
class node_operator,node_station_actor toneIndigo
```

## Components

### Admin access

- [Web administration](https://github.com/steve-community/steve/tree/master/src/main/java/de/rwth/idsg/steve/web/controller): `src/main/java/de/rwth/idsg/steve/web/controller`
- [REST API](https://github.com/steve-community/steve/tree/master/src/main/java/de/rwth/idsg/steve/web/api): `src/main/java/de/rwth/idsg/steve/web/api`
- [User authentication](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/config/ApiAuthenticationManager.java): `src/main/java/de/rwth/idsg/steve/config/ApiAuthenticationManager.java`

### Station operations

- [Station management](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/ChargePointService.java): `src/main/java/de/rwth/idsg/steve/service/ChargePointService.java`
- [RFID tag services](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/OcppTagService.java): `src/main/java/de/rwth/idsg/steve/service/OcppTagService.java`
- [Remote operations](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/ChargePointServiceClient.java): `src/main/java/de/rwth/idsg/steve/service/ChargePointServiceClient.java`
- [Operations API](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/web/api/OcppOperationsController.java): `src/main/java/de/rwth/idsg/steve/web/api/OcppOperationsController.java`
- [Central system services](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/CentralSystemService16_Service.java): `src/main/java/de/rwth/idsg/steve/service/CentralSystemService16_Service.java`

### OCPP communication

- [SOAP endpoints](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/ocpp/soap/CentralSystemService16_SoapServer.java): `src/main/java/de/rwth/idsg/steve/ocpp/soap/CentralSystemService16_SoapServer.java`
- [WebSocket endpoints](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/ocpp/ws/WebSocketEndpoint.java): `src/main/java/de/rwth/idsg/steve/ocpp/ws/WebSocketEndpoint.java`
- [Incoming pipeline](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/ocpp/ws/pipeline/IncomingPipeline.java): `src/main/java/de/rwth/idsg/steve/ocpp/ws/pipeline/IncomingPipeline.java`
- [Outgoing pipeline](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/ocpp/ws/pipeline/OutgoingPipeline.java): `src/main/java/de/rwth/idsg/steve/ocpp/ws/pipeline/OutgoingPipeline.java`
- [Version and transport](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/ocpp/OcppProtocol.java): `src/main/java/de/rwth/idsg/steve/ocpp/OcppProtocol.java`
- [OCPP task handlers](https://github.com/steve-community/steve/tree/master/src/main/java/de/rwth/idsg/steve/ocpp/task): `src/main/java/de/rwth/idsg/steve/ocpp/task`

### Persistence and services

- **MySQL / MariaDB**
- [Repositories](https://github.com/steve-community/steve/tree/master/src/main/java/de/rwth/idsg/steve/repository/impl): `src/main/java/de/rwth/idsg/steve/repository/impl`
- [Transaction reporting](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/TransactionReportService.java): `src/main/java/de/rwth/idsg/steve/service/TransactionReportService.java`
- [Notifications](https://github.com/steve-community/steve/blob/master/src/main/java/de/rwth/idsg/steve/service/NotificationService.java): `src/main/java/de/rwth/idsg/steve/service/NotificationService.java`

### Other components

- **Operator**
- **Charge point**

## Connections

- Operator → Web administration: uses
- Operator → REST API: calls
- REST API → User authentication: authenticates (evidence: `src/main/java/de/rwth/idsg/steve/config/ApiAuthenticationManager.java`)
- Web administration → Station management: manages stations (evidence: `src/main/java/de/rwth/idsg/steve/web/controller/Ocpp12Controller.java`)
- Web administration → RFID tag services: manages tags (evidence: `src/main/java/de/rwth/idsg/steve/web/controller/Ocpp12Controller.java`)
- REST API → Operations API: routes operations (evidence: `src/main/java/de/rwth/idsg/steve/web/api/OcppOperationsController.java`)
- Operations API → Remote operations: delegates (evidence: `src/main/java/de/rwth/idsg/steve/web/api/OcppOperationsController.java`)
- Web administration → Remote operations: issues commands (evidence: `src/main/java/de/rwth/idsg/steve/web/controller/Ocpp12Controller.java`)
- Remote operations → OCPP task handlers: creates tasks (evidence: `src/main/java/de/rwth/idsg/steve/service/ChargePointServiceClient.java`)
- Remote operations → Repositories: loads operation data (evidence: `src/main/java/de/rwth/idsg/steve/service/ChargePointServiceClient.java`)
- Charge point → SOAP endpoints: sends SOAP
- Charge point → WebSocket endpoints: connects JSON
- SOAP endpoints → Central system services: dispatches OCPP
- WebSocket endpoints → Incoming pipeline: dispatches messages
- Incoming pipeline → Central system services: handles calls (evidence: `src/main/java/de/rwth/idsg/steve/ocpp/ws/pipeline/IncomingPipeline.java`)
- Incoming pipeline → Version and transport: selects version (evidence: `src/main/java/de/rwth/idsg/steve/ocpp/ws/pipeline/IncomingPipeline.java`)
- Central system services → Station management: checks registration (evidence: `src/main/java/de/rwth/idsg/steve/service/CentralSystemService16_Service.java`)
- Central system services → Repositories: records events (evidence: `src/main/java/de/rwth/idsg/steve/service/CentralSystemService16_Service.java`)
- Central system services → RFID tag services: authorizes tags (evidence: `src/main/java/de/rwth/idsg/steve/service/CentralSystemService16_Service.java`)
- Remote operations → Outgoing pipeline: sends commands
- Outgoing pipeline → Charge point: transmits JSON (evidence: `src/main/java/de/rwth/idsg/steve/ocpp/ws/pipeline/OutgoingPipeline.java`)
- Station management → Repositories: reads station data (evidence: `src/main/java/de/rwth/idsg/steve/service/ChargePointService.java`)
- RFID tag services → Repositories: reads tag data
- Repositories → MySQL / MariaDB: reads and writes
- Central system services → Notifications: publishes events (evidence: `src/main/java/de/rwth/idsg/steve/service/CentralSystemService16_Service.java`)
- Web administration → Transaction reporting: views reports
- Transaction reporting → Repositories: queries transactions
