## 任务描述 更新项目文档,记录包裹管理功能的 API 端点和技术规格。 ## 需要更新的文档 ### 1. API 文档(`docs/api-documentation.md`) 新增以下 API 端点: **合伙人端点:** - `POST /api/v1/partner/parcels/{parcel_id}/ship` - 合伙人发货 **管理员端点:** - `GET /api/v1/admin/parcels/{parcel_id}/details` - 获取包裹详情 - `POST /api/v1/admin/parcels/{parcel_id}/quote` - 管理员报价 - `POST /api/v1/admin/parcels/{parcel_id}/ship` - 管理员发货 每个端点需要包含: - 请求方法和路径 - 权限要求 - 请求参数/请求体 - 响应格式 - 错误码说明 - 示例 ### 2. 技术规格(`docs/SPECIFICATION.md`) 更新以下章节: **包裹管理流程:** - 完整的包裹生命周期图 - 各状态的触发条件和操作者 - 滞留费计算规则 **数据模型:** - Parcel 模型字段说明 - OrderItem 与 Parcel 的关联关系 ### 3. 项目手册(`CLAUDE.md`) 在"项目特定实现注意事项"章节添加: **包裹管理注意事项:** - 滞留费按商品计算,报价时自动汇总 - 区分 `internal_tracking_no`(不显示给客户)和 `international_tracking_no`(显示给客户) - 包裹状态转换规则 - 常见问题和解决方案 ### 4. 数据模型文档(`docs/DATA_MODEL.md`) 更新 Parcel 相关章节: - 字段说明 - 状态枚举 - 与其他表的关系 ## 完成标准 - [ ] API 文档更新完成,所有新端点都有详细说明 - [ ] 技术规格更新完成,包裹流程清晰 - [ ] CLAUDE.md 更新完成,注意事项明确 - [ ] DATA_MODEL.md 更新完成 - [ ] 所有文档格式统一,无错别字 - [ ] 代码示例正确且可运行 ## 参考 - 设计文档:`docs/PARCEL_MANAGEMENT_DESIGN.md`(已创建) - 现有 API 文档格式