# 开发管理

> **负责人**: 开发团队  
> **状态**: 📋 Planning  
> **最后更新**: 2026-01-20

---

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

### 通用字段

| 字段 | 内容 |
|------|------|
| 模块 | 开发管理（devtracker） |
| 文档类型 | Module-README |
| 目标 | 记录本系统研发工作项、模块拆解与缺陷修复，形成可追踪的研发闭环 |
| 关键入口 | 前端：`frontend/src/app/(modules)/devtracker/`；后端：`backend/src/modules/devtracker/` |
| API Base | `/api/v1/devtracker` |
| 关联文档 | `01-prd.md` / `05-ui-interaction-spec.md` / `07-api.md` |

### 文档导航（状态）

| 文档 | 状态 | 最后更新 |
|------|------|---------|
| [产品需求文档](./01-prd.md) | ✅ | 2026-01-20 |
| [用户场景](./02-user-journey.md) | ✅ | 2026-01-20 |
| [架构设计](./03-architecture.md) | ✅ | 2026-01-20 |
| [状态机](./04-state-machine.md) | ✅ | 2026-01-20 |
| [UI 交互规范](./05-ui-interaction-spec.md) | ✅ | 2026-01-20 |
| [数据模型](./06-data-model.md) | ✅ | 2026-01-20 |
| [API 文档](./07-api.md) | ✅ | 2026-01-20 |
| [错误码](./08-error-codes.md) | ✅ | 2026-01-20 |
| [测试场景](./09-test-scenarios.md) | ✅ | 2026-01-20 |
| [E2E 测试规范](./10-e2e-test-spec.md) | ✅ | 2026-01-20 |
| [变更日志](./99-changelog.md) | ✅ | 2026-01-20 |

---

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

### 模块概述

开发管理模块用于记录研发工作项（DevItem），覆盖需求提出、评审、开发、测试与完成，并提供状态流转、权限控制与审计记录。

### 代码与数据位置

- **前端**: `frontend/src/app/(modules)/devtracker/`
- **后端**: `backend/src/modules/devtracker/`
- **数据库**: `platform_devtracker.dev_items`

### 主要接口

- `GET /devtracker/items` - 工作项列表
- `GET /devtracker/items/:id` - 工作项详情
- `POST /devtracker/items` - 创建工作项
- `PUT /devtracker/items/:id` - 更新工作项
- `PATCH /devtracker/items/:id/status` - 更新工作项状态
- `DELETE /devtracker/items/:id` - 删除工作项
- `GET /devtracker/gantt` - 工作项甘特图