REVOXELSEG_DICOM/工程分析/实现方案-2026-05-24-15-55-48.md

实现方案-2026-05-24-15-55-48

实现方案文档路径

工程分析/实现方案-2026-05-24-15-55-48.md

修改目标

• 在逆向工作区构件层级标题右侧增加全局显隐按钮。
• 在项目库项目卡片中增加锁定/解锁能力，并将锁定位姿数据保存到 项目数据/锁定结果/。
• 项目列表支持未锁定筛选，并按最后处理时间倒序排列。
• 修正 DICOM 切片滚动条的方向与无进度色视觉。

涉及路径

• WebSite/server.ts
• WebSite/src/types.ts
• WebSite/src/lib/api.ts
• WebSite/src/components/ProjectLibrary.tsx
• WebSite/src/components/ReverseWorkspace.tsx
• WebSite/src/index.css
• Docker部署/
• 工程分析/经验记录.md

技术路线

• 后端为项目状态增加 locked、lockedAt、lastProcessedAt、lockedPoseSnapshotPath 等兼容字段，并提供锁定/解锁 API。
• 锁定时读取当前项目位姿、构件样式和基础元数据，写入 项目数据/锁定结果/{projectName或projectId}-{timestamp}.json。
• 前端项目库使用新增 API 切换锁定状态；项目卡片在进入逆向工作区前判断锁定状态并提示。
• 逆向工作区构件层级右侧新增全局眼睛按钮，批量更新所有构件的 visible 字段。
• 切片滑块保持顶部为 1、底部为 N，去掉滚动后轨道进度色。

执行步骤

1. 阅读现有项目类型、项目库、逆向工作区和后端项目 API。
2. 扩展类型与 API 封装。
3. 实现后端锁定状态归一化、锁定结果落盘和接口。
4. 实现项目库锁定按钮、未锁定筛选、排序与锁定提示。
5. 实现逆向工作区全局构件显隐按钮。
6. 修正切片滚动条方向和 CSS。
7. 同步 Docker 部署说明。
8. 运行 lint/build，重新部署并验证。
9. 提交并推送 Gitea。

兼容性与回滚方案

• 旧项目缺少锁定字段时默认 locked=false，缺少最后处理时间时回退到 updatedAt、createdAt。
• 如锁定结果目录不存在则由后端自动创建。
• 回滚时可移除新增 API 和前端按钮，已有锁定 JSON 文件不影响系统启动。

预计文件变更

• 新增本次三份工程分析文档。
• 修改前后端项目状态、交互和样式文件。
• 修改 Docker 部署说明，记录新增锁定结果目录和功能。
• 追加经验记录。

提交与部署策略

• 仅暂存本次相关文档、前后端源码和 Docker 文档。
• Commit message 包含 2026-05-24-15-55-48 与简要描述。
• 使用 tmux 会话 revoxelseg-dicom 重新运行 npm run serve -- --host 0.0.0.0 --port 4000。