feat: 实现Operation-Agent核心功能及电商平台适配器
refactor: 重构项目结构,分离server和dashboard代码 style: 统一代码风格,修复lint警告 test: 添加平台适配器工厂测试用例 ci: 更新CI/CD流程,增加语义验证和性能测试 docs: 添加语义中心文档,定义统一数据模型和状态机
This commit is contained in:
@@ -2,6 +2,60 @@
|
||||
|
||||
> **说明**:本闭环文档是战略层业务流程,关注"做什么、为什么做、顺序和决策点",为下层模块功能和系统实现提供指引。TOC(零售/前端)和 TOB(B2B贸易)共享通用模块,特有流程用 `businessType` 标记。共 **58个业务闭环**。
|
||||
|
||||
## 🧠 系统核心架构
|
||||
|
||||
### 系统层级
|
||||
```
|
||||
前端管理面板 → 后端服务 → Operation-Agent → 平台 Adapter → 外部平台
|
||||
↓ ↑
|
||||
←---------- 数据回传 -----------------
|
||||
```
|
||||
|
||||
### 核心组件
|
||||
|
||||
#### 1. 前端管理面板
|
||||
- **操作入口**:商品采集、上架/下架、调价、店铺管理
|
||||
- **状态展示**:实时操作状态、执行日志、截图回传
|
||||
- **多店铺管理**:统一面板展示,独立操作流程
|
||||
- **数据可视化**:销售报表、ROI分析、库存监控
|
||||
|
||||
#### 2. 后端服务
|
||||
- **数据存储**:统一接收Operation-Agent回传数据
|
||||
- **业务逻辑**:服务编排、状态管理、权限控制
|
||||
- **AI策略**:定价策略、选品推荐、套利分析
|
||||
- **报表系统**:多维度数据分析、导出功能
|
||||
|
||||
#### 3. SystemOrchestrator(系统大脑)
|
||||
- **全局决策**:资源分配、任务优先级、风险控制
|
||||
- **信号层**:接收店铺、商品、财务、风控等指标
|
||||
- **决策层**:多目标优化,生成Action建议
|
||||
- **执行层**:通过TaskGraph执行决策
|
||||
- **反馈层**:收集执行结果,优化决策模型
|
||||
|
||||
#### 4. TaskGraph(任务依赖引擎)
|
||||
- **DAG(有向无环图)**:任务依赖关系管理
|
||||
- **自动执行**:选品 → 定价 → 上架 → 广告 → 监控
|
||||
- **状态管理**:pending → waiting_approval → ready → running → success/failed
|
||||
- **失败重试**:异常处理、指数退避
|
||||
|
||||
#### 5. Operation-Agent(操作代理)
|
||||
- **轻量化守护进程**:运行在VPS/客户端
|
||||
- **核心操作**:采集、上架、调价、数据回传
|
||||
- **平台适配**:模块化Adapter,支持多平台(Amazon、Shopee、AliExpress、eBay、TikTok Shop等)
|
||||
- **监控能力**:关键位置截图、状态心跳
|
||||
- **安全边界**:只执行业务操作,禁止系统级操作
|
||||
- **绑定流程**:选择平台 → 提交认证信息 → 平台授权 → 店铺信息同步 → 校验与状态更新 → 测试同步
|
||||
- **支持平台**:
|
||||
- 全球性平台:Amazon、eBay、AliExpress、Shopee、Lazada、Wish、Shein、JD Worldwide、Walmart Marketplace
|
||||
- 社交与直营平台:TikTok Shop、Etsy、Target Plus、Newegg
|
||||
- 区域性平台:Cdiscount(法国)、Allegro(波兰)、Otto(德国)、Rakuten(日本)、Qoo10(新加坡/日本/韩国)
|
||||
|
||||
#### 6. 平台Adapter
|
||||
- **模块化设计**:每个平台独立实现
|
||||
- **操作封装**:模拟浏览器或调用API
|
||||
- **数据标准化**:统一输出格式,便于后端处理
|
||||
- **异常处理**:捕获错误,触发截图回传
|
||||
|
||||
## 📑 目录
|
||||
|
||||
1. [数据采集与清洗闭环](#1️⃣-数据采集与清洗闭环product-data-collection--cleansing)
|
||||
@@ -62,12 +116,22 @@
|
||||
56. [AI动态定价系统](#5️⃣6️⃣-ai动态定价系统ai-dynamic-pricing-loop) 🆕
|
||||
57. [多店铺管理闭环](#5️⃣7️⃣-多店铺管理闭环multi-shop-management-loop) 🆕
|
||||
58. [多租户层级管理闭环](#5️⃣8️⃣-多租户层级管理闭环multi-tenant-hierarchy-loop) 🆕
|
||||
59. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
|
||||
60. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
|
||||
61. [关键绩效指标](#📊-关键绩效指标kpi)
|
||||
62. [追踪与审计](#🔍-追踪与审计)
|
||||
63. [业务审核状态机](#📋-业务审核状态机)
|
||||
64. [说明](#💡-说明)
|
||||
59. [安全与风控闭环](#5️⃣9️⃣-安全与风控闭环security--risk-control-loop) 🆕
|
||||
60. [用户管理与权限系统闭环](#6️⃣0️⃣-用户管理与权限系统闭环user-management--permission-system-loop) 🆕
|
||||
61. [多租户隔离闭环](#6️⃣1️⃣-多租户隔离闭环multi-tenant-isolation-loop) 🆕
|
||||
62. [支付与结算系统闭环](#6️⃣2️⃣-支付与结算系统闭环payment--settlement-system-loop) 🆕
|
||||
63. [API文档与开发者工具闭环](#6️⃣3️⃣-api文档与开发者工具闭环api-documentation--developer-tools-loop) 🆕
|
||||
64. [系统监控与运维闭环](#6️⃣4️⃣-系统监控与运维闭环system-monitoring--operation-loop) 🆕
|
||||
65. [国际化与本地化闭环](#6️⃣5️⃣-国际化与本地化闭环internationalization--localization-loop) 🆕
|
||||
66. [合规性与法律闭环](#6️⃣6️⃣-合规性与法律闭环compliance--legal-loop) 🆕
|
||||
67. [技术债务管理闭环](#6️⃣7️⃣-技术债务管理闭环technical-debt-management-loop) 🆕
|
||||
68. [用户教育与支持闭环](#6️⃣8️⃣-用户教育与支持闭环user-education--support-loop) 🆕
|
||||
69. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
|
||||
70. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
|
||||
71. [关键绩效指标](#📊-关键绩效指标kpi)
|
||||
72. [追踪与审计](#🔍-追踪与审计)
|
||||
73. [业务审核状态机](#📋-业务审核状态机)
|
||||
74. [说明](#💡-说明)
|
||||
|
||||
***
|
||||
|
||||
@@ -817,12 +881,13 @@ export default function(initialState: InitialState) {
|
||||
### 🔹 统一闭环依赖(TOC + TOB)
|
||||
|
||||
```text
|
||||
[数据采集] ↓[数据清洗] ↓[套利/利润评估] ↓[商品主数据] ↓[SKU变体与结构] ↓[商品刊登] ←→ [素材管理] ↓[定价与利润决策] ↓[广告/营销 (TOC) / 企业营销 (TOB)] ↓[订单履约 (OMS)] ↓[订单拆分与合并] ↓[异常订单处理] ↓[物流策略与渠道选择] ↓[库存 & WMS] ←→ [供应链 & 补货] ↓[售后逆向] ↓[资金对账] ↓[利润核算] ↓[B2B/TOB 贸易管理 (TOB)] ↓[用户/客户资产] ↓[A/B测试 & 策略优化] ↓[治理与审批中心] ↓[合规 & 证书] ↓[风控] ↓[报表 & 分析] ↺(反馈所有环节)
|
||||
[Operation-Agent] → [数据采集] ↓[数据清洗] ↓[套利/利润评估] ↓[商品主数据] ↓[SKU变体与结构] ↓[商品刊登] ←→ [素材管理] ↓[定价与利润决策] ↓[广告/营销 (TOC) / 企业营销 (TOB)] ↓[订单履约 (OMS)] ↓[订单拆分与合并] ↓[异常订单处理] ↓[物流策略与渠道选择] ↓[库存 & WMS] ←→ [供应链 & 补货] ↓[售后逆向] ↓[资金对账] ↓[利润核算] ↓[B2B/TOB 贸易管理 (TOB)] ↓[用户/客户资产] ↓[A/B测试 & 策略优化] ↓[治理与审批中心] ↓[合规 & 证书] ↓[风控] ↓[报表 & 分析] ↺(反馈所有环节)
|
||||
|
||||
外挂三条线:
|
||||
外挂四条线:
|
||||
用户资产 ← 订单 / 售后 → 广告 / B2B
|
||||
店铺健康度 ← 所有行为 → 限制商品 / 广告
|
||||
店铺隔离与自动化 ← 店铺操作 → 所有店铺相关行为
|
||||
Operation-Agent ← 多平台数据 → 所有跨境电商相关行为
|
||||
```
|
||||
|
||||
**说明**:
|
||||
@@ -874,20 +939,243 @@ export default function(initialState: InitialState) {
|
||||
36. **用户/客户资产闭环** → **广告计划与营销闭环**:提供用户画像和营销建议
|
||||
37. **用户/客户资产闭环** → **B2B / TOB 贸易管理闭环**:提供企业客户信息
|
||||
38. **广告计划与营销闭环** → **A/B测试与策略优化闭环**:提供广告策略数据
|
||||
39. **商品刊登闭环** → **A/B测试与策略优化闭环**:提供商品定价和展示数据
|
||||
40. **A/B测试与策略优化闭环** → **报表与分析闭环**:提供测试结果和优化建议
|
||||
41. **所有敏感操作** → **治理与审批中心闭环**:触发审批流程
|
||||
42. **治理与审批中心闭环** → **所有业务闭环**:提供审批结果
|
||||
43. **订单履约闭环** → **合规与证书管理闭环**:触发证书生成
|
||||
44. **合规与证书管理闭环** → **订单履约闭环**:提供合规证书
|
||||
45. **所有业务闭环** → **账号/店铺健康度闭环**:提供违规记录、发货延迟、差评率、退款率等数据
|
||||
46. **账号/店铺健康度闭环** → **广告计划与营销闭环**:提供是否暂停广告、降预算的决策
|
||||
47. **账号/店铺健康度闭环** → **商品刊登闭环**:提供是否限制上新、下架高风险商品的决策
|
||||
48. **所有店铺操作** → **店铺隔离与自动化闭环**:提供店铺操作数据
|
||||
49. **店铺隔离与自动化闭环** → **所有店铺相关行为**:提供隔离环境和自动化执行能力
|
||||
50. **所有闭环** → **合规与风控闭环**:提供全流程数据用于风险监控
|
||||
51. **所有业务闭环** → **报表与分析闭环**:提供各闭环的输出数据用于报表生成和分析
|
||||
52. **报表与分析闭环** → **所有业务闭环**:反馈数据异常、业务波动、优化建议,指导各闭环的操作调整
|
||||
|
||||
## 5️⃣9️⃣ 安全与风控闭环(Security & Risk Control Loop)
|
||||
|
||||
- **目标**:统一风控,确保系统安全和业务合规。
|
||||
- **流程**:
|
||||
1. **风险分级**:Level 1(安全)、Level 2(中风险)、Level 3(高风险)
|
||||
2. **人机协同**:AI生成建议 → 人工确认 → 执行
|
||||
3. **数据安全**:统一数据回传、权限控制、操作审计
|
||||
- **决策点**:
|
||||
- Level 1:自动执行
|
||||
- Level 2:小规模执行 + 确认
|
||||
- Level 3:仅建议,需人工确认
|
||||
- **输入**:全流程数据(TOC + TOB)
|
||||
- **输出**:风险处理记录、规则优化
|
||||
|
||||
## 6️⃣0️⃣ 用户管理与权限系统闭环(User Management & Permission System Loop)
|
||||
|
||||
- **目标**:管理用户账户和权限,确保系统安全和数据隔离。
|
||||
- **流程**:
|
||||
1. **用户管理**:注册、登录、个人信息管理、商户管理
|
||||
2. **权限体系**:角色定义、权限粒度、权限分配
|
||||
- **决策点**:
|
||||
- 角色权限分配
|
||||
- 数据访问控制
|
||||
- **输入**:用户信息、角色信息、权限信息
|
||||
- **输出**:用户账户、权限配置、访问控制结果
|
||||
|
||||
## 6️⃣1️⃣ 多租户隔离闭环(Multi-Tenant Isolation Loop)
|
||||
|
||||
- **目标**:实现商户→部门→店铺三层架构的数据隔离和权限控制。
|
||||
- **流程**:
|
||||
1. **数据隔离**:数据库级、Schema级、表级隔离
|
||||
2. **资源隔离**:计算资源、存储资源、网络资源隔离
|
||||
3. **租户配置**:独立配置、品牌定制、业务规则
|
||||
- **决策点**:
|
||||
- 隔离级别选择
|
||||
- 资源配额管理
|
||||
- **输入**:租户信息、店铺信息、资源配置
|
||||
- **输出**:隔离环境、配置管理、资源监控
|
||||
|
||||
## 6️⃣2️⃣ 支付与结算系统闭环(Payment & Settlement System Loop)
|
||||
|
||||
- **目标**:管理支付流程和商户结算,确保财务透明。
|
||||
- **流程**:
|
||||
1. **支付管理**:支付网关集成、支付流程、退款处理
|
||||
2. **账单与结算**:账单生成、结算周期、结算流程、税务处理
|
||||
- **决策点**:
|
||||
- 支付方式选择
|
||||
- 结算周期设置
|
||||
- **输入**:订单数据、支付信息、商户信息
|
||||
- **输出**:支付记录、账单、结算结果
|
||||
|
||||
## 6️⃣3️⃣ API文档与开发者工具闭环(API Documentation & Developer Tools Loop)
|
||||
|
||||
- **目标**:提供标准化的API接口和开发者工具,支持第三方集成。
|
||||
- **流程**:
|
||||
1. **API管理**:RESTful API设计、API文档、版本控制
|
||||
2. **开发者工具**:SDK、开发者门户、Webhook
|
||||
- **决策点**:
|
||||
- API版本管理
|
||||
- 开发者权限控制
|
||||
- **输入**:API需求、开发者信息
|
||||
- **输出**:API文档、SDK、开发者工具
|
||||
|
||||
## 6️⃣4️⃣ 系统监控与运维闭环(System Monitoring & Operation Loop)
|
||||
|
||||
- **目标**:监控系统健康状态,确保系统稳定运行。
|
||||
- **流程**:
|
||||
1. **监控体系**:系统健康、性能监控、异常监控
|
||||
2. **日志管理**:集中化日志、日志分析、告警机制
|
||||
3. **运维工具**:自动化部署、配置管理、灾备方案
|
||||
- **决策点**:
|
||||
- 监控阈值设置
|
||||
- 告警策略配置
|
||||
- **输入**:系统数据、日志数据、监控指标
|
||||
- **输出**:监控报告、告警通知、运维操作记录
|
||||
|
||||
## 6️⃣5️⃣ 国际化与本地化闭环(Internationalization & Localization Loop)
|
||||
|
||||
- **目标**:支持多语言和地区规则,适应全球业务需求。
|
||||
- **流程**:
|
||||
1. **多语言支持**:界面多语言、内容翻译
|
||||
2. **本地化配置**:时区处理、地区规则、货币与单位
|
||||
- **决策点**:
|
||||
- 语言支持范围
|
||||
- 本地化规则适配
|
||||
- **输入**:语言资源、地区规则
|
||||
- **输出**:多语言界面、本地化配置
|
||||
|
||||
## 6️⃣6️⃣ 合规性与法律闭环(Compliance & Legal Loop)
|
||||
|
||||
- **目标**:确保业务合规,符合数据隐私和平台规则要求。
|
||||
- **流程**:
|
||||
1. **数据隐私**:GDPR合规、CCPA合规、数据保护
|
||||
2. **平台规则**:电商平台合规、市场规范
|
||||
3. **合同管理**:商户协议、条款管理
|
||||
- **决策点**:
|
||||
- 合规策略制定
|
||||
- 合同条款审核
|
||||
- **输入**:用户数据、平台规则、合同模板
|
||||
- **输出**:合规报告、合同文档、隐私政策
|
||||
|
||||
## 6️⃣7️⃣ 技术债务管理闭环(Technical Debt Management Loop)
|
||||
|
||||
- **目标**:管理技术债务,确保代码质量和系统可维护性。
|
||||
- **流程**:
|
||||
1. **代码质量**:代码规范、代码审查、单元测试
|
||||
2. **技术栈管理**:依赖管理、技术选型
|
||||
3. **架构演进**:架构评估、技术债务识别与管理
|
||||
- **决策点**:
|
||||
- 技术栈更新策略
|
||||
- 代码质量标准
|
||||
- **输入**:代码库、依赖信息、架构文档
|
||||
- **输出**:代码质量报告、技术债务评估、架构优化建议
|
||||
|
||||
## 6️⃣8️⃣ 用户教育与支持闭环(User Education & Support Loop) 🆕
|
||||
|
||||
- **目标**:提供全面的用户教育和支持,提高用户体验和系统使用效率。
|
||||
- **流程**:
|
||||
1. **文档与培训**:用户文档、培训课程、视频教程
|
||||
2. **支持系统**:客服工单、知识库、在线支持
|
||||
3. **反馈机制**:用户反馈、功能投票
|
||||
- **决策点**:
|
||||
- 培训内容设计
|
||||
- 支持优先级设置
|
||||
- 反馈处理流程
|
||||
- **输入**:用户需求、系统功能、用户反馈
|
||||
- **输出**:用户文档、培训材料、支持工单处理结果、功能优化建议
|
||||
|
||||
***
|
||||
|
||||
## 6️⃣9️⃣ Operation-Agent 管理闭环(Operation-Agent Management Loop) 🆕
|
||||
|
||||
- **目标**:统一管理多平台跨境店铺,实现数据聚合、订单管理、商品同步、价格控制和报表分析闭环。
|
||||
- **流程**:
|
||||
1. **店铺绑定**:
|
||||
- 选择平台 → 提交认证信息 → 平台授权 → 店铺信息同步 → 校验与状态更新 → 测试同步
|
||||
2. **商品管理**:
|
||||
- 商品抓取:自动或手动同步平台商品信息
|
||||
- 上架/下架:可选择单个平台操作或全平台同步
|
||||
- 商品信息修改:价格、库存、标题、描述、图片统一管理
|
||||
- 商品分类与标签:统一标准,便于分析和报表生成
|
||||
3. **订单管理**:
|
||||
- 订单抓取:按时间/状态抓取多平台订单
|
||||
- 订单处理:统一查看、标记发货、取消、退款
|
||||
- 订单回写:状态更新自动同步至各平台
|
||||
4. **库存与价格管理**:
|
||||
- 库存同步:实时或定时同步各平台库存
|
||||
- 价格管理:支持统一定价、浮动定价、AI推荐价格
|
||||
- 异常提示:库存不足、价格冲突等提醒
|
||||
5. **报表与分析**:
|
||||
- 商品报表:库存、销量、价格变动历史
|
||||
- 订单报表:各平台销售汇总、退货率、利润计算
|
||||
- AI分析:定价建议、套利机会、热销商品推荐
|
||||
- 导出格式:CSV / JSON / Excel
|
||||
- **决策点**:
|
||||
- 平台选择:根据业务需求选择合适的跨境电商平台
|
||||
- 绑定策略:API、插件或Node-Agent接入方式
|
||||
- 定价策略:基于成本、市场和竞争情况
|
||||
- **输入**:
|
||||
- 平台认证信息(API Key、授权Token等)
|
||||
- 商品数据、订单数据、库存数据
|
||||
- 成本数据、运费数据、税费数据
|
||||
- **输出**:
|
||||
- 聚合店铺管理界面
|
||||
- 统一的商品、订单、库存数据
|
||||
- 分析报表和AI决策建议
|
||||
- **技术实现指引**:
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
| --- | --- | --- | --- |
|
||||
| 后端 | Operation-Agent管理 | `OperationAgentService.ts` | BE-AGENT001 |
|
||||
| 后端 | 店铺绑定服务 | `ShopBindingService.ts` | BE-AGENT002 |
|
||||
| 后端 | 数据聚合服务 | `DataAggregationService.ts` | BE-AGENT003 |
|
||||
| 前端 | 聚合管理面板 | `OperationAgentDashboard.tsx` | FE-AGENT001 |
|
||||
| 前端 | 店铺管理页面 | `ShopManagementPage.tsx` | FE-AGENT002 |
|
||||
| 前端 | 商品管理页面 | `ProductManagementPage.tsx` | FE-AGENT003 |
|
||||
- **状态变化**:
|
||||
- 店铺绑定:`PENDING` → `AUTHORIZING` → `SYNCHRONIZING` → `ACTIVE` / `FAILED`
|
||||
- 商品管理:`RAW` → `SYNCHRONIZED` → `UPDATED`
|
||||
- 订单管理:`PULLED` → `PROCESSED` → `SHIPPED` → `COMPLETED`
|
||||
|
||||
***
|
||||
|
||||
## 6️⃣8️⃣ 用户教育与支持闭环(User Education & Support Loop) 🆕
|
||||
|
||||
- **目标**:提供用户教育和支持,提高用户满意度和系统使用率。
|
||||
- **流程**:
|
||||
1. **文档与培训**:用户文档、培训课程、视频教程
|
||||
2. **支持系统**:客服工单、知识库、在线支持
|
||||
3. **反馈机制**:用户反馈、功能投票
|
||||
- **决策点**:
|
||||
- 培训内容设计
|
||||
- 支持优先级设置
|
||||
- **输入**:用户需求、系统功能、反馈信息
|
||||
- **输出**:用户文档、培训资料、支持记录、反馈处理结果
|
||||
|
||||
***
|
||||
|
||||
### 🔗 闭环依赖关系(TOC + TOB)
|
||||
|
||||
1. **数据采集与清洗闭环** → **商品主数据闭环**:提供原始商品数据
|
||||
2. **数据采集与清洗闭环** → **素材管理闭环**:提供采集的商品图片和视频素材
|
||||
3. **数据采集与清洗闭环** → **定价与利润决策闭环**:提供成本和市场数据
|
||||
4. **商品主数据闭环** → **SKU变体与结构闭环**:提供商品基础信息
|
||||
5. **SKU变体与结构闭环** → **商品刊登闭环**:提供结构化的商品信息
|
||||
6. **素材管理闭环** → **商品刊登闭环**:提供商品图片和视频素材
|
||||
7. **商品刊登闭环** → **订单履约闭环**:提供已刊登商品信息
|
||||
8. **订单履约闭环** → **库存与仓储管理闭环**:触发库存扣减
|
||||
9. **订单履约闭环** → **售后逆向闭环**:触发售后处理
|
||||
10. **售后逆向闭环** → **库存与仓储管理闭环**:触发库存回补
|
||||
11. **订单履约闭环** → **资金对账闭环**:提供订单交易数据
|
||||
12. **售后逆向闭环** → **资金对账闭环**:提供售后退款数据
|
||||
13. **库存与仓储管理闭环** → **供应链与供应商管理闭环**:触发补货
|
||||
14. **供应链与供应商管理闭环** → **库存与仓储管理闭环**:提供采购入库数据
|
||||
15. **资金对账闭环** → **利润核算闭环**:提供财务数据
|
||||
16. **商品刊登闭环** → **广告计划与营销闭环**:提供已刊登商品信息
|
||||
17. **广告计划与营销闭环** → **订单履约闭环**:增加订单量
|
||||
18. **订单履约闭环** → **用户/客户资产闭环**:提供订单数据
|
||||
19. **用户/客户资产闭环** → **广告计划与营销闭环**:提供用户画像和行为数据
|
||||
20. **商品刊登闭环** → **A/B测试与策略优化闭环**:提供商品定价和展示数据
|
||||
21. **A/B测试与策略优化闭环** → **报表与分析闭环**:提供测试结果和优化建议
|
||||
22. **所有敏感操作** → **治理与审批中心闭环**:触发审批流程
|
||||
23. **治理与审批中心闭环** → **所有业务闭环**:提供审批结果
|
||||
24. **订单履约闭环** → **合规与证书管理闭环**:触发证书生成
|
||||
25. **合规与证书管理闭环** → **订单履约闭环**:提供合规证书
|
||||
26. **所有业务闭环** → **账号/店铺健康度闭环**:提供违规记录、发货延迟、差评率、退款率等数据
|
||||
27. **账号/店铺健康度闭环** → **广告计划与营销闭环**:提供是否暂停广告、降预算的决策
|
||||
28. **账号/店铺健康度闭环** → **商品刊登闭环**:提供是否限制上新、下架高风险商品的决策
|
||||
29. **所有店铺操作** → **店铺隔离与自动化闭环**:提供店铺操作数据
|
||||
30. **店铺隔离与自动化闭环** → **所有店铺相关行为**:提供隔离环境和自动化执行能力
|
||||
31. **所有闭环** → **合规与风控闭环**:提供全流程数据用于风险监控
|
||||
32. **所有业务闭环** → **报表与分析闭环**:提供各闭环的输出数据用于报表生成和分析
|
||||
33. **报表与分析闭环** → **所有业务闭环**:反馈数据异常、业务波动、优化建议,指导各闭环的操作调整
|
||||
34. **Operation-Agent 管理闭环** → **数据采集与清洗闭环**:提供多平台商品数据
|
||||
35. **Operation-Agent 管理闭环** → **订单履约闭环**:提供多平台订单数据
|
||||
36. **Operation-Agent 管理闭环** → **库存与仓储管理闭环**:提供多平台库存数据
|
||||
37. **Operation-Agent 管理闭环** → **报表与分析闭环**:提供聚合数据用于分析
|
||||
|
||||
***
|
||||
|
||||
@@ -963,6 +1251,16 @@ export default function(initialState: InitialState) {
|
||||
| 仓储操作效率 | 每单处理时间 | TOC + TOB |
|
||||
| 跨仓调拨时效 | 调拨完成时间 | TOC + TOB |
|
||||
|
||||
#### Operation-Agent 管理闭环
|
||||
|
||||
| KPI 指标 | 描述 | 适用业务类型 |
|
||||
| ------ | ------------- | --------- |
|
||||
| 店铺绑定成功率 | 成功绑定的店铺比例 | TOC + TOB |
|
||||
| 数据同步时效 | 数据同步完成的平均时间 | TOC + TOB |
|
||||
| 平台覆盖度 | 已绑定平台占目标平台的比例 | TOC + TOB |
|
||||
| 操作成功率 | 成功执行的操作比例 | TOC + TOB |
|
||||
| 异常处理率 | 自动处理的异常比例 | TOC + TOB |
|
||||
|
||||
#### 供应链与供应商管理闭环
|
||||
|
||||
| KPI 指标 | 描述 | 适用业务类型 |
|
||||
|
||||
@@ -2,6 +2,238 @@
|
||||
|
||||
> **说明**:本任务表基于58个业务闭环拆解,专为100% AI开发设计,包含完整的任务依赖、数据流、触发条件和状态管理。
|
||||
|
||||
## 🧠 系统核心架构
|
||||
|
||||
### 系统层级
|
||||
```
|
||||
前端管理面板 → 后端服务 → Operation-Agent → 平台 Adapter → 外部平台
|
||||
↓ ↑
|
||||
←---------- 数据回传 -----------------
|
||||
```
|
||||
|
||||
### 核心组件
|
||||
|
||||
#### 1. 前端管理面板
|
||||
- **操作入口**:商品采集、上架/下架、调价、店铺管理
|
||||
- **状态展示**:实时操作状态、执行日志、截图回传
|
||||
- **多店铺管理**:统一面板展示,独立操作流程
|
||||
- **数据可视化**:销售报表、ROI分析、库存监控
|
||||
|
||||
#### 2. 后端服务
|
||||
- **数据存储**:统一接收Operation-Agent回传数据
|
||||
- **业务逻辑**:服务编排、状态管理、权限控制
|
||||
- **AI策略**:定价策略、选品推荐、套利分析
|
||||
- **报表系统**:多维度数据分析、导出功能
|
||||
|
||||
#### 3. SystemOrchestrator(系统大脑)
|
||||
- **全局决策**:资源分配、任务优先级、风险控制
|
||||
- **信号层**:接收店铺、商品、财务、风控等指标
|
||||
- **决策层**:多目标优化,生成Action建议
|
||||
- **执行层**:通过TaskGraph执行决策
|
||||
- **反馈层**:收集执行结果,优化决策模型
|
||||
|
||||
#### 4. TaskGraph(任务依赖引擎)
|
||||
- **DAG(有向无环图)**:任务依赖关系管理
|
||||
- **自动执行**:选品 → 定价 → 上架 → 广告 → 监控
|
||||
- **状态管理**:pending → waiting_approval → ready → running → success/failed
|
||||
- **失败重试**:异常处理、指数退避
|
||||
|
||||
#### 5. Operation-Agent(操作代理)
|
||||
- **轻量化守护进程**:运行在VPS/客户端
|
||||
- **核心操作**:采集、上架、调价、数据回传
|
||||
- **平台适配**:模块化Adapter,支持多平台(Amazon、Shopee、AliExpress、eBay、TikTok Shop等)
|
||||
- **监控能力**:关键位置截图、状态心跳
|
||||
- **安全边界**:只执行业务操作,禁止系统级操作
|
||||
- **绑定流程**:选择平台 → 提交认证信息 → 平台授权 → 店铺信息同步 → 校验与状态更新 → 测试同步
|
||||
- **支持平台**:
|
||||
- 全球性平台:Amazon、eBay、AliExpress、Shopee、Lazada、Wish、Shein、JD Worldwide、Walmart Marketplace
|
||||
- 社交与直营平台:TikTok Shop、Etsy、Target Plus、Newegg
|
||||
- 区域性平台:Cdiscount(法国)、Allegro(波兰)、Otto(德国)、Rakuten(日本)、Qoo10(新加坡/日本/韩国)
|
||||
|
||||
#### 6. 平台Adapter
|
||||
- **模块化设计**:每个平台独立实现
|
||||
- **操作封装**:模拟浏览器或调用API
|
||||
- **数据标准化**:统一输出格式,便于后端处理
|
||||
- **异常处理**:捕获错误,触发截图回传
|
||||
|
||||
#### 7. 用户管理与权限系统
|
||||
- **用户管理**:注册、登录、个人信息管理、商户管理
|
||||
- **权限体系**:角色定义(ADMIN、MANAGER、OPERATOR、FINANCE、SOURCING、LOGISTICS、ANALYST)、权限粒度、权限分配
|
||||
- **访问控制**:基于角色的访问控制,支持功能级和数据级权限
|
||||
|
||||
#### 8. 多租户隔离系统
|
||||
- **数据隔离**:数据库级、Schema级、表级隔离
|
||||
- **资源隔离**:计算资源、存储资源、网络资源隔离
|
||||
- **租户配置**:独立配置、品牌定制、业务规则
|
||||
|
||||
#### 9. 支付与结算系统
|
||||
- **支付管理**:支付网关集成、支付流程、退款处理
|
||||
- **账单与结算**:账单生成、结算周期、结算流程、税务处理
|
||||
|
||||
#### 10. 系统监控与运维
|
||||
- **监控体系**:系统健康、性能监控、异常监控
|
||||
- **日志管理**:集中化日志、日志分析、告警机制
|
||||
- **运维工具**:自动化部署、配置管理、灾备方案
|
||||
|
||||
## 🔄 业务闭环流程
|
||||
|
||||
### 1. 商品采集流程
|
||||
1. **前端**:用户选择平台,设置采集参数
|
||||
2. **后端**:生成采集任务,发送给Operation-Agent
|
||||
3. **Agent**:调用对应平台Adapter执行采集
|
||||
4. **Adapter**:模拟浏览器或API抓取商品数据
|
||||
5. **Agent**:回传采集结果到后端
|
||||
6. **后端**:存储数据,生成分析报表
|
||||
7. **前端**:展示采集结果,提供后续操作入口
|
||||
|
||||
### 2. 上架流程
|
||||
1. **前端**:用户选择商品,设置上架参数
|
||||
2. **后端**:生成上架任务,发送给Operation-Agent
|
||||
3. **Agent**:调用平台Adapter执行上架
|
||||
4. **Adapter**:模拟浏览器操作,完成上架
|
||||
5. **Agent**:回传上架结果和截图
|
||||
6. **后端**:更新商品状态,生成操作日志
|
||||
7. **前端**:展示上架状态,提供后续操作入口
|
||||
|
||||
### 3. 调价流程
|
||||
1. **前端**:用户选择商品,设置调价策略
|
||||
2. **后端**:AI分析生成调价建议,发送给Operation-Agent
|
||||
3. **Agent**:调用平台Adapter执行调价
|
||||
4. **Adapter**:模拟浏览器操作,更新价格
|
||||
5. **Agent**:回传调价结果和截图
|
||||
6. **后端**:更新价格记录,分析调价效果
|
||||
7. **前端**:展示调价状态,提供效果分析
|
||||
|
||||
### 4. 监控与分析流程
|
||||
1. **Agent**:定期采集平台数据,监控商品状态
|
||||
2. **Agent**:异常事件触发截图回传
|
||||
3. **后端**:接收监控数据,进行AI分析
|
||||
4. **后端**:生成预警和建议
|
||||
5. **前端**:展示监控结果,提供人工干预入口
|
||||
|
||||
## 🛡️ 安全与风控
|
||||
|
||||
### 1. 风险分级
|
||||
- **Level 1(安全)**:小幅调价、库存同步 → 自动执行
|
||||
- **Level 2(中风险)**:广告预算调整、扩品策略 → 小规模执行 + 确认
|
||||
- **Level 3(高风险)**:开新店、大额投放 → 仅建议,需人工确认
|
||||
|
||||
### 2. 人机协同
|
||||
- **建议模式**:AI生成建议 → 人工确认 → 执行
|
||||
- **自动模式**:低风险操作自动执行,高风险需确认
|
||||
- **可解释AI**:前端展示AI决策依据和风险评估
|
||||
- **回滚机制**:支持操作撤销,保证系统安全
|
||||
|
||||
### 3. 数据安全
|
||||
- **统一数据回传**:所有操作数据集中存储
|
||||
- **权限控制**:基于角色的访问控制
|
||||
- **操作审计**:完整的操作日志和截图记录
|
||||
|
||||
## 🚀 技术实现路径
|
||||
|
||||
### 1. 后端实现
|
||||
- **服务分层**:Controller → Service → Domain → Repository
|
||||
- **事件驱动**:使用BullMQ实现分布式队列
|
||||
- **WebSocket**:实时推送操作状态和结果
|
||||
- **AI集成**:模块化AI策略,可插拔设计
|
||||
|
||||
### 2. 前端实现
|
||||
- **组件化设计**:UI组件、功能组件、业务容器组件
|
||||
- **状态管理**:Umi Model + 全局状态
|
||||
- **数据可视化**:AntV G2/G6或ECharts
|
||||
- **响应式布局**:支持多终端访问
|
||||
|
||||
### 3. Operation-Agent实现
|
||||
- **技术选型**:Node.js + Puppeteer/Playwright
|
||||
- **模块化**:平台Adapter独立封装
|
||||
- **通信**:WebSocket/HTTP与后端通信
|
||||
- **监控**:心跳机制 + 异常捕获
|
||||
|
||||
### 4. 数据架构
|
||||
- **统一数据层**:DataHub提供唯一真相
|
||||
- **利润引擎**:实时计算ROI和利润
|
||||
- **报表系统**:多维度数据分析
|
||||
- **AI训练数据**:操作历史和结果用于模型优化
|
||||
|
||||
## 📈 商业价值
|
||||
|
||||
### 1. 核心价值
|
||||
- **自动化运营**:减少人工操作,提高效率
|
||||
- **数据驱动**:基于AI分析的智能决策
|
||||
- **多平台管理**:统一面板管理多个平台店铺
|
||||
- **风险控制**:实时监控和预警机制
|
||||
|
||||
### 2. 盈利模式
|
||||
- **功能收费**:基础功能免费,增值功能收费
|
||||
- **AI策略**:高级AI模型和策略订阅
|
||||
- **数据服务**:深度分析和报表服务
|
||||
- **平台分成**:通过平台交易获取分成
|
||||
|
||||
### 3. 竞争优势
|
||||
- **技术领先**:AI驱动的自动化运营
|
||||
- **用户体验**:轻量化操作,无需登录VPS
|
||||
- **数据闭环**:完整的数据流和分析体系
|
||||
- **可扩展性**:模块化设计,支持多平台扩展
|
||||
|
||||
## 🔮 未来规划
|
||||
|
||||
### 1. 阶段目标
|
||||
- **阶段1**:核心功能实现,基础业务闭环
|
||||
- **阶段2**:AI策略优化,人机协同系统
|
||||
- **阶段3**:多平台扩展,自动运营能力
|
||||
- **阶段4**:无人运营,AI完全自主决策
|
||||
|
||||
### 2. 技术演进
|
||||
- **AI能力**:从规则引擎到深度学习模型
|
||||
- **自动化**:从半自动到全自动化
|
||||
- **平台支持**:不断扩展支持的电商平台
|
||||
- **数据分析**:从基础报表到预测分析
|
||||
|
||||
### 3. 生态建设
|
||||
- **策略市场**:用户共享和交易AI策略
|
||||
- **开发者生态**:开放API,支持第三方集成
|
||||
- **行业解决方案**:针对不同行业的定制化方案
|
||||
|
||||
## 📋 实施计划
|
||||
|
||||
### 1. 近期任务
|
||||
- **后端服务搭建**:核心架构实现
|
||||
- **Operation-Agent开发**:基础操作能力
|
||||
- **前端面板开发**:用户交互界面
|
||||
- **平台Adapter实现**:主流平台支持
|
||||
|
||||
### 2. 中期任务
|
||||
- **SystemOrchestrator实现**:全局决策能力
|
||||
- **TaskGraph开发**:任务依赖管理
|
||||
- **AI策略集成**:智能定价和选品
|
||||
- **风控系统建设**:风险评估和预警
|
||||
|
||||
### 3. 远期任务
|
||||
- **多平台扩展**:覆盖更多电商平台
|
||||
- **自动化升级**:提高自主决策能力
|
||||
- **生态系统建设**:策略市场和开发者生态
|
||||
- **数据分析深化**:预测分析和智能推荐
|
||||
|
||||
## 🎯 成功指标
|
||||
|
||||
### 1. 业务指标
|
||||
- **商户数量**:平台入驻商户数
|
||||
- **GMV**:平台交易总额
|
||||
- **收入**:功能收费和平台分成
|
||||
- **用户满意度**:操作流畅度和功能满意度
|
||||
|
||||
### 2. 技术指标
|
||||
- **系统稳定性**:故障率和恢复时间
|
||||
- **操作成功率**:自动化操作成功率
|
||||
- **响应速度**:前端响应时间和操作执行时间
|
||||
- **AI准确率**:AI决策的准确性和有效性
|
||||
|
||||
### 3. 运营指标
|
||||
- **自动化率**:自动执行操作占比
|
||||
- **人工干预率**:需要人工干预的操作占比
|
||||
- **数据完整性**:数据采集和回传的完整性
|
||||
- **系统可用性**:平台服务可用时间
|
||||
|
||||
***
|
||||
|
||||
## 📦 任务包快速索引
|
||||
@@ -11,9 +243,15 @@
|
||||
> **状态标记规则**:
|
||||
>
|
||||
> - `⬜ 待领取` - 无人占用,可领取
|
||||
> - `🔒 AI-X` - 被AI-X占用中(如:🔒 AI-1, 🔒 AI-2)
|
||||
> - `🔒 AI-<Role>-<PID>` - 被AI占用中(如:🔒 AI-Frontend-1, 🔒 AI-Backend-2, 🔒 AI-Frontend-3-12345)
|
||||
> - `✅ 已完成` - 已完成
|
||||
> - `⏸️ 阻塞` - 有依赖阻塞
|
||||
>
|
||||
> **命名规范说明**:
|
||||
> - `Role`: AI角色(Frontend, Backend, Test, etc.)
|
||||
> - `PID`: 进程ID或唯一标识符,用于避免重复
|
||||
> - **示例**: AI-Frontend-1-12345(前端AI,ID为1,进程ID为12345)
|
||||
> - **好处**: 确保每个AI实例都有唯一标识,避免AI-1、AI-2等重复导致的冲突
|
||||
|
||||
### 🔴 P0 紧急任务包(立即处理)
|
||||
|
||||
@@ -56,6 +294,16 @@
|
||||
| 任务包ID | 包含任务 | 闭环 | 涉及文件 | 预计耗时 | 状态 |
|
||||
| ------------- | ------------------ | ----------- | ----------------------------------------------------------- | ---- | ----- |
|
||||
| PKG-MOCK-ARCH | MOCK-001\~MOCK-012 | 低侵入Mock架构实现 | Mock\_Architecture.md, \*DataSource.ts, msw\.ts, \*.mock.ts | 16h | ✅ 已完成 |
|
||||
| PKG-SECURITY | BE-SEC001\~BE-SEC005 | 安全与风控闭环 | SecurityService.ts, RiskControlService.ts | 24h | ✅ 已完成 |
|
||||
| PKG-USER-MGT | BE-USER001\~BE-USER004, FE-USER001\~FE-USER003 | 用户管理与权限系统 | UserService.ts, AuthService.ts, RoleService.ts, PermissionService.ts | 20h | ✅ 已完成 |
|
||||
| PKG-MULTI-TENANT | BE-MT001\~BE-MT004, FE-MT001\~FE-MT002 | 多租户隔离 | DataIsolationService.ts, HierarchyAuthMiddleware.ts, HierarchySelector.tsx | 24h | ✅ 已完成 |
|
||||
| PKG-PAYMENT | BE-PAY001\~BE-PAY005, FE-PAY001\~FE-PAY003 | 支付与结算系统 | PaymentService.ts, BillingService.ts, SettlementService.ts | 24h | ✅ 已完成 |
|
||||
| PKG-API-DOC | BE-API001\~BE-API003, FE-API001 | API文档与开发者工具 | ApiService.ts, SwaggerConfig.ts, SDKGenerator.ts | 16h | ✅ 已完成 |
|
||||
| PKG-MONITORING | BE-MON001\~BE-MON005, FE-MON001\~FE-MON002 | 系统监控与运维 | MonitoringService.ts, LogService.ts, HealthCheckService.ts | 20h | ✅ 已完成 |
|
||||
| PKG-I18N | BE-I18N001\~BE-I18N003, FE-I18N001\~FE-I18N002 | 国际化与本地化 | I18nService.ts, LocaleConfig.ts, TranslationManager.ts | 16h | ✅ 已完成 |
|
||||
| PKG-COMPLIANCE | BE-COMP001\~BE-COMP004, FE-COMP001\~FE-COMP002 | 合规性与法律 | ComplianceService.ts, DataPrivacyService.ts, ContractService.ts | 20h | ✅ 已完成 |
|
||||
| PKG-TECH-DEBT | BE-TECH001\~BE-TECH003 | 技术债务管理 | CodeQualityService.ts, DependencyManager.ts, ArchitectureReviewService.ts | 12h | ✅ 已完成 |
|
||||
| PKG-USER-EDU | FE-EDU001\~FE-EDU003, BE-EDU001 | 用户教育与支持 | DocumentationService.ts, TrainingService.ts, SupportService.ts | 16h | ✅ 已完成 |
|
||||
|
||||
***
|
||||
|
||||
@@ -402,7 +650,7 @@
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Step 2: 声明占用(强制) │
|
||||
│ ├── 将任务状态从 ⬜ 待领取 改为 🔒 AI-X(你的标识) │
|
||||
│ ├── 将任务状态从 ⬜ 待领取 改为 🔒 AI-<Role>-<PID>(你的标识,如:AI-Frontend-1-12345) │
|
||||
│ └── 直接编辑任务包表格中的"状态"列 │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
@@ -431,7 +679,7 @@
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Step 6: 完成并释放占用 │
|
||||
│ ├── 将任务状态从 🔒 AI-X 改为 ✅ 已完成 │
|
||||
│ ├── 将任务状态从 🔒 AI-<Role>-<PID> 改为 ✅ 已完成 │
|
||||
│ └── 直接编辑任务包表格中的"状态"列 │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
@@ -440,7 +688,7 @@
|
||||
|
||||
1. **检查状态**: 领取前确认任务状态为 ⬜ 待领取
|
||||
2. **优先领任务包**: 推荐领取完整任务包,避免碎片化
|
||||
3. **声明占用**: 直接修改任务状态列为 🔒 AI-X
|
||||
3. **声明占用**: 直接修改任务状态列为 🔒 AI-<Role>-<PID>(如:AI-Frontend-1-12345)
|
||||
4. **完成后标记**: 完成后将状态改为 ✅ 已完成
|
||||
5. **代码规范**: 所有代码必须遵循关键规则速查中的约束
|
||||
|
||||
@@ -461,13 +709,13 @@
|
||||
|
||||
| 模块 | 总任务数 | 已完成 | 进行中 | 待处理 | 失败 | 完成率 |
|
||||
| ------ | ------- | ------- | --- | ----- | -- | -------- |
|
||||
| 前端模块 | 54 | 54 | 0 | 0 | 0 | 100% |
|
||||
| 后端模块 | 144 | 144 | 0 | 0 | 0 | 100% |
|
||||
| 前端模块 | 64 | 64 | 0 | 0 | 0 | 100% |
|
||||
| 后端模块 | 169 | 169 | 0 | 0 | 0 | 100% |
|
||||
| 插件模块 | 14 | 14 | 0 | 0 | 0 | 100% |
|
||||
| AI模块 | 20 | 20 | 0 | 0 | 0 | 100% |
|
||||
| 数据模块 | 12 | 12 | 0 | 0 | 0 | 100% |
|
||||
| 运维模块 | 21 | 21 | 0 | 0 | 0 | 100% |
|
||||
| **总计** | **265** | **265** | 0 | **0** | 0 | **100%** |
|
||||
| 运维模块 | 26 | 26 | 0 | 0 | 0 | 100% |
|
||||
| **总计** | **305** | **305** | 0 | **0** | 0 | **100%** |
|
||||
|
||||
***
|
||||
|
||||
|
||||
Reference in New Issue
Block a user