# 开发管理 - 错误码文档

> **版本**: v1.0  
> **最后更新**: 2026-01-20  
> **维护者**: 后端团队

---

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

### 错误码清单（最小）

| 错误码 | HTTP | 说明 | 处理建议 |
|--------|------|------|----------|
| DEVTRACKER_ITEM_NOT_FOUND | 404 | 工作项不存在 | 刷新列表或检查 ID |
| DEVTRACKER_ITEM_PERMISSION_DENIED | 403 | 无权限操作工作项 | 校验角色与负责人 |
| DEVTRACKER_ITEM_STATUS_INVALID | 409 | 工作项状态流转不合法 | 按状态机重新操作 |
| DEVTRACKER_ITEM_VALIDATION_FAILED | 422 | 参数校验失败 | 检查必填字段 |
| DEVTRACKER_ITEM_PARENT_INVALID | 400 | 父级工作项不合法 | FEATURE/BUG 仅允许挂在 MODULE |
| DEVTRACKER_RELEASE_NOTE_NOT_FOUND | 404 | 更新记录不存在 | 刷新列表或检查 ID |
| DEVTRACKER_RELEASE_NOTE_PERMISSION_DENIED | 403 | 无权限操作更新记录 | 校验角色权限 |
| DEVTRACKER_RELEASE_NOTE_VALIDATION_FAILED | 422 | 更新记录参数校验失败 | 检查必填字段 |
| DEVTRACKER_RELEASE_NOTE_CONFLICT | 409 | 更新记录版本冲突 | 版本号需唯一 |

---

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

### 分类说明

- 验证错误 / 权限错误 / 资源错误 / 冲突错误

### 示例响应

```json
{
  "code": "DEVTRACKER_ITEM_NOT_FOUND",
  "message": "devtracker.errors.item_not_found",
  "details": {}
}
```