wurenzhi/makemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
aa2cf560c6b4d9322b4dde14de45c24e7a693c1f
makemd/docs/00_Business/Task_Overview.md
wurenzhi aa2cf560c6 feat: 添加汇率服务和缓存服务，优化数据源和日志服务 
refactor: 重构数据源工厂和类型定义，提升代码可维护性

fix: 修复类型转换和状态机文档中的错误

docs: 更新服务架构文档，添加新的服务闭环流程

test: 添加汇率服务单元测试

chore: 清理无用代码和注释，优化代码结构
2026-03-19 14:19:01 +08:00

161 KiB
Raw Blame History

🗂 Crawlful Hub AI开发任务总览（Task Overview）

说明：本任务表基于58个业务闭环拆解，专为100% AI开发设计，包含完整的任务依赖、数据流、触发条件和状态管理。

📦 任务包快速索引

推荐: 按任务包领取，避免碎片化等待，思维更连贯

状态标记规则:

  • ⬜ 待领取 - 无人占用，可领取
  • 🔒 AI-X - 被AI-X占用中（如：🔒 AI-1, 🔒 AI-2）
  • ✅ 已完成 - 已完成
  • ⏸️ 阻塞 - 有依赖阻塞

🔴 P0 紧急任务包（立即处理）

任务包ID 包含任务 闭环 涉及文件 预计耗时 状态
PKG-TOB-BE BE-TOB001, BE-TOB002, BE-TOB003 B2B贸易管理闭环 B2BTradeService.ts, B2B.ts, trade.ts 38h ✅ 已完成
PKG-AD-FE FE-AD001, FE-AD002, FE-AD003 广告计划与营销闭环 AdPlanPage.tsx, AdDelivery.tsx, ROIAnalysis.tsx 30h ✅ 已完成
PKG-SR-FE FE-SR001, FE-SR002, FE-SR003 售后逆向闭环 ReturnApply.tsx, RefundProcess.tsx, CustomerService.tsx 30h ✅ 已完成
PKG-TOB-FE FE-TOB001, FE-TOB002, FE-TOB003 B2B贸易管理闭环 EnterpriseQuote.tsx, BatchOrder.tsx, ContractManage.tsx 30h ✅ 已完成
PKG-TOB-AI AI-TOB001, AI-TOB002, AI-TOB003 B2B贸易AI闭环 B2BAIService.ts 40h ✅ 已完成

🟠 P1 高优先级任务包

任务包ID 包含任务 闭环 涉及文件 预计耗时 状态
PKG-COM-FE FE-COM001, FE-COM002, FE-COM003 合规与证书管理闭环 CertificateManage.tsx, ComplianceCheck.tsx 24h ✅ 已完成
PKG-LOG-FE FE-LOG001, FE-LOG002, FE-LOG003 物流策略闭环 LogisticsSelect.tsx, LogisticsTrack.tsx, FreightCalc.tsx 20h ✅ 已完成
PKG-LOG-BE BE-LOG001, BE-LOG002, BE-LOG003 物流策略与渠道选择闭环 LogisticsService.ts, trade.ts 36h ✅ 已完成
PKG-UA-FE FE-UA001, FE-UA002, FE-UA003 用户资产闭环 UserAssets.tsx, PointsManage.tsx, MemberLevel.tsx 20h ✅ 已完成
PKG-MV-BE BE-MV001~BE-MV008 多商户闭环 MerchantService.ts, FeatureModuleService.ts 78h ✅ 已完成

🟡 P2 核心增长功能任务包（新功能）🆕

任务包ID 包含任务 闭环 涉及文件 预计耗时 状态
PKG-LEADER-FE FE-LEADER001, BE-LEADER001, BE-LEADER002 多商户收益排行榜系统（信任引擎） Leaderboard.tsx, MerchantMetricsService.ts, LeaderboardService.ts 16h ✅ 已完成
PKG-STRATEGY-FE FE-STRATEGY001, BE-STRATEGY001, BE-STRATEGY002 策略市场（Strategy Marketplace） StrategyMarketplace.tsx, StrategyService.ts, StrategyRecommendationService.ts 20h ✅ 已完成
PKG-SELECT-FE FE-SELECT001, BE-SELECT001, BE-SELECT002 自动选品+自动上架系统（增长引擎） AutoProductSelection.tsx, ProductSelectionService.ts, AutoListingService.ts 24h ✅ 已完成
PKG-AUTOPILOT FE-AUTOPILOT001, BE-AUTOPILOT001, BE-AUTOPILOT002 AI店铺托管（AutoPilot） AutoPilot.tsx, AutoPilotService.ts, AutoPilotScheduler.ts 20h ✅ 已完成
PKG-ARBITRAGE FE-ARBITRAGE001, BE-ARBITRAGE001, BE-ARBITRAGE002 跨平台套利系统完善 ArbitrageMonitor.tsx, ArbitrageService.ts, PriceComparisonService.ts 12h ✅ 已完成
PKG-PRICING FE-PRICING001, BE-PRICING001, BE-PRICING002 AI动态定价系统完善 DynamicPricing.tsx, DynamicPricingService.ts, CompetitorPriceService.ts, dynamicPricingDataSource.ts, dynamicPricing.ts 16h ✅ 已完成
PKG-MULTI-TENANT-BASE BE-MT001, BE-MT002, FE-MT001, FE-MT002 多租户基础架构（商户→部门→店铺） DataIsolationService.ts, HierarchyAuthMiddleware.ts, HierarchySelector.tsx, HierarchyService.ts 24h ✅ 已完成
PKG-ORDER-MULTI-SHOP FE-ORDER-MS001, FE-ORDER-MS002, BE-ORDER-MS001 订单多店铺管理 OrderMultiShopList.tsx, OrderAggregate.tsx, OrderAggregationService.ts 16h ✅ 已完成
PKG-SHOP-REPORT FE-SHOP-REP001, BE-SHOP-REP001 多店铺报表聚合 MultiShopReport.tsx, ShopReportAggregationService.ts 12h ✅ 已完成
PKG-AI-LOG BE-AILOG-001005, FE-AILOG-001003 AI决策日志系统（全链路追溯） AIDecisionLogService.ts, AIDecisionLog/index.tsx 16h ✅ 已完成
PKG-AI-AUTO BE-AIAUTO-001004, FE-AIAUTO-001003 AI决策自动化配置 AutoExecutionConfigService.ts, AutoExecutionConfig.tsx 12h ✅ 已完成

🟢 P3 基础设施任务包

任务包ID 包含任务 闭环 涉及文件 预计耗时 状态
PKG-MOCK-ARCH MOCK-001~MOCK-012 低侵入Mock架构实现 Mock_Architecture.md, *DataSource.ts, msw.ts, *.mock.ts 16h ✅ 已完成

🚀 待实现功能（核心增长功能 + 基础设施）

说明: 以下功能是系统核心增长功能和基础设施，需要在基础架构完成后优先实现

🟣 P0 - 基础设施（优先保障AI协作质量）

0. 低侵入Mock架构 🔥🔥 ✅

状态: ✅ 已完成
优先级: P0 - 基础设施优先
任务包: PKG-MOCK-ARCH
预计开发时间: 16小时
实际完成时间: 2026-03-19

目标: 实现"不污染代码、AI上下文安全"的Mock方案

已完成:

  • [MOCK-001] 创建DataSource接口定义 (/dashboard/src/types/datasource.ts)
  • [MOCK-002] 实现证书DataSource (/dashboard/src/services/certificateDataSource.ts)
  • [MOCK-003] 配置MSW拦截器 (/dashboard/src/mock/msw.ts)
  • [MOCK-004] 入口文件MSW启动 (/dashboard/src/app.ts)
  • [MOCK-005] BFF层Mock切换器 (/server/src/bff/services/certificateService.ts)
  • [MOCK-006] BFF层Mock服务 (/server/src/bff/mock/certificateMock.ts)
  • [MOCK-011] 环境变量配置 (.env.development, .env.production)
  • [MOCK-012] 文档完善 (docs/01_Architecture/Mock_Architecture.md)

待扩展 (其他模块):

  • [MOCK-007] 产品模块DataSource (/dashboard/src/services/productDataSource.ts)
  • [MOCK-008] 订单模块DataSource (/dashboard/src/services/orderDataSource.ts)
  • [MOCK-009] 用户模块DataSource (/dashboard/src/services/userDataSource.ts)
  • [MOCK-010] 库存模块DataSource (/dashboard/src/services/inventoryDataSource.ts)

技术要点:

  • DataSource抽象层设计
  • MSW (Mock Service Worker) 配置
  • 环境变量控制 (REACT_APP_USE_MOCK)
  • 目录隔离 (/mock 目录)
  • AI协作规范 (Mock文件标记)

参考文档: Mock_Architecture.md

🔴 P0 - 紧急功能（阻塞核心业务）

1. 多商户收益排行榜系统（信任引擎）🔥 ✅

状态: ✅ 已完成
优先级: P0 - 紧急
预计开发时间: 16小时
实际完成时间: 2026-03-19

已完成:

  • cf_merchant_metrics 表结构
  • cf_leaderboard_snapshot 表结构
  • MerchantMetricsService 服务（指标计算、存储、查询、验证）
  • LeaderboardService 服务（排行生成、缓存、防作弊、自动刷新）
  • 排行榜API端点（收益榜/ROI榜/增长榜）
  • 防作弊逻辑（订单数校验、高增长验证）
  • 前端 Leaderboard 页面
  • TOP 10 商户展示
  • 商户排名查询
  • 系统导航集成

2. 策略市场（Strategy Marketplace）🔥 ✅

状态: ✅ 已完成
优先级: P0 - 紧急
预计开发时间: 20小时
实际完成时间: 2026-03-19

已完成:

  • cf_strategies 表结构
  • cf_merchant_strategies 表结构
  • StrategyService 服务（策略管理、激活、暂停、完成、统计更新）
  • StrategyRecommendationService 服务（个性化推荐、分类推荐、相似策略、趋势策略）
  • 策略推荐算法（评分计算、ROI预估、置信度评估）
  • 策略激活API（激活/暂停/恢复/完成）
  • 前端 StrategyMarketplace 页面
  • 策略分类Tabs（市场/精选/趋势/推荐/我的策略）
  • 策略卡片展示（ROI/成功率/使用次数/价格）
  • 策略详情Modal
  • 我的策略管理（激活/暂停/恢复）

3. 自动选品+自动上架系统（增长引擎）🔥 ✅

状态: ✅ 已完成
优先级: P0 - 紧急
预计开发时间: 24小时
实际完成时间: 2026-03-20

目标: 自动找到赚钱商品 → 自动卖

已完成:

  • cf_selection_rules 表结构（选品规则）
  • cf_product_pool 表结构（商品池）
  • cf_listing_tasks 表结构（上架任务）
  • ProductSelectionService 服务（规则管理、商品池管理、选品执行、评分算法）
  • AutoListingService 服务（配置管理、任务管理、批量上架、平台集成）
  • AI选品算法（评分/ROI预估/多维度权重）
  • 自动上架任务队列（BullMQ）
  • 前端 AutoProductSelection 页面（商品池管理、选品规则、上架任务、系统配置）
  • Mock架构实现（productSelection.mock.ts + productSelectionDataSource.ts）
  • 平台选择（1688/Amazon/TikTok/eBay/独立站）
  • 选品评分可视化（雷达图展示）
  • 上架任务实时监控

🟠 P1 - 高优先级功能

4. AI店铺托管（AutoPilot）🔥 ✅

状态: ✅ 已完成
优先级: P1 - 高
任务包: PKG-AUTOPILOT
预计开发时间: 20小时
实际完成时间: 2026-03-19

已完成:

  • AutoPilotService 服务
  • 托管调度器
  • 托管状态管理
  • 托管日志记录
  • 紧急停止机制
  • 前端 AutoPilot 控制台

5. 跨平台套利系统完善🔥 ✅

状态: ✅ 已完成
优先级: P1 - 高
任务包: PKG-ARBITRAGE
预计开发时间: 12小时
实际完成时间: 2026-03-19

已完成:

  • arbitrage_products 表结构
  • 自动价格对比
  • 自动上架TikTok
  • 套利ROI计算
  • 套利监控
  • 前端套利监控页面

6. AI动态定价系统完善🔥 ✅

状态: ✅ 已完成
优先级: P1 - 高
任务包: PKG-PRICING
预计开发时间: 16小时
实际完成时间: 2026-03-19

已完成:

  • 竞争对手价格监控
  • 博弈定价算法
  • 提价/降价策略
  • 定价决策日志
  • A/B测试定价
  • 前端动态定价控制面板

7. AI决策日志系统（全链路追溯）🔥 ✅

状态: ✅ 已完成
优先级: P1 - 高
任务包: PKG-AI-LOG
预计开发时间: 16小时
实际完成时间: 2026-03-20

目标: 实现"AI建议→人类确认→系统执行"全链路日志记录

已完成:

  • [BE-AILOG-001] cf_ai_decision_logs 表结构（包含输入/输出/执行结果/人工干预等字段）
  • [BE-AILOG-002] AIDecisionLogService 服务（创建日志、更新状态、记录人工干预）
  • [BE-AILOG-003] 日志查询功能（支持多维度筛选、分页）
  • [BE-AILOG-004] 日志统计功能（成功率、执行时间、类型分布）
  • [BE-AILOG-005] 决策链路追踪（通过trace_id查询完整链路）
  • [BE-AILOG-006] Redis缓存支持
  • [BE-AILOG-007] EventBus事件发布
  • [FE-AILOG-001] 日志查询页面（表格展示、筛选、分页）
  • [FE-AILOG-002] 统计面板（总决策数、成功率、趋势图、类型分布）
  • [FE-AILOG-003] 日志详情抽屉（基本信息、输入参数、决策选项、执行结果、人工干预）
  • [FE-AILOG-003] 日志统计仪表盘

技术要点:

  • 全链路ID关联 (operation_id, trace_id)
  • 日志类型分类 (AI建议/人工审核/系统执行)
  • 权限控制 (ADMIN/FINANCE可查看)
  • 数据脱敏 (敏感字段)

8. 多租户基础架构（商户→部门→店铺）🔥 ✅

状态: ✅ 已完成
优先级: P1 - 高
任务包: PKG-MULTI-TENANT-BASE
预计开发时间: 24小时
实际完成时间: 2026-03-20

目标: 实现商户→部门→店铺三层架构的数据隔离和权限控制

已完成:

  • [BE-MT001] DataIsolationService 服务（数据隔离查询构建、访问权限验证、层级节点管理）
  • [BE-MT001-01] 构建数据隔离查询条件（支持租户/部门/店铺三级隔离）
  • [BE-MT001-02] 验证数据访问权限（单条/批量验证）
  • [BE-MT001-03] 获取用户可见的层级节点列表
  • [BE-MT001-04] 构建层级树结构
  • [BE-MT002] HierarchyAuthMiddleware 中间件（层级权限认证、上下文构建）
  • [BE-MT002-01] 创建层级认证中间件
  • [BE-MT002-02] 构建数据隔离上下文
  • [BE-MT002-03] 验证层级选择器
  • [BE-MT002-04] 数据隔离查询包装器
  • [BE-MT002-05] 角色检查中间件
  • [BE-MT002-06] 权限检查中间件
  • [BE-MT002-07] HierarchyService 服务（层级结构管理、部门/店铺CRUD）
  • [FE-MT001] HierarchySelector 前端组件（三级联动选择器）
  • [FE-MT001-01] 支持Cascader/TreeSelect/Select三种模式
  • [FE-MT001-02] 支持商户→部门→店铺三级联动
  • [FE-MT001-03] 支持状态显示和平台标签

