总览与阅读指南
专题地图、生命周期和角色阅读路径
一、专题定位
本专题按产品生命周期完整沉淀一套 RAG（Retrieval-Augmented Generation，检索增强生成）知识库从概念到运维的全流程方法论：文章编号即生命周期顺序，每篇标注所处阶段、上游输入与下游产出。
适用读者：产品经理、架构师、开发工程师、测试工程师、部署运维工程师。
二、产品生命周期全景
flowchart LR
S1["① 概念立项
01"] --> S2["② 需求分析
02"] --> S3["③ 系统设计
03"] --> S4["④ 开发实现
04 05 06 07"] --> S5["⑤ 测试与验收
08 09"] --> S6["⑥ 部署上线
10"] --> S7["⑦ 运维与迭代
11"]
S7 -. "坏例回流 · 驱动各阶段迭代（闭环）" .-> S2
S7 -.-> S4
style S4 fill:#e8f4ff,stroke:#4a9eff
style S5 fill:#fff4e8,stroke:#ff9e4a
style S7 fill:#eaffea,stroke:#4abf60
三、生命周期阶段与文章对照
| 阶段 | 编号 | 文章 | 关键活动 | 主责角色 | 阶段门禁（完成标志） |
|---|---|---|---|---|---|
| 一、概念与立项 | 01 | RAG基础概念与整体架构 | 理解 RAG 价值、可行性判断 | 产品 + 全员 | 立项决策达成 |
| 二、需求分析 | 02 | 需求分析与技术选型 | 需求收集、技术选型、方案对比 | 产品 + 架构 | 需求清单 + 选型决策记录 |
| 三、系统设计 | 03 | 系统设计：架构与接口设计 | 分层架构、数据模型、API、时序图、设计决策 | 架构师 | 设计评审通过 |
| 四、开发实现 | 04 | 环境搭建与开发准备 | 开发/测试环境搭建与验证 | 开发 | 环境验证清单通过 |
| 05 | 文档预处理与入库流水线 | 离线侧：接收→解析→OCR→切片→向量化→索引 | 开发 | 各阶段质量检查点通过 | |
| 06 | 检索与生成链路设计 | 在线侧：改写→混合检索→重排→生成 | 开发 | 链路冒烟通过 | |
| 07 | 核心模块开发实现 | 工程编码、单测、日志与异常规范 | 开发 | 核心风险有测试覆盖 + 自查清单通过 | |
| 五、测试与验收 | 08 | 测试策略与用例设计 | 分层测试、用例执行、权限与性能 | 测试 | 准出标准达成（P0 100% 等） |
| 09 | 评测指标与评测集建设 | 评测集构建、召回/生成指标、自动化评测 | 测试 | 指标达基线 + 评测报告 | |
| 六、部署上线 | 10 | 部署上线：生产环境与CI-CD | 生产部署、灰度发布、CI/CD、监控告警 | 部署运维 | Go-Live 检查清单通过 |
| 七、运维与迭代 | 11 | 运维与持续迭代 | 线上监控、坏例回流、知识库运维、容量规划 | 运维 + 全员 | 周期复盘 + 闭环迭代 |
| 附录 | 12 | 名词术语表 | 全系列术语速查：八大类 80+ 名词一句话解释 + 篇目索引 | 全员 | 按需查阅 |
| 应用篇 | 13 | 个人知识库落地指南 | 个人场景轻量化落地：三种方式、必要条件、Obsidian 接入、迷你考卷 | 个人用户 | 跑通并验收 |
四、阶段交付物流（上游 → 下游）
| 上游阶段 | 交付给下游 | 下游阶段 |
|---|---|---|
| 01 概念立项 | 立项结论、业务目标 | 02 |
| 02 需求分析 | 需求清单、选型决策记录 | 03 |
| 03 系统设计 | 架构方案、DDL、API 契约、时序图 | 04~07 开发、08 测试 |
| 04~07 开发实现 | 可运行系统、单测、提测自查清单 | 08~09 |
| 08~09 测试验收 | 测试报告、评测基线（后继回归依据） | 10 |
| 10 部署上线 | 生产环境、监控大盘、回滚预案 | 11 |
| 11 运维迭代 | 坏例清单、迭代需求（回流至 02~09） | 闭环 |
五、建议阅读路径
第 12 篇是随用随查的术语表，不是第 13 篇的前置条件。文中的阈值、容量和时延数字均为示例或特定环境实测，落地时应以自己的风险、数据和评测基线为准。
- 项目管理（全流程视角）：01 → 02 → 03 → … → 11 顺序通读
- 产品经理：01 → 02 → 09（看指标口径）
- 架构师：01 → 02 → 03（重点）
- 开发工程师：03 → 04 → 05 → 06 → 07（重点）
- 测试工程师：01 → 05 → 06 → 08 → 09（重点）
- 部署运维：04 → 10 → 11（重点）
- 个人知识库实践：01 → 05 → 06 → 09 → 13
- 术语查询：阅读任何章节时按需进入 12
六、核心流程速记
【工程主线 · 产品生命周期】
概念立项(01) → 需求分析(02) → 系统设计(03) → 开发实现(04-07) → 测试验收(08-09) → 部署上线(10) → 运维迭代(11) ↺
【离线 · 入库侧（05 篇）】
文档接收 → 解析 → OCR（图片型文档）→ 切片 → 向量化 → 写入索引
【在线 · 查询侧（06 篇）】
用户提问 → 查询改写 → 混合检索 → 重排序 → 组装 Prompt → LLM 生成 → 引用溯源
【质量保障（08-09 篇）】
评测集建设 → 指标基线 → 分层测试 → 自动化评测 → 回归 → 线上监控 → 坏例回流