mirror of
https://gitee.com/san-bing/JChargePointProtocol
synced 2026-06-25 01:19:39 +08:00
56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
# 系统概述
|
||
|
||
JChargePointProtocol 是面向充电桩协议接入与设备管理的服务端平台，核心目标是把“多厂家私有协议”统一为“标准化平台能力”。
|
||
|
||
## 系统定位
|
||
|
||
- 对下：通过 TCP 长连接接入充电桩，解析厂商协议
|
||
- 对上：通过 REST/gRPC/Kafka 对业务系统提供统一能力
|
||
- 对内：以模块化方式隔离协议差异，保证可扩展与可维护
|
||
|
||
## 核心能力
|
||
|
||
- 设备管理：站点、充电桩、充电枪全生命周期管理
|
||
- 协议接入：当前已支持云快充、绿能协议，可按模式扩展新协议
|
||
- 指令下发：支持应用侧到协议侧的远程控制链路
|
||
- 状态采集：上行消息实时解析、转发与状态更新
|
||
- 运行治理：缓存、监控、日志、部署配置等基础支撑
|
||
|
||
## 模块划分
|
||
|
||
```text
|
||
jcpp-app 业务与管理接口
|
||
jcpp-protocol-* 协议处理与设备通信
|
||
jcpp-web-ui 可视化管理前端
|
||
jcpp-infrastructure-* 通用基础设施（缓存、队列、工具等）
|
||
```
|
||
|
||
## 关键链路
|
||
|
||
### 上行链路（设备 -> 平台）
|
||
|
||
1. 设备通过 TCP 发送协议报文
|
||
2. 协议模块解析报文并构建标准消息
|
||
3. 消息进入业务处理或转发到消息队列
|
||
4. 应用层更新设备状态、业务数据
|
||
|
||
### 下行链路（平台 -> 设备）
|
||
|
||
1. 应用层生成下行指令（REST/gRPC）
|
||
2. 协议模块根据会话定位目标连接
|
||
3. 协议编码后写入 TCP 通道
|
||
4. 设备执行并通过上行结果回传
|
||
|
||
## 运行形态
|
||
|
||
- 单体模式：`app + protocol` 同进程部署，适合开发与轻量场景
|
||
- 微服务模式：应用服务与协议服务拆分部署，适合规模化场景
|
||
|
||
## 文档索引
|
||
|
||
- 架构设计：`架构设计/`
|
||
- 协议细节：`核心模块详解/协议实现模块/`
|
||
- API 文档：`API接口参考/`
|
||
- 运维排障：`监控与运维.md`
|
||
- 开发上手：`开发者指南.md`
|