feat: 实现Operation-Agent核心功能及电商平台适配器
refactor: 重构项目结构,分离server和dashboard代码 style: 统一代码风格,修复lint警告 test: 添加平台适配器工厂测试用例 ci: 更新CI/CD流程,增加语义验证和性能测试 docs: 添加语义中心文档,定义统一数据模型和状态机
This commit is contained in:
@@ -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