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

2585 lines
161 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🗂 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-001~~005, FE-AILOG-001~~003** | **AI决策日志系统（全链路追溯）** | **AIDecisionLogService.ts, AIDecisionLog/index.tsx** | **16h** | **✅ 已完成** |
| **PKG-AI-AUTO** | **BE-AIAUTO-001~~004, FE-AIAUTO-001~~003** | **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方案
**已完成**:
- [x] \[MOCK-001] 创建DataSource接口定义 (`/dashboard/src/types/datasource.ts`)
- [x] \[MOCK-002] 实现证书DataSource (`/dashboard/src/services/certificateDataSource.ts`)
- [x] \[MOCK-003] 配置MSW拦截器 (`/dashboard/src/mock/msw.ts`)
- [x] \[MOCK-004] 入口文件MSW启动 (`/dashboard/src/app.ts`)
- [x] \[MOCK-005] BFF层Mock切换器 (`/server/src/bff/services/certificateService.ts`)
- [x] \[MOCK-006] BFF层Mock服务 (`/server/src/bff/mock/certificateMock.ts`)
- [x] \[MOCK-011] 环境变量配置 (`.env.development`, `.env.production`)
- [x] \[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](../01_Architecture/Mock_Architecture.md)
***
### 🔴 P0 - 紧急功能（阻塞核心业务）
#### 1. 多商户收益排行榜系统（信任引擎）🔥 ✅
**状态**: ✅ 已完成\
**优先级**: P0 - 紧急\
**预计开发时间**: 16小时\
**实际完成时间**: 2026-03-19
**已完成**:
- [x] `cf_merchant_metrics` 表结构
- [x] `cf_leaderboard_snapshot` 表结构
- [x] `MerchantMetricsService` 服务（指标计算、存储、查询、验证）
- [x] `LeaderboardService` 服务（排行生成、缓存、防作弊、自动刷新）
- [x] 排行榜API端点（收益榜/ROI榜/增长榜）
- [x] 防作弊逻辑（订单数校验、高增长验证）
- [x] 前端 `Leaderboard` 页面
- [x] TOP 10 商户展示
- [x] 商户排名查询
- [x] 系统导航集成
#### 2. 策略市场（Strategy Marketplace）🔥 ✅
**状态**: ✅ 已完成\
**优先级**: P0 - 紧急\
**预计开发时间**: 20小时\
**实际完成时间**: 2026-03-19
**已完成**:
- [x] `cf_strategies` 表结构
- [x] `cf_merchant_strategies` 表结构
- [x] `StrategyService` 服务（策略管理、激活、暂停、完成、统计更新）
- [x] `StrategyRecommendationService` 服务（个性化推荐、分类推荐、相似策略、趋势策略）
- [x] 策略推荐算法（评分计算、ROI预估、置信度评估）
- [x] 策略激活API（激活/暂停/恢复/完成）
- [x] 前端 `StrategyMarketplace` 页面
- [x] 策略分类Tabs（市场/精选/趋势/推荐/我的策略）
- [x] 策略卡片展示（ROI/成功率/使用次数/价格）
- [x] 策略详情Modal
- [x] 我的策略管理（激活/暂停/恢复）
#### 3. 自动选品+自动上架系统（增长引擎）🔥 ✅
**状态**: ✅ 已完成\
**优先级**: P0 - 紧急\
**预计开发时间**: 24小时\
**实际完成时间**: 2026-03-20
**目标**: 自动找到赚钱商品 → 自动卖
**已完成**:
- [x] `cf_selection_rules` 表结构（选品规则）
- [x] `cf_product_pool` 表结构（商品池）
- [x] `cf_listing_tasks` 表结构（上架任务）
- [x] `ProductSelectionService` 服务（规则管理、商品池管理、选品执行、评分算法）
- [x] `AutoListingService` 服务（配置管理、任务管理、批量上架、平台集成）
- [x] AI选品算法（评分/ROI预估/多维度权重）
- [x] 自动上架任务队列（BullMQ）
- [x] 前端 `AutoProductSelection` 页面（商品池管理、选品规则、上架任务、系统配置）
- [x] Mock架构实现（productSelection.mock.ts + productSelectionDataSource.ts）
- [x] 平台选择（1688/Amazon/TikTok/eBay/独立站）
- [x] 选品评分可视化（雷达图展示）
- [x] 上架任务实时监控
### 🟠 P1 - 高优先级功能
#### 4. AI店铺托管（AutoPilot）🔥 ✅
**状态**: ✅ 已完成\
**优先级**: P1 - 高\
**任务包**: PKG-AUTOPILOT\
**预计开发时间**: 20小时\
**实际完成时间**: 2026-03-19
**已完成**:
- [x] `AutoPilotService` 服务
- [x] 托管调度器
- [x] 托管状态管理
- [x] 托管日志记录
- [x] 紧急停止机制
- [x] 前端 `AutoPilot` 控制台
#### 5. 跨平台套利系统完善🔥 ✅
**状态**: ✅ 已完成\
**优先级**: P1 - 高\
**任务包**: PKG-ARBITRAGE\
**预计开发时间**: 12小时\
**实际完成时间**: 2026-03-19
**已完成**:
- [x] `arbitrage_products` 表结构
- [x] 自动价格对比
- [x] 自动上架TikTok
- [x] 套利ROI计算
- [x] 套利监控
- [x] 前端套利监控页面
#### 6. AI动态定价系统完善🔥 ✅
**状态**: ✅ 已完成\
**优先级**: P1 - 高\
**任务包**: PKG-PRICING\
**预计开发时间**: 16小时\
**实际完成时间**: 2026-03-19
**已完成**:
- [x] 竞争对手价格监控
- [x] 博弈定价算法
- [x] 提价/降价策略
- [x] 定价决策日志
- [x] A/B测试定价
- [x] 前端动态定价控制面板
#### 7. AI决策日志系统（全链路追溯）🔥 ✅
**状态**: ✅ 已完成\
**优先级**: P1 - 高\
**任务包**: PKG-AI-LOG\
**预计开发时间**: 16小时\
**实际完成时间**: 2026-03-20
**目标**: 实现"AI建议→人类确认→系统执行"全链路日志记录
**已完成**:
- [x] \[BE-AILOG-001] `cf_ai_decision_logs` 表结构（包含输入/输出/执行结果/人工干预等字段）
- [x] \[BE-AILOG-002] `AIDecisionLogService` 服务（创建日志、更新状态、记录人工干预）
- [x] \[BE-AILOG-003] 日志查询功能（支持多维度筛选、分页）
- [x] \[BE-AILOG-004] 日志统计功能（成功率、执行时间、类型分布）
- [x] \[BE-AILOG-005] 决策链路追踪（通过trace\_id查询完整链路）
- [x] \[BE-AILOG-006] Redis缓存支持
- [x] \[BE-AILOG-007] EventBus事件发布
- [x] \[FE-AILOG-001] 日志查询页面（表格展示、筛选、分页）
- [x] \[FE-AILOG-002] 统计面板（总决策数、成功率、趋势图、类型分布）
- [x] \[FE-AILOG-003] 日志详情抽屉（基本信息、输入参数、决策选项、执行结果、人工干预）
- \[FE-AILOG-003] 日志统计仪表盘
**技术要点**:
- 全链路ID关联 (operation\_id, trace\_id)
- 日志类型分类 (AI建议/人工审核/系统执行)
- 权限控制 (ADMIN/FINANCE可查看)
- 数据脱敏 (敏感字段)
#### 8. 多租户基础架构（商户→部门→店铺）🔥 ✅
**状态**: ✅ 已完成\
**优先级**: P1 - 高\
**任务包**: PKG-MULTI-TENANT-BASE\
**预计开发时间**: 24小时\
**实际完成时间**: 2026-03-20
**目标**: 实现商户→部门→店铺三层架构的数据隔离和权限控制
**已完成**:
- [x] \[BE-MT001] `DataIsolationService` 服务（数据隔离查询构建、访问权限验证、层级节点管理）
- [x] \[BE-MT001-01] 构建数据隔离查询条件（支持租户/部门/店铺三级隔离）
- [x] \[BE-MT001-02] 验证数据访问权限（单条/批量验证）
- [x] \[BE-MT001-03] 获取用户可见的层级节点列表
- [x] \[BE-MT001-04] 构建层级树结构
- [x] \[BE-MT002] `HierarchyAuthMiddleware` 中间件（层级权限认证、上下文构建）
- [x] \[BE-MT002-01] 创建层级认证中间件
- [x] \[BE-MT002-02] 构建数据隔离上下文
- [x] \[BE-MT002-03] 验证层级选择器
- [x] \[BE-MT002-04] 数据隔离查询包装器
- [x] \[BE-MT002-05] 角色检查中间件
- [x] \[BE-MT002-06] 权限检查中间件
- [x] \[BE-MT002-07] `HierarchyService` 服务（层级结构管理、部门/店铺CRUD）
- [x] \[FE-MT001] `HierarchySelector` 前端组件（三级联动选择器）
- [x] \[FE-MT001-01] 支持Cascader/TreeSelect/Select三种模式
- [x] \[FE-MT001-02] 支持商户→部门→店铺三级联动
- [x] \[FE-MT001-03] 支持状态显示和平台标签
**技术要点**:
- 三层架构：商户(TENANT) → 部门(DEPARTMENT) → 店铺(SHOP)
- 数据隔离规则预定义（cf\_product, cf\_order, cf\_customer等）
- Redis缓存支持
- EventBus事件发布
- 软删除支持
#### 9. AI决策自动化配置（渐进式演进）🔥 ✅ 🆕
**状态**: ✅ 已完成\
**优先级**: P1 - 高\
**任务包**: PKG-AI-AUTO\
**预计开发时间**: 12小时\
**实际完成时间**: 2026-03-19
**已完成**:
- [x] \[BE-AIAUTO-001] `cf_auto_execution_config` 表结构
- [x] \[BE-AIAUTO-002] `AutoExecutionConfigService` 服务
- [x] \[BE-AIAUTO-003] 自动执行阈值校验中间件
- [x] \[BE-AIAUTO-004] 自动化等级管理API
- [x] \[FE-AIAUTO-001] 自动化配置页面
- [x] \[FE-AIAUTO-002] 阈值配置表单
- [x] \[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` | 采集策略、通讯协议 |
**关键规则速查**：
```yaml
数据库:
- 表前缀: 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 |
| <br /> | <br /> | <br /> | <br /> | <br /> | <br /> | <br /> | <br /> | <br /> | <br /> | <br /> |
***
## 🔧 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 |
<details>
<summary>📋 BE-P006/BE-P007 任务详情卡片</summary>
**任务目标**: 在 `PlatformApiService.ts` 中实现 eBay/Shopee API 对接
**参考文件**:
- 主文件: `server/src/services/PlatformApiService.ts`
- 参考实现: `syncAmazonProducts()` 方法
- Worker: `server/src/workers/PlatformSyncWorker.ts`
**实现要求**:
```typescript
// 在 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 中定义的限流规则
**验收标准**:
- [x] 方法签名与 Amazon 实现一致
- [x] 日志包含五元组信息
- [x] 错误处理完整
- [x] 通过 TypeScript 编译
</details>
| 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 |
<details>
<summary>📋 BE-AD001/BE-AD002/BE-AD003 任务详情卡片</summary>
**任务目标**: 实现广告计划管理、投放引擎和ROI计算
**参考文件**:
- 服务文件: `server/src/services/AdPlanService.ts` (需创建)
- 数据模型: `server/src/models/AdPlan.ts`, `server/src/models/AdCampaign.ts`
- Worker: `server/src/workers/AdSyncWorker.ts`
**数据库表设计**:
```sql
-- 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
);
```
**实现要求**:
```typescript
// 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`
**验收标准**:
- [x] 数据库表已创建（带 cf\_ 前缀）
- [x] 服务类命名符合规范（XxxService）
- [x] 日志包含五元组信息
- [x] ROI计算精度正确（保留2位小数）
</details>
### 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 |
<details>
<summary>📋 BE-SR001/BE-SR002/BE-SR003 任务详情卡片</summary>
**任务目标**: 实现退货处理、退款流程和售后工单系统
**参考文件**:
- 服务文件: `server/src/services/AfterSalesService.ts` (需创建)
- 数据模型: `server/src/models/ReturnOrder.ts`, `server/src/models/RefundRecord.ts`, `server/src/models/ServiceTicket.ts`
**数据库表设计**:
```sql
-- 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
);
```
**实现要求**:
```typescript
// 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\_ 前缀）
- [ ] 状态机流程正确
- [ ] 五元组字段完整
- [ ] 退款金额精度正确
</details>
### 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 |
<details>
<summary>📋 BE-TOB001/BE-TOB002/BE-TOB003 任务详情卡片</summary>
**任务目标**: 实现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`
**数据库表设计**:
```sql
-- 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
);
```
**实现要求**:
```typescript
// 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. 信用额度检查必须在下单前执行
**验收标准**:
- [x] 阶梯价计算逻辑正确
- [x] 利润红线校验已实现
- [x] 五元组字段完整
- [x] 信用额度检查已实现
</details>
### 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 |
<details>
<summary>📋 BE-MV001~BE-MV008 多商户功能任务详情卡片</summary>
**任务目标**: 实现多商户入驻、功能模块化、费用结算等核心功能
**参考文件**:
- 服务文件: `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`
**数据库表设计**:
```sql
-- 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
);
```
**实现要求**:
```typescript
// 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`
**验收标准**:
- [ ] 商户注册流程完整
- [ ] 功能模块配置正确
- [ ] 结算计算准确
- [ ] 五元组字段完整
</details>
### 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️⃣ 数据采集与清洗闭环](./Business_ClosedLoops.md#1️⃣-数据采集与清洗闭环product-data-collection--cleansing)
**采集策略**: 仅处理无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️⃣ 店铺隔离与自动化闭环](./Business_ClosedLoops.md#1️⃣7️⃣-店铺隔离与自动化闭环shop-isolation--automation-loop)
**核心功能**: 店铺环境隔离 + 无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 |
#### 组件模板
```typescript
// 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规范
```typescript
// 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规范
```typescript
// 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封装
```typescript
// 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 路由与权限规范
#### 路由配置
```typescript
// 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',
},
],
},
// ... 其他路由
],
},
];
```
#### 权限配置
```typescript
// 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](./Business_ClosedLoops.md) | 58个业务闭环详细定义，包含流程、决策点、状态机 |
| **AI Strategy** | [../05\_AI/AI\_Strategy.md](../05_AI/AI_Strategy.md) | AI协作策略、节点自动决策体系、规则引擎 |
| **System Architecture** | [../01\_Architecture/System\_Architecture.md](../01_Architecture/System_Architecture.md) | 系统架构设计 |
| **State Machine** | [../01\_Architecture/STATE\_MACHINE.md](../01_Architecture/STATE_MACHINE.md) | 状态机定义 |
| **Backend Design** | [../02\_Backend/Backend\_Design.md](../02_Backend/Backend_Design.md) | 后端设计规范 |
| **Frontend Design** | [../03\_Frontend/Frontend\_Design.md](../03_Frontend/Frontend_Design.md) | 前端设计规范 |
| **Governance Standards** | [./Governance\_Standards.md](./Governance_Standards.md) | 治理与审批标准 |
***
**最后更新时间**：2026-03-19
**维护者**：Crawlful Hub AI Team
Reference in New Issue View Git Blame Copy Permalink