wurenzhi
22308fe042
- 删除无用的文件和错误日志 - 创建统一的 imports 模块集中管理依赖 - 重构组件使用新的 imports 方式 - 修复文档路径大小写问题 - 优化类型定义和接口导出 - 更新依赖版本 - 改进错误处理和API配置 - 统一组件导出方式
186 lines
6.1 KiB
Markdown
186 lines
6.1 KiB
Markdown
# 任务中心索引
|
||
|
||
> **入口**: [../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)
|
||
|
||
---
|
||
|
||
*查看各任务文档获取详细状态和进度信息* |