作者： mrbear1024

Vibe Coding 软件架构课大纲（从0→1 MVP到10→100可规模化）

课程关键词：以产品为中心、以增长为导向、以工程为抓手、以成本为红线。

0. 课程定位（Why this course）

  • 面向非科班/转行者与全栈/后端工程师的产品型软件架构课程。
  • 目标：从一个最小可行产品（MVP）起步，在 12 周内完成可维护、可观测、可扩展、可变现的架构升级，支撑1→10→100用户规模跃迁。
  • 方法论：Vibe Coding（以场景与节奏驱动的构建法） + Clean/Hexagonal/DDD-lite + SRE/FinOps + Data & AI Ready。

1. 学习成果（Learning Outcomes）

完成课程后，你将能：

  1. 以产品需求→领域建模→接口契约→迭代交付的节奏设计系统。
  2. 实作一套分层解耦（Adapter/UseCase/Domain/Infra）的服务，具备可测试性与可观测性。
  3. 在低成本前提下实现弹性扩缩容、灰度发布、降级与熔断、缓存与队列等工程能力。
  4. 构建增长闭环：埋点→指标→看板→A/B→自动化运营；并具备支付/订阅/风控的落地方案。
  5. 形成可复用模板仓库与团队协作流程（Git/CI/CD/Code Review/Runbook）。

2. 适用人群 & 先修要求

  • 两条学习路径：
  • 路径A（产品驱动）：零/低代码背景的产品/运营/创作者。
  • 路径B（工程驱动）：有 JS/TS/Go/Python 任一语言基础的工程师。
  • 建议先修：Git 基础、HTTP/REST 基础、数据库 CRUD 常识、Linux/容器基本操作。

3. 课程地图（四阶段能力栈）

Phase I：0→1（MVP）

  • 单体/模块化单体、REST 契约、ORM、认证鉴权、对象存储、邮件/短信。

Phase II：1→10（可维护）

  • Clean/Hexagonal、测试金字塔、可观测性（日志/指标/追踪）、CI/CD、蓝绿/灰度发布、缓存与队列。

Phase III：10→100（可扩展）

  • 读写分离、拆分边界（按变化轴拆）、事件驱动、幂等与一致性、限流与熔断、搜索与推荐、支付与订阅、风控。

Phase IV：合规与SRE

  • 安全与隐私、审计与合规、备份与容灾、成本优化（FinOps）、性能压测与容量规划。

4. 技术选型与模板（可替换）

  • 前端：Next.js（App Router）+ React + Tailwind + TanStack Query + Zustand。
  • 后端（任选其一）：
  • Node/TS：NestJS（分层 + DI），或 Fastify + 自建UseCase层。
  • Go：Fiber/Gin + Wire（DI）+ ent/GORM + fx（可选）。
  • Python：FastAPI + Pydantic + SQLModel。
  • 数据库：PostgreSQL（主→只读副本），Redis（缓存/会话/限流），对象存储（S3/R2）。
  • 消息与任务：Kafka/Redpanda（事件流，可选），或 RabbitMQ/CloudTasks（简化）。
  • 接口：HTTP/REST + OpenAPI；内部可选 gRPC（接口收敛）。
  • 可观测性：OpenTelemetry（Trace/Metric/Log）+ Grafana/Loki/Tempo + Prometheus。
  • CI/CD：GitHub Actions + Docker + Fly.io/Render/Vercel/Cloudflare（低运维起步）。
  • 鉴权：JWT + RLS（Postgres Row-Level Security 可选）+ RBAC/ABAC。
  • 支付：Stripe + Webhook 签名 + 幂等键；订阅/试用/优惠码/税务（基础版）。

提供脚手架模板仓库结构：见附录A。

5. 12 周详细大纲（每周 2 讲 + 1 实战）

Week 1｜产品到架构

  • L1 产品分解：核心用户旅程（Jobs to be Done）→ MVP Scope → 领域术语表。
  • L2 架构风格速写：分层/六边形/整洁架构/DDD-lite 的适用边界。
  • Lab：从用户故事生成 OpenAPI 契约与 ERD 初稿。

Week 2｜模块化单体 & Clean

  • L3 UseCase/Domain/Adapter 划分与依赖倒置；防腐层实践。
  • L4 数据访问策略：迁移、种子数据、软删除、多租户（Schema/Column/RLS）。
  • Lab：搭建模板仓库，打通注册/登录/资料编辑全链路。

Week 3｜可测试性

  • L5 测试金字塔：单测/契约测/端到端；Test Double 与可测性设计。
  • L6 假数据/工厂与快照；回归与变更检测。
  • Lab：为核心 UseCase 写 10+ 用例，集成 CI。

Week 4｜可观测性与质量门

  • L7 OTel 全链路追踪、指标基线、SLO/SLA/SLI 设计。
  • L8 错误预算与发布策略：蓝绿、金丝雀、特性开关。
  • Lab：接入 APM/日志/Tracing，看板上墙。