技术要点:

  • 三层架构：商户(TENANT) → 部门(DEPARTMENT) → 店铺(SHOP)
  • 数据隔离规则预定义（cf_product, cf_order, cf_customer等）
  • Redis缓存支持
  • EventBus事件发布
  • 软删除支持

9. AI决策自动化配置（渐进式演进）🔥 ✅ 🆕

状态: ✅ 已完成
优先级: P1 - 高
任务包: PKG-AI-AUTO
预计开发时间: 12小时
实际完成时间: 2026-03-19

已完成:

  • [BE-AIAUTO-001] cf_auto_execution_config 表结构
  • [BE-AIAUTO-002] AutoExecutionConfigService 服务
  • [BE-AIAUTO-003] 自动执行阈值校验中间件
  • [BE-AIAUTO-004] 自动化等级管理API
  • [FE-AIAUTO-001] 自动化配置页面
  • [FE-AIAUTO-002] 阈值配置表单
  • [FE-AIAUTO-003] 演进阶段展示

技术要点:

  • 自动化等级 (L1-L4)
  • 置信度阈值配置
  • 风险等级限制
  • 模块默认配置

🟡 P2 - 中优先级功能

实现这些功能后：

  • 📈 用户转化率: 提升 50%+
  • 💰 平台收益: 增加 100%+
  • 👥 用户留存率: 提高 30%+
  • 🤖 自动化运营: 实现 80%+

⚠️ AI Agent 必读文档清单

在开始任何任务之前，必须按顺序阅读以下文档：

优先级 文档 路径 必读原因
🔴 P0 项目规则 .trae/rules/project-specific-rules.md 硬性约束：表前缀cf_、金额decimal、五元组、命名规范
🔴 P0 业务闭环 docs/00_Business/Business_ClosedLoops.md 业务流程、决策点、数据库规范
🟠 P1 数据规格 docs/02_Backend/API_Specs/Data_API_Specs.md 表结构、字段定义、五元组追踪
🟠 P1 后端设计 docs/02_Backend/Backend_Design.md 服务架构、分层规则、安全约束
🟡 P2 插件设计 docs/04_Plugin/Plugin_Design.md 采集策略、通讯协议

关键规则速查：

数据库:
  - 表前缀: cf_ (如 cf_product, cf_order)
  - 金额字段: decimal(10,2) ❌禁止 float/double
  - 物理单位: 长度(cm), 重量(kg), 体积(m³)

追踪五元组 (所有业务表必须):
  - tenantId: 租户ID
  - shopId: 店铺ID  
  - taskId: 任务ID
  - traceId: 链路追踪ID
  - businessType: TOC | TOB

命名规范:
  - 服务类: XxxService ✅
  - ❌禁止: Manager, Helper, Util 后缀

安全约束:
  - ❌禁止: 后端网页爬取 (无API平台由插件处理)
  - ❌禁止: DROP, TRUNCATE 操作
  - 必须: PENDING_REVIEW 人工审核后执行

利润红线:
  - B2B < 15%: 禁止报价
  - B2C < 20%: 风控预警

📋 状态定义

状态 图标 描述 适用场景
pending ⏳ 未认领任务 新创建的任务
claimed 🔒 AI已认领，生成代码/配置中 AI正在处理任务
in_progress 🟡 运行/部署中 任务正在执行
completed ✅ 执行成功 任务完成并通过验证
failed ❌ 失败，触发自动修复或回滚 任务执行失败
blocked 🚫 被依赖任务阻塞 等待前置任务完成
retry 🔄 重试中 失败后正在重试

🔄 AI Agent 任务执行流程

┌─────────────────────────────────────────────────────────────┐
│  Step 1: 选择任务包（推荐）                                   │
│  ├── 查看 📦 任务包快速索引                                   │
│  ├── 检查目标任务状态是否为 ⬜ 待领取                         │
│  ├── 选择同一闭环的完整任务包                                 │
│  └── 或选择有依赖关系的任务链                                 │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  Step 2: 声明占用（强制）                                     │
│  ├── 将任务状态从 ⬜ 待领取 改为 🔒 AI-X（你的标识）          │
│  └── 直接编辑任务包表格中的"状态"列                           │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  Step 3: 阅读必读文档清单                                     │
│  ├── P0: project-specific-rules.md (硬性约束)                │
│  ├── P0: Business_ClosedLoops.md (业务流程)                  │
│  ├── P1: Data_API_Specs.md (表结构)                          │
│  └── P1: Backend_Design.md (服务架构)                        │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  Step 4: 连续执行任务包                                       │
│  ├── 遵循关键规则速查中的约束                                 │
│  ├── 参考已有代码风格                                         │
│  ├── 添加五元组追踪字段                                       │
│  └── 任务包内连续执行直到全部完成                             │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  Step 5: 验证代码                                             │
│  ├── 运行 TypeScript 编译检查                                │
│  ├── 检查是否违反硬性约束                                     │
│  └── 确认功能符合任务描述                                     │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  Step 6: 完成并释放占用                                       │
│  ├── 将任务状态从 🔒 AI-X 改为 ✅ 已完成                      │
│  └── 直接编辑任务包表格中的"状态"列                           │
└─────────────────────────────────────────────────────────────┘

⚠️ 重要提醒:

  1. 检查状态: 领取前确认任务状态为 ⬜ 待领取
  2. 优先领任务包: 推荐领取完整任务包，避免碎片化
  3. 声明占用: 直接修改任务状态列为 🔒 AI-X
  4. 完成后标记: 完成后将状态改为 ✅ 已完成
  5. 代码规范: 所有代码必须遵循关键规则速查中的约束

🎯 优先级定义

优先级 图标 描述 处理时效
P0 - 紧急 🔴 阻塞核心业务流程 立即处理
P1 - 高 🟠 影响重要功能 4小时内
P2 - 中 🟡 功能增强或优化 24小时内
P3 - 低 🟢 非关键功能 48小时内

📊 任务统计

模块 总任务数 已完成 进行中 待处理 失败 完成率
前端模块 54 54 0 0 0 100%
后端模块 144 144 0 0 0 100%
插件模块 14 14 0 0 0 100%
AI模块 20 20 0 0 0 100%
数据模块 12 12 0 0 0 100%
运维模块 21 21 0 0 0 100%
总计 265 265 0 0 0 100%

🚀 1️⃣ 前端模块（用户交互 / 状态展示）

1.1 商品管理前端

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-P001 商品刊登闭环 渲染商品列表页面 用户ID, 筛选条件 商品列表数据 页面加载 ✅ completed P1 - 4h AI-Frontend-1
FE-P002 商品刊登闭环 渲染商品详情页面 商品ID 商品详情数据 点击商品 ✅ completed P1 FE-P001 3h AI-Backend-9
FE-P003 商品刊登闭环 商品上架表单 商品基础信息 上架请求 点击上架 ✅ completed P1 FE-P002 2h AI-Backend-9
FE-P004 素材管理闭环 素材上传组件 文件对象 素材URL 选择文件 ✅ completed P2 FE-P002 1.5h AI-Backend-9
FE-P005 定价与利润决策闭环 商品ROI分析页面 商品ID, 时间范围 ROI分析数据 点击分析 ✅ completed P1 FE-P002 3h AI-Frontend-16
FE-P006 定价与利润决策闭环 AI智能定价功能 商品ID, 成本数据 建议售价 点击定价 ✅ completed P1 FE-P005 4h AI-Frontend-16
FE-P007 定价与利润决策闭环 商品利润监控面板 商品ID, 筛选条件 利润趋势数据 页面加载 ✅ completed P1 FE-P005 3h AI-Frontend-16

1.2 订单管理前端

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-O001 订单履约闭环 渲染订单列表页面 用户ID, 筛选条件 订单列表数据 页面加载 ✅ completed P0 - 3h AI-Frontend-9
FE-O002 订单履约闭环 渲染订单详情页面 订单ID 订单详情数据 点击订单 ✅ completed P1 FE-O001 2.5h AI-Frontend-9
FE-O003 订单集中管理闭环 多平台订单聚合展示 平台ID, 时间范围 聚合订单数据 页面加载 ✅ completed P1 FE-O001 2h AI-Frontend-9
FE-O004 异常订单处理闭环 异常订单处理界面 订单ID 处理结果 点击处理 ✅ completed P1 FE-O002 2h AI-Frontend-9

1.3 广告计划与营销前端【P0 阻塞核心业务】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-AD001 广告计划与营销闭环 广告计划管理页面 广告ID, 筛选条件 广告计划列表 页面加载 ✅ completed P0 - 12h AI-Frontend-4
FE-AD002 广告计划与营销闭环 广告投放界面 广告ID, 投放参数 投放结果 点击投放 ✅ completed P0 FE-AD001 10h AI-Frontend-4
FE-AD003 广告计划与营销闭环 ROI分析页面 广告ID, 时间范围 ROI报告 点击查看 ✅ completed P0 FE-AD001 8h AI-Frontend-4
FE-AD004 广告计划与营销闭环 AI广告优化功能 广告ID, 历史数据 优化建议 点击优化 ✅ completed P0 FE-AD003 10h AI-Frontend-16
FE-AD005 广告计划与营销闭环 自动调整策略配置 广告ID, 调整规则 配置结果 点击配置 ✅ completed P1 FE-AD004 8h AI-Frontend-16
FE-AD006 广告计划与营销闭环 广告效果监控面板 广告ID, 时间范围 实时效果数据 页面加载 ✅ completed P1 FE-AD003 8h AI-Frontend-16

1.4 售后逆向前端【P0 阻塞核心业务】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-SR001 售后逆向闭环 退货申请页面 订单ID, 退货原因 退货申请 点击退货 ✅ completed P0 - 10h AI-Frontend-5
FE-SR002 售后逆向闭环 退款处理界面 退款ID, 处理结果 退款记录 点击处理 ✅ completed P0 FE-SR001 8h AI-Frontend-5
FE-SR003 售后逆向闭环 售后客服界面 工单ID, 客服消息 客服记录 点击查看 ✅ completed P0 FE-SR001 12h AI-Frontend-5

1.11 素材管理前端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-MA001 素材管理闭环 素材管理页面 素材ID, 筛选条件 素材列表 页面加载 ✅ completed P1 - 8h AI-Frontend-1
FE-MA002 素材管理闭环 素材上传界面 文件对象 素材URL 选择文件 ✅ completed P1 FE-MA001 6h AI-Frontend-1
FE-MA003 素材管理闭环 素材审核界面 素材ID, 审核结果 审核状态 点击审核 ✅ completed P1 FE-MA001 6h AI-Frontend-1

1.12 资金对账前端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-FR001 资金对账闭环 对账管理页面 时间范围, 平台ID 对账列表 页面加载 ✅ completed P1 - 8h AI-Frontend-2
FE-FR002 资金对账闭环 对账详情界面 对账ID 对账详情 点击查看 ✅ completed P1 FE-FR001 6h AI-Frontend-2
FE-FR003 资金对账闭环 异常处理界面 对账ID, 处理结果 处理状态 点击处理 ✅ completed P1 FE-FR001 6h AI-Frontend-2

1.13 报表与分析前端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-RA001 报表与分析闭环 报表管理页面 报表类型, 筛选条件 报表列表 页面加载 ✅ completed P1 - 8h AI-Frontend-3
FE-RA002 报表与分析闭环 报表生成界面 报表参数 报表数据 点击生成 ✅ completed P1 FE-RA001 6h AI-Frontend-3
FE-RA003 报表与分析闭环 数据大屏界面 widgets 实时数据 页面加载 ✅ completed P1 FE-RA001 6h AI-Frontend-3

1.14 功能模块化与权限控制前端【P2 中优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-PM001 功能模块化与权限控制闭环 角色管理页面 角色ID, 筛选条件 角色列表 页面加载 ✅ completed P2 - 6h AI-Frontend-4
FE-PM002 功能模块化与权限控制闭环 权限管理界面 权限ID, 角色ID 权限分配 点击分配 ✅ completed P2 FE-PM001 6h AI-Frontend-4
FE-PM003 功能模块化与权限控制闭环 用户角色分配界面 用户ID, 角色ID 分配结果 点击分配 ✅ completed P2 FE-PM001 4h AI-Frontend-4

1.15 功能开通与支付前端【P2 中优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-FA001 功能开通与支付闭环 功能列表页面 功能ID, 筛选条件 功能列表 页面加载 ✅ completed P2 - 6h AI-Frontend-5
FE-FA002 功能开通与支付闭环 功能激活界面 功能ID, 支付信息 激活结果 点击激活 ✅ completed P2 FE-FA001 6h AI-Frontend-5
FE-FA003 功能开通与支付闭环 支付管理界面 支付ID, 状态 支付记录 点击查看 ✅ completed P2 FE-FA001 4h AI-Frontend-5

1.5 B2B / TOB 贸易前端【P0 阻塞核心业务】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-TOB001 B2B / TOB 贸易管理闭环 企业报价页面 客户ID, 商品ID 报价单 点击报价 ✅ completed P0 - 12h AI-Frontend-6
FE-TOB002 B2B / TOB 贸易管理闭环 批量订单界面 客户ID, 商品列表 批量订单 点击提交 ✅ completed P0 FE-TOB001 10h AI-Frontend-6
FE-TOB003 B2B / TOB 贸易管理闭环 合同管理页面 合同ID, 状态 合同详情 点击查看 ✅ completed P0 FE-TOB001 8h AI-Frontend-6

1.6 合规与证书管理前端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-COM001 合规与证书管理闭环 证书管理页面 证书ID, 筛选条件 证书列表 页面加载 ✅ completed P1 - 10h AI-Backend-8
FE-COM002 合规与证书管理闭环 合规检查界面 商品ID, 平台ID 合规结果 点击检查 ✅ completed P1 FE-COM001 8h AI-Backend-8
FE-COM003 合规与证书管理闭环 证书到期提醒 证书ID, 到期时间 提醒通知 定时触发 ✅ completed P1 FE-COM001 6h AI-Backend-8

1.7 物流策略与渠道选择前端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-LOG001 物流策略与渠道选择闭环 物流选择界面 订单ID, 目的地 物流方案 点击选择 ✅ completed P1 - 8h AI-Frontend-4
FE-LOG002 物流策略与渠道选择闭环 物流跟踪页面 订单ID, 物流单号 物流信息 点击跟踪 ✅ completed P1 FE-LOG001 6h AI-Frontend-4
FE-LOG003 物流策略与渠道选择闭环 运费计算页面 商品ID, 数量, 目的地 运费报价 点击计算 ✅ completed P1 FE-LOG001 6h AI-Frontend-4

1.8 用户/客户资产前端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-UA001 用户/客户资产闭环 用户资产页面 用户ID, 筛选条件 资产数据 页面加载 ✅ completed P1 - 8h AI-Frontend-7
FE-UA002 用户/客户资产闭环 积分管理界面 用户ID, 积分操作 积分记录 点击操作 ✅ completed P1 FE-UA001 6h AI-Frontend-7
FE-UA003 用户/客户资产闭环 会员等级页面 用户ID, 等级 会员权益 点击查看 ✅ completed P1 FE-UA001 6h AI-Frontend-7

1.9 A/B测试与策略优化前端【P2 中优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-AB001 A/B测试与策略优化闭环 A/B测试配置页面 测试ID, 参数 配置结果 点击配置 ✅ completed P2 - 6h AI-Frontend-11
FE-AB002 A/B测试与策略优化闭环 测试结果展示 测试ID, 时间范围 测试报告 点击查看 ✅ completed P2 FE-AB001 6h AI-Frontend-11

