docs: codify fallback retirement direction

This commit is contained in:
lix-2026
2026-05-10 08:46:43 +08:00
parent b7ceb7afae
commit 2f9ef85350
16 changed files with 616 additions and 63 deletions
+15 -16
View File
@@ -18,7 +18,7 @@
2. `Convex` 继续保留为当前自托管存储 / 实时 / 文件协作底座
3. `mnote-web` 是当前 Rust Web 主执行面,负责 3000 gateway、server-first shell、query / command / projection / transport 与 realtime streamNext App Router 已降为 legacy compat / island bundle source,不再是当前主入口
4. 文档页默认主编辑器已切到页面内 `leptos-tiptap` island
5. `BlockNote` 当前保留为 fallback / 对照链,不再代表默认主编辑器方向
5. `BlockNote` 已退出文档页默认主路径,仅作为历史参考实现 / 对照材料保留
一句话收口:
@@ -82,16 +82,15 @@
### 4.1 入口
- `/mnt/Data1T/mnote/wolai-frontend/src/app/api/documents/page/route.ts`
- `/mnt/Data1T/mnote/wolai-frontend/src/lib/documents/page-aggregate-loader.ts`
- `/mnt/Data1T/mnote/wolai-frontend/src/app/(app)/documents/[id]/page.tsx`
当前文档页读取主链已经不再由页面入口手工拼若干独立字段,而是:
1. Next `GET /api/documents/page` 优先请求 Rust `/api/page-aggregate/:id`
2. 若返回可信的 `mnote.page_aggregate.v1` 快照,则直接作为 `PageAggregateProjection`
3. 只有在 snapshot 不可用或不可信时,才回退到 TS builder 组装 fallback projection
4. 页面入口与 `DocumentContent` 都消费这同一份聚合结果
1. 页面 SSR 入口通过 `page-aggregate-loader.ts` 直接请求 Rust `/api/page-aggregate/:id`
2. `DocumentContent` 的内容重试补拉也直接请求同一条 `/api/page-aggregate/:id` 正式读链
3. 读取主链不再回退到 TS builder;snapshot 不可用或不可信时直接显式失败
4. Next `/api/documents/page` 已退场为明确 `410` 的 compat 边界,不再参与文档页运行时主路径
对应聚合类型定义:
@@ -113,11 +112,7 @@
- `leptos_tiptap_island`
调试桥仍保留:
- `leptos_tiptap_iframe_debug`
兼容回退仍保留:
文档页主路径已不再暴露显式 debug host 选择;历史 `iframe_debug` 宿主仅剩源码参考,不再参与页面 host 选择面。
- `blocknote`
@@ -135,12 +130,12 @@
### 4.5 BlockNote 的当前位置
- `/mnt/Data1T/mnote/wolai-frontend/src/components/editor/blocknote-editor.tsx`
- `/mnt/Data1T/mnote/recycle/wolai-frontend/src/components/editor/blocknote-editor.tsx`
`BlockNote` 当前仍保留,但其定位已变成:
`BlockNote` 当前仍保留回收副本,但其定位已变成:
- fallback / 对照链
- 迁移期保险丝
- 历史参考实现
- 对照材料 / 调试素材
而不是默认主编辑器方向。
@@ -160,7 +155,7 @@
1. Rust 侧虽已提供最小 `Page Aggregate` snapshot,但页面设置、页头标题与 AI 写入口还没有完整闭环到同一组聚合真相
2. 标题 / 正文 / 页面设置虽已开始收口到 `page.*` family,但 projection 回流与运行时语义仍未完全统一
3. 客户端仍保留 fallback builder、preferred sidebar snapshot 与本地 aggregate state reducer,说明页面域单一真源仍在推进中
3. 客户端仍保留 preferred sidebar snapshot 与本地 aggregate state reducer,说明页面域单一真源仍在推进中
因此当前正确表述应是:
@@ -217,6 +212,10 @@
> **树域 realtime 主链由 Rust Web `/api/tree/events` 持有,前端只消费稳定 stream contract 与 projection。**
补充:
> **`3000` 主壳当前已不再通过 `/api/tree/projections/*` 额外维护第二条 runtime live fallbacksnapshot / delta / resync 直接消费 `/api/tree/events` 载荷。**
## 7. Mindmap 与 OnlyOffice
### 7.1 Mindmap