11-entity-creation.md 1.1 KB
新实体创建流程规范
流程概述
实体创建流程分为两种模式，根据业务复杂度选择合适的实现方式：
- 标准通用CRUD：适用于简单数据模型，使用
GenericCrudService和createCrudRoutes快速生成基础CRUD接口 - 自定义复杂CRUD：适用于包含复杂业务逻辑的实体，需要手动实现服务方法和路由处理
适用场景选择
| 类型 | 适用场景 | 技术选型 |
|---|---|---|
| 标准通用CRUD | 简单数据管理、无复杂业务逻辑、基础CRUD操作 | GenericCrudService + createCrudRoutes |
| 自定义复杂CRUD | 复杂业务规则、多表关联操作、特殊权限控制、非标准数据处理 | 自定义Service + 手动路由实现 |
标准通用CRUD开发流程
自定义复杂CRUD开发流程
注意事项
- 实体Schema必须在实体文件中定义，路由中直接引用，不要重复定义
- 前端表格/表单字段必须与实体定义保持一致
- 确保所有API调用都有正确的类型推断
- 参考现有模块实现保持风格一致