# 任务中心索引

> **入口**: [../README.md](../README.md)

---

##  任务文件

| 文件 | 内容 | 说明 |
|------|------|------|
| [completed.md](completed.md) | 项目状态与开发指南 | 包含所有任务完成记录和项目状态 |
| [code_mapping.md](code_mapping.md) | 任务与代码实现映射 | 建立任务与代码的映射关系 |
| [P3_development.md](P3_development.md) | P3 待开发任务 | 包含所有待开发的功能任务 |

## 归档任务

| 文件 | 内容 | 说明 |
|------|------|------|
| [P0_critical.md](archive/ARCHIVE/P0_critical.md) | P0 阻塞性任务 | 核心基础功能（已完成） |
| [P1_important.md](archive/ARCHIVE/P1_important.md) | P1 高优先级任务 | 重要业务功能（已完成） |
| [P2_enhancement.md](archive/ARCHIVE/P2_enhancement.md) | P2 优化类任务 | 体验优化和增强功能（已完成） |

---

## 📋 任务状态定义

| 状态 | 说明 | 转换条件 |
|------|------|----------|
| `pending` | 待领取，未开始 | 初始状态 |
| `in_progress` | 已领取，进行中 | 领取任务时设置 |
| `completed` | 已完成 | 验收标准全部通过 |
| `blocked` | 阻塞中 | 有未解决的依赖或阻塞问题 |

## 📋 领取规则

### 领取任务时（必须执行）

1. **优先领取任务包**: 必须优先领取同一闭环的完整任务链
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) 中添加完成记录

### ⚠️ 重要提醒

- **禁止**: 只更新占用表而不更新任务状态
- **禁止**: 任务状态与实际进度不符
- **必须**: 保持占用表、任务状态、验收标准三者一致

---

## 📝 维护规则

### 任务完成时必须更新

| 更新内容 | 位置 | 责任人 |
|---------|------|--------|
| 任务状态改为 `completed`，勾选验收标准 | 对应 P* 文件 | AI |
| 添加完成记录 | completed.md | AI |
| 释放占用声明 | 本文件下方 | AI |
| 更新项目统计 | README.md | Brain |

### 变更记录格式

```markdown
| 日期 | 版本 | 类型 | 变更内容 | 维护人 |
|------|------|------|---------|--------|
| 2026-03-23 | v1.0 | 初始 | 文档创建 | AI-1 |
| 2026-03-23 | v1.1 | 新增 | 添加广告API集成任务包(BE-AD001~005) | AI-1 |
```

**变更类型**: 初始 / 新增 / 修改 / 修复

### 占用声明格式

**领取时**：
```markdown
| Agent | 占用模块 | 涉及任务 | 主要文件 | 开始时间 | 状态 |
|-------|----------|----------|----------|----------|------|
| AI-1 | 订单模块 | FE-001 | OrderService.ts | 2026-03-23 10:00 | 🔒 进行中 |
```

**完成时**：删除占用行或修改状态为 `✅ 已完成`

---

## 🔍 代码审查机制

### 审查流程

1. **任务启动前审查**
   - 检查是否与现有代码重复
   - 确认服务层功能边界
   - 验证是否需要创建新文件
   - **确认服务文件分类位置**: 根据功能确定服务文件的分类目录

2. **开发过程审查**
   - 确保代码符合项目规范
   - 检查服务层功能单一性
   - 验证错误处理和异常管理
   - **检查导入路径**: 确保服务移动后导入路径正确

3. **任务完成后审查**
   - 验证功能实现完整性
   - 检查代码质量和性能
   - 确认测试覆盖率
   - **更新服务映射**: 确保任务与代码实现的映射关系正确

### 审查重点

| 审查项 | 说明 | 标准 |
|--------|------|------|
| 服务层重复 | 检查是否与现有服务功能重叠 | 功能边界清晰，无重复实现 |
| 服务分类 | 检查服务文件是否放在正确的分类目录 | 按功能分类，目录结构清晰 |
| 代码质量 | 检查代码风格和结构 | 符合项目编码规范 |
| 安全性 | 检查安全漏洞和风险 | 无安全隐患 |
| 性能 | 检查性能优化点 | 响应时间合理 |
| 文档 | 检查注释和文档 | 文档完整清晰 |

### 审查标准

- **服务文件**: 功能单一，职责明确，放在正确的分类目录
- **代码风格**: 一致的命名和缩进
- **错误处理**: 完整的异常捕获和处理
- **测试覆盖**: 核心功能有测试用例
- **文档完整性**: 服务类有JSDoc注释

---

## 🚫 常见问题与预防措施

### 任务管理问题

| 问题 | 症状 | 预防措施 |
|------|------|----------|
| 任务与代码重复 | 功能重叠，维护困难 | 任务启动前审查，检查现有代码 |
| 服务文件位置错误 | 目录结构混乱 | 遵循服务文件分类规范，确认分类位置 |
| 导入路径错误 | 编译失败 | 移动服务后更新所有引用路径 |
| 任务状态不一致 | 进度跟踪困难 | 严格按照领取和完成规则更新状态 |
| 代码质量差 | 可读性差，bug多 | 遵循代码审查机制，确保代码质量 |

### 服务开发最佳实践

1. **服务文件管理**
   - 按功能分类到对应目录
   - 保持服务功能单一，职责明确
   - 定期清理冗余服务文件

2. **代码质量保证**
   - 遵循编码规范和命名约定
   - 实现完整的错误处理和异常管理
   - 为核心功能编写测试用例

3. **文档维护**
   - 服务类添加完整的JSDoc注释
   - 及时更新任务与代码的映射关系
   - 维护服务文件分类和目录结构

---

## 🔗 相关文档

- [规则中心](../rules/_index.md)
- [架构设计](../ARCH/_index.md)
- [服务地图](../services/_index.md)

---

*查看各任务文档获取详细状态和进度信息*