Skip to content

Type C 案例页

解决什么问题:端到端贯通的真实场景——把多个概念串起来,展示"在真实业务里怎么用"。

它是什么

Type C 文档是 wiki 的"实战剧本"——展示一个具体项目/场景,把 L 层的多个概念串联起来。

典型例子(未来):

  • l2-design/06-cases/event-sourcing-order-system/ (用事件溯源做订单系统)
  • l3-implementation/06-cases/staged-rollout/ (灰度发布的实施)

特征

  • 真实场景(不是 toy example)
  • 必须链接到具体概念页(Type B)
  • 篇幅 80-150 行
  • 一个案例贯穿多个 L 层

结构模板

markdown
---
title: [案例名]
type: case
layer: L2 (or 跨层)
group: cases
status: mature
confidence: ★★★★☆
last_updated: YYYY-MM-DD
related:
  - /path/to/concept-1/  # 案例涉及的概念
  - /path/to/concept-2/
---

# [案例名]

> 这个案例展示什么:[一句话——通过这个案例你将看到什么概念/方法的应用]

## 场景

[真实业务背景——1-2 段]
- 业务方是谁
- 解决了什么问题
- 为什么用这套方案

## 涉及的 [Layer] 概念

| 概念 | 在本案例的角色 | 链接 |
|---|---|---|
| [概念 1] | [怎么用] | [](/path/) |
| [概念 2] | [怎么用] | [](/path/) |
| ... | ... | ... |

## 决策过程

### 阶段 1: [阶段名]
[这个阶段做了什么、为什么、用了什么概念]

### 阶段 2: [阶段名]
...

## 结果

[实施后的数据/反馈——避免空话, 给可量化的结果]

## 复盘

### 什么是对的
[决策正确的部分——为什么]

### 什么可以改进
[下次会怎么改——基于实际数据]

## 相关链接

- [概念 1](/path/)
- [概念 2](/path/)
- [类似案例](/path/)

必填 section(5 个)

section作用篇幅
# 案例名主标题1 行
> 这个案例展示什么定位句1 行
## 场景真实业务背景1-2 段
## 涉及的 [Layer] 概念表格——案例用到的概念及链接5-10 行表格
## 决策过程阶段化展示3-5 个阶段
## 结果可量化结果1-2 段
## 复盘什么对/什么错2 个子段

怎么用

新建 Type C 文档

  1. 选择一个真实做过/调研过的项目
  2. 在"涉及的 [Layer] 概念"表里填至少 3 个相关 Type B 文档
  3. 决策过程按"为什么这么做"而不是"做了什么"
  4. 结果必须可量化(QPS、延迟、错误率、节省成本等)

常见误区

  1. 写成"项目介绍"而不是"案例分析"——案例的核心是"为什么这么做",不是"做了什么"
  2. 没有量化结果——"提升了" 是空话,"p99 延迟从 500ms 降到 80ms" 才是结果
  3. 不复盘——只讲成功不讲失败 = 假案例
  4. 不链接到概念页——案例页的核心价值是"展示概念的应用",不链接 = 孤立文档

关键洞察

案例 = 概念的"使用说明书"

Type B 概念页告诉读者"什么是 X",Type C 案例页告诉读者"在真实场景里 X 是这样用的"。没有案例的概念是抽象的,没有概念的案例是孤立的

相关链接

从名家方法论与工程化思路中蒸馏出自己的工程体系。