docs: codify fallback retirement direction
This commit is contained in:
+15
-16
@@ -18,7 +18,7 @@
|
||||
2. `Convex` 继续保留为当前自托管存储 / 实时 / 文件协作底座
|
||||
3. `mnote-web` 是当前 Rust Web 主执行面,负责 3000 gateway、server-first shell、query / command / projection / transport 与 realtime stream;Next 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 fallback;snapshot / delta / resync 直接消费 `/api/tree/events` 载荷。**
|
||||
|
||||
## 7. Mindmap 与 OnlyOffice
|
||||
|
||||
### 7.1 Mindmap
|
||||
|
||||
Reference in New Issue
Block a user