Week 5｜性能与缓存

  • L9 缓存层级：浏览器/边缘/CDN/服务/数据库；TTL/惰性失效/缓存击穿防护。
  • L10 限流/降级/熔断/重试与幂等键；接口稳定性设计。
  • Lab：为 3 条热点 API 设计缓存策略并压测。

Week 6｜事件驱动与任务

  • L11 事件建模：事实表/事件表、出站/入站箱（Outbox/Inbox）。
  • L12 任务编排：异步队列、定时任务、补偿与回滚策略（Saga-lite）。
  • Lab：实现邮件通知与审计日志流水线。

Week 7｜数据与推荐准备

  • L13 埋点体系：实体→事件→属性→指标（DAU/留存/漏斗/北极星）。
  • L14 向量检索/搜索/推荐的最低落地线；冷启动与反馈回路。
  • Lab：埋点→ETL→看板（Grafana/Metabase）闭环。

Week 8｜增长与变现

  • L15 支付/订阅/试用/券；税务与对账；Webhook 幂等与重放。
  • L16 营销增长：分享链路、邀请返佣（基础版）、邮件旅程与反作弊。
  • Lab：上线订阅 + 退款/降级/续费全流程沙箱。

Week 9｜边界拆分与一致性

  • L17 拆分边界：按变化轴与团队自治拆；数据一致性模型选择。
  • L18 最小化跨边界耦合：API 合同、Schema 版本化、兼容退场。
  • Lab：将“通知/计费”拆为独立服务并接入网关。

Week 10｜安全与隐私

  • L19 安全基线：OWASP Top10、密钥治理、RBAC/ABAC、审计与合规要点。
  • L20 隐私分级与数据脱敏；导入导出与删除权；权限申请流程。
  • Lab：落地密钥轮换、审计日志、敏感数据扫描。

Week 11｜SRE 与韧性

  • L21 备份/容灾/多可用区；错误预算驱动的运维决策。
  • L22 容量规划与成本优化（FinOps）：性能分析、按量计费与包年包月权衡。
  • Lab：演练故障注入与灾备切换 Runbook。

Week 12｜综合项目与答辩

  • L23 架构复盘：四象限（价值/风险/成本/复杂度）优先级矩阵。
  • L24 演示与路演：关键指标与技术亮点；Q&A 防守清单。
  • Capstone：见下。

6. Capstone（3 选 1，可自由发挥）

  1. AI 内容学习平台（轻量版）
  • 模块：上传/解析→摘要/问答→书签/高亮→订阅与分享。
  • 要求：MVP 单体 + 事件日志 + 订阅 + 埋点看板 + 基础风控。
  1. 支付与结算中台（SaaS 内嵌）
  • 模块：订单→支付→订阅→对账→发票；Webhooks 幂等与重放。
  • 要求：多租户（列级/RLS 方案），对账报表与异常告警。
  1. 推荐与通知系统（事件驱动）
  • 模块：事件摄取→用户画像→候选生成→触达编排（邮件/站内/推送）。
  • 要求：可观测性全套 + A/B 框架 + 限流/退订/合规。

评分：功能 40%｜工程质量 30%｜可观测性 15%｜成本与韧性 15%。

7. 里程碑与验收清单（Milestone Checklist）

  • M1（第 2 周）：登录注册上线，契约与ERD定版，CI 绿灯。
  • M2（第 4 周）：OTel/日志/指标/追踪齐备；蓝绿发布打通。
  • M3（第 6 周）：事件流与任务编排跑通；Outbox 守护。
  • M4（第 8 周）：支付订阅 + 邀请链路 + 退款流程。
  • M5（第 10 周）：安全基线通过（依赖扫描/密钥轮换/审计）。
  • M6（第 12 周）：容量/成本评估报告 + Chaos 演练报告 + Capstone 路演。

8. 团队协作与仓库规范

  • Mono-Repo 推荐结构（可拆多仓）：
  • /apps/web（Next.js）
  • /apps/api（NestJS/FastAPI/Gin）
  • /packages/core（领域模型与UseCase）
  • /packages/sdk（OpenAPI 生成客户端）
  • /infra（IaC/Docker/compose/k8s/Helm）
  • /docs（架构决策记录 ADR + Runbook + Onboarding）
  • 流程：GitHub Flow + Protect Main + PR Template + Conventional Commits + Changeset 版本管理。
  • 文档：ADR 模板、Runbook 模板、Oncall 手册。

