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

- 移除未使用的TabPane组件
- 修复类型定义和导入方式
- 优化mock数据源的环境变量判断逻辑
- 更新文档结构并归档旧文件
- 添加新的UI组件和Memo组件
- 调整API路径和响应处理
This commit is contained in:
2026-03-23 12:41:35 +08:00
parent a037843851
commit 2b86715c09
363 changed files with 39305 additions and 40622 deletions

View File

@@ -0,0 +1,77 @@
# 商品管理后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| ------- | ---------- | --------------------- | ------------- | ---------- | ---- | ----------- | --- | ------- | ---- | ------------ | -------- |
| BE-P001 | 商品主数据闭环 | 商品主数据管理接口 | 商品基础信息 | 商品ID, 状态 | 前端提交 | ✅ completed | P0 | - | 2h | AI-Backend-1 | 2026-03-20 |
| BE-P002 | SKU变体与结构闭环 | SKU变体管理接口 | 商品ID, 变体属性 | SKU ID, 库存 | 前端提交 | ✅ completed | P1 | BE-P001 | 1.5h | AI-Backend-1 | 2026-03-20 |
| BE-P003 | 商品刊登闭环 | 商品刊登接口 | 商品ID, 平台ID | 刊登结果 | 前端提交 | ✅ completed | P0 | BE-P001 | 2h | AI-Backend-2 | 2026-03-20 |
| BE-P004 | 定价与利润决策闭环 | 动态定价计算接口 | 商品ID, 市场数据 | 建议售价 | 定时触发 | ✅ completed | P1 | BE-P001 | 2.5h | AI-Backend-2 | 2026-03-20 |
| BE-P005 | 数据采集与清洗闭环 | 平台API对接服务(Amazon MWS) | API凭证, 商品ASIN | 商品数据 | 定时任务 | ✅ completed | P0 | BE-P001 | 8h | AI-Backend-2 | 2026-03-20 |
| BE-P006 | 多平台商品管理闭环 | 多平台商品整合接口 | 商品信息, 平台列表 | 商品映射关系 | 前端提交 | ✅ completed | P1 | BE-P001 | 6h | AI-Backend-1 | 2026-03-19 |
| BE-P007 | 多平台商品管理闭环 | 批量商品操作接口 | 商品ID列表, 操作类型 | 操作结果 | 前端提交 | ✅ completed | P1 | BE-P006 | 4h | AI-Backend-1 | 2026-03-19 |
| BE-P008 | 多平台商品管理闭环 | 跨平台库存同步接口 | 商品ID, 库存变化 | 同步状态 | 库存变化 | ✅ completed | P1 | BE-P006 | 5h | AI-Backend-1 | 2026-03-19 |
| BE-P009 | 三层商品模型闭环 | SPU/SKU/Listing三层模型实现 | 商品数据结构定义 | 三层模型数据 | 系统初始化 | ✅ completed | P0 | BE-P001 | 4h | AI-Backend-1 | 2026-03-20 |
| BE-P010 | 三层价格体系闭环 | 基准价/策略价/最终价计算服务 | SKU ID, 价格策略 | 最终价格 | 价格更新 | ✅ completed | P0 | BE-P009 | 3h | AI-Backend-1 | 2026-03-20 |
| BE-P011 | 商品映射与刊登闭环 | 商品映射关系管理接口 | 平台商品ID, 系统SKU ID | 映射关系 | 前端提交 | ✅ completed | P1 | BE-P009 | 2h | AI-Backend-2 | 2026-03-20 |
| BE-P012 | 自动刊登闭环 | AutoListingService自动刊登逻辑完善 | 选品结果, 平台配置 | 刊登任务 | AI决策 | ⚠️ needs_fix | P0 | BE-P003 | 4h | AI-Backend-1 | - |
| BE-P013 | 商品刊登闭环 | PublishService.publishToPlatform方法完善 | 商品ID, 平台参数 | 刊登结果 | 前端提交 | ⚠️ needs_fix | P0 | BE-P003 | 3h | AI-Backend-2 | - |
| BE-P014 | 数据采集与清洗闭环 | TikTok商品采集适配器 | 店铺ID, 采集配置 | 商品数据 | 定时任务 | 📝 pending | P0 | BE-P005 | 8h | AI-Backend-2 | - |
| BE-P015 | 数据采集与清洗闭环 | Temu商品采集适配器 | 店铺ID, 采集配置 | 商品数据 | 定时任务 | 📝 pending | P0 | BE-P005 | 8h | AI-Backend-2 | - |
## 相关闭环
- 商品主数据闭环
- SKU变体与结构闭环
- 商品刊登闭环
- 定价与利润决策闭环
- 数据采集与清洗闭环
- 多平台商品管理闭环
- 三层商品模型闭环
- 三层价格体系闭环
- 商品映射与刊登闭环
- 自动刊登闭环
## 依赖关系
- BE-P001 是基础任务,无依赖
- BE-P002 依赖 BE-P001
- BE-P003 依赖 BE-P001
- BE-P004 依赖 BE-P001
- BE-P005 依赖 BE-P001
- BE-P006 依赖 BE-P001
- BE-P007 依赖 BE-P006
- BE-P008 依赖 BE-P006
## 验收标准
- [x] 商品主数据管理接口能正确处理商品信息
- [x] SKU变体管理接口能成功创建和管理SKU变体
- [x] 商品刊登接口能成功将商品刊登到指定平台
- [x] 动态定价计算接口能提供合理的价格建议
- [x] 平台API对接服务能成功采集商品数据
- [x] 多平台商品整合接口能整合不同平台的商品数据
- [x] 批量商品操作接口能成功执行批量操作
- [x] 跨平台库存同步接口能保持库存数据一致
## 测试要求
- [x] 单元测试:覆盖核心业务逻辑
- [x] 集成测试验证与数据库和外部API的交互
- [x] 端到端测试:模拟完整的商品管理流程
- [x] 边界测试:测试异常情况和边界数据
## 性能要求
- 响应时间API响应时间 < 1秒
- 稳定性连续运行24小时无异常
- 并发处理支持100个并发请求
## 安全要求
- 输入验证:所有用户输入必须经过验证
- 权限控制:基于用户角色的访问控制
- 数据加密:敏感数据传输加密
- 防止SQL注入使用参数化查询

View File

@@ -0,0 +1,23 @@
# 文档优化后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| --------- | ------ | -------- | ----------- | ---- | ---- | ----------- | --- | --------- | ---- | ------------- | -------- |
| BE-DOC001 | 文档优化闭环 | 服务设计文档优化 | 服务架构, 业务流程 | 优化文档 | 开发完成 | ✅ completed | P2 | - | 6h | AI-Backend-16 | 2026-03-20 |
| BE-DOC002 | 文档优化闭环 | 数据一致性文档 | 事务边界, 幂等性 | 优化文档 | 开发完成 | ✅ completed | P2 | BE-DOC001 | 4h | AI-Backend-16 | 2026-03-20 |
| BE-DOC003 | 文档优化闭环 | 可观测性文档 | 日志, 追踪, 监控 | 优化文档 | 开发完成 | ✅ completed | P2 | BE-DOC001 | 4h | AI-Backend-16 | 2026-03-20 |
| BE-DOC004 | 文档优化闭环 | 权限系统文档 | RBAC, 数据级权限 | 优化文档 | 开发完成 | ✅ completed | P2 | BE-DOC001 | 4h | AI-Backend-16 | 2026-03-20 |
| BE-DOC005 | 文档优化闭环 | 配置驱动文档 | 系统参数, 可配置性 | 优化文档 | 开发完成 | ✅ completed | P2 | BE-DOC001 | 4h | AI-Backend-16 | 2026-03-20 |
## 相关闭环
- 文档优化闭环
## 依赖关系
- BE-DOC001 是基础任务,无依赖
- BE-DOC002 依赖 BE-DOC001
- BE-DOC003 依赖 BE-DOC001
- BE-DOC004 依赖 BE-DOC001
- BE-DOC005 依赖 BE-DOC001

View File

@@ -0,0 +1,64 @@
# 订单管理后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| ------- | --------- | --------- | -------------- | -------- | ---- | ----------- | --- | ------- | ---- | ------------ | -------- |
| BE-O001 | 订单履约闭环 | 订单创建接口 | 用户ID, 商品ID, 数量 | 订单ID, 状态 | 前端提交 | ✅ completed | P0 | BE-P001 | 2h | AI-Backend-1 | 2026-03-20 |
| BE-O002 | 订单集中管理闭环 | 多平台订单归集接口 | 平台账号, 时间范围 | 订单数据 | 定时任务 | ✅ completed | P0 | BE-O001 | 3h | AI-Backend-3 | 2026-03-20 |
| BE-O003 | 订单拆分与合并闭环 | 订单拆分逻辑 | 订单ID, 拆分规则 | 子订单列表 | 库存不足 | ✅ completed | P1 | BE-O001 | 2h | AI-Backend-3 | 2026-03-20 |
| BE-O004 | 异常订单处理闭环 | 异常订单识别与处理 | 订单ID | 处理结果 | 定时扫描 | ✅ completed | P1 | BE-O001 | 2.5h | AI-Backend-2 | 2026-03-20 |
| BE-O005 | 一站式订单履约闭环 | 多平台订单统一接口 | 订单数据, 平台列表 | 统一订单ID | 订单创建 | ✅ completed | P1 | BE-O001 | 6h | AI-Backend-1 | 2026-03-20 |
| BE-O006 | 一站式订单履约闭环 | 智能订单路由接口 | 订单ID, 库存数据 | 路由结果 | 订单处理 | ✅ completed | P1 | BE-O005 | 5h | AI-Backend-1 | 2026-03-20 |
| BE-O007 | 一站式订单履约闭环 | 全流程履约管理接口 | 订单ID, 履约参数 | 履约状态 | 订单处理 | ✅ completed | P1 | BE-O005 | 8h | AI-Backend-1 | 2026-03-20 |
| BE-O008 | 一站式订单履约闭环 | 跨平台状态同步接口 | 订单ID, 状态 | 同步结果 | 状态变化 | ✅ completed | P1 | BE-O005 | 4h | AI-Backend-1 | 2026-03-20 |
## 相关闭环
- 订单履约闭环
- 订单集中管理闭环
- 订单拆分与合并闭环
- 异常订单处理闭环
- 一站式订单履约闭环
## 依赖关系
- BE-O001 依赖 BE-P001
- BE-O002 依赖 BE-O001
- BE-O003 依赖 BE-O001
- BE-O004 依赖 BE-O001
- BE-O005 依赖 BE-O001
- BE-O006 依赖 BE-O005
- BE-O007 依赖 BE-O005
- BE-O008 依赖 BE-O005
## 验收标准
- [x] 订单创建接口能正确创建订单
- [x] 多平台订单归集接口能成功归集不同平台的订单
- [x] 订单拆分逻辑能根据规则拆分订单
- [x] 异常订单识别与处理能有效处理异常订单
- [x] 多平台订单统一接口能统一处理不同平台的订单
- [x] 智能订单路由接口能根据库存数据路由订单
- [x] 全流程履约管理接口能管理订单履约全流程
- [x] 跨平台状态同步接口能同步订单状态
## 测试要求
- [x] 单元测试:覆盖核心订单处理逻辑
- [x] 集成测试验证与数据库和外部API的交互
- [x] 端到端测试:模拟完整的订单管理流程
- [x] 边界测试:测试异常情况和边界数据
## 性能要求
- 响应时间API响应时间 < 1秒
- 稳定性连续运行24小时无异常
- 并发处理支持100个并发请求
## 安全要求
- 输入验证:所有用户输入必须经过验证
- 权限控制:基于用户角色的访问控制
- 数据加密:敏感数据传输加密
- 防止SQL注入使用参数化查询

View File

