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

- 将B2B统一为TOB术语
- 将状态值统一为大写格式
- 优化类型声明,避免使用any
- 将float类型替换为decimal以提高精度
- 新增术语标准化文档
- 优化路由结构和菜单分类
- 添加TypeORM实体类
- 增强加密模块安全性
- 重构前端路由结构
- 完善任务模板和验收标准
This commit is contained in:
2026-03-20 09:43:50 +08:00
parent eafa1bbe94
commit 48a78137c5
132 changed files with 13767 additions and 2140 deletions

View File

@@ -2,11 +2,11 @@
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
| ------- | ----------- | ------- | ---------- | ---- | ------ | ----------- | --- | ------- | ---- | ------------ |
| BE-I001 | 库存与仓储管理闭环 | 库存同步引擎 | 商品ID, 库存变化 | 库存状态 | 库存变化事件 | ✅ completed | P0 | BE-P001 | 2h | AI-Backend-1 |
| BE-I002 | 海外仓/本土仓闭环 | 多仓库库存分配 | 订单ID, 仓库列表 | 分配方案 | 订单创建 | ✅ completed | P1 | BE-I001 | 2.5h | AI-Backend-3 |
| BE-I003 | 供应链与供应商管理闭环 | 补货建议生成 | 商品ID, 库存阈值 | 补货建议 | 库存预警 | ✅ completed | P2 | BE-I001 | 2h | AI-Backend-3 |
| 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 |
## 相关闭环
@@ -16,6 +16,93 @@
## 依赖关系
- BE-I001 依赖 BE-P001
- BE-I002 依赖 BE-I001
- BE-I003 依赖 BE-I001
```
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角色可访问库存数据
- 审计日志:所有库存操作需记录详细日志
- 输入验证:严格验证库存数量等输入数据
- 数据一致性:确保库存数据的准确性和一致性