{
  "assignee_id": "d1e4fe91-fb56-4c47-95d0-818d5f22b5bd",
  "assignee_type": "agent",
  "created_at": "2026-05-21T15:42:15Z",
  "creator_id": "d1e4fe91-fb56-4c47-95d0-818d5f22b5bd",
  "creator_type": "agent",
  "description": "## 任务描述\n更新项目文档，记录包裹管理功能的 API 端点和技术规格。\n\n## 需要更新的文档\n\n### 1. API 文档（`docs/api-documentation.md`）\n新增以下 API 端点：\n\n**合伙人端点：**\n- `POST /api/v1/partner/parcels/{parcel_id}/ship` - 合伙人发货\n\n**管理员端点：**\n- `GET /api/v1/admin/parcels/{parcel_id}/details` - 获取包裹详情\n- `POST /api/v1/admin/parcels/{parcel_id}/quote` - 管理员报价\n- `POST /api/v1/admin/parcels/{parcel_id}/ship` - 管理员发货\n\n每个端点需要包含：\n- 请求方法和路径\n- 权限要求\n- 请求参数/请求体\n- 响应格式\n- 错误码说明\n- 示例\n\n### 2. 技术规格（`docs/SPECIFICATION.md`）\n更新以下章节：\n\n**包裹管理流程：**\n- 完整的包裹生命周期图\n- 各状态的触发条件和操作者\n- 滞留费计算规则\n\n**数据模型：**\n- Parcel 模型字段说明\n- OrderItem 与 Parcel 的关联关系\n\n### 3. 项目手册（`CLAUDE.md`）\n在\"项目特定实现注意事项\"章节添加：\n\n**包裹管理注意事项：**\n- 滞留费按商品计算，报价时自动汇总\n- 区分 `internal_tracking_no`（不显示给客户）和 `international_tracking_no`（显示给客户）\n- 包裹状态转换规则\n- 常见问题和解决方案\n\n### 4. 数据模型文档（`docs/DATA_MODEL.md`）\n更新 Parcel 相关章节：\n- 字段说明\n- 状态枚举\n- 与其他表的关系\n\n## 完成标准\n- [ ] API 文档更新完成，所有新端点都有详细说明\n- [ ] 技术规格更新完成，包裹流程清晰\n- [ ] CLAUDE.md 更新完成，注意事项明确\n- [ ] DATA_MODEL.md 更新完成\n- [ ] 所有文档格式统一，无错别字\n- [ ] 代码示例正确且可运行\n\n## 参考\n- 设计文档：`docs/PARCEL_MANAGEMENT_DESIGN.md`（已创建）\n- 现有 API 文档格式",
  "due_date": null,
  "id": "d3562ddb-66fd-45c8-978f-3f7eed6010ad",
  "identifier": "FET-30",
  "metadata": {},
  "number": 30,
  "parent_issue_id": "857e476e-26f8-4097-8da0-4100f121cb5c",
  "position": 0,
  "priority": "medium",
  "project_id": null,
  "start_date": null,
  "status": "todo",
  "title": "[文档] 更新 API 文档和技术规格",
  "updated_at": "2026-05-22T04:07:05Z",
  "workspace_id": "b5fdce19-2a82-455d-b644-5b83da2b3078"
}