# PRD: 外贸询盘智能推荐客服工作台

> **版本：** v1（基于 ScoredDemand 初次生成）
> **时间：** 2026-05-12
> **评分：** 30/40 — BUILD

---

## 1. Problem & User

**目标用户：** 外贸物流中介业务员与中介老板，5 人以下小团队。

**核心痛点：** 收到询盘后，业务员需要人工查找供应商报价、撰写英文回复，同时还要控制哪些供应商信息可以暴露给客户。随着百度/阿里国际站让买家可自行搜索更多供应商，中介的信息差优势在快速流失，却没有工具帮助业务员重构差异化价值。

**用户痛言：** "竞争者可以通过百度搜到更多供应商，信息优势在流失"

**为什么现有方案不够：** CRM 太重，通用 AI 没有供应商库，阿里国际站生态会直接暴露供应商联系方式——没有工具能同时做到"供应商匹配 + 信息分级展示 + 英文回复生成"。

---

## 2. Target Outcome & KPIs

- **主要 KPI：** 询盘响应时间从 30-60 分钟压缩到 10 分钟内
- **次要 KPI：** 每位业务员日均可处理询盘数量提升 2x
- **PLG 转化 KPI：** 首次生成回复后 7 天内付费率 ≥20%

---

## 3. MVP Scope (In)

- 供应商库 CSV 导入（字段：品类关键词、价格区间、MOQ、交期、认证、国家、是否可公开展示）
- 粘贴客户询盘邮件 → AI 自动提取结构化需求（产品、数量、目的国、预算、认证需求）
- 匹配供应商 + 生成英文/中文回复草稿
- "客户可见版"与"内部完整版"双视图（客户版隐藏工厂全名、联系方式、底价）
- 询盘列表管理
- 免费额度：每月 10 次询盘处理，付费墙触发后 Stripe 订阅

---

## 4. Out of Scope

- 邮箱系统直连（IMAP 集成）
- 多模型训练或 Fine-tuning
- 自动爬虫采集供应商数据
- 复杂审批工作流
- 移动端 App

---

## 5. User Flow（Aha Moment 路径）

**注册后 5 分钟内触达价值：**

1. **注册** → 引导页："导入你的供应商库"
2. **上传 CSV**（系统提供模板下载，<1 分钟完成导入）
3. **新建询盘** → 粘贴客户邮件文本（<30 秒）
4. **等待 ~30 秒** → 系统展示：匹配供应商列表 + 可发送英文回复草稿
5. **Aha Moment：** 业务员看到"客户可见版"——干净的推荐列表，不暴露工厂联系方式
6. **复制草稿发给客户** → 询盘记录自动保存
7. **第 11 次询盘** → 付费墙弹出

---

## 6. Functional Requirements (P0)

**供应商库：**
- `POST /api/suppliers/import` — CSV 解析 + 存入 Supabase
- 字段：name（内部用）, display_name（客户可见）, keywords[], price_range, moq, lead_time, certifications[], country, is_public
- 供应商列表 CRUD 页面

**询盘处理：**
- `POST /api/inquiries` — 存储原始询盘文本
- `POST /api/inquiries/:id/process` — 调用 OpenAI：
  - Step 1：从询盘文本中提取结构化需求 JSON
  - Step 2：基于需求 + 供应商库生成推荐列表 + 英文/中文回复草稿
- 结果存入 `inquiry_results` 表

**双视图展示：**
- 内部视图：完整供应商信息 + 建议报价
- 客户视图：隐藏 `name`、`contact`、`bottom_price`，只显示 `display_name`、`capabilities`、`price_range`
- "一键复制客户版"按钮

**Onboarding（零人工介入）：**
- 注册后预加载演示供应商库（5 条样本）
- 系统自动展示演示询盘处理结果，用户可直接看到价值

**付费墙：**
- 每账户每月免费处理 10 次询盘
- 第 11 次触发 Stripe Checkout（$29/月起步版）
- 触发后发送邮件："您刚处理了第 10 条询盘，升级解锁无限额度"