1.10 认证服务前端【P2 中优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-AUTH001 认证服务 登录页面 用户名, 密码 登录结果 点击登录 ✅ completed P2 - 6h AI-Backend-10
FE-AUTH002 认证服务 注册页面 用户信息 注册结果 点击注册 ✅ completed P2 FE-AUTH001 6h AI-Backend-10
FE-AUTH003 认证服务 密码重置页面 用户名, 新密码 重置结果 点击重置 ✅ completed P2 FE-AUTH001 4h AI-Backend-10

1.16 多商户管理前端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-MV001 多商户入驻闭环 商户管理页面 商户ID, 筛选条件 商户列表 页面加载 ✅ completed P1 - 10h AI-Frontend-12
FE-MV002 多商户入驻闭环 商户店铺管理页面 商户ID, 店铺信息 店铺列表 页面加载 ✅ completed P1 FE-MV001 8h AI-Frontend-12
FE-MV003 多商户订单闭环 多商户订单管理页面 商户ID, 订单状态 订单列表 页面加载 ✅ completed P1 FE-MV001 8h AI-Frontend-12
FE-MV004 多商户结算闭环 多商户结算管理页面 商户ID, 结算周期 结算列表 页面加载 ✅ completed P1 FE-MV001 8h AI-Frontend-12

1.17 前端优化与性能提升【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-OP001 前端优化闭环 前端组件化设计与实现 组件需求, UI设计 组件库 开发需求 ✅ completed P1 - 10h AI-Frontend-16
FE-OP002 前端优化闭环 前端状态管理优化 状态需求, 数据流 状态管理方案 开发需求 ✅ completed P1 FE-OP001 8h AI-Frontend-16
FE-OP003 前端优化闭环 前端性能优化 性能瓶颈, 用户体验 优化方案 性能测试 ✅ completed P1 FE-OP001 10h AI-Frontend-16
FE-OP004 前端优化闭环 前端响应式布局 多终端需求, 设计规范 响应式实现 设计需求 ✅ completed P2 FE-OP001 8h AI-Frontend-16

1.18 系统集成测试前端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-IT001 系统集成测试闭环 前后端集成测试 接口文档, 测试用例 测试结果 开发完成 ✅ completed P1 - 8h AI-Test-15
FE-IT002 系统集成测试闭环 前端功能测试 功能需求, 测试用例 测试结果 开发完成 ✅ completed P1 FE-IT001 6h AI-Test-15

1.19 文档优化前端【P2 中优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-DOC001 文档优化闭环 前端设计文档优化 设计规范, 代码结构 优化文档 开发完成 ✅ completed P2 - 6h AI-Frontend-16
FE-DOC002 文档优化闭环 UI组件文档优化 组件库, 使用示例 优化文档 开发完成 ✅ completed P2 FE-DOC001 4h AI-Frontend-16
FE-DOC003 文档优化闭环 页面流转文档优化 路由配置, 交互流程 优化文档 开发完成 ✅ completed P2 FE-DOC001 4h AI-Frontend-16
FE-DOC004 文档优化闭环 前端优化指南 性能优化, 交互优化 优化文档 开发完成 ✅ completed P2 FE-DOC001 6h AI-Frontend-16

1.20 前端骨架搭建【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-SK001 前端骨架闭环 菜单结构搭建 菜单配置, 路由定义 菜单组件 开发需求 ✅ completed P1 - 8h AI-Frontend-17
FE-SK002 前端骨架闭环 Dashboard页面骨架 页面设计, KPI指标 Dashboard页面 FE-SK001 ✅ completed P1 FE-SK001 10h AI-Frontend-17
FE-SK003 前端骨架闭环 Product页面骨架 页面设计, 表格结构 Product页面 FE-SK001 ✅ completed P1 FE-SK001 10h AI-Frontend-17
FE-SK004 前端骨架闭环 Orders页面骨架 页面设计, 表格结构 Orders页面 FE-SK001 ✅ completed P1 FE-SK001 10h AI-Frontend-17
FE-SK005 前端骨架闭环 统一组件库搭建 设计规范, 组件需求 组件库 FE-SK001 ✅ completed P1 FE-SK001 12h AI-Frontend-17

1.21 前端交互优化【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-INT001 前端交互闭环 商品价格修改交互 商品ID, 价格 价格更新 点击修改 ✅ completed P1 FE-SK003 8h AI-Frontend-17
FE-INT002 前端交互闭环 AI定价功能交互 商品ID, 成本数据 定价建议 点击定价 ✅ completed P1 FE-SK003 10h AI-Frontend-17
FE-INT003 前端交互闭环 订单处理交互 订单ID, 状态 状态更新 点击处理 ✅ completed P1 FE-SK004 8h AI-Frontend-17
FE-INT004 前端交互闭环 统一交互规范实现 交互设计, 用户体验 交互组件 开发需求 ✅ completed P1 FE-SK005 10h AI-Frontend-17

1.22 独立站管理前端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-IS001 独立站管理闭环 独立站列表页面 站点ID, 筛选条件 站点列表 页面加载 ✅ completed P1 FE-SK001 10h AI-Frontend-18
FE-IS002 独立站管理闭环 独立站创建页面 站点信息, 配置 创建结果 点击创建 ✅ completed P1 FE-IS001 12h AI-Frontend-18
FE-IS003 独立站管理闭环 独立站配置页面 站点ID, 配置参数 配置结果 点击配置 ✅ completed P1 FE-IS001 12h AI-Frontend-18
FE-IS004 独立站管理闭环 独立站商品管理页面 站点ID, 商品信息 商品列表 页面加载 ✅ completed P1 FE-IS001 10h AI-Frontend-18
FE-IS005 独立站管理闭环 独立站订单管理页面 站点ID, 订单信息 订单列表 页面加载 ✅ completed P1 FE-IS001 10h AI-Frontend-18
FE-IS006 独立站管理闭环 独立站数据分析页面 站点ID, 时间范围 分析报告 点击分析 ✅ completed P1 FE-IS001 12h AI-Frontend-18
FE-INT002 前端交互闭环 AI定价功能交互 商品数据, 市场数据 AI定价功能 FE-SK003 ✅ completed P1 FE-SK003 8h AI-Frontend-17
FE-INT003 前端交互闭环 订单处理交互 订单数据, 状态管理 订单处理功能 FE-SK004 ✅ completed P1 FE-SK004 8h AI-Frontend-17
FE-INT004 前端交互闭环 统一交互规范实现 交互设计, 用户体验 交互规范实现 FE-SK005 ✅ completed P1 FE-SK005 10h AI-Frontend-17

前端缺失任务补充

1.23 商户管理前端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-MV001 多商户管理闭环 商户管理页面 商户ID, 筛选条件 商户列表 页面加载 ✅ completed P1 FE-SK001 10h AI-Frontend-19
FE-MV002 多商户管理闭环 商户订单管理页面 商户ID, 订单信息 订单列表 页面加载 ✅ completed P1 FE-MV001 10h AI-Frontend-19
FE-MV003 多商户管理闭环 商户结算管理页面 商户ID, 结算信息 结算列表 页面加载 ✅ completed P1 FE-MV001 10h AI-Frontend-19
FE-MV004 多商户管理闭环 商户店铺管理页面 商户ID, 店铺信息 店铺列表 页面加载 ✅ completed P1 FE-MV001 10h AI-Frontend-19

1.24 售后服务前端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-SR001 售后逆向闭环 退货申请页面 订单ID, 退货原因 退货申请 点击申请 ✅ 已完成 P1 FE-SK001 10h AI-Frontend-20
FE-SR002 售后逆向闭环 退款流程页面 退款ID, 退款金额 退款处理 点击处理 ✅ 已完成 P1 FE-SR001 10h AI-Frontend-20
FE-SR003 售后逆向闭环 客户服务页面 客户ID, 服务类型 服务记录 点击服务 ✅ 已完成 P1 FE-SR001 10h AI-Frontend-20

1.25 物流管理前端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-LOG001 物流策略闭环 物流选择页面 订单ID, 物流参数 物流选项 点击选择 ✅ 已完成 P1 FE-SK001 10h AI-Frontend-21
FE-LOG002 物流策略闭环 运费计算页面 订单ID, 重量信息 运费结果 点击计算 ✅ 已完成 P1 FE-LOG001 10h AI-Frontend-21
FE-LOG003 物流策略闭环 物流追踪页面 物流单号, 追踪信息 追踪状态 点击追踪 ✅ 已完成 P1 FE-LOG001 10h AI-Frontend-21

1.26 黑名单管理前端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-BL001 恶意买家黑名单闭环 黑名单管理页面 黑名单ID, 筛选条件 黑名单列表 页面加载 ✅ completed P1 FE-SK001 10h AI-Frontend-22
FE-BL002 恶意买家黑名单闭环 风险监控页面 风险ID, 监控参数 风险报告 点击监控 ✅ completed P1 FE-BL001 10h AI-Frontend-22

1.27 营销管理前端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-MK001 营销管理闭环 竞争对手分析页面 竞品ID, 分析参数 竞品分析 点击分析 ✅ completed P1 FE-SK001 10h AI-Frontend-23
FE-MK002 营销管理闭环 营销活动管理页面 活动ID, 营销参数 活动列表 页面加载 ✅ completed P1 FE-MK001 10h AI-Frontend-23

1.28 供应商管理前端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-SP001 供应商管理闭环 供应商详情页面 供应商ID, 交易记录 供应商详情 点击查看 ✅ completed P1 FE-SK001 10h AI-Frontend-24

1.29 报表中心前端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-RP001 报表与分析闭环 利润报表页面 时间范围, 报表参数 利润报表 点击生成 ✅ completed P1 FE-SK001 10h AI-Frontend-25
FE-RP002 报表与分析闭环 绩效报表页面 时间范围, 绩效参数 绩效报表 点击生成 ✅ completed P1 FE-RP001 10h AI-Frontend-25

1.30 A/B测试前端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-AB001 A/B测试与策略优化闭环 A/B测试配置页面 测试参数, 流量分配 测试配置 点击配置 ✅ completed P1 FE-SK001 10h AI-Frontend-26
FE-AB002 A/B测试与策略优化闭环 测试结果分析页面 测试ID, 结果数据 结果报告 点击分析 ✅ completed P1 FE-AB001 10h AI-Frontend-26

1.31 退货管理前端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-RT001 高退货率SKU闭环 退货监控页面 SKU ID, 退货数据 退货统计 点击监控 ✅ completed P1 FE-SK001 10h AI-Frontend-27
FE-RT002 高退货率SKU闭环 SKU管理页面 SKU ID, 管理参数 SKU列表 点击管理 ✅ completed P1 FE-RT001 10h AI-Frontend-27

1.32 用户资产管理前端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-UA001 用户资产闭环 会员等级管理页面 会员ID, 等级参数 等级列表 页面加载 ✅ completed P1 FE-SK001 10h AI-Frontend-28
FE-UA002 用户资产闭环 积分管理页面 用户ID, 积分数据 积分列表 点击管理 ✅ completed P1 FE-UA001 10h AI-Frontend-28
FE-UA003 用户资产闭环 用户资产页面 用户ID, 资产数据 资产统计 点击查看 ✅ completed P1 FE-UA001 10h AI-Frontend-28











🔧 2️⃣ 后端模块（业务逻辑 / 数据处理）

2.1 商品管理后端

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-P001 商品主数据闭环 商品主数据管理接口 商品基础信息 商品ID, 状态 前端提交 ✅ completed P0 - 2h AI-Backend-1
BE-P002 SKU变体与结构闭环 SKU变体管理接口 商品ID, 变体属性 SKU ID, 库存 前端提交 ✅ completed P1 BE-P001 1.5h AI-Backend-1
BE-P003 商品刊登闭环 商品刊登接口 商品ID, 平台ID 刊登结果 前端提交 ✅ completed P0 BE-P001 2h AI-Backend-2
BE-P004 定价与利润决策闭环 动态定价计算接口 商品ID, 市场数据 建议售价 定时触发 ✅ completed P1 BE-P001 2.5h AI-Backend-2
BE-P005 数据采集与清洗闭环 平台API对接服务(Amazon MWS) API凭证, 商品ASIN 商品数据 定时任务 ✅ completed P0 BE-P001 8h AI-Backend-2

2.20 文档优化后端【P2 中优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-DOC001 文档优化闭环 服务设计文档优化 服务架构, 业务流程 优化文档 开发完成 ✅ completed P2 - 6h AI-Backend-16
BE-DOC002 文档优化闭环 数据一致性文档 事务边界, 幂等性 优化文档 开发完成 ✅ completed P2 BE-DOC001 4h AI-Backend-16
BE-DOC003 文档优化闭环 可观测性文档 日志, 追踪, 监控 优化文档 开发完成 ✅ completed P2 BE-DOC001 4h AI-Backend-16
BE-DOC004 文档优化闭环 权限系统文档 RBAC, 数据级权限 优化文档 开发完成 ✅ completed P2 BE-DOC001 4h AI-Backend-16
BE-DOC005 文档优化闭环 配置驱动文档 系统参数, 可配置性 优化文档 开发完成 ✅ completed P2 BE-DOC001 4h AI-Backend-16
BE-DOC006 文档优化闭环 事件驱动文档 核心事件, 处理流程 优化文档 开发完成 ✅ completed P2 BE-DOC001 4h AI-Backend-16
📋 BE-P006/BE-P007 任务详情卡片

任务目标: 在 PlatformApiService.ts 中实现 eBay/Shopee API 对接

参考文件:

  • 主文件: server/src/services/PlatformApiService.ts
  • 参考实现: syncAmazonProducts() 方法
  • Worker: server/src/workers/PlatformSyncWorker.ts

实现要求:

// 在 PlatformApiService 类中添加以下方法：
private static async syncEbayProducts(config, options): Promise<ProductSyncResult[]>
private static async syncEbayOrders(config, options): Promise<OrderSyncResult[]>
private static async syncShopeeProducts(config, options): Promise<ProductSyncResult[]>
private static async syncShopeeOrders(config, options): Promise<OrderSyncResult[]>

约束条件:

  1. 所有方法必须携带五元组: tenantId, shopId, taskId, traceId, businessType
  2. 使用 logger.info() 记录日志，包含 traceId
  3. API 调用失败时记录错误并抛出异常
  4. 遵守 RATE_LIMITS 中定义的限流规则

验收标准:

  • 方法签名与 Amazon 实现一致
  • 日志包含五元组信息
  • 错误处理完整
  • 通过 TypeScript 编译
| BE-P008 | 数据采集与清洗闭环 | 平台同步Worker(BullMQ) | 同步任务, 五元组 | 同步结果 | 队列触发 | ✅ completed | P0 | BE-P005 | 4h | AI-Backend-2 |

2.2 订单管理后端

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-O001 订单履约闭环 订单创建接口 用户ID, 商品ID, 数量 订单ID, 状态 前端提交 ✅ completed P0 BE-P001 2h AI-Backend-1
BE-O002 订单集中管理闭环 多平台订单归集接口 平台账号, 时间范围 订单数据 定时任务 ✅ completed P0 BE-O001 3h AI-Backend-3
BE-O003 订单拆分与合并闭环 订单拆分逻辑 订单ID, 拆分规则 子订单列表 库存不足 ✅ completed P1 BE-O001 2h AI-Backend-3
BE-O004 异常订单处理闭环 异常订单识别与处理 订单ID 处理结果 定时扫描 ✅ completed P1 BE-O001 2.5h AI-Backend-2

2.3 财务管理后端

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-F001 资金对账闭环 对账接口 时间范围, 平台ID 对账结果 定时任务 ✅ completed P0 BE-O001 2h AI-Backend-2
BE-F002 回款与财务闭环 回款管理接口 订单ID, 回款金额 回款记录 回款事件 ✅ completed P1 BE-F001 1.5h AI-Backend-2
BE-F003 利润核算闭环 利润计算接口 订单ID, 成本数据 利润数据 订单完成 ✅ completed P1 BE-F001 2h AI-Backend-3

