wurenzhi/makemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor(terminology): 统一术语标准并优化代码类型安全

Browse Source 
- 将B2B统一为TOB术语
- 将状态值统一为大写格式
- 优化类型声明，避免使用any
- 将float类型替换为decimal以提高精度
- 新增术语标准化文档
- 优化路由结构和菜单分类
- 添加TypeORM实体类
- 增强加密模块安全性
- 重构前端路由结构
- 完善任务模板和验收标准
This commit is contained in:
wurenzhi
2026-03-20 09:43:50 +08:00
parent eafa1bbe94
commit 48a78137c5
132 changed files with 13767 additions and 2140 deletions
Download Patch File Download Diff File Expand all files Collapse all files

66
docs/01_Architecture/12_Operation_Agent.md
View File

@@ -1,32 +1,32 @@
# Operation-Agent 架构设计与实现
# 运营代理（Agent）架构设计与实现
## 1. 核心架构
### 1.1 系统层级
```
前端管理面板 → 后端服务 → Operation-Agent → 平台 Adapter → 外部平台
↓ ↑
←---------- 数据回传 -----------------
前端控制台（Frontend Console） → 后端服务（Backend Service） → 运营代理（Agent） → 平台适配器（Platform Adapter） → 第三方平台（External Platform）
↓ ↑
←-------------------------- 数据回传 -------------------------------------------
```
### 1.2 核心组件
- **前端管理面板**：操作入口、状态展示、多店铺管理、数据可视化
- **后端服务**：数据存储、业务逻辑、AI策略、报表系统
- **Operation-Agent**：轻量化守护进程、核心操作、平台适配、监控能力
- **平台Adapter**：模块化设计、操作封装、数据标准化、异常处理
- **前端控制台（Frontend Console）**：操作入口、状态展示、多店铺管理、数据可视化
- **后端服务（Backend Service）**：数据存储、业务逻辑、AI策略、报表系统
- **运营代理（Agent）**：轻量化守护进程、核心操作、平台适配、监控能力
- **平台适配器（Platform Adapter）**：模块化设计、操作封装、数据标准化、异常处理
## 2. 浏览器插件实现方案
### 2.1 架构
```
浏览器插件 → 插件后台脚本 → 平台适配器 → 外部平台
↓ ↑
←------------ 数据回传 ------------
浏览器插件 → 插件后台脚本 → 平台适配器（Platform Adapter） → 第三方平台（External Platform）
↓ ↑
←-------------------- 数据回传 -------------------------
```
### 2.2 核心组件
- **插件后台脚本**：替代Operation-Agent的守护进程
- **平台适配器**：保留现有的`IPlatformAdapter`接口，扩展以支持浏览器环境
- **插件后台脚本**：替代运营代理（Agent）的守护进程
- **平台适配器（Platform Adapter）**：保留现有的`IPlatformAdapter`接口，扩展以支持浏览器环境
- **数据存储**：使用浏览器的`chrome.storage`存储配置和状态
- **用户界面**：实现浏览器插件的弹出页面
@@ -39,9 +39,9 @@
### 3.1 架构
```
后端服务 → Operation-Agent（无界面后台服务） → 平台 Adapter → 外部平台
↑ ↓
←--------------- 数据回传与状态更新 ---------------
后端服务（Backend Service） → 运营代理（Agent）（无界面后台服务） → 平台适配器（Platform Adapter） → 第三方平台（External Platform）
↑ ↓
←---------------------- 数据回传与状态更新 ---------------------
```
### 3.2 核心组件
@@ -60,13 +60,13 @@
### 4.1 架构
```
前端管理面板 ←→ 后端服务 ←→ Operation-Agent（远程浏览器） ←→ 平台 Adapter ←→ 外部平台
↑ ↑
←-------- 实时屏幕传输与操作 ---------→
前端控制台（Frontend Console） ←→ 后端服务（Backend Service） ←→ 运营代理（Agent）（远程浏览器） ←→ 平台适配器（Platform Adapter） ←→ 第三方平台（External Platform）
↑ ↑
←--------------------- 实时屏幕传输与操作 ------------------------------→
```
### 4.2 核心组件
- **远程浏览器管理**：Operation-Agent启动受控浏览器实例，捕获浏览器屏幕并编码传输
- **远程浏览器管理**：运营代理（Agent）启动受控浏览器实例，捕获浏览器屏幕并编码传输
- **实时通信层**：WebRTC或WebSocket实现实时屏幕传输
- **前端交互界面**：实时显示远程浏览器屏幕，捕获用户操作
- **会话管理**：远程交互会话的创建和管理，权限控制和安全验证
@@ -88,18 +88,18 @@
### 5.1 架构
```
前端管理面板 ←→ 后端服务 ←→ Agent管理服务 ←→ Operation-Agent实例集群
↓
负载均衡/调度
↓
┌─────────────┼─────────────┐
↓ ↓ ↓
VPS1 (IP1) VPS2 (IP2) VPS3 (IP3)
┌────────┐ ┌────────┐ ┌────────┐
│Agent 1 │ │Agent 2 │ │Agent 3 │
└────────┘ └────────┘ └────────┘
↓ ↓ ↓
多店铺管理 同平台隔离 多店铺管理
前端控制台（Frontend Console） ←→ 后端服务（Backend Service） ←→ Agent管理服务 ←→ 运营代理（Agent）实例集群
↓
负载均衡/调度
↓
┌─────────────────────┼─────────────────────┐
↓ ↓ ↓
VPS1 (IP1) VPS2 (IP2) VPS3 (IP3)
┌────────┐ ┌────────┐ ┌────────┐
│Agent 1 │ │Agent 2 │ │Agent 3 │
└────────┘ └────────┘ └────────┘
↓ ↓ ↓
多店铺管理 同平台隔离 多店铺管理
```
### 5.2 VPS控制模式
@@ -146,6 +146,6 @@
## 7. 总结
Operation-Agent是一个强大的跨境电商平台集成解决方案，通过灵活的架构设计和多种实现方案，可以满足不同场景下的需求。从浏览器插件到无界面后台服务，从远程人工交互到多店铺管理，Operation-Agent提供了一套完整的工具链，帮助商家高效管理多平台店铺，提高运营效率和竞争力。
运营代理（Agent）是一个强大的跨境电商平台集成解决方案，通过灵活的架构设计和多种实现方案，可以满足不同场景下的需求。从浏览器插件到无界面后台服务，从远程人工交互到多店铺管理，运营代理（Agent）提供了一套完整的工具链，帮助商家高效管理多平台店铺，提高运营效率和竞争力。
在实际商业化运营中，需要根据具体的业务需求、技术能力和成本预算选择合适的实现方案，并不断优化和改进，以适应不断变化的市场环境和平台规则。