diff --git a/design/10-review/README.md b/design/10-review/README.md index eee39b8f..b00e41a6 100644 --- a/design/10-review/README.md +++ b/design/10-review/README.md @@ -1,47 +1,21 @@ # 10-review 审查总览 -本目录汇总当前设计与实现的偏差审查结果。四份分域报告分别覆盖 Rust kernel/web、前端编辑器与树体验、Convex/realtime/storage、次级域与设计治理。 +> 执行状态：本轮 10-review 已完成并迁入 [done/](./done/) 留档。根目录只保留索引，避免后续 worker 把历史审查快照误当成当前待办。 -执行入口以 [顺序执行清单与验收标准](./06-execution-checklist-and-acceptance.md) 为准；`05-tree.md` 的 Resource Tree / File Tree / Page Tree、ObjectIdentity、mindmap 与 `index.md` 隔离主线已经由 `4-24` 与 `5-12` 承接到 `done/`，后续只保留防回归验证。 +最终执行入口： -## 结论 +- [顺序执行清单与验收标准](./done/06-execution-checklist-and-acceptance.md) -当前主线方向总体没有跑偏，但实现仍停留在“主链已切、收口未完”的状态。最需要继续收口的是： +历史审查报告： -1. `Page Aggregate` 的单一真源边界 -2. `tree realtime` 的统一 live cache 与查询模型 -3. `documents.*` / `tree.*` / `page.*` 的 side effect 一致性 -4. legacy / compat / fallback 的显式退场边界 +- [Rust Kernel / Web 实现偏差审查](./done/01-rust-kernel-web-review.md) +- [前端编辑器 / 树体验实现偏差审查](./done/02-frontend-editor-tree-review.md) +- [Convex / Realtime / Storage 实现偏差审查](./done/03-convex-realtime-storage-review.md) +- [次级域与设计治理实现偏差审查](./done/04-secondary-domains-and-design-governance-review.md) +- [树域 Resource Tree / File Tree / Page Tree 判断记录](./done/05-tree.md) -## 优先级摘要 +## 当前口径 -### P0 - -- Rust page write 路由与 artifact 一致性 -- 搜索 / workspace shell / fallback 数据不要再伪装成真实主链 - -### P1 - -- `pageSubtree` 与正文编辑的关系需要明确 -- Sidebar 的 `initial / query / tree_stream` 三源选择要继续向统一 live cache 收口 -- `PageAggregateSource` 的 provenance 口径要和真实读链对齐 -- Convex overview 查询要避免全量扫描放大 - -### P2 - -- 继续清理或标注 legacy compat、debug host、stale mapping -- 对 `design/90-reference` 和次级参考材料保持只读、非上位来源定位 - -## 报告文件 - -- [Rust Kernel / Web 实现偏差审查](./01-rust-kernel-web-review.md) -- [前端编辑器 / 树体验实现偏差审查](./02-frontend-editor-tree-review.md) -- [Convex / Realtime / Storage 实现偏差审查](./03-convex-realtime-storage-review.md) -- [次级域与设计治理实现偏差审查](./04-secondary-domains-and-design-governance-review.md) -- [顺序执行清单与验收标准](./06-execution-checklist-and-acceptance.md) - -## 统一判断 - -当前最准确的描述不是“已经完成单一真源收口”，而是： - -> Rust 已经持有主语义主导权，前端与 Convex 也已切到新主线，但 projection、command、realtime、fallback 仍有若干兼容态残留，需要继续按优先级收口。 +- `done/01` 到 `done/04` 是历史偏差审查快照；其中旧的“未完成 / 风险”条目已由 `done/06` 承接闭环，或转入对应主线设计文档继续跟踪。 +- `done/05-tree.md` 的 Resource Tree / File Tree / Page Tree、ObjectIdentity、mindmap 与 `index.md` 隔离主线已由 `design/04-tree-domain/done/4-24-*` 与 `design/05-editor-mainline/done/5-12-*` 承接完成。 +- `done/06-execution-checklist-and-acceptance.md` 是本轮 10-review 的最终验收依据；后续只作为防回归和口径核验材料。 diff --git a/design/10-review/01-rust-kernel-web-review.md b/design/10-review/done/01-rust-kernel-web-review.md similarity index 98% rename from design/10-review/01-rust-kernel-web-review.md rename to design/10-review/done/01-rust-kernel-web-review.md index 51a18cdc..7d801fd2 100644 --- a/design/10-review/01-rust-kernel-web-review.md +++ b/design/10-review/done/01-rust-kernel-web-review.md @@ -1,5 +1,7 @@ # Rust Kernel / Web 实现偏差审查 +> 执行状态：已归档到 `design/10-review/done/`。本文保留为历史审查快照，当前活跃口径以 `./06-execution-checklist-and-acceptance.md` 为准。 + ## 范围 本次只审查 Rust kernel / protocol / bridge-runtime / mnote-web / storage-convex-bridge 与当前设计主线的一致性。 @@ -116,4 +118,4 @@ Rust kernel / protocol / bridge-runtime / mnote-web 的主干方向与当前设 ## 修改的文件路径 -- `/mnt/Data1T/mnote/design/10-review/01-rust-kernel-web-review.md` +- `/mnt/Data1T/mnote/design/10-review/done/01-rust-kernel-web-review.md` diff --git a/design/10-review/02-frontend-editor-tree-review.md b/design/10-review/done/02-frontend-editor-tree-review.md similarity index 97% rename from design/10-review/02-frontend-editor-tree-review.md rename to design/10-review/done/02-frontend-editor-tree-review.md index ee71789a..5ba4a4c4 100644 --- a/design/10-review/02-frontend-editor-tree-review.md +++ b/design/10-review/done/02-frontend-editor-tree-review.md @@ -1,5 +1,7 @@ # 前端编辑器 / 树体验实现偏差审查 +> 执行状态：已归档到 `design/10-review/done/`。本文保留为历史审查快照，当前活跃口径以 `./06-execution-checklist-and-acceptance.md` 为准。 + ## 范围 本报告只审查 `wolai-frontend` 当前文档页、`leptos-tiptap` island host、`Page Aggregate` 消费链、Sidebar / tree shell / tree stream 与设计文档的一致性。 @@ -120,4 +122,4 @@ ## 修改的文件 -- `/mnt/Data1T/mnote/design/10-review/02-frontend-editor-tree-review.md` +- `/mnt/Data1T/mnote/design/10-review/done/02-frontend-editor-tree-review.md` diff --git a/design/10-review/03-convex-realtime-storage-review.md b/design/10-review/done/03-convex-realtime-storage-review.md similarity index 98% rename from design/10-review/03-convex-realtime-storage-review.md rename to design/10-review/done/03-convex-realtime-storage-review.md index b7427b94..36845f4a 100644 --- a/design/10-review/03-convex-realtime-storage-review.md +++ b/design/10-review/done/03-convex-realtime-storage-review.md @@ -1,5 +1,7 @@ # Convex / Realtime / Storage 实现偏差审查 +> 执行状态：已归档到 `design/10-review/done/`。本文保留为历史审查快照，当前活跃口径以 `./06-execution-checklist-and-acceptance.md` 为准。 + ## 范围 本报告审查 Convex / storage bridge / realtime / Page Aggregate 数据底座与当前设计主线的一致性，重点对照以下方向： @@ -212,4 +214,4 @@ tree command route 是一致的： ## 修改的文件路径 -- `design/10-review/03-convex-realtime-storage-review.md` +- `design/10-review/done/03-convex-realtime-storage-review.md` diff --git a/design/10-review/04-secondary-domains-and-design-governance-review.md b/design/10-review/done/04-secondary-domains-and-design-governance-review.md similarity index 97% rename from design/10-review/04-secondary-domains-and-design-governance-review.md rename to design/10-review/done/04-secondary-domains-and-design-governance-review.md index f2d0bb1c..a822ef53 100644 --- a/design/10-review/04-secondary-domains-and-design-governance-review.md +++ b/design/10-review/done/04-secondary-domains-and-design-governance-review.md @@ -1,5 +1,7 @@ # 次级域与设计治理实现偏差审查 +> 执行状态：已归档到 `design/10-review/done/`。本文保留为历史审查快照，当前活跃口径以 `./06-execution-checklist-and-acceptance.md` 为准。 + ## 范围 本次只审查 Mindmap、AI、OnlyOffice、Wolai-aline、SiYuan reference，以及 `design/process/done` 治理口径与当前实现方向的一致性。重点读取了 `ARCHITECTURE.md`、`design/README.md`、`design/06-mindmap/process/*`、`design/07-ai/process/*`、`design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md`、`design/09-siyuan-reference/process/9-siyuan-reference-boundary-and-adoption-v1.md`、`design/90-reference/*`，并对照了 Mindmap、AI route/lib、OnlyOffice route/adapter 与相关 Convex/Rust runtime 代码。 @@ -63,4 +65,4 @@ ## 本次修改文件 -- `/mnt/Data1T/mnote/design/10-review/04-secondary-domains-and-design-governance-review.md` +- `/mnt/Data1T/mnote/design/10-review/done/04-secondary-domains-and-design-governance-review.md` diff --git a/design/10-review/05-tree.md b/design/10-review/done/05-tree.md similarity index 91% rename from design/10-review/05-tree.md rename to design/10-review/done/05-tree.md index e5a74bf8..b94cde02 100644 --- a/design/10-review/05-tree.md +++ b/design/10-review/done/05-tree.md @@ -1,4 +1,4 @@ -> 执行状态：本文是 10-review 阶段的树域判断记录，不再作为待办清单直接执行。Resource Tree / File Tree / Page Tree 真源合同已由 `/mnt/Data1T/mnote/design/04-tree-domain/done/4-24-resource-tree-filetree-pagetree-source-contract-checklist-v1.md` 承接；主编辑区 Object Tab、mindmap object editor、`index.md` 隔离已由 `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-12-main-editor-object-tab-resource-alignment-checklist-v1.md` 承接。后续只需按 `06-execution-checklist-and-acceptance.md` 保留 smoke 防回归。 +> 执行状态：本文已归档到 `design/10-review/done/`，是 10-review 阶段的树域判断历史记录，不再作为待办清单直接执行。Resource Tree / File Tree / Page Tree 真源合同已由 `/mnt/Data1T/mnote/design/04-tree-domain/done/4-24-resource-tree-filetree-pagetree-source-contract-checklist-v1.md` 承接；主编辑区 Object Tab、mindmap object editor、`index.md` 隔离已由 `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-12-main-editor-object-tab-resource-alignment-checklist-v1.md` 承接。后续只需按 `06-execution-checklist-and-acceptance.md` 保留 smoke 防回归。 结论 我基本同意你的方向，但要把“文件树为根源”说得更精确：不应让“文件树 UI 组件”成为真源，而应让 Rust kernel 中的 workspace resource tree / file tree projection 背后 @@ -48,7 +48,7 @@ 我推荐第二种。 阶段 0：冻结合同 - 先把 design/10-review/05-tree.md 升级为正式设计合同，建议后续移动或补一份到： + 历史建议曾是：先把 design/10-review/05-tree.md 升级为正式设计合同，后续移动或补一份到： - design/04-tree-domain/process/4-24-resource-tree-filetree-pagetree-source-contract-v1.md - 或 design/05-editor-mainline/process/5-11-main-editor-object-tab-resource-tree-alignment-v1.md diff --git a/design/10-review/06-execution-checklist-and-acceptance.md b/design/10-review/done/06-execution-checklist-and-acceptance.md similarity index 97% rename from design/10-review/06-execution-checklist-and-acceptance.md rename to design/10-review/done/06-execution-checklist-and-acceptance.md index a46c1dcd..48bf96de 100644 --- a/design/10-review/06-execution-checklist-and-acceptance.md +++ b/design/10-review/done/06-execution-checklist-and-acceptance.md @@ -1,14 +1,16 @@ # 10-review 顺序执行清单与验收标准 +> 执行状态：已完成并归档到 `design/10-review/done/`。本文是本轮 10-review 的最终验收依据与防回归口径，根目录 `design/10-review/README.md` 仅保留索引。 + > 更新时间：2026-05-14 > > 上游依据： > - `/mnt/Data1T/mnote/design/10-review/README.md` -> - `/mnt/Data1T/mnote/design/10-review/01-rust-kernel-web-review.md` -> - `/mnt/Data1T/mnote/design/10-review/02-frontend-editor-tree-review.md` -> - `/mnt/Data1T/mnote/design/10-review/03-convex-realtime-storage-review.md` -> - `/mnt/Data1T/mnote/design/10-review/04-secondary-domains-and-design-governance-review.md` -> - `/mnt/Data1T/mnote/design/10-review/05-tree.md` +> - `/mnt/Data1T/mnote/design/10-review/done/01-rust-kernel-web-review.md` +> - `/mnt/Data1T/mnote/design/10-review/done/02-frontend-editor-tree-review.md` +> - `/mnt/Data1T/mnote/design/10-review/done/03-convex-realtime-storage-review.md` +> - `/mnt/Data1T/mnote/design/10-review/done/04-secondary-domains-and-design-governance-review.md` +> - `/mnt/Data1T/mnote/design/10-review/done/05-tree.md` > - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-24-resource-tree-filetree-pagetree-source-contract-checklist-v1.md` > - `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-12-main-editor-object-tab-resource-alignment-checklist-v1.md` @@ -336,7 +338,7 @@ - `rust/crates/storage-convex-bridge/src/mapping.rs`：`page.aggregate.get` 显式标注为 stale/future compat placeholder。 - `wolai-frontend/src/app/api/documents/page/route.ts`：返回 410，提示直接使用 `/api/page-aggregate/:documentId`。 - `wolai-frontend/src/app/api/mnote-web/stream/route.ts`：返回 410，提示直接使用 `/api/tree/events`。 -- `design/10-review/03-convex-realtime-storage-review.md`：已明确指出 `documents:getPageAggregate` 目前缺少 Convex 实现，属于方向滞后或 future/stale 口径。 +- `design/10-review/done/03-convex-realtime-storage-review.md`：已明确指出 `documents:getPageAggregate` 目前缺少 Convex 实现，属于方向滞后或 future/stale 口径。 - `rust/crates/storage-convex-bridge/src/mapping.rs`：`page.aggregate.get` 改为 `queries:unknown`，并注释说明 page aggregate 主读链由 Rust route + `bridge-runtime` 组装，避免误触发不存在的 `documents:getPageAggregate`。 - 已通过：`rg -n "documents:getPageAggregate|getPageAggregate" rust wolai-frontend src -g '!node_modules' -g '!target'`，仅剩 mapping 注释说明，无生产调用。 - 已通过：`cargo test -p storage-convex-bridge -- --nocapture`。 @@ -391,7 +393,7 @@ 建议修改范围： - `design/10-review/README.md` -- `design/10-review/05-tree.md` +- `design/10-review/done/05-tree.md` - `design/05-editor-mainline/done/5-5-1-page-aggregate-contract-v1.md` - `design/90-reference/` @@ -411,8 +413,8 @@ 证据： -- `design/10-review/README.md`：补充执行入口，指向 `06-execution-checklist-and-acceptance.md`，并说明 `05-tree.md` 核心主线已由 `4-24` / `5-12` 承接。 -- `design/10-review/05-tree.md`：开头增加执行状态，明确本文不再作为待办清单直接执行。 +- `design/10-review/README.md`：补充执行入口，指向 `done/06-execution-checklist-and-acceptance.md`，并说明 `done/05-tree.md` 核心主线已由 `4-24` / `5-12` 承接。 +- `design/10-review/done/05-tree.md`：开头增加执行状态，明确本文不再作为待办清单直接执行。 - `design/05-editor-mainline/done/5-5-1-page-aggregate-contract-v1.md`：`showHeadingNumbers` / `embedDefaultBlockId` 改为“runtime payload 已贯通，但深语义未完成”的口径。 - `design/90-reference/90-1-filetree.md`、`design/90-reference/90-2-yemianshu.md`：删除“需要我给你...”对话尾巴。 - `design/README.md`：补充 `90-reference/` 只能作为生态资料或背景材料，不能覆盖主线设计稿。