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,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%** |
***