refactor: 优化代码结构并修复类型问题
- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
This commit is contained in:
106
docs/ARCHIVE/00_Business/tasks/backend/12_logistics.md
Normal file
106
docs/ARCHIVE/00_Business/tasks/backend/12_logistics.md
Normal file
@@ -0,0 +1,106 @@
|
||||
# 物流策略与渠道选择后端任务
|
||||
|
||||
## 任务列表
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
|
||||
| --------- | ----------- | ------ | ------------- | ---- | ---- | ----------- | --- | --------- | ---- | ------------ | -------- |
|
||||
| BE-LOG001 | 物流策略与渠道选择闭环 | 物流策略引擎 | 订单ID, 目的地 | 物流方案 | 订单创建 | ✅ completed | P1 | - | 14h | AI-Backend-8 | 2026-03-20 |
|
||||
| BE-LOG002 | 物流策略与渠道选择闭环 | 渠道选择算法 | 订单ID, 物流方案 | 渠道ID | 订单创建 | ✅ completed | P1 | BE-LOG001 | 12h | AI-Backend-8 | 2026-03-20 |
|
||||
| BE-LOG003 | 物流策略与渠道选择闭环 | 运费计算接口 | 商品ID, 数量, 目的地 | 运费 | 前端请求 | ✅ completed | P1 | BE-LOG001 | 10h | AI-Backend-8 | 2026-03-20 |
|
||||
|
||||
## 相关闭环
|
||||
|
||||
- 物流策略与渠道选择闭环
|
||||
|
||||
## 依赖关系
|
||||
|
||||
```
|
||||
BE-LOG001 ─┬─► BE-LOG002
|
||||
└─► BE-LOG003
|
||||
```
|
||||
|
||||
## 数据库表结构
|
||||
|
||||
### cf_logistics_strategy
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| id | string | 策略ID |
|
||||
| tenant_id | string | 租户ID |
|
||||
| name | string | 策略名称 |
|
||||
| description | text | 策略描述 |
|
||||
| priority | integer | 优先级 |
|
||||
| status | enum | ACTIVE/INACTIVE |
|
||||
| created_at | datetime | 创建时间 |
|
||||
| updated_at | datetime | 更新时间 |
|
||||
|
||||
### cf_logistics_channel
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| id | string | 渠道ID |
|
||||
| tenant_id | string | 租户ID |
|
||||
| name | string | 渠道名称 |
|
||||
| type | string | 渠道类型 |
|
||||
| cost | decimal(10,2) | 基础成本 |
|
||||
| transit_time | integer | 预计运输时间(天) |
|
||||
| status | enum | ACTIVE/INACTIVE |
|
||||
| created_at | datetime | 创建时间 |
|
||||
| updated_at | datetime | 更新时间 |
|
||||
|
||||
### cf_shipping_rate
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| id | string | 费率ID |
|
||||
| tenant_id | string | 租户ID |
|
||||
| channel_id | string | 渠道ID |
|
||||
| destination | string | 目的地 |
|
||||
| weight_rate | decimal(10,2) | 重量费率 |
|
||||
| volume_rate | decimal(10,2) | 体积费率 |
|
||||
| created_at | datetime | 创建时间 |
|
||||
| updated_at | datetime | 更新时间 |
|
||||
|
||||
## API端点
|
||||
|
||||
### 物流管理API
|
||||
- `GET /api/logistics/strategies` - 获取物流策略列表
|
||||
- `POST /api/logistics/strategies` - 创建物流策略
|
||||
- `GET /api/logistics/strategies/:id` - 获取策略详情
|
||||
- `PUT /api/logistics/strategies/:id` - 更新策略
|
||||
- `GET /api/logistics/channels` - 获取物流渠道列表
|
||||
- `POST /api/logistics/channels` - 创建物流渠道
|
||||
- `GET /api/logistics/channels/:id` - 获取渠道详情
|
||||
- `POST /api/logistics/calculate` - 计算运费
|
||||
- `GET /api/logistics/rates` - 获取费率列表
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [ ] 物流策略引擎能根据订单和目的地生成合理的物流方案
|
||||
- [ ] 渠道选择算法能选择最优的物流渠道
|
||||
- [ ] 运费计算接口能准确计算运费
|
||||
- [ ] 所有接口响应时间不超过1.5秒
|
||||
- [ ] 数据一致性得到保证
|
||||
|
||||
## 测试要求
|
||||
|
||||
- [ ] 单元测试:覆盖物流策略和渠道选择逻辑
|
||||
- [ ] 集成测试:验证与订单系统的交互
|
||||
- [ ] 端到端测试:模拟完整的物流流程
|
||||
- [ ] 边界测试:测试异常数据和边界情况
|
||||
|
||||
## 风险提示
|
||||
|
||||
- **风险点1**:物流渠道不稳定 - 应对措施:建立渠道健康度监控和备用渠道机制
|
||||
- **风险点2**:运费计算不准确 - 应对措施:定期更新费率数据和优化计算算法
|
||||
- **风险点3**:物流时效延误 - 应对措施:实现物流状态实时监控和预警机制
|
||||
|
||||
## 性能要求
|
||||
|
||||
- 响应时间:平均响应时间 < 1.5秒
|
||||
- 并发处理:支持200个并发请求
|
||||
- 数据处理:能处理10000条物流计算/小时
|
||||
|
||||
## 安全要求
|
||||
|
||||
- 权限控制:只有LOGISTICS和ADMIN角色可访问物流数据
|
||||
- 审计日志:所有物流操作需记录详细日志
|
||||
- 输入验证:严格验证所有物流相关输入
|
||||
- 数据一致性:确保物流数据的准确性和一致性
|
||||
Reference in New Issue
Block a user