9. 关键设计清单（Design Checklists）

  • 接口契约：版本化、幂等键、错误码规范、速率限制头、分页/排序/过滤统一。
  • 数据层：迁移回滚脚本、软删除与审计、RLS/多租户策略、读写分离与连接池。
  • 缓存策略：键命名、TTL 策略、主动失效、热点保护、旁路缓存与写穿/写回。
  • 一致性：本地事务 + Outbox/Inbox、幂等消费、去重与去抖。
  • 可观测性：Trace 采样率、指标基线、错误预算、告警分级（P0/P1/P2）。
  • 发布韵律：特性开关、灰度比例、回滚阈值、演练频率。
  • 安全与合规：密钥治理、最小权限、数据分级、隐私请求处理 SLA。

10. 作业与考核方式

  • 周作业：课后完成 1 个设计清单 + 1 个可观测性任务（例如新增 3 个关键指标）。
  • 代码评分 Rubric：
  • 结构（分层、依赖方向、边界清晰）
  • 契约（OpenAPI 完整度、错误码、分页/过滤）
  • 测试（覆盖率、可读性、独立性）
  • 运维（CI/CD、打包、配置分离、环境差异处理）
  • 观测（日志、指标、追踪与告警合理性）
  • 成本（实例规格、缓存命中率、外部服务调用优化）

11. 课程资料包（交付物）

  • 架构模板仓库（Node/Go/Python 三选一）。
  • PR 模板、Issue 模板、ADR 模板、Runbook 模板、事故复盘模板。
  • OpenAPI 契约示例 + SDK 生成脚本（TS/Go/Python）。
  • 监控看板 JSON（Grafana）与告警规则示例（Prometheus Alertmanager）。
  • 压测脚本（k6）与容灾演练清单。

12. 推荐资料（精简可操作）

  • 《Clean Architecture》《Domain Modeling Made Functional》《Designing Data-Intensive Applications》
  • 《Building Microservices（2nd）》、Google SRE Workbook、《可观察性工程》
  • 官方文档：OpenAPI、OpenTelemetry、PostgreSQL、Redis、Stripe、Next.js、NestJS/FastAPI/Gin

附录A：模板仓库目录（示例）

repo/
├─ apps/
│  ├─ web/                  # Next.js（App Router）
│  └─ api/                  # NestJS/FastAPI/Gin
├─ packages/
│  ├─ core/                 # 领域模型与用例
│  └─ sdk/                  # OpenAPI 生成客户端
├─ infra/
│  ├─ docker/               # Dockerfile & compose
│  ├─ k8s/                  # Helm charts（可选）
│  └─ scripts/              # k6 压测/运维脚本
├─ docs/
│  ├─ adr/                  # 架构决策记录
│  ├─ runbook/              # 值班与故障处理
│  └─ onboarding/           # 新人文档
└─ .github/
   ├─ workflows/            # CI/CD
   ├─ ISSUE_TEMPLATE.md
   └─ PULL_REQUEST_TEMPLATE.md

附录B：OpenAPI 片段（示例）

openapi: 3.1.0
info:
  title: Vibe API
  version: 0.1.0
paths:
  /v1/auth/login:
    post:
      operationId: login
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LoginReq'
      responses:
        '200': { $ref: '#/components/responses/Ok' }
        '401': { $ref: '#/components/responses/Unauthorized' }
components:
  schemas:
    LoginReq:
      type: object
      required: [email, password]
      properties:
        email: { type: string, format: email }
        password: { type: string, minLength: 8 }
  responses:
    Ok:
      description: OK
    Unauthorized:
      description: Unauthorized

附录C：作业示例（Week5 缓存策略）

  • 为 /v1/content/{id} 设计旁路缓存：Key 架构、TTL、主动失效钩子；压测前后命中率对比。
  • 为“搜索”设计请求合并与慢查询观察；提供指标与结论。

附录D：演示与路演脚本（要点）

  • 3 张图讲清楚：上下文图、容器图、时序图。
  • 指标看板：北极星指标 + 稳定性指标（错误率、P95、可用性）。
  • 工程亮点：Outbox 幂等、灰度回滚、成本降本（缓存命中率从 60%→85%）。

Deep Thinking

“Deep thinking” is usually used to describe a way of thinking rather than a single activity. It means you don’t just skim or react to information on the surface, but you pause and work through it at multiple levels. Some common aspects people include are:
• Depth of analysis – looking for underlying causes, connections and principles rather than just the immediate facts.
• Extended concentration – giving a question or idea your full attention for a long enough time that your mind can go beyond first impressions.
• Critical and reflective – questioning assumptions (including your own), testing different angles, and imagining consequences.
• Integrative – combining knowledge from different fields or experiences to form a more complete picture.
• Creative insight – not just breaking things down but also synthesising new ideas or solutions.

You can contrast “deep thinking” with “shallow” or “surface” thinking, where we jump to quick answers or accept information at face value. People cultivate deep thinking by reading slowly and actively, taking notes, asking “why” repeatedly, letting ideas incubate, and discussing them with others to test and refine their understanding.