# LegalFlow V2 — PRD 补丁文档

> 版本：Patch v1.0
> 生成时间：2026-04-26
> 基于：legalflow-v2__prd__20260424-1522.md
> 补丁依据：Reddit 实际运营数据 + 用户互动分析
>
> 本文件是对原 PRD 的增量修订，不替换原文件。开发时以本文档中的补丁内容为准，覆盖原 PRD 对应章节。

---

## Patch 1 — Dashboard 首屏信息架构调整（Module B）

**原始 PRD §3 Module B 描述：**
> 律师视角：今日待办、即将到期案件、未计时提醒、未读通知

**问题：**
Reddit 运营数据显示，唯一获得真实用户互动的帖子（r/paralegal，4条回复，100%好评）以 deadline 计算痛点为核心钩子。builder story 和计费功能帖均被删。用户的情绪切入点是 **"截止日期漏掉就是职业事故"**，而非计费。

**补丁内容：调整 Dashboard 首屏信息优先级**

律师视角首屏卡片顺序变更：

| 顺序 | 原版 | 补丁版 |
|------|------|--------|
| 1st | 今日待办 | **⚠️ 截止日期警报（逾期/24h内）** |
| 2nd | 即将到期案件 | **📅 本周截止日期（按风险着色）** |
| 3rd | 未计时提醒 | 未计时工时提醒 |
| 4th | 未读通知 | 今日待办 + 未读通知 |

**设计规则：**
- 截止日期状态用颜色编码：🔴 逾期 / 🟡 24h内 / 🟢 72h+
- "今日无截止日期警报"时显示大绿色状态卡（给律师安全感）
- 计时器快捷入口保留在右上角，不从首屏移除

**受影响文件：**
```
app/dashboard/page.tsx — 卡片顺序和权重
app/api/dashboard/stats/route.ts — 截止日期风险统计优先计算
components/dashboard/DeadlineAlertCard.tsx — 新增组件
```

**Acceptance Criteria（新增）：**
- 有逾期/24h内截止日期时，用户进入 Dashboard 3秒内即可看到警报卡片
- 警报卡片点击直接进入案件详情的截止日期 tab
- 无警报时，显示"All clear — no deadlines due in 24h"绿色状态横幅

---

## Patch 2 — Onboarding 引导流程（新增模块）

**原始 PRD：** 无 Onboarding 相关内容

**问题：**
Reddit 上用户看到的是 deadline 工具的讨论（定价 $29 的窄工具），点进来发现是全套平台（$39-99/user）。预期错位会导致注册流失。需要引导流程把"来自 deadline 痛点的用户"转化为全平台用户。

**补丁内容：5步 Onboarding Wizard（注册后首次进入触发）**

```
Step 1 — 角色确认（30秒）
  → "What best describes you?" [律师 / 合伙人 / 助理 / 行政]
  → 根据角色预设 Dashboard 视角

Step 2 — 创建第一个案件（60秒）
  → 引导填写：案件名称、客户名称、案件类型
  → 自动创建示例联系人

Step 3 — 设置第一个截止日期（60秒）
  → 引导设置截止日期 + 开启提醒
  → 展示 deadline 计算结果（让用户立即感受核心价值）
  → Copy: "You just avoided your first missed deadline."

Step 4 — 邀请团队成员（可跳过）
  → 单人用户可跳过，律所用户引导邀请

Step 5 — 探索其他功能（功能地图）
  → 展示：时间计费、文档管理、客户门户
  → 每个功能附一句话价值说明
  → CTA: "Start Free Trial" / "Explore Now"
```

**设计规则：**
- 总时长控制在 3 分钟内完成
- 每步右侧展示该步骤的实际界面截图/预览
- 可在任意步骤跳过进入完整界面
- 完成 Onboarding 后显示"Setup complete 🎉"并打点

**受影响文件（新增）：**
```
app/onboarding/page.tsx — Onboarding Wizard 主页面
app/onboarding/steps/ — 5步组件
  ├── Step1Role.tsx
  ├── Step2CreateCase.tsx
  ├── Step3SetDeadline.tsx
  ├── Step4InviteTeam.tsx
  └── Step5Explore.tsx
app/api/onboarding/complete/route.ts — 完成标记 + 分析打点
lib/onboarding/progress.ts — 进度追踪逻辑
middleware.ts — 新用户首次进入自动重定向到 /onboarding
```

**数据模型补丁（users 表新增字段）：**
```sql
ALTER TABLE users ADD COLUMN onboarding_completed_at TIMESTAMP;
ALTER TABLE users ADD COLUMN onboarding_step INT DEFAULT 0;
```

**Acceptance Criteria：**
- 新注册用户首次进入自动跳转 /onboarding
- 完成 Step 3（设置截止日期）后用户必须能看到系统计算出的 deadline 提醒
- 完成全部 5 步后，onboarding_completed_at 打时间戳，不再重复触发
- 跳过 Onboarding 的用户在 Dashboard 顶部显示"Complete your setup"横幅（可关闭）

---

## Patch 3 — Beta 用户反馈机制（M3 新增）

**原始 PRD §10 M3：** 无用户反馈收集相关内容

