docs: 同步架构口径并整理设计稿状态
- 同步 AGENTS、ARCHITECTURE 与 01-05 总览中的 page aggregate / tree realtime 当前口径\n- 更新 3-3、5-5、5-6 对当前 Rust-first page aggregate 与 tree live stream 进展的描述\n- 将已被 wolai-aline 流程取代的 5-8 迁入 old 并标记 recycle
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# 01-05 当前主线与优先级总览
|
||||
|
||||
> 更新时间:2026-04-22
|
||||
> 更新时间:2026-05-09
|
||||
|
||||
这份总览只做一件事:
|
||||
|
||||
@@ -35,10 +35,10 @@
|
||||
原因:
|
||||
|
||||
- 默认主编辑器已经切到页面内 `leptos-tiptap` island
|
||||
- 标题单一真源已经开始收口
|
||||
- 文档页入口已经消费前端侧 `PageAggregateProjection`
|
||||
- 但 Rust 侧还没有原生 `Page Aggregate` 契约
|
||||
- 标题 / 正文 / 页面设置仍未统一成同一组 page aggregate command family
|
||||
- 文档页读取主链已优先消费 Rust `mnote.page_aggregate.v1` 快照
|
||||
- 标题单一真源与页面写链都已经开始收口到 `page.*` family
|
||||
- 但页面设置运行时语义、页头标题回流与 AI 设置面仍未完全闭环
|
||||
- TS fallback / 页面本地 aggregate state 仍说明页面域尚未完全统一
|
||||
|
||||
### 2.2 Tree Command Cutover
|
||||
|
||||
@@ -61,8 +61,9 @@
|
||||
原因:
|
||||
|
||||
- 当前 sidebar 已有 query snapshot、tree stream、preferred snapshot 选择链
|
||||
- 但正式的 snapshot + delta 主链还没有完全成为唯一实时事实来源
|
||||
- 这会持续带来 refetch 补偿、freshness 选择和旧快照回闪问题
|
||||
- `3000` 当前主壳已接入 `/api/tree/events` 的 snapshot + delta + resync consumer,并已有 browser smoke
|
||||
- 但 Sidebar、page subtree、filetree 与 preferred snapshot 还没有完全统一到同一条 live cache
|
||||
- 这仍会持续带来 refetch 补偿、freshness 选择和旧快照回闪问题
|
||||
|
||||
## 3. 当前仍应保留但不在第一线的 process
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 3-3 [process] Rust Web Tree Realtime Event Stream 方案 v1
|
||||
|
||||
> 更新时间:2026-04-29
|
||||
> 更新时间:2026-05-09
|
||||
>
|
||||
> 关联文档:
|
||||
> - `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/process/2-tree-first-graph-convex-rust-long-term-architecture-v1.md`
|
||||
@@ -258,9 +258,9 @@ Rust Web 负责:
|
||||
- iframe/postMessage tree shell 不是正式 realtime 主链
|
||||
|
||||
|
||||
## 9. 当前实现复核(2026-04-29)
|
||||
## 9. 当前实现复核(2026-05-09)
|
||||
|
||||
这份方案继续留在 `process/`,因为 Rust Web transport 已落地,但当前 `3000` 的 Rust SSR tree/sidebar 消费侧还没有完整闭环到 live stream。
|
||||
这份方案继续留在 `process/`,因为 Rust Web transport 与当前 `3000` 主壳 live consumer 已落地,但 page subtree / filetree / preferred snapshot 仍未完全统一到同一条正式 live cache。
|
||||
|
||||
### 9.1 已完成
|
||||
|
||||
@@ -269,12 +269,12 @@ Rust Web 负责:
|
||||
- [x] `stream_support.rs` 已有 cursor、delta、resync 的基础判定逻辑。
|
||||
- [x] `/api/stream/events` 与 WebSocket snapshot / resync 骨架已存在。
|
||||
- [x] legacy React 侧已有 `useSidebarTreeStream` 与 `EventSource` consumer,并有协议 / delta 单测。
|
||||
- [x] `task112` / `task120` 已覆盖 `/api/tree/events` snapshot 可用性。
|
||||
- [x] 当前 `3000` Rust shell 已直接挂载 tree live `EventSource` consumer,并通过 `data-mnote-tree-live-applied` 应用 delta / resync。
|
||||
- [x] `task112` / `task120` / `task123` 已覆盖 `/api/tree/events` snapshot、delta / resync 与 stream owner 可用性。
|
||||
- [x] `task165` 已验证双 pane 不重复建立第二条 tree live stream。
|
||||
|
||||
### 9.2 仍未完成
|
||||
|
||||
- [ ] 当前 Rust Web 3000 SSR workspace/sidebar shell 还没有直接挂载 live `EventSource` consumer;它主要依赖 SSR snapshot 与交互后重读。
|
||||
- [ ] delta / resync 尚缺面向当前 3000 Rust shell 的浏览器级 smoke。
|
||||
- [ ] Sidebar、page subtree、filetree 还没有全部统一到同一条 live stream cache。
|
||||
- [ ] WS 目前只证明 snapshot/resync 骨架,尚未成为主实时链路。
|
||||
- [ ] 不能把本稿移动到 `done/`,直到 `3000` 当前主界面的树消费侧也完成 snapshot + delta + resync 验收。
|
||||
- [ ] 不能把本稿移动到 `done/`,直到 `3000` 当前主界面的 page subtree / filetree / preferred snapshot 补偿链也完成统一验收。
|
||||
|
||||
@@ -1,11 +1,11 @@
|
||||
# 5-5 [process] 主编辑区与树域单一真源对齐方案 v1
|
||||
|
||||
> 更新时间:2026-04-22
|
||||
> 更新时间:2026-05-09
|
||||
>
|
||||
> 关联文档:
|
||||
> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-4-leptos-tiptap-mainline-correction-v1.md`
|
||||
> - `/mnt/Data1T/mnote/design/old/05-editor-mainline/process/5-3-tiptap-leptos-rust-migration-checklist-v1.md`
|
||||
> - `/mnt/Data1T/mnote/design/04-tree-domain/process/4-sidebar-pagetree-filetree-rust-web-rebuild-v1.md`
|
||||
> - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-sidebar-pagetree-filetree-rust-web-rebuild-v1.md`
|
||||
> - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-4-tree-projection-protocol-contract-v1.md`
|
||||
> - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-tree-first-graph-kernel-v1.md`
|
||||
> - `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-5-1-page-aggregate-contract-v1.md`
|
||||
@@ -34,7 +34,7 @@
|
||||
|
||||
它现在更接近于:
|
||||
|
||||
> **`Rust-aware + Convex-backed + 前端本地组装` 的混合态。**
|
||||
> **`Rust snapshot 优先 + Convex-backed + 前端 fallback / 本地 state 仍存在` 的混合态。**
|
||||
|
||||
因此,当前看到的这些“小问题”:
|
||||
|
||||
@@ -60,10 +60,9 @@
|
||||
|
||||
但以下事实仍然成立:
|
||||
|
||||
- 标题链路虽已开始与树域 canonical snapshot 对齐,但还没有和正文、页面设置统一成同一组 page aggregate command family
|
||||
- 页面正文是一条独立保存链
|
||||
- 页面设置又是一条独立更新链
|
||||
- 页面树 / 文件树与页头标题的一致性已明显改善,但当前 page aggregate projection 仍主要由前端装配而不是 Rust 原生提供
|
||||
- 读取主链虽已优先消费 Rust `mnote.page_aggregate.v1` snapshot,但 snapshot 不可用时仍保留 TS fallback
|
||||
- 标题、正文、页面设置虽已开始收口到同一组 page aggregate command family,但 projection 回流与运行时语义还没完全闭环
|
||||
- 页面树 / 文件树与页头标题的一致性已明显改善,但页头标题、页面设置与编辑器 runtime 还没有完全共享同一份聚合真相
|
||||
- `pageOptions` 已部分进入 `leptos-tiptap` 运行时语义层,但还没有整体收口完成
|
||||
|
||||
所以当前不能把这条线描述成:
|
||||
@@ -110,27 +109,24 @@
|
||||
|
||||
## 3.1 当前页面数据并不是一个统一聚合
|
||||
|
||||
当前文档页在加载时,实际上是把几类数据拆开读取,再由前端壳层重新拼装:
|
||||
当前文档页读取主链已经优先走 Rust `mnote.page_aggregate.v1` 快照,再在 snapshot 不可用或不可信时回退到 TS builder:
|
||||
|
||||
- 页面 meta
|
||||
- 页面标题
|
||||
- 页面设置
|
||||
- 页面正文
|
||||
- 页面子树快照
|
||||
- Rust `/api/page-aggregate/:id` snapshot
|
||||
- TS fallback builder
|
||||
- 页面本地 aggregate state reducer
|
||||
- preferred sidebar snapshot / 页头标题补偿链
|
||||
|
||||
这意味着当前不是:
|
||||
这意味着当前已经不再是:
|
||||
|
||||
- Rust 返回一份稳定的 page aggregate projection
|
||||
- `page.tsx` 手工拉 `meta + content` 再现场拼 props
|
||||
|
||||
而是:
|
||||
但也还不是:
|
||||
|
||||
- Next route 先查 meta
|
||||
- 再查 content
|
||||
- 再把 `title/options/content/pageSubtree` 手动组成页面 props
|
||||
- 页面所有读写、标题回流、页面设置运行时语义都只围绕一份 Rust page aggregate 自动闭环
|
||||
|
||||
这条链本身已经说明:
|
||||
|
||||
> **当前页面不是消费一份 canonical page projection,而是消费几份分裂的子结果。**
|
||||
> **当前页面已经进入 Rust-first 聚合读取阶段,但 canonical page projection 仍未成为页面域唯一真相。**
|
||||
|
||||
### 3.1.1 标题链已开始收口,但尚未完成页面聚合统一
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 5-6 [process] Page Aggregate 单一真源对齐执行清单 v1
|
||||
|
||||
> 更新时间:2026-04-22
|
||||
> 更新时间:2026-05-09
|
||||
>
|
||||
> 关联文档:
|
||||
> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.md`
|
||||
@@ -30,6 +30,7 @@
|
||||
### 2.1 已经成立的事实
|
||||
|
||||
- [x] `leptos-tiptap` 已经成为页面内正式主编辑区,不再是 iframe bridge。
|
||||
- [x] `/api/documents/page` 已优先消费 Rust `mnote.page_aggregate.v1` snapshot,TS builder 退为 fallback。
|
||||
- [x] 正文保存已经能按 `workspaceId/documentId` 正确落到对应页面。
|
||||
- [x] 当前主编辑区已具备可继续推进的基础交互能力。
|
||||
- [x] 当前问题已经不再是“能不能接入主编辑器”,而是“接入后如何收口为单一真源”。
|
||||
@@ -78,7 +79,7 @@
|
||||
- [x] 不再继续给 `DocumentPageProps`、`DocumentContentProps` 零散加字段来扩页面真相。
|
||||
- [x] 文档页加载入口能明确区分“聚合读取结果”和“局部 UI 临时态”。
|
||||
|
||||
补充:当前已新增 `page-aggregate-builder.ts`、`page-aggregate-loader.ts` 与 `/api/documents/page`,文档页 SSR 入口和 `DocumentContent` 的内容重试补拉都已改为消费同一份 `PageAggregateProjection`,不再由 `page.tsx` 手工拼 `meta + content`。Rust 侧仍未直接暴露同名 `Page Aggregate` projection route,但 `storage-convex-bridge` 与 `bridge-runtime` 已开始接受 `page.head.updateTitle / page.layout.updateOptions / page.body.save` 这组 page command family 的命名口径,因此这里先按“等价契约已出现”勾选完成。
|
||||
补充:当前已新增 `page-aggregate-builder.ts`、`page-aggregate-loader.ts` 与 `/api/documents/page`,文档页 SSR 入口和 `DocumentContent` 的内容重试补拉都已改为消费同一份 `PageAggregateProjection`,不再由 `page.tsx` 手工拼 `meta + content`。Rust 侧当前已直接暴露 `/api/page-aggregate/:id` 与 `mnote.page_aggregate.v1` snapshot;`page-aggregate-loader.ts` 会先校验并消费这条 Rust 读链,只有 snapshot 不可用或不可信时才回退到 TS builder。与此同时,`storage-convex-bridge` 与 `bridge-runtime` 已开始接受 `page.head.updateTitle / page.layout.updateOptions / page.body.save` 这组 page command family 的命名口径,因此这里按“读取契约已进入 Rust-first,写入命令面已开始收口”勾选完成。
|
||||
|
||||
### 4.3 退出标准
|
||||
|
||||
|
||||
+1
-1
@@ -1,4 +1,4 @@
|
||||
# 5-8 [process] Wolai 编辑态自动化测试方案 v1(已收口)
|
||||
# 5-8 [process][recycle] Wolai 编辑态自动化测试方案 v1(已收口)
|
||||
|
||||
> 更新时间:2026-04-30
|
||||
>
|
||||
Reference in New Issue
Block a user