2026-03-19 19:08:15 +08:00
|
|
|
|
# 库存管理后端任务
|
|
|
|
|
|
|
|
|
|
|
|
## 任务列表
|
|
|
|
|
|
|
2026-03-20 09:43:50 +08:00
|
|
|
|
| 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 |
|
2026-03-19 19:08:15 +08:00
|
|
|
|
|
|
|
|
|
|
## 相关闭环
|
|
|
|
|
|
|
|
|
|
|
|
- 库存与仓储管理闭环
|
|
|
|
|
|
- 海外仓/本土仓闭环
|
|
|
|
|
|
- 供应链与供应商管理闭环
|
|
|
|
|
|
|
|
|
|
|
|
## 依赖关系
|
|
|
|
|
|
|
2026-03-20 09:43:50 +08:00
|
|
|
|
```
|
|
|
|
|
|
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角色可访问库存数据
|
|
|
|
|
|
- 审计日志：所有库存操作需记录详细日志
|
|
|
|
|
|
- 输入验证：严格验证库存数量等输入数据
|
|
|
|
|
|
- 数据一致性：确保库存数据的准确性和一致性
|