2.4 库存管理后端

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

2.5 用户与账户管理后端

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-U001 客户/商家押金闭环 押金管理接口 客户ID, 金额 押金余额 押金操作 ✅ completed P1 BE-O001 1.5h AI-Backend-2
BE-U002 用户/客户资产闭环 用户资产统计 用户ID 资产数据 定时任务 ✅ completed P2 BE-U001 2h AI-Backend-2

2.6 治理与风控后端

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-G001 治理与审批中心闭环 审批流程引擎 审批类型, 数据 审批结果 审批请求 ✅ completed P1 BE-O001 2.5h AI-Backend-3
BE-G002 合规与风控闭环 风控规则引擎 订单ID, 用户ID 风险评分 订单创建 ✅ completed P0 BE-O001 2h AI-Backend-2
BE-G003 账号/店铺健康度闭环 健康度监控 店铺ID 健康度评分 定时任务 ✅ completed P1 BE-G002 2h AI-Backend-3

2.8 安全测试【P2 中优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-SE001 安全测试闭环 接口安全测试 API接口, 测试参数 测试报告 手动触发 ✅ completed P2 BE-G002 8h AI-Backend-1
BE-SE002 安全测试闭环 数据传输加密 传输数据, 加密算法 加密结果 手动触发 ✅ completed P2 BE-SE001 8h AI-Backend-1
BE-SE003 安全测试闭环 权限控制测试 用户角色, 权限矩阵 测试报告 手动触发 ✅ completed P2 BE-SE001 8h AI-Backend-1

2.7 广告计划与营销后端【P0 阻塞核心业务】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-AD001 广告计划与营销闭环 广告计划创建接口 广告参数 广告ID 前端提交 ✅ completed P0 - 12h AI-Backend-4
BE-AD002 广告计划与营销闭环 广告投放引擎 广告ID, 投放参数 投放状态 定时任务 ✅ completed P0 BE-AD001 16h AI-Backend-4
BE-AD003 广告计划与营销闭环 ROI计算接口 广告ID, 时间范围 ROI数据 定时任务 ✅ completed P0 BE-AD001 10h AI-Backend-4

2.8 素材管理后端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-MA001 素材管理闭环 素材创建接口 素材信息 素材ID 前端提交 ✅ completed P1 - 4h AI-Backend-6
BE-MA002 素材管理闭环 素材更新接口 素材ID, 素材信息 更新结果 前端提交 ✅ completed P1 BE-MA001 3h AI-Backend-6
BE-MA003 素材管理闭环 素材审核接口 素材ID, 审核结果 审核状态 前端提交 ✅ completed P1 BE-MA001 3h AI-Backend-6

2.9 资金对账后端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-FR001 资金对账闭环 对账创建接口 对账信息 对账ID 定时任务 ✅ completed P1 - 4h AI-Backend-7
BE-FR002 资金对账闭环 对账处理接口 对账ID, 处理结果 处理状态 前端提交 ✅ completed P1 BE-FR001 3h AI-Backend-7
BE-FR003 资金对账闭环 对账查询接口 对账ID 对账详情 前端查询 ✅ completed P1 BE-FR001 3h AI-Backend-7

2.10 报表与分析后端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-RA001 报表与分析闭环 报表创建接口 报表参数 报表ID 前端提交 ✅ completed P1 - 4h AI-Backend-8
BE-RA002 报表与分析闭环 报表数据生成接口 报表ID 报表数据 定时任务 ✅ completed P1 BE-RA001 6h AI-Backend-8
BE-RA003 报表与分析闭环 数据大屏生成接口 widgets 大屏数据 前端请求 ✅ completed P1 BE-RA001 4h AI-Backend-8

2.11 功能模块化与权限控制后端【P2 中优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-PM001 功能模块化与权限控制闭环 角色管理接口 角色信息 角色ID 前端提交 ✅ completed P2 - 4h AI-Backend-9
BE-PM002 功能模块化与权限控制闭环 权限管理接口 权限信息 权限ID 前端提交 ✅ completed P2 - 4h AI-Backend-9
BE-PM003 功能模块化与权限控制闭环 权限检查接口 用户ID, 资源, 操作 检查结果 前端请求 ✅ completed P2 BE-PM001 3h AI-Backend-9

2.12 功能开通与支付后端【P2 中优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-FA001 功能开通与支付闭环 功能激活接口 功能ID, 支付信息 激活ID 前端提交 ✅ completed P2 - 4h AI-Backend-10
BE-FA002 功能开通与支付闭环 支付处理接口 支付ID 支付状态 支付回调 ✅ completed P2 BE-FA001 4h AI-Backend-10
BE-FA003 功能开通与支付闭环 功能续费接口 激活ID 续费结果 前端提交 ✅ completed P2 BE-FA001 3h AI-Backend-10
📋 BE-AD001/BE-AD002/BE-AD003 任务详情卡片

任务目标: 实现广告计划管理、投放引擎和ROI计算

参考文件:

  • 服务文件: server/src/services/AdPlanService.ts (需创建)
  • 数据模型: server/src/models/AdPlan.ts, server/src/models/AdCampaign.ts
  • Worker: server/src/workers/AdSyncWorker.ts

数据库表设计:

-- cf_ad_plan 广告计划表
CREATE TABLE cf_ad_plan (
  id VARCHAR(36) PRIMARY KEY,
  tenant_id VARCHAR(36) NOT NULL,
  shop_id VARCHAR(36) NOT NULL,
  name VARCHAR(255) NOT NULL,
  platform ENUM('AMAZON','EBAY','SHOPEE','TIKTOK'),
  budget DECIMAL(10,2) NOT NULL,
  start_date DATE,
  end_date DATE,
  status ENUM('DRAFT','ACTIVE','PAUSED','COMPLETED'),
  trace_id VARCHAR(64),
  created_at DATETIME,
  updated_at DATETIME
);

-- cf_ad_campaign 广告活动表
CREATE TABLE cf_ad_campaign (
  id VARCHAR(36) PRIMARY KEY,
  ad_plan_id VARCHAR(36) NOT NULL,
  product_id VARCHAR(36),
  bid_amount DECIMAL(10,2),
  clicks INT DEFAULT 0,
  impressions INT DEFAULT 0,
  spend DECIMAL(10,2) DEFAULT 0,
  sales DECIMAL(10,2) DEFAULT 0,
  trace_id VARCHAR(64),
  created_at DATETIME,
  updated_at DATETIME
);

实现要求:

// AdPlanService.ts
export class AdPlanService {
  // BE-AD001: 创建广告计划
  static async createAdPlan(params: CreateAdPlanParams): Promise<AdPlan>;
  
  // BE-AD002: 广告投放引擎
  static async executeAdCampaign(adPlanId: string, options: ExecuteOptions): Promise<CampaignResult>;
  
  // BE-AD003: ROI计算
  static async calculateROI(adPlanId: string, dateRange: DateRange): Promise<ROIData>;
}

约束条件:

  1. 所有金额字段使用 decimal(10,2)
  2. 必须携带五元组追踪
  3. ROI计算公式: ROI = (销售额 - 广告花费) / 广告花费 * 100%
  4. 广告花费超过预算时触发 PENDING_REVIEW

验收标准:

  • 数据库表已创建（带 cf_ 前缀）
  • 服务类命名符合规范（XxxService）
  • 日志包含五元组信息
  • ROI计算精度正确（保留2位小数）

2.8 售后逆向后端【P0 阻塞核心业务】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-SR001 售后逆向闭环 退货处理接口 订单ID, 退货原因 退货ID 前端提交 ✅ completed P0 - 12h AI-Backend-5
BE-SR002 售后逆向闭环 退款流程引擎 退货ID, 审批结果 退款状态 审批完成 ✅ completed P0 BE-SR001 14h AI-Backend-5
BE-SR003 售后逆向闭环 售后工单系统 退货ID, 工单信息 工单ID 退货创建 ✅ completed P0 BE-SR001 16h AI-Backend-5
📋 BE-SR001/BE-SR002/BE-SR003 任务详情卡片

任务目标: 实现退货处理、退款流程和售后工单系统

参考文件:

  • 服务文件: server/src/services/AfterSalesService.ts (需创建)
  • 数据模型: server/src/models/ReturnOrder.ts, server/src/models/RefundRecord.ts, server/src/models/ServiceTicket.ts

数据库表设计:

-- cf_return_order 退货订单表
CREATE TABLE cf_return_order (
  id VARCHAR(36) PRIMARY KEY,
  tenant_id VARCHAR(36) NOT NULL,
  shop_id VARCHAR(36) NOT NULL,
  order_id VARCHAR(36) NOT NULL,
  return_reason VARCHAR(500),
  return_type ENUM('REFUND_ONLY','RETURN_REFUND','EXCHANGE'),
  status ENUM('SUBMITTED','PENDING_REVIEW','APPROVED','REJECTED','COMPLETED'),
  refund_amount DECIMAL(10,2),
  trace_id VARCHAR(64),
  task_id VARCHAR(36),
  business_type ENUM('TOC','TOB'),
  created_at DATETIME,
  updated_at DATETIME
);

-- cf_refund_record 退款记录表
CREATE TABLE cf_refund_record (
  id VARCHAR(36) PRIMARY KEY,
  return_order_id VARCHAR(36) NOT NULL,
  refund_amount DECIMAL(10,2) NOT NULL,
  refund_method VARCHAR(50),
  status ENUM('PENDING','PROCESSING','COMPLETED','FAILED'),
  trace_id VARCHAR(64),
  created_at DATETIME
);

-- cf_service_ticket 售后工单表
CREATE TABLE cf_service_ticket (
  id VARCHAR(36) PRIMARY KEY,
  return_order_id VARCHAR(36) NOT NULL,
  ticket_type ENUM('RETURN','REFUND','COMPLAINT','OTHER'),
  priority ENUM('LOW','MEDIUM','HIGH','URGENT'),
  status ENUM('OPEN','IN_PROGRESS','RESOLVED','CLOSED'),
  assignee_id VARCHAR(36),
  trace_id VARCHAR(64),
  created_at DATETIME,
  updated_at DATETIME
);

实现要求:

// AfterSalesService.ts
export class AfterSalesService {
  // BE-SR001: 退货处理
  static async createReturnOrder(params: CreateReturnParams): Promise<ReturnOrder>;
  static async getReturnOrder(returnId: string): Promise<ReturnOrder>;
  
  // BE-SR002: 退款流程引擎
  static async processRefund(returnId: string, approvalResult: ApprovalResult): Promise<RefundStatus>;
  
  // BE-SR003: 售后工单系统
  static async createServiceTicket(returnId: string, ticketInfo: TicketInfo): Promise<ServiceTicket>;
  static async updateTicketStatus(ticketId: string, status: TicketStatus): Promise<void>;
}

约束条件:

  1. 退款金额必须使用 decimal(10,2)
  2. 退款状态必须走 SUBMITTED -> PENDING_REVIEW -> APPROVED/REJECTED 流程
  3. 所有操作必须记录审计日志
  4. 退款超过阈值需人工审核

验收标准:

  • 数据库表已创建（带 cf_ 前缀）
  • 状态机流程正确
  • 五元组字段完整
  • 退款金额精度正确

2.9 B2B / TOB 贸易后端【P0 阻塞核心业务】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-TOB001 B2B / TOB 贸易管理闭环 阶梯价计算接口 商品ID, 数量 阶梯价 前端请求 ✅ completed P0 - 12h AI-Backend-6
BE-TOB002 B2B / TOB 贸易管理闭环 批量订单处理 客户ID, 商品列表 批量订单ID 前端提交 ✅ completed P0 BE-TOB001 16h AI-Backend-6
BE-TOB003 B2B / TOB 贸易管理闭环 账期管理 客户ID, 账期设置 账期记录 前端提交 ✅ completed P0 BE-TOB001 10h AI-Backend-6
📋 BE-TOB001/BE-TOB002/BE-TOB003 任务详情卡片

任务目标: 实现B2B阶梯价计算、批量订单处理和账期管理

参考文件:

  • 服务文件: server/src/services/B2BTradeService.ts (需创建)
  • 定价服务: server/src/services/PricingService.ts
  • 数据模型: server/src/models/B2BCustomer.ts, server/src/models/TieredPrice.ts, server/src/models/BatchOrder.ts

数据库表设计:

-- cf_b2b_customer B2B客户表
CREATE TABLE cf_b2b_customer (
  id VARCHAR(36) PRIMARY KEY,
  tenant_id VARCHAR(36) NOT NULL,
  company_name VARCHAR(255) NOT NULL,
  contact_name VARCHAR(100),
  credit_limit DECIMAL(12,2) DEFAULT 0,
  credit_used DECIMAL(12,2) DEFAULT 0,
  payment_terms INT DEFAULT 30, -- 账期天数
  tier_level ENUM('BRONZE','SILVER','GOLD','PLATINUM'),
  status ENUM('ACTIVE','SUSPENDED','INACTIVE'),
  trace_id VARCHAR(64),
  created_at DATETIME,
  updated_at DATETIME
);

-- cf_tiered_price 阶梯价格表
CREATE TABLE cf_tiered_price (
  id VARCHAR(36) PRIMARY KEY,
  product_id VARCHAR(36) NOT NULL,
  min_quantity INT NOT NULL,
  max_quantity INT,
  price DECIMAL(10,2) NOT NULL,
  discount_percent DECIMAL(5,2) DEFAULT 0,
  tenant_id VARCHAR(36) NOT NULL,
  trace_id VARCHAR(64),
  created_at DATETIME
);

-- cf_batch_order 批量订单表
CREATE TABLE cf_batch_order (
  id VARCHAR(36) PRIMARY KEY,
  tenant_id VARCHAR(36) NOT NULL,
  customer_id VARCHAR(36) NOT NULL,
  total_amount DECIMAL(12,2) NOT NULL,
  payment_status ENUM('PENDING','PARTIAL','PAID','OVERDUE'),
  due_date DATE,
  trace_id VARCHAR(64),
  task_id VARCHAR(36),
  business_type ENUM('TOB') DEFAULT 'TOB',
  created_at DATETIME,
  updated_at DATETIME
);

实现要求:

// B2BTradeService.ts
export class B2BTradeService {
  // BE-TOB001: 阶梯价计算
  static async calculateTieredPrice(
    productId: string, 
    quantity: number,
    customerId: string
  ): Promise<TieredPriceResult>;
  
  // BE-TOB002: 批量订单处理
  static async createBatchOrder(
    customerId: string,
    items: BatchOrderItem[]
  ): Promise<BatchOrder>;
  
  // BE-TOB003: 账期管理
  static async setPaymentTerms(
    customerId: string,
    terms: PaymentTermsConfig
  ): Promise<PaymentTerms>;
  static async checkCreditLimit(customerId: string): Promise<CreditStatus>;
}

约束条件:

  1. 利润红线: B2B利润率 < 15% 禁止报价
  2. 所有金额使用 decimal(10,2) 或 decimal(12,2)
  3. 账期超期自动标记为 OVERDUE
  4. 信用额度检查必须在下单前执行

验收标准:

  • 阶梯价计算逻辑正确
  • 利润红线校验已实现
  • 五元组字段完整
  • 信用额度检查已实现

2.10 合规与证书管理后端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-COM001 合规与证书管理闭环 证书存储接口 证书信息 证书ID 前端提交 ✅ completed P1 - 12h AI-Backend-7
BE-COM002 合规与证书管理闭环 合规检查引擎 商品ID, 平台ID 合规结果 前端请求 ✅ completed P1 BE-COM001 14h AI-Backend-7
BE-COM003 合规与证书管理闭环 证书更新提醒 证书ID, 到期时间 提醒通知 定时任务 ✅ completed P1 BE-COM001 8h AI-Backend-7

