LAUNCH MILESTONES

上线里程碑

自上而下一条主轴，每个功能就是一个里程碑，关键任务挂在它旁边。阶段横条标出出口判据， 菱形是开工门禁，虚线条是不受开发进度控制的外部审批。功能的完整明细见 功能路线图。

功能里程碑
31
阶段
4
外部审批链
2

MILESTONES

按功能排列的里程碑主轴

  1. M0

    开发前约定

    先把外部审批启动，并把改起来最贵的四类契约定死。

    出口判据四类契约全部定稿，ICP 备案已提交管局

  2. 1

    合规与准入

    M0
    • 域名注册与实名认证
    • ICP 备案提交与管局审核
    • 服务器接入商核验
    • 备案通过前只用本地与预览环境
    • 上线后 30 日内公安联网备案
    • 盘点收款主体资质，M1 中期启动商户号
  3. 2

    工具与内容契约

    M0
    • Next.js + Fumadocs 版本冒烟
    • Node 22、pnpm 与构建命令约定
    • 构建不通时整栈回退上一个可用版本
    • frontmatter 字段和内容目录结构
    • columnId、chapterId、order 稳定标识符
    • access 字段区分免费、试读、付费
    • 已有 Markdown 存稿归位
  4. 3

    URL 与路由契约

    M0
    • 教程、博客、速查表路径前缀定稿
    • trailingSlash 与反代配置对齐
    • slug 命名规范与大小写约定
    • 不做多语言，不预留 i18n 路径前缀
    • 内容铺开后不再调整 URL 结构
  5. 4

    付费隔离与内容管线

    M0
    • content-paid 放在 docs 集合外
    • 显式不参与静态构建
    • 章节页预留付费正文注入挂点
    • 付费正文投递到生产的方式定稿
    • 付费正文渲染归属：构建期片段或运行时渲染
    • 试读范围以 frontmatter 为默认，后台只做覆盖
  6. 5

    发布基线

    M0
    • 静态构建与本地预览
    • 自有 Nginx、try_files 与缓存策略
    • HTTPS 证书签发与续期
    • 移动端无横向滚动
  7. 外部审批备案链路域名注册与实名认证 → ICP 备案提交与管局审核 → 服务器接入商核验备案号是上线硬前置
  8. M1a

    可收录最小站

    尽早上线能被收录的最小站点，让索引时钟开始走。

    出口判据首发专栏可读、sitemap 已提交、收录起始日已记录

  9. 6

    首屏与品牌最小集

    M1a
    • 首页与全站导航
    • Logo、favicon、自有配色
    • 关于、联系、隐私和 404
    • 深色模式与移动端适配
  10. 7

    首发专栏

    M1a
    • 首发 3 到 5 篇可读章节
    • 专栏详情页与章节列表
    • 有序章节与独立侧栏 topic
    • 代码高亮、行标记与一键复制
    • 免费、试读、付费访问级别标记
    • 付费章节只给静态提示，不放死按钮
  11. 8

    SEO 基线

    M1a
    • 每篇 title、description、slug
    • 首页与标题位使用流量关键词
    • 品牌词不占 SEO 标题位
    • 自动 sitemap 与 robots.txt
    • Article 与 TechArticle JSON-LD
    • OG 图与图片 alt
    • Lighthouse SEO 大于等于 90
  12. 9

    上线与收录启动

    M1a
    • 备案通过后解析域名并部署
    • 站长平台验证并提交 sitemap
    • Orama 索引与中文检索冒烟
    • 不索引付费正文
    • 记录收录起始日并跟踪收录率
    • 验收判据：首发专栏可读且已提交收录
  13. M1b

    内容与运营

    在已上线站点上扩品类、补治理，并把周更节奏跑稳。

    出口判据周更节奏稳定，自然搜索 UV 与收录率可持续跟踪

  14. 10

    教程目录与筛选

    M1b
    • 教程目录卡片墙
    • 封面、简介与篇数
    • 按难度、标签、最新筛选排序
  15. 11

    速查表与博客

    M1b
    • 速查表列表、详情与锚点跳转
    • 命令一键复制
    • 博客列表、详情、分页和标签
    • RSS 与文章封面
  16. 12

    富媒体

    M1b
    • B 站视频 MDX 卡片
    • 懒加载与比例占位防 CLS
  17. 13

    内容治理

    M1b
    • 最后更新时间与修订记录
    • 过期内容提示
    • slug 变更 301 重定向
    • 死链与图片检查
  18. 14

    周更节奏

    M1b
    • 开发与写作按周切分时间
    • 周更频率与文章收录率作为前导指标
    • 一个主题先做全再铺下一个
    • 专栏管线：Claude Code 到 Codex 到具体 skill
  19. 15

    数据分析

    M1b
    • 自然搜索 UV 作为北极星
    • 来源词与落地页
    • 教程详情 CTA 点击
    • 站内搜索零结果
    • 404 访问记录
    • 采集入口与定期复盘
  20. 16

    页级反馈

    M1b
    • 文章纠错与建议入口
    • 自动附带当前页面 URL
    • 初期不引入完整评论系统
  21. 17

    可观测性与恢复

    M1b
    • 站点可用性监控
    • HTTPS 证书到期监控
    • 构建与部署失败报警
    • 404 报警
    • 定期备份
    • 恢复演练
  22. M1b+

    第三方教程（可选支线）

    镜像开源教程，不占主干时间，先解决重复内容再铺量。

    出口判据canonical 与 noindex 抽查通过，镜像内容流量单独可观察

  23. 18

    接入前提

    M1b+
    • 原创内容收录情况已验证
    • 评估重复内容风险后再决定接入
    • 排在 M1b 主线之后，不与首发专栏抢时间
  24. 19

    重复内容与 SEO

    M1b+
    • rel=canonical 指向上游原文
    • 高度重复页面 noindex
    • 不占用首页与教程目录主推位
    • 单独观察镜像内容的收录与流量
  25. 20

    来源与版权

    M1b+
    • 顶部导航或教程目录入口
    • 本站课程入口页
    • 许可证页面
    • 来源与非官方声明
    • 更新责任与命令安全提醒
  26. 21

    上游同步

    M1b+
    • Git submodule 独立管理
    • 上游源码只读
    • fast-forward 更新
    • 主仓库提交子模块指针
  27. 22

    内容适配

    M1b+
    • 只发布目标语言与读者所需路径
    • 排除脚本、内部文档和搜索噪声
    • loader 补 title
    • 关闭错误的 editUrl 与 issueUrl
    • 相对 Markdown 链接转本站路由
    • 未发布页面回退上游 GitHub
    • 缺失图片改用本站 public 资源
    • 避免重复页面标题
  28. 23

    上线验收

    M1b+
    • pnpm run build 通过
    • 入口到首页到模块页链路测试
    • 桌面与移动端截图检查
    • 链接、图片、搜索索引与许可证检查
    • canonical 与 noindex 抽查
    • 确认上游子模块工作树干净
    • 第二或第三个项目后再抽象集中配置
  29. 外部审批收款资质链路盘点收款主体资质 → 个体工商户或企业主体 → 微信支付商户号审核商户号是 M2 硬前置

  30. M2 启动判据

    5 条判据全部满足才开工，未达成则回到 M1b 继续内容循环。

  31. M2

    账号与交易

    判据达成后再从阅读转向购买。

    出口判据真实订单可完成：下单、支付、解锁、退款全链路闭环

  32. 24

    账号与个人中心

    M2
    • 邮箱或手机注册
    • 密码与昵称
    • 账号密码登录
    • Sanctum 第一方会话与 HttpOnly Secure Cookie
    • 不使用 localStorage 存 token
    • 邮箱或手机找回密码
    • 修改昵称与密码
    • 已购专栏与订单记录
  33. 25

    账号安全与数据权利

    M2
    • 邮箱或手机验证
    • 登录与找回密码限流
    • 防撞库
    • 注销账号
    • 个人数据导出或删除
  34. 26

    付费墙

    M2
    • 未购显示试读与购买卡
    • 服务端验证登录与购买记录
    • 已购后拉取全文并客户端注入
    • 付费正文永不进入 dist
    • 免费与试读内容对爬虫可见
    • 注入后补代码高亮与复制
    • 付费墙 JSON-LD 标注 isAccessibleForFree 为 false
    • paywall 区域标注且试读段有真实价值
    • 正文接口按章节粒度返回
    • 内容接口限流与异常批量下载告警
  35. 27

    商品与定价

    M2
    • 按专栏单独售卖，不做全站会员
    • 单价与试读范围后台可配
    • 下单写入价格快照
    • 购买 CTA、价格与已购数
    • 专栏上架与下架
  36. 28

    微信 Native 支付

    M2
    • 创建订单并返回二维码
    • 前端轮询支付状态
    • 支付成功自动解锁并写入已购记录
    • 回调验签与幂等
    • 查单接口兜底，回调或查单任一成功即解锁
    • 订单状态机
    • Native 扫码不需要 openid
    • 使用 yansongda laravel-pay，不引入 easywechat
  37. 29

    售后与交易通知

    M2
    • 待支付订单过期
    • 重复支付与支付异常处理
    • 退款处理与退款后撤销权益
    • 购买须知与退款规则
    • 发票规则前置到购买须知
    • 注册验证与找回密码通知
    • 支付成功、退款与订单状态通知
    • 初期以邮件为主，短信后置
  38. 30

    站长后台

    M2
    • Filament 与 filamentboot 基建
    • 认证、RBAC、菜单和操作日志
    • 用户、订单与客服按订单定位
    • 站点配置
    • 后台不编辑内容，Markdown 仍由 Git 管理
  39. 远期

    按需增强

    有真实需求后再扩展，并守住范围边界。

    出口判据按真实需求逐项评估，不排固定期限

  40. 31

    按需排期

    远期
    • 会员与专栏打包
    • 优惠码与早鸟
    • 评论，按 giscus 这类轻量嵌入方案评估
    • 邮件订阅
    • 学习进度
    • 大规模内容时评估外部搜索
    • 外部文档导入工具链