@@ -0,0 +1,108 @@
# 财务管理后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| ------- | ------- | ------ | ---------- | ---- | ---- | ----------- | --- | ------- | ---- | ------------ | -------- |
| BE-F001 | 资金对账闭环 | 对账接口 | 时间范围, 平台ID | 对账结果 | 定时任务 | ✅ completed | P0 | BE-O001 | 2h | AI-Backend-2 | 2026-03-20 |
| BE-F002 | 回款与财务闭环 | 回款管理接口 | 订单ID, 回款金额 | 回款记录 | 回款事件 | ✅ completed | P1 | BE-F001 | 1.5h | AI-Backend-2 | 2026-03-20 |
| BE-F003 | 利润核算闭环 | 利润计算接口 | 订单ID, 成本数据 | 利润数据 | 订单完成 | ✅ completed | P1 | BE-F001 | 2h | AI-Backend-3 | 2026-03-20 |
## 相关闭环
- 资金对账闭环
- 回款与财务闭环
- 利润核算闭环
## 依赖关系
```
BE-O001 ─► BE-F001 ─┬─► BE-F002
└─► BE-F003
```
## 数据库表结构
### cf_finance_reconciliation
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 对账记录ID |
| tenant_id | string | 租户ID |
| platform_id | string | 平台ID |
| period_start | datetime | 对账开始时间 |
| period_end | datetime | 对账结束时间 |
| expected_amount | decimal(10,2) | 预期金额 |
| actual_amount | decimal(10,2) | 实际金额 |
| status | enum | PENDING/COMPLETED/ERROR |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_payment_record
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 回款记录ID |
| tenant_id | string | 租户ID |
| order_id | string | 订单ID |
| amount | decimal(10,2) | 回款金额 |
| payment_method | string | 支付方式 |
| status | enum | PENDING/COMPLETED/FAILED |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_profit_calculation
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 利润计算ID |
| tenant_id | string | 租户ID |
| order_id | string | 订单ID |
| revenue | decimal(10,2) | 收入 |
| cost | decimal(10,2) | 成本 |
| profit | decimal(10,2) | 利润 |
| profit_margin | decimal(5,2) | 利润率 |
| created_at | datetime | 创建时间 |
## API端点
### 财务管理API
- `GET /api/finance/reconciliation` - 获取对账记录列表
- `POST /api/finance/reconciliation` - 发起对账
- `GET /api/finance/reconciliation/:id` - 获取对账详情
- `GET /api/finance/payments` - 获取回款记录列表
- `POST /api/finance/payments` - 记录回款
- `GET /api/finance/payments/:id` - 获取回款详情
- `GET /api/finance/profit/:orderId` - 获取订单利润
- `POST /api/finance/profit/calculate` - 计算利润
## 验收标准
- [x] 对账接口能正确处理不同平台的对账数据
- [x] 回款管理接口能准确记录回款信息
- [x] 利润计算接口能正确计算订单利润和利润率
- [x] 所有接口响应时间不超过2秒
- [x] 数据一致性得到保证,无重复或丢失数据
## 测试要求
- [x] 单元测试:覆盖核心计算逻辑
- [x] 集成测试:验证与订单系统的交互
- [x] 端到端测试:模拟完整的财务流程
- [x] 边界测试:测试异常数据和边界情况
## 风险提示
- **风险点1**:对账数据量大导致性能问题 - 应对措施:实现分页和异步处理
- **风险点2**:多平台数据格式不一致 - 应对措施:统一数据转换层
- **风险点3**:回款状态更新不及时 - 应对措施:实现定时同步机制
## 性能要求
- 响应时间:平均响应时间 < 2秒
- 并发处理支持100个并发请求
- 数据处理能处理10000条对账记录/小时
## 安全要求
- 权限控制只有FINANCE角色可访问财务数据
- 数据加密:敏感财务数据加密存储
- 审计日志:所有财务操作需记录详细日志
- 输入验证:严格验证所有财务数据输入

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

View File

@@ -0,0 +1,86 @@
# 用户与账户管理后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| ------- | --------- | ------ | -------- | ---- | ---- | ----------- | --- | ------- | ---- | ------------ | -------- |
| BE-U001 | 客户/商家押金闭环 | 押金管理接口 | 客户ID, 金额 | 押金余额 | 押金操作 | ✅ completed | P1 | BE-O001 | 1.5h | AI-Backend-2 | 2026-03-20 |
| BE-U002 | 用户/客户资产闭环 | 用户资产统计 | 用户ID | 资产数据 | 定时任务 | ✅ completed | P2 | BE-U001 | 2h | AI-Backend-2 | 2026-03-20 |
## 相关闭环
- 客户/商家押金闭环
- 用户/客户资产闭环
## 依赖关系
```
BE-O001 ─► BE-U001 ─► BE-U002
```
## 数据库表结构
### cf_user_deposit
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 押金记录ID |
| tenant_id | string | 租户ID |
| user_id | string | 用户ID |
| amount | decimal(10,2) | 押金金额 |
| balance | decimal(10,2) | 押金余额 |
| status | enum | ACTIVE/REFUNDED/FROZEN |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_user_asset
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 资产记录ID |
| tenant_id | string | 租户ID |
| user_id | string | 用户ID |
| deposit_balance | decimal(10,2) | 押金余额 |
| available_balance | decimal(10,2) | 可用余额 |
| total_assets | decimal(10,2) | 总资产 |
| last_updated | datetime | 最后更新时间 |
## API端点
### 用户资产管理API
- `GET /api/user/deposit/:userId` - 获取用户押金信息
- `POST /api/user/deposit` - 缴纳押金
- `POST /api/user/deposit/refund` - 退还押金
- `GET /api/user/assets/:userId` - 获取用户资产统计
- `GET /api/user/assets/summary` - 获取资产汇总
## 验收标准
- [x] 押金管理接口能正确处理押金的缴纳和退还
- [x] 用户资产统计能准确反映用户的资产状况
- [x] 所有接口响应时间不超过1秒
- [x] 数据一致性得到保证
## 测试要求
- [x] 单元测试:覆盖押金计算和资产统计逻辑
- [x] 集成测试:验证与订单系统的交互
- [x] 端到端测试:模拟完整的押金和资产管理流程
- [x] 边界测试:测试异常数据和边界情况
## 风险提示
- **风险点1**:押金退还操作风险 - 应对措施:实现审批流程
- **风险点2**:资产统计数据不一致 - 应对措施:实现定期对账机制
- **风险点3**:用户资产信息泄露 - 应对措施:加强数据加密和访问控制
## 性能要求
- 响应时间:平均响应时间 < 1秒
- 并发处理支持150个并发请求
- 数据处理能处理10000条资产记录/小时
## 安全要求
- 权限控制只有用户本人和ADMIN角色可访问用户资产数据
- 数据加密:敏感资产数据加密存储
- 审计日志:所有资产操作需记录详细日志
- 输入验证:严格验证所有资产相关输入

View File

@@ -0,0 +1,106 @@
# 治理与风控后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| ------- | ---------- | ------ | ---------- | ----- | ---- | ----------- | --- | ------- | ---- | ------------ | -------- |
| BE-G001 | 治理与审批中心闭环 | 审批流程引擎 | 审批类型, 数据 | 审批结果 | 审批请求 | ✅ completed | P1 | BE-O001 | 2.5h | AI-Backend-3 | 2026-03-20 |
| BE-G002 | 合规与风控闭环 | 风控规则引擎 | 订单ID, 用户ID | 风险评分 | 订单创建 | ✅ completed | P0 | BE-O001 | 2h | AI-Backend-2 | 2026-03-20 |
| BE-G003 | 账号/店铺健康度闭环 | 健康度监控 | 店铺ID | 健康度评分 | 定时任务 | ✅ completed | P1 | BE-G002 | 2h | AI-Backend-3 | 2026-03-20 |
## 相关闭环
- 治理与审批中心闭环
- 合规与风控闭环
- 账号/店铺健康度闭环
## 依赖关系
```
BE-O001 ─┬─► BE-G001
└─► BE-G002 ─► BE-G003
```
## 数据库表结构
### cf_approval
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 审批记录ID |
| tenant_id | string | 租户ID |
| approval_type | string | 审批类型 |
| data | json | 审批数据 |
| status | enum | PENDING/APPROVED/REJECTED |
| approver_id | string | 审批人ID |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_risk_control
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 风控记录ID |
| tenant_id | string | 租户ID |
| order_id | string | 订单ID |
| user_id | string | 用户ID |
| risk_score | integer | 风险评分 |
| risk_level | enum | LOW/MEDIUM/HIGH |
| status | enum | PENDING/APPROVED/REJECTED |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_health_check
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 健康检查ID |
| tenant_id | string | 租户ID |
| shop_id | string | 店铺ID |
| health_score | integer | 健康度评分 |
| status | enum | HEALTHY/WARNING/CRITICAL |
| issues | json | 问题列表 |
| checked_at | datetime | 检查时间 |
| created_at | datetime | 创建时间 |
## API端点
### 治理与风控API
- `GET /api/governance/approval` - 获取审批列表
- `POST /api/governance/approval` - 创建审批
- `PUT /api/governance/approval/:id` - 更新审批状态
- `GET /api/governance/risk` - 获取风控记录
- `POST /api/governance/risk/assess` - 评估风险
- `GET /api/governance/health/:shopId` - 获取店铺健康度
- `POST /api/governance/health/check` - 执行健康检查
## 验收标准
- [ ] 审批流程引擎能正确处理不同类型的审批请求
- [ ] 风控规则引擎能准确评估订单风险
- [ ] 健康度监控能及时发现店铺问题
- [ ] 所有接口响应时间不超过1.5秒
- [ ] 数据一致性得到保证
## 测试要求
- [ ] 单元测试:覆盖审批和风控逻辑
- [ ] 集成测试:验证与订单系统的交互
- [ ] 端到端测试:模拟完整的治理流程
- [ ] 边界测试:测试异常数据和边界情况
## 风险提示
- **风险点1**:审批流程过于复杂影响效率 - 应对措施:优化审批流程,设置合理的审批阈值
- **风险点2**:风控规则误判 - 应对措施:定期评估和调整风控规则
- **风险点3**:健康度监控误报 - 应对措施:优化监控算法,减少误报率
## 性能要求
- 响应时间:平均响应时间 < 1.5秒
- 并发处理支持200个并发请求
- 数据处理能处理5000条审批/小时
## 安全要求
- 权限控制只有ADMIN和MANAGER角色可访问治理与风控数据
- 审计日志:所有审批和风控操作需记录详细日志
- 输入验证:严格验证所有治理相关输入
- 数据一致性:确保治理数据的准确性和一致性

View File

