需求文档的艺术 - 构建你的 MVP 知识蓝图

# 问题陈述

## 概述
[用 1-2 句话简要描述问题]

## 目标受众
[谁遇到这个问题？具体说明人口统计和心理特征]

## 痛点
1. [主要痛点]
2. [次要痛点]
3. [第三痛点]

## 当前解决方案
| 解决方案 | 局限性 | 用户挫败感 |
|---------|--------|----------|
| [选项 1] | [问题所在] | [用户感受] |
| [选项 2] | [问题所在] | [用户感受] |

## 影响
[如果这个问题不解决会发生什么？尽可能量化]

## 机会
[解决这个问题会带来什么机会？]

# 用户旅程：首次激活

## 旅程概述
- **画像**: 小陈（独立开发者）
- **场景**: 第一次使用平台
- **目标**: 获取第一个有价值的内容
- **时长**: 5-10 分钟

## 旅程阶段

### 阶段 1：发现
| 触点 | 行动 | 想法 | 情绪 | 机会 |
|-----|-----|-----|-----|-----|
| 谷歌搜索 | 搜索"MVP 部署指南" | "我需要部署我的应用" | 沮丧 | SEO 优化 |
| 落地页 | 看到标题和主视觉 | "这看起来相关" | 好奇 | 清晰的价值主张 |

### 阶段 2：评估
| 触点 | 行动 | 想法 | 情绪 | 机会 |
|-----|-----|-----|-----|-----|
| 内容预览 | 阅读博客摘要 | "这很实用" | 感兴趣 | 高质量内容示例 |
| 定价页 | 查看层级 | "值得吗？" | 谨慎 | 免费层级入口 |

### 阶段 3：注册
| 触点 | 行动 | 想法 | 情绪 | 机会 |
|-----|-----|-----|-----|-----|
| 注册 | 创建账户 | "让我试试" | 充满希望 | 无摩擦注册 |
| 确认 | 验证邮箱 | "又一步..." | 略微烦恼 | 魔法链接选项 |

### 阶段 4：首次价值
| 触点 | 行动 | 想法 | 情绪 | 机会 |
|-----|-----|-----|-----|-----|
| 仪表板 | 看到内容库 | "我从哪开始？" | 不知所措 | 引导指南 |
| 第一篇文章 | 阅读部署指南 | "这正是我需要的！" | 高兴 | 追踪参与度 |

## 识别的痛点
1. 注册过程步骤太多
2. 注册后没有明确的起点
3. 内容组织可以改进

## 建议
1. 实现社交登录选项
2. 添加个性化引导流程
3. 为新用户创建"从这里开始"指南

# 功能：付费内容访问

## 概述
付费内容访问允许订阅用户解锁并阅读免费用户无法访问的
付费文章、教程和指南。

## 业务背景
- **战略目标**: 产生经常性订阅收入
- **成功指标**: 5% 免费转付费转化率
- **优先级**: P0（MVP 必须有）
- **预估工作量**: 2 个冲刺

## 用户故事

### US-001：查看付费徽章
作为一个 **访客**，我想要 **看到哪些内容是付费的**
这样 **我可以了解订阅会得到什么价值**。

### US-002：升级提示
作为一个 **免费用户**，我想要 **在访问付费内容时看到清晰的升级提示**
这样 **我可以轻松转换为付费订阅**。

### US-003：访问付费内容
作为一个 **付费订阅者**，我想要 **无摩擦地立即访问付费内容**
这样 **我可以从订阅中获得价值**。

## 验收标准

### AC-001：付费徽章显示
- [ ] 付费内容显示可见的徽章/图标
- [ ] 徽章出现在内容列表中
- [ ] 徽章出现在单个内容页面上
- [ ] 徽章样式在整个平台上一致

### AC-002：访问控制
- [ ] 免费用户看到模糊/截断的付费内容
- [ ] 免费用户看到升级 CTA
- [ ] 付费用户立即看到完整内容
- [ ] 升级后不需要刷新页面

### AC-003：订阅检查
- [ ] 系统在每次请求时验证订阅状态
- [ ] 过期订阅无法访问付费内容
- [ ] 支付失败有 24 小时宽限期

# 技术架构概述

## 系统上下文

