refactor: switch to free-trial/private-deploy/buyout pricing, fix feature gaps, add SEO landing + deploy config

2026-07-12 08:09:28 +08:00
parent 9ca5d79d8a
commit 04924e3bc4
36 changed files with 1026 additions and 975 deletions
@@ -1,7 +1,7 @@
 # TradeMate (外贸小助手) - 项目进度文档

-**更新时间**: 2026-06-16 18:30  
-**状态**: ✅ 生产环境运行中 — AI 路由 DB 驱动 + 翻译配额全链路 + ECS RAM 角色认证 + AI 数字员工
+**更新时间**: 2026-07-11  
+**状态**: ✅ 生产环境运行中 — 收费方式调整（免费试用/私有化部署/买断源码）+ 功能审计补全 + SEO 营销落地页 + 部署优化

 ---

@@ -82,7 +82,7 @@
 | **编排服务** | `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 |
+| **侧边栏入口** | `layouts/UserLayout.vue` | "AI数字员工" 已接入路由 `/workspace/agent` 与侧边栏菜单（图标 MagicStick）；`/agent` 重定向到 `/workspace/agent` |

 **工作流程**:
 1. 用户输入产品名称 + 描述 + 目标市场
@@ -199,7 +199,69 @@
 | Docker Compose 增强 | 添加 nginx/admin/user/uni-app 服务 + 独立网络 + Redis AOF |
 | CSRF 保护 | 双提交 Cookie 模式，auth/payment/profile 必检 |

-### 14. 核心 API 测试通过
+### 14. PC 工作台 UX 大幅重构 — 合并工作区 + CommandK 命令面板 ✅ [NEW]
+
+| 功能 | 说明 |
+|------|------|
+| **侧边栏精简** | 从 11 项合并为 5 项（首页/客户/业务/翻译/更多），减少 4 层级为 5 个清晰入口 |
+| **CommandK 命令面板** | `user-frontend/src/components/CommandK.vue` — 全局 Ctrl+K 调出，快速搜索/导航/操作 |
+| **工作区合并** | 客户/挖掘/跟进 → `WorkspaceCustomer.vue`；翻译/产品/报价/营销 → `WorkspaceBiz.vue` |
+| **仪表盘简化** | `NewHome.vue` 精简为数据看板，去掉冗余入口 |
+| **旧路由保留** | 旧页面可通过隐藏路由访问，保证兼容性 |
+
+### 15. uni-app 移动端 4Tab 合并重构 ✅ [NEW]
+
+| 功能 | 说明 |
+|------|------|
+| **Tab Bar 精简** | 从 5 项（首页/客户/营销/报价/我的）改为 4 项（首页/客户/业务/我的） |
+| **客户工作台** | `workspace-customer.vue` — 3 个内联标签（客户列表/挖掘新客/智能跟进） |
+| **业务工作台** | `workspace-biz.vue` — 4 个内联标签（翻译/产品库/报价单/营销素材） |
+| **个人中心更新** | `profile.vue` — 通知中心/数据分析/团队/升级会员/联系客服 |
+| **pages.json** | 标签栏配置同步更新，新增 workspace 页面注册 |
+
+### 16. 定价模型重构 + 升级弹窗 + 生态 UI ✅ [NEW]
+
+| 功能 | 说明 |
+|------|------|
+| **定价页重构** | `Upgrade.vue` 重新设计，新增 Yearly 套餐卡片 + 功能对比表 |
+| **升级弹窗** | `UpgradeModal.vue` — 全局组件，任何页面可直接调起 |
+| **生态入口** | `WorkspaceLanding.vue` — 工作台首页展示套餐状态 + 升级入口 |
+| **路由整合** | 新增 `/workspace/upgrade` 路由，侧边栏可直接访问 |
+
+### 17. 产品策略文档 + Agent 技能 + Chrome 浏览器扩展 ✅ [NEW]
+
+| 功能 | 说明 |
+|------|------|
+| **产品策略文档** | `docs/PRODUCT_STRATEGY.md` — 319 行完整产品路线图（市场分析/定位/功能规划/定价策略/增长路线） |
+| **Agent 技能定义** | 3 个 `.opencode/skills/` 文件 — `customer-discovery.md` / `marketing-content.md` / `translate-reply.md` |
+| **Chrome 扩展** | `browser-extension/` — 完整 Chrome 插件，支持 LinkedIn/Amazon/AliExpress 页面集成 |
+| **浏览器扩展功能** | popup 面板调用 API 翻译/提取客户信息、网页右键菜单、自动填写报价单 |
+
+### 18. 管理后台 AI 路由增强 ✅ [NEW]
+
+| 功能 | 说明 |
+|------|------|
+| **新增路由标签** | agent (数字员工)、followup (智能跟进)、outreach (开发信)、competitor (竞品分析) |
+| **一行代码改动** | `admin-frontend/src/views/Config.vue` 更新 `ai_routing` 字段标签 |
+
+### 19. 用户工作台 i18n 导航键更新 ✅ [NEW]
+
+| 功能 | 说明 |
+|------|------|
+| **中文 locale** | `zh-CN.json` — 新增 home/customers/biz/agent 导航键 |
+| **英文 locale** | `en.json` — 同步新增对应导航键 |
+| **双语言适配** | 确保重构后的侧边栏/面包屑/页面标题完整支持中英文切换 |
+
+### 20. 后端持续优化 ✅ [NEW]
+
+| 序号 | 文件 | 问题描述 | 状态 |
+|------|------|----------|------|
+| 16 | `customer_health.py` | 健康分计算逻辑优化，增加活跃度权重 | ✅ 已修复 |
+| 17 | `corpus_trainer.py` | 语料库训练流程修复，避免空数据处理 | ✅ 已修复 |
+| 18 | `middleware.py` | 中间件性能优化，减少请求路径匹配耗时 | ✅ 已修复 |
+| 19 | `conftest.py` | 测试基础设施增强，新增 fixture 复用 | ✅ 已修复 |
+
+### 21. 核心 API 测试通过

 | 功能 | 接口 | 状态 |
 |------|------|------|
@@ -222,6 +284,39 @@

 ---

+### 22. 收费方式调整 + 功能审计补全 + SEO/营销落地页 + 部署优化 ✅ [NEW]
+
+> **方向调整（2026-07-11）**：停止以「按月订阅」为主推的 SaaS 收费模型，改为合规的「免费试用 / 私有化部署 / 买断源码」三档方案。
+> 合规依据：仅持 ICP 备案即可销售「免费试用 + 私有化部署（年付授权）+ 买断源码（一次性软件/服务合同）」；若上线「托管付费订阅」需另行办理 ICP 经营许可证。
+
+| 模块 | 文件 | 说明 |
+|------|------|------|
+| **定价页重构** | `user-frontend/src/views/Upgrade.vue` + `UpgradeModal.vue`、`uni-app/src/pages/upgrade/upgrade.vue` | 三档方案：免费试用 ¥0 / 私有化部署 ¥39,800 年 / 买断源码 ¥98,000 一次性；价格为可配置展示值 |
+| **企业线索后端** | `backend/app/api/v1/leads.py` + `models/enterprise_lead.py` + `alembic/versions/add_enterprise_leads.py` | 新增 `POST /api/v1/leads`（免登录），`EnterpriseLead` 模型 + `enterprise_leads` 表；CSRF 对 `/api/v1/leads` 放行 |
+| **线索测试** | `backend/tests/test_leads_api.py` | 3 个用例全部通过 |
+| **功能审计补全** | `user-frontend/src/router/index.js`、`UserLayout.vue`、`admin-frontend/src/api/index.js`、`admin-frontend/src/views/Users.vue` | 修复 Agent 路由未接入工作台；修复后台用户编辑调用错误端点（`PATCH /users/{id}/tier`、`POST .../toggle-active`、`PATCH .../role`、`/admin/usage-stats`） |
+| **浏览器扩展补全** | `browser-extension/api/client.js`、`popup/popup.js`、`popup/index.html` | 新增「提取客户信息」（`extractInfo()`）+ 「客户」Tab + 升级链接指向 `/workspace/upgrade` |
+| **后端测试** | `backend` pytest | 158 用例 + 3 leads 用例全部通过，无失败 |
+| **SEO 营销落地页** | `landing/index.html`、`landing/robots.txt`、`landing/sitemap.xml` | 语义化可抓取 HTML + JSON-LD（`SoftwareApplication` + `FAQPage`）+ OG/Twitter + 规范化链接 + 内链到 `/app/`、`/workspace/`、定价；`robots.txt`/`sitemap.xml` 置于站点根 |
+| **前端 SEO 增强** | `uni-app/index.html` | 修复损坏的 `og:image`/`twitter:image`（指向 `/app/static/images/yzr/yuzhiran.jpg`），更新描述为新三档定价 |
+| **部署配置** | `deploy/frontend/nginx.conf` | 四路布局：`/` → 营销落地页（根）、`/app/` → uni-app H5、`/workspace/` → 用户工作台、`/admin/` → 管理后台、`/api/` → 后端 127.0.0.1:8000；各 SPA 带 `try_files ... /index.html` fallback |
+
+**部署目录结构（目标）**：
+```
+/www/wwwroot/trade.yuzhiran.com/
+├── index.html      ← landing/ 营销落地页（SEO 主入口）
+├── robots.txt      ← landing/robots.txt
+├── sitemap.xml     ← landing/sitemap.xml
+├── app/            ← uni-app 构建产物 (base: /app/)
+├── workspace/      ← user-frontend 构建产物 (base: /workspace/)
+├── admin/          ← admin-frontend 构建产物 (base: /admin/)
+└── （后端由 systemd/uvicorn 运行，经 /api/ 代理）
+```
+
+**注意**：本环境无服务器 SSH 凭据，无法实际推送部署；上述产物与 `nginx.conf` 为部署就绪状态，需在目标服务器执行构建 + 拷贝 + `alembic upgrade head` + 重载 nginx。
+
+---
+
 ## 三、待办事项

 ### 低优先级
@@ -369,16 +464,23 @@ trade.yuzhiran.com/
 ### 8.3 部署流程

 ```bash
