refactor(types): 重构类型系统,统一共享类型定义
feat(types): 新增共享类型中心,包含用户、产品、订单等核心领域类型 fix(types): 修复类型定义错误,统一各模块类型引用 style(types): 优化类型文件格式和注释 docs(types): 更新类型文档和变更日志 test(types): 添加类型测试用例 build(types): 配置类型共享路径 chore(types): 清理重复类型定义文件
This commit is contained in:
@@ -144,54 +144,45 @@
|
||||
|
||||
## 逻辑集中化强制规则
|
||||
|
||||
> **详细规范**: 详见 [项目规则 - 第8章](../../.trae/rules/project-specific-rules.md#8-逻辑集中化原则硬性约束)
|
||||
|
||||
### 核心原则
|
||||
> **所有业务逻辑必须集中在 Service 层,禁止分散在 Controller、前端或数据库操作中。**
|
||||
- 所有业务逻辑必须集中在 Service 层
|
||||
- 禁止分散在 Controller、前端或数据库操作中
|
||||
|
||||
### AI开发强制规则
|
||||
### AI开发强制规则(摘要)
|
||||
|
||||
1. **禁止在 Controller 中实现业务逻辑**
|
||||
- Controller 只负责请求/响应和权限校验
|
||||
- 业务决策、状态变化、数据校验必须在 Service 层
|
||||
|
||||
2. **禁止在前端实现业务规则**
|
||||
- 前端只负责展示、交互和调用接口
|
||||
- 禁止在前端进行业务计算、状态判断和权限判断
|
||||
|
||||
3. **禁止直接操作数据库**
|
||||
- 所有数据库操作必须通过 Repository 层
|
||||
- AI 不允许直接使用数据库连接或 ORM 操作数据库
|
||||
|
||||
4. **所有业务逻辑必须封装在 Service 层**
|
||||
- 每个业务操作必须对应一个 Service 方法
|
||||
- Service 方法必须体现业务闭环
|
||||
|
||||
5. **所有状态变更必须通过 Service 方法**
|
||||
- 禁止直接修改状态字段
|
||||
- 状态变更必须通过 Service 方法并遵循状态机
|
||||
|
||||
6. **所有跨模块操作必须在 Service 中完成**
|
||||
- 跨模块协同必须在 Service 层实现
|
||||
- 禁止在 Controller 或前端进行跨模块调用
|
||||
|
||||
7. **AI 修改代码时的优先顺序**
|
||||
- 优先修改 Service 层代码
|
||||
- 其次修改 Repository 层代码
|
||||
- 最后修改 Controller 或前端代码
|
||||
|
||||
8. **Service 方法命名规范**
|
||||
- 方法名必须体现业务闭环
|
||||
- 例如:`createOrderWithInventoryLock()` 而不是 `createOrder()`
|
||||
|
||||
9. **状态机遵循**
|
||||
- 所有状态变更必须遵循 STATE_MACHINE 定义
|
||||
- 禁止非法状态流转
|
||||
|
||||
10. **服务层职责边界**
|
||||
- Controller:请求/响应 + 权限校验
|
||||
- Service:业务逻辑编排 + 状态流转 + 多模块协同
|
||||
- Repository:数据库 CRUD 操作
|
||||
1. **禁止在 Controller 中实现业务逻辑** - Controller 只负责请求/响应和权限校验
|
||||
2. **禁止在前端实现业务规则** - 前端只负责展示、交互和调用接口
|
||||
3. **禁止直接操作数据库** - 所有数据库操作必须通过 Repository 层
|
||||
4. **所有业务逻辑必须封装在 Service 层** - 每个业务操作必须对应一个 Service 方法
|
||||
5. **所有状态变更必须通过 Service 方法** - 禁止直接修改状态字段
|
||||
|
||||
### 违反后果
|
||||
- **代码审查不通过**:任何违反逻辑集中化原则的代码将被拒绝合并
|
||||
- **AI 任务失败**:AI 无法维护分散的逻辑,导致任务执行失败
|
||||
- **生产环境风险**:分散逻辑导致数据不一致,直接影响系统稳定性
|
||||
- **生产环境风险**:分散逻辑导致数据不一致,直接影响系统稳定性
|
||||
|
||||
---
|
||||
|
||||
## Mock 数据规范
|
||||
|
||||
> **详细规范**: 详见 [项目规则 - 第11章](../../.trae/rules/project-specific-rules.md#11-mock数据规范ai上下文安全)
|
||||
|
||||
### 核心原则
|
||||
- **禁止**: 在业务组件中硬编码 Mock 数据
|
||||
- **必须**: 通过 DataSource 抽象层获取数据
|
||||
- **必须**: 所有 Mock 文件放在 `/mock` 目录
|
||||
|
||||
---
|
||||
|
||||
## TypeScript 编译错误修复
|
||||
|
||||
> **详细方案**: 详见 [TypeScript 错误修复方案](07_TypeScript_Error_Fix_Guide.md)
|
||||
|
||||
当前存在 613 个编译错误,必须按照分阶段策略修复:
|
||||
1. **阶段 1**: 修复 tsconfig.json 配置
|
||||
2. **阶段 2**: 消除所有 any 类型
|
||||
3. **阶段 3**: 修复类型不匹配
|
||||
4. **阶段 4**: 统一模块导入导出
|
||||
5. **阶段 5**: 正确处理 undefined 和 null
|
||||
Reference in New Issue
Block a user