GATE

M2 启动判据

这一步的投入是前面几个阶段的数倍，所以它需要判据而不是日期。以下条件全部满足才开工， 否则回到 M1b 继续内容循环。

  • 连续 4 周自然搜索 UV 达标
  • 首发专栏章节数达标
  • 收到明确付费意愿反馈
  • 收款主体与微信支付商户号已就绪
  • Laravel、Filament 与 filamentboot 版本兼容性已复核

EXTERNAL

外部审批链

这两条链有自己的时钟，开发做得快也不会让它们变短，因此必须尽早启动并单独跟踪。

备案链路

ICP 备案是上线的硬前置，M0 第一步就要启动。

  1. 域名注册与实名认证
  2. ICP 备案提交与管局审核（约 2 到 3 周）
  3. 服务器接入商核验
  4. 公安联网备案（上线后 30 日内）

备案号是上线硬前置

收款资质链路

商户号审核不受开发影响，M1 中期就要并行启动。

  1. 盘点收款主体资质
  2. 个体工商户或企业主体
  3. 微信支付商户号审核

商户号是 M2 硬前置

CROSS-CUTTING

跨阶段 · 技术与安全

贯穿全程，不单独排期，也不作为里程碑的前置。

  • 前台生态：Next.js + Fumadocs + shadcn/ui、Markdown + Git、Orama 检索
  • 后台生态：Laravel API、Filament、yansongda laravel-pay
  • 安全：服务端 Policy 验权、不信任客户端标志、支付验签、付费路由不缓存
  • 性能预算：移动 4G LCP 小于 2 秒、预渲染优先、ISR 承载周更