makemd/docs/00_Business/TASKS_IMPROVEMENT_PLAN.md

Tasks 目录改进计划

审查日期: 2026-03-20
审查范围: docs/00_Business/tasks 目录（51个任务文档）
审查标准: 术语一致性、格式规范性、内容完整性、依赖关系准确性

---

一、问题汇总

1.1 术语不一致问题 🔴 P0

问题类型	涉及文件	具体问题	影响
B2B/B2C vs TOB/TOC	BE-TOB001003, AI-TOB001003	使用 B2B / TOB 混用	术语混乱
merchant_id vs tenantId	多个文档	字段命名不一致	代码实现困惑
Admin vs ADMIN	21_customer_service.md, 15_auth.md	角色命名大小写不一致	权限系统混乱

1.2 任务ID格式不一致 🟡 P1

问题类型	示例	标准格式	影响
核心服务任务ID重复	BE-CS001 (核心服务) vs BE-CS001 (客户服务)	BE-CORE-XXX	任务追踪混乱
文档任务ID格式	BE-DOC001	BE-DOC-XXX	格式不统一

1.3 文档格式不一致 🟡 P1

问题类型	涉及文件	具体问题	影响
缺少"完成时间"列	04_finance.md, 05_inventory.md 等	表格列不完整	信息不完整
缺少数据库表结构	大部分backend任务	无表结构定义	开发困难
缺少API端点定义	大部分backend任务	无API定义	开发困难
依赖关系描述不统一	所有文档	文字/箭头/代码块混用	可读性差

1.4 内容完整性问题 🟡 P1

问题类型	涉及文件	具体问题	影响
缺少验收标准	所有任务	无明确的验收标准	质量控制困难
缺少测试要求	所有任务	无测试用例要求	质量保障不足
缺少风险提示	所有任务	无风险识别	项目风险高

1.5 状态标记问题 🟢 P2

问题类型	涉及文件	具体问题	影响
所有任务标记为completed	所有任务	实际可能未完成	进度追踪不准确

---

二、改进任务表

P0 - 立即修复（阻塞问题）

任务ID	问题描述	涉及文件	改进方向	预计耗时
IMP-P0-001	统一 B2B/B2C 为 TOB/TOC	BE-TOB001003, AI-TOB001003	全局替换术语	1h
IMP-P0-002	统一 merchant_id 为 tenantId	所有backend任务	全局替换字段名	2h
IMP-P0-003	统一角色命名（Admin → ADMIN）	21_customer_service.md, 15_auth.md	统一为大写	0.5h
IMP-P0-004	修复核心服务任务ID冲突	20_core_service.md, 21_customer_service.md	重命名 BE-CS001~004 为 BE-CORE-XXX	0.5h

P1 - 短期改进（重要问题）

任务ID	问题描述	涉及文件	改进方向	预计耗时
IMP-P1-001	统一文档表格格式（添加完成时间列）	04_finance.md, 05_inventory.md 等20个文件	补充缺失列	2h
IMP-P1-002	统一依赖关系描述格式	所有任务文档	统一使用箭头图示	3h
IMP-P1-003	为所有任务添加验收标准	所有任务文档	添加验收标准章节	8h
IMP-P1-004	为所有任务添加测试要求	所有任务文档	添加测试要求章节	6h
IMP-P1-005	为P0/P1任务添加风险提示	所有P0/P1任务	添加风险提示章节	4h
IMP-P1-006	为backend任务添加数据库表结构	所有backend任务	添加表结构定义	12h
IMP-P1-007	为backend任务添加API端点定义	所有backend任务	添加API端点章节	10h

P2 - 中期优化（改进问题）

任务ID	问题描述	涉及文件	改进方向	预计耗时
IMP-P2-001	修正任务状态标记	所有任务文档	根据实际情况更新状态	4h
IMP-P2-002	为所有任务添加性能要求	所有任务文档	添加性能指标	6h
IMP-P2-003	为所有任务添加安全要求	所有任务文档	添加安全检查项	4h
IMP-P2-004	创建任务文档模板	docs/00_Business/tasks/	创建标准模板	2h

---

三、改进实施计划

3.1 第一阶段：P0问题修复（1天）