-# 前端构建 & 部署
+# 1. 营销落地页（SEO 主入口）
+cp landing/index.html /www/wwwroot/trade.yuzhiran.com/index.html
+cp landing/robots.txt landing/sitemap.xml /www/wwwroot/trade.yuzhiran.com/
+
+# 2. 三端 SPA 构建 & 部署
+cd uni-app && npm run build:h5 && cp -r dist/build/h5/* /www/wwwroot/trade.yuzhiran.com/app/
 cd user-frontend && npm run build && cp -r dist/* /www/wwwroot/trade.yuzhiran.com/workspace/
 cd admin-frontend && npm run build && cp -r dist/* /www/wwwroot/trade.yuzhiran.com/admin/

-# 后端重启 (systemd)
+# 3. 后端：迁移 + 重启 (systemd)
+cd backend && source venv/bin/activate && alembic upgrade head
 sudo systemctl restart ftrade-backend.service
-
-# 查看启动日志
 sudo journalctl -u ftrade-backend.service -n 20

+# 4. Nginx：套用 deploy/frontend/nginx.conf 的 4 路布局后重载
+sudo nginx -t && sudo nginx -s reload
+
 # 本地开发启动
 cd backend && source venv/bin/activate && uvicorn app.main:app --reload --port 8000
 ```
@@ -389,6 +491,7 @@ cd backend && source venv/bin/activate && uvicorn app.main:app --reload --port 8

 | 日期 | 变更内容 |
 |------|----------|
+| 2026-07-11 | **收费方式调整**: 免费试用/私有化部署/买断源码三档；功能审计补全；SEO 营销落地页 + nginx 四路布局部署优化 |
 | 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 管理 + 客户挖掘联系人提取 |