@@ -0,0 +1,127 @@
# 广告计划与营销后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| -------- | --------- | -------- | ---------- | ----- | ---- | ----------- | --- | -------- | ---- | ------------ | -------- |
| BE-AD001 | 广告计划与营销闭环 | 广告计划创建接口 | 广告参数 | 广告ID | 前端提交 | ✅ completed | P0 | - | 12h | AI-Backend-4 | 2026-03-20 |
| BE-AD002 | 广告计划与营销闭环 | 广告投放引擎 | 广告ID, 投放参数 | 投放状态 | 定时任务 | ✅ completed | P0 | BE-AD001 | 16h | AI-Backend-4 | 2026-03-20 |
| BE-AD003 | 广告计划与营销闭环 | ROI计算接口 | 广告ID, 时间范围 | ROI数据 | 定时任务 | ✅ completed | P0 | BE-AD001 | 10h | AI-Backend-4 | 2026-03-20 |
| BE-AD004 | 全渠道营销整合闭环 | 多渠道整合接口 | 渠道列表, 营销参数 | 整合结果 | 前端提交 | ✅ completed | P1 | BE-AD001 | 8h | AI-Backend-1 | 2026-03-20 |
| BE-AD005 | 全渠道营销整合闭环 | 智能营销自动化接口 | 用户行为, 触发规则 | 自动化任务 | 行为触发 | ✅ completed | P1 | BE-AD004 | 10h | AI-Backend-1 | 2026-03-20 |
| BE-AD006 | 全渠道营销整合闭环 | 营销效果分析接口 | 营销活动, 时间范围 | 分析报告 | 定时任务 | ✅ completed | P1 | BE-AD004 | 6h | AI-Backend-1 | 2026-03-20 |
| BE-AD007 | 全渠道营销整合闭环 | A/B测试自动化接口 | 测试参数, 变体列表 | 测试结果 | 前端提交 | ✅ completed | P1 | BE-AD004 | 8h | AI-Backend-1 | 2026-03-20 |
## 相关闭环
- 广告计划与营销闭环
- 全渠道营销整合闭环
## 依赖关系
```
BE-AD001 ─┬─► BE-AD002
├─► BE-AD003
└─► BE-AD004 ─┬─► BE-AD005
├─► BE-AD006
└─► BE-AD007
```
## 数据库表结构
### cf_ad_campaign
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 广告计划ID |
| tenant_id | string | 租户ID |
| name | string | 广告名称 |
| type | string | 广告类型 |
| budget | decimal(10,2) | 预算 |
| start_date | datetime | 开始日期 |
| end_date | datetime | 结束日期 |
| status | enum | DRAFT/ACTIVE/PAUSED/ENDED |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_ad_performance
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 性能记录ID |
| tenant_id | string | 租户ID |
| campaign_id | string | 广告计划ID |
| date | date | 日期 |
| impressions | integer | 展示量 |
| clicks | integer | 点击量 |
| conversions | integer | 转化量 |
| spend | decimal(10,2) | 花费 |
| revenue | decimal(10,2) | 收入 |
| roi | decimal(5,2) | 投资回报率 |
### cf_marketing_activity
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 营销活动ID |
| tenant_id | string | 租户ID |
| name | string | 活动名称 |
| channels | json | 渠道列表 |
| start_date | datetime | 开始日期 |
| end_date | datetime | 结束日期 |
| status | enum | PLANNING/ACTIVE/ENDED |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
## API端点
### 广告管理API
- `GET /api/advertisement/campaigns` - 获取广告计划列表
- `POST /api/advertisement/campaigns` - 创建广告计划
- `GET /api/advertisement/campaigns/:id` - 获取广告计划详情
- `PUT /api/advertisement/campaigns/:id` - 更新广告计划
- `POST /api/advertisement/campaigns/:id/activate` - 激活广告
- `POST /api/advertisement/campaigns/:id/pause` - 暂停广告
- `GET /api/advertisement/performance/:campaignId` - 获取广告性能
- `GET /api/advertisement/roi/:campaignId` - 获取ROI数据
### 营销管理API
- `GET /api/marketing/activities` - 获取营销活动列表
- `POST /api/marketing/activities` - 创建营销活动
- `GET /api/marketing/activities/:id` - 获取营销活动详情
- `GET /api/marketing/analysis/:activityId` - 获取营销效果分析
- `POST /api/marketing/ab-test` - 创建A/B测试
- `GET /api/marketing/ab-test/:id/results` - 获取A/B测试结果
## 验收标准
- [ ] 广告计划创建接口能正确创建和配置广告计划
- [ ] 广告投放引擎能准确执行广告投放
- [ ] ROI计算接口能正确计算广告投资回报率
- [ ] 多渠道整合接口能整合不同渠道的营销活动
- [ ] 智能营销自动化接口能根据用户行为触发自动化任务
- [ ] 所有接口响应时间不超过2秒
- [ ] 数据一致性得到保证
## 测试要求
- [ ] 单元测试覆盖广告投放和ROI计算逻辑
- [ ] 集成测试:验证与其他系统的交互
- [ ] 端到端测试:模拟完整的广告和营销流程
- [ ] 性能测试:验证高并发下的性能
## 风险提示
- **风险点1**:广告投放成本超预算 - 应对措施:实现预算监控和自动暂停机制
- **风险点2**ROI计算不准确 - 应对措施:优化数据采集和计算算法
- **风险点3**:多渠道整合复杂度高 - 应对措施:建立统一的渠道管理框架
## 性能要求
- 响应时间:平均响应时间 < 2秒
- 并发处理支持300个并发请求
- 数据处理能处理10000条广告数据/小时
## 安全要求
- 权限控制只有ADMIN和MARKETING角色可访问广告和营销数据
- 审计日志:所有广告和营销操作需记录详细日志
- 输入验证:严格验证所有广告和营销相关输入
- 数据一致性:确保广告和营销数据的准确性和一致性

View File

@@ -0,0 +1,107 @@
# 售后逆向后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------ | -------- |
| BE-SR001 | 售后逆向闭环 | 退货处理接口 | 订单ID, 退货原因 | 退货ID | 前端提交 | ✅ completed | P0 | - | 12h | AI-Backend-5 | 2026-03-20 |
| BE-SR002 | 售后逆向闭环 | 退款流程引擎 | 退货ID, 审批结果 | 退款状态 | 审批完成 | ✅ completed | P0 | BE-SR001 | 14h | AI-Backend-5 | 2026-03-20 |
| BE-SR003 | 售后逆向闭环 | 售后工单系统 | 退货ID, 工单信息 | 工单ID | 退货创建 | ✅ completed | P0 | BE-SR001 | 16h | AI-Backend-5 | 2026-03-20 |
## 相关闭环
- 售后逆向闭环
## 依赖关系
```
BE-SR001 ─┬─► BE-SR002
└─► BE-SR003
```
## 数据库表结构
### cf_return
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 退货记录ID |
| tenant_id | string | 租户ID |
| order_id | string | 订单ID |
| reason | string | 退货原因 |
| status | enum | PENDING/APPROVED/REJECTED/REFUNDED |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_refund
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 退款记录ID |
| tenant_id | string | 租户ID |
| return_id | string | 退货ID |
| order_id | string | 订单ID |
| amount | decimal(10,2) | 退款金额 |
| status | enum | PENDING/COMPLETED/FAILED |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_service_ticket
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 工单ID |
| tenant_id | string | 租户ID |
| return_id | string | 退货ID |
| order_id | string | 订单ID |
| subject | string | 工单主题 |
| description | text | 工单描述 |
| status | enum | OPEN/IN_PROGRESS/RESOLVED/CLOSED |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
## API端点
### 售后管理API
- `GET /api/after-sales/returns` - 获取退货列表
- `POST /api/after-sales/returns` - 创建退货申请
- `GET /api/after-sales/returns/:id` - 获取退货详情
- `PUT /api/after-sales/returns/:id/status` - 更新退货状态
- `GET /api/after-sales/refunds` - 获取退款列表
- `POST /api/after-sales/refunds` - 创建退款
- `GET /api/after-sales/refunds/:id` - 获取退款详情
- `GET /api/after-sales/tickets` - 获取工单列表
- `POST /api/after-sales/tickets` - 创建工单
- `GET /api/after-sales/tickets/:id` - 获取工单详情
- `PUT /api/after-sales/tickets/:id/status` - 更新工单状态
## 验收标准
- [ ] 退货处理接口能正确处理退货申请
- [ ] 退款流程引擎能准确执行退款流程
- [ ] 售后工单系统能有效管理售后工单
- [ ] 所有接口响应时间不超过1.5秒
- [ ] 数据一致性得到保证
## 测试要求
- [ ] 单元测试:覆盖退货和退款逻辑
- [ ] 集成测试:验证与订单系统的交互
- [ ] 端到端测试:模拟完整的售后流程
- [ ] 边界测试:测试异常数据和边界情况
## 风险提示
- **风险点1**:退款操作风险 - 应对措施:实现审批流程和限额控制
- **风险点2**:售后工单积压 - 应对措施:实现工单优先级和自动分配
- **风险点3**:退货原因分析不准确 - 应对措施:建立退货原因分类和分析机制
## 性能要求
- 响应时间:平均响应时间 < 1.5秒
- 并发处理支持150个并发请求
- 数据处理能处理5000条售后记录/小时
## 安全要求
- 权限控制只有CUSTOMER_SERVICE和ADMIN角色可访问售后数据
- 审计日志:所有售后操作需记录详细日志
- 输入验证:严格验证所有售后相关输入
- 数据一致性:确保售后数据的准确性和一致性

View File

@@ -0,0 +1,19 @@
# TOB 贸易后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
| --------- | ---------------- | ------- | ---------- | ------ | ---- | ----------- | --- | --------- | ---- | ------------ |
| BE-TOB001 | TOB 贸易管理闭环 | 阶梯价计算接口 | 商品ID, 数量 | 阶梯价 | 前端请求 | ✅ completed | P0 | - | 12h | AI-Backend-6 |
| BE-TOB002 | TOB 贸易管理闭环 | 批量订单处理 | 客户ID, 商品列表 | 批量订单ID | 前端提交 | ✅ completed | P0 | BE-TOB001 | 16h | AI-Backend-6 |
| BE-TOB003 | TOB 贸易管理闭环 | 账期管理 | 客户ID, 账期设置 | 账期记录 | 前端提交 | ✅ completed | P0 | BE-TOB001 | 10h | AI-Backend-6 |
## 相关闭环
- TOB 贸易管理闭环
## 依赖关系
- BE-TOB001 是基础任务,无依赖
- BE-TOB002 依赖 BE-TOB001
- BE-TOB003 依赖 BE-TOB001

View File

@@ -0,0 +1,108 @@
# 合规与证书管理后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| --------- | --------- | ------ | ---------- | ---- | ---- | ----------- | --- | --------- | ---- | ------------ | -------- |
| BE-COM001 | 合规与证书管理闭环 | 证书存储接口 | 证书信息 | 证书ID | 前端提交 | ✅ completed | P1 | - | 12h | AI-Backend-7 | 2026-03-20 |
| BE-COM002 | 合规与证书管理闭环 | 合规检查引擎 | 商品ID, 平台ID | 合规结果 | 前端请求 | ✅ completed | P1 | BE-COM001 | 14h | AI-Backend-7 | 2026-03-20 |
| BE-COM003 | 合规与证书管理闭环 | 证书更新提醒 | 证书ID, 到期时间 | 提醒通知 | 定时任务 | ✅ completed | P1 | BE-COM001 | 8h | AI-Backend-7 | 2026-03-20 |
| BE-COM004 | 合规与风控闭环 | ComplianceService.searchKeyword属性完善 | 关键词, 商品数据 | 搜索结果 | 前端请求 | ⚠️ needs_fix | P1 | BE-COM002 | 2h | AI-Backend-7 | - |
| BE-COM005 | 合规与风控闭环 | 风险评估与预警接口 | 订单数据, 用户行为 | 风险评分 | 实时监控 | 📝 pending | P1 | BE-COM002 | 4h | AI-Backend-7 | - |
| BE-COM006 | 恶意买家黑名单闭环 | 黑名单管理与共享接口 | 买家信息, 风险等级 | 黑名单状态 | 风险识别 | 📝 pending | P1 | BE-COM005 | 3h | AI-Backend-7 | - |
| BE-COM007 | 高退货率SKU闭环 | 退货率监控与自动下架接口 | SKU ID, 退货数据 | 下架状态 | 退货率超阈值 | 📝 pending | P1 | BE-P002 | 4h | AI-Backend-7 | - |
## 相关闭环
- 合规与证书管理闭环
## 依赖关系
```
BE-COM001 ─┬─► BE-COM002
└─► BE-COM003
```
## 数据库表结构
### cf_certificate
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 证书ID |
| tenant_id | string | 租户ID |
| name | string | 证书名称 |
| type | string | 证书类型 |
| content | json | 证书内容 |
| expiry_date | datetime | 到期日期 |
| status | enum | ACTIVE/EXPIRED/REVOKED |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_compliance_check
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 检查记录ID |
| tenant_id | string | 租户ID |
| product_id | string | 商品ID |
| platform_id | string | 平台ID |
| result | enum | COMPLIANT/NON_COMPLIANT/WARNING |
| issues | json | 问题列表 |
| checked_at | datetime | 检查时间 |
| created_at | datetime | 创建时间 |
### cf_certificate_reminder
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 提醒ID |
| tenant_id | string | 租户ID |
| certificate_id | string | 证书ID |
| reminder_date | datetime | 提醒日期 |
| status | enum | PENDING/SENT |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
## API端点
### 合规与证书管理API
- `GET /api/compliance/certificates` - 获取证书列表
- `POST /api/compliance/certificates` - 上传证书
- `GET /api/compliance/certificates/:id` - 获取证书详情
- `PUT /api/compliance/certificates/:id` - 更新证书
- `DELETE /api/compliance/certificates/:id` - 删除证书
- `POST /api/compliance/check` - 执行合规检查
- `GET /api/compliance/check/:productId` - 获取商品合规状态
- `GET /api/compliance/reminders` - 获取证书到期提醒
## 验收标准
- [ ] 证书存储接口能正确存储和管理证书
- [ ] 合规检查引擎能准确评估商品合规性
- [ ] 证书更新提醒能及时通知证书到期
- [ ] 所有接口响应时间不超过2秒
- [ ] 数据一致性得到保证
## 测试要求
- [ ] 单元测试:覆盖证书管理和合规检查逻辑
- [ ] 集成测试:验证与商品系统的交互
- [ ] 端到端测试:模拟完整的合规流程
- [ ] 边界测试:测试异常数据和边界情况
## 风险提示
- **风险点1**:证书过期导致合规问题 - 应对措施:实现多级提醒机制
- **风险点2**:合规检查规则复杂 - 应对措施:建立规则引擎和定期更新机制
- **风险点3**:证书信息泄露 - 应对措施:加强数据加密和访问控制
## 性能要求
- 响应时间:平均响应时间 < 2秒
- 并发处理支持100个并发请求
- 数据处理能处理5000条合规检查/小时
## 安全要求
- 权限控制只有COMPLIANCE和ADMIN角色可访问合规数据
- 数据加密:敏感证书数据加密存储
- 审计日志:所有合规操作需记录详细日志
- 输入验证:严格验证所有合规相关输入

