jsowell-charger-web/jsowell-thirdparty/CLAUDE.md

根目录 > jsowell-thirdparty

jsowell-thirdparty 模块

第三方平台对接模块，负责与外部系统的集成。

---

变更记录 (Changelog)

2026-02-03 11:32:30

• 初始化模块文档
• 识别 20+ 第三方平台对接

---

模块职责

• 政府平台对接: 中电联、南瑞、各省市监管平台
• 地图服务: 高德地图站点推送
• 停车场系统: 停车场优惠券、车牌识别
• 支付通知: 第三方平台订单通知
• 数据同步: 站点、设备、订单数据同步

---

入口与启动

本模块为业务模块，无独立启动入口。

---

对外接口

第三方平台服务

服务	说明
ZDLService	中电联平台对接
NRService	南瑞平台对接
AMapService	高德地图服务
LianLianService	联联平台
HuaWeiService	华为平台
NXJTService	宁夏交投平台
LTYTService	停车场服务
RJService	停车场服务
QcyunsService	停车场服务

平台工厂

// ThirdPartyPlatformFactory.java
public class ThirdPartyPlatformFactory {
    // 根据平台类型获取对应的服务实现
}

---

关键依赖与配置

Maven 依赖

<dependencies>
    <dependency>
        <groupId>com.jsowell</groupId>
        <artifactId>jsowell-pile</artifactId>
    </dependency>
</dependencies>

---

数据模型

平台通用数据结构

类	说明
StationInfo	站点信息
ConnectorStatusInfo	充电枪状态
ChargeOrderInfo	充电订单
AlarmInfo	告警信息

高德地图数据

类	说明
AMapStationInfo	高德站点信息
AMapEquipmentInfo	高德设备信息
AMapConnectorInfo	高德充电枪信息
AMapPriceChargingInfo	高德计费信息

---

常见问题 (FAQ)

Q: 第三方平台数据同步失败？

1. 检查平台配置（ThirdPartyPlatformConfig）
2. 检查密钥配置（ThirdpartySecretInfo）
3. 查看同步日志

Q: 高德地图站点不显示？

1. 检查站点是否已推送
2. 检查站点状态是否正常
3. 查看 AMapService 调用日志

---

相关文件清单

jsowell-thirdparty/
├── src/main/java/com/jsowell/thirdparty/
│   ├── amap/                      # 高德地图
│   │   ├── domain/
│   │   ├── service/
│   │   └── util/
│   ├── camera/                    # 摄像头
│   ├── common/                    # 通用服务
│   ├── huawei/                    # 华为平台
│   ├── lianlian/                  # 联联平台
│   ├── nanrui/                    # 南瑞平台
│   ├── ningxiajiaotou/            # 宁夏交投
│   ├── parking/                   # 停车场
│   ├── platform/                  # 平台通用
│   │   ├── common/
│   │   ├── domain/
│   │   ├── factory/
│   │   └── service/
│   ├── yongchengboche/            # 永城泊车
│   └── zhongdianlian/             # 中电联
└── pom.xml