feat: 实现Operation-Agent核心功能及电商平台适配器

refactor: 重构项目结构,分离server和dashboard代码
style: 统一代码风格,修复lint警告
test: 添加平台适配器工厂测试用例
ci: 更新CI/CD流程,增加语义验证和性能测试
docs: 添加语义中心文档,定义统一数据模型和状态机
This commit is contained in:
2026-03-19 15:23:56 +08:00
parent aa2cf560c6
commit 8de9ea0aaa
41 changed files with 5615 additions and 497 deletions

View File

@@ -2,6 +2,60 @@
> **说明**:本闭环文档是战略层业务流程,关注"做什么、为什么做、顺序和决策点"为下层模块功能和系统实现提供指引。TOC零售/前端)和 TOBB2B贸易共享通用模块特有流程用 `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 指标 | 描述 | 适用业务类型 |

View File

@@ -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前端AIID为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%** |
***