# 开发管理 - 产品需求文档

> **版本**: v1.0  
> **状态**: Draft  
> **创建日期**: 2026-01-20  
> **最后更新**: 2026-01-20  
> **产品经理**: 待定

---

## ✅ 机器读取区（必填）

### 通用字段

| 字段 | 内容 |
|------|------|
| 模块 | 开发管理（devtracker） |
| 文档类型 | PRD |
| 目标 | 建立统一的研发工作项台账（DevItem），覆盖需求提出、评审、开发、测试与完成，支持模块/子任务/Bug 拆解 |
| 范围 | In Scope / Out of Scope |
| 核心规则 | 统一实体 DevItem；单一状态机覆盖提出/评审/开发/测试/完成/取消；FEATURE/BUG 必须归属 MODULE；权限与审计必做 |
| 验收标准 | 支持创建/评审/流转 DevItem；支持层级拆解与负责人分配；状态机校验生效；权限拦截与审计日志可追溯 |
| 关联文档 | `05-ui-interaction-spec.md` / `07-api.md` |

### 功能清单（最小）

| 功能 | 优先级 | 说明 |
|------|--------|------|
| 工作项管理 | P0 | 创建、评审与流转 DevItem（含模块/子任务/Bug） |
| 层级拆解 | P0 | MODULE → FEATURE/BUG 的父子关系 |
| 状态流转 | P0 | 单一状态机覆盖提出/评审/开发/测试/完成/取消 |
| 可读编号 | P0 | 自动生成可读编号（DT-YYYY-MODULE-TYPE-SEQ） |
| 权限控制 | P0 | 开发人员可使用，管理员可全量管理 |
| 审计日志 | P0 | 关键操作写入审计系统 |
| 甘特图视图 | P1 | 以 DevItem 为粒度展示计划与进度 |
| 过滤与检索 | P1 | 按类型/状态/负责人/优先级过滤 |
| 更新记录 | P1 | 记录版本更新说明，支持仅展示与有权限新增 |

---

## 🧭 人类阅读区（可选）

### 背景

当前系统缺少统一的研发任务台账，无法持续记录模块任务、子任务与 Bug 修复。本模块用于构建内置的研发任务管理能力，便于团队在系统内闭环记录与复盘。

### 目标用户

| 角色 | 描述 | 使用场景 |
|------|------|---------|
| 开发工程师 | 本项目研发人员 | 记录任务、流转状态、标记测试结果 |
| 技术负责人 | 负责模块拆解与进度跟踪 | 创建模块任务与拆解子任务 |
| 管理员 | 系统权限与审计管理 | 任务全局维护与审计追踪 |

### 详细需求（可选）

- DevItem 先评审后进入开发，评审通过使用 `REVIEWED` 状态。
- DevItem 包含负责人、创建人、评审人，评审动作记录评审人和时间。
- DevItem 类型通过 `itemType` 区分 MODULE/FEATURE/BUG。
- FEATURE/BUG 必须归属某个 MODULE（`parentId` 指向 MODULE）。
- DevItem 单一状态机包含提出/评审/开发/测试/完成/取消。
- 关键操作（创建/更新/状态变更/删除）必须产生日志。
- 仅开发相关角色可见，管理员具备全量维护权限。