REVOXELSEG_DICOM/工程分析/实现方案-2026-05-04-03-21-40.md

实现方案

时间戳：2026-05-04-03-21-40

修改目标

将当前前端静态演示升级为前后端协调系统：

• 后端统一管理登录状态、用户列表、项目列表和演示环境。
• 项目列表默认载入 Head_CT_DICOM 与 Head_CT_ReConstruct。
• 恢复演示环境出厂设置后恢复默认项目和默认用户。
• 逆向工作区通过后端生成并下载 .nii.gz 分割 mask。
• 继续部署到 http://192.168.3.11:4000/。

涉及路径

• WebSite/package.json
• WebSite/server.ts
• WebSite/src/lib/api.ts
• WebSite/src/types.ts
• WebSite/src/App.tsx
• WebSite/src/components/Login.tsx
• WebSite/src/components/Overview.tsx
• WebSite/src/components/ProjectLibrary.tsx
• WebSite/src/components/ReverseWorkspace.tsx
• WebSite/src/components/UserManagement.tsx
• WebSite/data/state.json
• WebSite/exports/
• .gitignore
• 工程分析/测试方案-2026-05-04-03-21-40.md
• 工程分析/经验记录.md

技术路线

1. 新增 Express 后端 server.ts。
   • 开发环境通过 Vite 中间件服务前端。
   • API 和页面共用 4000 端口，避免跨域和前后端端口不一致。
2. 后端状态持久化。
   • 使用 WebSite/data/state.json 保存演示状态。
   • 默认用户包括 admin / 123456。
   • 当前登录状态由后端统一维护，所有浏览器轮询 /api/session 同步。
3. 默认项目载入。
   • 后端扫描 ../Head_CT_DICOM 的 .dcm 数量。
   • 后端扫描 ../Head_CT_ReConstruct 的 .stl 文件列表。
   • 构造默认项目 head-ct-demo，包含 DICOM/STL 路径、数量、模块名称。
4. 恢复演示环境出厂设置。
   • POST /api/demo/reset 重建默认用户、默认项目、登录状态。
   • 前端系统管理页点击按钮后调用该接口，并刷新用户和项目相关数据。
5. 前端 API 化。
   • Login 调用 /api/login。
   • App 调用 /api/session 并轮询同步登录状态。
   • Overview 调用 /api/overview。
   • ProjectLibrary 调用 /api/projects。
   • UserManagement 调用 /api/users 与 /api/demo/reset。
   • ReverseWorkspace 调用 /api/projects/:id 与 /api/projects/:id/export-mask。
6. NIfTI 导出。
   • 后端生成 NIfTI-1 单文件 .nii.gz。
   • 使用 Node zlib.gzipSync 压缩。
   • 文件保存到 WebSite/exports/，同时以 attachment 下载。
   • NIfTI 内容先采用演示 mask 体素数据，尺寸、标签信息和项目元数据由后端生成。
7. 部署。
   • npm run build
   • npm run lint
   • 使用 tmux 运行 npm run serve -- --host 0.0.0.0 --port 4000。

数据流

登录：

前端登录页 -> POST /api/login -> 后端验证账号密码 -> 更新共享 session -> 所有浏览器轮询 /api/session 后同步状态。

项目：

前端项目库 -> GET /api/projects -> 后端扫描或读取默认项目状态 -> 展示 DICOM 数量、STL 模块、路径和状态。

重置：

系统管理页 -> POST /api/demo/reset -> 后端重建默认状态 -> 前端刷新用户和项目。

导出：

逆向工作区 -> POST /api/projects/:id/export-mask -> 后端生成 .nii.gz -> 前端下载。

兼容性与回滚方案

• 保留 Vite/React 前端结构，后端通过同端口中间件接入。
• DICOM/STL 仍不进入 Git。
• WebSite/data/state.json 和 WebSite/exports/ 作为运行态文件默认不纳入提交。
• 若后端服务异常，可回滚 server.ts 和前端 API 调用改动，恢复纯前端 Vite 部署。

预计文件变更

• 新增 WebSite/server.ts
• 新增 WebSite/src/lib/api.ts
• 修改 WebSite/package.json
• 修改 WebSite/src/types.ts
• 修改主要页面组件以接入 API。
• 修改 .gitignore 排除运行态数据和导出文件。
• 更新工程分析文档和经验记录。

人工审核状态

本次用户明确要求需求分析、实现方案、测试方案、执行修改均不用人工二次确认。

状态：自动确认，继续执行。