refactor(types): 重构类型系统,统一共享类型定义

feat(types): 新增共享类型中心,包含用户、产品、订单等核心领域类型
fix(types): 修复类型定义错误,统一各模块类型引用
style(types): 优化类型文件格式和注释
docs(types): 更新类型文档和变更日志
test(types): 添加类型测试用例
build(types): 配置类型共享路径
chore(types): 清理重复类型定义文件
This commit is contained in:
2026-03-20 17:53:46 +08:00
parent 989c4b13a6
commit 427becbc8f
222 changed files with 25676 additions and 6328 deletions

View File

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