我的第一篇博客

Blog Author · 1 分钟 阅读时间
发布于 2025年12月10日

📄 Astro + Notion 博客系统（SSR 专用）MVP 需求文档

1. 项目概述

1.1 项目背景

为快速搭建一个内容可实时更新、对搜索引擎友好、无需构建静态页面的博客系统，采用 Astro + Notion + SSR 架构 进行开发。

1.2 项目目标

构建一个：

  • ✅ 基于 服务端渲染（SSR）
  • ✅ 使用 Notion 作为唯一内容管理系统
  • ✅ 强 SEO 友好
  • ✅ 支持 Google Analytics 4
  • ✅ 可快速上线的博客系统 MVP

    • 2. 技术选型

    3. 系统架构（SSR）

    
    用户请求
   ↓
Astro SSR 服务
   ↓
调用 Notion API 获取数据
   ↓
服务端生成完整 HTML
   ↓
返回 HTML 给浏览器 & 搜索引擎
   ↓
GA4 客户端采集数据

    ✅ 不生成静态 HTML ✅ 所有页面运行时实时渲染 ✅ 搜索引擎可直接抓取完整内容

    4. 内容管理需求（Notion）

    4.1 数据库字段规范

    4.2 数据规则

  • ✅ 仅展示 status = published
  • ✅ 内容修改后 无需重新构建，立即生效
  • ✅ Notion 作为唯一内容后台

    • 5. 功能需求（MVP）

    5.1 首页

  • 最新文章列表（SSR 动态渲染）
  • 展示内容：
  • 支持分页

    • 5.2 文章详情页 /post/[slug]

  • 服务端根据 slug 实时请求 Notion
  • 支持：
  • 每篇文章独立 SEO Meta

    • 5.3 标签页 /tags

  • 所有标签聚合展示
  • 点击标签查看文章列表
  • SSR 渲染

    • 5.4 关于页 /about

  • 固定内容
  • 由 SSR 输出

    • 6. SEO 专用需求（SSR 方案）

    ✅ 不依赖客户端 JS 执行 ✅ 搜索引擎获取即完整内容

    7. Google Analytics（GA4）需求

  • ✅ 集成 GA4
  • ✅ 支持：
  • ✅ 支持：
  • ✅ SSR + CSR 混合路由切换仍可正常统计

    • 8. 非功能性需求

    9. 路由结构

    
    /
├── 首页
├── /post/[slug]
├── /tags
├── /about
├── /sitemap.xml（SSR）
└── /robots.txt

    10. 构建 & 运行方式（SSR 专用）

    11. MVP 里程碑计划

    12. MVP 明确不包含功能

  • ❌ 用户系统
  • ❌ 评论系统
  • ❌ 全文搜索
  • ❌ 多语言
  • ❌ 自建内容后台

    • 13. 交付物

  • ✅ 可访问 SSR 博客系统
  • ✅ Notion 内容模板
  • ✅ Git 源码仓库
  • ✅ GA4 配置完成
  • ✅ SEO 配置完成
  • ✅ 部署说明文档

    • ✅ 最终技术定位确认

    Share: