[根目录](../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
```