feat: 添加MSW模拟服务和数据源集成
refactor: 重构页面组件移除冗余Layout组件 feat: 实现WebSocket和事件总线系统 feat: 添加队列和调度系统 docs: 更新架构文档和服务映射 style: 清理重复接口定义使用数据源 chore: 更新依赖项配置 feat: 添加运行时系统和领域引导 ci: 配置ESLint边界检查规则 build: 添加Redis和WebSocket依赖 test: 添加MSW浏览器环境入口 perf: 优化数据获取逻辑使用统一数据源 fix: 修复类型定义和状态管理问题
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# 📌 Crawlful Hub 业务闭环（TOC + TOB Unified Business Loops）
|
||||
|
||||
> **说明**：本闭环文档是战略层业务流程，关注"做什么、为什么做、顺序和决策点"，为下层模块功能和系统实现提供指引。TOC（零售/前端）和 TOB（B2B贸易）共享通用模块，特有流程用 `businessType` 标记。共 **50个业务闭环**。
|
||||
> **说明**：本闭环文档是战略层业务流程，关注"做什么、为什么做、顺序和决策点"，为下层模块功能和系统实现提供指引。TOC（零售/前端）和 TOB（B2B贸易）共享通用模块，特有流程用 `businessType` 标记。共 **56个业务闭环**。
|
||||
|
||||
## 📑 目录
|
||||
|
||||
@@ -54,12 +54,20 @@
|
||||
48. [跨境电商闭环](#4️⃣8️⃣-跨境电商闭环cross-border-e-commerce-loop)
|
||||
49. [AI驱动智能决策闭环](#4️⃣9️⃣-ai驱动智能决策闭环ai-driven-smart-decision-loop)
|
||||
50. [核心服务优先级闭环](#5️⃣0️⃣-核心服务优先级闭环core-service-priority-loop)
|
||||
41. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
|
||||
42. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
|
||||
43. [关键绩效指标](#📊-关键绩效指标kpi)
|
||||
44. [追踪与审计](#🔍-追踪与审计)
|
||||
45. [业务审核状态机](#📋-业务审核状态机)
|
||||
46. [说明](#💡-说明)
|
||||
51. [多商户收益排行榜系统（信任引擎）](#5️⃣1️⃣-多商户收益排行榜系统信任引擎merchant-leaderboard-loop) 🆕
|
||||
52. [策略市场（Strategy Marketplace）](#5️⃣2️⃣-策略市场strategy-marketplace-loop) 🆕
|
||||
53. [自动选品+自动上架系统（增长引擎）](#5️⃣3️⃣-自动选品自动上架系统增长引擎auto-product-selection-listing-loop) 🆕
|
||||
54. [AI店铺托管（AutoPilot）](#5️⃣4️⃣-ai店铺托管autopilot-loop) 🆕
|
||||
55. [跨平台套利系统](#5️⃣5️⃣-跨平台套利系统cross-platform-arbitrage-loop) 🆕
|
||||
56. [AI动态定价系统](#5️⃣6️⃣-ai动态定价系统ai-dynamic-pricing-loop) 🆕
|
||||
57. [多店铺管理闭环](#5️⃣7️⃣-多店铺管理闭环multi-shop-management-loop) 🆕
|
||||
58. [多租户层级管理闭环](#5️⃣8️⃣-多租户层级管理闭环multi-tenant-hierarchy-loop) 🆕
|
||||
52. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
|
||||
53. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
|
||||
54. [关键绩效指标](#📊-关键绩效指标kpi)
|
||||
55. [追踪与审计](#🔍-追踪与审计)
|
||||
56. [业务审核状态机](#📋-业务审核状态机)
|
||||
57. [说明](#💡-说明)
|
||||
|
||||
***
|
||||
|
||||
@@ -2597,34 +2605,120 @@ Controller
|
||||
|
||||
## 4️⃣9️⃣ AI驱动智能决策闭环（AI-Driven Smart Decision Loop）
|
||||
|
||||
- **目标**：利用AI技术提升运营效率和决策准确性，实现智能化运营。
|
||||
- **流程**：
|
||||
1. **数据采集与处理**：
|
||||
- 多源数据整合
|
||||
- 数据清洗与预处理
|
||||
- 特征工程与选择
|
||||
2. **AI模型训练与部署**：
|
||||
- 模型选择与训练
|
||||
- 模型评估与优化
|
||||
- 模型部署与监控
|
||||
3. **智能决策应用**：
|
||||
- 智能定价与动态调价
|
||||
- 智能库存预测与补货
|
||||
- 智能广告投放与优化
|
||||
- 智能客户服务与售后
|
||||
- 智能风控与异常检测
|
||||
4. **决策执行与反馈**：
|
||||
- 决策执行与监控
|
||||
- 效果评估与分析
|
||||
- 模型迭代与优化
|
||||
- **目标**：利用AI技术提升运营效率和决策准确性，实现"AI主导决策 + 人类验证 + 操作执行 + 日志记录"的智能化运营。
|
||||
- **核心理念**：
|
||||
- **AI建议为主**：AI生成策略、推荐操作、人类只作为参考或最终确认
|
||||
- **人类介入可控**：前期可高干预，AI越强介入越低，最后趋近于完全自动
|
||||
- **操作可追踪**：每次AI建议、用户操作和系统执行都要有LOG，保证可审计性
|
||||
|
||||
### 流程概览
|
||||
|
||||
```
|
||||
[AI生成决策建议] → [人类确认/修改] → [系统执行操作] → [日志记录]
|
||||
```
|
||||
|
||||
### 详细流程
|
||||
|
||||
#### 1. AI生成决策建议
|
||||
- **输入**：历史数据 + 实时数据 + 规则库
|
||||
- **输出示例**：
|
||||
```json
|
||||
{
|
||||
"action": "调整价格",
|
||||
"params": {"sku": "A123", "new_price": 88.5},
|
||||
"confidence": 0.92,
|
||||
"risk_level": "low",
|
||||
"alternative_solutions": [
|
||||
{"action": "促销折扣", "params": {"sku":"A123", "discount":10}, "confidence":0.85}
|
||||
]
|
||||
}
|
||||
```
|
||||
- **设计要点**：
|
||||
- 每个建议带 **置信度、风险等级、替代方案**
|
||||
- 支持多维度评分（收益、风险、用户体验）
|
||||
|
||||
#### 2. 人类确认/修改
|
||||
- **UI/插件端展示**：
|
||||
- 建议动作、参数、风险提示
|
||||
- 支持修改参数或拒绝
|
||||
- 可选"自动执行模式"，允许置信度高于阈值自动执行
|
||||
- **记录内容**：
|
||||
- 谁确认/修改
|
||||
- 修改内容及理由
|
||||
- 时间戳
|
||||
|
||||
#### 3. 系统执行操作
|
||||
- **执行方式**：API调用 / 脚本执行 / 自动化任务
|
||||
- **失败重试策略**：
|
||||
- 可配置重试次数
|
||||
- 超时或失败记录到日志
|
||||
- **成功后**：返回执行状态，更新状态数据库
|
||||
|
||||
#### 4. 日志记录
|
||||
- **全链路ID关联**：每条操作有唯一ID，AI建议→人操作→系统执行关联
|
||||
- **日志结构示例**：
|
||||
```json
|
||||
{
|
||||
"operation_id": "20260319-001",
|
||||
"ai_suggestion": {
|
||||
"action": "调整价格",
|
||||
"params": {"sku": "A123", "new_price": 88.5},
|
||||
"confidence": 0.92,
|
||||
"timestamp": "2026-03-19T00:00:00"
|
||||
},
|
||||
"human_review": {
|
||||
"operator": "操作员姓名",
|
||||
"modified_params": {"new_price": 89.0},
|
||||
"reason": "小幅提升利润",
|
||||
"timestamp": "2026-03-19T00:05:00"
|
||||
},
|
||||
"system_execution": {
|
||||
"status": "success",
|
||||
"timestamp": "2026-03-19T00:06:00"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 自动化程度演进
|
||||
|
||||
| 阶段 | AI角色 | 人类角色 | 说明 |
|
||||
|------|--------|----------|------|
|
||||
| **初期** | 建议生成 | 审核确认 | 人工操作占主导 |
|
||||
| **中期** | 自动执行（高置信度） | 异常处理 | 对置信度高、低风险的操作可自动执行 |
|
||||
| **后期** | 全链路决策 | 仅异常介入 | AI全链路决策 + 自动执行 |
|
||||
|
||||
### 角色与权限
|
||||
|
||||
| 角色 | 权限 | 备注 |
|
||||
|------|------|------|
|
||||
| AI Agent | 决策生成、数据分析、风险评估 | 输出建议，带置信度 |
|
||||
| 人类操作者 | 审核/修改/确认 | 前期高干预，后期可降低 |
|
||||
| 系统执行层 | 自动化操作执行 | 仅执行经过确认的操作 |
|
||||
| 日志管理系统 | 全链路记录 | 可回溯，每条操作打时间戳 |
|
||||
|
||||
### 智能决策应用场景
|
||||
|
||||
1. **智能定价与动态调价**
|
||||
2. **智能库存预测与补货**
|
||||
3. **智能广告投放与优化**
|
||||
4. **智能客户服务与售后**
|
||||
5. **智能风控与异常检测**
|
||||
|
||||
- **决策点**：
|
||||
- 模型选择（监督学习vs无监督学习）
|
||||
- 预测结果置信度阈值
|
||||
- 人工干预时机
|
||||
- 模型更新频率
|
||||
- 自动执行阈值设定
|
||||
- **输入**：业务数据、市场数据、用户行为数据
|
||||
- **输出**：智能决策建议、预测结果、优化方案
|
||||
- **状态机**：`DATA_COLLECTION` → `MODEL_TRAINING` → `DECISION_MAKING` → `EXECUTION` → `FEEDBACK`
|
||||
- **输出**：智能决策建议、预测结果、优化方案、执行日志
|
||||
- **状态机**：`DATA_COLLECTION` → `AI_SUGGESTION` → `HUMAN_REVIEW` → `EXECUTION` → `LOGGING` → `FEEDBACK`
|
||||
- **关键指标**：
|
||||
- AI建议采纳率
|
||||
- 自动执行比例
|
||||
- 人工干预次数
|
||||
- 决策准确率
|
||||
- 执行成功率
|
||||
|
||||
***
|
||||
|
||||
@@ -2659,6 +2753,474 @@ Controller
|
||||
|
||||
***
|
||||
|
||||
## 5️⃣1️⃣ 多商户收益排行榜系统（信任引擎）（Merchant Leaderboard Loop）🆕
|
||||
|
||||
- **目标**：让用户看到"别人赚钱了" → 促进付费，建立信任和转化
|
||||
- **流程**：
|
||||
1. **数据采集**：
|
||||
- 收集商户订单数据
|
||||
- 收集广告数据
|
||||
- 收集ROI数据
|
||||
- 收集利润数据
|
||||
2. **数据汇总**：
|
||||
- 计算总收入
|
||||
- 计算总成本
|
||||
- 计算净利润
|
||||
- 计算ROI
|
||||
3. **排行计算**：
|
||||
- 收益榜排序
|
||||
- ROI榜排序
|
||||
- 增长榜排序
|
||||
4. **防作弊处理**：
|
||||
- 过滤异常订单
|
||||
- ROI上限限制
|
||||
- 新用户单独榜单
|
||||
5. **榜单展示**：
|
||||
- TOP 10 商户展示
|
||||
- ROI展示
|
||||
- 使用策略标签
|
||||
- **决策点**：
|
||||
- 排行计算频率（每10分钟）
|
||||
- 防作弊阈值设定
|
||||
- 榜单展示策略
|
||||
- **输入**：商户订单数据、广告数据、ROI数据
|
||||
- **输出**：排行榜数据、TOP 10 商户、榜单类型
|
||||
- **状态机**：`DATA_COLLECTION` → `DATA_AGGREGATION` → `RANKING_CALCULATION` → `ANTI_CHEAT` → `LEADERBOARD_DISPLAY`
|
||||
- **关键指标**：
|
||||
- 商户总数
|
||||
- 活跃商户数
|
||||
- 平均ROI
|
||||
- 最高ROI
|
||||
- 榜单更新频率
|
||||
- **数据表**：
|
||||
- `cf_merchant_metrics`：商户指标汇总表
|
||||
- `cf_leaderboard`：排行榜表
|
||||
- `cf_leaderboard_history`：排行榜历史表
|
||||
|
||||
***
|
||||
|
||||
## 5️⃣2️⃣ 策略市场（Strategy Marketplace Loop）🆕
|
||||
|
||||
- **目标**：AI赚钱能力商品化，实现功能收费闭环
|
||||
- **流程**：
|
||||
1. **策略创建**：
|
||||
- 策略类型定义（广告/定价/选品）
|
||||
- 策略配置schema
|
||||
- 策略定价模式
|
||||
- 策略ROI预估
|
||||
2. **策略发布**：
|
||||
- 策略审核
|
||||
- 策略上架
|
||||
- 策略分类
|
||||
3. **策略推荐**：
|
||||
- 基于商户数据推荐
|
||||
- 基于ROI推荐
|
||||
- 基于使用场景推荐
|
||||
4. **策略激活**：
|
||||
- 商户选择策略
|
||||
- 权限验证
|
||||
- 费用扣除
|
||||
- 策略激活
|
||||
5. **策略使用**：
|
||||
- 策略执行
|
||||
- 使用记录
|
||||
- 效果追踪
|
||||
- ROI计算
|
||||
6. **策略优化**：
|
||||
- 使用次数统计
|
||||
- ROI统计
|
||||
- 策略调整
|
||||
- **决策点**：
|
||||
- 策略定价策略
|
||||
- 策略推荐算法
|
||||
- 策略使用权限
|
||||
- **输入**：策略配置、商户数据、使用记录
|
||||
- **输出**：策略列表、推荐策略、激活状态、使用统计
|
||||
- **状态机**：`STRATEGY_CREATION` → `STRATEGY_PUBLISH` → `STRATEGY_RECOMMENDATION` → `STRATEGY_ACTIVATION` → `STRATEGY_USAGE` → `STRATEGY_OPTIMIZATION`
|
||||
- **关键指标**：
|
||||
- 策略总数
|
||||
- 活跃策略数
|
||||
- 策略使用次数
|
||||
- 平均ROI
|
||||
- 策略收益
|
||||
- **数据表**：
|
||||
- `cf_strategies`：策略表
|
||||
- `cf_merchant_strategies`：商户策略关联表
|
||||
- `cf_strategy_usage`：策略使用记录表
|
||||
- `cf_strategy_metrics`：策略指标表
|
||||
|
||||
***
|
||||
|
||||
## 5️⃣3️⃣ 自动选品+自动上架系统（增长引擎）（Auto Product Selection & Listing Loop）🆕
|
||||
|
||||
- **目标**：自动找到赚钱商品 → 自动卖，实现自动化增长
|
||||
- **流程**：
|
||||
1. **商品采集**：
|
||||
- 多平台商品采集（1688/Amazon/TikTok）
|
||||
- 商品数据清洗
|
||||
- 商品数据标准化
|
||||
2. **商品池管理**：
|
||||
- 商品入库
|
||||
- 商品分类
|
||||
- 商品去重
|
||||
3. **AI选品**：
|
||||
- 商品评分计算
|
||||
- ROI预估
|
||||
- 市场需求分析
|
||||
- 竞争度分析
|
||||
4. **选品决策**：
|
||||
- ROI阈值判断
|
||||
- 评分阈值判断
|
||||
- 预算范围判断
|
||||
5. **自动上架**：
|
||||
- 创建商品任务
|
||||
- 商品定价
|
||||
- 平台同步
|
||||
6. **效果追踪**：
|
||||
- 销售数据追踪
|
||||
- ROI计算
|
||||
- 选品效果评估
|
||||
- **决策点**：
|
||||
- 选品算法参数
|
||||
- ROI阈值设定
|
||||
- 预算范围设定
|
||||
- 自动上架策略
|
||||
- **输入**：平台商品数据、选品配置、预算范围
|
||||
- **输出**：选中商品、上架商品、效果报告
|
||||
- **状态机**：`PRODUCT_COLLECTION` → `PRODUCT_POOL_MANAGEMENT` → `AI_SELECTION` → `SELECTION_DECISION` → `AUTO_LISTING` → `EFFECT_TRACKING`
|
||||
- **关键指标**：
|
||||
- 商品池大小
|
||||
- 选品成功率
|
||||
- 平均ROI
|
||||
- 上架成功率
|
||||
- 自动化率
|
||||
- **数据表**：
|
||||
- `cf_products_pool`：商品池表
|
||||
- `cf_merchant_products`：商户商品表
|
||||
- `cf_product_selection_logs`：选品记录表
|
||||
- `cf_product_metrics`：商品指标表
|
||||
|
||||
***
|
||||
|
||||
## 5️⃣4️⃣ AI店铺托管（AutoPilot Loop）🆕
|
||||
|
||||
- **目标**：替用户运营店铺，实现全自动运营
|
||||
- **流程**：
|
||||
1. **托管配置**：
|
||||
- 策略选择（选品/定价/广告）
|
||||
- 预算设置
|
||||
- 风险控制
|
||||
- 托管范围设定
|
||||
2. **托管启动**：
|
||||
- 权限验证
|
||||
- 资源分配
|
||||
- 托管服务启动
|
||||
3. **自动运营**：
|
||||
- 自动选品
|
||||
- 自动定价
|
||||
- 自动广告
|
||||
- 自动库存管理
|
||||
4. **实时监控**：
|
||||
- 销售数据监控
|
||||
- ROI监控
|
||||
- 风险监控
|
||||
- 异常检测
|
||||
5. **智能决策**：
|
||||
- 策略调整
|
||||
- 预算调整
|
||||
- 风险控制
|
||||
- 紧急停止
|
||||
6. **报告生成**：
|
||||
- 运营报告
|
||||
- ROI报告
|
||||
- 决策日志
|
||||
- **决策点**：
|
||||
- 托管策略选择
|
||||
- 预算分配策略
|
||||
- 风险控制策略
|
||||
- 紧急停止条件
|
||||
- **输入**：托管配置、商户数据、市场数据
|
||||
- **输出**：运营报告、ROI报告、决策日志
|
||||
- **状态机**：`AUTOPILOT_CONFIG` → `AUTOPILOT_START` → `AUTO_OPERATION` → `REAL_TIME_MONITORING` → `SMART_DECISION` → `REPORT_GENERATION`
|
||||
- **关键指标**：
|
||||
- 托管商户数
|
||||
- 自动化运营率
|
||||
- 平均ROI
|
||||
- 风险事件数
|
||||
- 紧急停止次数
|
||||
- **数据表**：
|
||||
- `cf_autopilot_config`：托管配置表
|
||||
- `cf_autopilot_status`：托管状态表
|
||||
- `cf_autopilot_logs`：托管日志表
|
||||
- `cf_autopilot_decisions`：托管决策表
|
||||
|
||||
***
|
||||
|
||||
## 5️⃣5️⃣ 跨平台套利系统（Cross-Platform Arbitrage Loop）🆕
|
||||
|
||||
- **目标**：低买高卖，实现跨平台套利
|
||||
- **流程**：
|
||||
1. **价格监控**：
|
||||
- 多平台价格采集
|
||||
- 价格对比分析
|
||||
- 价格趋势分析
|
||||
2. **套利机会识别**：
|
||||
- 价格差计算
|
||||
- ROI计算
|
||||
- 利润计算
|
||||
- 风险评估
|
||||
3. **套利决策**：
|
||||
- 利润阈值判断
|
||||
- ROI阈值判断
|
||||
- 风险评估
|
||||
4. **自动执行**：
|
||||
- 采购下单
|
||||
- 平台上架
|
||||
- 库存同步
|
||||
5. **套利监控**：
|
||||
- 订单状态监控
|
||||
- 利润追踪
|
||||
- 风险监控
|
||||
6. **套利结算**：
|
||||
- 利润核算
|
||||
- 费用扣除
|
||||
- 收益分配
|
||||
- **决策点**：
|
||||
- 套利阈值设定
|
||||
- 风险控制策略
|
||||
- 执行策略（自动/手动）
|
||||
- 结算策略
|
||||
- **输入**：多平台价格数据、套利配置、风险参数
|
||||
- **输出**：套利机会、套利订单、利润报告
|
||||
- **状态机**：`PRICE_MONITORING` → `ARBITRAGE_OPPORTUNITY` → `ARBITRAGE_DECISION` → `AUTO_EXECUTION` → `ARBITRAGE_MONITORING` → `ARBITRAGE_SETTLEMENT`
|
||||
- **关键指标**：
|
||||
- 套利机会数
|
||||
- 套利成功率
|
||||
- 平均利润
|
||||
- 平均ROI
|
||||
- 风险事件数
|
||||
- **数据表**：
|
||||
- `cf_arbitrage_products`：套利商品表
|
||||
- `cf_arbitrage_opportunities`：套利机会表
|
||||
- `cf_arbitrage_orders`：套利订单表
|
||||
- `cf_arbitrage_profits`：套利利润表
|
||||
|
||||
***
|
||||
|
||||
## 5️⃣6️⃣ AI动态定价系统（AI Dynamic Pricing Loop）🆕
|
||||
|
||||
- **目标**：在竞争中最大化利润，实现博弈级定价
|
||||
- **流程**：
|
||||
1. **市场监控**：
|
||||
- 竞争对手价格监控
|
||||
- 市场需求分析
|
||||
- 库存水平监控
|
||||
- 转化率监控
|
||||
2. **定价模型**：
|
||||
- 需求预测
|
||||
- 竞争分析
|
||||
- 价格弹性计算
|
||||
- 最优价格计算
|
||||
3. **定价决策**：
|
||||
- 提价策略
|
||||
- 降价策略
|
||||
- 保持策略
|
||||
- A/B测试定价
|
||||
4. **价格执行**：
|
||||
- 价格更新
|
||||
- 平台同步
|
||||
- 库存调整
|
||||
5. **效果追踪**：
|
||||
- 销售数据追踪
|
||||
- 利润追踪
|
||||
- 转化率追踪
|
||||
- ROI计算
|
||||
6. **模型优化**：
|
||||
- 效果分析
|
||||
- 模型调整
|
||||
- 策略优化
|
||||
- **决策点**：
|
||||
- 定价策略选择
|
||||
- 提价/降价阈值
|
||||
- A/B测试策略
|
||||
- 模型更新频率
|
||||
- **输入**：市场数据、竞争对手价格、销售数据
|
||||
- **输出**：最优价格、定价决策、效果报告
|
||||
- **状态机**：`MARKET_MONITORING` → `PRICING_MODEL` → `PRICING_DECISION` → `PRICE_EXECUTION` → `EFFECT_TRACKING` → `MODEL_OPTIMIZATION`
|
||||
- **关键指标**：
|
||||
- 价格调整次数
|
||||
- 平均利润率
|
||||
- 转化率
|
||||
- ROI
|
||||
- 定价准确率
|
||||
- **数据表**：
|
||||
- `cf_pricing_decisions`：定价决策表
|
||||
- `cf_pricing_history`：定价历史表
|
||||
- `cf_competitor_prices`：竞争对手价格表
|
||||
- `cf_pricing_metrics`：定价指标表
|
||||
|
||||
***
|
||||
|
||||
## 5️⃣7️⃣ 多店铺管理闭环（Multi-Shop Management Loop）🆕
|
||||
|
||||
- **目标**：实现多店铺、多商户、多部门的统一管理与数据隔离，支持独立站/外部独立站/报表等一对多交互
|
||||
- **层级架构**：
|
||||
```
|
||||
商户(Merchant) → 部门(Department) → 店铺(Shop)
|
||||
↓ ↓ ↓
|
||||
商户级数据 部门级数据 店铺级数据
|
||||
```
|
||||
- **流程**：
|
||||
1. **店铺注册与配置**：
|
||||
- 店铺类型划分（独立站/平台店/外部独立站）
|
||||
- 平台账号绑定
|
||||
- 店铺基础信息配置
|
||||
- 店铺状态管理
|
||||
2. **权限配置**：
|
||||
- 层级权限继承
|
||||
- 数据访问范围控制
|
||||
- 操作权限分配
|
||||
- 角色管理
|
||||
3. **数据隔离**：
|
||||
- 店铺级数据隔离
|
||||
- 部门级数据聚合
|
||||
- 商户级数据汇总
|
||||
- 跨店铺数据访问控制
|
||||
4. **业务操作**：
|
||||
- 商品管理（单店/批量）
|
||||
- 订单管理（单店/聚合）
|
||||
- 库存管理（单店/同步）
|
||||
- 价格管理（单店/批量）
|
||||
5. **报表聚合**：
|
||||
- 单店报表
|
||||
- 部门聚合报表
|
||||
- 商户汇总报表
|
||||
- 跨店对比分析
|
||||
- **决策点**：
|
||||
- 店铺类型划分标准
|
||||
- 数据权限边界定义
|
||||
- 报表聚合规则
|
||||
- 跨店操作权限
|
||||
- **输入**：店铺信息、商户信息、部门信息、用户角色
|
||||
- **输出**：
|
||||
- 店铺管理界面
|
||||
- 跨店铺数据报表
|
||||
- 权限控制策略
|
||||
- 数据隔离配置
|
||||
- **状态机**：`SHOP_REGISTERED` → `SHOP_CONFIGURED` → `SHOP_ACTIVE` → `SHOP_SUSPENDED` → `SHOP_CLOSED`
|
||||
- **关键指标**：
|
||||
- 店铺数量
|
||||
- 活跃店铺数
|
||||
- 跨店订单量
|
||||
- 数据隔离有效性
|
||||
- 报表生成效率
|
||||
- **数据表**：
|
||||
- `cf_shop`：店铺主表（含层级关系）
|
||||
- `cf_department`：部门表
|
||||
- `cf_merchant`：商户表
|
||||
- `cf_shop_config`：店铺配置表
|
||||
- `cf_shop_permission`：店铺权限表
|
||||
- **📋 技术实现指引**：
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
| -- | ------- | ------ | ---- |
|
||||
| 后端 | 数据隔离服务 | `DataIsolationService.ts` | BE-MT001 |
|
||||
| 后端 | 层级权限中间件 | `HierarchyAuthMiddleware.ts` | BE-MT002 |
|
||||
| 后端 | 订单聚合服务 | `OrderAggregationService.ts` | BE-ORDER-MS001 |
|
||||
| 后端 | 报表聚合服务 | `ShopReportAggregationService.ts` | BE-SHOP-REP001 |
|
||||
| 前端 | 层级选择器组件 | `HierarchySelector.tsx` | FE-MT001 |
|
||||
| 前端 | 多店铺管理页面 | `MerchantManage.tsx, ShopManage.tsx` | FE-MT002 |
|
||||
| 前端 | 订单多店铺页面 | `OrderMultiShopList.tsx, OrderAggregate.tsx` | FE-ORDER-MS001, FE-ORDER-MS002 |
|
||||
| 前端 | 多店铺报表页面 | `MultiShopReport.tsx` | FE-SHOP-REP001 |
|
||||
|
||||
***
|
||||
|
||||
## 5️⃣8️⃣ 多租户层级管理闭环（Multi-Tenant Hierarchy Loop）🆕
|
||||
|
||||
- **目标**：实现商户→部门→店铺三层架构的完整管理，确保数据隔离和权限控制
|
||||
- **层级模型**：
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ 商户(Merchant) │
|
||||
│ - 商户ID (merchantId) │
|
||||
│ - 商户名称、联系方式、认证状态 │
|
||||
│ - 商户级配置、计费信息 │
|
||||
└────────────────────┬────────────────────────────────────┘
|
||||
│ 1:N
|
||||
┌───────────┴───────────┐
|
||||
▼ ▼
|
||||
┌─────────────────┐ ┌─────────────────┐
|
||||
│ 部门(Department) │ │ 部门(Department) │
|
||||
│ - 部门ID (deptId) │ │ - 部门ID (deptId) │
|
||||
│ - 部门名称、负责人 │ │ - 部门名称、负责人 │
|
||||
└────────┬────────┘ └────────┬────────┘
|
||||
│ 1:N │ 1:N
|
||||
▼ ▼
|
||||
┌─────────────────┐ ┌─────────────────┐
|
||||
│ 店铺(Shop) │ │ 店铺(Shop) │
|
||||
│ - 店铺ID (shopId) │ │ - 店铺ID (shopId) │
|
||||
│ - 平台、店铺类型 │ │ - 平台、店铺类型 │
|
||||
└─────────────────┘ └─────────────────┘
|
||||
```
|
||||
- **流程**：
|
||||
1. **商户入驻**：
|
||||
- 商户注册与认证
|
||||
- 商户信息完善
|
||||
- 商户计费配置
|
||||
- 商户权限初始化
|
||||
2. **部门创建**：
|
||||
- 部门信息录入
|
||||
- 部门负责人分配
|
||||
- 部门权限配置
|
||||
- 部门成员管理
|
||||
3. **店铺绑定**：
|
||||
- 店铺创建/导入
|
||||
- 店铺归属部门
|
||||
- 店铺类型配置
|
||||
- 店铺权限设置
|
||||
4. **层级数据隔离**：
|
||||
- 商户级：所有下属数据可见
|
||||
- 部门级：本部门及下属店铺数据可见
|
||||
- 店铺级：仅本店铺数据可见
|
||||
5. **跨层级操作**：
|
||||
- 上级可查看下级数据
|
||||
- 下级不可查看上级数据
|
||||
- 同级数据相互隔离
|
||||
- **决策点**：
|
||||
- 层级深度限制
|
||||
- 数据继承规则
|
||||
- 权限传递规则
|
||||
- 跨层级操作审批
|
||||
- **输入**：商户信息、部门信息、店铺信息、用户角色
|
||||
- **输出**：
|
||||
- 层级结构管理界面
|
||||
- 数据隔离配置
|
||||
- 权限分配结果
|
||||
- 层级报表
|
||||
- **状态机**：
|
||||
- 商户：`MERCHANT_PENDING` → `MERCHANT_VERIFIED` → `MERCHANT_ACTIVE` → `MERCHANT_SUSPENDED`
|
||||
- 部门：`DEPT_CREATED` → `DEPT_ACTIVE` → `DEPT_SUSPENDED`
|
||||
- 店铺：`SHOP_REGISTERED` → `SHOP_ACTIVE` → `SHOP_SUSPENDED`
|
||||
- **关键指标**：
|
||||
- 商户数量
|
||||
- 部门数量
|
||||
- 店铺数量
|
||||
- 层级数据隔离有效性
|
||||
- 权限配置准确性
|
||||
- **数据表**：
|
||||
- `cf_merchant`：商户主表
|
||||
- `cf_department`：部门表（含商户ID、父部门ID）
|
||||
- `cf_shop`：店铺表（含商户ID、部门ID）
|
||||
- `cf_user_hierarchy`：用户层级关系表
|
||||
- **📋 技术实现指引**：
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
| -- | ------- | ------ | ---- |
|
||||
| 后端 | 层级服务 | `HierarchyService.ts` | BE-MT001 |
|
||||
| 后端 | 层级权限中间件 | `HierarchyAuthMiddleware.ts` | BE-MT002 |
|
||||
| 前端 | 层级选择器 | `HierarchySelector.tsx` | FE-MT001 |
|
||||
| 前端 | 层级管理页面 | `HierarchyManage.tsx` | FE-MT002 |
|
||||
|
||||
***
|
||||
|
||||
### 📋 业务审核状态机
|
||||
|
||||
- **通用审核流程**：`SUBMITTED` (提交) → `PENDING_REVIEW` (人工审核) → `EXECUTED` / `REJECTED`
|
||||
|
||||
@@ -1,218 +0,0 @@
|
||||
# Business_ClosedLoops.md 分析报告
|
||||
|
||||
## 闭环状态分析
|
||||
|
||||
经过分析，`Business_ClosedLoops.md` 文件的当前状态如下：
|
||||
|
||||
### 1. 多商户相关闭环状态
|
||||
- ✅ 多商户相关闭环已全部添加详细内容：
|
||||
- 31. 多商户入驻与认证闭环
|
||||
- 32. 功能模块化与权限控制闭环
|
||||
- 33. 功能开通与支付闭环
|
||||
- 34. 多商户结算与财务闭环
|
||||
- 35. 多商户商品与订单管理闭环
|
||||
|
||||
### 2. 新增闭环
|
||||
- **46. 技术基础设施闭环**：提供稳定、高效、可扩展的技术基础设施
|
||||
- **47. 客户服务闭环**：提供高效、专业的客户服务
|
||||
- **48. 跨境电商闭环**：支持跨境电商全流程，解决清关、物流、支付等痛点
|
||||
- **49. AI驱动智能决策闭环**：利用AI技术提升运营效率和决策准确性
|
||||
- **50. 核心服务优先级闭环**：确定核心业务服务的优先级顺序，确保资源合理分配
|
||||
|
||||
### 3. 编号错误
|
||||
- ✅ 编号错误已修正，文件结构完整
|
||||
|
||||
## 潜在的业务拓展机会
|
||||
|
||||
基于现有业务闭环，可以考虑以下拓展方向：
|
||||
|
||||
### 1. 多商户生态系统深化
|
||||
- 完善多商户入驻、认证、管理、结算的完整流程
|
||||
- 构建商户等级体系和激励机制
|
||||
- 提供商户运营工具和数据分析服务
|
||||
|
||||
### 2. 跨境电商服务
|
||||
- 国际支付解决方案
|
||||
- 清关服务和合规咨询
|
||||
- 跨境物流优化和追踪
|
||||
|
||||
### 3. AI驱动的智能决策
|
||||
- 智能定价与动态调价
|
||||
- 智能库存预测与补货
|
||||
- 智能广告投放与优化
|
||||
- 智能客户服务与售后
|
||||
|
||||
### 4. 社交电商整合
|
||||
- 社交媒体平台集成
|
||||
- 社交分享与推荐系统
|
||||
- 内容营销工具
|
||||
|
||||
### 5. 全渠道零售
|
||||
- 线上线下库存一体化
|
||||
- 全渠道订单管理
|
||||
- 会员体系整合
|
||||
|
||||
### 6. 可持续发展与绿色物流
|
||||
- 碳足迹计算与优化
|
||||
- 环保包装选择
|
||||
- 可持续供应链管理
|
||||
|
||||
### 7. 高级数据分析与商业智能
|
||||
- 预测分析与市场趋势
|
||||
- 竞争对手分析
|
||||
- 行业 benchmarking
|
||||
|
||||
### 8. 区块链应用
|
||||
- 供应链透明度
|
||||
- 物流追踪与溯源
|
||||
- 智能合约与自动化结算
|
||||
|
||||
### 9. 移动应用与小程序
|
||||
- 商户端移动应用
|
||||
- 客户购物小程序
|
||||
- 物流追踪移动工具
|
||||
|
||||
### 10. API开放平台
|
||||
- 第三方开发者生态
|
||||
- 插件市场
|
||||
- 集成服务
|
||||
|
||||
## 同行与上下游分析
|
||||
|
||||
### 核心竞争对手分析
|
||||
|
||||
#### 1. 跨境电商平台
|
||||
- **亚马逊、eBay、Shopee**：提供完整的电商生态，拥有强大的平台流量和物流网络
|
||||
- **Temu、SHEIN**：以低价策略和快速供应链著称，擅长数据分析和用户运营
|
||||
- **独立站平台**：如Shopify，提供灵活的建站工具和营销功能
|
||||
|
||||
#### 2. 供应链管理系统
|
||||
- **SAP、Oracle**：企业级ERP系统，功能全面但实施成本高
|
||||
- **Shopify Plus、BigCommerce**：针对电商的管理系统，集成度高
|
||||
- **开源ERP系统**：如Odoo，灵活性高但需要技术支持
|
||||
|
||||
#### 3. 物流与供应链服务
|
||||
- **DHL、FedEx、UPS**：国际物流巨头，提供全球配送服务
|
||||
- **菜鸟、京东物流**：国内物流龙头，提供一体化物流解决方案
|
||||
- **4PL服务商**：提供供应链整体解决方案，如德迅、辛克
|
||||
|
||||
### 上下游生态分析
|
||||
|
||||
#### 上游供应商
|
||||
- **制造商/工厂**：提供产品生产
|
||||
- **品牌商**：提供品牌授权和产品设计
|
||||
- **原材料供应商**：提供生产所需材料
|
||||
- **供应商管理平台**：如阿里巴巴、Global Sources
|
||||
|
||||
#### 中游服务商
|
||||
- **物流服务商**：国际快递、货代、仓储服务
|
||||
- **支付服务商**：PayPal、Stripe、银行跨境支付
|
||||
- **清关服务商**：提供海关申报和清关服务
|
||||
- **营销服务商**：广告投放、社交媒体运营
|
||||
|
||||
#### 下游渠道
|
||||
- **线上平台**：亚马逊、eBay、Shopee等
|
||||
- **线下渠道**：实体店、批发市场
|
||||
- **B2B客户**：企业采购商、分销商
|
||||
- **终端消费者**：个人买家
|
||||
|
||||
### 差异化优势机会
|
||||
|
||||
1. **全链路整合**：打通采购、销售、物流、财务全流程，提供一体化解决方案
|
||||
2. **多平台协同**：支持多平台数据同步和管理，避免数据孤岛
|
||||
3. **AI驱动决策**：利用AI技术优化定价、库存和营销策略
|
||||
4. **灵活的多商户模式**：支持不同规模商户的定制化需求
|
||||
5. **跨境合规保障**：提供合规咨询和证书管理服务
|
||||
|
||||
### 缺失功能分析
|
||||
|
||||
#### 同行拥有但我们可能缺失的功能
|
||||
|
||||
1. **亚马逊、eBay等平台**
|
||||
- 全球物流网络和仓储体系
|
||||
- 强大的用户评价和信用体系
|
||||
- 成熟的广告投放系统和数据分析工具
|
||||
- 多语言和多币种支持
|
||||
|
||||
2. **Temu、SHEIN**
|
||||
- 快速供应链响应机制（7-15天交货）
|
||||
- 强大的数据分析和用户画像系统
|
||||
- 社交电商和内容营销能力
|
||||
- 个性化推荐算法
|
||||
|
||||
3. **Shopify**
|
||||
- 丰富的插件生态系统
|
||||
- 灵活的主题和模板系统
|
||||
- 内置的支付处理解决方案
|
||||
- 多渠道销售集成（社交媒体、市场places等）
|
||||
|
||||
4. **SAP、Oracle**
|
||||
- 企业级财务管理和会计功能
|
||||
- 人力资源管理模块
|
||||
- 高级预测和规划工具
|
||||
- 复杂的供应链优化算法
|
||||
|
||||
5. **物流服务商**
|
||||
- 实时包裹追踪和物流可视化
|
||||
- 多渠道物流整合
|
||||
- 智能路由和路径优化
|
||||
- 海关预清关服务
|
||||
|
||||
#### 上下游伙伴拥有但我们可能缺失的功能
|
||||
|
||||
1. **上游供应商**
|
||||
- 供应商绩效评估和评级系统
|
||||
- 采购合同管理和自动续约
|
||||
- 供应商协同平台和信息共享
|
||||
- 预测性采购和需求计划
|
||||
|
||||
2. **中游服务商**
|
||||
- 多币种支付处理和汇率管理
|
||||
- 税务计算和申报服务
|
||||
- 物流保险和风险保障
|
||||
- 营销自动化和CRM集成
|
||||
|
||||
3. **下游渠道**
|
||||
- 全渠道库存管理和订单路由
|
||||
- 会员忠诚度计划和奖励系统
|
||||
- 实时促销和折扣管理
|
||||
- 客户服务和支持系统
|
||||
|
||||
#### 功能补充建议
|
||||
|
||||
1. **技术层面**
|
||||
- 开发开放API平台，集成第三方服务
|
||||
- 构建微服务架构，提高系统扩展性
|
||||
- 投资AI和机器学习能力，优化决策流程
|
||||
- 加强数据安全和隐私保护
|
||||
|
||||
2. **业务层面**
|
||||
- 建立全球物流合作伙伴网络
|
||||
- 开发多语言和多币种支持
|
||||
- 构建用户评价和信用体系
|
||||
- 提供端到端的跨境合规解决方案
|
||||
|
||||
3. **生态层面**
|
||||
- 培育第三方开发者生态
|
||||
- 建立商户社区和知识共享平台
|
||||
- 发展战略合作伙伴关系
|
||||
- 构建行业标准和最佳实践
|
||||
|
||||
## 结论
|
||||
|
||||
`Business_ClosedLoops.md` 文件现已包含完整的50个业务闭环，包括：
|
||||
- 35个核心业务闭环
|
||||
- 15个扩展业务闭环
|
||||
- 5个新增闭环（技术基础设施、客户服务、跨境电商、AI驱动智能决策、核心服务优先级）
|
||||
|
||||
系统已经具备完整的业务流程覆盖，从商品采集到财务对账，从订单履约到售后服务，形成了完整的业务生态系统。
|
||||
|
||||
建议重点关注：
|
||||
1. 完善多商户生态系统，构建商户服务体系
|
||||
2. 加强跨境电商服务能力，解决清关、物流等痛点
|
||||
3. 利用AI技术提升运营效率和决策准确性
|
||||
4. 构建开放的API生态，吸引第三方开发者
|
||||
5. 建立可持续发展的绿色供应链，符合全球环保趋势
|
||||
6. 加强技术基础设施建设，确保系统稳定高效运行
|
||||
7. 提升客户服务质量，增强客户满意度和忠诚度
|
||||
8. 按照优先级顺序实施核心业务服务，确保资源合理分配
|
||||
@@ -63,3 +63,103 @@ export class ReconciliationService { ... }
|
||||
|
||||
### 4.2 风险登记 (Risk Registry)
|
||||
- 记录系统风险、缓解措施与负责人。
|
||||
|
||||
---
|
||||
|
||||
## 5. AI决策角色与权限（AI Decision Roles & Permissions）
|
||||
|
||||
> **说明**：定义AI决策系统中各角色的权限边界，确保"AI主导决策 + 人类验证"的安全可控。
|
||||
|
||||
### 5.1 角色定义
|
||||
|
||||
| 角色 | 权限 | 职责 | 备注 |
|
||||
|------|------|------|------|
|
||||
| **AI Agent** | 决策生成、数据分析、风险评估 | 输出建议，带置信度 | 无执行权限 |
|
||||
| **人类操作者** | 审核/修改/确认 | 前期高干预，后期可降低 | 按权限等级操作 |
|
||||
| **系统执行层** | 自动化操作执行 | 仅执行经过确认的操作 | 幂等性保证 |
|
||||
| **日志管理系统** | 全链路记录 | 可回溯，每条操作打时间戳 | 只读权限 |
|
||||
|
||||
### 5.2 人类操作者权限等级
|
||||
|
||||
| 等级 | 角色 | 可操作范围 | 审核权限 |
|
||||
|------|------|------------|----------|
|
||||
| **L1** | OPERATOR | 查看、确认低风险操作 | 无 |
|
||||
| **L2** | MANAGER | 查看、确认、修改中低风险操作 | 审核OPERATOR操作 |
|
||||
| **L3** | FINANCE | 查看、确认、修改所有财务相关操作 | 审核财务操作 |
|
||||
| **L4** | ADMIN | 全部权限，包括配置AI阈值 | 审核所有操作 |
|
||||
|
||||
### 5.3 操作风险等级与权限映射
|
||||
|
||||
| 风险等级 | 操作类型 | 最低审核权限 | 自动执行 |
|
||||
|----------|----------|--------------|----------|
|
||||
| **低风险** | 库存预警、数据同步 | OPERATOR | ✅ 允许 |
|
||||
| **中风险** | 定价调整、广告投放 | MANAGER | ✅ 允许（高置信度） |
|
||||
| **高风险** | 退款审批、合同签订 | FINANCE | ❌ 禁止 |
|
||||
| **极高风险** | 大额转账、系统配置 | ADMIN | ❌ 禁止 |
|
||||
|
||||
### 5.4 AI决策权限控制
|
||||
|
||||
```typescript
|
||||
interface AIDecisionPermission {
|
||||
module: string; // 模块名称
|
||||
action: string; // 操作类型
|
||||
risk_level: 'low' | 'medium' | 'high' | 'critical';
|
||||
min_reviewer_role: 'OPERATOR' | 'MANAGER' | 'FINANCE' | 'ADMIN';
|
||||
auto_execute: boolean; // 是否允许自动执行
|
||||
auto_execute_confidence: number; // 自动执行置信度阈值
|
||||
require_dual_approval: boolean; // 是否需要双人审批
|
||||
}
|
||||
```
|
||||
|
||||
### 5.5 权限校验流程
|
||||
|
||||
```
|
||||
1. AI生成建议 → 系统判断风险等级
|
||||
2. 根据风险等级 → 确定最低审核权限
|
||||
3. 操作者提交审核 → 校验操作者权限
|
||||
4. 权限通过 → 执行操作 → 记录日志
|
||||
5. 权限不足 → 拒绝操作 → 记录异常日志
|
||||
```
|
||||
|
||||
### 5.6 特殊场景处理
|
||||
|
||||
| 场景 | 处理方式 | 说明 |
|
||||
|------|----------|------|
|
||||
| **大额退款** | 双人审批 | ADMIN + FINANCE 同时确认 |
|
||||
| **紧急定价** | 快速通道 | MANAGER确认后立即执行，事后补录 |
|
||||
| **批量操作** | 批量审批 | 单次审批上限100条，超出需ADMIN |
|
||||
| **跨店铺操作** | 店铺权限校验 | 只能操作有权限的店铺 |
|
||||
|
||||
### 5.7 审计与追溯
|
||||
|
||||
- **操作日志**：所有AI建议、人类审核、系统执行均记录
|
||||
- **权限变更日志**：角色权限变更需ADMIN审批并记录
|
||||
- **异常告警**：权限越界、异常操作实时告警
|
||||
- **定期审计**：每月进行权限审计，清理过期权限
|
||||
|
||||
---
|
||||
|
||||
## 6. 自动化程度演进（Automation Evolution）
|
||||
|
||||
> **说明**：定义AI决策系统从"人工主导"到"AI主导"的渐进式演进路径。
|
||||
|
||||
### 6.1 演进阶段
|
||||
|
||||
| 阶段 | 时间 | AI角色 | 人类角色 | 目标 |
|
||||
|------|------|--------|----------|------|
|
||||
| **阶段1** | 1-3月 | 建议生成 | 全部确认 | 建立信任 |
|
||||
| **阶段2** | 3-6月 | 低风险自动 | 高风险确认 | 效率提升 |
|
||||
| **阶段3** | 6-12月 | 大部分自动 | 异常介入 | 规模化 |
|
||||
| **阶段4** | 12月+ | 全链路决策 | 仅监控 | 智能化 |
|
||||
|
||||
### 6.2 阶段准入条件
|
||||
|
||||
| 阶段 | 准入条件 |
|
||||
|------|----------|
|
||||
| **阶段1→2** | AI建议采纳率 > 80%，决策准确率 > 85% |
|
||||
| **阶段2→3** | 自动执行成功率 > 95%，异常率 < 5% |
|
||||
| **阶段3→4** | 人工干预率 < 10%，系统稳定性 > 99.9% |
|
||||
|
||||
---
|
||||
|
||||
*本治理规范遵循 Crawlful Hub 项目规则，所有开发活动必须遵守逻辑集中化原则。*
|
||||
|
||||
@@ -48,6 +48,9 @@
|
||||
| AI-Frontend-12 | 多商户管理前端 | FE-MV001, FE-MV002, FE-MV003, FE-MV004 | MerchantManage.tsx, ShopManage.tsx, MerchantOrder.tsx, MerchantSettlement.tsx | 2026-03-19 08:00 | ✅ 已完成 |
|
||||
| AI-Frontend-12 | 多商户管理闭环 | FE-MV001, FE-MV002, FE-MV003, FE-MV004 | MerchantManage.tsx, MerchantShopManage.tsx, MerchantOrderManage.tsx, MerchantSettlementManage.tsx | 2026-03-19 10:00 | ✅ 已完成 |
|
||||
| AI-DevOps-12 | 运维模块 | OP-MV001, OP-MV002, OP-IT005, OP-ST004 | MerchantMonitorService.ts, ServiceHealthCheck.ts, MerchantIntegrationTest.ts, MerchantPerformanceTest.ts | 2026-03-19 09:00 | ✅ 已完成 |
|
||||
| **AI-Leaderboard-1** | **多商户收益排行榜系统（信任引擎）** | **FE-LEADER001, BE-LEADER001, BE-LEADER002** | **Leaderboard.tsx, MerchantMetricsService.ts, LeaderboardService.ts** | **2026-03-19 14:00** | **✅ 已完成** |
|
||||
| **AI-Strategy-1** | **策略市场（Strategy Marketplace）** | **FE-STRATEGY001, BE-STRATEGY001, BE-STRATEGY002** | **StrategyMarketplace.tsx, StrategyService.ts, StrategyRecommendationService.ts** | **2026-03-19 15:00** | **✅ 已完成** |
|
||||
| **AI-Frontend-29** | **前端交互任务包** | **FE-INT-P001~FE-INT-P010, FE-INT-O001~FE-INT-O010, FE-INT-T001~FE-INT-T006, FE-INT-A001~FE-INT-A005, FE-INT-C001~FE-INT-C004, FE-INT-S001~FE-INT-S004** | **ProductPage.tsx, OrdersPage.tsx, TaskCenter/index.tsx, DashboardPage.tsx, CompliancePage.tsx, SettingsPage.tsx** | **2026-03-19 18:00** | **✅ 已完成** |
|
||||
| AI-Backend-1 | 安全测试闭环 | BE-SE001, BE-SE002, BE-SE003 | SecurityTestService.ts, EncryptionService.ts, PermissionTestService.ts | 2026-03-19 14:00 | ✅ 已完成 |
|
||||
| AI-Analysis-7 | 恶意买家黑名单闭环 | AI-BL001, DT-BL002 | BlacklistService.ts, BlacklistAnalysisService.ts | 2026-03-19 11:00 | ✅ 已完成 |
|
||||
| AI-Analysis-7 | 多商户智能分析AI | AI-MV001, AI-MV002, AI-MV003 | MerchantAnalysisService.ts | 2026-03-19 14:00 | ✅ 已完成 |
|
||||
@@ -69,7 +72,20 @@
|
||||
| **AI-Frontend-27** | **高退货率SKU闭环** | **FE-RT001, FE-RT002** | **ReturnMonitor.tsx, SKUManage.tsx** | **2026-03-20 16:00** | **✅ 已完成** |
|
||||
| **AI-Frontend-22** | **恶意买家黑名单闭环** | **FE-BL001, FE-BL002** | **BlacklistManage.tsx, RiskMonitor.tsx** | **2026-03-20 17:00** | **✅ 已完成** |
|
||||
| **AI-Frontend-28** | **用户资产闭环** | **FE-UA001, FE-UA002, FE-UA003** | **MemberLevel.tsx, PointsManage.tsx, UserAssets.tsx** | **2026-03-20 17:00** | **✅ 已完成** |
|
||||
|
||||
| AI-Frontend-31 | 前端交互任务包 | FE-INT-P001~FE-INT-P010, FE-INT-O001~FE-INT-O010, FE-INT-T001~FE-INT-T006, FE-INT-A001~FE-INT-A005, FE-INT-C001~FE-INT-C004, FE-INT-S001~FE-INT-S004 | Product/index.tsx, Orders/index.tsx, TaskCenter/index.tsx, DashboardPage.tsx, Compliance/index.tsx, Settings/index.tsx | 2026-03-20 19:00 | ✅ 已完成 |
|
||||
| **AI-Frontend-32** | **前端交互任务包（超大型）** | **FE-INT-P001~P010, FE-INT-O001~O010, FE-INT-T001~T006, FE-INT-A001~A005, FE-INT-C001~C004, FE-INT-S001~S004 (共39个任务)** | **Product/index.tsx, Orders/index.tsx, TaskCenter/index.tsx, Analytics/index.tsx, Compliance/index.tsx, Settings/index.tsx, PlatformAccountConfig.tsx, ExchangeRateConfig.tsx, CostTemplateConfig.tsx, WinNodeConfig.tsx** | **2026-03-18 10:00** | **✅ 已完成** |
|
||||
| **AI-System-1** | **超大型系统集成与部署任务包** | **系统集成、架构验证、全面测试、性能优化、安全加固、部署准备（6大核心任务）** | **SystemIntegrationService.ts, PerformanceOptimizationService.ts, SecurityHardeningService.ts, deployment-check.js, deploy-prep.js, run-tests.js, optimize-system.js** | **2026-03-18 22:00** | **✅ 已完成** |
|
||||
| **AI-Leaderboard-1** | **多商户收益排行榜系统（信任引擎）** | **FE-LEADER001, BE-LEADER001, BE-LEADER002** | **Leaderboard.tsx, MerchantMetricsService.ts, LeaderboardService.ts** | **2026-03-19 14:00** | **✅ 已完成** |
|
||||
| - | 策略市场（Strategy Marketplace）🆕 | FE-STRATEGY001, BE-STRATEGY001, BE-STRATEGY002 | StrategyMarketplace.tsx, StrategyService.ts, StrategyRecommendationService.ts | - | ⏳ 待认领 |
|
||||
| **AI-Frontend-33** | **自动选品+自动上架系统（增长引擎）** | **FE-SELECT001, BE-SELECT001, BE-SELECT002** | **AutoProductSelection.tsx, ProductSelectionService.ts, AutoListingService.ts** | **2026-03-20 20:00** | **✅ 已完成** |
|
||||
| - | AI店铺托管（AutoPilot）🆕 | FE-AUTOPILOT001, BE-AUTOPILOT001, BE-AUTOPILOT002 | AutoPilot.tsx, AutoPilotService.ts, AutoPilotScheduler.ts | - | ⏳ 待认领 |
|
||||
| - | 跨平台套利系统完善🆕 | FE-ARBITRAGE001, BE-ARBITRAGE001, BE-ARBITRAGE002 | ArbitrageMonitor.tsx, ArbitrageService.ts, PriceComparisonService.ts | - | ⏳ 待认领 |
|
||||
| - | AI动态定价系统完善🆕 | FE-PRICING001, BE-PRICING001, BE-PRICING002 | DynamicPricing.tsx, DynamicPricingService.ts, CompetitorPriceService.ts | - | ⏳ 待认领 |
|
||||
| - | 多租户基础架构（商户→部门→店铺）🆕 | BE-MT001, BE-MT002, FE-MT001, FE-MT002 | DataIsolationService.ts, HierarchyAuthMiddleware.ts, HierarchySelector.tsx, HierarchyService.ts | - | ⏳ 待认领 |
|
||||
| - | 订单多店铺管理🆕 | FE-ORDER-MS001, FE-ORDER-MS002, BE-ORDER-MS001 | OrderMultiShopList.tsx, OrderAggregate.tsx, OrderAggregationService.ts | - | ⏳ 待认领 |
|
||||
| - | 多店铺报表聚合🆕 | FE-SHOP-REP001, BE-SHOP-REP001 | MultiShopReport.tsx, ShopReportAggregationService.ts | - | ⏳ 待认领 |
|
||||
| **AI-Backend-34** | **AI决策日志系统（全链路追溯）** | **BE-AILOG-001~005, FE-AILOG-001~003** | **AIDecisionLogService.ts, AIDecisionLog/index.tsx** | **2026-03-20 22:00** | **✅ 已完成** |
|
||||
| - | AI决策自动化配置🆕 | BE-AIAUTO-001~004, FE-AIAUTO-001~003 | AutoExecutionConfigService.ts, AutoExecutionConfig.tsx | - | ⏳ 待认领 |
|
||||
|
||||
**占用规则**:
|
||||
|
||||
@@ -104,6 +120,28 @@
|
||||
| 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 | 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 | ✅ 已完成 |
|
||||
|
||||
### 📦 任务包领取模板
|
||||
|
||||
领取任务包时，复制以下模板并更新：
|
||||
@@ -123,6 +161,219 @@
|
||||
|
||||
***
|
||||
|
||||
## 🚀 待实现功能（核心增长功能 + 基础设施）
|
||||
|
||||
> **说明**: 以下功能是系统核心增长功能和基础设施，需要在基础架构完成后优先实现
|
||||
|
||||
### 🟣 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 - 高
|
||||
**预计开发时间**: 20小时
|
||||
|
||||
**目标**: 替用户运营店铺，实现全自动运营
|
||||
|
||||
**需要实现**:
|
||||
- `AutoPilotService` 服务
|
||||
- 托管调度器
|
||||
- 托管状态管理
|
||||
- 托管日志记录
|
||||
- 紧急停止机制
|
||||
- 前端 `AutoPilot` 控制台
|
||||
|
||||
#### 5. 跨平台套利系统完善🔥
|
||||
**状态**: ⏳ 部分实现
|
||||
**优先级**: P1 - 高
|
||||
**预计开发时间**: 12小时
|
||||
|
||||
**目标**: 低买高卖，实现跨平台套利
|
||||
|
||||
**需要实现**:
|
||||
- `arbitrage_products` 表结构
|
||||
- 自动价格对比
|
||||
- 自动上架TikTok
|
||||
- 套利ROI计算
|
||||
- 套利监控
|
||||
- 前端套利监控页面
|
||||
|
||||
#### 6. AI动态定价系统完善🔥
|
||||
**状态**: ⏳ 部分实现
|
||||
**优先级**: P1 - 高
|
||||
**预计开发时间**: 16小时
|
||||
|
||||
**目标**: 在竞争中最大化利润，实现博弈级定价
|
||||
|
||||
**需要实现**:
|
||||
- 竞争对手价格监控
|
||||
- 博弈定价算法
|
||||
- 提价/降价策略
|
||||
- 定价决策日志
|
||||
- A/B测试定价
|
||||
- 前端动态定价控制面板
|
||||
|
||||
#### 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. AI决策自动化配置（渐进式演进）🔥 🆕
|
||||
**状态**: ⏳ 待实现
|
||||
**优先级**: P1 - 高
|
||||
**任务包**: PKG-AI-AUTO
|
||||
**预计开发时间**: 12小时
|
||||
|
||||
**目标**: 实现AI决策自动化程度的可配置化
|
||||
|
||||
**需要实现**:
|
||||
- [BE-AIAUTO-001] `cf_auto_execution_config` 表结构
|
||||
- [BE-AIAUTO-002] `AutoExecutionConfigService` 服务
|
||||
- [BE-AIAUTO-003] 自动执行阈值校验中间件
|
||||
- [BE-AIAUTO-004] 自动化等级管理API
|
||||
- [FE-AIAUTO-001] 自动化配置页面
|
||||
- [FE-AIAUTO-002] 阈值配置表单
|
||||
- [FE-AIAUTO-003] 演进阶段展示
|
||||
|
||||
**技术要点**:
|
||||
- 自动化等级 (L1-L4)
|
||||
- 置信度阈值配置
|
||||
- 风险等级限制
|
||||
- 模块默认配置
|
||||
|
||||
---
|
||||
|
||||
### 🟡 P2 - 中优先级功能
|
||||
|
||||
实现这些功能后：
|
||||
- 📈 **用户转化率**: 提升 50%+
|
||||
- 💰 **平台收益**: 增加 100%+
|
||||
- 👥 **用户留存率**: 提高 30%+
|
||||
- 🤖 **自动化运营**: 实现 80%+
|
||||
|
||||
***
|
||||
|
||||
## ⚠️ AI Agent 必读文档清单
|
||||
|
||||
**在开始任何任务之前，必须按顺序阅读以下文档：**
|
||||
@@ -1744,16 +1995,16 @@ export class FeatureModuleService {
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
|---------|---------|---------|------|------|---------|------|--------|------|---------|--------|
|
||||
| FE-INT-P001 | 商品主数据闭环 | 商品列表筛选交互 | 筛选条件 | 筛选结果 | 用户操作 | ⏳ pending | P1 | FE-SK003 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-P002 | 商品主数据闭环 | 商品列表排序交互 | 排序字段 | 排序结果 | 用户操作 | ⏳ pending | P1 | FE-SK003 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-P003 | 商品主数据闭环 | 商品新增交互 | 商品信息 | 新商品 | 点击新增 | ⏳ pending | P1 | FE-SK003 | 6h | AI-Frontend-XX |
|
||||
| FE-INT-P004 | 商品主数据闭环 | 商品编辑交互 | 编辑数据 | 更新结果 | 点击编辑 | ⏳ pending | P1 | FE-INT-P003 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-P005 | 定价与利润决策闭环 | 商品定价交互 | 成本数据 | 定价结果 | 点击定价 | ⏳ pending | P1 | FE-SK003 | 8h | AI-Frontend-XX |
|
||||
| FE-INT-P006 | 商品刊登闭环 | 商品上架交互 | 上架确认 | 上架结果 | 点击上架 | ⏳ pending | P1 | FE-INT-P005 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-P007 | 商品刊登闭环 | 商品同步交互 | 同步请求 | 同步任务 | 点击同步 | ⏳ pending | P1 | FE-INT-P006 | 6h | AI-Frontend-XX |
|
||||
| FE-INT-P008 | 商品主数据闭环 | 商品批量操作交互 | 选中商品 | 批量结果 | 批量操作 | ⏳ pending | P1 | FE-INT-P003 | 8h | AI-Frontend-XX |
|
||||
| FE-INT-P009 | 商品主数据闭环 | 商品详情查看交互 | 商品ID | 详情数据 | 点击查看 | ⏳ pending | P1 | FE-SK003 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-P010 | 定价与利润决策闭环 | 实时定价计算交互 | 成本输入 | 计算结果 | 输入变化 | ⏳ pending | P1 | FE-INT-P005 | 6h | AI-Frontend-XX |
|
||||
| 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 订单中心交互任务
|
||||
|
||||
@@ -1761,16 +2012,16 @@ export class FeatureModuleService {
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
|---------|---------|---------|------|------|---------|------|--------|------|---------|--------|
|
||||
| FE-INT-O001 | 订单履约闭环 | 订单列表筛选交互 | 筛选条件 | 筛选结果 | 用户操作 | ⏳ pending | P1 | FE-SK004 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-O002 | 订单履约闭环 | 订单确认交互 | 订单ID | 确认结果 | 点击确认 | ⏳ pending | P1 | FE-SK004 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-O003 | 订单履约闭环 | 订单发货交互 | 发货信息 | 发货结果 | 点击发货 | ⏳ pending | P1 | FE-INT-O002 | 6h | AI-Frontend-XX |
|
||||
| FE-INT-O004 | 订单履约闭环 | 订单完成交互 | 订单ID | 完成结果 | 点击完成 | ⏳ pending | P1 | FE-INT-O003 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-O005 | 订单履约闭环 | 订单取消交互 | 取消原因 | 取消结果 | 点击取消 | ⏳ pending | P1 | FE-SK004 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-O006 | 售后逆向闭环 | 售后申请交互 | 售后信息 | 申请结果 | 点击申请 | ⏳ pending | P1 | FE-INT-O004 | 6h | AI-Frontend-XX |
|
||||
| FE-INT-O007 | 售后逆向闭环 | 售后审核交互 | 审核结果 | 处理结果 | 点击审核 | ⏳ pending | P1 | FE-INT-O006 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-O008 | 售后逆向闭环 | 退款处理交互 | 退款金额 | 退款结果 | 点击退款 | ⏳ pending | P1 | FE-INT-O007 | 6h | AI-Frontend-XX |
|
||||
| FE-INT-O009 | 订单集中管理闭环 | 多平台订单聚合交互 | 平台筛选 | 聚合结果 | 用户操作 | ⏳ pending | P1 | FE-SK004 | 8h | AI-Frontend-XX |
|
||||
| FE-INT-O010 | 订单履约闭环 | 异常订单处理交互 | 异常信息 | 处理结果 | 点击处理 | ⏳ pending | P1 | FE-SK004 | 6h | AI-Frontend-XX |
|
||||
| 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 执行中心交互任务
|
||||
|
||||
@@ -1778,12 +2029,12 @@ export class FeatureModuleService {
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
|---------|---------|---------|------|------|---------|------|--------|------|---------|--------|
|
||||
| FE-INT-T001 | 服务编排与执行闭环 | 任务列表筛选交互 | 筛选条件 | 筛选结果 | 用户操作 | ⏳ pending | P1 | FE-SK001 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-T002 | 服务编排与执行闭环 | 任务重试交互 | 任务ID | 重试结果 | 点击重试 | ⏳ pending | P1 | FE-INT-T001 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-T003 | 服务编排与执行闭环 | 任务取消交互 | 任务ID | 取消结果 | 点击取消 | ⏳ pending | P1 | FE-INT-T001 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-T004 | 服务编排与执行闭环 | 任务日志查看交互 | 任务ID | 日志数据 | 点击查看 | ⏳ pending | P1 | FE-INT-T001 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-T005 | 服务编排与执行闭环 | 任务详情查看交互 | 任务ID | 详情数据 | 点击查看 | ⏳ pending | P1 | FE-INT-T001 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-T006 | 服务编排与执行闭环 | 批量任务操作交互 | 选中任务 | 批量结果 | 批量操作 | ⏳ pending | P1 | FE-INT-T001 | 6h | AI-Frontend-XX |
|
||||
| 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 数据中心交互任务
|
||||
|
||||
@@ -1791,11 +2042,11 @@ export class FeatureModuleService {
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
|---------|---------|---------|------|------|---------|------|--------|------|---------|--------|
|
||||
| FE-INT-A001 | 报表与分析闭环 | 数据筛选交互 | 筛选条件 | 筛选结果 | 用户操作 | ⏳ pending | P1 | FE-SK002 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-A002 | 报表与分析闭环 | 时间范围选择交互 | 时间范围 | 数据更新 | 选择时间 | ⏳ pending | P1 | FE-INT-A001 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-A003 | 报表与分析闭环 | 图表交互 | 图表操作 | 数据详情 | 点击图表 | ⏳ pending | P1 | FE-INT-A001 | 6h | AI-Frontend-XX |
|
||||
| FE-INT-A004 | 报表与分析闭环 | 数据导出交互 | 导出格式 | 导出文件 | 点击导出 | ⏳ pending | P1 | FE-INT-A001 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-A005 | 报表与分析闭环 | KPI卡片交互 | 卡片点击 | 详情数据 | 点击卡片 | ⏳ pending | P1 | FE-INT-A001 | 4h | AI-Frontend-XX |
|
||||
| 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 合规中心交互任务
|
||||
|
||||
@@ -1803,19 +2054,19 @@ export class FeatureModuleService {
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
|---------|---------|---------|------|------|---------|------|--------|------|---------|--------|
|
||||
| FE-INT-C001 | 合规与证书管理闭环 | 证书上传交互 | 证书文件 | 上传结果 | 点击上传 | ⏳ pending | P1 | FE-SK001 | 6h | AI-Frontend-XX |
|
||||
| FE-INT-C002 | 合规与证书管理闭环 | 证书审核交互 | 审核结果 | 处理结果 | 点击审核 | ⏳ pending | P1 | FE-INT-C001 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-C003 | 合规与风控闭环 | 合规检查交互 | 商品ID | 检查结果 | 点击检查 | ⏳ pending | P1 | FE-SK001 | 6h | AI-Frontend-XX |
|
||||
| FE-INT-C004 | 合规与风控闭环 | 风险监控交互 | 监控参数 | 监控结果 | 用户操作 | ⏳ pending | P1 | FE-INT-C003 | 6h | AI-Frontend-XX |
|
||||
| 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 | 系统设置 | 平台账号配置交互 | 账号信息 | 配置结果 | 保存配置 | ⏳ pending | P2 | FE-SK001 | 6h | AI-Frontend-XX |
|
||||
| FE-INT-S002 | 系统设置 | 汇率配置交互 | 汇率数据 | 配置结果 | 保存配置 | ⏳ pending | P2 | FE-SK001 | 4h | AI-Frontend-XX |
|
||||
| FE-INT-S003 | 系统设置 | 成本模板配置交互 | 模板数据 | 配置结果 | 保存配置 | ⏳ pending | P2 | FE-SK001 | 6h | AI-Frontend-XX |
|
||||
| FE-INT-S004 | 系统设置 | WinNode配置交互 | 节点信息 | 配置结果 | 保存配置 | ⏳ pending | P2 | FE-SK001 | 6h | AI-Frontend-XX |
|
||||
| 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：前端开发规范
|
||||
|
||||
@@ -2344,24 +2595,4 @@ export default function(initialState: InitialState) {
|
||||
// 合规权限
|
||||
'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. 本附录内容基于参考文档的前端开发规范，与现有50个业务闭环保持一致
|
||||
2. 所有技术栈选择遵循项目特定规则中的约束
|
||||
3. 组件规范和状态管理规范与Business_ClosedLoops.md中的前端交互规范对应
|
||||
4. API交互规范遵循五元组追踪要求
|
||||
|
||||
***
|
||||
|
||||
**最后更新时间**：2026-03-18
|
||||
**维护者**：Crawlful Hub AI Team
|
||||
'compliance:audit': permissio
|
||||
@@ -1,271 +0,0 @@
|
||||
# 上层闭环设计
|
||||
|
||||
## ❗ 真正缺的不是业务闭环，而是这 3 个“上层闭环”
|
||||
|
||||
你虽然有：
|
||||
|
||||
- ✔ 37个业务闭环（生产系统）
|
||||
- ✔ TOC + TOB 全链路
|
||||
- ✔ 多商户 + 非SaaS架构
|
||||
|
||||
但还缺：
|
||||
|
||||
---
|
||||
|
||||
## 🔴 ① 商业化闭环（Monetization Loop）
|
||||
|
||||
你现在只有：
|
||||
|
||||
- 👉 功能开通与支付（第33个闭环）
|
||||
|
||||
但缺的是：
|
||||
|
||||
- 👉 **“如何持续赚钱 + 放大收入”**
|
||||
|
||||
---
|
||||
|
||||
### 🧩 38️⃣ 商业化与增长闭环（Monetization & Growth Loop）
|
||||
|
||||
- **目标**：实现系统持续盈利与收入增长（非SaaS模式）
|
||||
|
||||
---
|
||||
|
||||
#### 收费模型
|
||||
|
||||
##### 1. 功能收费（Feature-based）
|
||||
- 高级分析
|
||||
- 自动化能力
|
||||
- API调用
|
||||
|
||||
##### 2. 交易抽成（Transaction-based）
|
||||
- TOC：订单抽佣（3~10%）
|
||||
- TOB：大单服务费
|
||||
|
||||
##### 3. 服务收费（Service-based）
|
||||
- 代发货
|
||||
- 仓储服务
|
||||
- 数据服务
|
||||
|
||||
##### 4. 资金沉淀（Deposit Float）
|
||||
- 押金沉淀收益
|
||||
- 账期资金
|
||||
|
||||
---
|
||||
|
||||
#### 收费触发点
|
||||
|
||||
- 功能调用
|
||||
- 订单完成
|
||||
- 商家使用服务
|
||||
- API请求
|
||||
|
||||
---
|
||||
|
||||
#### 收入放大机制
|
||||
|
||||
- ROI分析 → 推荐开功能
|
||||
- 利润分析 → 推荐加广告
|
||||
- 订单增长 → 引导升级套餐
|
||||
|
||||
---
|
||||
|
||||
#### 决策点
|
||||
|
||||
- 免费 vs 付费边界
|
||||
- 抽成比例
|
||||
- 功能定价策略
|
||||
|
||||
---
|
||||
|
||||
#### 输入
|
||||
|
||||
- 用户行为
|
||||
- 订单数据
|
||||
- 利润数据
|
||||
|
||||
---
|
||||
|
||||
#### 输出
|
||||
|
||||
- 收入增长
|
||||
- 用户付费转化
|
||||
|
||||
---
|
||||
|
||||
## 🔴 ② 服务编排闭环（Service Orchestration Loop）
|
||||
|
||||
你现在缺的是：
|
||||
|
||||
- 👉 **“业务闭环 → Service Flow” 的映射层**
|
||||
|
||||
---
|
||||
|
||||
### 🧩 39️⃣ 服务编排与执行闭环（Service Orchestration Loop）
|
||||
|
||||
- **目标**：将业务闭环转化为可执行的后端服务流
|
||||
|
||||
---
|
||||
|
||||
#### 核心原则
|
||||
|
||||
- 每个业务闭环必须对应一个 Service Flow
|
||||
- 所有逻辑必须走 Service 层
|
||||
|
||||
---
|
||||
|
||||
#### 执行流程
|
||||
|
||||
Frontend
|
||||
→ Controller
|
||||
→ Service（核心编排）
|
||||
→ Repository / External API
|
||||
→ 返回结果
|
||||
|
||||
---
|
||||
|
||||
#### 示例
|
||||
|
||||
##### 功能开通
|
||||
|
||||
Controller
|
||||
→ FeatureService.openFeature
|
||||
→ PaymentService.create
|
||||
→ PaymentCallback
|
||||
→ PermissionService.grant
|
||||
|
||||
---
|
||||
|
||||
#### 决策点
|
||||
|
||||
- 服务拆分粒度
|
||||
- 是否异步（消息队列）
|
||||
- 是否需要补偿机制
|
||||
|
||||
---
|
||||
|
||||
#### 输出
|
||||
|
||||
- 可执行后端服务
|
||||
- 业务状态流转
|
||||
|
||||
---
|
||||
|
||||
## 🔴 ③ 增长飞轮闭环（Growth Flywheel）
|
||||
|
||||
你现在是“系统”，但不是“生意机器”。
|
||||
|
||||
---
|
||||
|
||||
### 🧩 40️⃣ 增长飞轮闭环（Growth Flywheel Loop）
|
||||
|
||||
- **目标**：让系统自动变强、自动赚钱
|
||||
|
||||
---
|
||||
|
||||
#### 飞轮逻辑
|
||||
|
||||
数据 → 利润分析 → 推荐 → 用户行动 → 收入 → 更多数据
|
||||
|
||||
---
|
||||
|
||||
#### 核心路径
|
||||
|
||||
1. 商品数据 → 利润分析
|
||||
2. 利润高 → 推广广告
|
||||
3. 广告带订单
|
||||
4. 订单产生数据
|
||||
5. 数据优化策略
|
||||
|
||||
---
|
||||
|
||||
#### TOB路径
|
||||
|
||||
询盘 → 报价 → 成交 → 复购 → 信用提升 → 更大订单
|
||||
|
||||
---
|
||||
|
||||
#### 决策点
|
||||
|
||||
- 推荐策略
|
||||
- 自动化程度
|
||||
- AI参与程度
|
||||
|
||||
---
|
||||
|
||||
#### 输出
|
||||
|
||||
- GMV增长
|
||||
- ROI提升
|
||||
- 用户粘性
|
||||
|
||||
---
|
||||
|
||||
## 🔥 给你一句最关键的判断
|
||||
|
||||
你现在的系统：
|
||||
|
||||
> ✅ 是一个“ERP + 自动化系统”
|
||||
> ❌ 还不是“赚钱机器”
|
||||
|
||||
---
|
||||
|
||||
## 🧠 你现在的阶段定位
|
||||
|
||||
```text
|
||||
阶段1：业务闭环（你已完成）✅
|
||||
阶段2：系统实现（你进行中）✅
|
||||
阶段3：服务编排（你缺）❌
|
||||
阶段4：商业闭环（你缺）❌
|
||||
阶段5：增长飞轮（你缺）❌
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 你下一步应该怎么做（非常关键）
|
||||
|
||||
不要再继续加业务闭环了，已经够了。
|
||||
|
||||
---
|
||||
|
||||
### ✅ 正确顺序：
|
||||
|
||||
#### ① 先做这个（最重要）
|
||||
|
||||
- 👉 **实现 Service 层（闭环 → 代码）**
|
||||
|
||||
选一个闭环：
|
||||
|
||||
```text
|
||||
33️⃣ 功能开通与支付闭环
|
||||
```
|
||||
|
||||
打通：
|
||||
|
||||
```text
|
||||
支付 → 权限 → 账单
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### ② 然后做
|
||||
|
||||
- 👉 商业化闭环（开始赚钱）
|
||||
|
||||
---
|
||||
|
||||
#### ③ 最后做
|
||||
|
||||
- 👉 增长飞轮（自动赚钱）
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 一个很关键的提醒（很多人死在这里）
|
||||
|
||||
如果你现在：
|
||||
|
||||
- 👉 继续写业务闭环
|
||||
- 👉 或继续拆任务
|
||||
|
||||
结果就是：
|
||||
|
||||
> ❌ 永远停在“设计系统”，而不是“跑系统”
|
||||
708
docs/01_Architecture/Mock_Architecture.md
Normal file
708
docs/01_Architecture/Mock_Architecture.md
Normal file
@@ -0,0 +1,708 @@
|
||||
# 低侵入 Mock 架构设计
|
||||
|
||||
> 文档创建时间: 2026-03-19 (北京时间)
|
||||
> 适用项目: Crawlful Hub
|
||||
> 目标: 实现"不污染代码、AI上下文安全"的Mock方案
|
||||
|
||||
---
|
||||
|
||||
## 📋 目录
|
||||
|
||||
1. [核心原则](#核心原则)
|
||||
2. [架构概览](#架构概览)
|
||||
3. [前端Mock方案](#前端mock方案)
|
||||
4. [后端/BFF Mock方案](#后端bff-mock方案)
|
||||
5. [目录规范](#目录规范)
|
||||
6. [AI协作规范](#ai协作规范)
|
||||
7. [实施任务](#实施任务)
|
||||
|
||||
---
|
||||
|
||||
## 核心原则
|
||||
|
||||
### 1. Mock ≠ 写死数据
|
||||
|
||||
❌ **错误做法**: 在组件中直接写死数据
|
||||
```typescript
|
||||
const data = [{ id: 1, name: 'Mock商品' }]
|
||||
```
|
||||
|
||||
✅ **正确做法**: 通过数据源抽象层获取
|
||||
```typescript
|
||||
const data = await productDataSource.list()
|
||||
```
|
||||
|
||||
### 2. Mock 必须"可插拔"
|
||||
|
||||
Mock 应该是:
|
||||
- ✅ 可开启 / 可关闭
|
||||
- ✅ 可替换 / 可隔离
|
||||
- ✅ 环境变量控制
|
||||
|
||||
### 3. Mock 属于"数据源层"，不是"业务层"
|
||||
|
||||
```
|
||||
业务代码 → DataSource抽象层 → (Mock/真实API)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 架构概览
|
||||
|
||||
### 三层数据架构
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 前端 (React + Umi) │
|
||||
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
|
||||
│ │ 业务组件 │ → │ DataSource │ → │ API/Mock │ │
|
||||
│ │ │ │ 抽象层 │ │ │ │
|
||||
│ └─────────────┘ └─────────────┘ └─────────────┘ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ BFF 层 (服务编排层) │
|
||||
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
|
||||
│ │ Service │ → │ Mock切换 │ → │ 真实/Mock │ │
|
||||
│ │ │ │ │ │ 服务 │ │
|
||||
│ └─────────────┘ └─────────────┘ └─────────────┘ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 后端微服务层 │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Mock 分布策略
|
||||
|
||||
| 层级 | 是否Mock | 说明 |
|
||||
|------|---------|------|
|
||||
| 前端 | ⚠️ 可选 | 推荐用MSW，保持业务代码纯净 |
|
||||
| DataSource | ✅ 可切换 | 控制入口，环境变量驱动 |
|
||||
| BFF | ✅ 主力Mock | 最真实，前端无感知 |
|
||||
| 后端 | ❌ 不建议 | 除非联调测试 |
|
||||
|
||||
---
|
||||
|
||||
## 前端Mock方案
|
||||
|
||||
### 方案对比
|
||||
|
||||
| 方案 | 侵入性 | 推荐度 | 适用场景 |
|
||||
|------|--------|--------|----------|
|
||||
| MSW (Mock Service Worker) | ⭐ 最低 | 🥇 最推荐 | 前端开发、UI测试 |
|
||||
| DataSource抽象 | ⭐⭐ 低 | 🥈 推荐 | 需要自定义逻辑 |
|
||||
| 本地Mock Server | ⭐⭐⭐ 中 | 🥉 可选 | 团队共享Mock |
|
||||
| 硬编码 | ❌ 高 | 🚫 不推荐 | 绝对禁止 |
|
||||
|
||||
### 推荐方案: MSW + DataSource抽象
|
||||
|
||||
#### 1. 目录结构
|
||||
|
||||
```
|
||||
/dashboard/src
|
||||
/api ← 真实API封装
|
||||
product.ts
|
||||
user.ts
|
||||
order.ts
|
||||
certificate.ts
|
||||
/mock ← 所有Mock数据和拦截器
|
||||
/data ← Mock数据文件
|
||||
product.mock.ts
|
||||
user.mock.ts
|
||||
certificate.mock.ts
|
||||
msw.ts ← MSW初始化配置
|
||||
browser.ts ← 浏览器环境启动
|
||||
server.ts ← Node/测试环境启动
|
||||
/services ← 数据源抽象层
|
||||
productDataSource.ts
|
||||
userDataSource.ts
|
||||
certificateDataSource.ts
|
||||
/types ← 类型定义
|
||||
datasource.ts ← DataSource接口定义
|
||||
```
|
||||
|
||||
#### 2. DataSource接口定义
|
||||
|
||||
```typescript
|
||||
// /dashboard/src/types/datasource.ts
|
||||
|
||||
/**
|
||||
* [MOCK-001] DataSource抽象接口
|
||||
* 所有数据源必须实现此接口
|
||||
* AI注意: 这是抽象层，不涉及具体实现
|
||||
*/
|
||||
export interface IDataSource<T, QueryParams = any> {
|
||||
list(params?: QueryParams): Promise<T[]>;
|
||||
detail(id: string): Promise<T | null>;
|
||||
create(data: Partial<T>): Promise<T>;
|
||||
update(id: string, data: Partial<T>): Promise<T>;
|
||||
delete(id: string): Promise<void>;
|
||||
}
|
||||
|
||||
export interface ProductQueryParams {
|
||||
keyword?: string;
|
||||
category?: string;
|
||||
status?: string;
|
||||
page?: number;
|
||||
pageSize?: number;
|
||||
}
|
||||
|
||||
export interface CertificateQueryParams {
|
||||
status?: string;
|
||||
type?: string;
|
||||
page?: number;
|
||||
pageSize?: number;
|
||||
}
|
||||
```
|
||||
|
||||
#### 3. DataSource抽象层实现
|
||||
|
||||
```typescript
|
||||
// /dashboard/src/services/certificateDataSource.ts
|
||||
|
||||
import { Certificate } from '@/types/certificate';
|
||||
import { IDataSource, CertificateQueryParams } from '@/types/datasource';
|
||||
|
||||
/**
|
||||
* [MOCK-002] 证书数据源抽象层
|
||||
* 通过环境变量自动切换Mock/真实API
|
||||
* AI注意: 这是唯一入口，业务代码必须调用此层
|
||||
*/
|
||||
|
||||
// 真实API实现
|
||||
class ApiCertificateDataSource implements IDataSource<Certificate, CertificateQueryParams> {
|
||||
async list(params?: CertificateQueryParams): Promise<Certificate[]> {
|
||||
const query = new URLSearchParams(params as any).toString();
|
||||
const response = await fetch(`/api/v1/certificate/certificates?${query}`);
|
||||
const result = await response.json();
|
||||
return result.data || [];
|
||||
}
|
||||
|
||||
async detail(id: string): Promise<Certificate | null> {
|
||||
const response = await fetch(`/api/v1/certificate/certificates/${id}`);
|
||||
const result = await response.json();
|
||||
return result.data || null;
|
||||
}
|
||||
|
||||
async create(data: Partial<Certificate>): Promise<Certificate> {
|
||||
const response = await fetch('/api/v1/certificate/certificates', {
|
||||
method: 'POST',
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
body: JSON.stringify(data),
|
||||
});
|
||||
const result = await response.json();
|
||||
return result.data;
|
||||
}
|
||||
|
||||
async update(id: string, data: Partial<Certificate>): Promise<Certificate> {
|
||||
const response = await fetch(`/api/v1/certificate/certificates/${id}`, {
|
||||
method: 'PUT',
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
body: JSON.stringify(data),
|
||||
});
|
||||
const result = await response.json();
|
||||
return result.data;
|
||||
}
|
||||
|
||||
async delete(id: string): Promise<void> {
|
||||
await fetch(`/api/v1/certificate/certificates/${id}`, {
|
||||
method: 'DELETE',
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// Mock实现 (完全独立文件)
|
||||
class MockCertificateDataSource implements IDataSource<Certificate, CertificateQueryParams> {
|
||||
private mockData: Certificate[] = [
|
||||
{
|
||||
id: '1',
|
||||
name: 'CE认证证书',
|
||||
type: 'PRODUCT_CERT',
|
||||
status: 'APPROVED',
|
||||
fileUrl: '/files/ce-cert.pdf',
|
||||
fileName: 'CE-Certificate-2026.pdf',
|
||||
uploadDate: '2026-03-15',
|
||||
expiryDate: '2027-03-15',
|
||||
approvedBy: 'admin',
|
||||
approvedDate: '2026-03-16',
|
||||
productId: 'P001',
|
||||
productName: '工业温度传感器',
|
||||
notes: '欧盟市场准入认证',
|
||||
},
|
||||
// ... 更多Mock数据
|
||||
];
|
||||
|
||||
async list(params?: CertificateQueryParams): Promise<Certificate[]> {
|
||||
// 模拟网络延迟
|
||||
await new Promise(resolve => setTimeout(resolve, 300));
|
||||
|
||||
let result = [...this.mockData];
|
||||
|
||||
if (params?.status) {
|
||||
result = result.filter(item => item.status === params.status);
|
||||
}
|
||||
if (params?.type) {
|
||||
result = result.filter(item => item.type === params.type);
|
||||
}
|
||||
|
||||
return result;
|
||||
}
|
||||
|
||||
async detail(id: string): Promise<Certificate | null> {
|
||||
await new Promise(resolve => setTimeout(resolve, 200));
|
||||
return this.mockData.find(item => item.id === id) || null;
|
||||
}
|
||||
|
||||
async create(data: Partial<Certificate>): Promise<Certificate> {
|
||||
await new Promise(resolve => setTimeout(resolve, 500));
|
||||
const newCert: Certificate = {
|
||||
id: `${Date.now()}`,
|
||||
...data as Certificate,
|
||||
status: 'PENDING',
|
||||
uploadDate: new Date().toISOString().split('T')[0],
|
||||
};
|
||||
this.mockData.unshift(newCert);
|
||||
return newCert;
|
||||
}
|
||||
|
||||
async update(id: string, data: Partial<Certificate>): Promise<Certificate> {
|
||||
await new Promise(resolve => setTimeout(resolve, 300));
|
||||
const index = this.mockData.findIndex(item => item.id === id);
|
||||
if (index === -1) throw new Error('Certificate not found');
|
||||
this.mockData[index] = { ...this.mockData[index], ...data };
|
||||
return this.mockData[index];
|
||||
}
|
||||
|
||||
async delete(id: string): Promise<void> {
|
||||
await new Promise(resolve => setTimeout(resolve, 200));
|
||||
this.mockData = this.mockData.filter(item => item.id !== id);
|
||||
}
|
||||
}
|
||||
|
||||
// 导出数据源实例 (环境变量控制)
|
||||
const useMock = process.env.REACT_APP_USE_MOCK === 'true';
|
||||
|
||||
export const certificateDataSource: IDataSource<Certificate, CertificateQueryParams> = useMock
|
||||
? new MockCertificateDataSource()
|
||||
: new ApiCertificateDataSource();
|
||||
|
||||
// 标记Mock状态 (用于调试)
|
||||
export const __MOCK__ = useMock;
|
||||
```
|
||||
|
||||
#### 4. MSW配置
|
||||
|
||||
```typescript
|
||||
// /dashboard/src/mock/msw.ts
|
||||
|
||||
import { setupWorker, rest } from 'msw';
|
||||
import { mockCertificates } from './data/certificate.mock';
|
||||
|
||||
/**
|
||||
* [MOCK-003] MSW Mock配置
|
||||
* 拦截HTTP请求，返回Mock数据
|
||||
* AI注意: 这是网络层拦截，业务代码完全无感知
|
||||
*/
|
||||
|
||||
export const worker = setupWorker(
|
||||
// 证书列表
|
||||
rest.get('/api/v1/certificate/certificates', (req, res, ctx) => {
|
||||
const status = req.url.searchParams.get('status');
|
||||
const type = req.url.searchParams.get('type');
|
||||
|
||||
let data = [...mockCertificates];
|
||||
if (status) data = data.filter(item => item.status === status);
|
||||
if (type) data = data.filter(item => item.type === type);
|
||||
|
||||
return res(
|
||||
ctx.delay(300),
|
||||
ctx.json({
|
||||
success: true,
|
||||
data,
|
||||
total: data.length,
|
||||
})
|
||||
);
|
||||
}),
|
||||
|
||||
// 证书详情
|
||||
rest.get('/api/v1/certificate/certificates/:id', (req, res, ctx) => {
|
||||
const { id } = req.params;
|
||||
const cert = mockCertificates.find(item => item.id === id);
|
||||
|
||||
if (!cert) {
|
||||
return res(
|
||||
ctx.status(404),
|
||||
ctx.json({ success: false, error: '证书不存在' })
|
||||
);
|
||||
}
|
||||
|
||||
return res(
|
||||
ctx.delay(200),
|
||||
ctx.json({ success: true, data: cert })
|
||||
);
|
||||
}),
|
||||
|
||||
// 创建证书
|
||||
rest.post('/api/v1/certificate/certificates', async (req, res, ctx) => {
|
||||
const body = await req.json();
|
||||
const newCert = {
|
||||
id: `${Date.now()}`,
|
||||
...body,
|
||||
status: 'PENDING',
|
||||
uploadDate: new Date().toISOString().split('T')[0],
|
||||
};
|
||||
|
||||
return res(
|
||||
ctx.delay(500),
|
||||
ctx.json({ success: true, data: { id: newCert.id } })
|
||||
);
|
||||
}),
|
||||
|
||||
// 更新证书状态
|
||||
rest.put('/api/v1/certificate/certificates/:id/status', async (req, res, ctx) => {
|
||||
const { id } = req.params;
|
||||
const { status, approvedBy } = await req.json();
|
||||
|
||||
return res(
|
||||
ctx.delay(300),
|
||||
ctx.json({ success: true })
|
||||
);
|
||||
}),
|
||||
|
||||
// 删除证书
|
||||
rest.delete('/api/v1/certificate/certificates/:id', (req, res, ctx) => {
|
||||
return res(
|
||||
ctx.delay(200),
|
||||
ctx.json({ success: true })
|
||||
);
|
||||
})
|
||||
);
|
||||
```
|
||||
|
||||
```typescript
|
||||
// /dashboard/src/mock/browser.ts
|
||||
import { worker } from './msw';
|
||||
export { worker };
|
||||
```
|
||||
|
||||
```typescript
|
||||
// /dashboard/src/index.tsx (入口文件)
|
||||
|
||||
import React from 'react';
|
||||
import ReactDOM from 'react-dom/client';
|
||||
import App from './App';
|
||||
|
||||
/**
|
||||
* [MOCK-004] MSW启动配置
|
||||
* 仅在REACT_APP_USE_MOCK=true时启用
|
||||
*/
|
||||
async function enableMocking() {
|
||||
if (process.env.REACT_APP_USE_MOCK !== 'true') {
|
||||
return;
|
||||
}
|
||||
|
||||
const { worker } = await import('./mock/browser');
|
||||
return worker.start({
|
||||
onUnhandledRequest: 'bypass', // 未拦截的请求直接透传
|
||||
});
|
||||
}
|
||||
|
||||
enableMocking().then(() => {
|
||||
const root = ReactDOM.createRoot(document.getElementById('root')!);
|
||||
root.render(
|
||||
<React.StrictMode>
|
||||
<App />
|
||||
</React.StrictMode>
|
||||
);
|
||||
});
|
||||
```
|
||||
|
||||
#### 5. 业务组件使用示例
|
||||
|
||||
```typescript
|
||||
// /dashboard/src/pages/Compliance/index.tsx
|
||||
|
||||
import { certificateDataSource } from '@/services/certificateDataSource';
|
||||
|
||||
const ComplianceManagement: React.FC = () => {
|
||||
const fetchData = useCallback(async () => {
|
||||
setLoading(true);
|
||||
try {
|
||||
// 调用DataSource层，完全无感知是Mock还是真实API
|
||||
const data = await certificateDataSource.list({
|
||||
status: activeStatus,
|
||||
type: activeType,
|
||||
});
|
||||
setCertificates(data);
|
||||
} catch (error) {
|
||||
message.error('获取证书列表失败');
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
}, [activeStatus, activeType]);
|
||||
|
||||
const handleUploadSubmit = async () => {
|
||||
try {
|
||||
const values = await uploadForm.validateFields();
|
||||
await certificateDataSource.create({
|
||||
name: values.name,
|
||||
type: values.type,
|
||||
expiryDate: values.expiryDate.format('YYYY-MM-DD'),
|
||||
productId: values.productId,
|
||||
productName: values.productName,
|
||||
notes: values.notes,
|
||||
});
|
||||
message.success('证书上传成功');
|
||||
fetchData();
|
||||
} catch (error) {
|
||||
message.error('上传失败');
|
||||
}
|
||||
};
|
||||
|
||||
// ... 其他逻辑
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 后端/BFF Mock方案
|
||||
|
||||
### 架构设计
|
||||
|
||||
```
|
||||
BFF层
|
||||
├─ Service (业务逻辑)
|
||||
├─ Mock切换器 (环境变量控制)
|
||||
├─ 真实API客户端
|
||||
└─ Mock服务
|
||||
```
|
||||
|
||||
### 实现示例
|
||||
|
||||
```typescript
|
||||
// /server/src/bff/services/certificateService.ts
|
||||
|
||||
import { CertificateService as RealCertificateService } from '../../services/CertificateService';
|
||||
import { MockCertificateService } from '../mock/certificateMock';
|
||||
|
||||
/**
|
||||
* [MOCK-005] BFF层证书服务
|
||||
* 通过环境变量自动切换Mock/真实服务
|
||||
*/
|
||||
|
||||
const useMock = process.env.USE_MOCK === 'true';
|
||||
|
||||
export const certificateService = useMock
|
||||
? new MockCertificateService()
|
||||
: new RealCertificateService();
|
||||
|
||||
// 类型导出，确保调用方类型安全
|
||||
export type ICertificateService = typeof certificateService;
|
||||
```
|
||||
|
||||
```typescript
|
||||
// /server/src/bff/mock/certificateMock.ts
|
||||
|
||||
import { ICertificateService } from '../services/certificateService';
|
||||
|
||||
/**
|
||||
* [MOCK-006] BFF层Mock服务
|
||||
* 完全独立的Mock实现
|
||||
* AI注意: 这是Mock实现，不是真实业务逻辑
|
||||
*/
|
||||
|
||||
export class MockCertificateService implements ICertificateService {
|
||||
private mockData = [
|
||||
// ... Mock数据
|
||||
];
|
||||
|
||||
async query(options: any) {
|
||||
await this.delay(300);
|
||||
return {
|
||||
items: this.mockData,
|
||||
total: this.mockData.length,
|
||||
};
|
||||
}
|
||||
|
||||
async getById(id: string, tenantId: string, shopId: string) {
|
||||
await this.delay(200);
|
||||
return this.mockData.find(item => item.id === id) || null;
|
||||
}
|
||||
|
||||
async create(input: any) {
|
||||
await this.delay(500);
|
||||
const id = `mock-${Date.now()}`;
|
||||
// ... 创建逻辑
|
||||
return id;
|
||||
}
|
||||
|
||||
private delay(ms: number) {
|
||||
return new Promise(resolve => setTimeout(resolve, ms));
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 目录规范
|
||||
|
||||
### 前端目录规范
|
||||
|
||||
```
|
||||
/dashboard/src
|
||||
/mock ← 所有Mock相关
|
||||
/data ← Mock数据定义
|
||||
*.mock.ts
|
||||
msw.ts ← MSW配置
|
||||
browser.ts ← 浏览器入口
|
||||
server.ts ← Node/测试入口
|
||||
README.md ← Mock使用说明
|
||||
/services ← DataSource抽象层
|
||||
*DataSource.ts
|
||||
/api ← 真实API封装
|
||||
*.ts
|
||||
```
|
||||
|
||||
### 后端目录规范
|
||||
|
||||
```
|
||||
/server/src
|
||||
/bff ← BFF层
|
||||
/mock ← Mock服务
|
||||
*.ts
|
||||
/services ← 服务层
|
||||
*.ts
|
||||
/api ← API客户端
|
||||
*.ts
|
||||
/services ← 真实服务
|
||||
*.ts
|
||||
```
|
||||
|
||||
### 标记规范
|
||||
|
||||
所有Mock文件必须包含以下标记:
|
||||
|
||||
```typescript
|
||||
/**
|
||||
* [MOCK-XXX] 功能描述
|
||||
* AI注意: 这是Mock实现，不是真实业务逻辑
|
||||
* 仅在USE_MOCK=true时启用
|
||||
*/
|
||||
|
||||
// 或者
|
||||
|
||||
// [MOCK] 此文件为Mock数据，AI请勿当作真实业务逻辑
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## AI协作规范
|
||||
|
||||
### 1. Mock文件识别规则
|
||||
|
||||
AI在分析代码时:
|
||||
- ✅ 忽略 `/mock` 目录下所有文件
|
||||
- ✅ 忽略包含 `[MOCK]` 标记的文件
|
||||
- ✅ 忽略 `__MOCK__` 变量为真的代码路径
|
||||
|
||||
### 2. 业务代码规范
|
||||
|
||||
AI生成业务代码时必须:
|
||||
- ✅ 调用 DataSource 抽象层
|
||||
- ✅ 不直接调用 API 或 Mock
|
||||
- ✅ 不硬编码任何数据
|
||||
|
||||
### 3. 文档声明
|
||||
|
||||
```markdown
|
||||
## Mock使用规范
|
||||
|
||||
1. 所有Mock数据必须放 `/mock` 目录
|
||||
2. DataSource层是唯一业务入口
|
||||
3. `USE_MOCK=true` 时才启用Mock
|
||||
4. AI不得将Mock数据当作真实业务逻辑
|
||||
5. Mock不代表真实接口结构，仅用于UI开发
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 实施任务
|
||||
|
||||
### 任务清单
|
||||
|
||||
| 任务ID | 任务描述 | 涉及文件 | 优先级 | 状态 |
|
||||
|--------|----------|----------|--------|------|
|
||||
| MOCK-001 | 创建DataSource接口定义 | `/dashboard/src/types/datasource.ts` | P0 | ⏳ 待实现 |
|
||||
| MOCK-002 | 实现证书DataSource | `/dashboard/src/services/certificateDataSource.ts` | P0 | ⏳ 待实现 |
|
||||
| MOCK-003 | 配置MSW拦截器 | `/dashboard/src/mock/msw.ts` | P0 | ⏳ 待实现 |
|
||||
| MOCK-004 | 入口文件MSW启动 | `/dashboard/src/index.tsx` | P0 | ⏳ 待实现 |
|
||||
| MOCK-005 | BFF层Mock切换器 | `/server/src/bff/services/*.ts` | P1 | ⏳ 待实现 |
|
||||
| MOCK-006 | BFF层Mock服务 | `/server/src/bff/mock/*.ts` | P1 | ⏳ 待实现 |
|
||||
| MOCK-007 | 产品模块DataSource | `/dashboard/src/services/productDataSource.ts` | P1 | ⏳ 待实现 |
|
||||
| MOCK-008 | 订单模块DataSource | `/dashboard/src/services/orderDataSource.ts` | P1 | ⏳ 待实现 |
|
||||
| MOCK-009 | 用户模块DataSource | `/dashboard/src/services/userDataSource.ts` | P1 | ⏳ 待实现 |
|
||||
| MOCK-010 | 库存模块DataSource | `/dashboard/src/services/inventoryDataSource.ts` | P1 | ⏳ 待实现 |
|
||||
| MOCK-011 | 环境变量配置 | `.env.development`, `.env.production` | P0 | ⏳ 待实现 |
|
||||
| MOCK-012 | 文档完善 | `docs/01_Architecture/Mock_Architecture.md` | P0 | ✅ 已完成 |
|
||||
| MOCK-013 | 自动选品模块Mock数据 | `/dashboard/src/mock/data/productSelection.mock.ts` | P0 | ✅ 已完成 |
|
||||
| MOCK-014 | 自动选品DataSource | `/dashboard/src/services/productSelectionDataSource.ts` | P0 | ✅ 已完成 |
|
||||
| MOCK-015 | 自动选品页面Mock集成 | `/dashboard/src/pages/AutoProductSelection/index.tsx` | P0 | ✅ 已完成 |
|
||||
|
||||
### 环境变量配置
|
||||
|
||||
```bash
|
||||
# .env.development (开发环境)
|
||||
REACT_APP_USE_MOCK=true # 前端启用Mock
|
||||
USE_MOCK=true # 后端启用Mock
|
||||
|
||||
# .env.production (生产环境)
|
||||
REACT_APP_USE_MOCK=false # 前端禁用Mock
|
||||
USE_MOCK=false # 后端禁用Mock
|
||||
```
|
||||
|
||||
### 快速启动命令
|
||||
|
||||
```bash
|
||||
# 开发模式 (带Mock)
|
||||
npm run dev:mock
|
||||
|
||||
# 开发模式 (真实API)
|
||||
npm run dev
|
||||
|
||||
# 生产构建
|
||||
npm run build
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 优势总结
|
||||
|
||||
| 特性 | 描述 |
|
||||
|------|------|
|
||||
| 🎯 零侵入 | 业务层完全不感知Mock |
|
||||
| 🔄 可切换 | 环境变量一键切换Mock/真实API |
|
||||
| 🤖 AI安全 | Mock独立文件 + 文档规范 |
|
||||
| 📦 可扩展 | 支持MSW、BFF Mock、本地Mock Server |
|
||||
| 🧪 可测试 | 统一接口便于单元测试 |
|
||||
| 📝 可维护 | 目录清晰，职责分离 |
|
||||
|
||||
---
|
||||
|
||||
## 附录
|
||||
|
||||
### 相关文档
|
||||
|
||||
- [项目特定规则](../.trae/rules/project-specific-rules.md)
|
||||
- [AI协作协议](../.trae/rules/project-specific-rules.md#7-ai-协作协议)
|
||||
- [Task_Overview](../00_Business/Task_Overview.md)
|
||||
|
||||
### 更新记录
|
||||
|
||||
| 时间 | 版本 | 更新内容 |
|
||||
|------|------|----------|
|
||||
| 2026-03-19 | v1.0 | 初始版本，创建完整Mock架构设计 |
|
||||
|
||||
---
|
||||
|
||||
*本文档遵循 Crawlful Hub 项目规范，所有Mock实现必须遵守"低侵入、AI安全"原则。*
|
||||
@@ -145,7 +145,33 @@ Merchant Portal
|
||||
|
||||
---
|
||||
|
||||
## 10. 异常处理闭环
|
||||
## 10. 自动选品闭环
|
||||
|
||||
Flow:
|
||||
Frontend / Scheduler
|
||||
→ ProductSelectionController.execute
|
||||
→ ProductSelectionService.executeSelection
|
||||
→ ProductSelectionService.calculateScore
|
||||
→ ProductPoolRepository.save
|
||||
→ AutoListingService.createListingTask
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 11. 自动上架闭环
|
||||
|
||||
Flow:
|
||||
Scheduler / Manual Trigger
|
||||
→ AutoListingController.batchList
|
||||
→ AutoListingService.batchListProducts
|
||||
→ PlatformApiService.publishProduct
|
||||
→ ListingTaskRepository.updateStatus
|
||||
→ NotificationService.notifyListingResult
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 12. 异常处理闭环
|
||||
|
||||
Flow:
|
||||
Frontend / System
|
||||
|
||||
@@ -67,3 +67,156 @@
|
||||
- **有 API 平台**: 走 `Connector Bus` 标准协议。
|
||||
- **无 API 平台**: 走 `No-API Bridge`，采用 `Collect -> Clean -> Review -> Publish` 流程。
|
||||
- **统一发布编排**: 由 `PublishOrchestrator` 统一管理。
|
||||
|
||||
---
|
||||
|
||||
## 6. AI决策日志系统（AI Decision Logging System）
|
||||
|
||||
> **说明**：本章节定义AI决策全链路日志记录规范，确保"AI建议→人类确认→系统执行"可追溯、可审计。
|
||||
|
||||
### 6.1 日志系统目标
|
||||
|
||||
- **全链路追溯**：每条操作有唯一ID，AI建议→人操作→系统执行关联
|
||||
- **可审计性**：支持事后审计、问题排查、策略优化
|
||||
- **数据完整性**：日志不可篡改，支持长期存储
|
||||
|
||||
### 6.2 日志类型
|
||||
|
||||
| 日志类型 | 内容 | 存储周期 |
|
||||
|----------|------|----------|
|
||||
| **AI建议日志** | 建议动作、参数、置信度、生成时间 | 180天 |
|
||||
| **人工操作日志** | 操作人、修改内容、理由、确认时间 | 永久 |
|
||||
| **系统执行日志** | 执行结果、执行时间、失败原因 | 90天 |
|
||||
| **异常日志** | 异常类型、堆栈、处理结果 | 180天 |
|
||||
|
||||
### 6.3 日志数据结构
|
||||
|
||||
```typescript
|
||||
interface AIDecisionLog {
|
||||
// 唯一标识
|
||||
operation_id: string; // 格式: YYYYMMDD-序号
|
||||
trace_id: string; // 全链路追踪ID
|
||||
|
||||
// AI建议部分
|
||||
ai_suggestion: {
|
||||
action: string; // 操作类型
|
||||
params: Record<string, any>; // 操作参数
|
||||
confidence: number; // 置信度 (0-1)
|
||||
risk_level: 'low' | 'medium' | 'high'; // 风险等级
|
||||
alternative_solutions?: Array<{
|
||||
action: string;
|
||||
params: Record<string, any>;
|
||||
confidence: number;
|
||||
}>;
|
||||
timestamp: string; // ISO 8601
|
||||
model_version?: string; // AI模型版本
|
||||
};
|
||||
|
||||
// 人工审核部分
|
||||
human_review?: {
|
||||
operator: string; // 操作人
|
||||
operator_id: string; // 操作人ID
|
||||
action: 'approved' | 'modified' | 'rejected'; // 审核动作
|
||||
modified_params?: Record<string, any>; // 修改后的参数
|
||||
reason?: string; // 修改/拒绝理由
|
||||
timestamp: string; // ISO 8601
|
||||
};
|
||||
|
||||
// 系统执行部分
|
||||
system_execution: {
|
||||
status: 'pending' | 'success' | 'failed' | 'retrying';
|
||||
result?: Record<string, any>; // 执行结果
|
||||
error_message?: string; // 错误信息
|
||||
retry_count?: number; // 重试次数
|
||||
timestamp: string; // ISO 8601
|
||||
duration_ms?: number; // 执行耗时
|
||||
};
|
||||
|
||||
// 元数据
|
||||
metadata: {
|
||||
tenant_id: string; // 租户ID
|
||||
shop_id?: string; // 店铺ID
|
||||
business_type: 'TOC' | 'TOB'; // 业务类型
|
||||
module: string; // 模块名称
|
||||
created_at: string; // 创建时间
|
||||
updated_at: string; // 更新时间
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
### 6.4 日志存储方案
|
||||
|
||||
| 方案 | 适用场景 | 说明 |
|
||||
|------|----------|------|
|
||||
| **MySQL** | 中小规模 | 使用JSON字段存储，支持索引查询 |
|
||||
| **MongoDB** | 大规模 | 原生JSON支持，高性能写入 |
|
||||
| **Elasticsearch** | 日志分析 | 全文搜索、聚合分析、可视化 |
|
||||
|
||||
### 6.5 日志查询API
|
||||
|
||||
```typescript
|
||||
// 查询日志
|
||||
GET /api/v1/logs/ai-decision
|
||||
?operation_id=20260319-001
|
||||
&trace_id=xxx
|
||||
&operator=admin
|
||||
&status=success
|
||||
&start_date=2026-03-01
|
||||
&end_date=2026-03-19
|
||||
&page=1
|
||||
&page_size=20
|
||||
|
||||
// 日志统计
|
||||
GET /api/v1/logs/ai-decision/stats
|
||||
?module=pricing
|
||||
&period=daily
|
||||
```
|
||||
|
||||
### 6.6 日志安全
|
||||
|
||||
- **访问控制**：只有ADMIN和FINANCE角色可查看完整日志
|
||||
- **数据脱敏**：敏感字段（价格、利润）根据权限脱敏显示
|
||||
- **审计追踪**：日志查询操作本身也被记录
|
||||
|
||||
---
|
||||
|
||||
## 7. 自动化程度配置（Automation Level Config）
|
||||
|
||||
> **说明**：定义AI决策自动化程度的配置规范，支持渐进式自动化演进。
|
||||
|
||||
### 7.1 自动化等级
|
||||
|
||||
| 等级 | 名称 | AI角色 | 人类角色 | 适用场景 |
|
||||
|------|------|--------|----------|----------|
|
||||
| **L1** | 辅助决策 | 建议生成 | 全部确认 | 高风险操作 |
|
||||
| **L2** | 部分自动 | 低风险自动 | 高风险确认 | 常规操作 |
|
||||
| **L3** | 有条件自动 | 大部分自动 | 异常介入 | 成熟业务 |
|
||||
| **L4** | 高度自动 | 全链路决策 | 仅监控 | 低风险高频 |
|
||||
|
||||
### 7.2 自动执行阈值配置
|
||||
|
||||
```typescript
|
||||
interface AutoExecutionConfig {
|
||||
module: string; // 模块名称
|
||||
enabled: boolean; // 是否启用自动执行
|
||||
min_confidence: number; // 最低置信度阈值 (默认0.85)
|
||||
max_risk_level: 'low' | 'medium'; // 最大允许风险等级
|
||||
daily_limit?: number; // 每日自动执行上限
|
||||
require_review_actions: string[]; // 必须人工审核的操作
|
||||
}
|
||||
```
|
||||
|
||||
### 7.3 模块默认配置
|
||||
|
||||
| 模块 | 默认等级 | 置信度阈值 | 风险限制 |
|
||||
|------|----------|------------|----------|
|
||||
| 定价调整 | L2 | 0.90 | low |
|
||||
| 库存补货 | L2 | 0.85 | low, medium |
|
||||
| 广告投放 | L3 | 0.80 | low, medium |
|
||||
| 订单处理 | L3 | 0.85 | low |
|
||||
| 财务操作 | L1 | 1.00 | - (全部人工) |
|
||||
| 退款审批 | L1 | 1.00 | - (全部人工) |
|
||||
|
||||
---
|
||||
|
||||
*本架构文档遵循 Crawlful Hub 项目规范，所有系统设计必须遵守逻辑集中化原则。*
|
||||
|
||||
@@ -138,4 +138,60 @@
|
||||
- 单元测试
|
||||
- 集成测试
|
||||
- 构建检查
|
||||
- CI 失败必须及时修复
|
||||
- CI 失败必须及时修复
|
||||
|
||||
---
|
||||
|
||||
## 逻辑集中化强制规则
|
||||
|
||||
### 核心原则
|
||||
> **所有业务逻辑必须集中在 Service 层，禁止分散在 Controller、前端或数据库操作中。**
|
||||
|
||||
### AI开发强制规则
|
||||
|
||||
1. **禁止在 Controller 中实现业务逻辑**
|
||||
- Controller 只负责请求/响应和权限校验
|
||||
- 业务决策、状态变化、数据校验必须在 Service 层
|
||||
|
||||
2. **禁止在前端实现业务规则**
|
||||
- 前端只负责展示、交互和调用接口
|
||||
- 禁止在前端进行业务计算、状态判断和权限判断
|
||||
|
||||
3. **禁止直接操作数据库**
|
||||
- 所有数据库操作必须通过 Repository 层
|
||||
- AI 不允许直接使用数据库连接或 ORM 操作数据库
|
||||
|
||||
4. **所有业务逻辑必须封装在 Service 层**
|
||||
- 每个业务操作必须对应一个 Service 方法
|
||||
- Service 方法必须体现业务闭环
|
||||
|
||||
5. **所有状态变更必须通过 Service 方法**
|
||||
- 禁止直接修改状态字段
|
||||
- 状态变更必须通过 Service 方法并遵循状态机
|
||||
|
||||
6. **所有跨模块操作必须在 Service 中完成**
|
||||
- 跨模块协同必须在 Service 层实现
|
||||
- 禁止在 Controller 或前端进行跨模块调用
|
||||
|
||||
7. **AI 修改代码时的优先顺序**
|
||||
- 优先修改 Service 层代码
|
||||
- 其次修改 Repository 层代码
|
||||
- 最后修改 Controller 或前端代码
|
||||
|
||||
8. **Service 方法命名规范**
|
||||
- 方法名必须体现业务闭环
|
||||
- 例如：`createOrderWithInventoryLock()` 而不是 `createOrder()`
|
||||
|
||||
9. **状态机遵循**
|
||||
- 所有状态变更必须遵循 STATE_MACHINE 定义
|
||||
- 禁止非法状态流转
|
||||
|
||||
10. **服务层职责边界**
|
||||
- Controller：请求/响应 + 权限校验
|
||||
- Service：业务逻辑编排 + 状态流转 + 多模块协同
|
||||
- Repository：数据库 CRUD 操作
|
||||
|
||||
### 违反后果
|
||||
- **代码审查不通过**：任何违反逻辑集中化原则的代码将被拒绝合并
|
||||
- **AI 任务失败**：AI 无法维护分散的逻辑，导致任务执行失败
|
||||
- **生产环境风险**：分散逻辑导致数据不一致，直接影响系统稳定性
|
||||
@@ -30,7 +30,24 @@
|
||||
| 前端优化 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
|
||||
| 前端页面骨架创建 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
|
||||
| 前端文档补充 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
|
||||
| 系统集成测试 | 🔄 进行中 | 2026-03-19 | - |
|
||||
| 运行态架构设计 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
|
||||
| 分布式队列实现 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
|
||||
| WebSocket实时推送系统 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
|
||||
| 计费系统实现 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
|
||||
| 前端Task Center页面 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
|
||||
| 系统集成测试 | ✅ 已完成 | 2026-03-19 | 2026-03-18 |
|
||||
| 性能优化与安全加固 | ✅ 已完成 | 2026-03-19 | 2026-03-18 |
|
||||
| 部署准备与文档完善 | ✅ 已完成 | 2026-03-19 | 2026-03-18 |
|
||||
| 超大型系统集成与部署任务包 | ✅ 已完成 | 2026-03-19 | 2026-03-18 |
|
||||
| 多商户收益排行榜系统（信任引擎） | ✅ 已完成 | 2026-03-25 | 2026-03-19 |
|
||||
| 策略市场（Strategy Marketplace） | ✅ 已完成 | 2026-03-25 | 2026-03-19 |
|
||||
| 自动选品+自动上架系统（增长引擎） | ✅ 已完成 | 2026-03-25 | 2026-03-20 |
|
||||
| AI店铺托管（AutoPilot） | ⏳ 待实现 | 2026-03-30 | - |
|
||||
| 跨平台套利系统完善 | ⏳ 待实现 | 2026-03-30 | - |
|
||||
| AI动态定价系统完善 | ⏳ 待实现 | 2026-03-30 | - |
|
||||
| 多租户基础架构（商户→部门→店铺） | ⏳ 待实现 | 2026-03-25 | - |
|
||||
| 订单多店铺管理 | ⏳ 待实现 | 2026-03-25 | - |
|
||||
| 多店铺报表聚合 | ⏳ 待实现 | 2026-03-30 | - |
|
||||
|
||||
## 📋 任务状态跟踪
|
||||
|
||||
@@ -89,14 +106,50 @@
|
||||
52. ✅ 更新项目规则文档（project-specific-rules.md），加入逻辑集中化原则
|
||||
53. ✅ 更新SERVICE_MAP.md，强化服务层职责和调用规范
|
||||
54. ✅ 更新Service_Design.md，明确服务层设计规范和边界
|
||||
55. ✅ 安装并配置ESLint插件 eslint-plugin-boundaries，实施边界约束
|
||||
56. ✅ 创建ESLint配置文件，确保Controller只能调用Service层
|
||||
57. ✅ 更新AI_RULES.md，添加详细的逻辑集中化强制规则
|
||||
58. ✅ 执行代码审查，识别并修复逻辑分散问题
|
||||
59. ✅ 重构OrderController，将业务逻辑迁移到OrderService
|
||||
60. ✅ 实施Service Guard运行时保护，确保所有业务逻辑通过Service层
|
||||
61. ✅ 验证状态机实现，确保状态流转正确
|
||||
62. ✅ 创建Runtime_Architecture.md文档，详细说明运行态架构设计
|
||||
63. ✅ 创建后端Runtime代码骨架，包括eventBus、jobQueue、worker、scheduler等模块
|
||||
64. ✅ 实现BullMQ分布式队列，替换内存队列，支持优先级和限流
|
||||
65. ✅ 实现WebSocket实时推送系统，支持商户级精准推送
|
||||
66. ✅ 实现完整计费系统，包括数据库设计、UsageService和BillingService
|
||||
67. ✅ 创建前端Task Center页面，支持任务监控和实时更新
|
||||
68. ✅ 创建Event Log页面，用于显示系统事件日志
|
||||
69. ✅ 创建Billing页面，用于显示商户的账单信息
|
||||
70. ✅ 安装并启动Redis服务（Memurai），解决BullMQ连接问题
|
||||
71. ✅ 修复queue-core.ts，延迟Queue创建避免启动时Redis连接错误
|
||||
72. ✅ 修复scheduler.ts，使用BullMQ的addJob替代旧版createJob
|
||||
73. ✅ 后端服务器成功启动并运行在 http://localhost:3001
|
||||
74. ✅ API测试通过，认证接口正常工作
|
||||
75. ✅ 前端Dashboard服务成功启动并运行在 http://localhost:8000
|
||||
76. ✅ 实现自动选品+自动上架系统前端页面（AutoProductSelection/index.tsx）
|
||||
77. ✅ 实现ProductSelectionService后端服务，包含选品规则管理、商品池管理、选品执行等功能
|
||||
78. ✅ 实现AutoListingService后端服务，包含自动上架配置、上架任务管理、批量上架等功能
|
||||
79. ✅ 创建自动选品Mock数据文件（productSelection.mock.ts），包含完整的类型定义和Mock数据
|
||||
80. ✅ 创建productSelectionDataSource.ts数据源抽象层，实现环境变量自动切换Mock/真实API
|
||||
81. ✅ 重构AutoProductSelection页面，移除硬编码Mock数据，改用DataSource抽象层获取数据
|
||||
82. ✅ 实现多商户收益排行榜系统数据库表结构（cf_merchant_metrics, cf_leaderboard_snapshot）
|
||||
83. ✅ 实现MerchantMetricsService后端服务，包含商户指标计算、存储、查询等功能
|
||||
84. ✅ 实现LeaderboardService后端服务，包含排行榜生成、缓存、防作弊等功能
|
||||
85. ✅ 实现Leaderboard前端页面，包含收益榜/ROI榜/增长榜展示、商户排名、TOP10展示等
|
||||
86. ✅ 添加Leaderboard路由和菜单项，集成到系统导航
|
||||
|
||||
### 进行中任务
|
||||
1. 🔄 系统集成测试
|
||||
2. 🔄 前端交互任务开发
|
||||
（无进行中任务）
|
||||
|
||||
### 待开始任务
|
||||
1. ⏳ 性能测试和优化
|
||||
2. ⏳ 安全测试
|
||||
1. ⏳ 策略市场（Strategy Marketplace）🆕
|
||||
2. ⏳ AI店铺托管（AutoPilot）🆕
|
||||
3. ⏳ 跨平台套利系统完善🆕
|
||||
5. ⏳ AI动态定价系统完善🆕
|
||||
6. ⏳ 多租户基础架构（商户→部门→店铺）🆕
|
||||
7. ⏳ 订单多店铺管理🆕
|
||||
8. ⏳ 多店铺报表聚合🆕
|
||||
|
||||
## 🏗️ 架构演进
|
||||
|
||||
@@ -299,6 +352,51 @@
|
||||
- **2026-03-18**：更新项目规则文档（project-specific-rules.md），加入逻辑集中化原则
|
||||
- **2026-03-18**：更新SERVICE_MAP.md，强化服务层职责和调用规范
|
||||
- **2026-03-18**：更新Service_Design.md，明确服务层设计规范和边界
|
||||
- **2026-03-18**：安装并配置ESLint插件 eslint-plugin-boundaries，实施边界约束
|
||||
- **2026-03-18**：创建ESLint配置文件，确保Controller只能调用Service层
|
||||
- **2026-03-18**：更新AI_RULES.md，添加详细的逻辑集中化强制规则
|
||||
- **2026-03-18**：执行代码审查，识别并修复逻辑分散问题
|
||||
- **2026-03-18**：重构OrderController，将业务逻辑迁移到OrderService
|
||||
- **2026-03-18**：实施Service Guard运行时保护，确保所有业务逻辑通过Service层
|
||||
- **2026-03-18**：验证状态机实现，确保状态流转正确
|
||||
- **2026-03-18**：创建Runtime_Architecture.md文档，详细说明运行态架构设计
|
||||
- **2026-03-18**：创建后端Runtime代码骨架，包括eventBus、jobQueue、worker、scheduler等模块
|
||||
- **2026-03-18**：实现BullMQ分布式队列，替换内存队列，支持优先级和限流
|
||||
- **2026-03-18**：实现WebSocket实时推送系统，支持商户级精准推送
|
||||
- **2026-03-18**：实现完整计费系统，包括数据库设计、UsageService和BillingService
|
||||
- **2026-03-18**：创建前端Task Center页面，支持任务监控和实时更新
|
||||
- **2026-03-18**：创建Event Log页面，用于显示系统事件日志
|
||||
- **2026-03-18**：创建Billing页面，用于显示商户的账单信息
|
||||
- **2026-03-18**：安装并启动Redis服务（Memurai），解决BullMQ连接问题
|
||||
- **2026-03-18**：修复queue-core.ts，延迟Queue创建避免启动时Redis连接错误
|
||||
- **2026-03-18**：修复scheduler.ts，使用BullMQ的addJob替代旧版createJob
|
||||
- **2026-03-18**：后端服务器成功启动并运行在 http://localhost:3001
|
||||
- **2026-03-18**：API测试通过，认证接口正常工作
|
||||
- **2026-03-18**：前端Dashboard服务成功启动并运行在 http://localhost:8000
|
||||
- **2026-03-19**：完成多店铺管理方案设计，包括商户→部门→店铺三层架构
|
||||
- **2026-03-19**：更新Task_Overview.md，添加多租户基础架构、订单多店铺管理、多店铺报表聚合任务包
|
||||
- **2026-03-19**：更新Business_ClosedLoops.md，添加多店铺管理闭环和多租户层级管理闭环
|
||||
- **2026-03-19**：更新Development_Progress.md，添加多店铺管理相关里程碑和待开始任务
|
||||
- **2026-03-20**：实现自动选品+自动上架系统前端页面（AutoProductSelection/index.tsx）
|
||||
- **2026-03-20**：实现ProductSelectionService后端服务，包含选品规则管理、商品池管理、选品执行等功能
|
||||
- **2026-03-20**：实现AutoListingService后端服务，包含自动上架配置、上架任务管理、批量上架等功能
|
||||
- **2026-03-20**：创建自动选品Mock数据文件（productSelection.mock.ts），符合项目Mock规范
|
||||
- **2026-03-20**：创建productSelectionDataSource.ts数据源抽象层，实现环境变量自动切换Mock/真实API
|
||||
- **2026-03-20**：重构AutoProductSelection页面，移除硬编码Mock数据，改用DataSource抽象层获取数据
|
||||
- **2026-03-19**：实现多商户收益排行榜系统（信任引擎）完整功能
|
||||
- **2026-03-19**：创建cf_merchant_metrics和cf_leaderboard_snapshot数据库表结构
|
||||
- **2026-03-19**：实现MerchantMetricsService，包含商户指标计算、存储、查询、验证等功能
|
||||
- **2026-03-19**：实现LeaderboardService，包含排行榜生成、缓存、防作弊、自动刷新等功能
|
||||
- **2026-03-19**：创建Leaderboard前端页面，支持收益榜/ROI榜/增长榜三种排行榜展示
|
||||
- **2026-03-19**：实现TOP10商户展示、商户排名查询、防作弊过滤等功能
|
||||
- **2026-03-19**：添加Leaderboard路由和菜单项，集成到系统导航
|
||||
- **2026-03-19**：实现策略市场（Strategy Marketplace）完整功能
|
||||
- **2026-03-19**：创建cf_strategies和cf_merchant_strategies数据库表结构
|
||||
- **2026-03-19**：实现StrategyService，包含策略管理、激活、暂停、完成、统计更新等功能
|
||||
- **2026-03-19**：实现StrategyRecommendationService，包含个性化推荐、分类推荐、相似策略、趋势策略等功能
|
||||
- **2026-03-19**：创建StrategyMarketplace前端页面，支持市场/精选/趋势/推荐/我的策略五个Tab
|
||||
- **2026-03-19**：实现策略推荐算法（评分计算、ROI预估、置信度评估）
|
||||
- **2026-03-19**：添加StrategyMarketplace路由和菜单项，集成到系统导航
|
||||
|
||||
### 关键洞察
|
||||
1. **服务闭环与收费的关系**：服务闭环跟收费没有必然关系，收费只是把问题放大了。只要存在"状态流转 + 多模块协同"，就必须有服务闭环。
|
||||
@@ -307,6 +405,11 @@
|
||||
4. **前端优化的重要性**：前端是用户直接接触的界面，其流畅性和功能完整性直接影响用户体验和系统的商业价值。
|
||||
5. **逻辑集中化的必要性**：逻辑分散导致AI难以维护，状态不一致，修改风险高。集中化逻辑到服务层 + 统一状态管理，AI才能高效维护和迭代。
|
||||
6. **服务层职责边界**：Controller只负责请求/响应和权限校验，Service层负责业务逻辑编排和状态流转，Repository层负责数据库操作。明确职责边界是逻辑集中化的基础。
|
||||
7. **静态检查与运行时保护**：通过ESLint插件和Service Guard运行时保护，可以强制确保所有业务逻辑都通过Service层，避免逻辑分散。
|
||||
8. **代码审查的重要性**：定期进行代码审查，确保新代码符合逻辑集中化原则，是维护系统可扩展性和可维护性的关键。
|
||||
9. **多店铺管理的层级架构**：商户→部门→店铺三层架构确保了数据隔离和权限控制的清晰边界，每个层级的数据可见性和操作权限都有明确限制。
|
||||
10. **数据隔离的必要性**：多店铺环境下，数据隔离是核心安全需求，必须通过服务层统一实现，避免前端或Controller直接操作导致数据泄露。
|
||||
11. **Mock架构规范的重要性**：Mock数据必须隔离在`/mock`目录，通过DataSource抽象层获取数据，禁止在业务组件中硬编码Mock数据。这确保了AI上下文安全，避免AI将Mock数据误认为真实业务逻辑。
|
||||
|
||||
### AI开发建议
|
||||
1. 优先进行系统集成测试，确保各服务之间的正确交互
|
||||
@@ -319,19 +422,26 @@
|
||||
8. **严格执行逻辑集中化原则**：所有业务逻辑必须集中在 Service 层，禁止分散在 Controller、前端或数据库操作中
|
||||
9. **明确服务层职责边界**：Controller 只负责请求/响应和权限校验，Service 层负责业务逻辑编排和状态流转，Repository 层负责数据库操作
|
||||
10. **统一状态管理**：前端使用全局 Model 或状态管理库，后端统一使用 STATE_MACHINE 定义的状态机，所有状态更新必须通过 Service 层
|
||||
11. **使用ESLint插件**：配置 eslint-plugin-boundaries 插件，确保Controller只能调用Service层
|
||||
12. **实施Service Guard**：使用运行时保护机制，禁止直接操作数据库，确保所有业务逻辑通过Service层
|
||||
13. **定期代码审查**：定期审查代码，确保新代码符合逻辑集中化原则
|
||||
14. **重构现有代码**：逐步将分散的业务逻辑迁移到Service层，确保职责边界清晰
|
||||
|
||||
## 📝 下一步计划
|
||||
|
||||
### 短期计划（2026-03-19 至 2026-03-21）
|
||||
1. 完成系统集成测试，验证服务层功能
|
||||
2. 优化数据库查询和缓存策略
|
||||
3. 实现完整的错误处理和日志记录
|
||||
4. 进行性能测试和优化
|
||||
5. 实现安全测试，确保系统安全性
|
||||
6. 完成前端交互任务开发，包括筛选、排序、新增、编辑、定价、上架、同步等
|
||||
7. **代码审查**：检查所有Controller、Service、Repository代码，确保符合逻辑集中化原则
|
||||
8. **重构优化**：将分散的业务逻辑迁移到Service层，确保职责边界清晰
|
||||
9. **测试验证**：验证逻辑集中化后的代码，确保功能正确性和数据一致性
|
||||
1. ✅ 完成后端服务器启动，解决Redis连接问题
|
||||
2. 🔄 完成系统集成测试，验证服务层功能
|
||||
3. 🔄 测试BullMQ Worker和队列系统
|
||||
4. 🔄 测试WebSocket实时推送功能
|
||||
5. ⏳ 优化数据库查询和缓存策略
|
||||
6. ⏳ 实现完整的错误处理和日志记录
|
||||
7. ⏳ 进行性能测试和优化
|
||||
8. ⏳ 实现安全测试，确保系统安全性
|
||||
9. ⏳ 完成前端交互任务开发，包括筛选、排序、新增、编辑、定价、上架、同步等
|
||||
10. ⏳ 验证ESLint配置和Service Guard的有效性
|
||||
11. ⏳ 完善Repository层实现，确保所有数据库操作都通过Repository层
|
||||
12. ⏳ 优化Service层性能，特别是异步操作和错误处理
|
||||
|
||||
### 中期计划（2026-03-22 至 2026-03-28）
|
||||
1. 完善前端与后端的集成，实现数据实时同步
|
||||
|
||||
@@ -1,685 +0,0 @@
|
||||
# 项目模块清单与说明
|
||||
|
||||
## 1. 项目整体结构
|
||||
|
||||
```
|
||||
├── .github/ # GitHub配置和CI/CD工作流
|
||||
├── .prompts/ # AI提示配置
|
||||
├── .trae/ # Trae IDE配置和项目规则
|
||||
├── dashboard/ # 前端仪表板
|
||||
├── docs/ # 项目文档
|
||||
├── docs1/ # 备用文档
|
||||
├── docs11/ # 备用文档
|
||||
├── extension/ # 浏览器扩展
|
||||
├── node-agent/ # 节点代理
|
||||
├── scripts/ # 脚本文件
|
||||
├── server/ # 后端服务
|
||||
├── .continueignore # Continue配置
|
||||
├── .gitignore # Git忽略文件
|
||||
├── README.md # 项目说明
|
||||
├── package.json # 项目依赖
|
||||
```
|
||||
|
||||
## 2. 后端模块清单
|
||||
|
||||
### 2.1 核心服务 (server/src/services/)
|
||||
|
||||
| 模块名称 | 路径 | 功能描述 | 状态 |
|
||||
|---------|------|---------|------|
|
||||
| ABTestAnalysisService | services/ABTestAnalysisService.ts | A/B测试分析服务 | 未实现 |
|
||||
| ABTestService | services/ABTestService.ts | A/B测试服务 | 未实现 |
|
||||
| AGIStrategyEvolutionService | services/AGIStrategyEvolutionService.ts | AGI策略演化服务 | 未实现 |
|
||||
| AIService | services/AIService.ts | AI服务 | 未实现 |
|
||||
| ActionAuditService | services/ActionAuditService.ts | 操作审计服务 | 未实现 |
|
||||
| AdAutoService | services/AdAutoService.ts | 广告自动化服务 | 未实现 |
|
||||
| AdCreativeService | services/AdCreativeService.ts | 广告创意服务 | 未实现 |
|
||||
| AdMimicryService | services/AdMimicryService.ts | 广告模仿服务 | 未实现 |
|
||||
| AdOptimizationService | services/AdOptimizationService.ts | 广告优化服务 | 未实现 |
|
||||
| AdPlanService | services/AdPlanService.ts | 广告计划服务 | 未实现 |
|
||||
| AdPredictionService | services/AdPredictionService.ts | 广告预测服务 | 未实现 |
|
||||
| AfterSalesService | services/AfterSalesService.ts | 售后服务 | 未实现 |
|
||||
| AgentSwarmService | services/AgentSwarmService.ts | 智能体集群服务 | 未实现 |
|
||||
| AgingInventoryService | services/AgingInventoryService.ts | 库存老化服务 | 未实现 |
|
||||
| ArbitrageService | services/ArbitrageService.ts | 套利服务 | 未实现 |
|
||||
| AuditService | services/AuditService.ts | 审计服务 | 未实现 |
|
||||
| AuditWorker | services/AuditWorker.ts | 审计工作器 | 未实现 |
|
||||
| AuthService | services/AuthService.ts | 认证服务 | 未实现 |
|
||||
| AutoCircuitBreakerService | services/AutoCircuitBreakerService.ts | 自动熔断服务 | 未实现 |
|
||||
| AutoDelistService | services/AutoDelistService.ts | 自动下架服务 | 未实现 |
|
||||
| AutoDiagnosticsService | services/AutoDiagnosticsService.ts | 自动诊断服务 | 未实现 |
|
||||
| AutoRedTeamingService | services/AutoRedTeamingService.ts | 自动红队服务 | 未实现 |
|
||||
| AutoReturnQAService | services/AutoReturnQAService.ts | 自动退货QA服务 | 未实现 |
|
||||
| AutonomousEcoService | services/AutonomousEcoService.ts | 自主生态服务 | 未实现 |
|
||||
| AutonomousSandboxService | services/AutonomousSandboxService.ts | 自主沙箱服务 | 未实现 |
|
||||
| AutonomousSourcingService | services/AutonomousSourcingService.ts | 自主采购服务 | 未实现 |
|
||||
| AutonomousWarehousingService | services/AutonomousWarehousingService.ts | 自主仓储服务 | 未实现 |
|
||||
| B2BAIService | services/B2BAIService.ts | B2B AI服务 | 未实现 |
|
||||
| B2BTradeService | services/B2BTradeService.ts | B2B贸易服务 | 未实现 |
|
||||
| BehavioralRiskService | services/BehavioralRiskService.ts | 行为风险服务 | 未实现 |
|
||||
| BiddingStrategyService | services/BiddingStrategyService.ts | 竞价策略服务 | 未实现 |
|
||||
| BlacklistDatabaseService | services/BlacklistDatabaseService.ts | 黑名单数据库服务 | 未实现 |
|
||||
| BlacklistService | services/BlacklistService.ts | 黑名单服务 | 未实现 |
|
||||
| BlacklistShareService | services/BlacklistShareService.ts | 黑名单共享服务 | 未实现 |
|
||||
| BlockchainTraceabilityService | services/BlockchainTraceabilityService.ts | 区块链溯源服务 | 未实现 |
|
||||
| BondedWarehouseService | services/BondedWarehouseService.ts | 保税仓服务 | 未实现 |
|
||||
| BrandSovereigntyService | services/BrandSovereigntyService.ts | 品牌主权服务 | 未实现 |
|
||||
| BullMQDeadLetterService | services/BullMQDeadLetterService.ts | BullMQ死信服务 | 未实现 |
|
||||
| BullMQService | services/BullMQService.ts | BullMQ服务 | 未实现 |
|
||||
| BusinessModelEvolutionService | services/BusinessModelEvolutionService.ts | 商业模式演化服务 | 已实现 |
|
||||
| CarbonCostGameService | services/CarbonCostGameService.ts | 碳成本博弈服务 | 未实现 |
|
||||
| CarbonNeutralPathService | services/CarbonNeutralPathService.ts | 碳中和路径服务 | 未实现 |
|
||||
| CashflowForecastService | services/CashflowForecastService.ts | 现金流预测服务 | 已实现 |
|
||||
| CashflowPredictor | services/CashflowPredictor.ts | 现金流预测器 | 未实现 |
|
||||
| CashflowService | services/CashflowService.ts | 现金流服务 | 未实现 |
|
||||
| CertificateDatabaseService | services/CertificateDatabaseService.ts | 证书数据库服务 | 未实现 |
|
||||
| CertificateService | services/CertificateService.ts | 证书服务 | 未实现 |
|
||||
| ChannelStatusService | services/ChannelStatusService.ts | 渠道状态服务 | 未实现 |
|
||||
| CommodityHedgingService | services/CommodityHedgingService.ts | 商品对冲服务 | 未实现 |
|
||||
| CompetitorPulseService | services/CompetitorPulseService.ts | 竞争对手脉搏服务 | 未实现 |
|
||||
| CompetitorService | services/CompetitorService.ts | 竞争对手服务 | 未实现 |
|
||||
| ComplianceCheckService | services/ComplianceCheckService.ts | 合规检查服务 | 未实现 |
|
||||
| ComplianceGateService | services/ComplianceGateService.ts | 合规门禁服务 | 未实现 |
|
||||
| ComplianceRuleDatabaseService | services/ComplianceRuleDatabaseService.ts | 合规规则数据库服务 | 未实现 |
|
||||
| ConfidentialSharingService | services/ConfidentialSharingService.ts | 机密共享服务 | 未实现 |
|
||||
| ConfigService | services/ConfigService.ts | 配置服务 | 未实现 |
|
||||
| CongestionFailoverService | services/CongestionFailoverService.ts | 拥塞故障转移服务 | 未实现 |
|
||||
| ContainerQuotaService | services/ContainerQuotaService.ts | 容器配额服务 | 未实现 |
|
||||
| ContentGapService | services/ContentGapService.ts | 内容差距服务 | 未实现 |
|
||||
| CostAttributionService | services/CostAttributionService.ts | 成本归因服务 | 未实现 |
|
||||
| CreditLimitService | services/CreditLimitService.ts | 信用额度服务 | 未实现 |
|
||||
| CrossTenantEmbeddingAggregator | services/CrossTenantEmbeddingAggregator.ts | 跨租户嵌入聚合器 | 未实现 |
|
||||
| CurrencyRiskService | services/CurrencyRiskService.ts | 货币风险服务 | 未实现 |
|
||||
| CustomerServiceAgent | services/CustomerServiceAgent.ts | 客户服务代理 | 未实现 |
|
||||
| CustomsDeclarationService | services/CustomsDeclarationService.ts | 报关服务 | 未实现 |
|
||||
| DSOOptimizerService | services/DSOOptimizerService.ts | DSO优化服务 | 未实现 |
|
||||
| DataComplianceService | services/DataComplianceService.ts | 数据合规服务 | 未实现 |
|
||||
| DeadlockAdvisor | services/DeadlockAdvisor.ts | 死锁顾问 | 未实现 |
|
||||
| DecentralizedArbitrationService | services/DecentralizedArbitrationService.ts | 去中心化仲裁服务 | 未实现 |
|
||||
| DeployService | services/DeployService.ts | 部署服务 | 已实现 |
|
||||
| DevOpsService | services/DevOpsService.ts | DevOps服务 | 未实现 |
|
||||
| DisputeAdvisorService | services/DisputeAdvisorService.ts | 争议顾问服务 | 未实现 |
|
||||
| DisputeClassifier | services/DisputeClassifier.ts | 争议分类器 | 未实现 |
|
||||
| DisputeResolverService | services/DisputeResolverService.ts | 争议解决服务 | 已实现 |
|
||||
| DynamicPricingService | services/DynamicPricingService.ts | 动态定价服务 | 已实现 |
|
||||
| DynamicRecompositionService | services/DynamicRecompositionService.ts | 动态重组服务 | 未实现 |
|
||||
| DynamicShippingService | services/DynamicShippingService.ts | 动态 shipping 服务 | 未实现 |
|
||||
| EcoValueSharingService | services/EcoValueSharingService.ts | 生态价值共享服务 | 未实现 |
|
||||
| EdgeSyncService | services/EdgeSyncService.ts | 边缘同步服务 | 未实现 |
|
||||
| EncryptedStreamAuditService | services/EncryptedStreamAuditService.ts | 加密流审计服务 | 未实现 |
|
||||
| EventBusService | services/EventBusService.ts | 事件总线服务 | 未实现 |
|
||||
| ExceptionAutoFixService | services/ExceptionAutoFixService.ts | 异常自动修复服务 | 未实现 |
|
||||
| ExperimentService | services/ExperimentService.ts | 实验服务 | 未实现 |
|
||||
| FXHedgingService | services/FXHedgingService.ts | 外汇对冲服务 | 未实现 |
|
||||
| FXRebalancingService | services/FXRebalancingService.ts | 外汇再平衡服务 | 未实现 |
|
||||
| FactoryMonitorService | services/FactoryMonitorService.ts | 工厂监控服务 | 未实现 |
|
||||
| FailoverLogisticsService | services/FailoverLogisticsService.ts | 故障转移物流服务 | 未实现 |
|
||||
| FestivalMarketingService | services/FestivalMarketingService.ts | 节日营销服务 | 未实现 |
|
||||
| FinanceService | services/FinanceService.ts | 财务服务 | 未实现 |
|
||||
| FraudSharedService | services/FraudSharedService.ts | 欺诈共享服务 | 未实现 |
|
||||
| FreightAuditor | services/FreightAuditor.ts | 货运审计员 | 未实现 |
|
||||
| FulfillmentConsensusService | services/FulfillmentConsensusService.ts | 履行共识服务 | 未实现 |
|
||||
| GeopoliticalRiskHedgeService | services/GeopoliticalRiskHedgeService.ts | 地缘政治风险对冲服务 | 未实现 |
|
||||
| GlobalCSMonitor | services/GlobalCSMonitor.ts | 全球客服监控 | 未实现 |
|
||||
| GreenSupplyChainService | services/GreenSupplyChainService.ts | 绿色供应链服务 | 未实现 |
|
||||
| GreenSupplyService | services/GreenSupplyService.ts | 绿色供应服务 | 未实现 |
|
||||
| HighValueQAService | services/HighValueQAService.ts | 高价值QA服务 | 未实现 |
|
||||
| HolidayRiskService | services/HolidayRiskService.ts | 假日风险服务 | 未实现 |
|
||||
| IPCheckService | services/IPCheckService.ts | IP检查服务 | 未实现 |
|
||||
| IPSentinelService | services/IPSentinelService.ts | IP哨兵服务 | 未实现 |
|
||||
| ImageFingerprintService | services/ImageFingerprintService.ts | 图像指纹服务 | 未实现 |
|
||||
| ImprovementSuggestionService | services/ImprovementSuggestionService.ts | 改进建议服务 | 未实现 |
|
||||
| InfluencerBotService | services/InfluencerBotService.ts | 红人营销自动邀约机器人 | 已实现 |
|
||||
| InventoryAgingService | services/InventoryAgingService.ts | 库存老化服务 | 已实现 |
|
||||
| InventoryDistributionService | services/InventoryDistributionService.ts | 库存分配服务 | 未实现 |
|
||||
| InventoryForecastService | services/InventoryForecastService.ts | 库存预测服务 | 未实现 |
|
||||
| InventoryRLService | services/InventoryRLService.ts | 库存强化学习服务 | 未实现 |
|
||||
| InventoryService | services/InventoryService.ts | 库存服务 | 未实现 |
|
||||
| InventorySyncV2Service | services/InventorySyncV2Service.ts | 库存同步V2服务 | 未实现 |
|
||||
| InvoiceLateRiskService | services/InvoiceLateRiskService.ts | 发票逾期风险服务 | 未实现 |
|
||||
| InvoicingService | services/InvoicingService.ts | 发票服务 | 未实现 |
|
||||
| KOLOrchestratorService | services/KOLOrchestratorService.ts | KOL编排服务 | 未实现 |
|
||||
| LastMileOptimizerService | services/LastMileOptimizerService.ts | 最后一公里优化服务 | 未实现 |
|
||||
| LeadTimeDriftService | services/LeadTimeDriftService.ts | 前置时间漂移服务 | 未实现 |
|
||||
| LiquidityHedgingService | services/LiquidityHedgingService.ts | 流动性对冲服务 | 未实现 |
|
||||
| LiveScriptService | services/LiveScriptService.ts | 实时脚本服务 | 未实现 |
|
||||
| LogAnalyticsService | services/LogAnalyticsService.ts | 日志分析服务 | 未实现 |
|
||||
| LogisticTTLService | services/LogisticTTLService.ts | 物流TTL服务 | 未实现 |
|
||||
| LogisticTelemetryService | services/LogisticTelemetryService.ts | 物流遥测服务 | 未实现 |
|
||||
| LogisticsInsuranceService | services/LogisticsInsuranceService.ts | 物流保险服务 | 未实现 |
|
||||
| LogisticsIntelligenceService | services/LogisticsIntelligenceService.ts | 物流智能服务 | 未实现 |
|
||||
| LogisticsService | services/LogisticsService.ts | 物流服务 | 未实现 |
|
||||
| ManufacturingCoordinationService | services/ManufacturingCoordinationService.ts | 制造协调服务 | 未实现 |
|
||||
| MarketingCalendarService | services/MarketingCalendarService.ts | 营销日历服务 | 未实现 |
|
||||
| MarketingService | services/MarketingService.ts | 营销服务 | 未实现 |
|
||||
| MediaAssetService | services/MediaAssetService.ts | 媒体资产服务 | 已实现 |
|
||||
| MemberLevelService | services/MemberLevelService.ts | 会员等级服务 | 未实现 |
|
||||
| MerchantService | services/MerchantService.ts | 商家服务 | 未实现 |
|
||||
| MerchantProductOrderService | services/MerchantProductOrderService.ts | 多商户商品订单服务 | 已实现 |
|
||||
| MerchantSettlementService | services/MerchantSettlementService.ts | 多商户结算服务 | 已实现 |
|
||||
| MicroCreditService | services/MicroCreditService.ts | 小额信贷服务 | 未实现 |
|
||||
| MultiAssetSettlementService | services/MultiAssetSettlementService.ts | 多资产结算服务 | 未实现 |
|
||||
| MultiCurrencyFinanceService | services/MultiCurrencyFinanceService.ts | 多货币财务服务 | 未实现 |
|
||||
| NegotiationBotService | services/NegotiationBotService.ts | 谈判机器人服务 | 未实现 |
|
||||
| NodeGovernanceV2Service | services/NodeGovernanceV2Service.ts | 节点治理V2服务 | 未实现 |
|
||||
| OmniStockService | services/OmniStockService.ts | 全渠道库存服务 | 未实现 |
|
||||
| OrderProfitService | services/OrderProfitService.ts | 订单利润服务 | 未实现 |
|
||||
| OrderService | services/OrderService.ts | 订单服务 | 未实现 |
|
||||
| PRMonitorService | services/PRMonitorService.ts | PR监控服务 | 未实现 |
|
||||
| PackingOptimizer | services/PackingOptimizer.ts | 包装优化器 | 未实现 |
|
||||
| PathSimulatorService | services/PathSimulatorService.ts | 路径模拟器服务 | 未实现 |
|
||||
| PaymentRiskService | services/PaymentRiskService.ts | 支付风险服务 | 未实现 |
|
||||
| PaymentService | services/PaymentService.ts | 支付服务 | 未实现 |
|
||||
| PayoutAppealService | services/PayoutAppealService.ts | 支付上诉服务 | 未实现 |
|
||||
| PayoutService | services/PayoutService.ts | 支付服务 | 未实现 |
|
||||
| PersonalizedPricingService | services/PersonalizedPricingService.ts | 个性化定价服务 | 未实现 |
|
||||
| PersonalizedRecommendService | services/PersonalizedRecommendService.ts | 个性化推荐服务 | 未实现 |
|
||||
| PixelFeedbackService | services/PixelFeedbackService.ts | 像素反馈服务 | 未实现 |
|
||||
| PlatformApiService | services/PlatformApiService.ts | 平台API服务 | 未实现 |
|
||||
| PlatformFeeWatcher | services/PlatformFeeWatcher.ts | 平台费用监控 | 未实现 |
|
||||
| PnlSnapshotService | services/PnlSnapshotService.ts | PnL快照服务 | 未实现 |
|
||||
| PointsService | services/PointsService.ts | 积分服务 | 未实现 |
|
||||
| PoolSourcingService | services/PoolSourcingService.ts | 池采购服务 | 未实现 |
|
||||
| PredictiveFXService | services/PredictiveFXService.ts | 预测外汇服务 | 未实现 |
|
||||
| PredictiveHealthService | services/PredictiveHealthService.ts | 预测健康服务 | 未实现 |
|
||||
| PredictiveStagingService | services/PredictiveStagingService.ts | 预测登台服务 | 未实现 |
|
||||
| PricingAuditService | services/PricingAuditService.ts | 定价审计服务 | 未实现 |
|
||||
| PricingDecisionService | services/PricingDecisionService.ts | 定价决策服务 | 未实现 |
|
||||
| PricingService | services/PricingService.ts | 定价服务 | 未实现 |
|
||||
| PriorityTicketService | services/PriorityTicketService.ts | 优先票服务 | 未实现 |
|
||||
| ProcurementAuditService | services/ProcurementAuditService.ts | 采购审计服务 | 未实现 |
|
||||
| ProductHealthService | services/ProductHealthService.ts | 产品健康服务 | 未实现 |
|
||||
| ProductService | services/ProductService.ts | 产品服务 | 未实现 |
|
||||
| PublishService | services/PublishService.ts | 发布服务 | 未实现 |
|
||||
| QuotaCircuitBreakerService | services/QuotaCircuitBreakerService.ts | 配额熔断服务 | 未实现 |
|
||||
| RLCrawlerService | services/RLCrawlerService.ts | RL爬虫服务 | 未实现 |
|
||||
| ReasoningPipelineService | services/ReasoningPipelineService.ts | 推理管道服务 | 未实现 |
|
||||
| RedTeamingService | services/RedTeamingService.ts | 红队服务 | 未实现 |
|
||||
| RedisService | services/RedisService.ts | Redis服务 | 未实现 |
|
||||
| ReplenishmentService | services/ReplenishmentService.ts | 补货服务 | 未实现 |
|
||||
| ReportService | services/ReportService.ts | 报告服务 | 已实现 |
|
||||
| FinanceReconciliationService | services/FinanceReconciliationService.ts | 财务对账服务 | 已实现 |
|
||||
| FeatureActivationService | services/FeatureActivationService.ts | 功能激活服务 | 已实现 |
|
||||
| RBACService | services/RBACService.ts | 角色权限服务 | 已实现 |
|
||||
| BillingService | services/BillingService.ts | 账单服务 | 已实现 |
|
||||
| ReturnRateDatabaseService | services/ReturnRateDatabaseService.ts | 退货率数据库服务 | 未实现 |
|
||||
| ReturnRateMonitorService | services/ReturnRateMonitorService.ts | 退货率监控服务 | 未实现 |
|
||||
| ReviewService | services/ReviewService.ts | 评论服务 | 未实现 |
|
||||
| RiskAssessmentService | services/RiskAssessmentService.ts | 风险评估服务 | 未实现 |
|
||||
| RiskRadarService | services/RiskRadarService.ts | 风险雷达服务 | 未实现 |
|
||||
| SKUMappingService | services/SKUMappingService.ts | SKU映射服务 | 未实现 |
|
||||
| SLAScoringService | services/SLAScoringService.ts | SLA评分服务 | 未实现 |
|
||||
| SeaFreightAdvisor | services/SeaFreightAdvisor.ts | 海运顾问 | 未实现 |
|
||||
| SelfHealingService | services/SelfHealingService.ts | 自愈服务 | 未实现 |
|
||||
| SemanticLogService | services/SemanticLogService.ts | 语义日志服务 | 未实现 |
|
||||
| SensibleStockService | services/SensibleStockService.ts | 合理库存服务 | 未实现 |
|
||||
| SentimentAIService | services/SentimentAIService.ts | 情感AI服务 | 未实现 |
|
||||
| SlowMovingStockService | services/SlowMovingStockService.ts | 慢动库存服务 | 未实现 |
|
||||
| SocialTrendSourcingService | services/SocialTrendSourcingService.ts | 社会趋势采购服务 | 未实现 |
|
||||
| SovereignCreditPoolService | services/SovereignCreditPoolService.ts | 主权信用池服务 | 未实现 |
|
||||
| SovereignLedgerService | services/SovereignLedgerService.ts | 主权账本服务 | 未实现 |
|
||||
| SovereignLogisticsV2Service | services/SovereignLogisticsV2Service.ts | 主权物流V2服务 | 未实现 |
|
||||
| SovereignMediationService | services/SovereignMediationService.ts | 主权调解服务 | 未实现 |
|
||||
| SovereignReputationV2Service | services/SovereignReputationV2Service.ts | 主权声誉V2服务 | 未实现 |
|
||||
| SovereigntyGovernanceService | services/SovereigntyGovernanceService.ts | 主权治理服务 | 未实现 |
|
||||
| SovereigntyIdentityService | services/SovereigntyIdentityService.ts | 主权身份服务 | 未实现 |
|
||||
| SovereigntyReputationService | services/SovereigntyReputationService.ts | 主权声誉服务 | 未实现 |
|
||||
| SovereigntySettlementService | services/SovereigntySettlementService.ts | 主权结算服务 | 未实现 |
|
||||
| StockPlannerService | services/StockPlannerService.ts | 库存计划服务 | 未实现 |
|
||||
| StuckTrackingService | services/StuckTrackingService.ts | 卡住跟踪服务 | 未实现 |
|
||||
| StyleWarService | services/StyleWarService.ts | 风格战争服务 | 未实现 |
|
||||
| SupplierBlacklistService | services/SupplierBlacklistService.ts | 供应商黑名单服务 | 未实现 |
|
||||
| SupplierInquiryService | services/SupplierInquiryService.ts | 供应商询价服务 | 未实现 |
|
||||
| SupplierRiskRadar | services/SupplierRiskRadar.ts | 供应商风险雷达 | 未实现 |
|
||||
| SupplierRiskRadarService | services/SupplierRiskRadarService.ts | 供应商风险雷达服务 | 未实现 |
|
||||
| SupplierService | services/SupplierService.ts | 供应商服务 | 已实现 |
|
||||
| SupplyChainService | services/SupplyChainService.ts | 供应链服务 | 未实现 |
|
||||
| SyncService | services/SyncService.ts | 同步服务 | 未实现 |
|
||||
| TEEComputeService | services/TEEComputeService.ts | TEE计算服务 | 未实现 |
|
||||
| TaxBonusService | services/TaxBonusService.ts | 税收奖励服务 | 未实现 |
|
||||
| TaxComplianceService | services/TaxComplianceService.ts | 税收合规服务 | 未实现 |
|
||||
| TaxIncentivesService | services/TaxIncentivesService.ts | 税收激励服务 | 未实现 |
|
||||
| TaxReportService | services/TaxReportService.ts | 税收报告服务 | 未实现 |
|
||||
| TaxService | services/TaxService.ts | 税收服务 | 未实现 |
|
||||
| TraceService | services/TraceService.ts | 跟踪服务 | 未实现 |
|
||||
| TraceabilityService | services/TraceabilityService.ts | 溯源服务 | 未实现 |
|
||||
| TracingTopoService | services/TracingTopoService.ts | 跟踪拓扑服务 | 未实现 |
|
||||
| TrackingFraudDetector | services/TrackingFraudDetector.ts | 跟踪欺诈检测器 | 未实现 |
|
||||
| TradeService | services/TradeService.ts | 贸易服务 | 已实现 |
|
||||
| TrueROASService | services/TrueROASService.ts | 真实ROAS服务 | 未实现 |
|
||||
| TrustEvolutionService | services/TrustEvolutionService.ts | 信任演化服务 | 未实现 |
|
||||
| UnifiedTaskService | services/UnifiedTaskService.ts | 统一任务服务 | 未实现 |
|
||||
| UserAssetService | services/UserAssetService.ts | 用户资产服务 | 未实现 |
|
||||
| UserValueAnalysisService | services/UserValueAnalysisService.ts | 用户价值分析服务 | 未实现 |
|
||||
| VaultService | services/VaultService.ts | 保险库服务 | 未实现 |
|
||||
| VendorCreditService | services/VendorCreditService.ts | 供应商信用服务 | 未实现 |
|
||||
| VisionFactoryService | services/VisionFactoryService.ts | 视觉工厂服务 | 未实现 |
|
||||
| VisualSourcingService | services/VisualSourcingService.ts | 视觉采购服务 | 未实现 |
|
||||
| WMSAdvisor | services/WMSAdvisor.ts | WMS顾问 | 未实现 |
|
||||
| WarehouseService | services/WarehouseService.ts | 仓库服务 | 未实现 |
|
||||
| WebhookService | services/WebhookService.ts | Webhook服务 | 未实现 |
|
||||
| WorkerProfilerService | services/WorkerProfilerService.ts | 工作器分析服务 | 未实现 |
|
||||
| ZKPSovereignAdmissionService | services/ZKPSovereignAdmissionService.ts | ZKP主权准入服务 | 未实现 |
|
||||
|
||||
### 2.2 API控制器 (server/src/api/controllers/)
|
||||
|
||||
| 模块名称 | 路径 | 功能描述 | 状态 |
|
||||
|---------|------|---------|------|
|
||||
| AIController | api/controllers/AIController.ts | AI控制器 | 未实现 |
|
||||
| AdOpsController | api/controllers/AdOpsController.ts | 广告运营控制器 | 未实现 |
|
||||
| ArbitrageController | api/controllers/ArbitrageController.ts | 套利控制器 | 未实现 |
|
||||
| AuditController | api/controllers/AuditController.ts | 审计控制器 | 未实现 |
|
||||
| AuthController | api/controllers/AuthController.ts | 认证控制器 | 未实现 |
|
||||
| BillingController | api/controllers/BillingController.ts | 账单控制器 | 未实现 |
|
||||
| BizController | api/controllers/BizController.ts | 业务控制器 | 未实现 |
|
||||
| BizStrategyController | api/controllers/BizStrategyController.ts | 业务策略控制器 | 未实现 |
|
||||
| ChatBotController | api/controllers/ChatBotController.ts | 聊天机器人控制器 | 未实现 |
|
||||
| CommandCenterController | api/controllers/CommandCenterController.ts | 命令中心控制器 | 未实现 |
|
||||
| ConfigController | api/controllers/ConfigController.ts | 配置控制器 | 未实现 |
|
||||
| CreativeController | api/controllers/CreativeController.ts | 创意控制器 | 未实现 |
|
||||
| CustomerController | api/controllers/CustomerController.ts | 客户控制器 | 未实现 |
|
||||
| GovernanceController | api/controllers/GovernanceController.ts | 治理控制器 | 未实现 |
|
||||
| ImageRecognitionController | api/controllers/ImageRecognitionController.ts | 图像识别控制器 | 未实现 |
|
||||
| LiteConsoleController | api/controllers/LiteConsoleController.ts | 轻量级控制台控制器 | 未实现 |
|
||||
| NaturalLanguageProcessingController | api/controllers/NaturalLanguageProcessingController.ts | 自然语言处理控制器 | 未实现 |
|
||||
| NodeController | api/controllers/NodeController.ts | 节点控制器 | 未实现 |
|
||||
| OrderController | api/controllers/OrderController.ts | 订单控制器 | 未实现 |
|
||||
| PricingController | api/controllers/PricingController.ts | 定价控制器 | 未实现 |
|
||||
| ProductController | api/controllers/ProductController.ts | 产品控制器 | 未实现 |
|
||||
| PublishController | api/controllers/PublishController.ts | 发布控制器 | 未实现 |
|
||||
| RecommendationController | api/controllers/RecommendationController.ts | 推荐控制器 | 未实现 |
|
||||
| ReportController | api/controllers/ReportController.ts | 报告控制器 | 未实现 |
|
||||
| SettlementController | api/controllers/SettlementController.ts | 结算控制器 | 未实现 |
|
||||
| SyncController | api/controllers/SyncController.ts | 同步控制器 | 未实现 |
|
||||
| TelemetryController | api/controllers/TelemetryController.ts | 遥测控制器 | 未实现 |
|
||||
| TenantController | api/controllers/TenantController.ts | 租户控制器 | 未实现 |
|
||||
| TraceController | api/controllers/TraceController.ts | 跟踪控制器 | 未实现 |
|
||||
| VaultController | api/controllers/VaultController.ts | 保险库控制器 | 未实现 |
|
||||
| WebhookController | api/controllers/WebhookController.ts | Webhook控制器 | 未实现 |
|
||||
|
||||
### 2.3 API路由 (server/src/api/routes/)
|
||||
|
||||
| 模块名称 | 路径 | 功能描述 | 状态 |
|
||||
|---------|------|---------|------|
|
||||
| ai.ts | api/routes/ai.ts | AI路由 | 已实现（仅保留/chat端点） |
|
||||
| arbitrage.ts | api/routes/arbitrage.ts | 套利路由 | 未实现 |
|
||||
| audit.ts | api/routes/audit.ts | 审计路由 | 未实现 |
|
||||
| auth.ts | api/routes/auth.ts | 认证路由 | 未实现 |
|
||||
| billing.ts | api/routes/billing.ts | 账单路由 | 未实现 |
|
||||
| biz.ts | api/routes/biz.ts | 业务路由 | 未实现 |
|
||||
| chatbot.ts | api/routes/chatbot.ts | 聊天机器人路由 | 未实现 |
|
||||
| command.ts | api/routes/command.ts | 命令路由 | 未实现 |
|
||||
| config.ts | api/routes/config.ts | 配置路由 | 未实现 |
|
||||
| console_lite.ts | api/routes/console_lite.ts | 轻量级控制台路由 | 未实现 |
|
||||
| creative.ts | api/routes/creative.ts | 创意路由 | 未实现 |
|
||||
| customer.ts | api/routes/customer.ts | 客户路由 | 未实现 |
|
||||
| finance.ts | api/routes/finance.ts | 财务路由 | 未实现 |
|
||||
| governance.ts | api/routes/governance.ts | 治理路由 | 未实现 |
|
||||
| image-recognition.ts | api/routes/image-recognition.ts | 图像识别路由 | 未实现 |
|
||||
| marketing.ts | api/routes/marketing.ts | 营销路由 | 未实现 |
|
||||
| nlp.ts | api/routes/nlp.ts | 自然语言处理路由 | 未实现 |
|
||||
| node.ts | api/routes/node.ts | 节点路由 | 未实现 |
|
||||
| order.ts | api/routes/order.ts | 订单路由 | 未实现 |
|
||||
| product.ts | api/routes/product.ts | 产品路由 | 未实现 |
|
||||
| publish.ts | api/routes/publish.ts | 发布路由 | 未实现 |
|
||||
| recommendation.ts | api/routes/recommendation.ts | 推荐路由 | 未实现 |
|
||||
| report.ts | api/routes/report.ts | 报告路由 | 未实现 |
|
||||
| sovereignty.ts | api/routes/sovereignty.ts | 主权路由 | 未实现 |
|
||||
| strategy.ts | api/routes/strategy.ts | 策略路由 | 未实现 |
|
||||
| sync.ts | api/routes/sync.ts | 同步路由 | 未实现 |
|
||||
| telemetry.ts | api/routes/telemetry.ts | 遥测路由 | 未实现 |
|
||||
| tenant.ts | api/routes/tenant.ts | 租户路由 | 未实现 |
|
||||
| trace.ts | api/routes/trace.ts | 跟踪路由 | 未实现 |
|
||||
| trade.ts | api/routes/trade.ts | 贸易路由 | 未实现 |
|
||||
| vault.ts | api/routes/vault.ts | 保险库路由 | 未实现 |
|
||||
| webhook.ts | api/routes/webhook.ts | Webhook路由 | 未实现 |
|
||||
|
||||
### 2.4 核心模块 (server/src/core/)
|
||||
|
||||
| 模块名称 | 路径 | 功能描述 | 状态 |
|
||||
|---------|------|---------|------|
|
||||
| AINativeCommerceService | core/ai/AINativeCommerceService.ts | AI原生商务服务 | 未实现 |
|
||||
| ChatBotService | core/ai/ChatBotService.ts | 聊天机器人服务 | 未实现 |
|
||||
| DecisionExplainabilityEngine | core/ai/DecisionExplainabilityEngine.ts | 决策可解释性引擎 | 未实现 |
|
||||
| DynamicPricingAGIService | core/ai/DynamicPricingAGIService.ts | 动态定价AGI服务 | 未实现 |
|
||||
| FingerprintEngine | core/ai/FingerprintEngine.ts | 指纹引擎 | 未实现 |
|
||||
| ImageRecognitionService | core/ai/ImageRecognitionService.ts | 图像识别服务 | 未实现 |
|
||||
| NaturalLanguageProcessingService | core/ai/NaturalLanguageProcessingService.ts | 自然语言处理服务 | 未实现 |
|
||||
| RecommendationService | core/ai/RecommendationService.ts | 推荐服务 | 未实现 |
|
||||
| RBACEngine | core/auth/RBACEngine.ts | RBAC引擎 | 未实现 |
|
||||
| BusinessFunnelService | core/biz/BusinessFunnelService.ts | 业务漏斗服务 | 未实现 |
|
||||
| EarlyStageBizService | core/biz/EarlyStageBizService.ts | 早期业务服务 | 未实现 |
|
||||
| OnboardingService | core/biz/OnboardingService.ts | 入职服务 | 未实现 |
|
||||
| TOCService | core/biz/TOCService.ts | TOC服务 | 未实现 |
|
||||
| RedisService | core/cache/RedisService.ts | Redis服务 | 未实现 |
|
||||
| AliExpressConnector | core/connectors/AliExpressConnector.ts | 阿里Express连接器 | 未实现 |
|
||||
| AmazonConnector | core/connectors/AmazonConnector.ts | 亚马逊连接器 | 未实现 |
|
||||
| IPlatformConnector | core/connectors/IPlatformConnector.ts | 平台连接器接口 | 未实现 |
|
||||
| ShopeeConnector | core/connectors/ShopeeConnector.ts | Shopee连接器 | 未实现 |
|
||||
| ShopifyConnector | core/connectors/ShopifyConnector.ts | Shopify连接器 | 未实现 |
|
||||
| TikTokConnector | core/connectors/TikTokConnector.ts | TikTok连接器 | 未实现 |
|
||||
| DistributedLockDecorator | core/decorators/DistributedLockDecorator.ts | 分布式锁装饰器 | 未实现 |
|
||||
| CoreEngineService | core/engine/CoreEngineService.ts | 核心引擎服务 | 未实现 |
|
||||
| RuleEngineService | core/engine/RuleEngineService.ts | 规则引擎服务 | 未实现 |
|
||||
| WorkflowEngineService | core/engine/WorkflowEngineService.ts | 工作流引擎服务 | 未实现 |
|
||||
| TurboGateway | core/gateway/TurboGateway.ts | Turbo网关 | 未实现 |
|
||||
| AIGovernanceService | core/governance/standards/AIGovernanceService.ts | AI治理服务 | 未实现 |
|
||||
| BehavioralRiskService | core/governance/BehavioralRiskService.ts | 行为风险服务 | 未实现 |
|
||||
| DataComplianceService | core/governance/DataComplianceService.ts | 数据合规服务 | 未实现 |
|
||||
| FeatureGovernanceService | core/governance/FeatureGovernanceService.ts | 功能治理服务 | 未实现 |
|
||||
| FeatureToggleService | core/governance/FeatureToggleService.ts | 功能切换服务 | 未实现 |
|
||||
| GuardrailService | core/governance/GuardrailService.ts | 护栏服务 | 未实现 |
|
||||
| QuotaCircuitBreakerService | core/governance/QuotaCircuitBreakerService.ts | 配额熔断服务 | 未实现 |
|
||||
| QuotaGovernanceService | core/governance/QuotaGovernanceService.ts | 配额治理服务 | 未实现 |
|
||||
| RedTeamingService | core/governance/RedTeamingService.ts | 红队服务 | 未实现 |
|
||||
| S3QuotaManager | core/governance/S3QuotaManager.ts | S3配额管理器 | 未实现 |
|
||||
| ShadowAuditService | core/governance/ShadowAuditService.ts | 影子审计服务 | 未实现 |
|
||||
| FraudDetectionService | core/graph/FraudDetectionService.ts | 欺诈检测服务 | 未实现 |
|
||||
| mtls.guard.ts | core/guards/mtls.guard.ts | mTLS守卫 | 未实现 |
|
||||
| rbac.guard.ts | core/guards/rbac.guard.ts | RBAC守卫 | 未实现 |
|
||||
| sla.guard.ts | core/guards/sla.guard.ts | SLA守卫 | 未实现 |
|
||||
| state-transition.guard.ts | core/guards/state-transition.guard.ts | 状态转换守卫 | 未实现 |
|
||||
| trace-context.guard.ts | core/guards/trace-context.guard.ts | 跟踪上下文守卫 | 未实现 |
|
||||
| WebhookService | core/integrations/WebhookService.ts | Webhook服务 | 未实现 |
|
||||
| ShopIsolationService | core/isolation/ShopIsolationService.ts | 店铺隔离服务 | 未实现 |
|
||||
| DIDHandshakeService | core/network/DIDHandshakeService.ts | DID握手服务 | 已实现 |
|
||||
| FederatedNodeService | core/network/FederatedNodeService.ts | 联邦节点服务 | 未实现 |
|
||||
| P2PConnectionService | core/network/P2PConnectionService.ts | P2P连接服务 | 未实现 |
|
||||
| PrivateInventorySyncService | core/network/PrivateInventorySyncService.ts | 私有库存同步服务 | 未实现 |
|
||||
| DomainEventBus | core/runtime/DomainEventBus.ts | 域事件总线 | 已实现 |
|
||||
| DomainBootstrap | core/runtime/DomainBootstrap.ts | 域引导 | 已实现 |
|
||||
|
||||
### 2.5 工作器 (server/src/workers/)
|
||||
|
||||
| 模块名称 | 路径 | 功能描述 | 状态 |
|
||||
|---------|------|---------|------|
|
||||
| CrawlerWorker | workers/CrawlerWorker.ts | 爬虫工作器 | 已实现 |
|
||||
|
||||
## 3. 前端模块清单
|
||||
|
||||
### 3.1 浏览器扩展 (extension/src/)
|
||||
|
||||
| 模块名称 | 路径 | 功能描述 | 状态 |
|
||||
|---------|------|---------|------|
|
||||
| ABTestOptimizationService | extension/src/background/ABTestOptimizationService.ts | A/B测试优化服务 | 未实现 |
|
||||
| ABTestStrategyService | extension/src/background/ABTestStrategyService.ts | A/B测试策略服务 | 未实现 |
|
||||
| AutoShipService | extension/src/background/AutoShipService.ts | 自动发货服务 | 未实现 |
|
||||
| DOMParser | extension/src/background/DOMParser.ts | DOM解析器 | 未实现 |
|
||||
| FingerprintManager | extension/src/background/FingerprintManager.ts | 指纹管理器 | 未实现 |
|
||||
| LogisticsSyncService | extension/src/background/LogisticsSyncService.ts | 物流同步服务 | 未实现 |
|
||||
| MessageHandler | extension/src/background/MessageHandler.ts | 消息处理器 | 未实现 |
|
||||
| OrderCollector | extension/src/background/OrderCollector.ts | 订单收集器 | 未实现 |
|
||||
| RefundQuery | extension/src/background/RefundQuery.ts | 退款查询 | 未实现 |
|
||||
| ReturnSync | extension/src/background/ReturnSync.ts | 退货同步 | 未实现 |
|
||||
| index.ts | extension/src/background/index.ts | 后台入口 | 未实现 |
|
||||
| services.ts | extension/src/background/services.ts | 后台服务 | 未实现 |
|
||||
| index.ts | extension/src/content/index.ts | 内容脚本 | 未实现 |
|
||||
| index.ts | extension/src/platforms/index.ts | 平台集成 | 未实现 |
|
||||
| Logger | extension/src/utils/Logger.ts | 日志工具 | 未实现 |
|
||||
| index.ts | extension/src/utils/index.ts | 工具入口 | 未实现 |
|
||||
|
||||
### 3.2 仪表板 (dashboard/src/pages/)
|
||||
|
||||
| 模块名称 | 路径 | 功能描述 | 状态 |
|
||||
|---------|------|---------|------|
|
||||
| ABTest | dashboard/src/pages/ABTest/ | A/B测试页面 | 未实现 |
|
||||
| Ad | dashboard/src/pages/Ad/ | 广告页面 | 未实现 |
|
||||
| AfterSales | dashboard/src/pages/AfterSales/ | 售后服务页面 | 未实现 |
|
||||
| Auth | dashboard/src/pages/Auth/ | 认证页面 | 未实现 |
|
||||
| B2B | dashboard/src/pages/B2B/ | B2B页面 | 未实现 |
|
||||
| B2BTrade | dashboard/src/pages/B2BTrade/ | B2B贸易页面 | 未实现 |
|
||||
| Compliance | dashboard/src/pages/Compliance/ | 合规页面 | 未实现 |
|
||||
| Logistics | dashboard/src/pages/Logistics/ | 物流页面 | 未实现 |
|
||||
| Orders | dashboard/src/pages/Orders/ | 订单页面 | 未实现 |
|
||||
| Product | dashboard/src/pages/Product/ | 产品页面 | 未实现 |
|
||||
| UserAsset | dashboard/src/pages/UserAsset/ | 用户资产页面 | 未实现 |
|
||||
|
||||
## 4. 文档结构
|
||||
|
||||
| 模块名称 | 路径 | 功能描述 | 状态 |
|
||||
|---------|------|---------|------|
|
||||
| Business_Blueprint.md | docs/00_Business/Business_Blueprint.md | 业务蓝图 | 未实现 |
|
||||
| Business_ClosedLoops.md | docs/00_Business/Business_ClosedLoops.md | 业务闭环 | 未实现 |
|
||||
| Business_ClosedLoops_Analysis.md | docs/00_Business/Business_ClosedLoops_Analysis.md | 业务闭环分析 | 未实现 |
|
||||
| Governance_Standards.md | docs/00_Business/Governance_Standards.md | 治理标准 | 未实现 |
|
||||
| Task_Overview.md | docs/00_Business/Task_Overview.md | 任务概览 | 已实现 |
|
||||
| Module_Blueprints.md | docs/01_Architecture/Module_Blueprints.md | 模块蓝图 | 未实现 |
|
||||
| System_Architecture.md | docs/01_Architecture/System_Architecture.md | 系统架构 | 未实现 |
|
||||
| Data_API_Specs.md | docs/02_Backend/API_Specs/Data_API_Specs.md | 数据API规范 | 未实现 |
|
||||
| Finance_API.md | docs/02_Backend/API_Specs/Finance_API.md | 财务API | 未实现 |
|
||||
| Order_API.md | docs/02_Backend/API_Specs/Order_API.md | 订单API | 未实现 |
|
||||
| Product_API.md | docs/02_Backend/API_Specs/Product_API.md | 产品API | 未实现 |
|
||||
| Backend_Design.md | docs/02_Backend/Backend_Design.md | 后端设计 | 未实现 |
|
||||
| Frontend_Design.md | docs/03_Frontend/Frontend_Design.md | 前端设计 | 未实现 |
|
||||
| Pages_Flow.md | docs/03_Frontend/Pages_Flow.md | 页面流程 | 未实现 |
|
||||
| UI_Components.md | docs/03_Frontend/UI_Components.md | UI组件 | 未实现 |
|
||||
| DOM_Interaction.md | docs/04_Plugin/DOM_Interaction.md | DOM交互 | 未实现 |
|
||||
| Plugin_Design.md | docs/04_Plugin/Plugin_Design.md | 插件设计 | 未实现 |
|
||||
| AI_Module_List.md | docs/05_AI/AI_Module_List.md | AI模块列表 | 已实现 |
|
||||
| AI_Strategy.md | docs/05_AI/AI_Strategy.md | AI策略 | 未实现 |
|
||||
| Quality_Optimization.md | docs/07_Testing/Quality_Optimization.md | 质量优化 | 未实现 |
|
||||
| DOC_INDEX.md | docs/10_Documents_Global/DOC_INDEX.md | 文档索引 | 未实现 |
|
||||
| PROJECT_MAP.md | docs/10_Documents_Global/PROJECT_MAP.md | 项目地图 | 未实现 |
|
||||
|
||||
## 5. 模块状态分析
|
||||
|
||||
### 5.1 已实现模块
|
||||
|
||||
| 模块类型 | 模块名称 | 路径 |
|
||||
|---------|---------|------|
|
||||
| 后端服务 | BusinessModelEvolutionService | services/BusinessModelEvolutionService.ts |
|
||||
| 后端服务 | CashflowForecastService | services/CashflowForecastService.ts |
|
||||
| 后端服务 | DeployService | services/DeployService.ts |
|
||||
| 后端服务 | DisputeResolverService | services/DisputeResolverService.ts |
|
||||
| 后端服务 | DynamicPricingService | services/DynamicPricingService.ts |
|
||||
| 后端服务 | SupplierService | services/SupplierService.ts |
|
||||
| 后端服务 | TradeService | services/TradeService.ts |
|
||||
| 后端服务 | InfluencerBotService | services/InfluencerBotService.ts |
|
||||
| 后端服务 | InventoryAgingService | services/InventoryAgingService.ts |
|
||||
| 后端服务 | MediaAssetService | services/MediaAssetService.ts |
|
||||
| 后端服务 | FinanceReconciliationService | services/FinanceReconciliationService.ts |
|
||||
| 后端服务 | ReportService | services/ReportService.ts |
|
||||
| 后端服务 | RBACService | services/RBACService.ts |
|
||||
| 后端服务 | FeatureActivationService | services/FeatureActivationService.ts |
|
||||
| 后端服务 | MerchantSettlementService | services/MerchantSettlementService.ts |
|
||||
| 后端服务 | MerchantProductOrderService | services/MerchantProductOrderService.ts |
|
||||
| 后端服务 | BillingService | services/BillingService.ts |
|
||||
| 核心模块 | DIDHandshakeService | core/network/DIDHandshakeService.ts |
|
||||
| 核心模块 | DomainEventBus | core/runtime/DomainEventBus.ts |
|
||||
| 核心模块 | DomainBootstrap | core/runtime/DomainBootstrap.ts |
|
||||
| 工作器 | CrawlerWorker | workers/CrawlerWorker.ts |
|
||||
| API路由 | ai.ts | api/routes/ai.ts |
|
||||
| 文档 | Task_Overview.md | docs/00_Business/Task_Overview.md |
|
||||
| 文档 | AI_Module_List.md | docs/05_AI/AI_Module_List.md |
|
||||
| 文档 | Module_Inventory.md | docs/Module_Inventory.md |
|
||||
|
||||
### 5.2 抽象/过时模块清理记录
|
||||
|
||||
已清理以下抽象或过时的模块：
|
||||
|
||||
#### AI路由清理
|
||||
- 已删除40个未实现的AI端点，仅保留 `/ai/chat` 端点
|
||||
- 清理的抽象功能包括：
|
||||
- 联邦学习指标 (getFederatedMetrics)
|
||||
- AI决策逻辑链 (getDecisionLogicChain, getDecisionNarrative, streamNarrative)
|
||||
- 情感分析与风格对齐 (analyzeSentiment, alignStyle)
|
||||
- 视频处理 (processVideo)
|
||||
- 语义漂移检测 (detectSemanticDrift)
|
||||
- 安全相关 (scanPrompt, runTEEProtectedTask, initiateDIDHandshake, toggleKillSwitch)
|
||||
- AGI自我进化 (triggerSelfEvolution, checkQuota, getCounterpartyProfile)
|
||||
- 采购联盟 (joinSourcingAlliance)
|
||||
- 碳信用 (issueCarbonCredit)
|
||||
- 危机检测 (detectCrisis)
|
||||
- 跨主权资源 (publishResource, findOptimalResource)
|
||||
- 算力池 (getComputePoolStatus, scheduleComputeJob)
|
||||
- 数据湖优化 (optimizeDataLake, migrateColdData)
|
||||
|
||||
### 5.3 未实现模块
|
||||
|
||||
项目中大部分模块尚未实现，包括：
|
||||
- 大部分后端服务（约180+个）
|
||||
- 所有API控制器
|
||||
- 大部分API路由
|
||||
- 大部分核心模块
|
||||
- 所有前端扩展模块
|
||||
- 所有仪表板页面
|
||||
- 大部分文档
|
||||
|
||||
### 5.4 模块实现率
|
||||
|
||||
| 模块类型 | 总数 | 已实现 | 实现率 |
|
||||
|---------|------|--------|--------|
|
||||
| 后端服务 | 197 | 17 | 8.63% |
|
||||
| API控制器 | 30 | 0 | 0% |
|
||||
| API路由 | 32 | 1 | 3.13% |
|
||||
| 核心模块 | 50 | 3 | 6% |
|
||||
| 工作器 | 1 | 1 | 100% |
|
||||
| 前端扩展 | 12 | 0 | 0% |
|
||||
| 仪表板页面 | 11 | 0 | 0% |
|
||||
| 文档 | 22 | 4 | 18.18% |
|
||||
| **总计** | **325** | **26** | **7.94%** |
|
||||
|
||||
> 注：AI路由已从原来的50+个端点清理为1个有效端点，移除了40个抽象/未实现的端点
|
||||
|
||||
## 6. 模块清理建议
|
||||
|
||||
### 6.1 过时或抽象模块识别
|
||||
|
||||
根据项目结构和代码分析，以下类型的模块可能被视为过时或抽象：
|
||||
|
||||
**真正的抽象/空壳模块：**
|
||||
1. **只有接口定义** - `export interface xxx` 或 `export type xxx`，没有 class 实现
|
||||
2. **方法体为空** - 只有方法签名，没有实际业务逻辑
|
||||
3. **只有 TODO 注释** - 没有实际代码实现
|
||||
|
||||
**注意：以下不算抽象，它们有完整业务逻辑实现：**
|
||||
- ✅ 有 `static async` 方法实现
|
||||
- ✅ 有数据库操作（db.insert, db.select 等）
|
||||
- ✅ 有业务逻辑计算
|
||||
- ✅ 有完整的 if/else 流程
|
||||
|
||||
**其他需要清理的类型：**
|
||||
4. **重复功能**：多个模块提供相似功能
|
||||
5. **未使用模块**：在代码中没有被引用的模块
|
||||
6. **技术债务**：使用过时技术或架构的模块
|
||||
|
||||
### 6.2 清理建议
|
||||
|
||||
| 清理类型 | 建议操作 | 理由 |
|
||||
|---------|---------|------|
|
||||
| 抽象服务 | 暂时保留，作为未来实现的基础 | 虽然抽象，但提供了良好的接口定义 |
|
||||
| 重复功能 | 合并相似模块，保留功能最完整的 | 减少代码冗余，提高维护性 |
|
||||
| 未使用模块 | 标记为待实现或移除 | 减少项目复杂度，提高构建速度 |
|
||||
| 技术债务 | 重构或重写 | 提高代码质量和性能 |
|
||||
|
||||
### 6.3 具体清理建议
|
||||
|
||||
1. **AI相关模块**：大部分AI模块尚未实现，建议先实现核心功能，再扩展其他模块
|
||||
2. **前端扩展**：根据实际需求优先实现核心功能，如订单收集和物流同步
|
||||
3. **仪表板页面**：优先实现常用页面，如订单管理和产品管理
|
||||
4. **后端服务**：优先实现业务核心服务，如订单、支付、物流等
|
||||
|
||||
## 7. 业务闭环分类与实现状态
|
||||
|
||||
### 7.1 业务闭环清单（共37个）
|
||||
|
||||
| 序号 | 闭环名称 | 对应服务 | 代码实现状态 |
|
||||
|------|---------|---------|-------------|
|
||||
| 1 | 数据采集与清洗 | PlatformApiService, RLCrawlerService | ⚠️ 部分实现 |
|
||||
| 2 | 商品刊登 | ProductService, PublishService | ⚠️ 部分实现 |
|
||||
| 3 | 素材管理 | ImageFingerprintService | ❌ 未实现 |
|
||||
| 4 | 广告计划与营销 | AdPlanService, AdOptimizationService | ⚠️ 部分实现 |
|
||||
| 5 | 订单履约 | OrderService, LogisticsService | ⚠️ 部分实现 |
|
||||
| 6 | 售后逆向 | AfterSalesService, ReturnRateMonitorService | ⚠️ 部分实现 |
|
||||
| 7 | 资金对账 | FinanceService, MultiCurrencyFinanceService | ❌ 未实现 |
|
||||
| 8 | 库存与仓储 | InventoryService, WarehouseService | ⚠️ 部分实现 |
|
||||
| 9 | 供应链与供应商 | SupplierService, SupplyChainService | ✅ 已实现 |
|
||||
| 10 | B2B/TOB贸易 | B2BTradeService, TradeService | ✅ 已实现 |
|
||||
| 11 | 治理与审批 | GovernanceController, QuotaCircuitBreakerService | ⚠️ 部分实现 |
|
||||
| 12 | 合规与证书 | ComplianceCheckService, CertificateService | ⚠️ 部分实现 |
|
||||
| 13 | 合规与风控 | RiskAssessmentService, BehavioralRiskService | ⚠️ 部分实现 |
|
||||
| 14 | 报表与分析 | ReportService, AnalyticsService | ❌ 未实现 |
|
||||
| 15 | 定价与利润决策 | PricingService, DynamicPricingService | ✅ 已实现 |
|
||||
| 16 | 账号/店铺健康度 | ProductHealthService, ChannelStatusService | ⚠️ 部分实现 |
|
||||
| 17 | 店铺隔离与自动化 | ShopIsolationService, AutoDiagnosticsService | ⚠️ 部分实现 |
|
||||
| 18 | 订单集中管理 | OrderService | ⚠️ 部分实现 |
|
||||
| 19 | 客户/商家押金与账户 | UserAssetService, MemberLevelService | ⚠️ 部分实现 |
|
||||
| 20 | 商家选择发货 | MerchantService | ⚠️ 部分实现 |
|
||||
| 21 | 回款与财务 | PaymentService, PayoutService | ⚠️ 部分实现 |
|
||||
| 22 | 海外仓/本土仓 | BondedWarehouseService, WarehouseService | ⚠️ 部分实现 |
|
||||
| 23 | 商品主数据 | ProductService, SKUMappingService | ⚠️ 部分实现 |
|
||||
| 24 | SKU变体与结构 | SKUMappingService | ⚠️ 部分实现 |
|
||||
| 25 | 订单拆分与合并 | OrderService | ⚠️ 部分实现 |
|
||||
| 26 | 异常订单处理 | OrderService, ExceptionAutoFixService | ⚠️ 部分实现 |
|
||||
| 27 | 物流策略与渠道 | LogisticsService, DynamicShippingService | ⚠️ 部分实现 |
|
||||
| 28 | 利润核算 | OrderProfitService, PricingAuditService | ⚠️ 部分实现 |
|
||||
| 29 | 用户/客户资产 | UserAssetService, PointsService | ⚠️ 部分实现 |
|
||||
| 30 | A/B测试与策略优化 | ABTestService, ABTestAnalysisService | ⚠️ 部分实现 |
|
||||
| 31 | 多商户入驻与认证 | MerchantService, AuthService | ⚠️ 部分实现 |
|
||||
| 32 | 功能模块化与权限 | RBACEngine, FeatureToggleService | ❌ 未实现 |
|
||||
| 33 | 功能开通与支付 | PaymentService, PointsService | ❌ 未实现 |
|
||||
| 34 | 多商户结算与财务 | SettlementController, MultiAssetSettlementService | ❌ 未实现 |
|
||||
| 35 | 多商户商品与订单 | ProductService, OrderService | ❌ 未实现 |
|
||||
| 36 | 恶意买家黑名单 | BlacklistService, BlacklistDatabaseService | ⚠️ 部分实现 |
|
||||
| 37 | 高退货率SKU自动下架 | AutoDelistService, ReturnRateMonitorService | ⚠️ 部分实现 |
|
||||
|
||||
### 7.2 业务闭环实现状态统计
|
||||
|
||||
| 状态 | 数量 | 说明 |
|
||||
|------|------|------|
|
||||
| ✅ 已实现 | 3 | 有完整业务逻辑实现 |
|
||||
| ⚠️ 部分实现 | 25 | 有基础方法但未完全闭环 |
|
||||
| ❌ 未实现 | 9 | 只有接口定义或空壳 |
|
||||
|
||||
### 7.3 相对抽象的业务闭环（建议优先实现）
|
||||
|
||||
以下业务闭环在代码中没有对应的实现或只有空壳，建议优先实现：
|
||||
|
||||
| 闭环名称 | 原因 | 建议实现优先级 |
|
||||
|---------|------|---------------|
|
||||
| 素材管理 | 无对应服务实现 | P1 - 高 |
|
||||
| 资金对账 | 无完整服务实现 | P1 - 高 |
|
||||
| 报表与分析 | ReportService 为空壳 | P1 - 高 |
|
||||
| 功能模块化与权限 | RBACEngine 未实现 | P2 - 中 |
|
||||
| 功能开通与支付 | 无对应服务 | P2 - 中 |
|
||||
| 多商户结算与财务 | 无完整服务实现 | P3 - 低 |
|
||||
| 多商户商品与订单 | 无完整服务实现 | P3 - 低 |
|
||||
|
||||
### 7.4 实现建议
|
||||
|
||||
**优先级划分：**
|
||||
- **P1 (高)**：核心业务功能，影响整体流程
|
||||
- **P2 (中)**：重要功能，提升系统能力
|
||||
- **P3 (低)**：扩展功能，可后期实现
|
||||
|
||||
**具体实现建议：**
|
||||
|
||||
1. **P1 优先级**：
|
||||
- **素材管理**：实现 ImageFingerprintService，支持图片处理和素材库管理
|
||||
- **资金对账**：完善 FinanceService，实现多币种、VAT、汇率处理
|
||||
- **报表与分析**：实现 ReportService，提供数据可视化和 KPI 分析
|
||||
|
||||
2. **P2 优先级**：
|
||||
- **功能模块化与权限**：实现 RBACEngine，完善权限控制
|
||||
- **功能开通与支付**：实现 PaymentService，支持功能开通和支付流程
|
||||
|
||||
3. **P3 优先级**：
|
||||
- **多商户结算与财务**：实现 MultiAssetSettlementService
|
||||
- **多商户商品与订单**：完善 ProductService 和 OrderService 对多商户的支持
|
||||
|
||||
**实现顺序建议：**
|
||||
1. 供应链与供应商（已实现）→ 定价与利润决策（已实现）→ B2B/TOB贸易（已实现）
|
||||
2. 订单履约 → 库存与仓储 → 售后逆向
|
||||
3. 资金对账 → 报表与分析 → 素材管理
|
||||
4. 功能模块化与权限 → 多商户功能
|
||||
|
||||
**技术实现要点：**
|
||||
- 遵循项目规则，使用 `cf_` 表前缀
|
||||
- 实现 `initTable` 方法进行数据库初始化
|
||||
- 确保服务之间的依赖关系清晰
|
||||
- 遵循业务闭环的状态机设计
|
||||
|
||||
## 8. 总结
|
||||
|
||||
本项目是一个功能丰富的电商平台系统，包含多个模块和服务。目前实现率较低（约5%），大部分模块处于未实现状态。建议按照业务优先级逐步实现核心功能，同时保持代码结构的清晰和一致性。
|
||||
|
||||
通过本模块清单，可以清晰了解项目的整体结构和实现状态，为后续的开发和维护提供参考。
|
||||
519
docs/Runtime_Architecture.md
Normal file
519
docs/Runtime_Architecture.md
Normal file
@@ -0,0 +1,519 @@
|
||||
# 🌐 Runtime_Architecture.md（运行态架构 · 可落地版）
|
||||
|
||||
---
|
||||
|
||||
# 🎯 一、设计目标
|
||||
|
||||
> 将系统从“接口驱动”升级为“事件驱动 + 自动运行系统”，实现业务闭环自动推进、可计费、可监控。
|
||||
|
||||
---
|
||||
|
||||
# 🧠 二、核心设计原则
|
||||
|
||||
### 1️⃣ 事件驱动（Event Driven）
|
||||
|
||||
所有业务流转必须通过事件触发，而不是手动串流程
|
||||
|
||||
---
|
||||
|
||||
### 2️⃣ 状态驱动（State Driven）
|
||||
|
||||
所有实体必须由 STATE_MACHINE 控制流转
|
||||
|
||||
---
|
||||
|
||||
### 3️⃣ 服务编排（Service Orchestration）
|
||||
|
||||
所有业务逻辑必须在 Service 层执行
|
||||
|
||||
---
|
||||
|
||||
### 4️⃣ 自动化优先（Automation First）
|
||||
|
||||
能自动执行的流程，禁止依赖用户点击
|
||||
|
||||
---
|
||||
|
||||
### 5️⃣ 可计费（Billable by Design）
|
||||
|
||||
所有关键行为必须具备计费能力
|
||||
|
||||
---
|
||||
|
||||
# 🧩 三、Runtime 四大核心模块
|
||||
|
||||
---
|
||||
|
||||
## 1️⃣ Event System（事件系统）
|
||||
|
||||
### 🎯 作用
|
||||
|
||||
解耦模块，实现系统自动联动
|
||||
|
||||
---
|
||||
|
||||
### 📌 事件结构
|
||||
|
||||
```typescript
|
||||
interface DomainEvent {
|
||||
id: string
|
||||
type: string
|
||||
payload: any
|
||||
timestamp: number
|
||||
source: string
|
||||
merchantId?: string
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 📌 核心事件定义
|
||||
|
||||
```typescript
|
||||
// 商品
|
||||
PRODUCT_CREATED
|
||||
PRODUCT_UPDATED
|
||||
|
||||
// 订单
|
||||
ORDER_CREATED
|
||||
ORDER_PAID
|
||||
ORDER_COMPLETED
|
||||
|
||||
// 库存
|
||||
INVENTORY_LOW
|
||||
INVENTORY_UPDATED
|
||||
|
||||
// 功能
|
||||
FEATURE_ENABLED
|
||||
FEATURE_DISABLED
|
||||
|
||||
// AI
|
||||
AI_TASK_CREATED
|
||||
AI_TASK_COMPLETED
|
||||
|
||||
// 广告
|
||||
AD_STARTED
|
||||
AD_PERFORMANCE_UPDATED
|
||||
|
||||
// 任务
|
||||
JOB_CREATED
|
||||
JOB_UPDATED
|
||||
JOB_COMPLETED
|
||||
|
||||
// 计费
|
||||
BILLING_GENERATED
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 📌 事件流
|
||||
|
||||
```typescript
|
||||
Controller → Service → Emit Event → EventBus → Listener → Service
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 📌 示例
|
||||
|
||||
```typescript
|
||||
await productService.createProduct(data)
|
||||
|
||||
eventBus.emit({
|
||||
type: 'PRODUCT_CREATED',
|
||||
payload: { productId },
|
||||
source: 'ProductService',
|
||||
merchantId: data.merchantId
|
||||
})
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2️⃣ Job / Worker System（任务系统）
|
||||
|
||||
### 🎯 作用
|
||||
|
||||
执行异步任务 & 自动推进系统
|
||||
|
||||
---
|
||||
|
||||
### 📌 任务模型
|
||||
|
||||
```typescript
|
||||
interface Job {
|
||||
id: string
|
||||
type: string
|
||||
status: 'pending' | 'running' | 'success' | 'failed'
|
||||
payload: any
|
||||
result?: any
|
||||
retryCount: number
|
||||
merchantId?: string
|
||||
priority?: number
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 📌 核心任务类型
|
||||
|
||||
```typescript
|
||||
AI_OPTIMIZE_PRODUCT
|
||||
SYNC_INVENTORY
|
||||
RUN_ADS
|
||||
CALCULATE_PROFIT
|
||||
GENERATE_BILL
|
||||
UPDATE_AD_BUDGET
|
||||
STOP_AD
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 📌 执行流程
|
||||
|
||||
```typescript
|
||||
Event → 创建 Job → Worker 消费 → 调用 Service → 更新状态 → 触发新 Event
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 📌 示例
|
||||
|
||||
```typescript
|
||||
eventBus.on('PRODUCT_CREATED', async (event) => {
|
||||
await jobService.create({
|
||||
type: 'AI_OPTIMIZE_PRODUCT',
|
||||
payload: { productId: event.payload.productId },
|
||||
merchantId: event.merchantId
|
||||
})
|
||||
})
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3️⃣ Scheduler（调度系统）
|
||||
|
||||
### 🎯 作用
|
||||
|
||||
周期性驱动系统（无人值守）
|
||||
|
||||
---
|
||||
|
||||
### 📌 示例调度
|
||||
|
||||
```typescript
|
||||
// 每5分钟
|
||||
syncInventory()
|
||||
|
||||
// 每1小时
|
||||
calculateROI()
|
||||
|
||||
// 每天
|
||||
runSettlement()
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 📌 实现方式
|
||||
|
||||
```typescript
|
||||
node-cron / bullmq / agenda
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 📌 调度 → Job
|
||||
|
||||
```typescript
|
||||
cron.schedule('*/5 * * * *', async () => {
|
||||
await jobService.create({ type: 'SYNC_INVENTORY' })
|
||||
})
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4️⃣ State Engine（状态推进器）
|
||||
|
||||
### 🎯 作用
|
||||
|
||||
统一控制所有状态流转
|
||||
|
||||
---
|
||||
|
||||
### 📌 原则
|
||||
|
||||
❌ Service 随意改状态
|
||||
✅ 必须通过 State Machine
|
||||
|
||||
---
|
||||
|
||||
### 📌 示例
|
||||
|
||||
```typescript
|
||||
orderStateMachine.transition(order, 'PAY')
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 📌 自动推进
|
||||
|
||||
```typescript
|
||||
Worker → 调用 Service → 推动状态
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 💰 四、计费系统（Billing Runtime）
|
||||
|
||||
---
|
||||
|
||||
## 📊 1️⃣ 计费模型
|
||||
|
||||
```typescript
|
||||
FeatureBilling
|
||||
UsageBilling
|
||||
ResultBilling
|
||||
SubscriptionBilling
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📌 2️⃣ 使用量计费
|
||||
|
||||
```typescript
|
||||
UsageService.track({
|
||||
feature: 'AI_OPTIMIZE',
|
||||
usage: 1,
|
||||
merchantId,
|
||||
source: 'AI'
|
||||
})
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📌 3️⃣ 账单生成
|
||||
|
||||
```typescript
|
||||
BillingService.generateBill(merchantId)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📌 4️⃣ 收费触发点
|
||||
|
||||
| 行为 | 是否计费 |
|
||||
| --- | --- |
|
||||
| AI优化 | ✅ |
|
||||
| 广告投放 | ✅ |
|
||||
| 自动补货 | ✅ |
|
||||
| API调用 | ✅ |
|
||||
|
||||
---
|
||||
|
||||
# 🔄 五、完整运行链路（核心）
|
||||
|
||||
---
|
||||
|
||||
## 🎯 示例：商品自动赚钱闭环
|
||||
|
||||
```typescript
|
||||
用户创建商品
|
||||
→ PRODUCT_CREATED
|
||||
|
||||
→ 创建 Job（AI优化）
|
||||
→ AI_TASK_COMPLETED
|
||||
|
||||
→ 自动上架
|
||||
→ AD_STARTED
|
||||
|
||||
→ 产生订单
|
||||
→ ORDER_PAID
|
||||
|
||||
→ CALCULATE_PROFIT
|
||||
|
||||
→ GENERATE_BILL
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 🎯 六、前端 Runtime 对应设计（关键）
|
||||
|
||||
---
|
||||
|
||||
## 1️⃣ Task Center（必须做）
|
||||
|
||||
### 字段
|
||||
|
||||
```typescript
|
||||
任务名称
|
||||
状态（运行中/完成/失败）
|
||||
进度
|
||||
结果
|
||||
触发来源
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2️⃣ Event Log
|
||||
|
||||
```typescript
|
||||
时间
|
||||
事件类型
|
||||
来源
|
||||
结果
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3️⃣ Billing Timeline
|
||||
|
||||
```typescript
|
||||
时间
|
||||
费用类型
|
||||
金额
|
||||
来源功能
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4️⃣ ROI Dashboard（核心）
|
||||
|
||||
```typescript
|
||||
商品ID
|
||||
ROI
|
||||
点击数
|
||||
订单数
|
||||
成本
|
||||
收入
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 🧱 七、Service 分层强化（必须执行）
|
||||
|
||||
---
|
||||
|
||||
## ❗ 强制规则
|
||||
|
||||
```typescript
|
||||
Controller ❌ 不允许写逻辑
|
||||
Service ✅ 唯一逻辑入口
|
||||
Worker ✅ 调用 Service
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 🔐 八、运行安全设计
|
||||
|
||||
---
|
||||
|
||||
## 必须补
|
||||
|
||||
### 1️⃣ 幂等性
|
||||
|
||||
```typescript
|
||||
jobId: productId + type
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2️⃣ 重试机制
|
||||
|
||||
```typescript
|
||||
失败 → retry 3 次
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3️⃣ 日志系统
|
||||
|
||||
```typescript
|
||||
Event Log + Job Log + Error Log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 🚀 九、实施步骤
|
||||
|
||||
---
|
||||
|
||||
## 1️⃣ 新建模块
|
||||
|
||||
```bash
|
||||
/src/runtime
|
||||
├── eventBus.ts
|
||||
├── jobQueue.ts
|
||||
├── worker.ts
|
||||
├── scheduler.ts
|
||||
├── jobProcessor.ts
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2️⃣ 实现 BullMQ 分布式队列
|
||||
|
||||
```bash
|
||||
/src/runtime/queue
|
||||
├── index.ts
|
||||
├── worker.ts
|
||||
├── processor.ts
|
||||
├── priority.ts
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3️⃣ 实现 WebSocket 实时推送
|
||||
|
||||
```bash
|
||||
/src/runtime/ws
|
||||
├── server.ts
|
||||
├── client.ts
|
||||
├── broadcast.ts
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4️⃣ 实现计费系统
|
||||
|
||||
```bash
|
||||
/src/services
|
||||
├── UsageService.ts
|
||||
├── BillingService.ts
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5️⃣ 实现 AI 策略系统
|
||||
|
||||
```bash
|
||||
/src/runtime/strategy
|
||||
├── engine.ts
|
||||
├── roi.ts
|
||||
├── ad.ts
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6️⃣ 前端实现
|
||||
|
||||
```bash
|
||||
/pages/TaskCenter/index.tsx
|
||||
/pages/EventLog/index.tsx
|
||||
/pages/Billing/index.tsx
|
||||
/pages/ROIDashboard/index.tsx
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 🧠 最终结论
|
||||
|
||||
你现在系统的阶段是：
|
||||
|
||||
> ✅ 架构完成
|
||||
> ❗ Runtime 未建立
|
||||
|
||||
---
|
||||
|
||||
# 🔥 一句话
|
||||
|
||||
> **没有 Runtime，你的系统只是“能用”；
|
||||
> 有 Runtime，才是“能赚钱 + 能自动跑”的系统。**
|
||||
@@ -1,100 +1,146 @@
|
||||
我把“逻辑分散 → AI难维护”这个问题拆开，详细分析下原因、表现和影响，以及可行的解决思路。
|
||||
明白，你想要的是一个**多店铺、多商品、多订单的统一管理方案**，逻辑上类似商品管理，但增加了订单流、报表、跨站点维度。下面我给你整理一个完整的方案，包括数据模型、前端交互逻辑、后端架构，以及多店铺的管理方式。
|
||||
|
||||
---
|
||||
|
||||
## 1️⃣ 问题本质
|
||||
## 1️⃣ 数据模型设计
|
||||
|
||||
**逻辑分散**指的是业务逻辑没有集中在服务层，而散布在不同模块中，例如：
|
||||
### 1.1 核心实体
|
||||
|
||||
* **Controller 中写逻辑**：Controller 除了接收请求和返回响应，还处理业务决策、状态变化、数据校验。
|
||||
* **前端直接写逻辑**：复杂计算、权限判断、状态流转直接在 React 组件或页面中实现。
|
||||
* **数据库操作分散**：不同模块直接调用数据库，导致状态更新不统一。
|
||||
* **脚本或工具处理逻辑**：AI 任务或异步脚本单独处理业务逻辑，没有统一调用入口。
|
||||
| 实体 | 说明 | 核心字段 |
|
||||
| ----------------- | -------------------- | --------------------------------------------------------------------------------------- |
|
||||
| 店铺（Store） | 多店铺管理，包括我们的独立站、外部独立站 | store_id, store_name, store_type(自营/外部), credentials(登录信息/API Key) |
|
||||
| 商品（Product） | 商品信息，支持一店多商品 | product_id, store_id, sku, name, price, stock, status |
|
||||
| 订单（Order） | 订单信息 | order_id, store_id, product_id[], user_id, status, total_amount, created_at, updated_at |
|
||||
| 报表（Report） | 按店铺/时间/状态汇总 | report_id, store_id, type(销售/库存/ROI), period, data(JSON) |
|
||||
| 用户（User/Customer） | 买家信息 | user_id, name, contact, address |
|
||||
|
||||
### 1.2 关联逻辑
|
||||
|
||||
* 一店铺可以有多商品、多订单、多报表。
|
||||
* 商品与订单是多对多关系（一个订单可能包含多商品）。
|
||||
* 报表基于订单和商品计算。
|
||||
* 支持不同店铺类型（自营、外部独立站、亚马逊等）统一接口。
|
||||
|
||||
---
|
||||
|
||||
## 2️⃣ AI 维护难的原因
|
||||
## 2️⃣ 前端交互设计
|
||||
|
||||
AI 的核心优势是**理解和处理规则化逻辑**，逻辑分散导致 AI 难维护主要有以下几个原因：
|
||||
### 2.1 总览页（Dashboard）
|
||||
|
||||
1. **难以追踪业务流程**
|
||||
* **功能**：
|
||||
|
||||
* 业务步骤可能跨多个文件或模块，AI 无法一次性获取完整流程。
|
||||
* 例如，订单闭环：支付、库存锁定、订单创建、账单生成分别在不同文件处理，AI 需要先分析依赖关系，再理解流程。
|
||||
* 显示各店铺的销售总额、订单数、库存情况。
|
||||
* 过滤器：店铺类型、时间段、状态（待发货/已发货）。
|
||||
* 快速入口：进入某个店铺的商品管理或订单管理。
|
||||
|
||||
2. **状态流转不统一**
|
||||
### 2.2 店铺管理页
|
||||
|
||||
* 状态可能在多个地方更新，缺乏中心化状态管理。
|
||||
* AI 很难判断状态真实值和变化条件，导致任务调度或逻辑判断出错。
|
||||
* **列表视图**：展示店铺名称、类型、总订单数、总销售额。
|
||||
* **操作按钮**：
|
||||
|
||||
3. **重复逻辑**
|
||||
* 编辑店铺信息
|
||||
* 查看报表
|
||||
* 同步商品/订单
|
||||
* 添加/移除店铺
|
||||
|
||||
* 不同模块可能重复实现相同逻辑（如权限判断、价格计算）。
|
||||
* AI 难以判断哪个逻辑是“权威版本”，容易修改错地方。
|
||||
### 2.3 商品管理页（店铺内）
|
||||
|
||||
4. **难以保证一致性**
|
||||
* 逻辑类似你已有商品管理：
|
||||
|
||||
* 分散逻辑容易导致边缘情况处理不统一（例如异常、支付失败、库存不足）。
|
||||
* AI 在优化或修复逻辑时，可能漏掉某些分散的处理点。
|
||||
* 列表：SKU、名称、库存、价格、状态
|
||||
* 批量操作：上架/下架、修改价格、同步库存
|
||||
* 支持多店铺切换查看（切换store_id）
|
||||
|
||||
5. **代码依赖复杂**
|
||||
### 2.4 订单管理页
|
||||
|
||||
* 分散逻辑意味着调用链不清晰，AI 在修改或推理时必须解析跨文件依赖。
|
||||
* 对于大型多商户系统，这种复杂度呈指数级增长。
|
||||
* **列表视图**：
|
||||
|
||||
* 订单ID、用户、状态、金额、下单时间、店铺
|
||||
* **操作**：
|
||||
|
||||
* 查看订单详情
|
||||
* 修改订单状态（支付确认、发货、完成）
|
||||
* 批量处理（发货/取消）
|
||||
* 导出 CSV / 对接报表
|
||||
* **过滤器**：
|
||||
|
||||
* 店铺
|
||||
* 订单状态
|
||||
* 时间段
|
||||
* 商品 SKU
|
||||
|
||||
### 2.5 报表页
|
||||
|
||||
* 支持多维度：
|
||||
|
||||
* 店铺维度（单店/全部店铺）
|
||||
* 时间维度（日/周/月/季度）
|
||||
* 类型维度（销售额、订单量、库存、ROI）
|
||||
* 可导出 PDF / Excel / CSV
|
||||
* 可自定义图表
|
||||
|
||||
---
|
||||
|
||||
## 3️⃣ 典型表现
|
||||
## 3️⃣ 后端架构
|
||||
|
||||
* Controller 内部有大量 `if/else` + 异步调用
|
||||
* 前端页面直接处理业务规则（如价格、折扣、库存判断）
|
||||
* 数据库更新在多个 Service/Repository 之外被调用
|
||||
* AI 执行任务时，需要在不同模块中查找状态和规则
|
||||
### 3.1 接口设计（REST 或 GraphQL）
|
||||
|
||||
* **店铺接口**
|
||||
|
||||
* `GET /stores`：列表
|
||||
* `POST /store`：新增
|
||||
* `PUT /store/{id}`：更新
|
||||
* `DELETE /store/{id}`：删除
|
||||
* **商品接口**
|
||||
|
||||
* `GET /store/{id}/products`：获取商品
|
||||
* `POST /store/{id}/product`：新增商品
|
||||
* `PUT /product/{id}`：更新
|
||||
* `DELETE /product/{id}`：删除
|
||||
* **订单接口**
|
||||
|
||||
* `GET /store/{id}/orders`：获取订单列表
|
||||
* `GET /order/{id}`：订单详情
|
||||
* `PUT /order/{id}`：修改状态
|
||||
* `POST /order/batch-update`：批量操作
|
||||
* **报表接口**
|
||||
|
||||
* `GET /store/{id}/report?type=sales&period=month`：获取报表
|
||||
|
||||
### 3.2 数据同步逻辑
|
||||
|
||||
* 对接外部独立站或电商平台时，支持定时抓取或 API 同步：
|
||||
|
||||
* 商品库存、价格
|
||||
* 订单状态、物流信息
|
||||
* 使用队列（如 RabbitMQ / Kafka）处理异步同步任务，保证系统流畅。
|
||||
|
||||
### 3.3 多店铺隔离
|
||||
|
||||
* 数据库可选：
|
||||
|
||||
* **单库多表**：每个实体表里加 `store_id` 字段，统一管理。
|
||||
* **多库方案**：每个店铺单独数据库，跨店铺汇总需要 ETL。
|
||||
* 建议初期用单库多表，方便报表和操作统一。
|
||||
|
||||
---
|
||||
|
||||
## 4️⃣ 后果
|
||||
## 4️⃣ 交互逻辑总结
|
||||
|
||||
1. **维护成本高**
|
||||
```
|
||||
Dashboard
|
||||
└─ 店铺列表
|
||||
├─ 商品管理
|
||||
└─ 订单管理
|
||||
└─ 报表
|
||||
```
|
||||
|
||||
* AI 或开发者需要理解多个模块才能做一件改动。
|
||||
2. **修改容易出错**
|
||||
|
||||
* 改动一处可能引起其他模块逻辑不一致。
|
||||
3. **难以快速迭代**
|
||||
|
||||
* 新功能闭环难以接入，因为逻辑散落在各处。
|
||||
4. **收费闭环风险**
|
||||
|
||||
* 分散逻辑导致支付、权限、账单、状态不一致，直接影响收益。
|
||||
* 每一层都支持批量操作、过滤器、多店铺切换。
|
||||
* 报表基于订单和商品计算，保持实时性或每日更新。
|
||||
* 多店铺/多系统接口统一，后端做抽象层处理不同 API。
|
||||
|
||||
---
|
||||
|
||||
## 5️⃣ 解决策略
|
||||
如果你需要，我可以帮你画一张**完整的多店铺-多商品-多订单交互架构图**，把前端交互和后端逻辑、报表处理都可视化出来，这样团队开发时一目了然。
|
||||
|
||||
**核心原则：逻辑集中化 → 服务驱动**
|
||||
|
||||
1. **服务层集中业务逻辑**
|
||||
|
||||
* Controller 只负责请求/响应和权限校验。
|
||||
* Service 层负责业务闭环、状态流转和多模块协同。
|
||||
|
||||
2. **状态管理统一**
|
||||
|
||||
* 前端使用全局 Model 或状态管理库（Umi Model、Redux 等）。
|
||||
* 后端统一使用状态机或闭环处理状态。
|
||||
|
||||
3. **复用核心逻辑**
|
||||
|
||||
* 公共函数或工具库统一处理权限、价格、库存、账单等逻辑。
|
||||
* AI 只需调用 Service 接口，不直接处理业务逻辑。
|
||||
|
||||
4. **可视化业务流程**
|
||||
|
||||
* 使用流程图或状态机图记录完整闭环，让 AI 可快速理解流程。
|
||||
* 前端交互和后端服务逻辑保持一致。
|
||||
|
||||
---
|
||||
|
||||
💡 **总结一句话**：
|
||||
逻辑分散让 AI 无法一次性理解完整闭环，状态不一致，修改风险高；集中化逻辑到服务层 + 统一状态管理，AI 才能高效维护和迭代。
|
||||
你希望我帮你画吗？
|
||||
|
||||
Reference in New Issue
Block a user