# Certified Immigration Translation Compliance — Lean MVP PRD

> **版本：** v1（首次生成）
> **生成时间：** 2026-05-07 10:10
> **Source:** `ScoredDemands/immigration-visa-doc-automation__scored-demand__20260506-1220.md`
> **Score:** 32/40 · **Decision:** BUILD

---

## 1. Problem & User

**Target User:** 小型移民文件翻译机构（1-10 人）及独立认证译员，为客户处理 USCIS/移民签证提交的认证翻译件。

**Core Pain:** 现有通用翻译平台（Smartcat、DeepL）不支持移民认证翻译的合规要求：USCIS 规定认证翻译必须包含译员声明、签名、日期、联系信息，且格式必须符合具体申请类型。机构目前手工拼接 Word 模板 + PDF，出错率高、审计记录缺失，一旦被 USCIS 退件损失极大。

**User Quote:** "Most AI translation tools are going to cause serious problems for the agencies using them."

---

## 2. Target Outcome & KPIs

| KPI | 目标值（90天） |
|-----|--------------|
| 案件完成率（创建→下载认证PDF） | ≥ 80% |
| 试用→付费转化率 | ≥ 12% |
| 首次使用 Aha Moment 时间 | ≤ 5 分钟 |
| 月活跃机构数 | ≥ 30 |

**Aha Moment：** 用户上传一份出生证明图片，填写基本信息，5 分钟内下载到带有认证声明的完整 PDF 包——第一次就看到符合 USCIS 要求的成品。

---

## 3. MVP Scope（In）

- 案件管理：创建/查看/归档认证翻译案件
- 文件上传：源文件（PDF/图片）上传至 Supabase Storage
- 翻译编辑：纯文本翻译编辑区（可选 AI 草稿，标注"仅供参考"）
- 审核清单：译员和审核人逐项签核 checklist
- 证书生成：USCIS 标准认证声明模板（含译员姓名、签名块、日期、联系方式）
- 审计日志：每步操作时间戳记录
- PDF 导出：翻译正文 + 认证页 + 审计摘要打包下载
- Stripe 订阅：$49/月（25 案件 / 3 用户），超额 $0.75/案件

---

## 4. Out of Scope（明确排除）

- 原生移动 App
- 完整 CAT 工具（翻译记忆库、术语库同步）
- 非 USCIS 司法管辖区的证书模板（v2 再扩展）
- 企业级 SSO / SOC2 合规
- 自动从 USCIS 门户拉取案件状态
- 公证翻译（需公证人参与的流程）

---

## 5. User Flow（Happy Path）

```
1. 注册（邮箱 + 机构名）→ 自动进入免费试用（5 案件上限）
2. 仪表盘 → 点击「New Case」
3. 填写：文件类型（出生证明/婚姻证明/驾照等）、语言对、申请人姓名
4. 上传源文件（PDF/JPG/PNG，≤20MB）
5. 进入翻译编辑页 → 可选「AI 草稿」（OpenAI 生成，标注仅供参考）→ 编辑确认
6. 审核 checklist：
   - □ 姓名/日期拼写与原件一致
   - □ 官方机构名称翻译正确
   - □ 文件号码完整
   - □ 译员已确认完整准确
7. 填写译员信息（姓名、资质声明、联系方式）→ 点击「Generate Certificate」
8. 预览 PDF：第一页翻译正文 + 最后一页 USCIS 认证声明
9. 下载 ZIP（源文件 + 翻译 PDF + 审计日志 PDF）
10. ──── 付费墙触发 ────
    第 6 个案件创建时 → 弹出升级提示 + 自动触发邮件序列
```

**付费墙触发事件：** `case.created` 且 `org.free_cases_used >= 5`

---

## 6. Functional Requirements（P0）

### 认证与账户
- P0-1：邮箱注册 / 登录（Supabase Auth）
- P0-2：机构工作区，支持邀请 ≤3 名用户（免费层）