View File

@@ -0,0 +1,106 @@
# 物流策略与渠道选择后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| --------- | ----------- | ------ | ------------- | ---- | ---- | ----------- | --- | --------- | ---- | ------------ | -------- |
| BE-LOG001 | 物流策略与渠道选择闭环 | 物流策略引擎 | 订单ID, 目的地 | 物流方案 | 订单创建 | ✅ completed | P1 | - | 14h | AI-Backend-8 | 2026-03-20 |
| BE-LOG002 | 物流策略与渠道选择闭环 | 渠道选择算法 | 订单ID, 物流方案 | 渠道ID | 订单创建 | ✅ completed | P1 | BE-LOG001 | 12h | AI-Backend-8 | 2026-03-20 |
| BE-LOG003 | 物流策略与渠道选择闭环 | 运费计算接口 | 商品ID, 数量, 目的地 | 运费 | 前端请求 | ✅ completed | P1 | BE-LOG001 | 10h | AI-Backend-8 | 2026-03-20 |
## 相关闭环
- 物流策略与渠道选择闭环
## 依赖关系
```
BE-LOG001 ─┬─► BE-LOG002
└─► BE-LOG003
```
## 数据库表结构
### cf_logistics_strategy
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 策略ID |
| tenant_id | string | 租户ID |
| name | string | 策略名称 |
| description | text | 策略描述 |
| priority | integer | 优先级 |
| status | enum | ACTIVE/INACTIVE |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_logistics_channel
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 渠道ID |
| tenant_id | string | 租户ID |
| name | string | 渠道名称 |
| type | string | 渠道类型 |
| cost | decimal(10,2) | 基础成本 |
| transit_time | integer | 预计运输时间(天) |
| status | enum | ACTIVE/INACTIVE |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_shipping_rate
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 费率ID |
| tenant_id | string | 租户ID |
| channel_id | string | 渠道ID |
| destination | string | 目的地 |
| weight_rate | decimal(10,2) | 重量费率 |
| volume_rate | decimal(10,2) | 体积费率 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
## API端点
### 物流管理API
- `GET /api/logistics/strategies` - 获取物流策略列表
- `POST /api/logistics/strategies` - 创建物流策略
- `GET /api/logistics/strategies/:id` - 获取策略详情
- `PUT /api/logistics/strategies/:id` - 更新策略
- `GET /api/logistics/channels` - 获取物流渠道列表
- `POST /api/logistics/channels` - 创建物流渠道
- `GET /api/logistics/channels/:id` - 获取渠道详情
- `POST /api/logistics/calculate` - 计算运费
- `GET /api/logistics/rates` - 获取费率列表
## 验收标准
- [ ] 物流策略引擎能根据订单和目的地生成合理的物流方案
- [ ] 渠道选择算法能选择最优的物流渠道
- [ ] 运费计算接口能准确计算运费
- [ ] 所有接口响应时间不超过1.5秒
- [ ] 数据一致性得到保证
## 测试要求
- [ ] 单元测试:覆盖物流策略和渠道选择逻辑
- [ ] 集成测试:验证与订单系统的交互
- [ ] 端到端测试:模拟完整的物流流程
- [ ] 边界测试:测试异常数据和边界情况
## 风险提示
- **风险点1**:物流渠道不稳定 - 应对措施:建立渠道健康度监控和备用渠道机制
- **风险点2**:运费计算不准确 - 应对措施:定期更新费率数据和优化计算算法
- **风险点3**:物流时效延误 - 应对措施:实现物流状态实时监控和预警机制
## 性能要求
- 响应时间:平均响应时间 < 1.5秒
- 并发处理支持200个并发请求
- 数据处理能处理10000条物流计算/小时
## 安全要求
- 权限控制只有LOGISTICS和ADMIN角色可访问物流数据
- 审计日志:所有物流操作需记录详细日志
- 输入验证:严格验证所有物流相关输入
- 数据一致性:确保物流数据的准确性和一致性

View File

@@ -0,0 +1,103 @@
# 用户/客户资产后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| -------- | --------- | -------- | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------ | -------- |
| BE-UA001 | 用户/客户资产闭环 | 用户资产计算接口 | 用户ID | 资产数据 | 前端请求 | ✅ completed | P1 | - | 10h | AI-Backend-7 | 2026-03-20 |
| BE-UA002 | 用户/客户资产闭环 | 积分管理引擎 | 用户ID, 积分操作 | 积分记录 | 前端提交 | ✅ completed | P1 | BE-UA001 | 10h | AI-Backend-7 | 2026-03-20 |
| BE-UA003 | 用户/客户资产闭环 | 会员等级系统 | 用户ID, 等级规则 | 等级信息 | 定时任务 | ✅ completed | P1 | BE-UA001 | 12h | AI-Backend-7 | 2026-03-20 |
## 相关闭环
- 用户/客户资产闭环
## 依赖关系
```
BE-UA001 ─┬─► BE-UA002
└─► BE-UA003
```
## 数据库表结构
### cf_user_asset
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 资产记录ID |
| tenant_id | string | 租户ID |
| user_id | string | 用户ID |
| total_assets | decimal(10,2) | 总资产 |
| available_balance | decimal(10,2) | 可用余额 |
| frozen_balance | decimal(10,2) | 冻结余额 |
| last_updated | datetime | 最后更新时间 |
| created_at | datetime | 创建时间 |
### cf_user_points
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 积分记录ID |
| tenant_id | string | 租户ID |
| user_id | string | 用户ID |
| points | integer | 积分数量 |
| type | enum | EARNED/USED/EXPIRED |
| reason | string | 积分变动原因 |
| created_at | datetime | 创建时间 |
### cf_user_membership
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 会员记录ID |
| tenant_id | string | 租户ID |
| user_id | string | 用户ID |
| level | string | 会员等级 |
| points_required | integer | 所需积分 |
| benefits | json | 会员权益 |
| effective_date | datetime | 生效日期 |
| expiry_date | datetime | 到期日期 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
## API端点
### 用户资产管理API
- `GET /api/user/assets/:userId` - 获取用户资产信息
- `POST /api/user/assets/calculate` - 计算用户资产
- `GET /api/user/points/:userId` - 获取用户积分
- `POST /api/user/points` - 操作用户积分
- `GET /api/user/membership/:userId` - 获取用户会员等级
- `POST /api/user/membership/update` - 更新会员等级
## 验收标准
- [ ] 用户资产计算接口能正确计算用户资产
- [ ] 积分管理引擎能准确管理用户积分
- [ ] 会员等级系统能正确评估和更新会员等级
- [ ] 所有接口响应时间不超过1秒
- [ ] 数据一致性得到保证
## 测试要求
- [ ] 单元测试:覆盖资产计算和积分管理逻辑
- [ ] 集成测试:验证与用户系统的交互
- [ ] 端到端测试:模拟完整的资产管理流程
- [ ] 边界测试:测试异常数据和边界情况
## 风险提示
- **风险点1**:资产计算错误 - 应对措施:实现双重校验和审计机制
- **风险点2**:积分过期管理 - 应对措施:实现自动过期处理和提醒机制
- **风险点3**:会员等级计算不准确 - 应对措施:建立等级规则引擎和定期更新机制
## 性能要求
- 响应时间:平均响应时间 < 1秒
- 并发处理支持150个并发请求
- 数据处理能处理10000条资产记录/小时
## 安全要求
- 权限控制只有用户本人和ADMIN角色可访问用户资产数据
- 数据加密:敏感资产数据加密存储
- 审计日志:所有资产操作需记录详细日志
- 输入验证:严格验证所有资产相关输入

View File

@@ -0,0 +1,104 @@
# A/B测试与策略优化后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| -------- | ------------ | ------- | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------ | -------- |
| BE-AB001 | A/B测试与策略优化闭环 | A/B测试引擎 | 测试ID, 参数 | 测试实例 | 前端提交 | ✅ completed | P2 | - | 12h | AI-Backend-4 | 2026-03-20 |
| BE-AB002 | A/B测试与策略优化闭环 | 流量分配算法 | 测试ID, 用户ID | 实验组 | 用户访问 | ✅ completed | P2 | BE-AB001 | 10h | AI-Backend-4 | 2026-03-20 |
| BE-AB003 | A/B测试与策略优化闭环 | 效果统计接口 | 测试ID, 时间范围 | 统计结果 | 定时任务 | ✅ completed | P2 | BE-AB001 | 8h | AI-Backend-4 | 2026-03-20 |
## 相关闭环
- A/B测试与策略优化闭环
## 依赖关系
```
BE-AB001 ─┬─► BE-AB002
└─► BE-AB003
```
## 数据库表结构
### cf_ab_test
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 测试ID |
| tenant_id | string | 租户ID |
| name | string | 测试名称 |
| description | text | 测试描述 |
| status | enum | DRAFT/RUNNING/COMPLETED/PAUSED |
| start_date | datetime | 开始日期 |
| end_date | datetime | 结束日期 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_ab_variant
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 变体ID |
| test_id | string | 测试ID |
| name | string | 变体名称 |
| weight | integer | 流量权重 |
| configuration | json | 变体配置 |
| created_at | datetime | 创建时间 |
### cf_ab_result
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 结果ID |
| test_id | string | 测试ID |
| variant_id | string | 变体ID |
| metric_name | string | 指标名称 |
| metric_value | decimal(10,2) | 指标值 |
| sample_size | integer | 样本大小 |
| recorded_at | datetime | 记录时间 |
| created_at | datetime | 创建时间 |
## API端点
### A/B测试管理API
- `GET /api/ab-test/tests` - 获取测试列表
- `POST /api/ab-test/tests` - 创建测试
- `GET /api/ab-test/tests/:id` - 获取测试详情
- `PUT /api/ab-test/tests/:id/status` - 更新测试状态
- `GET /api/ab-test/variants/:testId` - 获取变体列表
- `POST /api/ab-test/variants` - 创建变体
- `POST /api/ab-test/assign` - 分配用户到实验组
- `GET /api/ab-test/results/:testId` - 获取测试结果
- `POST /api/ab-test/results` - 记录测试结果
## 验收标准
- [ ] A/B测试引擎能正确创建和管理测试
- [ ] 流量分配算法能公平分配用户到不同实验组
- [ ] 效果统计接口能准确统计测试结果
- [ ] 所有接口响应时间不超过1.5秒
- [ ] 数据一致性得到保证
## 测试要求
- [ ] 单元测试:覆盖测试引擎和流量分配逻辑
- [ ] 集成测试:验证与其他系统的交互
- [ ] 端到端测试模拟完整的A/B测试流程
- [ ] 边界测试:测试异常数据和边界情况
## 风险提示
- **风险点1**:流量分配不均匀 - 应对措施:实现随机算法和监控机制
- **风险点2**:测试结果统计不准确 - 应对措施:优化数据采集和统计方法
- **风险点3**:测试影响用户体验 - 应对措施:设置合理的测试范围和回滚机制
## 性能要求
- 响应时间:平均响应时间 < 1.5秒
- 并发处理支持200个并发请求
- 数据处理能处理10000条测试记录/小时
## 安全要求
- 权限控制只有ADMIN和ANALYST角色可访问A/B测试数据
- 审计日志所有A/B测试操作需记录详细日志
- 输入验证:严格验证所有测试相关输入
- 数据一致性:确保测试数据的准确性和一致性

View File

