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
|
|||
|
|
```
|