refactor(services): 重构服务模块结构,按功能分类移动文件

将服务文件按功能分类移动到对应子目录,包括财务、营销、订单等模块
更新相关路由和导入路径,修复文件引用错误
归档旧版任务文档,更新README和任务统计信息
This commit is contained in:
2026-03-23 15:41:50 +08:00
parent 2b86715c09
commit e59d7c6620
156 changed files with 14658 additions and 7774 deletions

View File

@@ -8,19 +8,61 @@
| 文件 | 内容 | 说明 |
|------|------|------|
| [P0_critical.md](P0_critical.md) | P0 阻塞性任务 | 核心基础功能 |
| [P1_important.md](P1_important.md) | P1 高优先级任务 | 重要业务功能 |
| [P2_enhancement.md](P2_enhancement.md) | P2 优化类任务 | 体验优化和增强功能 |
| [completed.md](completed.md) | 已完成任务记录 | 历史任务归档 |
| [completed.md](completed.md) | 项目状态与开发指南 | 包含所有任务完成记录和项目状态 |
| [code_mapping.md](code_mapping.md) | 任务与代码实现映射 | 建立任务与代码的映射关系 |
| [P3_development.md](P3_development.md) | P3 待开发任务 | 包含所有待开发的功能任务 |
## 归档任务
| 文件 | 内容 | 说明 |
|------|------|------|
| [P0_critical.md](ARCHIVE/P0_critical.md) | P0 阻塞性任务 | 核心基础功能(已完成) |
| [P1_important.md](ARCHIVE/P1_important.md) | P1 高优先级任务 | 重要业务功能(已完成) |
| [P2_enhancement.md](ARCHIVE/P2_enhancement.md) | P2 优化类任务 | 体验优化和增强功能(已完成) |
---
## 📋 任务状态定义
| 状态 | 说明 | 转换条件 |
|------|------|----------|
| `pending` | 待领取,未开始 | 初始状态 |
| `in_progress` | 已领取,进行中 | 领取任务时设置 |
| `completed` | 已完成 | 验收标准全部通过 |
| `blocked` | 阻塞中 | 有未解决的依赖或阻塞问题 |
## 📋 领取规则
### 领取任务时(必须执行)
1. **优先领取任务包**: 必须优先领取同一闭环的完整任务链
2. **最小粒度**: 单次领取不少于 5 个相关任务
3. **声明占用**: 领取时在具体任务文档中更新占用状态
4. **完成后释放**: 任务完成后及时更新状态
2. **最小粒度**: 单次领取不少于 3 个相关任务
3. **更新占用状态表**: 在具体任务文档顶部添加
```markdown
| Agent | 占用模块 | 涉及任务 | 主要文件 | 开始时间 | 状态 |
|-------|----------|----------|----------|----------|------|
| AI-X | 模块名 | 任务ID | 文件路径 | YYYY-MM-DD HH:MM | 🔒 进行中 |
```
4. **更新任务状态**: 将每个领取的任务详情中的状态改为 `in_progress`
```markdown
| **状态** | in_progress |
```
### 完成任务时(必须执行)
1. **更新任务详情**: 将任务状态改为 `completed`
```markdown
| **状态** | completed |
```
2. **勾选验收标准**: 将所有 `- [ ]` 改为 `- [x]`
3. **更新占用状态表**: 将状态从 "🔒 进行中" 改为 "✅ 已完成" 或删除该行
4. **添加完成记录**: 在 [completed.md](completed.md) 中添加完成记录
### ⚠️ 重要提醒
- **禁止**: 只更新占用表而不更新任务状态
- **禁止**: 任务状态与实际进度不符
- **必须**: 保持占用表、任务状态、验收标准三者一致
---
@@ -59,6 +101,80 @@
---
## 🔍 代码审查机制
### 审查流程
1. **任务启动前审查**
- 检查是否与现有代码重复
- 确认服务层功能边界
- 验证是否需要创建新文件
- **确认服务文件分类位置**: 根据功能确定服务文件的分类目录
2. **开发过程审查**
- 确保代码符合项目规范
- 检查服务层功能单一性
- 验证错误处理和异常管理
- **检查导入路径**: 确保服务移动后导入路径正确
3. **任务完成后审查**
- 验证功能实现完整性
- 检查代码质量和性能
- 确认测试覆盖率
- **更新服务映射**: 确保任务与代码实现的映射关系正确
### 审查重点
| 审查项 | 说明 | 标准 |
|--------|------|------|
| 服务层重复 | 检查是否与现有服务功能重叠 | 功能边界清晰,无重复实现 |
| 服务分类 | 检查服务文件是否放在正确的分类目录 | 按功能分类,目录结构清晰 |
| 代码质量 | 检查代码风格和结构 | 符合项目编码规范 |
| 安全性 | 检查安全漏洞和风险 | 无安全隐患 |
| 性能 | 检查性能优化点 | 响应时间合理 |
| 文档 | 检查注释和文档 | 文档完整清晰 |
### 审查标准
- **服务文件**: 功能单一,职责明确,放在正确的分类目录
- **代码风格**: 一致的命名和缩进
- **错误处理**: 完整的异常捕获和处理
- **测试覆盖**: 核心功能有测试用例
- **文档完整性**: 服务类有JSDoc注释
---
## 🚫 常见问题与预防措施
### 任务管理问题
| 问题 | 症状 | 预防措施 |
|------|------|----------|
| 任务与代码重复 | 功能重叠,维护困难 | 任务启动前审查,检查现有代码 |
| 服务文件位置错误 | 目录结构混乱 | 遵循服务文件分类规范,确认分类位置 |
| 导入路径错误 | 编译失败 | 移动服务后更新所有引用路径 |
| 任务状态不一致 | 进度跟踪困难 | 严格按照领取和完成规则更新状态 |
| 代码质量差 | 可读性差bug多 | 遵循代码审查机制,确保代码质量 |
### 服务开发最佳实践
1. **服务文件管理**
- 按功能分类到对应目录
- 保持服务功能单一,职责明确
- 定期清理冗余服务文件
2. **代码质量保证**
- 遵循编码规范和命名约定
- 实现完整的错误处理和异常管理
- 为核心功能编写测试用例
3. **文档维护**
- 服务类添加完整的JSDoc注释
- 及时更新任务与代码的映射关系
- 维护服务文件分类和目录结构
---
## 🔗 相关文档
- [规则中心](../RULES/_index.md)