# 需求分析-2026-05-24-15-55-48

## 开始时间

2026-05-24-15-55-48

## 原始需求摘要

1. 逆向工作区“构件层级”标题右侧增加全局小眼睛按钮，可一键显示或隐藏所有构件。
2. 项目列表中增加项目锁定能力：在“进入逆向工作区”左侧增加“锁定按钮”；锁定时将位姿数据保存到 `项目数据/锁定结果/`；进入逆向工作区时若项目已锁定则提示需要解锁；项目列表左侧支持筛选未上锁项目；项目按最后处理时间排序。
3. 修正 DICOM 切片位置滚动条：滚动后轨道不要出现进度色；显示顺序保持正确，但 `1` 应位于滚动条最上方，通过下拉从 `1` 到 `N` 查看切片。

## 业务目标

- 让批量构件显示控制更高效，便于快速观察 DICOM 与 STL 的融合效果。
- 为项目处理状态增加可控的“锁定”机制，避免已确认位姿的项目被误进入/误编辑。
- 将锁定时的关键位姿数据落盘，便于后续追溯和复核。
- 让切片滚动控件语义与用户认知一致：顶部为第 1 张，向下逐步增加。

## 输入与输出

- 输入：项目列表操作、构件可见性操作、DICOM 切片滚动条操作。
- 输出：项目锁定状态、锁定结果 JSON 文件、构件显示状态更新、正确方向的切片预览与无进度色滚动条。

## 影响范围

- 前端：项目库、逆向工作区、DICOM 切片控件、构件层级工具栏。
- 后端：项目状态结构、锁定/解锁接口、锁定结果落盘、项目排序字段维护。
- 文档：`Docker部署/` 部署说明与工程分析经验记录。

## 关键约束

- 必须沿用现有 `WebSite/server.ts` 的项目状态持久化方式。
- 新增字段需要兼容既有 `state.json`，避免旧项目读取失败。
- 锁定结果必须写入仓库根目录下的 `项目数据/锁定结果/`。
- 不提交大型医学影像数据、运行态导出文件或无关工作区变化。

## 风险点

- 锁定后禁止进入工作区需要和项目卡片按钮状态、错误提示保持一致。
- 位姿数据来源可能同时存在于项目级 `modelPose` 和后端当前状态，需要归一化保存。
- DICOM 视图已经做过切片编号反转，滚动方向调整时不能再次破坏显示编号。
- 一键隐藏所有构件会影响跨页面共享样式，需要调用既有构件样式 API。

## 默认假设

- “锁定按钮”需要支持再次点击解锁，解锁后允许进入逆向工作区。
- “最后处理时间”使用项目最近更新时间、最后导出时间或最后锁定时间中的最新值排序。
- 切片滚动条无需保留蓝色进度轨道，只保留中性轨道与滑块。