wurenzhi/makemd

Files

wurenzhi 2b86715c09 refactor: 优化代码结构并修复类型问题

- 移除未使用的TabPane组件
- 修复类型定义和导入方式
- 优化mock数据源的环境变量判断逻辑
- 更新文档结构并归档旧文件
- 添加新的UI组件和Memo组件
- 调整API路径和响应处理

2026-03-23 12:41:35 +08:00

4.5 KiB

Raw Permalink Blame History

库存管理后端任务

任务列表

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 - 生成补货建议

验收标准

库存同步引擎能实时更新库存状态
多仓库库存分配能优化物流成本
补货建议生成能准确预测库存需求
所有接口响应时间不超过1.5秒
库存数据一致性得到保证

测试要求

单元测试：覆盖库存计算逻辑
集成测试：验证与订单系统的交互
端到端测试：模拟完整的库存管理流程
压力测试：验证高并发下的性能

风险提示

风险点1：库存同步延迟导致超卖 - 应对措施：实现乐观锁机制
风险点2：多仓库分配逻辑复杂 - 应对措施：建立分配规则引擎
风险点3：补货建议不准确 - 应对措施：基于历史数据优化算法

性能要求

响应时间：平均响应时间 < 1.5秒
并发处理：支持200个并发请求
数据同步：支持实时库存同步

安全要求

权限控制：只有LOGISTICS和OPERATOR角色可访问库存数据
审计日志：所有库存操作需记录详细日志
输入验证：严格验证库存数量等输入数据
数据一致性：确保库存数据的准确性和一致性