2026-05-24-15-55-48 增加项目锁定与切片控件修正

工程分析/经验记录.md

@@ -1693,3 +1693,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 后续做 STL 到 Label Map 的切面填充时，不能只按全局行交点两两配对，必须先按轮廓连通性分组。遇到长线桥接，应同时检查源 STL 的边界边/非流形边和体素化配对策略；如果 STL 是真实中心线或开口片面，只能近似显示，不能承诺恢复真实医学实体。每次修改导出算法后，至少用包含中文构件名和复杂肝脏血管的项目执行一次 `separate + all` 导出，并用 `tar -tzf` 验证文件完整。
+
+## 2026-05-24-15-55-48 项目锁定状态与切片滑块方向要分开建模
+
+A. 具体问题
+
+用户要求项目库支持锁定/解锁项目，锁定时保存位姿快照到 `项目数据/锁定结果/`；已锁定项目进入逆向工作区时提示需要解锁；项目列表可筛选未上锁项目并按最后处理时间排序。同时，DICOM 切片位置滑条不应显示进度色，且第 1 张应位于滑条顶部，向下查看到第 N 张。
+
+B. 产生问题原因
+
+项目此前没有锁定字段、最后处理时间和锁定快照 API，项目列表只能按读取顺序展示。切片显示层号已经使用 `total - sliceIndex` 转换为用户可见顺序，但滑块值仍使用旧的反向映射和底部进度填充，导致第 1 张出现在滑条底部，并被误看成进度条。
+
+C. 解决问题方案
+
+为项目状态增加 `locked`、`lockedAt`、`unlockedAt`、`lastProcessedAt`、`lockedPoseSnapshotPath`，新增锁定 API；锁定时写入只包含项目元数据、模型位姿、构件样式和最新分割结果的 JSON 快照，不写入原始 DICOM/STL。项目库增加锁定/解锁按钮、未上锁筛选、锁定提示和最后处理时间排序；逆向工作区自身也拦截已锁定项目。切片滑块改用实际切片索引作为控件值，保留显示层号转换，并删除滑条上的彩色填充层。
+
+D. 后续如何避免问题
+
+凡是新增项目运行态数据，都要同时考虑后端状态归一化、前端类型、API、列表排序、Docker 持久化挂载和 `.gitignore`。锁定类快照属于运行态追溯数据，不应混入源码 commit。DICOM 切片控件要明确区分“数组索引”“用户显示层号”和“滑块位置”，不要用同一个变量同时表达三种语义。