feat: add AI Digital Employee agent orchestrator with pipeline tracking
- New AgentPipeline model with JSONB pipeline_data for stages/leads/summary
- AgentOrchestrator service chains DiscoveryService search→analyze→outreach→auto-save
- 3 new API endpoints: POST /agent/start, GET /agent/pipelines, GET /agent/{id}
- Full Agent dashboard Vue component with stats, pipeline grid, leads table, outreach preview
- Sidebar redesigned with AI Agent as primary entry point
- Updated PROGRESS.md, AGENTS.md, DATABASE_SCHEMA.md with latest state
This commit is contained in:
+38
-15
@@ -1,7 +1,7 @@
|
||||
# TradeMate (外贸小助手) - 项目进度文档
|
||||
|
||||
**更新时间**: 2026-06-02 12:00
|
||||
**状态**: ✅ 生产环境运行中 — AI 路由 DB 驱动 + 翻译配额全链路 + ECS RAM 角色认证
|
||||
**更新时间**: 2026-06-16 18:30
|
||||
**状态**: ✅ 生产环境运行中 — AI 路由 DB 驱动 + 翻译配额全链路 + ECS RAM 角色认证 + AI 数字员工
|
||||
|
||||
---
|
||||
|
||||
@@ -74,7 +74,24 @@
|
||||
| 联系人提取 | `discovery.py` | 点击从公司官网抓取 Email/Phone/WhatsApp/WeChat |
|
||||
| 真实搜索结果 | `mcp_search_server.py` | 对接 Google Custom Search 返回真实数据 |
|
||||
|
||||
### 5. 落地页 + 推荐系统 + 付费体系 ✅
|
||||
### 5. AI 数字员工 (Agent Orchestrator) ✅ [NEW]
|
||||
|
||||
| 功能 | 文件 | 说明 |
|
||||
|------|------|------|
|
||||
| **Pipeline 模型** | `models/agent_pipeline.py` | `agent_pipelines` 表 — UUID PK + JSONB pipeline_data |
|
||||
| **编排服务** | `services/agent_orchestrator.py` | 串接 DiscoveryService → 分析 → 评分 → 触达 → 自动入库 |
|
||||
| **Agent API** | `api/v1/agent.py` | 3 端点: POST /start, GET /pipelines, GET /{id} |
|
||||
| **Agent 仪表盘** | `user-frontend/src/views/Agent.vue` | 统计卡片 + 任务列表 + 流水线进度 + 线索表格 + 触达预览 |
|
||||
| **侧边栏入口** | `layouts/UserLayout.vue` | "AI数字员工" 作为首位菜单项,图标 MagicStick |
|
||||
|
||||
**工作流程**:
|
||||
1. 用户输入产品名称 + 描述 + 目标市场
|
||||
2. Agent 自动搜索 → AI 分析匹配度 → 评分排序 → Top 5 生成触达文案
|
||||
3. 高匹配客户 (≥70分) 自动保存到客户列表
|
||||
4. 用户在线预览 WhatsApp/LinkedIn/Email 触达文案
|
||||
5. 4 阶段流水线可视进度 (搜索→分析→触达→完成)
|
||||
|
||||
### 6. 落地页 + 推荐系统 + 付费体系 ✅
|
||||
|
||||
| 功能 | 说明 |
|
||||
|------|------|
|
||||
@@ -84,7 +101,7 @@
|
||||
| 年费定价 | `payment.py` — 新增 yearly 套餐选项 |
|
||||
| 搜索 API 管理 | `admin_search.py` — 管理后台配置搜索提供商 |
|
||||
|
||||
### 5.1 支付系统 ✅
|
||||
### 6.1 支付系统 ✅
|
||||
|
||||
| 组件 | 文件 | 说明 |
|
||||
|------|------|------|
|
||||
@@ -104,7 +121,7 @@
|
||||
|
||||
**凭证**: `PAY_API_KEY` / `PAY_API_SECRET` 从 `.env` 读取(外贸助手密钥),HMAC-SHA256 认证
|
||||
|
||||
### 6. PC 桌面端布局 ✅
|
||||
### 7. PC 桌面端布局 ✅
|
||||
|
||||
| 功能 | 说明 |
|
||||
|------|------|
|
||||
@@ -113,7 +130,7 @@
|
||||
| 消除重复 tabbar | 桌面端侧边栏替代移动端底部导航 |
|
||||
| 消除组件边界 | 侧边栏完全在 App.vue 内部 |
|
||||
|
||||
### 7. Bug 修复 (共 13 个)
|
||||
### 8. Bug 修复 (共 13 个)
|
||||
|
||||
| 序号 | 文件 | 问题描述 | 状态 |
|
||||
|------|------|----------|------|
|
||||
@@ -133,7 +150,7 @@
|
||||
| 14 | `app/api/v1/auth.py` | 登录/注册 CSRF 鸡生蛋 — 匿名用户无 cookie 导致 403 | ✅ 已修复 |
|
||||
| 15 | 4 个前端登录/注册页面 | 后端错误英文直接展示给用户 | ✅ 已修复 |
|
||||
|
||||
### 8. 游客模式 (Guest Mode) ✅
|
||||
### 9. 游客模式 (Guest Mode) ✅
|
||||
|
||||
| 功能 | 接口 | 说明 |
|
||||
|------|------|------|
|
||||
@@ -141,7 +158,7 @@
|
||||
| 公开翻译 | `POST /api/v1/translate/public/translate` | 无需认证 |
|
||||
| 公开信息提取 | `POST /api/v1/translate/public/extract` | 无需认证 |
|
||||
|
||||
### 9. 管理后台完整可用
|
||||
### 10. 管理后台完整可用
|
||||
|
||||
| 功能 | 说明 |
|
||||
|------|------|
|
||||
@@ -152,7 +169,7 @@
|
||||
| AI 模型配置 | 在线增删改 AI 提供商、重载配置、启停控制 |
|
||||
| 搜索配置 | 搜索提供商管理 |
|
||||
|
||||
### 10. 翻译配额全链路 ✅
|
||||
### 11. 翻译配额全链路 ✅
|
||||
|
||||
| 组件 | 说明 |
|
||||
|------|------|
|
||||
@@ -162,7 +179,7 @@
|
||||
| `OpenAIProvider.translate()` | LLM 翻译也走配额检查 (`llm` 版本) |
|
||||
| 后台 `Quota.vue` | 配额管理页 (月限额/启用/重置),修复了 API 路径 bug |
|
||||
|
||||
### 11. 管理后台增强
|
||||
### 12. 管理后台增强
|
||||
|
||||
| 功能 | 说明 |
|
||||
|------|------|
|
||||
@@ -171,7 +188,7 @@
|
||||
| AI 模型配置 | 修复侧边栏链接路径 |
|
||||
| 登录跳转 | 登录后自动跳转仪表盘 |
|
||||
|
||||
### 12. 其他增强
|
||||
### 13. 其他增强
|
||||
|
||||
| 功能 | 说明 |
|
||||
|------|------|
|
||||
@@ -182,7 +199,7 @@
|
||||
| Docker Compose 增强 | 添加 nginx/admin/user/uni-app 服务 + 独立网络 + Redis AOF |
|
||||
| CSRF 保护 | 双提交 Cookie 模式,auth/payment/profile 必检 |
|
||||
|
||||
### 11. 核心 API 测试通过
|
||||
### 14. 核心 API 测试通过
|
||||
|
||||
| 功能 | 接口 | 状态 |
|
||||
|------|------|------|
|
||||
@@ -199,6 +216,9 @@
|
||||
| 产品 CRUD | `/api/v1/products/*` | ✅ 正常 |
|
||||
| 客户 CRUD | `/api/v1/customers/*` | ✅ 正常 |
|
||||
| 套餐计划 | `GET /api/v1/payment/plans` | ✅ 正常 |
|
||||
| AI Agent 启动 | `POST /api/v1/agent/start` | ✅ 正常 |
|
||||
| AI Agent 列表 | `GET /api/v1/agent/pipelines` | ✅ 正常 |
|
||||
| AI Agent 详情 | `GET /api/v1/agent/{id}` | ✅ 正常 |
|
||||
|
||||
---
|
||||
|
||||
@@ -209,6 +229,7 @@
|
||||
2. 测试 WhatsApp 真实集成(需 Meta Business 认证)
|
||||
3. 性能优化测试
|
||||
4. 微信小程序端验证
|
||||
5. 在管理后台添加 Agent Pipeline 管理页面
|
||||
|
||||
---
|
||||
|
||||
@@ -262,11 +283,11 @@
|
||||
trade-assistant/
|
||||
├── backend/ # FastAPI 后端
|
||||
│ ├── app/
|
||||
│ │ ├── api/v1/ # REST API (30+ 路由模块)
|
||||
│ │ ├── api/v1/ # REST API (30+ 路由模块, 含 agent)
|
||||
│ │ ├── ai/ # AI 抽象层 (router + 5 providers)
|
||||
│ │ ├── core/ # 安全/中间件/异常 (含 CSRF + 限流)
|
||||
│ │ ├── models/ # 数据模型 (25+ 模型)
|
||||
│ │ ├── services/ # 业务逻辑 (30+ 服务)
|
||||
│ │ ├── models/ # 数据模型 (25+ 模型, 含 agent_pipeline)
|
||||
│ │ ├── services/ # 业务逻辑 (30+ 服务, 含 agent_orchestrator)
|
||||
│ │ ├── workers/ # Celery 任务
|
||||
│ │ └── main.py # FastAPI 入口
|
||||
│ ├── alembic/ # 数据库迁移
|
||||
@@ -275,6 +296,7 @@ trade-assistant/
|
||||
├── uni-app/ # 移动端 H5 + 小程序
|
||||
├── admin-frontend/ # PC 管理后台 (Vue 3 + Element Plus)
|
||||
├── user-frontend/ # 用户工作台 (Vue 3 + Element Plus)
|
||||
│ └── src/views/Agent.vue # AI 数字员工仪表盘
|
||||
├── nginx/ # Nginx 配置
|
||||
├── docker-compose.yml # Docker 编排 (6 服务)
|
||||
├── scripts/ # 运维脚本
|
||||
@@ -367,6 +389,7 @@ cd backend && source venv/bin/activate && uvicorn app.main:app --reload --port 8
|
||||
|
||||
| 日期 | 变更内容 |
|
||||
|------|----------|
|
||||
| 2026-06-16 | **AI 数字员工**: AgentOrchestrator 编排服务 + AgentPipeline 模型 + Agent API + 前端仪表盘 |
|
||||
| 2026-06-02 | 生产环境部署 + AI 路由 DB 驱动 + 翻译配额扩展至 LLM + ECS RAM 角色认证 + 删除 OpencodeGo/Spark |
|
||||
| 2026-05-29 | 安全加固 (T-005): 限流/CSRF/CORS + AI 提供商 DB 管理 + 客户挖掘联系人提取 |
|
||||
| 2026-05-28 | 加载反馈 + 搜索历史自动保存 + 超时修复 |
|
||||
|
||||
Reference in New Issue
Block a user