2.11 物流策略与渠道选择后端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-LOG001 物流策略与渠道选择闭环 物流策略引擎 订单ID, 目的地 物流方案 订单创建 ✅ completed P1 - 14h AI-Backend-8
BE-LOG002 物流策略与渠道选择闭环 渠道选择算法 订单ID, 物流方案 渠道ID 订单创建 ✅ completed P1 BE-LOG001 12h AI-Backend-8
BE-LOG003 物流策略与渠道选择闭环 运费计算接口 商品ID, 数量, 目的地 运费 前端请求 ✅ completed P1 BE-LOG001 10h AI-Backend-8

2.12 用户/客户资产后端【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-UA001 用户/客户资产闭环 用户资产计算接口 用户ID 资产数据 前端请求 ✅ completed P1 - 10h AI-Backend-7
BE-UA002 用户/客户资产闭环 积分管理引擎 用户ID, 积分操作 积分记录 前端提交 ✅ completed P1 BE-UA001 10h AI-Backend-7
BE-UA003 用户/客户资产闭环 会员等级系统 用户ID, 等级规则 等级信息 定时任务 ✅ completed P1 BE-UA001 12h AI-Backend-7

2.13 A/B测试与策略优化后端【P2 中优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-AB001 A/B测试与策略优化闭环 A/B测试引擎 测试ID, 参数 测试实例 前端提交 ✅ completed P2 - 12h AI-Backend-4
BE-AB002 A/B测试与策略优化闭环 流量分配算法 测试ID, 用户ID 实验组 用户访问 ✅ completed P2 BE-AB001 10h AI-Backend-4
BE-AB003 A/B测试与策略优化闭环 效果统计接口 测试ID, 时间范围 统计结果 定时任务 ✅ completed P2 BE-AB001 8h AI-Backend-4

2.14 认证服务后端【P2 中优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-AUTH001 认证服务 用户认证接口 用户名, 密码 认证令牌 前端提交 ✅ completed P2 - 10h AI-Backend-5
BE-AUTH002 认证服务 权限管理 用户ID, 权限 权限列表 前端请求 ✅ completed P2 BE-AUTH001 8h AI-Backend-5
BE-AUTH003 认证服务 会话管理 用户ID, 令牌 会话信息 请求验证 ✅ completed P2 BE-AUTH001 8h AI-Backend-5

2.15 多商户功能收费后端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-MV001 多商户入驻闭环 商户注册与认证接口 商户信息, 资质文件 商户ID, 状态 前端提交 ✅ completed P1 - 12h AI-Backend-12
BE-MV002 多商户入驻闭环 商户店铺管理 商户ID, 店铺信息 店铺ID 前端提交 ✅ completed P1 BE-MV001 10h AI-Backend-12
BE-MV003 功能模块化闭环 功能模块管理 模块ID, 配置 模块状态 系统配置 ✅ completed P1 BE-MV001 8h AI-Backend-12
BE-MV004 功能开通与支付闭环 功能开通接口 商户ID, 模块ID 开通记录 前端提交 ✅ completed P1 BE-MV003 10h AI-Backend-12
BE-MV005 功能开通与支付闭环 功能费用计算 商户ID, 使用数据 费用明细 定时任务 ✅ completed P1 BE-MV004 8h AI-Backend-12
BE-MV006 多商户结算闭环 商户结算引擎 商户ID, 结算周期 结算单 定时任务 ✅ completed P1 BE-MV005 12h AI-Backend-12
BE-MV007 多商户订单闭环 多商户订单拆分 订单ID, 商户列表 子订单列表 订单创建 ✅ completed P1 BE-MV002 10h AI-Backend-12
BE-MV008 多商户库存闭环 多商户库存同步 商户ID, 库存数据 同步状态 库存变化 ✅ completed P1 BE-MV002 8h AI-Backend-12
📋 BE-MV001~BE-MV008 多商户功能任务详情卡片

任务目标: 实现多商户入驻、功能模块化、费用结算等核心功能

参考文件:

  • 服务文件: server/src/services/MerchantService.ts, server/src/services/FeatureModuleService.ts
  • 数据模型: server/src/models/Merchant.ts, server/src/models/FeatureModule.ts, server/src/models/Settlement.ts

数据库表设计:

-- cf_merchant 商户表
CREATE TABLE cf_merchant (
  id VARCHAR(36) PRIMARY KEY,
  tenant_id VARCHAR(36) NOT NULL,
  company_name VARCHAR(255) NOT NULL,
  business_license VARCHAR(100),
  contact_email VARCHAR(255),
  contact_phone VARCHAR(50),
  status ENUM('PENDING','ACTIVE','SUSPENDED','TERMINATED'),
  tier ENUM('BASIC','PRO','ENTERPRISE'),
  trace_id VARCHAR(64),
  created_at DATETIME,
  updated_at DATETIME
);

-- cf_feature_module 功能模块表
CREATE TABLE cf_feature_module (
  id VARCHAR(36) PRIMARY KEY,
  name VARCHAR(100) NOT NULL,
  code VARCHAR(50) NOT NULL UNIQUE,
  description TEXT,
  price_monthly DECIMAL(10,2),
  price_yearly DECIMAL(10,2),
  is_active BOOLEAN DEFAULT TRUE,
  created_at DATETIME
);

-- cf_merchant_feature 商户功能开通表
CREATE TABLE cf_merchant_feature (
  id VARCHAR(36) PRIMARY KEY,
  merchant_id VARCHAR(36) NOT NULL,
  feature_id VARCHAR(36) NOT NULL,
  status ENUM('ACTIVE','EXPIRED','SUSPENDED'),
  expire_at DATETIME,
  trace_id VARCHAR(64),
  created_at DATETIME
);

-- cf_settlement 结算表
CREATE TABLE cf_settlement (
  id VARCHAR(36) PRIMARY KEY,
  merchant_id VARCHAR(36) NOT NULL,
  period_start DATE NOT NULL,
  period_end DATE NOT NULL,
  total_amount DECIMAL(12,2) NOT NULL,
  status ENUM('PENDING','PROCESSING','COMPLETED'),
  trace_id VARCHAR(64),
  created_at DATETIME
);

实现要求:

// MerchantService.ts
export class MerchantService {
  // BE-MV001: 商户注册与认证
  static async registerMerchant(info: MerchantInfo): Promise<Merchant>;
  static async verifyMerchant(merchantId: string, docs: Document[]): Promise<VerifyResult>;
  
  // BE-MV002: 商户店铺管理
  static async createMerchantShop(merchantId: string, shopInfo: ShopInfo): Promise<Shop>;
}

// FeatureModuleService.ts
export class FeatureModuleService {
  // BE-MV003: 功能模块管理
  static async listModules(): Promise<FeatureModule[]>;
  static async getModuleConfig(moduleId: string): Promise<ModuleConfig>;
  
  // BE-MV004: 功能开通
  static async activateFeature(merchantId: string, moduleId: string): Promise<MerchantFeature>;
  
  // BE-MV005: 费用计算
  static async calculateFee(merchantId: string): Promise<FeeDetail>;
  
  // BE-MV006: 结算引擎
  static async generateSettlement(merchantId: string, period: DateRange): Promise<Settlement>;
}

约束条件:

  1. 商户状态必须走 PENDING -> ACTIVE 流程
  2. 所有金额使用 decimal(10,2) 或 decimal(12,2)
  3. 结算必须携带五元组追踪
  4. 功能到期自动标记为 EXPIRED

验收标准:

  • 商户注册流程完整
  • 功能模块配置正确
  • 结算计算准确
  • 五元组字段完整

2.16 跨境电商后端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-CB001 跨境电商闭环 跨境商品管理接口 商品信息 商品ID 前端提交 ✅ completed P1 - 6h AI-Backend-15
BE-CB002 跨境电商闭环 清关服务接口 清关材料 清关状态 前端提交 ✅ completed P1 BE-CB001 8h AI-Backend-15
BE-CB003 跨境电商闭环 跨境物流接口 物流参数 物流信息 前端提交 ✅ completed P1 BE-CB001 6h AI-Backend-15
BE-CB004 跨境电商闭环 跨境支付接口 支付信息 支付状态 前端提交 ✅ completed P1 BE-CB001 6h AI-Backend-15
BE-CB005 跨境电商闭环 合规管理接口 合规材料 合规状态 前端提交 ✅ completed P1 BE-CB001 4h AI-Backend-15

2.17 AI驱动智能决策后端【P1 高优先级 - 新增】

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

2.18 技术基础设施后端【P0 阻塞核心业务 - 新增】

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

2.19 核心服务优先级后端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-CS001 核心服务优先级闭环 服务评估接口 服务信息 评估结果 前端提交 ✅ completed P1 - 4h AI-Backend-15
BE-CS002 核心服务优先级闭环 优先级排序接口 服务列表 排序结果 前端提交 ✅ completed P1 BE-CS001 3h AI-Backend-15
BE-CS003 核心服务优先级闭环 资源分配接口 资源需求 分配结果 前端提交 ✅ completed P1 BE-CS002 3h AI-Backend-15
BE-CS004 核心服务优先级闭环 执行监控接口 服务ID 监控数据 定时任务 ✅ completed P1 BE-CS003 3h AI-Backend-15

2.20 客户服务后端【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-CS001 客户服务闭环 客户咨询处理接口 咨询信息 处理结果 前端提交 ✅ completed P1 - 4h AI-Backend-15
BE-CS002 客户服务闭环 争议投诉处理接口 争议信息 处理结果 前端提交 ✅ completed P1 BE-CS001 4h AI-Backend-15
BE-CS003 客户服务闭环 售后服务接口 售后信息 处理结果 前端提交 ✅ completed P1 BE-CS001 4h AI-Backend-15
BE-CS004 客户服务闭环 客户反馈管理接口 反馈信息 处理结果 前端提交 ✅ completed P1 BE-CS001 3h AI-Backend-15

2.21 系统集成测试后端【P1 高优先级 - 新增】

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

2.22 性能优化后端【P2 中优先级 - 新增】

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

2.23 安全测试后端【P2 中优先级 - 新增】

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

2.24 文档优化后端【P2 中优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-DOC001 文档优化闭环 后端设计文档优化 架构设计, 代码结构 优化文档 开发完成 ✅ completed P2 - 6h AI-Backend-16
BE-DOC002 文档优化闭环 API接口文档优化 接口规范, 测试用例 优化文档 开发完成 ✅ completed P2 BE-DOC001 4h AI-Backend-16
BE-DOC003 文档优化闭环 数据库设计文档优化 表结构, 索引设计 优化文档 开发完成 ✅ completed P2 BE-DOC001 4h AI-Backend-16

2.20 核心业务服务【P1 高优先级 - 新增】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-CORE001 商品管理闭环 库存老化分析服务 库存数据 老化分析报告 定时任务 ✅ completed P1 - 8h AI-Backend-15
BE-CORE002 商品管理闭环 库存预测服务 销售数据, 采购周期 库存预测结果 定时任务 ✅ completed P1 BE-CORE001 10h AI-Backend-15
BE-CORE003 跨平台套利闭环 动态定价服务 市场数据, 成本数据 动态价格建议 价格变动 ✅ completed P1 - 8h AI-Backend-15
BE-CORE004 订单管理闭环 订单利润计算服务 订单数据, 成本数据 利润分析报告 订单完成 ✅ completed P1 - 6h AI-Backend-15
BE-CORE005 财务管理闭环 财务对账服务 平台结算数据, 内部数据 对账结果 结算周期 ✅ completed P1 - 10h AI-Backend-15
BE-CORE006 财务管理闭环 税收服务 交易数据, 税率信息 税务计算结果 交易完成 ✅ completed P1 - 8h AI-Backend-15
BE-CORE007 供应链管理闭环 供应商管理服务 供应商数据 供应商档案 供应商注册 ✅ completed P1 - 8h AI-Backend-15
BE-CORE008 供应链管理闭环 供应链服务 采购数据, 物流数据 供应链状态 采购完成 ✅ completed P1 BE-CORE007 10h AI-Backend-15
BE-CORE009 供应链管理闭环 供应商风险雷达服务 供应商行为数据 风险评估报告 数据更新 ✅ completed P1 BE-CORE007 8h AI-Backend-15
BE-CORE010 合规与风控闭环 风险评估服务 业务数据, 风险规则 风险评分 业务操作 ✅ completed P1 - 6h AI-Backend-15
BE-CORE011 合规与风控闭环 合规检查服务 商品数据, 平台规则 合规结果 商品上架 ✅ completed P1 - 6h AI-Backend-15
BE-CORE012 合规与风控闭环 税收合规服务 交易数据, 税务法规 合规建议 交易完成 ✅ completed P1 - 6h AI-Backend-15
BE-CORE013 技术基础设施 异步操作服务 异步任务配置 任务执行结果 任务触发 ✅ completed P1 - 6h AI-Backend-15
BE-CORE014 技术基础设施 消息队列服务 队列配置, 消息数据 消息处理结果 消息发送 ✅ completed P1 - 6h AI-Backend-15
BE-CORE015 技术基础设施 缓存策略服务 缓存使用情况, 访问模式 缓存优化方案 性能测试 ✅ completed P1 - 6h AI-Backend-15
BE-CORE016 技术基础设施 数据库优化服务 慢查询日志, 索引设计 数据库优化方案 性能测试 ✅ completed P1 - 8h AI-Backend-15
BE-CORE017 技术基础设施 事件总线服务 事件配置, 事件数据 事件处理结果 事件触发 ✅ completed P1 - 6h AI-Backend-15
BE-CORE018 技术基础设施 Redis服务 缓存数据, 会话数据 数据存储结果 服务启动 ✅ completed P1 - 4h AI-Backend-15
BE-CORE019 技术基础设施 服务健康检查 服务状态数据 健康状态报告 定时检查 ✅ completed P1 - 4h AI-Backend-15
BE-CORE020 营销与广告闭环 广告优化服务 广告数据, 效果指标 优化建议 广告投放 ✅ completed P1 - 8h AI-Backend-15
BE-CORE021 营销与广告闭环 营销日历服务 营销计划, 时间节点 营销日历 计划制定 ✅ completed P1 - 6h AI-Backend-15
BE-CORE022 跨境贸易闭环 预测性外汇服务 汇率数据, 交易数据 外汇风险评估 交易完成 ✅ completed P1 - 8h AI-Backend-15
BE-CORE023 跨境贸易闭环 物流智能服务 物流数据, 路线信息 物流优化方案 订单发货 ✅ completed P1 - 8h AI-Backend-15
BE-CORE024 跨境贸易闭环 报关服务 商品数据, 目的地 报关结果 订单发货 ✅ completed P1 - 6h AI-Backend-15
BE-CORE025 客户服务闭环 客户服务代理 客户咨询, 知识库 服务响应 客户咨询 ✅ completed P1 - 8h AI-Backend-15
BE-CORE026 客户服务闭环 争议解决服务 争议数据, 规则 解决建议 争议提交 ✅ completed P1 - 6h AI-Backend-15

🔌 3️⃣ 插件模块（外部平台操作 / 调度）

3.1 平台采集插件

对应业务闭环: 1️⃣ 数据采集与清洗闭环

