wurenzhi/makemd

Files

wurenzhi 48a78137c5 refactor(terminology): 统一术语标准并优化代码类型安全

- 将B2B统一为TOB术语
- 将状态值统一为大写格式
- 优化类型声明，避免使用any
- 将float类型替换为decimal以提高精度
- 新增术语标准化文档
- 优化路由结构和菜单分类
- 添加TypeORM实体类
- 增强加密模块安全性
- 重构前端路由结构
- 完善任务模板和验收标准

2026-03-20 09:43:50 +08:00

3.9 KiB

Raw 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-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角色可访问库存数据
审计日志：所有库存操作需记录详细日志
输入验证：严格验证库存数量等输入数据
数据一致性：确保库存数据的准确性和一致性