Files
JChargePointProtocol/docs/系统概述.md
三丙 771b10eb10 docs: 更新开发者指南和系统概述,简化内容并增强可读性
- 精简开发者指南,聚焦于本地开发流程和环境准备
- 更新系统概述,明确系统定位和核心能力
- 删除冗余引用和目录,优化文档结构
2026-05-08 15:27:19 +08:00

1.9 KiB
Raw Blame History

系统概述

JChargePointProtocol 是面向充电桩协议接入与设备管理的服务端平台,核心目标是把“多厂家私有协议”统一为“标准化平台能力”。

系统定位

  • 对下:通过 TCP 长连接接入充电桩,解析厂商协议
  • 对上:通过 REST/gRPC/Kafka 对业务系统提供统一能力
  • 对内:以模块化方式隔离协议差异,保证可扩展与可维护

核心能力

  • 设备管理:站点、充电桩、充电枪全生命周期管理
  • 协议接入:当前已支持云快充、绿能协议,可按模式扩展新协议
  • 指令下发:支持应用侧到协议侧的远程控制链路
  • 状态采集:上行消息实时解析、转发与状态更新
  • 运行治理:缓存、监控、日志、部署配置等基础支撑

模块划分

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