feat: 修复 H5 底部导航覆盖 + 更新项目进度文档

## H5 底部导航修复 (Bug #10) - 精简 App.vue，移除重复 tabbar，仅保留全局样式 - uni-page 设置 height: calc(100% - 50px) + overflow-y: auto - 内容区域精确停在底部导航上方，独立滚动不再叠加 - 恢复 custom-tab-bar 组件 ## 项目进度文档 - PROGRESS.md 更新至 10 个 Bug 修复 - 新增 H5 底部导航修复记录 - 新增历史变更条目
2026-05-12 20:24:42 +08:00
parent 69e164dcae
commit 7b62c2f8b4
125 changed files with 19725 additions and 728 deletions
@@ -1,8 +1,8 @@
 # 外贸小助手 (TradeMate) — 产品设计文档

-> 版本: v1.0
-> 创建日期: 2026-05-08
-> 状态: 初始设计
+> 版本: v1.1
+> 创建日期: 2026-05-10
+> 状态: V2 规划中

 ---

@@ -39,23 +39,35 @@
 ### 2.1 功能全景图

 ```
-┌─────────────────────────────────────────────────────┐
-│                    外贸小助手                         │
-│                                                      │
-│  ┌──────────┐  ┌──────────┐  ┌──────────┐           │
-│  │ 营销素材  │  │ 智能沟通  │  │ 客户跟进  │          │
-│  │ 工厂     │  │ 助手     │  │ 引擎     │           │
-│  ├──────────┤  ├──────────┤  ├──────────┤           │
-│  │ 开发信   │  │ 消息翻译  │  │ 沉默检测  │          │
-│  │ 产品文案  │  │ 回复建议  │  │ 跟进提醒  │          │
-│  │ 关键词   │  │ 一键发送  │  │ 话术推荐  │          │
-│  │ 竞品分析  │  │ 语气调整  │  │ 周期提醒  │          │
-│  └──────────┘  └──────────┘  └──────────┘           │
-│                                                      │
-│  ┌─────────────────────────────────────────┐         │
-│  │  跨功能支撑: 报价单生成 / 汇率换算      │         │
-│  └─────────────────────────────────────────┘         │
-└─────────────────────────────────────────────────────┘
+┌─────────────────────────────────────────────────────────────────┐
+│                        外贸小助手 V2                              │
+│                                                                  │
+│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌────────────────┐  │
+│  │ 营销素材  │  │ 智能沟通  │  │ 客户跟进  │  │ 智能决策中心   │  │
+│  │ 工厂     │  │ 助手     │  │ 引擎     │  │ (新增)         │  │
+│  ├──────────┤  ├──────────┤  ├──────────┤  ├────────────────┤  │
+│  │ 开发信   │  │ 消息翻译  │  │ 沉默检测  │  │ 健康度看板    │  │
+│  │ 产品文案  │  │ 回复建议  │  │ 跟进提醒  │  │ 客户评分      │  │
+│  │ 关键词   │  │ 语气调整  │  │ 话术推荐  │  │ 行动建议      │  │
+│  │ 竞品分析  │  │ TTS播放  │  │ 周期提醒  │  │ 趋势预警      │  │
+│  └──────────┘  └──────────┘  └─────┬────┘  └────────────────┘  │
+│                                     │                            │
+│  ┌──────────────────────────────────┼──────────────────────────┐ │
+│  │  AI智能跟进助手 (新增)           │                          │ │
+│  │  ┌─ 时机判断 ─ 内容生成 ─ 渠道选择 ─ 效果追踪 ─┐          │ │
+│  │  └──────────────────────────────────────────────┘          │ │
+│  └──────────────────────────────────┬──────────────────────────┘ │
+│                                     │                            │
+│  ┌──────────────────────────────────┼──────────────────────────┐ │
+│  │  智能市场机会分析 (新增)         │                          │ │
+│  │  ┌─ 趋势分析 ─ 客户发现 ─ 竞争情报 ─ 策略报告 ─┐          │ │
+│  │  └──────────────────────────────────────────────┘          │ │
+│  └─────────────────────────────────────────────────────────────┘ │
+│                                                                  │
+│  ┌──────────────────────────────────────────────────────────┐   │
+│  │  跨功能支撑: 报价单生成 / 汇率换算 / 合规筛查 / 文档模板 │   │
+│  └──────────────────────────────────────────────────────────┘   │
+└─────────────────────────────────────────────────────────────────┘
 ```

 ### 2.2 功能一：营销素材工厂（帮用户"有内容可发"）