### 案件核心流程
- P0-3：创建案件（文件类型、语言对、申请人姓名、上传源文件）
- P0-4：翻译编辑器（textarea，支持粘贴，可选 OpenAI 草稿按钮）
- P0-5：审核 checklist（5 项固定检查点，全勾选才能进入证书生成）
- P0-6：USCIS 证书模板渲染（译员声明、机构信息、时间戳）
- P0-7：PDF 生成（puppeteer/pdf-lib）并打包 ZIP 下载
- P0-8：审计事件写入（case_id, user_id, action, timestamp）

### 计费
- P0-9：Stripe Checkout Session 创建（`/api/billing/subscribe`）
- P0-10：Webhook 处理 `checkout.session.completed` → 更新 `subscriptions` 表
- P0-11：免费层限额检查中间件（≥6 案件跳转付费页）

### Onboarding（无人工介入）
- P0-12：注册后自动发送欢迎邮件（Resend），含「创建第一个案件」按钮
- P0-13：仪表盘首次访问显示 3 步引导提示（tooltip tour）

### 自动化邮件序列（付费转化）
| 触发 | 邮件 | 时机 |
|------|------|------|
| 免费第 4 案件完成 | "你已完成 4/5 个免费案件，升级后无限使用" | 即时 |
| 免费限额触发 | "你的第 6 个案件需要升级" + CTA | 即时 |
| 触发后 48h 未付费 | "移民机构平均每月处理 X 案件，$49 相当于每案 $2" | +48h |

---

## 7. Minimal Data Model

```sql
-- 核心表（Supabase PostgreSQL）
organizations (id, name, owner_id, plan, free_cases_used, created_at)
users (id, email, org_id, role[owner|member], created_at)
cases (id, org_id, created_by, doc_type, lang_pair, applicant_name,
       source_file_url, translation_text, checklist_completed_at,
       certificate_url, zip_url, status[draft|reviewed|exported], created_at)
certificates (id, case_id, translator_name, translator_contact,
              certification_statement, signed_at, pdf_url)
audit_events (id, case_id, user_id, action, metadata, created_at)
subscriptions (id, org_id, stripe_customer_id, stripe_sub_id,
               plan, status, current_period_end)
```

---

## 8. API / Integration Notes

| 服务 | 用途 | 说明 |
|------|------|------|
| Supabase Auth | 认证 | JWT，Row Level Security |
| Supabase Storage | 文件存储 | `source-docs/` + `exports/` bucket |
| OpenAI GPT-4o-mini | AI 草稿（可选） | 仅在用户点击时调用，标注"仅供参考" |
| pdf-lib / puppeteer | PDF 生成 | 服务端渲染证书模板 |
| Stripe | 订阅计费 | Checkout + Webhook |
| Resend | 事务邮件 | 欢迎邮件 + 转化序列 |

---

## 9. Acceptance Criteria（可验证）

| # | 测试场景 | 期望结果 |
|---|----------|----------|
| AC-1 | 新用户注册 + 完成第 1 个案件 | ≤5 分钟；下载 ZIP 包含翻译 PDF + 认证页 + 审计日志 |
| AC-2 | checklist 未全部勾选时点击「Generate Certificate」 | 按钮禁用，显示错误提示 |
| AC-3 | 免费层创建第 6 个案件 | 跳转 Stripe Checkout，`POST /api/billing/subscribe` 返回 200 |
| AC-4 | Stripe Webhook `checkout.session.completed` | `subscriptions.status = active`，机构 `plan = pro` |
| AC-5 | 3 名用户邀请后第 4 名受邀 | 返回 403 "Free plan supports 3 users" |
| AC-6 | PDF 生成包含 USCIS 必要字段 | 认证页含：译员姓名、联系方式、声明文字、日期、机构名 |

---

## 10. Delivery Plan

### M1 — 数据层 + 认证（Day 1 上午）

