## 任务描述 实现管理员发货 API,允许管理员填写国际物流单号。 ## 技术细节 - **文件位置**:`backend/app/api/routes/admin.py` - **端点**:`POST /api/v1/admin/parcels/{parcel_id}/ship` - **请求体**: ```json { "international_tracking_no": "UPS1234567890" } ``` - **响应**: ```json { "success": true, "parcel_id": "...", "status": "shipped" } ``` ## 业务逻辑 1. 验证包裹状态必须是 `shipped_waiting` 2. 验证当前用户是管理员角色 3. 更新 `international_tracking_no` 字段 4. 状态变为 `shipped` 5. 发送通知给客户(包裹已发货,提供国际单号) 6. 记录操作日志 ## 完成标准 - [ ] API 端点实现完成 - [ ] 权限验证正确 - [ ] 状态转换验证正确 - [ ] 客户通知发送成功 - [ ] 单元测试通过 - [ ] API 文档更新 ## 参考 - 设计文档:`docs/PARCEL_MANAGEMENT_DESIGN.md` 第 4.2.3 节