docs: 沉淀迭代与发布流程(docs/08)+ PRD 加版本栏/版本列

版本方案(里程碑版,非严格 semver)、PRD 两层结构、发布收尾清单;
迭代循环 PRD 先行。docs/05 是角色边界故新开 docs/08。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

CHANGELOG.md

@@ -8,6 +8,7 @@
 - **PRD(`docs/01`)对齐现状 + 补完整性**:
   - 对齐:阶段改「已内网上线」、补 06-26/06-29 修订记录;§3 范围与 §8 验收补入**趋势视图**;§7 去掉与趋势矛盾的"不做自定义日期范围"(趋势已支持自定义起止);空态文案「数据缺失」→「暂无数据」。
   - 补充:§1.2 业务目标与成功指标、§1.3 目标用户与典型场景、§1.4 访问与权限(现状内网无鉴权、对外前须补)。
+- **`docs/08-迭代与发布` 新增**:沉淀迭代方式(端到端垂直切片 + 闭环流程 + PRD 先行)、PRD 两层结构与拆分时机、**版本方案**(里程碑版 v1.0 起、每模块 minor+1,API 对外供数时另走 SemVer)、三层记录区分、发布收尾 7 步清单。PRD 顶部加"版本"栏 + 修订记录加"版本"列(MVP 期留空);README/docs07 索引补 docs/08。
 - **`/docs-check` 全套复扫**(只读、未派子代理):修掉 3 处残留漂移——`docs/06` 鉴权交叉引用 §7→§1.4、`docs/02` 空态措辞对齐「暂无数据」、`docs/02` §5 标注 `/query` 不含自定义范围(趋势见 §5.1);其余(接口/口径/表结构/IA/结构/部署)均一致。
 
 ## 2026-06-29

README.md

@@ -3,7 +3,7 @@
 面向内部的一站式数据平台门户。**MVP 已端到端交付一个可用模块:拼团漏斗**(`行为分析 > 漏斗分析 > 拼团漏斗`,含**漏斗**与**趋势**两视图),其余能力域进导航、出"待开发"占位。
 
 > **新接手先读 [docs/07 项目结构与模块](docs/07-项目结构与模块.md)**(目录层级 / 模块职责 / 运行与部署流程)。
-> 产品与信息架构见 [docs/01](docs/01-产品需求-MVP.md);技术架构与契约见 [docs/02](docs/02-技术架构.md) / [docs/03](docs/03-数据契约.md);视觉设计见 [docs/04](docs/04-设计规范.md);接口见 [docs/06](docs/06-接口文档.md);协作约定见 [docs/05](docs/05-agent协作准则.md) 与根 [CLAUDE.md](CLAUDE.md)。改动留痕见 [CHANGELOG.md](CHANGELOG.md)。
+> 产品与信息架构见 [docs/01](docs/01-产品需求-MVP.md);技术架构与契约见 [docs/02](docs/02-技术架构.md) / [docs/03](docs/03-数据契约.md);视觉设计见 [docs/04](docs/04-设计规范.md);接口见 [docs/06](docs/06-接口文档.md);协作约定见 [docs/05](docs/05-agent协作准则.md) 与根 [CLAUDE.md](CLAUDE.md);**迭代与发布流程见 [docs/08](docs/08-迭代与发布.md)**。改动留痕见 [CHANGELOG.md](CHANGELOG.md)。
 
 ## 能力域(信息架构,5 个 L1)
 

docs/01-产品需求-MVP.md

@@ -6,21 +6,24 @@
 
 | 项 | 内容 |
 |----|----|
+| 版本 | **—**(MVP 未打号;版本方案与发布流程见 `docs/08`) |
 | 阶段 | **MVP 已内网上线**(未切 `release` 正式版) |
 | 更新日期 | 2026-07-03 |
 
-> MVP 快速迭代期不打语义版本号(v1/v2),**按日期记变更**(与 `CHANGELOG.md` 一致);真正上线到 `release` 后再切正式版本。
+> MVP 快速迭代期不打语义版本号,**按日期记变更**(与 `CHANGELOG.md` 一致);切 `release` 起填 v1.0,每个新能力域模块 minor+1(详见 `docs/08` §4)。
 
 ## 修订记录(按日期)
 
