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

[根目录](../CLAUDE.md) > **jsowell-pile**

# jsowell-pile 模块

充电桩业务核心模块，包含订单、会员、计费、支付等核心业务逻辑。

---

## 变更记录 (Changelog)

### 2026-02-03 11:32:30
- 初始化模块文档
- 识别 80 个 Service 实现类
- 统计 60+ Mapper XML 文件

---

## 模块职责

- **订单管理**: 充电订单创建、结算、分账、退款
- **会员服务**: 会员注册、钱包管理、积分系统
- **计费管理**: 计费模板、时段电价、服务费
- **支付集成**: 微信支付、支付宝、汇付支付（Adapay）
- **设备管理**: 充电桩、充电枪、站点信息
- **商户管理**: 商户信息、分账配置、清算账单

---

## 入口与启动

本模块为业务模块，无独立启动入口，由 `jsowell-admin` 模块引用。

### 核心 Service

| Service | 说明 |
|---------|------|
| `OrderBasicInfoServiceImpl` | 订单核心服务（创建、结算、分账） |
| `MemberBasicInfoServiceImpl` | 会员服务 |
| `MemberWalletInfoServiceImpl` | 钱包服务 |
| `MemberPointsInfoServiceImpl` | 积分服务 |
| `PileStationInfoServiceImpl` | 站点服务 |
| `PileBasicInfoServiceImpl` | 充电桩服务 |
| `PileConnectorInfoServiceImpl` | 充电枪服务 |
| `PileBillingTemplateServiceImpl` | 计费模板服务 |
| `WechatPayServiceImpl` | 微信支付服务 |
| `AdapayService` | 汇付支付服务 |

---

## 对外接口

### RPC 服务

```java
// WccServiceImpl.java - Dubbo RPC 服务
@DubboService
public class WccServiceImpl implements WccService {
    // 提供给其他服务调用的接口
}
```

### RabbitMQ 消费者

```java
// OrderRabbitListener.java
@RabbitListener(queues = RabbitConstants.ORDER_QUEUE)
public void handleOrderMessage(Message message) {
    // 处理订单消息
}
```

---

## 关键依赖与配置

### Maven 依赖

```xml
<dependencies>
    <dependency>
        <groupId>com.jsowell</groupId>
        <artifactId>jsowell-framework</artifactId>
    </dependency>
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.4.0</version>
    </dependency>
    <dependency>
        <groupId>com.huifu.adapay</groupId>
        <artifactId>adapay-java-sdk</artifactId>
    </dependency>
    <dependency>
        <groupId>com.alipay.sdk</groupId>
        <artifactId>alipay-sdk-java</artifactId>
    </dependency>
</dependencies>
```

---

## 数据模型

### 核心实体

| 实体类 | 数据库表 | 说明 |
|--------|---------|------|
| `OrderBasicInfo` | `order_basic_info` | 充电订单 |
| `OrderPayRecord` | `order_pay_record` | 支付记录 |
| `OrderSplitRecord` | `order_split_record` | 分账记录 |
| `MemberBasicInfo` | `member_basic_info` | 会员信息 |
| `MemberWalletInfo` | `member_wallet_info` | 会员钱包 |
| `MemberPointsInfo` | `member_points_info` | 会员积分 |
| `PileStationInfo` | `pile_station_info` | 充电站 |
| `PileBasicInfo` | `pile_basic_info` | 充电桩 |
| `PileConnectorInfo` | `pile_connector_info` | 充电枪 |
| `PileBillingTemplate` | `pile_billing_template` | 计费模板 |
| `PileMerchantInfo` | `pile_merchant_info` | 商户信息 |
| `ClearingBillInfo` | `clearing_bill_info` | 清算账单 |

### Mapper XML 文件

位置：`src/main/resources/mapper/pile/`

主要文件：
- `OrderBasicInfoMapper.xml` (3620 行)
- `PileMerchantInfoMapper.xml` (1304 行)
- `PersonalChargingRecordMapper.xml` (1413 行)
- `OrderDetailMapper.xml` (1306 行)
- `OrderPileOccupyMapper.xml` (1043 行)

---

## 测试与质量

### 单元测试

测试位于 `jsowell-admin/src/test/java/`，涉及本模块的测试：
- `OrderServiceWhitelistCompletionTest`
- `WhitelistOrderCompletionDefaultsTest`

---

## 常见问题 (FAQ)

### Q: 订单分账失败如何处理？
检查 `OrderBasicInfoServiceImpl.realTimeOrderSplit()` 方法，查看分账配置和汇付账户状态

### Q: 积分发放延迟？
积分通过 RabbitMQ 异步发放，检查 `PointsRabbitConfig` 配置和消息队列状态

### Q: 支付回调未收到？
检查支付平台回调地址配置，查看 `WxpayCallbackRecord` 或 `AdapayCallbackRecord` 表

---

## 相关文件清单

```
jsowell-pile/
├── src/main/java/com/jsowell/
│   ├── adapay/                    # 汇付支付
│   │   ├── config/               # 支付配置
│   │   ├── dto/                  # 数据传输对象
│   │   ├── service/              # 支付服务
│   │   └── vo/                   # 视图对象
│   ├── alipay/                   # 支付宝
│   ├── wxpay/                    # 微信支付
│   ├── mq/                       # RabbitMQ 消费者
│   ├── pile/
│   │   ├── domain/               # 实体类
│   │   ├── dto/                  # DTO
│   │   ├── mapper/               # Mapper 接口
│   │   ├── service/              # Service 接口
│   │   │   └── impl/            # Service 实现
│   │   ├── vo/                   # VO
│   │   ├── jcpp/                 # JCPP 协议
│   │   ├── rpc/                  # RPC 服务
│   │   └── transaction/          # 事务服务
│   └── thirdparty/               # 第三方服务
├── src/main/resources/
│   └── mapper/pile/              # Mapper XML (60+ 文件)
└── src/main/proto/               # Protobuf 定义
```