@@ -0,0 +1,114 @@
# 认证服务后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| ---------- | ---- | ------ | -------- | ---- | ---- | ----------- | --- | ---------- | ---- | ------------ | -------- |
| BE-AUTH001 | 认证服务 | 用户认证接口 | 用户名, 密码 | 认证令牌 | 前端提交 | ✅ completed | P2 | - | 10h | AI-Backend-5 | 2026-03-20 |
| BE-AUTH002 | 认证服务 | 权限管理 | 用户ID, 权限 | 权限列表 | 前端请求 | ✅ completed | P2 | BE-AUTH001 | 8h | AI-Backend-5 | 2026-03-20 |
| BE-AUTH003 | 认证服务 | 会话管理 | 用户ID, 令牌 | 会话信息 | 请求验证 | ✅ completed | P2 | BE-AUTH001 | 8h | AI-Backend-5 | 2026-03-20 |
## 相关闭环
- 认证服务
## 依赖关系
```
BE-AUTH001 ─┬─► BE-AUTH002
└─► BE-AUTH003
```
## 数据库表结构
### cf_user
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 用户ID |
| tenant_id | string | 租户ID |
| username | string | 用户名 |
| password_hash | string | 密码哈希 |
| email | string | 邮箱 |
| status | enum | ACTIVE/INACTIVE/LOCKED |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_role
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 角色ID |
| name | string | 角色名称 |
| description | text | 角色描述 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_permission
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 权限ID |
| name | string | 权限名称 |
| description | text | 权限描述 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_user_role
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| user_id | string | 用户ID |
| role_id | string | 角色ID |
| created_at | datetime | 创建时间 |
### cf_role_permission
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| role_id | string | 角色ID |
| permission_id | string | 权限ID |
| created_at | datetime | 创建时间 |
## API端点
### 认证服务API
- `POST /api/auth/login` - 用户登录
- `POST /api/auth/logout` - 用户登出
- `POST /api/auth/refresh` - 刷新令牌
- `GET /api/auth/me` - 获取当前用户信息
- `GET /api/auth/roles` - 获取角色列表
- `POST /api/auth/roles` - 创建角色
- `GET /api/auth/roles/:id` - 获取角色详情
- `GET /api/auth/permissions` - 获取权限列表
- `POST /api/auth/assign-role` - 分配角色给用户
## 验收标准
- [ ] 用户认证接口能正确验证用户身份并颁发令牌
- [ ] 权限管理能准确控制用户权限
- [ ] 会话管理能有效管理用户会话
- [ ] 所有接口响应时间不超过1秒
- [ ] 数据一致性得到保证
## 测试要求
- [ ] 单元测试:覆盖认证和权限管理逻辑
- [ ] 集成测试:验证与用户系统的交互
- [ ] 端到端测试:模拟完整的认证流程
- [ ] 安全测试:测试认证系统的安全性
## 风险提示
- **风险点1**:密码安全 - 应对措施:使用强哈希算法和盐值
- **风险点2**:令牌泄露 - 应对措施:实现令牌过期和刷新机制
- **风险点3**:权限越权 - 应对措施:实现细粒度权限控制和权限校验
## 性能要求
- 响应时间:平均响应时间 < 1秒
- 并发处理支持500个并发请求
- 数据处理能处理10000次认证请求/小时
## 安全要求
- 权限控制:严格的基于角色的权限控制
- 数据加密:密码和敏感数据加密存储
- 审计日志:所有认证和权限操作需记录详细日志
- 输入验证:严格验证所有认证相关输入
- 防止暴力破解:实现登录尝试限制和验证码机制

View File

@@ -0,0 +1,150 @@
# 多商户功能收费后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| -------- | --------- | --------- | ---------- | -------- | ---- | ----------- | --- | -------- | ---- | ------------- | -------- |
| BE-MV001 | 多商户入驻闭环 | 商户注册与认证接口 | 商户信息, 资质文件 | 商户ID, 状态 | 前端提交 | ✅ completed | P1 | - | 12h | AI-Backend-12 | 2026-03-20 |
| BE-MV002 | 多商户入驻闭环 | 商户店铺管理 | 商户ID, 店铺信息 | 店铺ID | 前端提交 | ✅ completed | P1 | BE-MV001 | 10h | AI-Backend-12 | 2026-03-20 |
| BE-MV003 | 功能模块化闭环 | 功能模块管理 | 模块ID, 配置 | 模块状态 | 系统配置 | ✅ completed | P1 | BE-MV001 | 8h | AI-Backend-12 | 2026-03-20 |
| BE-MV004 | 功能开通与支付闭环 | 功能开通接口 | 商户ID, 模块ID | 开通记录 | 前端提交 | ✅ completed | P1 | BE-MV003 | 10h | AI-Backend-12 | 2026-03-20 |
| BE-MV005 | 功能开通与支付闭环 | 功能费用计算 | 商户ID, 使用数据 | 费用明细 | 定时任务 | ✅ completed | P1 | BE-MV004 | 8h | AI-Backend-12 | 2026-03-20 |
| BE-MV006 | 多商户结算闭环 | 商户结算引擎 | 商户ID, 结算周期 | 结算单 | 定时任务 | ✅ completed | P1 | BE-MV005 | 12h | AI-Backend-12 | 2026-03-20 |
| BE-MV007 | 多商户订单闭环 | 多商户订单拆分 | 订单ID, 商户列表 | 子订单列表 | 订单创建 | ✅ completed | P1 | BE-MV002 | 10h | AI-Backend-12 | 2026-03-20 |
| BE-MV008 | 多商户库存闭环 | 多商户库存同步 | 商户ID, 库存数据 | 同步状态 | 库存变化 | ✅ completed | P1 | BE-MV002 | 8h | AI-Backend-12 | 2026-03-20 |
## 相关闭环
- 多商户入驻闭环
- 功能模块化闭环
- 功能开通与支付闭环
- 多商户结算闭环
- 多商户订单闭环
- 多商户库存闭环
## 依赖关系
```
BE-MV001 ─┬─► BE-MV002 ─┬─► BE-MV007
│ └─► BE-MV008
└─► BE-MV003 ─► BE-MV004 ─► BE-MV005 ─► BE-MV006
```
## 数据库表结构
### cf_merchant
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 商户ID |
| tenant_id | string | 租户ID |
| name | string | 商户名称 |
| contact_name | string | 联系人姓名 |
| contact_email | string | 联系人邮箱 |
| status | enum | PENDING/ACTIVE/INACTIVE/SUSPENDED |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_merchant_shop
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 店铺ID |
| merchant_id | string | 商户ID |
| name | string | 店铺名称 |
| domain | string | 店铺域名 |
| status | enum | ACTIVE/INACTIVE/MAINTENANCE |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_feature_module
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 模块ID |
| name | string | 模块名称 |
| description | text | 模块描述 |
| price | decimal(10,2) | 模块价格 |
| status | enum | ACTIVE/INACTIVE |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_merchant_feature
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 开通记录ID |
| merchant_id | string | 商户ID |
| module_id | string | 模块ID |
| start_date | datetime | 开始日期 |
| end_date | datetime | 结束日期 |
| status | enum | ACTIVE/EXPIRED/CANCELLED |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
### cf_merchant_settlement
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 结算单ID |
| merchant_id | string | 商户ID |
| period_start | datetime | 结算开始日期 |
| period_end | datetime | 结算结束日期 |
| amount | decimal(10,2) | 结算金额 |
| status | enum | PENDING/COMPLETED/FAILED |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
## API端点
### 商户管理API
- `GET /api/merchant/merchants` - 获取商户列表
- `POST /api/merchant/merchants` - 注册商户
- `GET /api/merchant/merchants/:id` - 获取商户详情
- `PUT /api/merchant/merchants/:id` - 更新商户信息
- `GET /api/merchant/shops` - 获取店铺列表
- `POST /api/merchant/shops` - 创建店铺
- `GET /api/merchant/shops/:id` - 获取店铺详情
### 功能管理API
- `GET /api/merchant/modules` - 获取功能模块列表
- `POST /api/merchant/modules` - 创建功能模块
- `GET /api/merchant/modules/:id` - 获取模块详情
- `POST /api/merchant/features/activate` - 开通功能
- `GET /api/merchant/features/:merchantId` - 获取商户已开通功能
- `POST /api/merchant/billing/calculate` - 计算功能费用
- `GET /api/merchant/settlements/:merchantId` - 获取商户结算单
## 验收标准
- [ ] 商户注册与认证接口能正确处理商户注册和认证
- [ ] 商户店铺管理能有效管理商户店铺
- [ ] 功能模块管理能正确管理功能模块
- [ ] 功能开通接口能正确开通功能
- [ ] 功能费用计算能准确计算费用
- [ ] 商户结算引擎能正确生成结算单
- [ ] 多商户订单拆分能正确拆分订单
- [ ] 多商户库存同步能及时同步库存
- [ ] 所有接口响应时间不超过2秒
- [ ] 数据一致性得到保证
## 测试要求
- [ ] 单元测试:覆盖商户管理和功能开通逻辑
- [ ] 集成测试:验证与订单和库存系统的交互
- [ ] 端到端测试:模拟完整的商户管理流程
- [ ] 边界测试:测试异常数据和边界情况
## 风险提示
- **风险点1**:商户资质审核不严格 - 应对措施:建立严格的审核流程和标准
- **风险点2**:功能费用计算错误 - 应对措施:实现多重校验和审计机制
- **风险点3**:结算流程异常 - 应对措施:建立结算异常处理机制和人工审核
## 性能要求
- 响应时间:平均响应时间 < 2秒
- 并发处理支持200个并发请求
- 数据处理能处理5000条商户记录/小时
## 安全要求
- 权限控制只有ADMIN和MERCHANT角色可访问商户数据
- 数据加密:敏感商户信息加密存储
- 审计日志:所有商户操作需记录详细日志
- 输入验证:严格验证所有商户相关输入

View File

@@ -0,0 +1,33 @@
# 跨境电商后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| -------- | ------ | -------- | ---- | ---- | ---- | ----------- | --- | -------- | ---- | ------------- | -------- |
| BE-CB001 | 跨境电商闭环 | 跨境商品管理接口 | 商品信息 | 商品ID | 前端提交 | ✅ completed | P1 | - | 6h | AI-Backend-15 | 2026-03-20 |
| BE-CB002 | 跨境电商闭环 | 清关服务接口 | 清关材料 | 清关状态 | 前端提交 | ✅ completed | P1 | BE-CB001 | 8h | AI-Backend-15 | 2026-03-20 |
| BE-CB003 | 跨境电商闭环 | 跨境物流接口 | 物流参数 | 物流信息 | 前端提交 | ✅ completed | P1 | BE-CB001 | 6h | AI-Backend-15 | 2026-03-20 |
| BE-CB004 | 跨境电商闭环 | 跨境支付接口 | 支付信息 | 支付状态 | 前端提交 | ✅ completed | P1 | BE-CB001 | 6h | AI-Backend-15 | 2026-03-20 |
| BE-CB005 | 跨境电商闭环 | 合规管理接口 | 合规材料 | 合规状态 | 前端提交 | ✅ completed | P1 | BE-CB001 | 4h | AI-Backend-15 | 2026-03-20 |
| BE-CB006 | 跨境电商闭环 | Sellbrite平台集成 | 平台认证信息 | 集成状态 | 前端提交 | ✅ completed | P1 | BE-CB001 | 10h | AI-Backend-1 | 2026-03-20 |
| BE-CB007 | 跨境电商闭环 | Shoplazza平台集成 | 平台认证信息 | 集成状态 | 前端提交 | ✅ completed | P1 | BE-CB001 | 10h | AI-Backend-1 | 2026-03-20 |
| BE-CB008 | 跨境电商闭环 | SaleSmartly平台集成 | 平台认证信息 | 集成状态 | 前端提交 | ✅ completed | P1 | BE-CB001 | 10h | AI-Backend-1 | 2026-03-20 |
| BE-CB009 | 跨境电商闭环 | 多平台库存同步服务 | 库存数据 | 同步状态 | 定时任务 | ✅ completed | P1 | BE-CB006, BE-CB007 | 8h | AI-Backend-1 | 2026-03-20 |
| BE-CB010 | 跨境电商闭环 | 全渠道营销集成 | 营销参数 | 营销效果 | 前端提交 | ✅ completed | P1 | BE-CB007 | 8h | AI-Backend-1 | 2026-03-20 |
## 相关闭环
- 跨境电商闭环
## 依赖关系
- BE-CB001 是基础任务,无依赖
- BE-CB002 依赖 BE-CB001
- BE-CB003 依赖 BE-CB001
- BE-CB004 依赖 BE-CB001
- BE-CB005 依赖 BE-CB001
- BE-CB006 依赖 BE-CB001
- BE-CB007 依赖 BE-CB001
- BE-CB008 依赖 BE-CB001
- BE-CB009 依赖 BE-CB006, BE-CB007
- BE-CB010 依赖 BE-CB007