-| 日期 | 变更 |
-|------|------|
-| 2026-06-21 | 初版:5 个扁平能力域 + 泛用 UV 漏斗设想(bitmap 方案) |
-| 2026-06-24 | 重构为**三级信息架构**(初版 7 个 L1);MVP 改为**拼团固定漏斗**(预聚合两表),漏斗详规对齐实现;前端栈 Ant Design → shadcn/ui |
-| 2026-06-25 | **IA 精简定稿为 5 个 L1**(行为分析 / 指标体系 / 画像体系 / 数据看板 / 营销触达):多实体画像、实时并入看板、去数据管理/工作台门面、导航展开折叠;**平台更名「数据服务平台」→「数据平台」**(数据服务一词留给将来 API 层)+ 命名约定;文档全量对齐现状 |
-| 2026-06-26 | **MVP 内网上线**:后端接入真实拼团两表、服务器 uvicorn 单进程同源托管;**新增「趋势」视图**(按日 UV/相邻转换率折线,范围支持自定义起止) |
-| 2026-06-29 | 默认单日改回昨日(缺数即"暂无数据",不在应用侧兜底);空态文案「数据缺失」→「暂无数据」;顶栏品牌中英视觉等重 |
-| 2026-07-03 | PRD 对齐现状(趋势视图、趋势支持自定义范围、上线状态、文案)+ 补业务目标 / 用户场景 / 访问权限(§1.2–1.4) |
+> 版本列自切 `release`(v1.0)起启用;MVP 期留空(`—`)。版本方案见 `docs/08`。
+
+| 日期 | 版本 | 变更 |
+|------|------|------|
+| 2026-06-21 | — | 初版:5 个扁平能力域 + 泛用 UV 漏斗设想(bitmap 方案) |
+| 2026-06-24 | — | 重构为**三级信息架构**(初版 7 个 L1);MVP 改为**拼团固定漏斗**(预聚合两表),漏斗详规对齐实现;前端栈 Ant Design → shadcn/ui |
+| 2026-06-25 | — | **IA 精简定稿为 5 个 L1**(行为分析 / 指标体系 / 画像体系 / 数据看板 / 营销触达):多实体画像、实时并入看板、去数据管理/工作台门面、导航展开折叠;**平台更名「数据服务平台」→「数据平台」**(数据服务一词留给将来 API 层)+ 命名约定;文档全量对齐现状 |
+| 2026-06-26 | — | **MVP 内网上线**:后端接入真实拼团两表、服务器 uvicorn 单进程同源托管;**新增「趋势」视图**(按日 UV/相邻转换率折线,范围支持自定义起止) |
+| 2026-06-29 | — | 默认单日改回昨日(缺数即"暂无数据",不在应用侧兜底);空态文案「数据缺失」→「暂无数据」;顶栏品牌中英视觉等重 |
+| 2026-07-03 | — | PRD 对齐现状(趋势视图、趋势支持自定义范围、上线状态、文案)+ 补业务目标 / 用户场景 / 访问权限(§1.2–1.4);沉淀迭代与发布流程(`docs/08`) |
 
 ---
 

docs/07-项目结构与模块.md

@@ -1,7 +1,7 @@
 # 项目结构与模块
 
 > 给新接手者的"地图":目录层级、各模块职责、运行与部署流程。细节散落各专题文档,本文只做总览 + 指路。
-> 关联:产品/IA [docs/01](01-产品需求-MVP.md)、技术架构与契约 [docs/02](02-技术架构.md)、数据契约 [docs/03](03-数据契约.md)、设计规范 [docs/04](04-设计规范.md)、接口 [docs/06](06-接口文档.md)。
+> 关联:产品/IA [docs/01](01-产品需求-MVP.md)、技术架构与契约 [docs/02](02-技术架构.md)、数据契约 [docs/03](03-数据契约.md)、设计规范 [docs/04](04-设计规范.md)、接口 [docs/06](06-接口文档.md)、迭代与发布 [docs/08](08-迭代与发布.md)。
 
 ## 1. 这是什么
 

docs/08-迭代与发布.md