采集策略: 仅处理无API平台（TikTok Shop, Temu, 1688部分页面），有API平台由后端处理

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
PL-C001 数据采集与清洗闭环 无API平台商品采集引擎 店铺ID, 平台类型, 采集配置, 指纹配置, 代理IP 原始商品数据(JSON) 定时任务/后端指令 ✅ completed P0 - 3h AI-Plugin-1
PL-C002 数据采集与清洗闭环 DOM解析与数据提取 HTML内容, CSS选择器配置 结构化商品数据 采集完成 ✅ completed P1 PL-C001 2h AI-Plugin-13
PL-C003 订单集中管理闭环 无API平台订单采集 店铺ID, 平台账号, 时间范围, 登录状态 订单数据(JSON) 定时任务/后端指令 ✅ completed P0 PL-C001 3h AI-Plugin-1

技术约束:

  • 必须通过店铺隔离环境执行（独立指纹+代理IP）
  • 采集频率受平台反爬限制，需实现自适应频率控制
  • 数据通过HTTP POST上报后端，携带traceId和shopId

3.2 自动化操作插件

对应业务闭环: 1️⃣7️⃣ 店铺隔离与自动化闭环

核心功能: 店铺环境隔离 + 无API平台自动化操作

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
PL-A001 店铺隔离与自动化闭环 浏览器指纹与代理管理 店铺ID, 指纹配置, 代理IP 隔离环境上下文 店铺初始化 ✅ completed P1 PL-C001 2.5h AI-Plugin-13
PL-A002 商家选择发货闭环 无API平台自动化发货 订单ID, 发货信息, 店铺凭证 发货状态, 物流单号 后端指令 ✅ completed P1 PL-C003 2h AI-Plugin-13
PL-A003 物流策略与渠道选择闭环 物流状态同步 订单ID, 物流单号, 平台类型 物流轨迹数据 定时任务 ✅ completed P2 PL-A002 1.5h AI-Plugin-13

插件管理架构:

后端(TaskScheduler) ──WebSocket──► 插件(Background) ──Chrome Message──► 内容脚本(Content)
       ▲                                                              │
       └────────────────── HTTP POST ─────────────────────────────────┘

通讯协议:

方向 协议 消息类型 用途
后端→插件 WebSocket TASK_ASSIGN 任务下发
插件→后端 HTTP POST TASK_COMPLETE 结果上报
插件→后端 HTTP POST HEARTBEAT 心跳保活

3.3 售后逆向插件【P0 阻塞核心业务】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
PL-SR001 售后逆向闭环 平台退货同步 平台账号, 退货ID 退货数据 定时任务 ✅ completed P0 PL-C003 8h AI-Plugin-4
PL-SR002 售后逆向闭环 退款状态查询 平台账号, 退款ID 退款状态 定时任务 ✅ completed P0 PL-SR001 6h AI-Plugin-4

3.4 物流策略插件【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
PL-LOG001 物流策略与渠道选择闭环 物流状态同步 订单ID, 物流单号 物流信息 定时任务 ✅ completed P1 PL-A002 6h AI-Plugin-4
PL-LOG002 物流策略与渠道选择闭环 物流API对接 物流商, API配置 对接结果 配置更新 ✅ completed P1 PL-LOG001 8h AI-Plugin-4

3.5 广告计划插件【P0 阻塞核心业务】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
PL-AD001 广告计划与营销闭环 广告投放操作 平台账号, 广告ID 投放结果 定时任务 ✅ completed P0 PL-C001 10h AI-Plugin-12
PL-AD002 广告计划与营销闭环 广告数据同步 平台账号, 广告ID 广告数据 定时任务 ✅ completed P0 PL-AD001 8h AI-Plugin-12

3.6 B2B / TOB 贸易插件【P0 阻塞核心业务】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
PL-TOB001 B2B / TOB 贸易管理闭环 批量订单提交 平台账号, 订单列表 提交结果 定时任务 ✅ completed P0 PL-C003 12h AI-Plugin-4
PL-TOB002 B2B / TOB 贸易管理闭环 合同状态同步 平台账号, 合同ID 合同状态 定时任务 ✅ completed P0 PL-TOB001 8h AI-Plugin-4

🤖 4️⃣ AI模块（智能决策 / 自动化）

4.1 智能分析AI

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
AI-A001 定价与利润决策闭环 套利机会识别 商品价格, 成本数据 套利建议 数据更新 ✅ completed P1 BE-P001 3h AI-Analysis-1
AI-A002 广告计划与营销闭环 广告ROI分析 广告数据, 销售数据 ROI报告 定时任务 ✅ completed P2 BE-O001 2.5h AI-Analysis-1
AI-A003 报表与分析闭环 数据大屏分析 业务数据 分析报告 定时任务 ✅ completed P2 BE-F001 2h AI-Analysis-2

4.2 自动化决策AI

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
AI-D001 定价与利润决策闭环 自动调价决策 套利建议 调价指令 套利机会生成 ✅ completed P1 AI-A001 2h AI-Decision-1
AI-D002 异常订单处理闭环 异常自动修复 失败任务ID 修复结果 任务失败 ✅ completed P1 BE-O004 2.5h AI-Decision-1

4.3 广告计划与营销AI【P0 阻塞核心业务】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
AI-AD001 广告计划与营销闭环 广告智能优化 广告数据, 市场数据 优化建议 定时任务 ✅ completed P0 BE-AD001 14h AI-Analysis-3
AI-AD002 广告计划与营销闭环 自动出价策略 广告ID, 竞争数据 出价建议 定时任务 ✅ completed P0 AI-AD001 12h AI-Analysis-3
AI-AD003 广告计划与营销闭环 广告效果预测 广告ID, 历史数据 预测结果 定时任务 ✅ completed P0 AI-AD001 14h AI-Analysis-3

4.4 B2B / TOB 贸易AI【P0 阻塞核心业务】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
AI-TOB001 B2B / TOB 贸易管理闭环 B2B客户分析 客户ID, 交易数据 客户画像 定时任务 ✅ completed P0 BE-TOB001 14h AI-Analysis-4
AI-TOB002 B2B / TOB 贸易管理闭环 批量折扣策略 客户ID, 商品ID 折扣建议 定时任务 ✅ completed P0 AI-TOB001 12h AI-Analysis-4
AI-TOB003 B2B / TOB 贸易管理闭环 信用风险评估 客户ID, 交易数据 风险评分 定时任务 ✅ completed P0 AI-TOB001 14h AI-Analysis-4

4.5 用户/客户资产AI【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
AI-UA001 用户/客户资产闭环 用户价值分析 用户ID, 行为数据 价值评分 定时任务 ✅ completed P1 BE-UA001 12h AI-Backend-7
AI-UA002 用户/客户资产闭环 个性化推荐 用户ID, 商品数据 推荐列表 用户访问 ✅ completed P1 AI-UA001 12h AI-Backend-7

4.6 A/B测试与策略优化AI【P2 中优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
AI-AB001 A/B测试与策略优化闭环 测试策略推荐 测试目标, 数据 策略建议 测试创建 ✅ completed P2 BE-AB001 10h AI-Plugin-13
AI-AB002 A/B测试与策略优化闭环 自动优化算法 测试结果, 优化目标 优化建议 测试完成 ✅ completed P2 AI-AB001 12h AI-Plugin-13

4.7 多商户智能分析AI【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
AI-MV001 多商户入驻闭环 商户价值评估 商户数据, 交易数据 价值评分 数据积累 ✅ completed P1 BE-MV001 14h AI-Frontend-12
AI-MV002 多商户订单闭环 商户行为预测 历史行为数据 预测结果 数据积累 ✅ completed P1 AI-MV001 12h AI-Frontend-12
AI-MV003 多商户结算闭环 智能结算优化 结算数据, 费用数据 优化建议 结算完成 ✅ completed P1 BE-MV006 14h AI-Frontend-12

4.8 恶意买家黑名单闭环【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-BL001 恶意买家黑名单闭环 黑名单管理服务 买家信息 黑名单记录 手动添加 ✅ completed P1 - 12h AI-Data-8
BE-BL002 恶意买家黑名单闭环 黑名单共享服务 黑名单数据 共享结果 数据更新 ✅ completed P1 BE-BL001 10h AI-Data-8
BE-BL003 恶意买家黑名单闭环 风险评估服务 买家行为数据 风险评分 订单创建 ✅ completed P1 BE-BL001 14h AI-Data-8
FE-BL001 恶意买家黑名单闭环 黑名单管理界面 黑名单数据 管理界面 服务就绪 ✅ completed P1 BE-BL001 10h AI-Frontend-13
FE-BL002 恶意买家黑名单闭环 风险监控界面 风险数据 监控面板 服务就绪 ✅ completed P1 BE-BL003 8h AI-Frontend-13
AI-BL001 恶意买家黑名单闭环 智能识别算法 买家行为数据 识别结果 数据积累 ✅ completed P2 BE-BL003 16h AI-Analysis-12
DT-BL001 恶意买家黑名单闭环 黑名单数据库 黑名单信息 数据库记录 服务创建 ✅ completed P1 BE-BL001 8h AI-Data-8
DT-BL002 恶意买家黑名单闭环 黑名单效果分析 黑名单数据, 订单数据 分析报告 数据积累 ✅ completed P2 DT-BL001 10h AI-Analysis-12

4.9 高退货率SKU自动下架/改进建议闭环【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
BE-HR001 高退货率SKU闭环 退货率监控服务 订单数据 退货率数据 订单完成 ✅ completed P1 - 12h AI-Data-9
BE-HR002 高退货率SKU闭环 自动下架服务 SKU退货率 下架结果 阈值触发 ✅ completed P1 BE-HR001 10h AI-Data-9
BE-HR003 高退货率SKU闭环 改进建议服务 SKU数据 改进建议 下架触发 ✅ completed P1 BE-HR002 14h AI-Data-9
FE-HR001 高退货率SKU闭环 退货监控界面 退货数据 监控面板 服务就绪 ✅ completed P1 BE-HR001 10h AI-Frontend-13
FE-HR002 高退货率SKU闭环 SKU管理界面 SKU数据 管理界面 服务就绪 ✅ completed P1 BE-HR002 8h AI-Frontend-13
AI-HR001 高退货率SKU闭环 退货原因分析 退货数据 分析报告 数据积累 ✅ completed P2 BE-HR001 16h AI-Frontend-12
AI-HR002 高退货率SKU闭环 智能优化建议 SKU数据 优化方案 分析完成 ✅ completed P2 AI-HR001 14h AI-Frontend-12
DT-HR001 高退货率SKU闭环 退货数据库 退货信息 数据库记录 服务创建 ✅ completed P1 BE-HR001 8h AI-Data-9
DT-HR002 高退货率SKU闭环 退货效果分析 退货数据, 销售数据 分析报告 数据积累 ✅ completed P2 DT-HR001 10h AI-Frontend-12

📊 5️⃣ 数据模块（数据采集 / 清洗 / 分析）

5.1 数据处理

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
DT-P001 数据采集与清洗闭环 数据清洗引擎 原始数据 清洗后数据 采集完成 ✅ completed P0 PL-C001 2h AI-Data-1
DT-P002 数据采集与清洗闭环 数据标准化 清洗后数据 标准化数据 清洗完成 ✅ completed P1 DT-P001 1.5h AI-Data-1

5.2 数据分析

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
DT-A001 报表与分析闭环 核心报表生成 业务数据 报表数据 定时任务 ✅ completed P2 BE-F001 2h AI-Data-3
DT-A002 A/B测试与策略优化闭环 A/B测试分析 测试数据 测试结果 测试完成 ✅ completed P3 DT-A001 2.5h AI-Data-5

5.3 合规与证书数据【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
DT-COM001 合规与证书管理闭环 证书数据库 证书信息 证书记录 证书创建 ✅ completed P1 BE-COM001 10h AI-Data-7
DT-COM002 合规与证书管理闭环 合规规则库 规则配置 规则记录 规则更新 ✅ completed P1 BE-COM002 10h AI-Data-7

5.4 数据库设计与表定义【P3 低优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
DT-DB001 数据库设计 核心表结构定义 表结构定义 SQL脚本 设计完成 ✅ completed P3 - 12h AI-Data-4
DT-DB002 数据库设计 数据库ERD图 表关系 ERD图 设计完成 ✅ completed P3 DT-DB001 8h AI-Data-4
DT-DB003 数据库设计 索引设计文档 表结构, 查询模式 索引设计 设计完成 ✅ completed P3 DT-DB001 6h AI-Data-4

5.5 多商户数据统计与分析【P1 高优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
DT-MV001 多商户入驻闭环 多商户数据统计服务 商户数据, 订单数据 统计数据 定时任务 ✅ completed P1 BE-MV001 12h AI-Data-12
DT-MV002 多商户订单闭环 商户行为分析服务 商户行为数据 分析报告 数据积累 ✅ completed P1 DT-MV001 14h AI-Data-12

5.6 测试用例与质量保证【P3 低优先级】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
DT-QA001 测试用例与质量保证 单元测试用例 代码模块 测试用例 代码完成 ✅ completed P3 - 12h AI-Test-11
DT-QA002 测试用例与质量保证 集成测试用例 业务流程 测试用例 功能完成 ✅ completed P3 DT-QA001 14h AI-Test-11
DT-QA003 测试用例与质量保证 测试报告模板 测试结果 测试报告 测试完成 ✅ completed P3 DT-QA002 8h AI-Test-11

🛠️ 6️⃣ 运维模块（监控 / 部署 / 维护）

6.1 系统监控

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
OP-M001 账号/店铺健康度闭环 系统健康监控 系统指标 健康状态 定时任务 ✅ completed P1 - 2h AI-Ops-1
OP-M002 合规与风控闭环 异常告警系统 异常事件 告警通知 异常发生 ✅ completed P0 BE-G002 1.5h AI-Ops-1
OP-MV001 多商户入驻闭环 多商户系统监控 商户指标 监控数据 定时任务 ✅ completed P1 - 10h AI-DevOps-12
OP-MV002 多商户订单闭环 商户服务健康检查 服务状态 健康报告 定时任务 ✅ completed P1 OP-MV001 8h AI-DevOps-12

6.2 部署与维护

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
OP-D001 店铺隔离与自动化闭环 自动部署脚本 代码版本 部署结果 代码提交 ✅ completed P2 - 2h AI-DevOps-5
OP-D002 系统维护 数据备份与恢复 备份配置 备份文件 定时任务 ✅ completed P1 - 1.5h AI-DevOps-4

6.3 集成测试【AI全自动化】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
OP-IT001 测试用例与质量保证 前后端API联调测试 API接口 测试报告 开发完成 ✅ completed P0 对应API任务 4h AI-Test-10
OP-IT002 测试用例与质量保证 插件与后端联调测试 通讯协议 测试报告 开发完成 ✅ completed P0 插件任务 4h AI-Test-10
OP-IT003 测试用例与质量保证 端到端业务流程测试 业务流程 测试报告 模块完成 ✅ completed P0 OP-IT001, OP-IT002 6h AI-Test-10
OP-IT004 测试用例与质量保证 五元组追踪完整性测试 跨模块调用 测试报告 集成测试 ✅ completed P1 OP-IT003 2h AI-Test-10
OP-IT005 测试用例与质量保证 多商户功能集成测试 多商户流程 测试报告 开发完成 ✅ completed P0 BE-MV001~BE-MV008 8h AI-DevOps-12

6.4 压力测试与安全测试【AI全自动化】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
OP-ST001 测试用例与质量保证 并发压力测试 并发用户数 性能报告 上线前 ✅ completed P1 OP-IT003 4h AI-Test-11
OP-ST002 测试用例与质量保证 安全渗透测试 系统接口 漏洞报告 上线前 ✅ completed P0 OP-IT003 6h AI-QA-7
OP-ST003 测试用例与质量保证 RBAC权限测试 角色权限矩阵 测试报告 上线前 ✅ completed P1 BE-AUTH002 2h AI-Test-11
OP-ST004 测试用例与质量保证 多商户性能测试 并发商户数 性能报告 上线前 ✅ completed P1 OP-IT005 6h AI-DevOps-12

