49 lines
2.7 KiB
Markdown
49 lines
2.7 KiB
Markdown
|
# 4-52 resource lifecycle 兼容路径在 Convex 退役后丢失 artifact / 拒绝 mindmap lifecycle
|
|||
|
|
|
|||
|
|
## 状态
|
|||
|
|
|
|||
|
|
- 状态：done
|
|||
|
|
- Owner：04-tree-domain / bridge-runtime / resource lifecycle command
|
|||
|
|
- 发现时间：2026-06-01
|
|||
|
|
- 修复时间：2026-06-01
|
|||
|
|
|
|||
|
|
## 现象
|
|||
|
|
|
|||
|
|
执行 `cargo test -p mnote-web mindmap -- --test-threads=1` 时，mindmap 相关宽测曾失败：
|
|||
|
|
|
|||
|
|
- `mindmap_put_derives_workspace_and_returns_tree_artifacts`
|
|||
|
|
- `mindmap_command_apply_returns_object_artifacts_without_tree_resync`
|
|||
|
|
- `mindmap_delete_restore_keeps_markdown_reference_out_of_lifecycle_command`
|
|||
|
|
- `mindmap_trash_routes_delete_restore_purge_and_empty`
|
|||
|
|
- `sidebar_runtime_routes_local_mindmap_and_office_assets`
|
|||
|
|
|
|||
|
|
前两个失败是 `execute_retired_command_plan_with_artifacts()` 在 Convex 退役后仍能执行 fixture mutation，但把 Rust artifact plan 置为 `None`，导致调用方拿不到 `commandLog` / `domainEvent`。
|
|||
|
|
|
|||
|
|
后两个失败是 `tree.resource.archive/restore/purge/rename` 在 bridge-runtime 生成 resource-kind 专用函数名前，会先经过 `build_write_request()`；旧 `legacy_command_function_name()` 没有这些正式 tree resource command 名，导致 mindmap lifecycle 被 `retired_bridge_error()` 拒绝。
|
|||
|
|
|
|||
|
|
最后一个失败是 runtime 拆分后，OnlyOffice local open 逻辑已迁到 `sidebar-filetree-open-runtime.js`，但 Rust include 断言仍检查旧 `sidebar-tree-runtime.js` 字符串。
|
|||
|
|
|
|||
|
|
## 根因
|
|||
|
|
|
|||
|
|
- Convex 退役后，artifact 持久化不能再作为兼容路径成功条件；Rust artifact plan 应继续返回给调用方和 realtime consumer。
|
|||
|
|
- resource lifecycle command 的正式命名已从表面 compat alias 收口到 `tree.resource.*`，但旧 Convex 兼容映射表未允许这些名称通过前置 request 构造。
|
|||
|
|
- browser runtime 模块拆分后，测试断言没有同步到新的 canonical owner 文件。
|
|||
|
|
|
|||
|
|
## 修复
|
|||
|
|
|
|||
|
|
- `rust/crates/mnote-web/src/transport/convex.rs`
|
|||
|
|
- `persist_runtime_command_artifacts()` 在 Convex 退役路径改为 no-op 成功。
|
|||
|
|
- `execute_retired_command_plan_with_artifacts()` 重新构造并返回 `RuntimeCommandArtifactPlan`，不重新启用 Convex artifact 持久化。
|
|||
|
|
- `rust/crates/bridge-runtime/src/lib.rs`
|
|||
|
|
- `legacy_command_function_name()` 允许 `tree.resource.archive/restore/purge/rename` 通过前置 request 构造；最终函数名仍由 resource lifecycle plan 按资源类型分流。
|
|||
|
|
- `rust/crates/mnote-web/src/ssr/pages/layout.rs`
|
|||
|
|
- OnlyOffice local open 断言改查 `SIDEBAR_FILETREE_OPEN_RUNTIME_JS`。
|
|||
|
|
- `rust/crates/mnote-web/src/routes/resource_trash.rs`
|
|||
|
|
- `delete_json()` test helper 在状态码失败时输出 body，便于后续定位真实错误码。
|
|||
|
|
|
|||
|
|
## 验证
|
|||
|
|
|
|||
|
|
- `cargo test -p mnote-web mindmap -- --test-threads=1`
|
|||
|
|
|
|||
|
|
结果：26 个 mindmap 相关测试全部通过。
|