@@ -0,0 +1,64 @@
+# 迭代与发布流程
+
+> 平台如何一版一版往前走:迭代单元、闭环流程、PRD 文档演进、版本方案、发布收尾清单。
+> 关联:产品/IA [docs/01](01-产品需求-MVP.md);角色边界 [docs/05](05-agent协作准则.md);"改动同步文档"见根 [CLAUDE.md](../CLAUDE.md) 规则 6。
+
+## 1. 迭代单元:端到端垂直切片
+
+按能力域**一个个把模块做到端到端可用**(拼团漏斗为范本),**不先铺框架**。每个切片 = 一个 L2 分析模型或 L3 报表,从取数口径 → 页面 → 验收一条龙,每次都产出**可上线、可汇报**的成果,风险小。
+
+## 2. 闭环流程(每个切片走同一条流水线)
+
+1. **需求登记** → `docs/01` 路线图/状态表(或 issue)。
+2. **PRD 先行** → 动工前先写清/对齐平台级状态 + 模块级详规(对应 CLAUDE.md 规则 1"先想清楚")。
+3. **实现** → `feature-xxx` 分支 → 测试 → PR 合 `feature`。
+4. **收尾** → `CHANGELOG`(规则 5)+ 同步文档(规则 6)。
+5. **上线** → `/look`。
+6. **定期** → `/docs-check` 扫漂移。
+
+> **铁律:PRD 先行**——先文档对齐、再写代码。拼团漏斗是"边做边补文档",以后新模块不要再这样,避免漂移。
+
+## 3. PRD 文档的两层结构与演进
+
+- **平台级 PRD**(`docs/01`,保留):定位、IA(5 能力域)、路线图、全局约束(数据现实/访问权限)、**各模块"可用/待开发"状态总表**。精简、稳定、少改。
+- **模块级 PRD**(`docs/prd/<模块>.md`,按需新增):每个端到端模块一份详规(定义/口径/时间能力/页面/验收,即现在 `docs/01` §4 的形态)。`docs/01` 只留一句定位 + 链接。
+
+**拆分时机**:等**第二个模块动工**时,把现 `docs/01` §4 拼团漏斗详规抽成 `docs/prd/拼团漏斗.md`,§4 收敛为索引。**当前单模块不拆**(拆了是空架子)。
+
+## 4. 版本方案
+
+内部工具、单一部署、暂无外部消费方 → **版本号是里程碑标记,不是依赖管理**,不上严格 SemVer。
+
+| 阶段 | 版本 | 规则 |
+|---|---|---|
+| MVP 内网迭代(现在) | **—(未打号)** | 靠 CHANGELOG 日期 + git SHA;关键状态可 `git tag`(如 `mvp-拼团漏斗`) |
+| 切 `release`(首个稳定内网版) | **v1.0** | 平台第一个正式版 |
+| 每上线**一个新能力域模块** | **minor +1**(v1.1、v1.2…) | 如 v1.1 加留存、v1.2 加看板 |
+| 模块内修复/小改/文案 | **不 bump** | CHANGELOG 记即可 |
+| 平台级大重构(IA 翻修等) | **major +1**(v2.0) | 罕见 |
+
+**例外**:`apps/api` 将来**对外供数**时,单独走标准 SemVer(契约不兼容 → major,兼容加端点/字段 → minor,修复 → patch);在此之前跟随平台里程碑。
+
+**真相源**:`git tag` 是已发布版本的权威;PRD 版本栏、CHANGELOG 只镜像它。
+
+## 5. 三层记录,各管各的(别混)
+
+| 层 | 管什么 | 粒度 | 给谁看 |
+|---|---|---|---|
+| `CHANGELOG.md` | **每次**落地改动(代码/文档) | 细,按日期 | 研发 |
+| `docs/01` 修订记录 | **产品/规格级**变更 | 粗,按日期,里程碑行标版本 | 产品/需求方 |
+| `git tag` + PRD 版本栏 | **里程碑**(版本号) | 只在 bump 点 | 汇报 |
+
+一次版本变更三层都留痕,但粒度不同:CHANGELOG 可能记 20 条、PRD 修订记录记 1 条、tag 打 1 个。
+
+## 6. 发布收尾清单(版本 bump = 新模块上线时跑一遍)
+
+1. **模块详规**写好(`docs/prd/<模块>.md`,或未拆前加 §)。
+2. `docs/01` **状态总表**(§2.1/§2.2)→ 该模块"可用";**路线图**(§5)→ 已交付;§3/§8 纳入。
+3. `docs/01` **版本栏 + 更新日期** → 新版本。
+4. `docs/01` **修订记录**加一行,版本列标 `vX.Y`。
+5. `CHANGELOG` 记(日期 + "发布 vX.Y")。
+6. `git tag vX.Y`。
+7. `package.json` 版本对齐(切 `release` 起)。
+
+**非版本的规格小改**:照规则 6 更对应段 + 更新日期 + 修订记录加一条日期行(**版本列留空**);纯内部实现改动不动 PRD。