View File

@@ -0,0 +1,30 @@
# AI驱动智能决策后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
| -------- | ---------- | -------- | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------- |
| BE-AI001 | AI驱动智能决策闭环 | 数据采集处理接口 | 数据源信息 | 处理结果 | 定时任务 | ✅ completed | P1 | - | 8h | AI-Backend-15 |
| BE-AI002 | AI驱动智能决策闭环 | 模型训练部署接口 | 训练数据 | 模型ID | 手动触发 | ✅ completed | P1 | BE-AI001 | 12h | AI-Backend-15 |
| BE-AI003 | AI驱动智能决策闭环 | 智能定价接口 | 商品ID, 市场数据 | 建议售价 | 定时任务 | ✅ completed | P1 | BE-AI002 | 6h | AI-Backend-15 |
| BE-AI004 | AI驱动智能决策闭环 | 智能库存预测接口 | 商品ID, 销售数据 | 补货建议 | 定时任务 | ✅ completed | P1 | BE-AI002 | 6h | AI-Backend-15 |
| BE-AI005 | AI驱动智能决策闭环 | 智能风控接口 | 订单ID, 用户ID | 风险评分 | 订单创建 | ✅ completed | P1 | BE-AI002 | 4h | AI-Backend-15 |
| BE-AI006 | AI驱动智能决策闭环 | AIService部分方法完善 | 决策参数, 上下文 | 决策结果 | AI请求 | ⚠️ needs_fix | P2 | BE-AI002 | 3h | AI-Backend-15 |
| BE-AI007 | 策略市场闭环 | 策略创建与发布接口 | 策略配置, ROI预估 | 策略ID | 前端提交 | 📝 pending | P2 | BE-AI002 | 4h | AI-Backend-15 |
| BE-AI008 | 策略市场闭环 | 策略推荐与激活接口 | 商户数据, 使用场景 | 推荐列表 | 前端请求 | 📝 pending | P2 | BE-AI007 | 3h | AI-Backend-15 |
| BE-AI009 | 自动选品闭环 | AI选品评分计算接口 | 商品数据, 市场分析 | 选品评分 | 选品任务 | 📝 pending | P1 | BE-AI002 | 4h | AI-Backend-15 |
| BE-AI010 | 跨平台套利闭环 | 套利机会识别接口 | 多平台价格数据 | 套利建议 | 价格监控 | 📝 pending | P1 | BE-AI003 | 3h | AI-Backend-15 |
| BE-AI011 | AI动态定价闭环 | 竞争对手价格监控接口 | 商品ID, 平台列表 | 价格数据 | 定时任务 | 📝 pending | P1 | BE-AI003 | 4h | AI-Backend-15 |
| BE-AI012 | AI店铺托管闭环 | 托管配置与自动运营接口 | 托管策略, 预算配置 | 运营报告 | 托管启动 | 📝 pending | P2 | BE-AI003 | 6h | AI-Backend-15 |
## 相关闭环
- AI驱动智能决策闭环
## 依赖关系
- BE-AI001 是基础任务,无依赖
- BE-AI002 依赖 BE-AI001
- BE-AI003 依赖 BE-AI002
- BE-AI004 依赖 BE-AI002
- BE-AI005 依赖 BE-AI002

View File

@@ -0,0 +1,19 @@
# 技术基础设施后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
| -------- | -------- | ------ | ---- | ---- | ---- | ----------- | --- | -- | ---- | ------------- |
| BE-TI001 | 技术基础设施闭环 | 服务管理接口 | 服务配置 | 服务状态 | 前端提交 | ✅ completed | P0 | - | 8h | AI-Backend-22 |
| BE-TI002 | 技术基础设施闭环 | 数据管理接口 | 数据配置 | 数据状态 | 前端提交 | ✅ completed | P0 | - | 6h | AI-Backend-22 |
| BE-TI003 | 技术基础设施闭环 | 消息处理接口 | 消息配置 | 消息状态 | 前端提交 | ✅ completed | P0 | - | 6h | AI-Backend-22 |
| BE-TI004 | 技术基础设施闭环 | 安全合规接口 | 安全配置 | 安全状态 | 前端提交 | ✅ completed | P0 | - | 6h | AI-Backend-22 |
| BE-TI005 | 技术基础设施闭环 | 监控告警接口 | 监控配置 | 告警状态 | 定时任务 | ✅ completed | P0 | - | 4h | AI-Backend-22 |
## 相关闭环
- 技术基础设施闭环
## 依赖关系
- 所有任务均为基础任务,无依赖

View File

@@ -0,0 +1,21 @@
# 核心服务优先级后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
| -------- | --------- | ------- | ---- | ---- | ---- | ----------- | --- | -------- | ---- | ------------- |
| BE-CORE001 | 核心服务优先级闭环 | 服务评估接口 | 服务信息 | 评估结果 | 前端提交 | ✅ completed | P1 | - | 4h | AI-Backend-15 |
| BE-CORE002 | 核心服务优先级闭环 | 优先级排序接口 | 服务列表 | 排序结果 | 前端提交 | ✅ completed | P1 | BE-CORE001 | 3h | AI-Backend-15 |
| BE-CORE003 | 核心服务优先级闭环 | 资源分配接口 | 资源需求 | 分配结果 | 前端提交 | ✅ completed | P1 | BE-CORE002 | 3h | AI-Backend-15 |
| BE-CORE004 | 核心服务优先级闭环 | 执行监控接口 | 服务ID | 监控数据 | 定时任务 | ✅ completed | P1 | BE-CORE003 | 3h | AI-Backend-15 |
## 相关闭环
- 核心服务优先级闭环
## 依赖关系
- BE-CORE001 是基础任务,无依赖
- BE-CORE002 依赖 BE-CORE001
- BE-CORE003 依赖 BE-CORE002
- BE-CORE004 依赖 BE-CORE003

View File

@@ -0,0 +1,32 @@
# 客户服务后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| -------- | ------ | -------- | ---- | ---- | ---- | ----------- | --- | -------- | ---- | ------------- | -------- |
| BE-CS001 | 客户服务闭环 | 客户咨询处理接口 | 咨询信息 | 处理结果 | 前端提交 | ✅ completed | P1 | - | 4h | AI-Backend-15 | 2026-03-20 |
| BE-CS002 | 客户服务闭环 | 争议投诉处理接口 | 争议信息 | 处理结果 | 前端提交 | ✅ completed | P1 | BE-CS001 | 4h | AI-Backend-15 | 2026-03-20 |
| BE-CS003 | 客户服务闭环 | 售后服务接口 | 售后信息 | 处理结果 | 前端提交 | ✅ completed | P1 | BE-CS001 | 4h | AI-Backend-15 | 2026-03-20 |
| BE-CS004 | 客户服务闭环 | 客户反馈管理接口 | 反馈信息 | 处理结果 | 前端提交 | ✅ completed | P1 | BE-CS001 | 3h | AI-Backend-15 | 2026-03-20 |
| BE-CS005 | 全渠道客户沟通闭环 | 全渠道消息聚合接口 | 渠道列表, 消息数据 | 聚合结果 | 消息接收 | ✅ completed | P1 | BE-CS001 | 6h | AI-Backend-1 | 2026-03-20 |
| BE-CS006 | 全渠道客户沟通闭环 | 智能自动化客服接口 | 用户问题, 上下文 | 回复内容 | 消息接收 | ✅ completed | P1 | BE-CS005 | 8h | AI-Backend-1 | 2026-03-20 |
| BE-CS007 | 全渠道客户沟通闭环 | 团队协作管理接口 | 任务分配, 协作数据 | 协作结果 | 任务创建 | ✅ completed | P1 | BE-CS005 | 5h | AI-Backend-1 | 2026-03-20 |
| BE-CS008 | 全渠道客户沟通闭环 | 客户精细化管理接口 | 客户数据, 标签规则 | 客户画像 | 数据更新 | ✅ completed | P1 | BE-CS005 | 6h | AI-Backend-1 | 2026-03-20 |
| BE-CS009 | 全渠道客户沟通闭环 | 跨境沟通适配接口 | 消息内容, 目标语言 | 翻译结果 | 消息发送 | ✅ completed | P1 | BE-CS005 | 4h | AI-Backend-1 | 2026-03-20 |
## 相关闭环
- 客户服务闭环
- 全渠道客户沟通闭环
## 依赖关系
- BE-CS001 是基础任务,无依赖
- BE-CS002 依赖 BE-CS001
- BE-CS003 依赖 BE-CS001
- BE-CS004 依赖 BE-CS001
- BE-CS005 依赖 BE-CS001
- BE-CS006 依赖 BE-CS005
- BE-CS007 依赖 BE-CS005
- BE-CS008 依赖 BE-CS005
- BE-CS009 依赖 BE-CS005

View File

@@ -0,0 +1,19 @@
# 系统集成测试后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
| -------- | -------- | -------- | ----------- | ---- | ---- | ----------- | --- | -------- | ---- | ---------- |
| BE-IT001 | 系统集成测试闭环 | 后端接口集成测试 | 接口文档, 测试用例 | 测试结果 | 开发完成 | ✅ completed | P1 | - | 10h | AI-Test-15 |
| BE-IT002 | 系统集成测试闭环 | 服务层功能测试 | 服务需求, 测试用例 | 测试结果 | 开发完成 | ✅ completed | P1 | BE-IT001 | 8h | AI-Test-15 |
| BE-IT003 | 系统集成测试闭环 | 数据库性能测试 | 数据库设计, 测试数据 | 性能报告 | 开发完成 | ✅ completed | P1 | BE-IT001 | 8h | AI-Test-15 |
## 相关闭环
- 系统集成测试闭环
## 依赖关系
- BE-IT001 是基础任务,无依赖
- BE-IT002 依赖 BE-IT001
- BE-IT003 依赖 BE-IT001

View File

@@ -0,0 +1,19 @@
# 性能优化后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
| -------- | ------ | ------- | ------------ | ---- | ---- | ----------- | --- | -------- | ---- | ------------- |
| BE-PF001 | 性能优化闭环 | 数据库查询优化 | 慢查询日志, 索引设计 | 优化方案 | 性能测试 | ✅ completed | P2 | BE-IT003 | 8h | AI-Backend-14 |
| BE-PF002 | 性能优化闭环 | 缓存策略优化 | 缓存使用情况, 访问模式 | 缓存方案 | 性能测试 | ✅ completed | P2 | BE-PF001 | 6h | AI-Backend-14 |
| BE-PF003 | 性能优化闭环 | 异步操作优化 | 异步任务, 队列配置 | 优化方案 | 性能测试 | ✅ completed | P2 | BE-PF001 | 6h | AI-Backend-14 |
## 相关闭环
- 性能优化闭环
## 依赖关系
- BE-PF001 依赖 BE-IT003
- BE-PF002 依赖 BE-PF001
- BE-PF003 依赖 BE-PF001

View File

@@ -0,0 +1,19 @@
# 安全测试后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------- |
| BE-SE001 | 安全测试闭环 | 接口安全测试 | 接口文档, 安全规范 | 安全报告 | 开发完成 | ✅ completed | P2 | BE-IT001 | 8h | AI-Backend-15 |
| BE-SE002 | 安全测试闭环 | 数据传输加密 | 传输数据, 加密需求 | 加密方案 | 安全测试 | ✅ completed | P2 | BE-SE001 | 6h | AI-Backend-15 |
| BE-SE003 | 安全测试闭环 | 权限控制测试 | 权限设计, 测试用例 | 测试结果 | 安全测试 | ✅ completed | P2 | BE-SE001 | 6h | AI-Backend-15 |
## 相关闭环
- 安全测试闭环
## 依赖关系
- BE-SE001 依赖 BE-IT001
- BE-SE002 依赖 BE-SE001
- BE-SE003 依赖 BE-SE001

View File

