docs(design): 归档 10-review 到 done
将 10-review 的 01-06 文档统一迁入 done/，根目录 README 收缩为索引。 补充各历史审查稿的归档说明，并把 06 的活跃引用改到 done/ 下，避免后续重复把已完成审查当成当前待办。
This commit is contained in:
lix-2026
+13
-39
@@ -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 的最终验收依据；后续只作为防回归和口径核验材料。
|
||||
|
||||
+3
-1
@@ -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`
|
||||
+3
-1
@@ -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`
|
||||
+3
-1
@@ -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`
|
||||
+3
-1
@@ -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`
|
||||
@@ -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
|
||||
+11
-9
@@ -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/` 只能作为生态资料或背景材料，不能覆盖主线设计稿。
|
||||
Reference in New Issue
Block a user