**文件：**
- `prisma/schema.prisma`（或 `supabase/migrations/001_init.sql`）
- `lib/supabase.ts`（客户端 + 服务端 client）
- `app/api/cases/route.ts`（GET list, POST create）
- `app/api/cases/[id]/route.ts`（GET detail, PATCH update）

**Exit Criteria：**
- `POST /api/cases` 返回 201，body 含 `id`
- `GET /api/cases` 返回空数组（已认证用户）
- 未认证请求返回 401

### M2 — 核心业务流程（Day 1 下午 ~ Day 2 上午）

**文件：**
- `app/dashboard/page.tsx`（案件列表 + New Case 按钮）
- `app/cases/new/page.tsx`（创建表单 + 文件上传）
- `app/cases/[id]/translate/page.tsx`（翻译编辑器 + AI 草稿按钮）
- `app/cases/[id]/review/page.tsx`（审核 checklist）
- `app/cases/[id]/certificate/page.tsx`（证书预览 + 下载）
- `app/api/cases/[id]/generate-pdf/route.ts`（PDF 生成 + ZIP 打包）
- `app/api/billing/subscribe/route.ts` + `app/api/billing/webhook/route.ts`
- `lib/pdf.ts`（USCIS 证书模板渲染）
- `lib/stripe.ts`

**Exit Criteria：**
- 完整 happy path 可跑通：注册 → 创建案件 → 编辑 → 审核 → 下载 ZIP
- Stripe test mode 支付成功，`subscriptions` 表状态变为 `active`
- 免费限额中间件：第 6 案件重定向到 `/billing`

### M3 — Onboarding + 邮件序列 + 上线（Day 2 下午）

**文件：**
- `lib/email.ts`（Resend 封装）
- `app/api/onboarding/welcome/route.ts`（注册 webhook 触发）
- `components/OnboardingTour.tsx`（3 步 tooltip）
- `app/api/cases/[id]/route.ts`（补充免费案件计数逻辑）
- `.github/workflows/deploy.yml` 或 Vercel 配置

**Exit Criteria：**
- 新注册用户收到欢迎邮件（Resend dashboard 可见）
- 第 4 案件完成后触发升级提示邮件
- Vercel / Railway 部署成功，`/health` 返回 200

---

## 11. Risks & Mitigations

| 风险 | 影响 | 缓解 |
|------|------|------|
| PDF 生成性能慢（puppeteer 冷启动） | 用户等待下载 | 改用 `pdf-lib` 纯 JS 方案，无需 headless browser |
| USCIS 认证要求变化 | 证书格式失效 | 证书模板存数据库，可热更新，无需重新部署 |
| AI 草稿误译被用户当作终稿提交 | 客户 USCIS 退件 | UI 强制显示"AI 仅供参考"banner，checklist 含"已人工审核翻译"一项 |
| 免费层被滥用（用多个邮箱注册） | 付费转化率下降 | 可选：机构域名邮箱验证；优先观察，再限制 |
| Scope Creep | 超出 20h 预算 | 任何新需求必须替换现有 P0 项，不得叠加 |

---

## 12. Chargeability Rationale

**免费版提供的价值（让用户上瘾）：**
- 5 个案件完整走通全流程，包括 AI 草稿 + 认证 PDF 下载
- 用户在付费前已亲眼看到"符合 USCIS 要求的成品"

**付费版扩展的价值（让用户升级）：**
- 无限案件数量
- 3 名以上用户协作
- 审计日志历史归档（免费版 30 天）
- 未来：多司法管辖区模板（加拿大、英国）

**定价：** $49/月（25 案件 / 3 用户）；$0.75/超额案件  
**付费墙时机：** 第 6 个案件创建时触发——此时用户已充分验证价值，转化意愿最强。

**一句话：** 用户每次使用都在规避 USCIS 退件风险（退件平均损失 $200-500 + 数周时间），$49/月 的合规保险对任何正经机构都是毫无争议的必要支出。