3.8 KiB
3.8 KiB
实施计划
对应父任务 implement.md 的第 1、6 步。每步一个提交，门禁不过就停。
前置：direct-edit-solver-api 第 2 步（handle manifest）已可用。完整验收需其预览与保存端点就绪。
1. ol-ext 限时探针
- 目标：只回答一个问题——能否复用通用 handle 的命中、pointer 生命周期与视觉反馈。
- 范围：隔离探针目录，不修改生产基线图层，不进依赖清单直到通过。
- 验证：手动跑探针页，确认 OL
Map未重建、proxy 拖拽稳定、基线 source 未被写入、事件能转成 draft 值。 - 门禁：三条同时成立才把
ol-ext固定为依赖。超过一个工作日或任一条不成立，立刻停止排障。 - 回滚点：删除探针目录，改用原生 OL
Snap+ 小型PointerInteractionadapter。数据合约不变，本步失败只换输入层。
2. EditSession 纯逻辑
- 目标：先把可单测的部分做完，与地图解耦。
- 范围：命令栈与 undo/redo；
previewSeq仲裁；handle 事件到约束值的投影；指针位移到米的换算。不含任何 OpenLayers 引用。 - 验证：
npm run test:client:unit—— 命令栈压入/撤销/重做序列正确；乱序响应（后发先到）被丢弃且不覆盖较新预览；投影在四种 kind 上给出预期约束值；同一像素位移在低纬与高纬得到一致的米值（纬度缩放正确）。 - 门禁：四类纯逻辑全部有测试；
EditSession不 importol。 - 回滚点：纯新增模块，无调用方，revert 无影响。
3. 手柄渲染与开关
- 目标：选中道路后能看到正确的手柄，且禁入区可见可解释。
- 范围：
directEdit开关（默认关闭）；selection → manifest 读取；editHandlessource 渲染；reserve 内手柄置灰并带原因提示。只读不可拖。 - 验证：
npm run test:client、npm run build；手测——选中道路出现手柄，拖拽前后Map为同一实例；reserve 内手柄置灰并提示进入JunctionTools；关闭开关后无手柄、无 manifest 请求。 - 门禁：
Map未被重建；基线 source 未被写入。 - 回滚点：开关关闭即止损。
4. 拖拽、ghost 与预览
- 目标：四类能力真正可拖，预览权威且不闪烁。
- 范围：外缘偏移、步行带宽度、车道分隔位置、区间范围控制；
editGhost即时反馈；80ms 防抖与pointerup最终请求；AbortController取消在途请求；editPreview替换；无效草稿诊断与保留最后有效预览。 - 验证：
npm run test:client:unit、npm run test:client、npm run build；手测——拖动外缘时道路面/步行带/车道线/标线/connector 一致更新且只有受影响 source 被替换；车道分隔可独立调整；区间范围手柄改变影响区间且两端平滑；连续快速拖拽松手后无回跳；违反不变量时停在最后有效预览并显示诊断。 - 门禁：只有受影响 source 被替换，无全图层重建；无回跳。
- 回滚点：按能力分批提交，可单独回退某一类手柄。
5. 应用、保存与撤销
- 目标：闭合编辑生命周期。
- 范围：应用/保存/取消；undo/redo 接到命令栈；保存走
expectedDocumentVersion；409 冲突提示。 - 验证：
npm run test:client:unit（保存冲突分支）、npm run test:client、npm run build；手测——未保存编辑可撤销/重做；保存后重新编译几何不变且状态exact；两标签页同时保存后者收到 409 提示且前者结果保留。 - 门禁：撤销不重写已保存历史；409 有明确用户提示而非静默失败。
- 回滚点：revert 后回到第 4 步的预览-only 状态。
步骤依赖
1 与 2 可并行；3 依赖 1 的结论与 2；4 依赖 3；5 依赖 4。第 1 步失败不阻塞 2-5，只改变第 3、4 步的命中与拖拽实现方式。