lix-2026
3311bd0366
- add npm dev:hot wrapper using cargo-watch and page reload polling - add mnote-web dev hot reload endpoint and coverage - record current architecture review and tracked bug findings across realtime, tree, editor, and AI runtimes Verification: - node scripts/task-dev-hot-plan-test.js - node --check scripts/dev-hot.js - cargo test -p mnote-web dev_hot -- --nocapture
1.5 KiB
1.5 KiB
3-16 [process][bug] tree realtime WS 主链口径与前端 SSE 实现不一致 v1
发现时间：2026-05-17
状态：
[process]关联主线：
03-rust-web
1. 问题定义
当前架构口径已描述 /api/realtime/ws 是树实时 push 主链，/api/tree/events 是 SSE fallback。但前端真实代码仍只发现 EventSource('/api/tree/events') 消费链路，没有发现 /api/realtime/ws 或 new WebSocket 主 consumer。
2. 证据
- routes/mod.rs 注册
/api/tree/events。 - routes/mod.rs 注册
/api/realtime/ws。 - use-sidebar-tree-stream.ts 实际创建
EventSource。 - protocol.ts 固定构造
/api/tree/events。
3. 影响
- 架构文档与前端运行路径不一致。
- live cache 收口时无法判断真实主链。
- 回归测试如果只检查后端 WS route 存在，会误判前端已切换完成。
4. 建议修复
- 明确当前阶段：要么更新架构口径为“前端仍 SSE，WS route 已准备”，要么实现前端 WS consumer。
- 增加浏览器 smoke，断言网络中实际使用的是 WS 主链还是 SSE fallback。
- 文档与测试必须以真实前端消费路径为准。
5. 状态
已确认口径与前端源码不一致，尚未修复。