discipline/rounds/round-09-pro-subscription.md
📑 本页目录
轮次记录 · Round 9 · Pro 订阅（watchlist 推送 + 每周需求报告）
1. 目标与选题
- 用户指令：开始 Round 9。
- 选题（来自 round-07 §7 候选 1 与 09-value-chain §10 路线图）：Pro 订阅 （watchlist 推送 + 周报邮件），即 L5 变现阶段 2，完成标准 = 订阅管道就绪、 订阅率可测、付费状态不伪造。
- 约束：无 Stripe/SMTP 真实凭据 → 采用与 AdSense 相同的「配置驱动 + 诚实状态」： 默认 waitlist 模式，Stripe 密钥与 SMTP 配置后自动启用。
2. 背景与相关文献
- 学科资产：09-value-chain.md §6 变现纪律（付费点绑定 L4 价值、订阅率 = 价值代理）、 §7 指标链（H20/H21）；06-evidence.md 先注册后计分；出生检测协议 （protocols/emergence-detection.md，watchlist 概念源自 Round 3）。
- 产品参考：同类信息产品定价（The Information $30/月、Apptopia $99/月、 Sensor Tower 企业版）→ Q16 定价锚点定案 $9/月（~1/10）。
3. 框架变更（Decision）
| # | 决策 | 落点 |
|---|---|---|
| D39 | Pro 分层与定价定案：$9/月 · $89/年（Q16）；定价为假设 H22 先注册 | config/forecast.yaml pro:、docs/10-pro-subscription.md |
| D40 | 付费不伪造：waitlist 模式（默认）只记意向；stripe 模式由 webhook（HMAC 校验）确认后置 active | app/pro_api.py webhook、app/forecasting/watchlist.py activate_subscriber |
| D41 | Watchlist 告警：监控领域/子领域，三类事件（on_watchlist/curve_rise/gap），同类 7 天去重 | app/forecasting/watchlist.py check_alerts |
| D42 | 每周需求报告：聚合出生检测/趋势上升榜/许愿池需求簇/预测，md+html+json；摘要公开、全文 Pro 投递 | app/forecasting/watchlist.py generate_digest、/reports |
| D43 | 邮件诚实交付：先写 outbox 队列；SMTP 配置后发送，未配置则队列即交付物 | watchlist.queue_email / send_outbox |
| D44 | 埋点事件扩展：pro_view/pro_waitlist/checkout_start/subscribe_success/watchlist_add/report_open 先登记 | app/analytics_api.py _EVENTS |
4. 实践产物与结果
- 产品设计文档
docs/10-pro-subscription.md（分层、定价、用户旅程、门控、指标、 待接入清单）。 - 订阅数据层
app/forecasting/watchlist.py：订阅者/监控目标/告警追加式 JSONL， 状态机 waitlist→active→canceled；告警检查与周报生成。 - API
app/pro_api.py：waitlist / checkout（waitlist 登记或 Stripe Checkout）/ webhook（HMAC-SHA256 校验 + checkout.session.completed → active）/ watchlist CRUD / alerts / report.latest（teaser 公开、全文需 active token）。 - CLI
scripts/watchlist.py：waitlist/add/rm/ls/check/digest/outbox/status。 - 页面：
/pro（定价卡 + 等待名单 + watchlist 管理 + 告警列表）、/reports（周报 teaser + 历史列表）；首页/价值链路/英文门户加 Pro 入口。 - H22（定价弹性）与 H20/H21 补登记进 knowledge/hypotheses.md。
- 结果指标：CLI 与 API 全链路本地验证通过（含 webhook 激活→active→周报全文； 坏签名 400、waitlist 模式 404）；首份周报 report-2026-W33 已生成（真实数据）。
5. 评估
- 达标：订阅状态机与门控可端到端测试；订阅率/转化指标有数据管道（事件先登记）； watchlist 命中率（H20）与定价弹性（H22）检验起点明确；付费状态不伪造。
- 未达标：Stripe/SMTP 真实接入需外部凭据（如实列入 docs/10 §6 待接入清单）； 周报全文为「投递目标 = active 订阅者」，waitlist 阶段不投递（符合付费墙纪律）。
6. 未决问题
- Q16 结案：定价锚点 $9/月 · $89/年（H22 检验）。
- Q18（埋点隐私）仍开放：EU 同意门待流量上升后评估。
- Q19 token 投递：生产接入邮件后，token 应改为 magic link 投递（docs/10 §6.3）。
- Q20 退订/取消入口：状态机 canceled 已有，页面入口待 Round 10。
7. 下一轮建议（Round 10 候选）
- 需求报告 / API（企业）+ 飞轮验证：路线图 L5 阶段 3；许愿池数据加工成 结构化报告/API，开始 H21 首次检验。
- 英文产品 UI 化：趋势雷达/预测看板双语（承接 /en 流量，Round 8 遗留）。
- Stripe/SMTP 真实接入：拿到凭据后启用 mode=stripe + 邮件投递 + magic link （docs/10 §6 清单落地）。
8. 版本号与 changelog
- 版本：v0.8 → v0.9。Changelog 见 rounds/README.md。