@@ -0,0 +1,41 @@
# 快速建站与品牌化运营后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| ------- | ----------- | ------- | ---------- | ------ | ---- | ----------- | --- | -------- | ---- | ------------- | -------- |
| BE-SC001 | 快速建站与品牌化运营闭环 | 模板化网站设计接口 | 模板ID, 设计参数 | 网站模板 | 前端提交 | ✅ completed | P1 | - | 8h | AI-Backend-1 | 2026-03-20 |
| BE-SC002 | 快速建站与品牌化运营闭环 | 拖拽式页面编辑器接口 | 页面ID, 组件数据 | 页面配置 | 前端提交 | ✅ completed | P1 | BE-SC001 | 10h | AI-Backend-1 | 2026-03-20 |
| BE-SC003 | 快速建站与品牌化运营闭环 | 响应式布局适配接口 | 页面ID, 设备类型 | 布局配置 | 前端提交 | ✅ completed | P1 | BE-SC001 | 6h | AI-Backend-1 | 2026-03-20 |
| BE-SC004 | 快速建站与品牌化运营闭环 | 多语言支持接口 | 网站ID, 语言列表 | 多语言配置 | 前端提交 | ✅ completed | P1 | BE-SC001 | 5h | AI-Backend-1 | 2026-03-20 |
| BE-SC005 | 快速建站与品牌化运营闭环 | 品牌标识与视觉设计接口 | 品牌ID, 设计素材 | 品牌配置 | 前端提交 | ✅ completed | P1 | BE-SC001 | 6h | AI-Backend-1 | 2026-03-20 |
| BE-SC006 | 快速建站与品牌化运营闭环 | 品牌故事与内容管理接口 | 品牌ID, 内容数据 | 内容管理 | 前端提交 | ✅ completed | P1 | BE-SC005 | 5h | AI-Backend-1 | 2026-03-20 |
| BE-SC007 | 快速建站与品牌化运营闭环 | 电商功能集成接口 | 网站ID, 功能列表 | 功能配置 | 前端提交 | ✅ completed | P1 | BE-SC001 | 8h | AI-Backend-1 | 2026-03-20 |
| BE-SC008 | 快速建站与品牌化运营闭环 | 营销工具集成接口 | 网站ID, 营销参数 | 营销配置 | 前端提交 | ✅ completed | P1 | BE-SC001 | 6h | AI-Backend-1 | 2026-03-20 |
| BE-SC009 | 快速建站与品牌化运营闭环 | 物流与配送配置接口 | 网站ID, 物流参数 | 物流配置 | 前端提交 | ✅ completed | P1 | BE-SC001 | 5h | AI-Backend-1 | 2026-03-20 |
| BE-SC010 | 快速建站与品牌化运营闭环 | 数据分析与报表接口 | 网站ID, 分析参数 | 分析报告 | 定时任务 | ✅ completed | P1 | BE-SC001 | 7h | AI-Backend-1 | 2026-03-20 |
| BE-SC011 | 快速建站与品牌化运营闭环 | SEO优化接口 | 网站ID, SEO参数 | SEO配置 | 前端提交 | ✅ completed | P1 | BE-SC001 | 5h | AI-Backend-1 | 2026-03-20 |
| BE-SC012 | 快速建站与品牌化运营闭环 | 社交媒体集成接口 | 网站ID, 社交账号 | 集成配置 | 前端提交 | ✅ completed | P1 | BE-SC001 | 4h | AI-Backend-1 | 2026-03-20 |
| BE-SC013 | 快速建站与品牌化运营闭环 | 内容营销支持接口 | 网站ID, 内容数据 | 内容管理 | 前端提交 | ✅ completed | P1 | BE-SC001 | 6h | AI-Backend-1 | 2026-03-20 |
| BE-SC014 | 快速建站与品牌化运营闭环 | 品牌故事传播接口 | 品牌ID, 传播参数 | 传播效果 | 定时任务 | ✅ completed | P1 | BE-SC006 | 5h | AI-Backend-1 | 2026-03-20 |
## 相关闭环
- 快速建站与品牌化运营闭环
## 依赖关系
- BE-SC001 是基础任务,无依赖
- BE-SC002 依赖 BE-SC001
- BE-SC003 依赖 BE-SC001
- BE-SC004 依赖 BE-SC001
- BE-SC005 依赖 BE-SC001
- BE-SC006 依赖 BE-SC005
- BE-SC007 依赖 BE-SC001
- BE-SC008 依赖 BE-SC001
- BE-SC009 依赖 BE-SC001
- BE-SC010 依赖 BE-SC001
- BE-SC011 依赖 BE-SC001
- BE-SC012 依赖 BE-SC001
- BE-SC013 依赖 BE-SC001
- BE-SC014 依赖 BE-SC006

View File

@@ -0,0 +1,126 @@
# 远程桌面与任务中心后端任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| ------- | ------- | ------- | ---- | ---- | ------- | ---- | ------ | ---- | ------- | ------ | ------- |
| BE-WN001 | 远程桌面体系闭环 | WinNode服务实现 | 节点配置 | 节点管理API | 前端调用 | ✅ completed | P1 | - | 3h | AI-Backend-1 | 2026-03-20 |
| BE-WN002 | 远程桌面体系闭环 | WinNode心跳与状态监控 | 节点ID, 状态数据 | 状态更新 | 定时心跳 | ✅ completed | P1 | BE-WN001 | 2h | AI-Backend-1 | 2026-03-20 |
| BE-WN003 | 远程桌面体系闭环 | WinNode连接测试与重启 | 节点ID | 测试结果 | 手动触发 | ✅ completed | P1 | BE-WN001 | 1.5h | AI-Backend-1 | 2026-03-20 |
| BE-TC001 | 任务中心闭环 | TaskCenter服务实现 | 任务配置 | 任务管理API | 前端调用 | ✅ completed | P1 | - | 3h | AI-Backend-1 | 2026-03-20 |
| BE-TC002 | 任务中心闭环 | 任务状态流转与进度更新 | 任务ID, 状态 | 状态更新 | 任务执行 | ✅ completed | P1 | BE-TC001 | 2h | AI-Backend-1 | 2026-03-20 |
| BE-TC003 | 任务中心闭环 | 任务统计与查询接口 | 租户ID | 统计数据 | 前端调用 | ✅ completed | P1 | BE-TC001 | 1.5h | AI-Backend-1 | 2026-03-20 |
| BE-IS001 | 独立站管理闭环 | IndependentSite服务实现 | 站点配置 | 站点管理API | 前端调用 | ✅ completed | P1 | - | 3h | AI-Backend-1 | 2026-03-20 |
| BE-IS002 | 独立站管理闭环 | 站点产品同步接口 | 站点ID, 产品ID列表 | 同步状态 | 手动触发 | ✅ completed | P1 | BE-IS001 | 2h | AI-Backend-1 | 2026-03-20 |
| BE-IS003 | 独立站管理闭环 | 站点订单与数据分析接口 | 站点ID, 时间范围 | 分析报告 | 前端调用 | ✅ completed | P1 | BE-IS001 | 2h | AI-Backend-1 | 2026-03-20 |
| BE-SET001 | 设置管理闭环 | Settings路由与控制器 | API请求 | API响应 | HTTP请求 | ✅ completed | P1 | BE-WN001, BE-TC001, BE-IS001 | 2h | AI-Backend-1 | 2026-03-20 |
## 相关闭环
- 远程桌面体系闭环
- 任务中心闭环
- 独立站管理闭环
- 设置管理闭环
## 依赖关系
```
BE-WN001 ─┬─► BE-WN002
└─► BE-WN003
BE-TC001 ─┬─► BE-TC002
└─► BE-TC003
BE-IS001 ─┬─► BE-IS002
└─► BE-IS003
BE-WN001 ─┐
BE-TC001 ─┼─► BE-SET001
BE-IS001 ─┘
```
## 数据库表结构
### cf_win_node
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 节点ID |
| tenant_id | string | 租户ID |
| name | string | 节点名称 |
| host | string | 主机地址 |
| port | number | 端口号 |
| status | enum | ONLINE/OFFLINE/BUSY/ERROR |
| shop_id | string | 关联店铺ID |
| profile_dir | string | 浏览器配置目录 |
| proxy | string | 代理配置 |
| fingerprint_policy | enum | STANDARD/STEALTH/RANDOM/CUSTOM |
| max_concurrent | number | 最大并发数 |
| current_tasks | number | 当前任务数 |
| cpu_usage | decimal | CPU使用率 |
| memory_usage | decimal | 内存使用率 |
| last_heartbeat | timestamp | 最后心跳时间 |
### cf_task_center
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 任务ID |
| tenant_id | string | 租户ID |
| shop_id | string | 店铺ID |
| task_type | string | 任务类型 |
| task_name | string | 任务名称 |
| status | enum | PENDING/RUNNING/COMPLETED/FAILED/CANCELLED |
| priority | enum | LOW/MEDIUM/HIGH/URGENT |
| progress | number | 进度百分比 |
| input | json | 输入参数 |
| output | json | 输出结果 |
| error | text | 错误信息 |
| trace_id | string | 追踪ID |
### cf_independent_site
| 字段 | 类型 | 说明 |
| ---- | ---- | ---- |
| id | string | 站点ID |
| tenant_id | string | 租户ID |
| name | string | 站点名称 |
| domain | string | 域名 |
| platform | enum | SHOPIFY/WOOCOMMERCE/MAGENTO/CUSTOM |
| status | enum | ACTIVE/INACTIVE/MAINTENANCE/ERROR |
| config | json | 站点配置 |
| theme | json | 主题配置 |
| payment_gateways | json | 支付网关 |
| shipping_methods | json | 配送方式 |
| analytics | json | 分析配置 |
| seo_config | json | SEO配置 |
## API端点
### WinNode API
- `GET /api/settings/winnode` - 获取节点列表
- `GET /api/settings/winnode/:id` - 获取节点详情
- `POST /api/settings/winnode` - 创建节点
- `PUT /api/settings/winnode/:id` - 更新节点
- `DELETE /api/settings/winnode/:id` - 删除节点
- `POST /api/settings/winnode/:id/test` - 测试连接
- `POST /api/settings/winnode/:id/restart` - 重启节点
- `POST /api/settings/winnode/:id/heartbeat` - 心跳上报
- `GET /api/settings/winnode/stats` - 获取统计
### TaskCenter API
- `GET /api/settings/taskcenter` - 获取任务列表
- `GET /api/settings/taskcenter/:id` - 获取任务详情
- `POST /api/settings/taskcenter` - 创建任务
- `PUT /api/settings/taskcenter/:id/status` - 更新状态
- `POST /api/settings/taskcenter/:id/cancel` - 取消任务
- `POST /api/settings/taskcenter/:id/retry` - 重试任务
- `GET /api/settings/taskcenter/stats` - 获取统计
### IndependentSite API
- `GET /api/settings/independent-site` - 获取站点列表
- `GET /api/settings/independent-site/:id` - 获取站点详情
- `POST /api/settings/independent-site` - 创建站点
- `PUT /api/settings/independent-site/:id` - 更新站点
- `DELETE /api/settings/independent-site/:id` - 删除站点
- `POST /api/settings/independent-site/:id/sync-products` - 同步产品
- `GET /api/settings/independent-site/:id/products` - 获取产品
- `GET /api/settings/independent-site/:id/orders` - 获取订单
- `GET /api/settings/independent-site/:id/analytics` - 获取分析

View File

