lix-2026
cdff672aa5
Document the VSCode-like local-first product shape, demote Convex to a control-plane role, and retire stale architecture drafts. Add local workspace migration/export references plus smoke coverage for no-Convex managed workspace startup, local markdown title/body/options persistence, asset upload behavior, and Convex fixture export. Verification: git diff --cached --check; node scripts/check-local-first-convex-guard.js --staged; node scripts/task444-convex-workspace-export-local-fixture-smoke.js; node scripts/task166-local-first-managed-workspace-no-convex-smoke.js; node scripts/task167-local-markdown-title-body-options-no-convex-smoke.js
63 lines
2.0 KiB
Markdown
63 lines
2.0 KiB
Markdown
# 5-22 [done][bug] documents.content.get 在 Page Aggregate 前剥离原生块文档字段 v1
|
||
|
||
> 发现时间：2026-05-18
|
||
>
|
||
> 状态：`[done]`
|
||
>
|
||
> 关联主线：`05-editor-mainline`
|
||
|
||
## 1. 问题定义
|
||
|
||
`page.aggregate.get` 已支持按 `editorDocument -> blockDocument -> documents.content` 的顺序构建正文真相，但 `/api/page-aggregate/:id` 主链会先通过 `documents.content.get` 读取内容。
|
||
|
||
旧的 `DocumentContentResult` 只保留：
|
||
|
||
- `content`
|
||
- `revision`
|
||
- `conflictDetectionKey`
|
||
- `title`
|
||
- `pageSubtree`
|
||
|
||
上游返回的 `editorDocument / blockDocument / tiptapDocument` 被提前剥离，导致 Page Aggregate route 真实运行时仍回落到 `documents.content`。
|
||
|
||
## 2. 根因
|
||
|
||
`bridge-runtime` 的 `build_document_content_result` 没有把原生块文档字段带入 `DocumentContentResult`。
|
||
|
||
这使 5-19 的 Page Aggregate 优先级修复只在合成输入测试里成立，真实 `mnote-web` route 入口仍拿不到原生字段。
|
||
|
||
## 3. 修复
|
||
|
||
- `core-protocol::DocumentContentResult` 新增可选字段：
|
||
- `editorDocument`
|
||
- `tiptapDocument`
|
||
- `blockDocument`
|
||
- `blockProjectionVersion`
|
||
- `build_document_content_result` 保留这些上游字段。
|
||
- `mnote-web` Page Aggregate route 回归测试加入含 `editorDocument` 的 `documents:getContent` fixture，并断言：
|
||
- `body.projectionSource=editorDocument`
|
||
- `body.blockDocument.rootBlockIds[0]=editor_1`
|
||
- `body.blockDocument.blocks[0].text` 来自 `editorDocument`
|
||
|
||
## 4. 验证
|
||
|
||
RED：
|
||
|
||
```bash
|
||
cargo test --manifest-path rust/Cargo.toml -p mnote-web page_aggregate_endpoint_returns_snapshot_contract -- --nocapture
|
||
```
|
||
|
||
旧实现失败，`projectionSource` 仍为 `documents.content`。
|
||
|
||
GREEN：
|
||
|
||
```bash
|
||
cargo test --manifest-path rust/Cargo.toml -p mnote-web page_aggregate_endpoint_returns_snapshot_contract -- --nocapture
|
||
```
|
||
|
||
结果：`1 passed`。
|
||
|
||
## 5. 剩余边界
|
||
|
||
这修复的是 Rust route 读取链字段保留；底层 Convex schema/mutation 是否已完整原生落库仍按后续持久层迁移继续跟进。
|