# 任务完成时间标记规约

## 1. 目的

本规约旨在统一任务完成时间的标记规范，确保所有已完成任务都有明确的完成时间，便于任务进度追踪和历史任务管理。

## 2. 适用范围

本规约适用于 `docs/00_Business/Task_Overview.md` 文件中所有任务表的完成时间标记。

## 3. 规范内容

### 3.1 表格结构

所有任务表必须包含 "完成时间" 列，表头格式如下：

```markdown
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
```

### 3.2 完成时间格式

- 已完成任务的完成时间统一格式为 `YYYY-MM-DD`
- 未完成任务的完成时间字段为空
- 历史已完成任务的完成时间统一设置为 `2026-03-20`

### 3.3 状态标记

- 已完成任务状态标记为 `✅ completed` 或 `✅ 已完成`
- 未完成任务状态标记为 `pending` 或其他未完成状态

### 3.4 操作流程

1. **添加完成时间列**：为所有任务表添加 "完成时间" 列
2. **标记已完成任务**：为所有状态为已完成的任务添加完成时间 `2026-03-20`
3. **保持未完成任务**：未完成任务的完成时间字段保持为空
4. **新增任务处理**：新添加的任务，完成后及时添加完成时间

### 3.5 示例

```markdown
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| ------- | -------- | -------- | ---- | ---- | -------- | ---- | ------ | ---- | -------- | ------ | -------- |
| FE-P001 | 商品刊登闭环 | 渲染商品列表页面 | 用户ID, 筛选条件 | 商品列表数据 | 页面加载 | ✅ completed | P1 | - | 4h | AI-Frontend-1 | 2026-03-20 |
| FE-P002 | 商品刊登闭环 | 渲染商品详情页面 | 商品ID | 商品详情数据 | 点击商品 | ✅ completed | P1 | FE-P001 | 3h | AI-Backend-9 | 2026-03-20 |
| BE-P001 | 商品刊登闭环 | 商品数据获取接口 | 商品ID | 商品数据 | API请求 | pending | P1 | - | 5h | AI-Backend-1 | |
```

## 4. 执行责任

- 任务完成后，负责人应及时更新任务状态并添加完成时间
- 定期检查任务表，确保所有已完成任务都有完成时间标记
- 新增任务时，按照本规约格式添加到任务表中

## 5. 版本控制

本规约自发布之日起生效，如有变更，将在文档中更新版本号和变更内容。

### 版本历史

| 版本 | 发布日期 | 变更内容 |
| ---- | -------- | -------- |
| 1.0 | 2026-03-20 | 初始发布 |