## 任务描述 实现获取包裹详情 API,返回包裹、商品、地址、滞留费等完整信息。 ## 技术细节 - **文件位置**:`backend/app/api/routes/admin.py` - **端点**:`GET /api/v1/admin/parcels/{parcel_id}/details` - **响应**: ```json { "parcel": { "id": "...", "parcel_number": "PKG-001", "weight_kg": 2.5, "parcel_status": "awaiting_shipment", ... }, "items": [ { "id": "...", "product_name": "商品名称", "quantity": 2, "is_sensitive": false, "warehouse_date": "2026-03-01T00:00:00Z", "storage_fee_usd": 5.00 } ], "address": { "recipient_name": "张三", "country": "United States", "city": "New York", "full_address": "..." }, "storage_fees": { "total_fee_usd": 15.00, "items_detail": [...] }, "user": { "id": "...", "username": "user123", "email": "user@example.com" } } ``` ## 业务逻辑 1. 验证当前用户是管理员角色 2. 获取包裹基本信息 3. 获取包裹中所有商品(JOIN OrderItem) 4. 获取收货地址信息 5. 调用 `StorageFeeService` 计算每个商品的滞留费 6. 获取客户信息(用户名、邮箱) 7. 组装完整响应 ## 完成标准 - [ ] API 端点实现完成 - [ ] 返回数据完整且正确 - [ ] 滞留费计算正确 - [ ] 权限验证正确 - [ ] 单元测试通过 - [ ] API 文档更新 ## 参考 - 设计文档:`docs/PARCEL_MANAGEMENT_DESIGN.md` 第 4.2.4 节 - 滞留费服务:`backend/app/services/storage_fee_service.py`