**问题：**
Reddit 上已有 1 位潜在 beta 用户（Gr8Autoxr）等待体验，且 V2 内容包里有 beta 邀请计划。但 PRD 里没有任何机制收集 beta 反馈，无法形成迭代闭环。

**补丁内容：轻量 Beta Feedback Widget**

**实现方案（自建，不依赖 Intercom）：**

1. **应用内反馈入口**
   - 每个页面右下角固定「💬 Feedback」悬浮按钮（beta 期用户可见）
   - 点击弹出简短表单：
     - "What were you trying to do?" （文本，必填）
     - "Did it work?" （Yes / Mostly / No，必填）
     - "Anything else?" （文本，可选）
   - 提交后立即回复："Thanks! We read every message."

2. **Beta 用户标记机制**
   - users 表新增 `is_beta BOOLEAN DEFAULT FALSE`
   - Admin 可在后台手动标记 beta 用户
   - beta 用户 Dashboard 顶部显示"You're a beta tester 🧪 Help us improve"横幅

3. **反馈汇总（管理员后台）**
   - `/admin/feedback` — 查看所有反馈条目
   - 支持按页面、按评级、按日期过滤
   - 导出 CSV

4. **定期 NPS 触发**
   - 用户使用满 7 天后，下次登录时弹一次 NPS 问卷（0-10分）
   - 之后每 30 天触发一次（如用户未主动关闭）

**受影响文件（新增，归入 M3）：**
```
components/feedback/FeedbackWidget.tsx — 悬浮按钮 + 表单
app/api/feedback/route.ts — 提交存储
app/admin/feedback/page.tsx — 管理员查看页面
lib/feedback/nps.ts — NPS 触发逻辑
```

**数据模型（新增 feedback_entries 表）：**
```sql
CREATE TABLE feedback_entries (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  user_id UUID REFERENCES users(id),
  page_url TEXT,
  intent TEXT NOT NULL,
  rating TEXT CHECK (rating IN ('yes', 'mostly', 'no')),
  comment TEXT,
  nps_score INT CHECK (nps_score BETWEEN 0 AND 10),
  created_at TIMESTAMP DEFAULT NOW()
);
```

**Acceptance Criteria：**
- Beta 用户在任意页面可打开反馈表单，提交后 <2秒 完成
- 管理员可在 /admin/feedback 查看全部反馈
- 7天后自动弹 NPS 弹窗，用户可永久关闭
- 每条反馈自动附带页面 URL 和用户 ID，便于定位问题

---

## Patch 4 — 定价策略锁定与统一

**原始 PRD §12 定价：** $39/user/month（Starter）/ $69/user/month（Professional）/ $99/user/month（Enterprise）

**问题：**
目前存在三套定价表述：
- V1 Reddit 帖子：$29/user（已发出，无法修改）
- V2 Reddit 内容包：$39/user（待发）
- PRD：$39 / $69 / $99

**补丁决策：**

| Plan | 价格 | 包含内容 | 备注 |
|------|------|---------|------|
| **Solo** | $29/user/mo | 案件管理 + 截止日期 + 证据链（V1 功能集） | 兼容旧帖表述，给老用户一个入口 |
| **Starter** | $39/user/mo | Solo + 时间计费 + 发票 + 文档管理 | V2 核心功能 |
| **Professional** | $69/user/mo | Starter + 客户门户 + 报表 + Google Calendar 同步 | 律所首选 |
| **Enterprise** | $99/user/mo | Professional + SSO + 审计日志 + 专属支持 | 大型律所 |

**Solo Plan 定位：**
- 专门为"从 Reddit 旧帖点进来的用户"设计的入门层
- 免费试用 14 天后转 $29/mo
- 后台统计 Solo 用户功能使用率，触发升级提示

**受影响文件：**
```
app/settings/billing/page.tsx — 定价展示页面
app/api/billing/plans/route.ts — Plan 配置
lib/billing/feature-gates.ts — 按 Plan 控制功能访问
```

---

## M1 Exit Criteria 补丁

在原 M1 Exit Criteria 后追加：

> - Onboarding Wizard 完整流程可走通（Step 1-5 全部可交互，数据可保存）
> - 新注册用户首次登录自动重定向到 /onboarding

## M3 Exit Criteria 补丁

在原 M3 Exit Criteria 后追加：

> - Beta Feedback Widget 在所有页面可见并可提交
> - 管理员可通过 /admin/feedback 查看全部反馈条目
> - 定价页面展示 4 个 Plan（Solo / Starter / Professional / Enterprise），feature gate 按 Plan 控制

---

## 补丁优先级总结

| 补丁 | 优先级 | 纳入 Milestone |
|------|--------|---------------|
| Patch 1 — Dashboard 首屏 deadline 优先 | 🔴 P0 | M3（Dashboard 阶段实现） |
| Patch 2 — Onboarding Wizard | 🔴 P0 | M1（随注册流程一起上） |
| Patch 3 — Beta Feedback Widget | 🟡 P1 | M3（beta 期收集反馈） |
| Patch 4 — 定价 Solo Plan | 🟡 P1 | M2（随计费模块一起上） |

---

*本补丁基于 Reddit 社区真实用户数据驱动，非主观假设。*