3.9 KiB
3.9 KiB
实现方案:逆向结果复核增强与管理功能修复
实现方案文档路径:工程分析/实现方案-2026-05-20-14-53-31.md
修改目标
增强项目库逆向分割结果的复核交互,补齐逆向工作区映射视图 DICOM 控制,优化离开保存提示逻辑,修复起始页标题和系统管理用户操作。
涉及路径
WebSite/src/App.tsxWebSite/src/components/Login.tsxWebSite/src/components/ProjectLibrary.tsxWebSite/src/components/ReverseWorkspace.tsxWebSite/src/components/UserManagement.tsxWebSite/src/lib/api.tsWebSite/src/types.tsWebSite/server.ts工程分析/需求分析-2026-05-20-14-53-31.md工程分析/实现方案-2026-05-20-14-53-31.md工程分析/测试方案-2026-05-20-14-53-31.md工程分析/经验记录.md
技术路线
- 检查登录页、主入口、项目库、逆向工作区和用户管理现有实现。
- 后端项目状态归一化时默认项目不再继承旧保存结果,确保初始逆向分割结果为空。
- 项目库逆向分割结果页复用
NativeStlViewer提供可拖拽融合视图,固定精细模型显示和 DICOM 高融合语义;DICOM+分割卡片加入横向 Slice Navigator、DICOM 显示模式和旋转控制。 - 逆向工作区给映射视图加入 DICOM 显示模式与旋转状态,并用该状态请求/渲染预览。
- 逆向工作区保存后建立状态快照,只有当前可视化工具栏状态与快照不同才注册离开确认;确认文本改成单行语义。
- 起始页标题顺序调整;根地址访问时按最初起始页处理共享会话。
- 用户管理前后端补齐新增/更新/删除接口能力,前端禁止删除当前用户。
- 运行类型检查、构建、服务部署与接口验证。
执行步骤
- 阅读相关源码与 API 封装。
- 编写项目状态、API 与用户管理后端补丁。
- 编写项目库和逆向工作区 UI/交互补丁。
- 修复登录页标题与主入口初始会话策略。
- 更新测试方案实际执行记录和经验记录。
- 精确暂存本轮文件,提交并推送 Gitea。
兼容性与回滚方案
- 旧项目若已有保存结果,保留用户保存结果;默认演示项目初始状态按空结果处理。
- 用户管理新增接口只操作
WebSite/data/state.json中用户列表,不影响 DICOM/STL 原始数据。 - 若项目库预览异常,仍可进入逆向工作区重新保存结果并导出。
预计文件变更
程序文件:
WebSite/src/App.tsxWebSite/src/components/Login.tsxWebSite/src/components/ProjectLibrary.tsxWebSite/src/components/ReverseWorkspace.tsxWebSite/src/components/UserManagement.tsxWebSite/src/lib/api.tsWebSite/src/types.tsWebSite/server.ts
工程分析:
- 本轮三份分析文档。
工程分析/经验记录.md。
提交与部署策略
- 暂存本轮程序改动与工程分析文档。
- 避免提交软著材料、历史删除状态和运行态导出文件。
- commit message 包含
2026-05-20-14-53-31。 - 构建通过后重启
tmux会话revoxelseg-dicom,验证 4000 端口服务。
实际实现记录
- 项目库逆向分割结果页新增结果 DICOM 显示模式、旋转控制和横向 Slice Navigator。
- 项目库融合视角改为可拖拽结果位姿预览,并固定使用精细模型语义。
- 后端分割结果记录增加
schemaVersion,过滤旧演示结果,默认项目初始结果为空;新保存结果继续持久化。 - 逆向工作区映射视图新增默认/骨窗/软组织/高对比和左转/右转控制。
- 逆向工作区新增保存快照判断,仅在保存相关状态变化后离开才弹窗。
- 根页面启动时清理共享会话,显示起始登录页;登录页标题改为全称在上、简称在下。
- 系统管理补齐用户新增、编辑、改密、删除接口和前端表单,并禁止删除当前登录用户。