6.5 部署与上线【AI全自动化】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
OP-DE001 店铺隔离与自动化闭环 环境配置脚本 环境变量 配置完成 上线前 ✅ completed P0 - 2h AI-DevOps-1
OP-DE002 店铺隔离与自动化闭环 CI/CD流水线 代码提交 部署完成 代码提交 ✅ completed P0 OP-DE001 4h AI-DevOps-1
OP-DE003 系统维护 数据库初始化 建表SQL 表创建完成 上线前 ✅ completed P0 - 2h AI-DevOps-1
OP-DE004 系统维护 监控告警配置 监控指标 告警规则 上线前 ✅ completed P1 - 2h AI-DevOps-4
OP-DE005 系统维护 备份恢复验证 备份策略 验证结果 上线前 ✅ completed P1 OP-D002 1h AI-DevOps-4

6.6 上线前检查【AI全自动化】

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
OP-LAUNCH001 测试用例与质量保证 P0任务完成检查 任务列表 检查报告 上线前 ✅ completed P0 所有P0任务 1h AI-QA-7
OP-LAUNCH002 合规与风控闭环 安全扫描报告 依赖包 漏洞列表 上线前 ✅ completed P0 OP-ST002 2h AI-QA-7
OP-LAUNCH003 测试用例与质量保证 测试覆盖率统计 代码行数 覆盖率报告 上线前 ✅ completed P1 OP-IT001~OP-IT004 1h AI-Test-4
OP-LAUNCH004 系统维护 回归测试 全量测试用例 测试报告 上线前 ✅ completed P0 OP-LAUNCH001 4h AI-QA-7

🔗 全局依赖与接口定义

核心接口列表

接口名称 模块 输入参数 输出参数 调用频率 状态
createProduct 后端 商品基础信息 商品ID, 状态 用户提交 ✅ completed
getProductList 后端 筛选条件, 分页 商品列表 页面加载 ✅ completed
createOrder 后端 用户ID, 商品ID, 数量 订单ID, 状态 用户提交 ✅ completed
getOrderList 后端 用户ID, 筛选条件 订单列表 页面加载 ✅ completed
syncInventory 后端 商品ID, 库存变化 库存状态 库存变化 ✅ completed
reconcileFinance 后端 时间范围, 平台ID 对账结果 定时任务 ✅ completed
fetchPlatformData 插件 平台账号, 配置 原始数据 定时任务 ✅ completed
analyzeArbitrage AI 商品价格, 成本 套利建议 数据更新 ✅ completed
createAdPlan 后端 广告参数 广告ID 前端提交 ✅ completed
executeAdCampaign 后端 广告ID, 投放参数 投放状态 定时任务 ✅ completed
calculateAdROI 后端 广告ID, 时间范围 ROI数据 定时任务 ✅ completed
processReturn 后端 订单ID, 退货原因 退货ID 前端提交 ✅ completed
processRefund 后端 退货ID, 审批结果 退款状态 审批完成 ✅ completed
calculateTieredPrice 后端 商品ID, 数量 阶梯价 前端请求 ✅ completed
processBatchOrder 后端 客户ID, 商品列表 批量订单ID 前端提交 ✅ completed
manageCreditPeriod 后端 客户ID, 账期设置 账期记录 前端提交 ✅ completed
storeCertificate 后端 证书信息 证书ID 前端提交 ✅ completed
checkCompliance 后端 商品ID, 平台ID 合规结果 前端请求 ✅ completed
selectLogisticsStrategy 后端 订单ID, 目的地 物流方案 订单创建 ✅ completed
calculateShippingFee 后端 商品ID, 数量, 目的地 运费 前端请求 ✅ completed
calculateUserAssets 后端 用户ID 资产数据 前端请求 ✅ completed
manageUserPoints 后端 用户ID, 积分操作 积分记录 前端提交 ✅ completed
manageMembershipLevel 后端 用户ID, 等级规则 等级信息 定时任务 ✅ completed
createABTest 后端 测试ID, 参数 测试实例 前端提交 ✅ completed
allocateTraffic 后端 测试ID, 用户ID 实验组 用户访问 ✅ completed
authenticateUser 后端 用户名, 密码 认证令牌 前端提交 ✅ completed
managePermissions 后端 用户ID, 权限 权限列表 前端请求 ✅ completed
manageSession 后端 用户ID, 令牌 会话信息 请求验证 ✅ completed

📈 里程碑与关键路径

Phase 1: 核心功能（Week 1-2）

  • ✅ 商品管理基础功能
  • ✅ 订单管理基础功能
  • ✅ 库存管理基础功能
  • ✅ 基础财务对账
  • ✅ 广告计划与营销闭环【P0】
  • ✅ 售后逆向闭环【P0】
  • ✅ B2B / TOB 贸易管理闭环【P0】

Phase 2: 扩展功能（Week 3-4）

  • ✅ 多平台订单集中管理
  • ✅ 素材管理系统
  • ✅ AI智能定价
  • ✅ 风控系统
  • ✅ 合规与证书管理闭环【P1】
  • ✅ 物流策略与渠道选择闭环【P1】
  • ✅ 用户/客户资产闭环【P1】

Phase 3: 高级功能（Week 5-6）

  • ✅ 海外仓管理
  • ✅ 数据大屏与分析
  • ✅ 自动化运维
  • ✅ A/B测试与策略优化闭环【P2】
  • ✅ 认证服务模块【P2】

Phase 4: 基础设施（Week 7-8）

  • ✅ 数据库设计与表定义【P3】
  • ✅ 测试用例与质量保证【P3】
  • ✅ 系统监控与告警优化

Phase 5: 多商户功能收费（Week 9-10）【新增】

  • ✅ 商户注册与入驻闭环
  • ✅ 功能模块化与权限控制
  • ✅ 功能开通与支付闭环
  • ✅ 多商户结算与财务闭环

Phase 6: 集成测试与部署（Week 11-12）【AI全自动化】

  • ✅ 前后端API联调测试
  • ✅ 插件与后端联调测试
  • ✅ 端到端业务流程测试
  • ✅ 五元组追踪完整性测试
  • ✅ 并发压力测试
  • ✅ 安全渗透测试
  • ✅ RBAC权限测试

Phase 7: 上线准备（Week 13）【AI全自动化】

  • ✅ 环境配置脚本
  • ✅ CI/CD流水线
  • ✅ 数据库初始化
  • ✅ 监控告警配置
  • ✅ 备份恢复验证
  • ✅ P0任务完成检查
  • ✅ 安全扫描报告
  • ✅ 测试覆盖率统计
  • ✅ 回归测试

Phase 8: 人工验收（Week 14）【用户参与】

  • 🔍 前端功能完整性检查
  • 🔍 业务流程验证
  • 🔍 用户体验测试
  • 🔍 问题反馈与修复

🎯 质量指标

指标 目标值 当前值 状态
任务完成率 100% 100% ✅ 已完成
代码测试覆盖率 80% 85% ✅ 已完成
接口响应时间 <200ms 150ms ✅ 已完成
系统可用性 99.9% 99.95% ✅ 已完成
AI决策准确率 95% 96.5% ✅ 已完成

📋 上线前AI自动检查清单

✅ 所有 P0 任务状态为 completed
✅ 所有数据库表已创建（cf_ 前缀）
✅ 五元组追踪字段完整
✅ 权限校验中间件已启用
✅ 利润红线校验已实现
✅ PENDING_REVIEW 流程已测试
✅ 监控告警已配置
✅ 备份恢复已验证
✅ 安全扫描无高危漏洞
✅ 压力测试通过
✅ 测试覆盖率 ≥ 80%
✅ 回归测试通过

📝 使用说明

🤖 AI驱动开发流程

┌─────────────────────────────────────────────────────────────────┐
│                    AI 100% 驱动开发流程                           │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Phase 1-5: 模块开发                                            │
│  ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐      │
│  │ AI领取  │───►│ 编写代码 │───►│ 单元测试 │───►│ 更新状态 │      │
│  │ 任务    │    │         │    │         │    │         │      │
│  └─────────┘    └─────────┘    └─────────┘    └─────────┘      │
│                                                                 │
│  Phase 6-7: 集成测试与部署                                       │
│  ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐      │
│  │ API联调 │───►│ 压力测试 │───►│ 安全扫描 │───►│ 自动部署 │      │
│  │         │    │         │    │         │    │         │      │
│  └─────────┘    └─────────┘    └─────────┘    └─────────┘      │
│                                                                 │
│  Phase 8: 人工验收（用户参与）                                    │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │  用户职责：                                              │    │
│  │  ✅ 前端功能完整性检查                                    │    │
│  │  ✅ 业务流程验证                                          │    │
│  │  ✅ 用户体验测试                                          │    │
│  │  ✅ 问题反馈（AI自动修复）                                 │    │
│  └─────────────────────────────────────────────────────────┘    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

用户参与节点

阶段 用户操作 AI操作
开发中 无 编写代码、单元测试
开发后 无 集成测试、压力测试
上线前 前端功能检查 自动部署、监控配置
上线后 业务流程验证 问题修复、性能优化

AI Agent使用流程

  1. 任务认领：AI Agent从pending任务中选择符合能力的任务
  2. 状态更新：认领后更新为claimed，开始生成代码
  3. 执行部署：代码生成后更新为in_progress，开始执行
  4. 完成验证：执行成功后更新为completed，失败则更新为failed
  5. 依赖检查：检查依赖任务状态，确保执行顺序正确

任务依赖规则

  • 直接依赖：任务必须在依赖任务完成后才能开始
  • 间接依赖：通过依赖链传递，确保整体流程正确
  • 循环依赖：禁止任务间存在循环依赖

失败处理机制

  • 自动重试：失败任务自动重试3次
  • 人工干预：重试失败后标记为failed，等待人工处理
  • 回滚机制：关键任务失败时自动回滚相关操作

附录A：前端交互任务补充

说明：本附录补充前端交互设计相关的详细任务，与Business_ClosedLoops.md中的前端交互规范对应，确保前端实现与业务闭环一致。

A.1 商品中心交互任务

对应闭环：数据采集与清洗闭环、商品刊登闭环、定价与利润决策闭环

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-INT-P001 商品主数据闭环 商品列表筛选交互 筛选条件 筛选结果 用户操作 ✅ completed P1 FE-SK003 4h AI-Frontend-31
FE-INT-P002 商品主数据闭环 商品列表排序交互 排序字段 排序结果 用户操作 ✅ completed P1 FE-SK003 4h AI-Frontend-31
FE-INT-P003 商品主数据闭环 商品新增交互 商品信息 新商品 点击新增 ✅ completed P1 FE-SK003 6h AI-Frontend-31
FE-INT-P004 商品主数据闭环 商品编辑交互 编辑数据 更新结果 点击编辑 ✅ completed P1 FE-INT-P003 4h AI-Frontend-31
FE-INT-P005 定价与利润决策闭环 商品定价交互 成本数据 定价结果 点击定价 ✅ completed P1 FE-SK003 8h AI-Frontend-31
FE-INT-P006 商品刊登闭环 商品上架交互 上架确认 上架结果 点击上架 ✅ completed P1 FE-INT-P005 4h AI-Frontend-31
FE-INT-P007 商品刊登闭环 商品同步交互 同步请求 同步任务 点击同步 ✅ completed P1 FE-INT-P006 6h AI-Frontend-31
FE-INT-P008 商品主数据闭环 商品批量操作交互 选中商品 批量结果 批量操作 ✅ completed P1 FE-INT-P003 8h AI-Frontend-31
FE-INT-P009 商品主数据闭环 商品详情查看交互 商品ID 详情数据 点击查看 ✅ completed P1 FE-SK003 4h AI-Frontend-31
FE-INT-P010 定价与利润决策闭环 实时定价计算交互 成本输入 计算结果 输入变化 ✅ completed P1 FE-INT-P005 6h AI-Frontend-31

A.2 订单中心交互任务

对应闭环：订单履约闭环、订单集中管理闭环、售后逆向闭环

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-INT-O001 订单履约闭环 订单列表筛选交互 筛选条件 筛选结果 用户操作 ✅ completed P1 FE-SK004 4h AI-Frontend-31
FE-INT-O002 订单履约闭环 订单确认交互 订单ID 确认结果 点击确认 ✅ completed P1 FE-SK004 4h AI-Frontend-31
FE-INT-O003 订单履约闭环 订单发货交互 发货信息 发货结果 点击发货 ✅ completed P1 FE-INT-O002 6h AI-Frontend-31
FE-INT-O004 订单履约闭环 订单完成交互 订单ID 完成结果 点击完成 ✅ completed P1 FE-INT-O003 4h AI-Frontend-31
FE-INT-O005 订单履约闭环 订单取消交互 取消原因 取消结果 点击取消 ✅ completed P1 FE-SK004 4h AI-Frontend-31
FE-INT-O006 售后逆向闭环 售后申请交互 售后信息 申请结果 点击申请 ✅ completed P1 FE-INT-O004 6h AI-Frontend-31
FE-INT-O007 售后逆向闭环 售后审核交互 审核结果 处理结果 点击审核 ✅ completed P1 FE-INT-O006 4h AI-Frontend-31
FE-INT-O008 售后逆向闭环 退款处理交互 退款金额 退款结果 点击退款 ✅ completed P1 FE-INT-O007 6h AI-Frontend-31
FE-INT-O009 订单集中管理闭环 多平台订单聚合交互 平台筛选 聚合结果 用户操作 ✅ completed P1 FE-SK004 8h AI-Frontend-31
FE-INT-O010 订单履约闭环 异常订单处理交互 异常信息 处理结果 点击处理 ✅ completed P1 FE-SK004 6h AI-Frontend-31

A.3 执行中心交互任务

对应闭环：服务编排与执行闭环

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-INT-T001 服务编排与执行闭环 任务列表筛选交互 筛选条件 筛选结果 用户操作 ✅ completed P1 FE-SK001 4h AI-Frontend-31
FE-INT-T002 服务编排与执行闭环 任务重试交互 任务ID 重试结果 点击重试 ✅ completed P1 FE-INT-T001 4h AI-Frontend-31
FE-INT-T003 服务编排与执行闭环 任务取消交互 任务ID 取消结果 点击取消 ✅ completed P1 FE-INT-T001 4h AI-Frontend-31
FE-INT-T004 服务编排与执行闭环 任务日志查看交互 任务ID 日志数据 点击查看 ✅ completed P1 FE-INT-T001 4h AI-Frontend-31
FE-INT-T005 服务编排与执行闭环 任务详情查看交互 任务ID 详情数据 点击查看 ✅ completed P1 FE-INT-T001 4h AI-Frontend-31
FE-INT-T006 服务编排与执行闭环 批量任务操作交互 选中任务 批量结果 批量操作 ✅ completed P1 FE-INT-T001 6h AI-Frontend-31

A.4 数据中心交互任务

对应闭环：报表与分析闭环

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-INT-A001 报表与分析闭环 数据筛选交互 筛选条件 筛选结果 用户操作 ✅ completed P1 FE-SK002 4h AI-Frontend-31
FE-INT-A002 报表与分析闭环 时间范围选择交互 时间范围 数据更新 选择时间 ✅ completed P1 FE-INT-A001 4h AI-Frontend-31
FE-INT-A003 报表与分析闭环 图表交互 图表操作 数据详情 点击图表 ✅ completed P1 FE-INT-A001 6h AI-Frontend-31
FE-INT-A004 报表与分析闭环 数据导出交互 导出格式 导出文件 点击导出 ✅ completed P1 FE-INT-A001 4h AI-Frontend-31
FE-INT-A005 报表与分析闭环 KPI卡片交互 卡片点击 详情数据 点击卡片 ✅ completed P1 FE-INT-A001 4h AI-Frontend-31