@@ -0,0 +1,196 @@
# 代码审查修复任务
## 任务列表
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
| ------- | ---------- | ---------- | ----- | ---- | -------- | ---- | --- | --- | ---- | -------- | -------- |
| BE-CR001 | 代码质量闭环 | 修复 TypeScript 编译错误400+ | 错误列表 | 编译通过 | 代码审查 | ✅ completed | P0 | - | 16h | AI-Backend-1 | 2026-03-22 |
| BE-CR002 | 代码质量闭环 | 修复金额字段类型51 处 float/double → decimal | 违规文件列表 | 数据库表更新 | 代码审查 | ✅ completed | P0 | - | 4h | AI-Backend-1 | 2026-03-20 |
| BE-CR003 | 安全闭环 | 移除 VaultCrypto 默认密钥硬编码 | VaultCrypto.ts | 安全密钥管理 | 代码审查 | ✅ completed | P0 | - | 1h | AI-Backend-1 | 2026-03-20 |
| BE-CR004 | 功能闭环 | 完成核心 TODO 项(商品/订单同步) | TODO 列表 | 功能实现 | 代码审查 | ✅ completed | P1 | - | 8h | AI-Backend-1 | 2026-03-25 |
| BE-CR005 | 类型安全闭环 | 减少 `any` 类型使用43 处) | 违规文件列表 | 类型定义完善 | 代码审查 | 🔒 claimed | P1 | - | 6h | AI-Backend-1 | 2026-03-25 |
| BE-CR006 | 日志规范闭环 | 统一 logger 使用86 处 console.log | 违规文件列表 | 日志统一 | 代码审查 | 🔒 claimed | P1 | - | 3h | AI-Backend-1 | 2026-03-24 |
| BE-CR007 | 输入验证闭环 | 完善输入参数验证 | API 路由列表 | Zod 验证 | 代码审查 | 🔒 claimed | P2 | - | 12h | AI-Backend-1 | 2026-04-10 |
| BE-CR008 | 性能优化闭环 | 优化数据库查询索引 | 慢查询日志 | 索引优化 | 性能监控 | 🔒 claimed | P2 | - | 8h | AI-Backend-1 | 2026-04-15 |
| BE-CR009 | 测试覆盖闭环 | 补充单元测试覆盖率 | 测试报告 | 测试用例 | 代码审查 | 🔒 claimed | P2 | - | 20h | AI-Backend-1 | 2026-04-20 |
## 相关闭环
- 代码质量闭环
- 安全闭环
- 功能闭环
- 类型安全闭环
- 日志规范闭环
- 输入验证闭环
- 性能优化闭环
- 测试覆盖闭环
## 依赖关系
- BE-CR001 是基础任务,无依赖
- BE-CR002 无依赖
- BE-CR003 无依赖
- BE-CR004 无依赖
- BE-CR005 无依赖
- BE-CR006 无依赖
- BE-CR007 依赖 BE-CR001
- BE-CR008 依赖 BE-CR001
- BE-CR009 依赖 BE-CR001
## 任务详情
### BE-CR001: 修复 TypeScript 编译错误
**问题描述**: Server 模块存在 400+ 个 TypeScript 编译错误,导致项目无法正常构建。
**影响文件**:
- `src/services/*.ts` (100+ 文件)
- `src/domains/**/*.ts` (50+ 文件)
- `src/core/**/*.ts` (30+ 文件)
**错误类型分布**:
- 类型不匹配错误: ~40%
- 缺少类型声明: ~30%
- 导入/导出错误: ~20%
- 其他语法错误: ~10%
**验收标准**:
- ✅ 运行 `npm run check` 无错误
- ✅ 项目能够成功编译
- ✅ 无 TypeScript 类型错误
- ✅ 所有导入导出正确
**实施步骤**:
1. 运行 `npm run check` 获取完整错误列表
2. 按模块分批修复优先修复核心服务Trade/Billing/Arbitrage
3. 添加缺失的类型声明文件
4. 统一模块导入规范
---
### BE-CR002: 修复金额字段类型
**问题描述**: 根据项目规则 1.1,金额字段必须使用 `decimal(10,2)`,但发现多处使用 `float`/`double`
**违规文件列表**:
| 文件路径 | 行号 | 违规代码 |
|----------|------|----------|
| `src/services/ProductService.ts` | 53 | `table.double('rating')` |
| `src/core/runtime/LegacyTableInitializer.ts` | 321-322 | `table.float('daily_budget')` |
| `src/domains/Arbitrage/ArbitrageService.ts` | 98-99 | `table.float('initial_profit_rate')` |
| `src/domains/Billing/SLAGovernanceService.ts` | 108 | `table.float('p95_latency_ms')` |
| `src/services/FXHedgingService.ts` | 40 | `table.float('volatility')` |
**验收标准**:
- ✅ 所有金额字段使用 `decimal(10,2)`
- ✅ 数据库表结构更新完成
- ✅ 迁移脚本执行成功
- ✅ 无数据丢失
**实施步骤**:
1. 识别所有使用 float/double 的金额字段
2. 创建数据库迁移脚本
3. 更新表结构定义
4. 执行迁移并验证数据完整性
---
### BE-CR003: 移除 VaultCrypto 默认密钥硬编码
**问题描述**: `VaultCrypto.ts` 中存在默认主密钥硬编码,如果环境变量未设置,将使用可预测的默认密钥,严重危及凭证安全。
**文件**: `server/src/utils/VaultCrypto.ts`
**行号**: 9
**验收标准**:
- ✅ 移除默认密钥硬编码
- ✅ 环境变量缺失时抛出明确错误
- ✅ 添加密钥验证逻辑
- ✅ 通过安全测试
**实施步骤**:
1. 修改 `MASTER_KEY` 获取逻辑
2. 添加环境变量验证
3. 更新相关文档
4. 测试密钥管理流程
---
### BE-CR004: 完成核心 TODO 项
**问题描述**: 发现 30 个 TODO/FIXME 注释,部分涉及核心功能缺失。
**关键遗留项**:
| 文件 | 行号 | 描述 | 优先级 |
|------|------|------|--------|
| `OperationAgentService.ts` | 118 | 商品同步到数据库 | P0 |
| `OperationAgentService.ts` | 167 | 订单同步到数据库 | P0 |
| `PlatformApiService.ts` | 204-214 | Amazon SP-API 同步 | P1 |
| `dynamicPricing.ts` | 261 | analyzeCompetitorPrices 方法 | P1 |
| `SummaryAggregationService.ts` | 125-126 | 真实成本/利润接入 | P1 |
**验收标准**:
- ✅ 所有 P0 级别 TODO 完成
- ✅ 商品同步功能实现
- ✅ 订单同步功能实现
- ✅ 核心功能测试通过
---
### BE-CR005: 减少 `any` 类型使用
**问题描述**: Dashboard 模块中存在 43 处 `any` 类型使用,削弱了 TypeScript 的类型安全。
**验收标准**:
- ✅ 减少 `any` 类型使用至 10 处以下
- ✅ 定义明确的接口类型
- ✅ 通过 TypeScript 严格检查
- ✅ 类型覆盖率 > 95%
---
### BE-CR006: 统一 logger 使用
**问题描述**: 86 个文件混合使用 `console.log/warn/error`,与统一的 logger 服务并存。
**验收标准**:
- ✅ 所有 console.log 替换为 logger
- ✅ 日志格式统一
- ✅ 日志级别正确使用
- ✅ 日志输出可配置
---
### BE-CR007: 完善输入参数验证
**问题描述**: 部分 API 缺少输入参数校验,建议统一使用 Zod 进行参数验证。
**验收标准**:
- ✅ 所有 API 路由添加参数验证
- ✅ 使用 Zod 统一验证
- ✅ 错误提示清晰
- ✅ 通过安全测试
---
### BE-CR008: 优化数据库查询索引
**问题描述**: 复杂查询需通过 `EXPLAIN` 校验索引,批量操作建议分批处理。
**验收标准**:
- ✅ 所有慢查询优化
- ✅ 索引合理配置
- ✅ 查询性能提升 > 50%
- ✅ 通过性能测试
---
### BE-CR009: 补充单元测试覆盖率
**问题描述**: 核心服务缺少单元测试,需要补充测试用例。
**验收标准**:
- ✅ 核心服务测试覆盖率 > 80%
- ✅ 关键业务逻辑测试完整
- ✅ 所有测试通过
- ✅ CI/CD 集成测试

View File

@@ -0,0 +1,143 @@
# BE-DOC001 文档修复任务
> **任务类型**: 文档修复
> **优先级**: P1
> **状态**: COMPLETED
> **描述**: 修复全局文档中发现的内容重复、逻辑矛盾、信息冗余和错误内容问题
## 修复进度
### 已完成
- ✅ 1. 订单状态机定义不一致问题修复
- ✅ 2. 链接路径错误修复
- ✅ 3. 术语使用不统一问题修复
- ✅ 4. 内容重复整合
- ✅ 5. 信息冗余简化
- ✅ 6. 文档结构优化
- ✅ 7. 依赖关系图改进
- ✅ 8. 文档索引统一
- ✅ 9. 文档格式标准化
- ✅ 10. 文档版本更新
## 修复总结
本次文档修复工作已完成所有计划任务,包括:
1. **高优先级问题**
- 统一了订单状态机定义
- 修正了所有错误的链接路径
- 统一了术语使用B2B → TOB
- 整合了重复内容
2. **中优先级问题**
- 简化了信息冗余内容
- 优化了文档结构
- 改进了依赖关系图
3. **低优先级问题**
- 统一了文档索引
- 标准化了文档格式
- 更新了文档版本信息
通过本次修复,文档体系更加规范、一致、高效,为开发团队和用户提供了更好的参考价值。
## 问题列表
### 高优先级问题
#### 1. 订单状态机定义不一致
- **问题描述**: Business_Blueprint.md 与 State_Machine.md 中的订单状态机定义不一致
- **复现步骤**: 对比两个文件中的订单状态机定义
- **预期结果**: 统一订单状态机定义,以 State_Machine.md 为准
- **优先级**: P1
#### 2. 链接路径错误
- **问题描述**: Business_ClosedLoops.md 中存在多个错误的文档链接
- **复现步骤**: 检查文档中的链接路径是否正确
- **预期结果**: 修正所有错误的链接路径
- **优先级**: P1
#### 3. 术语使用不统一
- **问题描述**: 部分文档仍使用 B2B 术语,与 TOB 标准不一致
- **复现步骤**: 搜索文档中的 B2B 术语使用情况
- **预期结果**: 统一使用 TOB 术语
- **优先级**: P1
#### 4. 内容重复整合
- **问题描述**: 利润红线规则、状态机定义等在多个文档中重复出现
- **复现步骤**: 识别重复内容并整合到对应规范文档中
- **预期结果**: 消除重复内容,提高文档维护性
- **优先级**: P1
### 中优先级问题
#### 5. 信息冗余简化
- **问题描述**: 系统架构描述、状态机定义、业务模块描述等内容冗余
- **复现步骤**: 识别冗余内容并简化
- **预期结果**: 简化文档内容,提高可读性
- **优先级**: P2
#### 6. 文档结构优化
- **问题描述**: 部分文件名与术语标准不一致
- **复现步骤**: 检查并重命名不符合术语标准的文件
- **预期结果**: 统一文件命名,保持术语一致性
- **优先级**: P2
#### 7. 依赖关系图改进
- **问题描述**: 闭环依赖关系图过于复杂,难以理解
- **复现步骤**: 分析并简化依赖关系图
- **预期结果**: 简化依赖关系图,提高可读性
- **优先级**: P2
### 低优先级问题
#### 8. 文档索引统一
- **问题描述**: 各模块的文档索引与 DOC_INDEX.md 重复
- **复现步骤**: 简化各模块的文档索引,引用全局 DOC_INDEX.md
- **预期结果**: 统一文档索引,减少冗余
- **优先级**: P3
#### 9. 文档格式标准化
- **问题描述**: 文档格式不一致,包括表格格式、标题层级等
- **复现步骤**: 检查并统一文档格式
- **预期结果**: 标准化文档格式,提高一致性
- **优先级**: P3
#### 10. 文档版本更新
- **问题描述**: 部分文档的更新日期不一致
- **复现步骤**: 检查并更新文档的更新日期
- **预期结果**: 统一文档更新日期,确保信息时效性
- **优先级**: P3
## 修复计划
### 第一阶段:高优先级问题修复
1. 修复订单状态机定义不一致问题
2. 修正 Business_ClosedLoops.md 中的链接路径错误
3. 统一术语使用,将 B2B 改为 TOB
4. 整合重复内容,提高文档维护性
### 第二阶段:中优先级问题修复
5. 简化信息冗余内容
6. 优化文档结构,统一文件命名
7. 改进依赖关系图
### 第三阶段:低优先级问题修复
8. 统一文档索引
9. 标准化文档格式
10. 更新文档版本信息
## 验证方法
- **链接验证**: 检查所有文档链接是否正确
- **术语一致性检查**: 确保所有文档使用统一的术语
- **内容重复检查**: 确认重复内容已整合
- **格式一致性检查**: 验证文档格式是否统一
## 相关文档
- [Document_Review_Report.md](../../06_Reports/Document_Review_Report.md)
- [TERMINOLOGY_STANDARDS.md](../../10_Documents_Global/TERMINOLOGY_STANDARDS.md)
- [State_Machine.md](../../01_Architecture/06_State_Machine.md)
- [Business_Blueprint.md](../Business_Blueprint.md)
- [Business_ClosedLoops.md](../Business_ClosedLoops.md)