JChargePointProtocol/docs/系统概述.md

# 系统概述

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`