mirror of
https://codeup.aliyun.com/67c68d4e484ca2f0a13ac3c1/ydc/jsowell-charger-web.git
synced 2026-04-20 11:05:18 +08:00
136 lines
3.1 KiB
Markdown
136 lines
3.1 KiB
Markdown
[根目录](../CLAUDE.md) > **jsowell-thirdparty**
|
||
|
||
# jsowell-thirdparty 模块
|
||
|
||
第三方平台对接模块，负责与外部系统的集成。
|
||
|
||
---
|
||
|
||
## 变更记录 (Changelog)
|
||
|
||
### 2026-02-03 11:32:30
|
||
- 初始化模块文档
|
||
- 识别 20+ 第三方平台对接
|
||
|
||
---
|
||
|
||
## 模块职责
|
||
|
||
- **政府平台对接**: 中电联、南瑞、各省市监管平台
|
||
- **地图服务**: 高德地图站点推送
|
||
- **停车场系统**: 停车场优惠券、车牌识别
|
||
- **支付通知**: 第三方平台订单通知
|
||
- **数据同步**: 站点、设备、订单数据同步
|
||
|
||
---
|
||
|
||
## 入口与启动
|
||
|
||
本模块为业务模块，无独立启动入口。
|
||
|
||
---
|
||
|
||
## 对外接口
|
||
|
||
### 第三方平台服务
|
||
|
||
| 服务 | 说明 |
|
||
|------|------|
|
||
| `ZDLService` | 中电联平台对接 |
|
||
| `NRService` | 南瑞平台对接 |
|
||
| `AMapService` | 高德地图服务 |
|
||
| `LianLianService` | 联联平台 |
|
||
| `HuaWeiService` | 华为平台 |
|
||
| `NXJTService` | 宁夏交投平台 |
|
||
| `LTYTService` | 停车场服务 |
|
||
| `RJService` | 停车场服务 |
|
||
| `QcyunsService` | 停车场服务 |
|
||
|
||
### 平台工厂
|
||
|
||
```java
|
||
// ThirdPartyPlatformFactory.java
|
||
public class ThirdPartyPlatformFactory {
|
||
// 根据平台类型获取对应的服务实现
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 关键依赖与配置
|
||
|
||
### Maven 依赖
|
||
|
||
```xml
|
||
<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
|
||
```
|