@@ -174,6 +186,154 @@
  - 用户确认 → 生成正式报价单图片 → 一键发送
 ```

+### 2.6 功能四：客户健康度看板（帮用户"一眼看清该追谁"）
+
+#### 用户场景
+> "我有50多个客户，除了最近联系的那几个，其他谁在流失、谁快成交了，我心里完全没数。"
+
+#### 交互流程
+
+```
+[用户打开小程序]
+  └─ 点击"客户" → 顶部展示健康度总览卡片:
+       ├─ 🟢 活跃客户: 12
+       ├─ 🟡 需关注: 5
+       ├─ 🔴 高危流失: 3
+       └─ 📊 整体健康趋势（本周 vs 上周）
+
+[点击具体客户]
+  └─ 进入客户详情 → 健康度看板:
+       ├─ 综合评分: 78/100（评分趋势 ↑↓）
+       ├─ 评分维度明细:
+       │   ├─ 📈 响应趋势: +15%（回复速度在变快）
+       │   ├─ 💬 情感轨迹: 正面（AI分析最近3条消息）
+       │   ├─ 📋 询盘深度: "问了MOQ和认证"（成交信号）
+       │   ├─ ⏰ 沉默天数: 3天
+       │   └─ 💰 预估价值: $12,500
+       └─ 🎯 系统建议动作:
+            "客户问过MOQ和认证，建议明天发认证证书和报价单跟进"
+```
+
+#### 核心机制
+
+- **评分透明可解释**: 不像竞品黑盒打分，每个维度都有来源和原因
+- **多维度融合**: 响应趋势 + 情感分析 + 行为信号 + 沉默天数 + 商业价值
+- **Actionable**: 不只是分数，而是"到底是什么问题 + 建议怎么做"
+
+#### 数据来源（全在现有数据库里，无需外部API）
+
+| 维度 | 数据源 | 现有字段 |
+|------|--------|---------|
+| 响应趋势 | messages | created_at, direction |
+| 情感轨迹 | messages | content（AI分析） |
+| 询盘深度 | messages | content（关键词匹配） |
+| 沉默天数 | customers | last_contact_at |
+| 商业价值 | quotations | total, status |
+
+### 2.7 功能五：AI智能跟进助手（帮用户"知道什么时候跟、怎么跟"）
+
+#### 用户场景
+> "报完价客户就没消息了，我不知道该不该发消息、什么时候发、发什么内容合适。"
+
+#### 交互流程
+
+```
+[系统自动运行]
+  └─ AI 持续评估每个客户的跟进状态:
+       ├─ 每个客户生成"最优跟进时机"（基于历史互动模式）
+       ├─ 不同客户不同策略:
+       │   ├─ 客户A（沉默3天，之前聊报价）: "建议今晚8点WhatsApp发认证资料"
+       │   ├─ 客户B（沉默7天，之前聊样品）: "建议邮件发新品目录 + 限时折扣"
+       │   └─ 客户C（回盘积极，在比价）: "客户可能在对比，建议3天后主动降价5%"
+       └─ 系统主动推送通知:
+            "📌 跟进提醒: 客户Carlos沉默4天，最优跟进窗口还剩2天"
+
+[用户点击提醒]
+  └─ 进入跟进界面:
+       ├─ 客户背景摘要（快速回顾）
+       ├─ AI推荐的跟进内容（基于上次对话定制）
+       ├─ 选择渠道: WhatsApp / Email / 电话
+       └─ 一键发送 / 编辑后发送
+
+[发送后]
+  └─ 自动打标: "已跟进" → 继续监控客户反应
+  └─ 若3天内客户回复 → 标记"跟进成功" → 更新评分
+  └─ 若客户未回复 → 自动调整下一次跟进策略
+```
+
+#### 核心机制
+
+- **不是固定时间间隔**: 竞品用3/7/14天固定规则，AI根据客户状态动态判断
+- **多渠道选择**: 根据客户历史偏好推荐最佳渠道
+- **内容个性化**: 每次跟进都基于上次对话 + 产品库 + 市场信息生成
+- **闭环追踪**: 跟进→回复（或不回复）→调整策略
+
+#### 对比竞品
+
+| 维度 | 竞品 EDM 序列 | TradeMate AI 跟进 |
+|------|-------------|------------------|
+| 触发方式 | 预设时间（3/7/14天） | AI动态评估最佳时机 |
+| 内容 | 模板化 | 每次个性化生成 |
+| 渠道 | 仅邮件 | WhatsApp/邮件/电话 |
+| 适应性 | 固定流程 | 根据客户反应自动调整 |
+| 成本 | 邮件服务费 | 现有AI能力，零新增成本 |
+
+### 2.8 功能六：智能市场机会分析（帮用户"找到该开发哪个市场"）
+
+#### 用户场景
+> "我想开发新市场，但不知道哪个国家对我的产品需求大、竞争情况怎么样、应该怎么切入。"
+
+#### 交互流程
+
+```
+[用户输入产品信息]
+  └─ 点击"市场分析"
+  └─ AI 自动执行:
+       1. 调取免费国际贸易统计数据分析目标市场趋势
+       2. 搜索公开B2B平台/行业黄页发现潜在客户
+       3. 分析目标市场竞争格局和定价
+       4. 生成市场进入策略报告
+
+[用户收到报告]
+  ┌─────────────────────────────────────┐
+  │   📊 户外折叠椅 · 市场机会报告       │
+  │                                      │
+  │   🎯 推荐市场 Top 3:                  │
+  │   1. 美国 (+23% 进口增长) — 建议主攻  │
+  │   2. 德国 (+15%) — 中高端定位         │
+  │   3. 东南亚 (+40% 增长快速) — 建议布局 │
+  │                                      │
+  │   👥 潜在客户示例:                     │
+  │   · OutdoorLiving Inc. (美国)         │
+  │   · GartenPro GmbH (德国)             │
+  │   · CampingZone (东南亚)              │
+  │                                      │
+  │   💡 进入策略建议:                     │
+  │   · 美国: 侧重防水+承重卖点            │
+  │   · 德国: 强调环保认证                │
+  │   · 东南亚: 主打性价比                │
+  └─────────────────────────────────────┘
+
+[用户下一步]
+  └─ 点击"生成开发信" → AI 自动适配目标市场的文化习惯生成文案
+  └─ 保存报告到产品库 → 随时查阅
+```
+
+#### 核心机制
+
+- **零数据采购成本**: 使用免费国际贸易统计 API + AI 搜索，不买海关数据
+- **海关数据竞品的问题**: 数据滞后3-6个月，只有提单记录无具体联系人
+- **我们的方案**: 不只告诉你"谁买了"，而是"怎么找到他们、怎么卖进去"
+
+#### 数据源
+
+| 数据源 | 用途 | 成本 |
+|--------|------|------|
+| UN COMTRADE / ITC TradeMap | 国际贸易统计数据 | 免费 |
+| Google Custom Search / SerpAPI | B2B平台/黄页公开数据 | 免费~$50/月 |
+| Wikipedia/OpenStreetMap | 国家基础信息 | 免费 |
+| AI 已有知识 | 市场策略、文化习惯 | 已有 |
+
 ---

 ## 三、用户旅程
@@ -222,11 +382,13 @@

 ## 五、护城河策略

-详见 `TECH_ARCHITECTURE.md` 第 5 章，核心三层：
+详见 `TECH_ARCHITECTURE.md` 第 5 章，核心五层：

 1. **外贸垂直语料库**：用户每次使用产生的翻译/回复数据，积累成行业专属语料
 2. **用户产品知识库**：产品信息+客户偏好+历史报价，迁移成本极高
 3. **沉默客户模式算法**：跨用户行为数据产生的预测能力，网络效应
+4. **客户健康度评分模型**：基于多维度行为数据的客户价值评估，用户用得越久模型越准
+5. **AI跟进策略引擎**：基于历史跟进成功率的学习模型，持续优化时机/内容/渠道

 ---

@@ -244,7 +406,8 @@

 | 阶段 | 时间 | 功能 |
 |------|------|------|
-| MVP | 第1-4周 | 智能翻译+回复建议+基础营销素材+产品库 |
-| V2 | 第5-8周 | 沉默客户跟进+WhatsApp集成+报价单生成 |
-| V3 | 第9-12周 | 语料库训练+回复质量优化+多人协作 |
-| V4 | 第13-16周 | 跨用户A/B测试+预测算法+API开放 |
+| MVP | 第1-4周 | 智能翻译+回复建议+基础营销素材+产品库 ✅ |
+| V2 | 第5-8周 | 沉默客户跟进+WhatsApp集成+报价单生成 ✅ |
+| V3 | 第9-12周 | 语料库训练+回复质量优化+多人协作 ✅ |
+| V4 | 第13-16周 | 跨用户A/B测试+预测算法+API开放 ✅ |
+| **V5** | **第17-20周** | **客户健康度看板+智能跟进助手+市场机会分析** |