```plaintext
┌─────────────────────────────────────────────────────────────┐
│                        用户                                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐    │
│  │ 访客     │  │ 免费     │  │ 付费     │  │ 管理员   │    │
│  │          │  │ 会员     │  │ 会员     │  │          │    │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘    │
│       │             │             │             │           │
└───────┼─────────────┼─────────────┼─────────────┼───────────┘
        │             │             │             │
        └─────────────┴─────────────┴─────────────┘
                              │
                    ┌─────────▼─────────┐
                    │  CDN (Cloudflare) │
                    └─────────┬─────────┘
                              │
                    ┌─────────▼─────────┐
                    │   Next.js 应用    │
                    │   (Vercel)        │
                    └─────────┬─────────┘
                              │
         ┌────────────────────┼────────────────────┐
         │                    │                    │
┌────────▼────────┐ ┌────────▼────────┐ ┌────────▼────────┐
│   PostgreSQL    │ │   R2 存储       │ │   Stripe/       │
│   (数据库)      │ │   (文件)        │ │   Creem         │
└─────────────────┘ └─────────────────┘ └─────────────────┘

### 6.2 数据模型文档

<Files>
  <Folder name="technical" defaultOpen>
    <Folder name="data-models" defaultOpen>
      <File name="user.md" />
      <File name="subscription.md" />
      <File name="content.md" />
      <File name="analytics.md" />
    </Folder>
  </Folder>
</Files>

```md title="technical/data-models/user.md"
# 数据模型：用户

## 模式定义

| 字段 | 类型 | 约束 | 描述 |
|-----|------|-----|-----|
| id | UUID | PRIMARY KEY | 唯一标识符 |
| email | VARCHAR(255) | UNIQUE, NOT NULL | 用户邮箱 |
| name | VARCHAR(100) | NOT NULL | 显示名称 |
| avatar_url | TEXT | NULLABLE | 头像图片 |
| role | ENUM | DEFAULT 'user' | user, admin |
| email_verified | BOOLEAN | DEFAULT false | 验证状态 |
| created_at | TIMESTAMP | DEFAULT NOW() | 账户创建时间 |
| updated_at | TIMESTAMP | ON UPDATE | 最后修改时间 |

## 关系

- **has_one**: Subscription
- **has_many**: ReadingHistory
- **has_many**: Bookmarks

## 索引

- `idx_user_email` 在 `email` 上（用于登录查找）
- `idx_user_created` 在 `created_at` 上（用于分析）

## 示例记录

```json
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "email": "chen@example.com",
  "name": "陈明",
  "avatar_url": "https://storage.example.com/avatars/chen.jpg",
  "role": "user",
  "email_verified": true,
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-03-20T14:22:00Z"
}

---

## 第七部分：成功指标文档

### 7.1 定义关键指标

你的成功指标文档应该清楚地定义成功是什么样子以及如何衡量它：

```md title="metrics/success-metrics.md"
# 成功指标

## 北极星指标
**月度经常性收入（MRR）**
- 目标：2025 Q2 末达到 $2,000 MRR
- 当前：$0（预发布）

## 主要指标

### 获客
| 指标 | 定义 | 目标 | 当前 |
|-----|-----|-----|-----|
| 月访客 | 每月独立访客 | 5,000 | - |
| 注册率 | 访客 → 免费账户 | 5% | - |
| 注册来源 | 用户来自哪里 | 追踪 | - |

### 激活
| 指标 | 定义 | 目标 | 当前 |
|-----|-----|-----|-----|
| 激活率 | 注册 → 阅读 3+ 篇文章 | 40% | - |
| 价值时间 | 到第一个内容的分钟数 | < 5 分钟 | - |
| 引导完成率 | 完成资料设置 | 60% | - |

### 收入
| 指标 | 定义 | 目标 | 当前 |
|-----|-----|-----|-----|
| 免费转付费 | 免费用户 → 订阅者 | 5% | - |
| ARPU | 每用户平均收入 | $15/月 | - |
| LTV | 终身价值 | $150 | - |

### 留存
| 指标 | 定义 | 目标 | 当前 |
|-----|-----|-----|-----|
| DAU/MAU | 日活/月活比率 | 30% | - |
| 流失率 | 月度订阅取消 | < 5% | - |
| 内容回访 | 7 天内回访的用户 | 50% | - |

## 次要指标

### 参与度
- 每次会话的平均阅读时间
- 每用户每月阅读的文章数
- 每用户搜索查询数
- 创建的书签数

### 内容
- 最受欢迎的文章
- 内容完成率
- 付费 vs 免费参与度

## 追踪实现

所有指标通过以下方式追踪：
1. **PostHog**：产品分析
2. **Stripe 仪表板**：收入指标
3. **数据库查询**：自定义指标