docs(cqrs-rewrite): 精简 archive 恢复材料导航

- 更新 archive todo 顶部导航,补充截止恢复点、阶段索引与跳转约定

- 更新 archive trace 顶部索引,突出验证锚点与阶段回看入口
This commit is contained in:
gewuyou 2026-05-11 12:42:19 +08:00
parent 7fa9d5ff17
commit af4e988a5b
2 changed files with 77 additions and 0 deletions

View File

@ -5,6 +5,50 @@
围绕 `GFramework` 当前的双轨 CQRS 现状,继续完成以“去外部依赖、降低反射、收口公开入口”为目标的 围绕 `GFramework` 当前的双轨 CQRS 现状,继续完成以“去外部依赖、降低反射、收口公开入口”为目标的
CQRS 迁移与收敛。 CQRS 迁移与收敛。
## 归档使用说明
- 本文件只覆盖 `CQRS-REWRITE-RP-076``CQRS-REWRITE-RP-131` 的历史恢复材料,用于 boot 或人工恢复时快速定位旧阶段锚点。
- `RP-131` 是本归档的截止恢复点,不是当前 active 入口;继续恢复时应回到 active `todos/``traces/`,再从 archive 补读所需历史。
- 若只需要历史结论优先查本文件的阶段索引若需要当轮验证细节、worker 边界或判断过程,再跳到配套 archive trace。
## 归档截止点
- 截止恢复点:`CQRS-REWRITE-RP-131`
- 截止阶段benchmark 并发运行隔离入口
- 截止结论:
- benchmark 入口已支持 `--artifacts-suffix <suffix>`,并通过独立 host 工作目录隔离 BenchmarkDotNet 并发运行产物。
- 截止轮次的写面仍收敛在 `GFramework.Cqrs.Benchmarks` 单模块,没有重新扩散到 runtime、测试或 active tracking。
- 截止后的历史跳转:
- 需要 `RP-129``RP-131` 的 benchmark 隔离 / scoped-host / worker 波次细节:查看下方 `2026-05-11`
- 需要 `RP-123``RP-128` 的 PR review 收口与 stream/request benchmark 对齐:查看下方 `2026-05-09`
- 需要 `RP-113``RP-122` 的 notification publisher 与 request 热路径收敛:查看下方 `2026-05-08`
- 需要 `RP-101``RP-112` 的 benchmark 基线、PR review 收口与 bridge 之后的性能阶段:查看下方 `2026-05-07`
- 需要 `RP-076``RP-100` 的较早 generator gate / legacy bridge / benchmark 引入历史:查看下方 `2026-04-30``2026-05-04``2026-05-06`
## 阶段索引
- `RP-129` ~ `RP-131`
- 主题benchmark 多 worker 波次、stream scoped-host、并发运行隔离入口。
- 入口:`2026-05-11`
- `RP-123` ~ `RP-128`
- 主题:`PR #344` / `PR #345` review 收口stream lifetime 与 generated binding 对齐。
- 入口:`2026-05-09`
- `RP-113` ~ `RP-122`
- 主题notification publisher 公开策略、组合根配置、fan-out benchmark、request 零管道热路径缓存。
- 入口:`2026-05-08`
- `RP-101` ~ `RP-112`
- 主题request / stream benchmark 对照、性能门槛、`PR #339` ~ `PR #341` review 收口。
- 入口:`2026-05-07`
- `RP-076` ~ `RP-100`
- 主题active 入口历史收敛、generator contract gate、legacy Core CQRS bridge、benchmark 基础设施引入。
- 入口:`2026-04-30``2026-05-04``2026-05-06`
## 跳转约定
- 想找某个恢复点,直接搜索 `CQRS-REWRITE-RP-xxx`
- 想找某一轮最小验证,优先搜索该阶段下的“验证”或“本轮验证”。
- 想找下一批从哪里接续,优先搜索该阶段下的“下一恢复点”或“当前下一步”。
## 当前恢复点 ## 当前恢复点
- 恢复点编号:`CQRS-REWRITE-RP-131` - 恢复点编号:`CQRS-REWRITE-RP-131`

View File

@ -1,5 +1,38 @@
# CQRS 重写迁移追踪 # CQRS 重写迁移追踪
## 归档导航
- 本 trace 归档承接 `CQRS-REWRITE-RP-076``CQRS-REWRITE-RP-131` 的执行细节,作用是给 boot / 人工恢复提供“按阶段回看”的证据面,而不是重新充当 active trace。
- 若只需要知道历史阶段做了什么、下一步曾指向哪里,先看对应日期块的首段与“下一恢复点”。
- 若只需要验证锚点优先看各阶段下的“本轮验证”“本轮验证结果”或“验证RP-xxx”。
## 快速索引
- `2026-05-11`
- `RP-129` ~ `RP-131`
- 主题benchmark 多 worker 波次、stream scoped-host、并发运行隔离入口。
- `2026-05-09`
- `RP-123` ~ `RP-128`
- 主题:`PR #344` / `PR #345` review 收口stream lifetime 与 generated binding 对齐。
- `2026-05-08`
- `RP-101` ~ `RP-122`
- 主题notification publisher、request 热路径、benchmark 对照与 review 收口。
- `2026-05-07`
- `RP-093` ~ `RP-100`
- 主题legacy bridge、stream pipeline seam、性能门槛与 benchmark 对照。
- `2026-05-06`
- `RP-083` ~ `RP-091`
- 主题generator gate 回归、benchmark 基础设施、startup / invoker 对照。
- `2026-05-04``2026-04-30`
- `RP-076` ~ `RP-082`
- 主题active 入口历史收敛、generator contract gate 与早期 PR 锚点整理。
## 跳转约定
- 搜索 `CQRS-REWRITE-RP-xxx` 可直接定位单个恢复点。
- 搜索“下一恢复点”可快速看到该阶段向后衔接的建议。
- 搜索“本轮结论”可快速判断该阶段是否值得继续细读。
## 2026-05-11 ## 2026-05-11
### 阶段benchmark 并发运行隔离入口CQRS-REWRITE-RP-131 ### 阶段benchmark 并发运行隔离入口CQRS-REWRITE-RP-131