docs: 重构并删除docs11目录,更新项目文档结构
删除旧的docs11目录及其所有内容,包括: - 业务蓝图文档(business-blueprint.md) - 数据API规范(data-api-specs.md) - 系统架构文档(system-architecture.md) - 模块蓝图文档(module-blueprints.md) - 治理标准文档(governance-standards.md) - 质量标准文档(quality-optimization.md) - 任务总览文档(Crawlful_Hub_Task_Overview_Full_v1.md) - README.md等文件 同时更新了docs目录下的现有文档: - 更新SERVICE_MAP.md强化服务层职责和调用规范 - 更新Service_Design.md明确服务层设计规范和边界 - 更新项目规则文档加入逻辑集中化原则 - 统一调整了文档表格格式和结构
This commit is contained in:
@@ -8,13 +8,23 @@
|
||||
|
||||
## 1. 服务层架构
|
||||
|
||||
### 1.1 核心原则
|
||||
### 1.1 核心原则(逻辑集中化)
|
||||
|
||||
- **每个业务操作对应一个 Service**:前端的每个用户操作都必须有对应的后端 Service 处理
|
||||
- **服务编排**:通过 Service 层串联多个模块,实现业务流程的完整执行
|
||||
- **单一职责**:每个 Service 只负责一个核心业务领域
|
||||
- **依赖注入**:通过依赖注入实现服务间的解耦
|
||||
- **事务管理**:重要操作必须在事务中执行,确保数据一致性
|
||||
> **逻辑集中化 → 服务驱动**:所有业务逻辑必须集中在 Service 层,禁止分散在 Controller、前端或数据库操作中。
|
||||
|
||||
#### 强制约束
|
||||
- ✅ **每个业务操作对应一个 Service**:前端的每个用户操作都必须有对应的后端 Service 处理
|
||||
- ✅ **服务编排**:通过 Service 层串联多个模块,实现业务流程的完整执行
|
||||
- ✅ **单一职责**:每个 Service 只负责一个核心业务领域
|
||||
- ✅ **依赖注入**:通过依赖注入实现服务间的解耦
|
||||
- ✅ **事务管理**:重要操作必须在事务中执行,确保数据一致性
|
||||
- ✅ **状态管理统一**:所有状态更新必须通过 Service 层,禁止在 Controller 或前端直接修改
|
||||
|
||||
#### 禁止行为
|
||||
- ❌ **Controller 中写业务逻辑**:Controller 只负责请求/响应和权限校验,业务决策、状态变化、数据校验必须在 Service 层
|
||||
- ❌ **前端直接写业务规则**:复杂计算、权限判断、状态流转禁止在 React 组件中实现
|
||||
- ❌ **数据库操作分散**:不同模块禁止直接调用数据库,必须通过 Service 层
|
||||
- ❌ **脚本或工具处理逻辑**:AI 任务或异步脚本必须通过 Service 层统一调用
|
||||
|
||||
### 1.2 服务层级结构
|
||||
|
||||
@@ -22,6 +32,26 @@
|
||||
Controller → Service (核心编排) → Repository / External API → 数据库/外部系统
|
||||
```
|
||||
|
||||
#### Controller 层职责(强制执行)
|
||||
- 接收 HTTP 请求和参数验证
|
||||
- 调用 Service 层处理业务逻辑
|
||||
- 返回响应给前端
|
||||
- 权限校验(通过 `authorize()` 中间件)
|
||||
- **禁止**:业务决策、状态变化、数据校验
|
||||
|
||||
#### Service 层职责(核心)
|
||||
- 业务逻辑编排和状态流转
|
||||
- 多模块协同和数据一致性保证
|
||||
- 事务管理和异常处理
|
||||
- 调用 Repository 层或外部 API
|
||||
- **必须**:所有业务逻辑必须在此层实现
|
||||
|
||||
#### Repository 层职责
|
||||
- 数据库 CRUD 操作
|
||||
- 数据模型映射
|
||||
- 查询优化
|
||||
- **禁止**:业务逻辑处理
|
||||
|
||||
---
|
||||
|
||||
## 2. 核心服务列表
|
||||
|
||||
Reference in New Issue
Block a user