# 实现方案：逆向结果复核增强与管理功能修复

实现方案文档路径：`工程分析/实现方案-2026-05-20-14-53-31.md`

## 修改目标

增强项目库逆向分割结果的复核交互，补齐逆向工作区映射视图 DICOM 控制，优化离开保存提示逻辑，修复起始页标题和系统管理用户操作。

## 涉及路径

- `WebSite/src/App.tsx`
- `WebSite/src/components/Login.tsx`
- `WebSite/src/components/ProjectLibrary.tsx`
- `WebSite/src/components/ReverseWorkspace.tsx`
- `WebSite/src/components/UserManagement.tsx`
- `WebSite/src/lib/api.ts`
- `WebSite/src/types.ts`
- `WebSite/server.ts`
- `工程分析/需求分析-2026-05-20-14-53-31.md`
- `工程分析/实现方案-2026-05-20-14-53-31.md`
- `工程分析/测试方案-2026-05-20-14-53-31.md`
- `工程分析/经验记录.md`

## 技术路线

1. 检查登录页、主入口、项目库、逆向工作区和用户管理现有实现。
2. 后端项目状态归一化时默认项目不再继承旧保存结果，确保初始逆向分割结果为空。
3. 项目库逆向分割结果页复用 `NativeStlViewer` 提供可拖拽融合视图，固定精细模型显示和 DICOM 高融合语义；DICOM+分割卡片加入横向 Slice Navigator、DICOM 显示模式和旋转控制。
4. 逆向工作区给映射视图加入 DICOM 显示模式与旋转状态，并用该状态请求/渲染预览。
5. 逆向工作区保存后建立状态快照，只有当前可视化工具栏状态与快照不同才注册离开确认；确认文本改成单行语义。
6. 起始页标题顺序调整；根地址访问时按最初起始页处理共享会话。
7. 用户管理前后端补齐新增/更新/删除接口能力，前端禁止删除当前用户。
8. 运行类型检查、构建、服务部署与接口验证。

## 执行步骤

- 阅读相关源码与 API 封装。
- 编写项目状态、API 与用户管理后端补丁。
- 编写项目库和逆向工作区 UI/交互补丁。
- 修复登录页标题与主入口初始会话策略。
- 更新测试方案实际执行记录和经验记录。
- 精确暂存本轮文件，提交并推送 Gitea。

## 兼容性与回滚方案

- 旧项目若已有保存结果，保留用户保存结果；默认演示项目初始状态按空结果处理。
- 用户管理新增接口只操作 `WebSite/data/state.json` 中用户列表，不影响 DICOM/STL 原始数据。
- 若项目库预览异常，仍可进入逆向工作区重新保存结果并导出。

## 预计文件变更

程序文件：

- `WebSite/src/App.tsx`
- `WebSite/src/components/Login.tsx`
- `WebSite/src/components/ProjectLibrary.tsx`
- `WebSite/src/components/ReverseWorkspace.tsx`
- `WebSite/src/components/UserManagement.tsx`
- `WebSite/src/lib/api.ts`
- `WebSite/src/types.ts`
- `WebSite/server.ts`

工程分析：

- 本轮三份分析文档。
- `工程分析/经验记录.md`。

## 提交与部署策略

- 暂存本轮程序改动与工程分析文档。
- 避免提交软著材料、历史删除状态和运行态导出文件。
- commit message 包含 `2026-05-20-14-53-31`。
- 构建通过后重启 `tmux` 会话 `revoxelseg-dicom`，验证 4000 端口服务。

## 实际实现记录

- 项目库逆向分割结果页新增结果 DICOM 显示模式、旋转控制和横向 Slice Navigator。
- 项目库融合视角改为可拖拽结果位姿预览，并固定使用精细模型语义。
- 后端分割结果记录增加 `schemaVersion`，过滤旧演示结果，默认项目初始结果为空；新保存结果继续持久化。
- 逆向工作区映射视图新增默认/骨窗/软组织/高对比和左转/右转控制。
- 逆向工作区新增保存快照判断，仅在保存相关状态变化后离开才弹窗。
- 根页面启动时清理共享会话，显示起始登录页；登录页标题改为全称在上、简称在下。
- 系统管理补齐用户新增、编辑、改密、删除接口和前端表单，并禁止删除当前登录用户。