Day 1 上午:
├─ IMP-P0-001: 统一 B2B/B2C 为 TOB/TOC (1h)
├─ IMP-P0-002: 统一 merchant_id 为 tenantId (2h)
├─ IMP-P0-003: 统一角色命名 (0.5h)
└─ IMP-P0-004: 修复任务ID冲突 (0.5h)

Day 1 下午:
├─ 验证所有P0修复
└─ 更新相关文档索引

3.2 第二阶段：P1问题改进（3天）

Day 2:
├─ IMP-P1-001: 统一文档表格格式 (2h)
├─ IMP-P1-002: 统一依赖关系描述 (3h)
└─ 开始 IMP-P1-006: 添加数据库表结构 (4h)

Day 3:
├─ 完成 IMP-P1-006: 添加数据库表结构 (8h)
└─ 开始 IMP-P1-007: 添加API端点定义 (4h)

Day 4:
├─ 完成 IMP-P1-007: 添加API端点定义 (6h)
├─ IMP-P1-003: 添加验收标准 (4h)
├─ IMP-P1-004: 添加测试要求 (4h)
└─ IMP-P1-005: 添加风险提示 (4h)

3.3 第三阶段：P2问题优化（2天）

Day 5:
├─ IMP-P2-001: 修正任务状态标记 (4h)
├─ IMP-P2-002: 添加性能要求 (4h)
└─ IMP-P2-003: 添加安全要求 (4h)

Day 6:
├─ IMP-P2-004: 创建任务文档模板 (2h)
└─ 验证所有改进完成

---

四、改进标准

4.1 术语标准

旧术语	新术语	适用范围
B2B	TOB	所有文档、代码、数据库
B2C	TOC	所有文档、代码、数据库
merchant_id	tenantId	所有代码、API、数据库
Admin	ADMIN	角色定义
Manager	MANAGER	角色定义
Operator	OPERATOR	角色定义

4.2 任务ID格式标准

模块	前缀	示例
Backend	BE-XXX	BE-P001, BE-O001
Frontend	FE-XXX	FE-P001, FE-O001
Plugin	PL-XXX	PL-C001, PL-A001
AI	AI-XXX	AI-D001, AI-TOB001
Document	BE-DOC-XXX	BE-DOC001
Core Service	BE-CORE-XXX	BE-CORE001
Customer Service	BE-CS-XXX	BE-CS001

4.3 文档格式标准

标准表格列

列名	是否必填	说明
Task ID	✅	任务唯一标识
闭环关联	✅	关闭的业务闭环
任务描述	✅	任务简要描述
输入	✅	任务输入参数
输出	✅	任务输出结果
触发条件	✅	任务触发条件
状态	✅	任务当前状态
优先级	✅	P0/P1/P2/P3
依赖	✅	依赖的任务ID
预计耗时	✅	预计完成时间
负责人	✅	负责人/团队
完成时间	✅	实际完成时间

标准章节结构

# [模块名称]任务

## 任务列表
[任务表格]

## 相关闭环
[相关闭环列表]

## 依赖关系
[依赖关系描述，统一使用箭头图示]

## 数据库表结构
[表结构定义，backend任务必填]

## API端点
[API端点定义，backend任务必填]

## 验收标准
[验收标准列表]

## 测试要求
[测试用例要求]

## 风险提示
[风险识别和应对措施]

---

五、改进验收标准

5.1 P0改进验收

• 所有文档中的 B2B/B2C 已替换为 TOB/TOC
• 所有文档中的 merchant_id 已替换为 tenantId
• 所有角色命名统一为大写（ADMIN, MANAGER, OPERATOR）
• 核心服务任务ID冲突已解决

5.2 P1改进验收

• 所有任务文档表格格式统一
• 所有依赖关系描述统一使用箭头图示
• 所有任务包含验收标准
• 所有任务包含测试要求
• 所有P0/P1任务包含风险提示
• 所有backend任务包含数据库表结构
• 所有backend任务包含API端点定义

5.3 P2改进验收

• 所有任务状态标记准确
• 所有任务包含性能要求
• 所有任务包含安全要求
• 已创建任务文档模板

---

六、相关文档

文档	路径	说明
术语标准	../10_Documents_Global/TERMINOLOGY_STANDARDS.md	术语定义和替换规则
项目规则	../../.trae/rules/project-specific-rules.md	项目硬性约束
任务概览	../Task_Overview.md	任务总览和状态追踪

---

最后更新: 2026-03-20