00efacd14c
- 创建经销商账款明细控制器，提供完整的CRUD接口 - 定义经销商账款明细服务接口和实现类 - 添加创建、查询、更新、删除经销商账款明细的数据传输对象 - 实现经销商账款明细的领域实体和网关接口 - 集成订单发货单的应收金额和调整总额字段 - 添加分页查询中发货时间范围筛选功能 - 实现经销商账款明细的数据访问对象和转换器
88 lines
2.4 KiB
Markdown
88 lines
2.4 KiB
Markdown
---
|
||
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` 目录：
|
||
|
||
```bash
|
||
# 错误示例
|
||
**/*OrderShip*.java
|
||
|
||
# 正确示例（使用路径限制）
|
||
erp-turbo-business/**/*OrderShip*.java
|
||
```
|