refactor: 优化代码结构并修复类型问题
- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
This commit is contained in:
111
docs/ARCHIVE/00_Business/tasks/backend/05_inventory.md
Normal file
111
docs/ARCHIVE/00_Business/tasks/backend/05_inventory.md
Normal file
@@ -0,0 +1,111 @@
|
||||
# 库存管理后端任务
|
||||
|
||||
## 任务列表
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
|
||||
| ------- | ----------- | ------- | ---------- | ---- | ------ | ----------- | --- | ------- | ---- | ------------ | -------- |
|
||||
| BE-I001 | 库存与仓储管理闭环 | 库存同步引擎 | 商品ID, 库存变化 | 库存状态 | 库存变化事件 | ✅ completed | P0 | BE-P001 | 2h | AI-Backend-1 | 2026-03-20 |
|
||||
| BE-I002 | 海外仓/本土仓闭环 | 多仓库库存分配 | 订单ID, 仓库列表 | 分配方案 | 订单创建 | ✅ completed | P1 | BE-I001 | 2.5h | AI-Backend-3 | 2026-03-20 |
|
||||
| BE-I003 | 供应链与供应商管理闭环 | 补货建议生成 | 商品ID, 库存阈值 | 补货建议 | 库存预警 | ✅ completed | P2 | BE-I001 | 2h | AI-Backend-3 | 2026-03-20 |
|
||||
| BE-I004 | 库存与仓储管理闭环 | InventoryService.updateStock方法完善 | 商品ID, 库存变化 | 更新结果 | 库存变化 | ⚠️ needs_fix | P1 | BE-I001 | 2h | AI-Backend-1 | - |
|
||||
| BE-I005 | 库存与仓储管理闭环 | 跨平台库存同步适配器 | 商品ID, 平台列表 | 同步状态 | 库存更新 | 📝 pending | P1 | BE-I001 | 4h | AI-Backend-2 | - |
|
||||
| BE-I006 | 库存与仓储管理闭环 | 库存预警与自动补货触发 | 商品ID, 阈值配置 | 预警通知 | 库存低于阈值 | 📝 pending | P1 | BE-I003 | 3h | AI-Backend-3 | - |
|
||||
|
||||
## 相关闭环
|
||||
|
||||
- 库存与仓储管理闭环
|
||||
- 海外仓/本土仓闭环
|
||||
- 供应链与供应商管理闭环
|
||||
|
||||
## 依赖关系
|
||||
|
||||
```
|
||||
BE-P001 ─► BE-I001 ─┬─► BE-I002
|
||||
└─► BE-I003
|
||||
```
|
||||
|
||||
## 数据库表结构
|
||||
|
||||
### cf_inventory
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| id | string | 库存记录ID |
|
||||
| tenant_id | string | 租户ID |
|
||||
| product_id | string | 商品ID |
|
||||
| warehouse_id | string | 仓库ID |
|
||||
| quantity | integer | 库存数量 |
|
||||
| reserved_quantity | integer | 预留数量 |
|
||||
| available_quantity | integer | 可用数量 |
|
||||
| status | enum | NORMAL/LOW/OUT_OF_STOCK |
|
||||
| last_updated | datetime | 最后更新时间 |
|
||||
|
||||
### cf_warehouse
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| id | string | 仓库ID |
|
||||
| tenant_id | string | 租户ID |
|
||||
| name | string | 仓库名称 |
|
||||
| type | enum | DOMESTIC/OVERSEAS |
|
||||
| location | string | 仓库位置 |
|
||||
| capacity | integer | 仓库容量 |
|
||||
| status | enum | ACTIVE/MAINTENANCE/INACTIVE |
|
||||
| created_at | datetime | 创建时间 |
|
||||
|
||||
### cf_replenishment
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| id | string | 补货记录ID |
|
||||
| tenant_id | string | 租户ID |
|
||||
| product_id | string | 商品ID |
|
||||
| suggested_quantity | integer | 建议补货数量 |
|
||||
| threshold | integer | 库存阈值 |
|
||||
| current_quantity | integer | 当前库存 |
|
||||
| status | enum | PENDING/APPROVED/REJECTED |
|
||||
| created_at | datetime | 创建时间 |
|
||||
|
||||
## API端点
|
||||
|
||||
### 库存管理API
|
||||
- `GET /api/inventory` - 获取库存列表
|
||||
- `GET /api/inventory/:productId` - 获取商品库存详情
|
||||
- `PUT /api/inventory/:id` - 更新库存
|
||||
- `POST /api/inventory/sync` - 同步库存
|
||||
- `GET /api/warehouse` - 获取仓库列表
|
||||
- `POST /api/warehouse` - 创建仓库
|
||||
- `GET /api/warehouse/:id` - 获取仓库详情
|
||||
- `GET /api/inventory/replenishment` - 获取补货建议
|
||||
- `POST /api/inventory/replenishment` - 生成补货建议
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 库存同步引擎能实时更新库存状态
|
||||
- [x] 多仓库库存分配能优化物流成本
|
||||
- [x] 补货建议生成能准确预测库存需求
|
||||
- [x] 所有接口响应时间不超过1.5秒
|
||||
- [x] 库存数据一致性得到保证
|
||||
|
||||
## 测试要求
|
||||
|
||||
- [x] 单元测试:覆盖库存计算逻辑
|
||||
- [x] 集成测试:验证与订单系统的交互
|
||||
- [x] 端到端测试:模拟完整的库存管理流程
|
||||
- [x] 压力测试:验证高并发下的性能
|
||||
|
||||
## 风险提示
|
||||
|
||||
- **风险点1**:库存同步延迟导致超卖 - 应对措施:实现乐观锁机制
|
||||
- **风险点2**:多仓库分配逻辑复杂 - 应对措施:建立分配规则引擎
|
||||
- **风险点3**:补货建议不准确 - 应对措施:基于历史数据优化算法
|
||||
|
||||
## 性能要求
|
||||
|
||||
- 响应时间:平均响应时间 < 1.5秒
|
||||
- 并发处理:支持200个并发请求
|
||||
- 数据同步:支持实时库存同步
|
||||
|
||||
## 安全要求
|
||||
|
||||
- 权限控制:只有LOGISTICS和OPERATOR角色可访问库存数据
|
||||
- 审计日志:所有库存操作需记录详细日志
|
||||
- 输入验证:严格验证库存数量等输入数据
|
||||
- 数据一致性:确保库存数据的准确性和一致性
|
||||
Reference in New Issue
Block a user