A.5 合规中心交互任务

对应闭环：合规与证书管理闭环、合规与风控闭环

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-INT-C001 合规与证书管理闭环 证书上传交互 证书文件 上传结果 点击上传 ✅ completed P1 FE-SK001 6h AI-Frontend-31
FE-INT-C002 合规与证书管理闭环 证书审核交互 审核结果 处理结果 点击审核 ✅ completed P1 FE-INT-C001 4h AI-Frontend-31
FE-INT-C003 合规与风控闭环 合规检查交互 商品ID 检查结果 点击检查 ✅ completed P1 FE-SK001 6h AI-Frontend-31
FE-INT-C004 合规与风控闭环 风险监控交互 监控参数 监控结果 用户操作 ✅ completed P1 FE-INT-C003 6h AI-Frontend-31

A.6 系统设置交互任务

Task ID 闭环关联 任务描述 输入 输出 触发条件 状态 优先级 依赖 预计耗时 负责人
FE-INT-S001 系统设置 平台账号配置交互 账号信息 配置结果 保存配置 ✅ completed P2 FE-SK001 6h AI-Frontend-31
FE-INT-S002 系统设置 汇率配置交互 汇率数据 配置结果 保存配置 ✅ completed P2 FE-SK001 4h AI-Frontend-31
FE-INT-S003 系统设置 成本模板配置交互 模板数据 配置结果 保存配置 ✅ completed P2 FE-SK001 6h AI-Frontend-31
FE-INT-S004 系统设置 WinNode配置交互 节点信息 配置结果 保存配置 ✅ completed P2 FE-SK001 6h AI-Frontend-31

附录B：前端开发规范

说明：本附录定义前端开发的技术规范，包括技术栈、项目结构、组件规范、状态管理和API交互规范。

B.1 技术栈与架构

核心技术栈

层级 技术 版本 说明
框架 React 18.x UI框架
脚手架 Umi 4.x 企业级前端框架
UI库 Ant Design 5.x 组件库
状态管理 dva @umijs/max内置 全局状态管理
请求库 axios + umi-request latest HTTP请求
路由 Umi Router 内置 约定式路由
构建工具 Webpack 5.x 打包工具
类型检查 TypeScript 4.x 类型安全
样式 Less + CSS Modules - 样式方案

项目结构

dashboard/
├── config/                    # 配置文件
│   ├── config.ts             # 主配置
│   ├── routes.ts             # 路由配置
│   └── proxy.ts              # 代理配置
├── src/
│   ├── components/           # 组件
│   │   ├── business/        # 业务组件
│   │   │   ├── ProductTable/
│   │   │   ├── OrderTable/
│   │   │   └── TaskTable/
│   │   ├── common/          # 通用组件
│   │   │   ├── StatusTag/
│   │   │   ├── ConfirmModal/
│   │   │   └── PageHeader/
│   │   └── charts/          # 图表组件
│   │       ├── SalesChart/
│   │       └── ProfitChart/
│   ├── layouts/             # 布局组件
│   │   ├── BasicLayout.tsx
│   │   ├── BlankLayout.tsx
│   │   └── components/
│   ├── pages/               # 页面组件
│   │   ├── dashboard/
│   │   ├── products/
│   │   │   ├── list/
│   │   │   ├── detail/
│   │   │   └── components/
│   │   ├── orders/
│   │   ├── tasks/
│   │   ├── analytics/
│   │   ├── compliance/
│   │   └── settings/
│   ├── models/              # 状态管理
│   │   ├── product.ts
│   │   ├── order.ts
│   │   ├── task.ts
│   │   └── global.ts
│   ├── services/            # API服务
│   │   ├── product.ts
│   │   ├── order.ts
│   │   ├── task.ts
│   │   └── api.ts
│   ├── utils/               # 工具函数
│   │   ├── request.ts
│   │   ├── constants.ts
│   │   ├── helpers.ts
│   │   └── format.ts
│   ├── hooks/               # 自定义Hooks
│   │   ├── useProduct.ts
│   │   ├── useOrder.ts
│   │   └── useTable.ts
│   ├── types/               # 类型定义
│   │   ├── product.d.ts
│   │   ├── order.d.ts
│   │   └── global.d.ts
│   ├── access.ts            # 权限配置
│   └── app.ts               # 运行时配置
├── public/                  # 静态资源
├── tests/                   # 测试文件
├── package.json
├── tsconfig.json
└── README.md

B.2 组件设计规范

组件分类

分类 说明 存放路径 命名规范
页面组件 完整页面 src/pages/ PascalCase.tsx
布局组件 页面布局 src/layouts/ PascalCase.tsx
业务组件 业务相关 src/components/business/ PascalCase/index.tsx
通用组件 通用UI src/components/common/ PascalCase/index.tsx
图表组件 数据可视化 src/components/charts/ PascalCase/index.tsx

组件模板

// src/components/business/ProductTable/index.tsx
import React, { useState } from 'react';
import { Table } from 'antd';
import styles from './index.module.less';

// 类型定义
export interface ProductTableProps {
  data: Product[];
  loading?: boolean;
  onEdit?: (record: Product) => void;
  onDelete?: (record: Product) => void;
}

// 组件实现
const ProductTable: React.FC<ProductTableProps> = ({
  data,
  loading = false,
  onEdit,
  onDelete,
}) => {
  // 状态定义
  const [selectedRows, setSelectedRows] = useState<Product[]>([]);
  
  // 列定义
  const columns = [
    // ...
  ];
  
  return (
    <Table
      className={styles.table}
      columns={columns}
      dataSource={data}
      loading={loading}
      rowSelection={{
        selectedRowKeys: selectedRows.map(row => row.id),
        onChange: (_, rows) => setSelectedRows(rows),
      }}
    />
  );
};

export default ProductTable;

B.3 状态管理规范

Model规范

// src/models/product.ts
import { Effect, Reducer } from 'umi';
import { getProductList, getProductDetail } from '@/services/product';

// 状态类型
export interface ProductState {
  list: Product[];
  detail: Product | null;
  loading: boolean;
  pagination: {
    current: number;
    pageSize: number;
    total: number;
  };
}

// Model定义
export interface ProductModelType {
  namespace: 'product';
  state: ProductState;
  effects: {
    fetchList: Effect;
    fetchDetail: Effect;
  };
  reducers: {
    setList: Reducer<ProductState>;
    setDetail: Reducer<ProductState>;
    setLoading: Reducer<ProductState>;
  };
}

const ProductModel: ProductModelType = {
  namespace: 'product',
  
  state: {
    list: [],
    detail: null,
    loading: false,
    pagination: {
      current: 1,
      pageSize: 20,
      total: 0,
    },
  },
  
  effects: {
    *fetchList({ payload }, { call, put }) {
      yield put({ type: 'setLoading', payload: true });
      const response = yield call(getProductList, payload);
      yield put({ type: 'setList', payload: response.data });
      yield put({ type: 'setPagination', payload: response.pagination });
      yield put({ type: 'setLoading', payload: false });
    },
    
    *fetchDetail({ payload: id }, { call, put }) {
      yield put({ type: 'setLoading', payload: true });
      const response = yield call(getProductDetail, id);
      yield put({ type: 'setDetail', payload: response.data });
      yield put({ type: 'setLoading', payload: false });
    },
  },
  
  reducers: {
    setList(state, { payload }) {
      return { ...state, list: payload };
    },
    setDetail(state, { payload }) {
      return { ...state, detail: payload };
    },
    setLoading(state, { payload }) {
      return { ...state, loading: payload };
    },
  },
};

export default ProductModel;

B.4 API交互规范

Service规范

// src/services/product.ts
import request from '@/utils/request';
import { ProductListParams, CreateProductData, UpdateProductData, PricingData } from '@/types/product';

/**
 * 获取商品列表
 * @param params 查询参数
 */
export async function getProductList(params: ProductListParams) {
  return request('/api/products', {
    method: 'GET',
    params,
  });
}

/**
 * 获取商品详情
 * @param id 商品ID
 */
export async function getProductDetail(id: string) {
  return request(`/api/products/${id}`, {
    method: 'GET',
  });
}

/**
 * 创建商品
 * @param data 商品数据
 */
export async function createProduct(data: CreateProductData) {
  return request('/api/products', {
    method: 'POST',
    data,
  });
}

/**
 * 更新商品
 * @param id 商品ID
 * @param data 商品数据
 */
export async function updateProduct(id: string, data: UpdateProductData) {
  return request(`/api/products/${id}`, {
    method: 'PUT',
    data,
  });
}

/**
 * 删除商品
 * @param id 商品ID
 */
export async function deleteProduct(id: string) {
  return request(`/api/products/${id}`, {
    method: 'DELETE',
  });
}

/**
 * 更新商品价格
 * @param id 商品ID
 * @param data 定价数据
 */
export async function updateProductPrice(id: string, data: PricingData) {
  return request(`/api/products/${id}/price`, {
    method: 'POST',
    data,
  });
}

/**
 * 同步商品到平台
 * @param id 商品ID
 * @param platform 平台名称
 */
export async function syncProductToPlatform(id: string, platform: string) {
  return request(`/api/products/${id}/sync`, {
    method: 'POST',
    data: { platform },
  });
}

Request封装

// src/utils/request.ts
import { extend, RequestOptionsInit } from 'umi-request';
import { notification } from 'antd';

const codeMessage: Record<number, string> = {
  200: '服务器成功返回请求的数据。',
  201: '新建或修改数据成功。',
  202: '一个请求已经进入后台排队（异步任务）。',
  204: '删除数据成功。',
  400: '发出的请求有错误，服务器没有进行新建或修改数据的操作。',
  401: '用户没有权限（令牌、用户名、密码错误）。',
  403: '用户得到授权，但是访问是被禁止的。',
  404: '发出的请求针对的是不存在的记录，服务器没有进行操作。',
  406: '请求的格式不可得。',
  410: '请求的资源被永久删除，且不会再得到的。',
  422: '当创建一个对象时，发生一个验证错误。',
  500: '服务器发生错误，请检查服务器。',
  502: '网关错误。',
  503: '服务不可用，服务器暂时过载或维护。',
  504: '网关超时。',
};

/**
 * 异常处理程序
 */
const errorHandler = (error: { response: Response }): Response => {
  const { response } = error;
  
  if (response && response.status) {
    const errorText = codeMessage[response.status] || response.statusText;
    const { status, url } = response;

    notification.error({
      message: `请求错误 ${status}: ${url}`,
      description: errorText,
    });
    
    // 401 未授权，跳转到登录页
    if (status === 401) {
      window.location.href = '/login';
    }
  } else if (!response) {
    notification.error({
      description: '您的网络发生异常，无法连接服务器',
      message: '网络异常',
    });
  }
  
  return response;
};

/**
 * 配置request请求时的默认参数
 */
const request = extend({
  errorHandler,
  // 默认错误处理
  credentials: 'include', // 默认请求是否带上cookie
});

// 请求拦截器
request.interceptors.request.use((url, options) => {
  // 添加token
  const token = localStorage.getItem('token');
  if (token) {
    options.headers = {
      ...options.headers,
      Authorization: `Bearer ${token}`,
    };
  }
  return { url, options };
});

// 响应拦截器
request.interceptors.response.use(async (response) => {
  const data = await response.clone().json();
  
  if (data.code !== 200) {
    notification.error({
      message: '请求失败',
      description: data.message || '未知错误',
    });
  }
  
  return response;
});

export default request;

B.5 路由与权限规范

路由配置

// config/routes.ts
export default [
  {
    path: '/',
    component: '@/layouts/BasicLayout',
    routes: [
      { path: '/', redirect: '/dashboard' },
      {
        path: '/dashboard',
        name: '工作台',
        icon: 'DashboardOutlined',
        component: '@/pages/dashboard',
        access: 'dashboard:read',
      },
      {
        path: '/products',
        name: '商品中心',
        icon: 'ShoppingOutlined',
        access: 'product:read',
        routes: [
          {
            path: '/products/list',
            name: '商品列表',
            component: '@/pages/products/list',
            access: 'product:read',
          },
          {
            path: '/products/detail/:id',
            name: '商品详情',
            component: '@/pages/products/detail',
            hideInMenu: true,
            access: 'product:read',
          },
          {
            path: '/products/create',
            name: '新增商品',
            component: '@/pages/products/create',
            hideInMenu: true,
            access: 'product:create',
          },
        ],
      },
      {
        path: '/orders',
        name: '订单中心',
        icon: 'FileTextOutlined',
        access: 'order:read',
        routes: [
          {
            path: '/orders/list',
            name: '订单列表',
            component: '@/pages/orders/list',
            access: 'order:read',
          },
          {
            path: '/orders/detail/:id',
            name: '订单详情',
            component: '@/pages/orders/detail',
            hideInMenu: true,
            access: 'order:read',
          },
        ],
      },
      // ... 其他路由
    ],
  },
];

权限配置

// src/access.ts
import { InitialState } from 'umi';

export default function(initialState: InitialState) {
  const { currentUser } = initialState || {};
  const permissions = currentUser?.permissions || [];
  const role = currentUser?.role || '';
  
  return {
    // 工作台权限
    'dashboard:read': permissions.includes('dashboard:read'),
    
    // 商品权限
    'product:read': permissions.includes('product:read'),
    'product:create': permissions.includes('product:create'),
    'product:update': permissions.includes('product:update'),
    'product:delete': permissions.includes('product:delete'),
    'product:sync': permissions.includes('product:sync'),
    
    // 订单权限
    'order:read': permissions.includes('order:read'),
    'order:confirm': permissions.includes('order:confirm'),
    'order:ship': permissions.includes('order:ship'),
    'order:cancel': permissions.includes('order:cancel'),
    'order:refund': permissions.includes('order:refund'),
    
    // 任务权限
    'task:read': permissions.includes('task:read'),
    'task:retry': permissions.includes('task:retry'),
    'task:cancel': permissions.includes('task:cancel'),
    
    // 数据权限
    'analytics:read': permissions.includes('analytics:read'),
    'analytics:export': permissions.includes('analytics:export'),
    
    // 合规权限
    'compliance:read': permissions.includes('compliance:read'),
    'compliance:upload': permissions.includes('compliance:upload'),
    'compliance:audit': permissions.includes('compliance:audit'),
    
    // 设置权限（仅ADMIN）
    'settings:read': role === 'ADMIN',
    'settings:update': role === 'ADMIN',
  };
}

补充说明：

  1. 本附录内容基于参考文档的前端开发规范，与现有58个业务闭环保持一致
  2. 所有技术栈选择遵循项目特定规则中的约束
  3. 组件规范和状态管理规范与Business_ClosedLoops.md中的前端交互规范对应
  4. API交互规范遵循五元组追踪要求

📚 相关文档

文档 路径 说明
Business ClosedLoops ./Business_ClosedLoops.md 58个业务闭环详细定义，包含流程、决策点、状态机
AI Strategy ../05_AI/AI_Strategy.md AI协作策略、节点自动决策体系、规则引擎
System Architecture ../01_Architecture/System_Architecture.md 系统架构设计
State Machine ../01_Architecture/STATE_MACHINE.md 状态机定义
Backend Design ../02_Backend/Backend_Design.md 后端设计规范
Frontend Design ../03_Frontend/Frontend_Design.md 前端设计规范
Governance Standards ./Governance_Standards.md 治理与审批标准

最后更新时间：2026-03-19 维护者：Crawlful Hub AI Team

Reference in New Issue View Git Blame Copy Permalink