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