shenyifei 00efacd14c feat(dealer): 添加经销商账款明细管理功能

- 创建经销商账款明细控制器，提供完整的CRUD接口
- 定义经销商账款明细服务接口和实现类
- 添加创建、查询、更新、删除经销商账款明细的数据传输对象
- 实现经销商账款明细的领域实体和网关接口
- 集成订单发货单的应收金额和调整总额字段
- 添加分页查询中发货时间范围筛选功能
- 实现经销商账款明细的数据访问对象和转换器

2026-01-09 18:02:23 +08:00

2.4 KiB

Raw Permalink Blame History

paths
erp-turbo-//.java

ERPTurbo 项目规则

模块架构

ERPTurbo 项目包含两个主要模块：

erp-turbo-business - 主要业务模块（仅操作此模块）
erp-turbo-svc - 旧版服务模块（禁止操作）

重要规则

⚠️ 绝对不要修改 erp-turbo-svc 模块下的任何文件

所有代码变更都应该在 erp-turbo-business 模块中进行。

目录结构

ERPTurbo_Server/
├── erp-turbo-business/          # 主业务模块 ✅ 可操作
│   ├── erp-turbo-biz/           # 业务逻辑层
│   │   ├── src/main/java/
│   │   │   ├── domain/          # 领域层
│   │   │   ├── app/             # 应用层
│   │   │   └── infrastructure/  # 基础设施层
│   └── erp-turbo-api/           # API 定义层
│
└── erp-turbo-svc/               # 聚合服务模块自动生成 ❌ 禁止操作
    ├── erp-turbo-biz/
    └── erp-turbo-api/

文件路径规范

在进行字段添加、枚举添加等操作时，仅处理以下路径：

API 层（erp-turbo-business/erp-turbo-api）

erp-turbo-common/erp-turbo-api/src/main/java/com/xunhong/erp/turbo/api/biz/dto/
├── cmd/        # 命令对象（CreateCmd, UpdateCmd, DestroyCmd）
├── vo/         # 视图对象
├── qry/        # 查询对象
├── common/     # 通用对象
└── enums/      # 枚举类

Domain 层（erp-turbo-business/erp-turbo-biz）

erp-turbo-business/erp-turbo-biz/src/main/java/com/xunhong/erp/turbo/biz/
├── domain/     # 领域实体
└── infrastructure/
    ├── entity/ # DO 实体
    ├── mapper/ # MyBatis Mapper
    └── convert/ # 对象转换器

禁止操作的路径

❌ erp-turbo-svc/

示例

✅ 正确操作

添加字段到 OrderShip：

erp-turbo-business/erp-turbo-biz/.../entity/OrderShipDO.java
erp-turbo-business/erp-turbo-biz/.../domain/entity/OrderShip.java
erp-turbo-common/erp-turbo-api/.../vo/OrderShipVO.java

❌ 错误操作

erp-turbo-svc/erp-turbo-biz/.../entity/OrderShipDO.java ❌
erp-turbo-svc/erp-turbo-biz/.../domain/entity/OrderShip.java ❌

文件搜索策略

使用 Glob/Grep 工具时，应排除 erp-turbo-svc 目录：

# 错误示例
**/*OrderShip*.java

# 正确示例（使用路径限制）
erp-turbo-business/**/*OrderShip*.java

2.4 KiB Raw Permalink Blame History Unescape Escape