**自动化邮件序列：**
- Day 0：欢迎 + 快速导入供应商库指南
- Day 2：提示"您还有 X 次免费额度"
- Day 7：触发"分享给同事"裂变邮件

---

## 7. Data Model（Minimal）

```
users(id, email, company_name, plan, monthly_count, stripe_customer_id)
suppliers(id, user_id, name, display_name, keywords[], price_range, moq, lead_time, certifications[], country, is_public)
inquiries(id, user_id, raw_text, extracted_needs_json, status, created_at)
inquiry_results(id, inquiry_id, matched_suppliers[], draft_reply_en, draft_reply_zh, created_at)
```

---

## 8. API/Integration Notes

- **LLM：** OpenAI GPT-4o；Prompt 分两步（需求提取 → 回复生成），使用结构化输出
- **向量搜索：** pgvector（Supabase）做供应商关键词语义匹配；MVP 可先用关键词 ILIKE 匹配
- **支付：** Stripe Billing（$29/mo 起步版，$79/mo 专业版）
- **邮件：** Resend API

---

## 9. Acceptance Criteria

- [ ] 导入 5 行 CSV → 供应商列表页显示正确数据
- [ ] 粘贴含产品名/数量/目的国的询盘 → 30 秒内生成英文草稿 + 匹配 ≥1 个供应商
- [ ] 客户视图中 `name` 和联系方式字段不可见
- [ ] 第 11 次询盘 → Stripe Checkout 弹出并可完成支付
- [ ] 新用户注册 → 不上传 CSV 也能看到演示数据的询盘结果

---

## 10. Delivery Plan

### Milestone 1（Day 1-2）：供应商库 + 询盘处理管道
**文件：**
- `supabase/migrations/001_schema.sql` — 核心表结构
- `app/api/suppliers/import/route.ts` — CSV 解析
- `app/api/inquiries/route.ts` — 询盘 CRUD
- `lib/inquiry-processor.ts` — OpenAI 两步处理逻辑

**Exit Criteria：** `POST /api/inquiries/:id/process` → DB 中出现匹配供应商列表 + 英文草稿

### Milestone 2（Day 3-5）：双视图 UI
**文件：**
- `app/suppliers/page.tsx` — 供应商管理页
- `app/inquiries/page.tsx` — 询盘列表
- `app/inquiries/[id]/page.tsx` — 处理结果页（内部/客户双视图 tab）
- `components/DualViewToggle.tsx` — 视图切换组件

**Exit Criteria：** 在内部视图能看到工厂全名，切换客户视图后工厂全名消失，"复制"按钮复制客户版文本

### Milestone 3（Day 6-7）：PLG + 支付 + 引导
**文件：**
- `app/api/stripe/checkout/route.ts`
- `app/api/stripe/webhook/route.ts`
- `lib/quota.ts` — 月度计数
- `lib/email.ts` — Resend 序列
- `app/onboarding/page.tsx` — 演示数据引导

**Exit Criteria：** 第 11 次处理 → Stripe Checkout → 支付成功 → quota 重置 → Day 0 邮件发送

---

## 11. Risks & Mitigations

| 风险 | 缓解措施 |
|------|----------|
| LLM 生成回复质量不稳定 | 提供"重新生成"按钮 + 用户可手动编辑草稿 |
| 供应商库格式差异大 | 提供标准 CSV 模板下载，MVP 只支持标准格式 |
| 客户数据安全顾虑 | 所有数据隔离（Row Level Security），明确 ToS |
| 竞争对手 ChatGPT 免费替代 | 差异化：有供应商库 + 双视图信息控制，这是通用 AI 没有的 |

---

## 12. Chargeability Rationale

**免费版：** 每月 10 次询盘处理，让业务员真实体验 10 分钟内完成供应商匹配 + 英文草稿的效率提升。

**付费版（$29/月起）：** 无限询盘 + 多成员席位 + 自定义供应商展示模板；对月均处理 20+ 询盘的团队，只要多成交 1 单即覆盖全年订阅成本，ROI 明确。

**付费墙触发时机：** 第 11 次询盘——用户已导入供应商库、建立了工作流依赖，替换成本远高于 $29/月。