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

# 问题陈述

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

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

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

## 当前解决方案
| 解决方案 | 局限性 | 用户挫败感 |
|---------|--------|----------|

# 用户旅程：首次激活

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

## 旅程阶段

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

### 阶段 2：评估

# 功能：付费内容访问

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

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

## 用户故事

### US-001：查看付费徽章
作为一个 **访客**，我想要 **看到哪些内容是付费的**

# 技术架构概述

## 系统上下文

```plaintext
┌─────────────────────────────────────────────────────────────┐
│                        用户                                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐    │
│  │ 访客     │  │ 免费     │  │ 付费     │  │ 管理员   │    │
│  │          │  │ 会员     │  │ 会员     │  │          │    │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘    │
│       │             │             │             │           │
└───────┼─────────────┼─────────────┼─────────────┼───────────┘
        │             │             │             │
        └─────────────┴─────────────┴─────────────┘
                              │
                    ┌─────────▼─────────┐
                    │  CDN (Cloudflare) │
                    └─────────┬─────────┘
                              │

### 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

---

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

### 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 | - |

### 留存