## 📋 任务分配完成 已创建设计文档和 7 个子任务,覆盖包裹管理功能的完整实现。 ### 📄 设计文档 - **文件**:`docs/PARCEL_MANAGEMENT_DESIGN.md` - **内容**:完整的业务流程、技术方案、API 设计、实施计划 ### 🔧 后端任务(4个) 1. **FET-24** - 实现合伙人发货 API - 端点:`POST /api/v1/partner/parcels/{id}/ship` - 功能:填写中间物流单号 2. **FET-25** - 实现管理员报价 API(含滞留费自动计算) - 端点:`POST /api/v1/admin/parcels/{id}/quote` - 功能:输入运费,自动计算滞留费和总费用 3. **FET-26** - 实现管理员发货 API - 端点:`POST /api/v1/admin/parcels/{id}/ship` - 功能:填写国际物流单号 4. **FET-27** - 实现获取包裹详情 API - 端点:`GET /api/v1/admin/parcels/{id}/details` - 功能:返回包裹、商品、地址、滞留费等完整信息 ### 🎨 前端任务(2个) 5. **FET-28** - 合伙人发货 UI - 文件:`frontend/src/views/partner/PartnerDashboard.vue` - 功能:在包裹 Modal 中添加发货表单 6. **FET-29** - 管理员报价和发货 UI - 文件:`frontend/src/views/admin/AdminParcels.vue` - 功能:添加详情 Modal,实现报价和发货表单 ### 📚 文档任务(1个) 7. **FET-30** - 更新 API 文档和技术规格 - 更新:`docs/api-documentation.md`, `docs/SPECIFICATION.md`, `CLAUDE.md`, `docs/DATA_MODEL.md` --- ## 🎯 实施建议 ### 开发顺序 1. **先做后端**(FET-24 → FET-25 → FET-26 → FET-27) - 后端 API 是前端的依赖 - 可以并行开发,但建议按顺序测试 2. **再做前端**(FET-28, FET-29) - 依赖后端 API 完成 - 两个前端任务可以并行开发 3. **最后更新文档**(FET-30) - 在所有功能实现完成后更新 - 确保文档与实际代码一致 ### 关键依赖 - FET-28(合伙人 UI)依赖 FET-24(合伙人 API) - FET-29(管理员 UI)依赖 FET-25, FET-26, FET-27(管理员 API) - FET-30(文档)依赖所有开发任务完成 ### 测试要点 - 滞留费计算精度(使用 Decimal) - 状态转换验证(防止非法跳转) - 物流单号隐私保护(中间单号不显示给客户) - 完整的 E2E 流程测试 --- ## 📞 需要协调的事项 1. **滞留费计算规则确认** - 当前:免费 90 天,超期按月收费 - 是否需要调整? 2. **报价审批流程** - 当前:管理员直接报价,客户支付 - 是否需要增加审批环节? 3. **物流商集成** - 当前:手动填写单号 - 未来是否需要对接物流 API? 如有疑问或需要调整,请在相关 issue 中评论。