2026-05-23-00-32-26 撰写系统功能描述

工程分析/实现方案-2026-05-23-00-32-26.md

@@ -0,0 +1,49 @@
+# 实现方案
+
+实现方案文档路径：`工程分析/实现方案-2026-05-23-00-32-26.md`
+
+## 修改目标
+
+撰写一段准确、完整、可直接复用的系统功能文字描述，并完成工程分析流程留痕、备份提交、构建与部署验证。
+
+## 涉及路径
+
+- `工程分析/需求分析-2026-05-23-00-32-26.md`
+- `工程分析/实现方案-2026-05-23-00-32-26.md`
+- `工程分析/测试方案-2026-05-23-00-32-26.md`
+- `工程分析/系统功能描述-2026-05-23-00-32-26.md`
+- `工程分析/经验记录.md`
+
+## 技术路线
+
+1. 阅读工程工作流、整体分析、经验记录、README 与核心前端页面。
+2. 提炼系统定位、用户登录、项目库、DICOM 预览、STL 预览、三维融合、位姿调整、构件样式、Mask/NIfTI 导出、系统管理和部署能力。
+3. 将描述控制在 800-1300 字，并避免宣称当前尚未接入的真实医学级体素化能力。
+4. 写入文档后执行字数检查、构建检查、部署验证和 Git 备份提交。
+
+## 执行步骤
+
+- 记录开始时间并阅读核心工程分析资料。
+- 创建本次需求分析、实现方案、测试方案。
+- 最终执行前再次阅读 `工程分析/经验记录.md`。
+- 新增系统功能描述文档。
+- 追加经验记录 A/B/C/D。
+- 执行 `npm run build`。
+- 使用项目约定的 `tmux` 会话重新部署，并验证 `/api/health` 与首页。
+- 精确暂存本次文档并提交，commit message 包含时间戳和简要描述。
+
+## 兼容性与回滚方案
+
+- 本次不修改源码和配置，不影响系统运行兼容性。
+- 如需回滚，可删除本次新增文档并回退经验记录追加段落；业务系统无需回滚。
+
+## 预计文件变更
+
+- 新增 4 个工程分析文档。
+- 修改 1 个经验记录文档。
+
+## 提交与部署策略
+
+- Git 提交只包含本次相关文档。
+- 部署沿用 `WebSite` 下 `npm run build` 与 `npm run serve -- --host 0.0.0.0 --port 4000`，优先使用 `tmux` 会话 `revoxelseg-dicom`。
+- 若 4000 端口已由现有 Docker 正式服务占用，则不强行叠加 tmux 服务；记录占用来源，并对当前实际对外服务执行重建、重启和健康验证。

工程分析/测试方案-2026-05-23-00-32-26.md

@@ -0,0 +1,42 @@
+# 测试方案
+
+测试方案文档路径：`工程分析/测试方案-2026-05-23-00-32-26.md`
+
+## 静态检查
+
+- 检查系统功能描述是否包含当前系统主要功能模块。
+- 检查是否存在夸大真实医学级算法、诊断能力或临床结论的表述。
+- 检查正文规模是否落在 800-1300 字要求范围内。
+
+## 构建检查
+
+- 在 `WebSite/` 下执行 `npm run build`，确认前端与服务端构建通过。
+
+## 关键业务场景验证
+
+- 验证描述覆盖登录、总体概况、项目库、DICOM/STL 数据管理、逆向工作区、三维融合、构件配置、导出和系统管理。
+- 验证健康接口可访问。
+- 验证首页可访问。
+
+## 医学影像数据相关边界验证
+
+- 文案中明确系统面向 DICOM 序列、STL 重建模型、Label Map/NIfTI Mask 等医学影像数据流。
+- 文案避免承诺临床诊断和真实自动分割结果，只描述当前演示闭环与辅助标注能力。
+
+## 部署验证
+
+- 构建后使用 `tmux` 会话 `revoxelseg-dicom` 启动服务。
+- 若 `4000` 端口已由现有 Docker 服务占用，则沿用实际对外服务执行 `docker compose up -d --build`，避免端口冲突。
+- 验证 `http://127.0.0.1:4000/api/health`。
+- 验证 `http://127.0.0.1:4000/`。
+
+## Git/Gitea 备份验证
+
+- 使用 `git status --short` 确认仅暂存本次相关文件。
+- 提交信息包含 `2026-05-23-00-32-26` 和简要描述。
+
+## 风险与回归关注点
+
+- 当前工作区存在大量非本次变更，提交时不得混入。
+- 如果 4000 端口已有服务占用，需要先识别并按项目约定处理。
+- 本次不修改源码，回归风险主要来自部署过程而非文档内容。

工程分析/系统功能描述-2026-05-23-00-32-26.md

@@ -0,0 +1,11 @@
+# 系统功能文字描述
+
+本系统是一套面向医学影像重建与分割标注场景的“基于模型逆向体素化及 DICOM 分割标注系统”。系统围绕 DICOM 影像序列、STL 三维重建模型和 NIfTI 分割结果三类核心数据，构建从项目管理、数据导入、影像预览、模型查看、三维融合、位姿校准到分割结果导出的完整演示流程，帮助使用者在浏览器中直观完成影像与模型的空间对应关系复核。
+
+系统提供统一登录入口和共享会话管理，支持管理员进入总体概况、项目库、逆向工作区和系统管理工作区。总体概况页面集中展示项目数量、DICOM 切片数量、STL 模型数量、Mask 导出状态和近期处理趋势，使用户能够快速了解当前演示数据与项目进展。项目库负责承载病例项目和数据资产管理，用户可以查看项目基本信息，导入或覆盖 DICOM 影像、STL 模型及压缩包数据，并在上传过程中获得进度、处理阶段和失败原因反馈，降低大体量医学数据操作的不确定性。
+
+在影像查看方面，系统支持轴向、矢状面、冠状面 DICOM 切片预览，并提供默认、骨窗、软组织、高对比等显示模式，便于从不同窗宽窗位风格复核组织结构。系统能够解析关键 DICOM 元数据、spacing、物理尺寸等信息，并支持下载原始影像归档。在模型查看方面，系统读取 STL 文件并生成抽样三角面预览，支持多构件显示、隐藏、颜色、透明度、Mask ID 和实体显示精度配置，使不同组织或结构模型能够以清晰的层级方式呈现。
+
+逆向工作区是系统的核心操作区域，面向 DICOM 与 STL 的空间融合和逆向映射复核。用户可在三维视图中同时观察 DICOM 体数据、切片范围和 STL 模型，调整模型旋转、平移、缩放等位姿参数，并通过细粒度步进完成配准微调。系统提供自动拉伸、视角切换、切片范围控制、DICOM 透明度控制和 STL 切面展示，辅助用户判断模型是否落在影像空间的合理位置。二维映射视图可叠加显示 Label Map 结果统计，帮助用户检查可见构件、填充像素和分段数量。
+
+系统支持按项目导出 DICOM 原始影像、STL 原始模型、位姿数据和分割影像结果。分割影像可按可见类别或全部类别导出，并支持构件整体导出为多标签 Label Map，或按构件分别导出为独立 NII.GZ 文件，便于后续接入医学影像分析工具进行复核。系统管理工作区提供用户新增、编辑、密码修改、删除和演示环境恢复能力，保证演示数据、用户状态和项目状态可统一维护。整体上，本系统强调医学影像数据的可视化管理、模型与影像的空间校准、分割结果的可追溯导出和演示环境的可重复运行，为后续接入真实医学级逆向体素化算法和临床级标注流程预留了清晰接口。

工程分析/经验记录.md

@@ -1603,3 +1603,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 后续遇到“停止、暂停、下线、关闭服务”类请求时，工作流中的重新部署步骤应解释为“运行态验证”，而不是再次启动服务。最终汇报要明确服务已停、恢复命令是什么，以及哪些入口当前不可访问，避免把暂停请求处理成重启请求。
+
+## 2026-05-23-00-32-26 系统功能描述要贴合演示系统真实边界
+
+A. 具体问题
+
+用户要求撰写 800-1300 字的系统功能文字描述，内容需要覆盖项目核心功能，同时不能把当前演示闭环写成已具备完整临床级自动分割或真实医学级体素化算法。
+
+B. 产生问题原因
+
+系统名称和目标包含“逆向体素化”“DICOM 分割标注”等较强算法语义，但工程整体分析已明确当前仍以演示闭环为主，真实医学级 STL 到 DICOM 空间体素化算法尚未接入。若只按目标愿景撰写，容易超出当前系统实际能力。
+
+C. 解决问题方案
+
+先阅读工作流、工程整体分析、经验记录、README 和核心页面源码，再提炼登录、总体概况、项目库、DICOM 预览、STL 预览、三维融合、位姿校准、构件样式、Label Map/NIfTI 导出和系统管理等真实功能。正文中特别使用“演示流程”“复核”“预留接口”等表述，避免承诺临床诊断或已完成真实算法接入，并用字符统计确认正文处于用户要求范围。
+
+D. 后续如何避免问题
+
+后续撰写项目介绍、软著说明、验收材料或宣传文案时，应先核对工程整体分析和最新源码功能，再区分“已实现能力”“演示能力”和“后续预留能力”。涉及医学影像、分割、诊断和算法效果的表述必须保守准确，不能为了文字完整性虚构尚未落地的临床级能力。

工程分析/需求分析-2026-05-23-00-32-26.md

@@ -0,0 +1,42 @@
+# 需求分析
+
+开始时间：2026-05-23-00-32-26
+
+## 原始需求摘要
+
+用户要求撰写一段 800-1300 字的系统功能文字描述。
+
+## 业务目标
+
+形成一段可用于项目介绍、软著材料、验收材料或产品说明的系统功能描述，准确概括“基于模型逆向体素化及 DICOM 分割标注系统”的核心能力、使用流程和交付价值。
+
+## 输入与输出
+
+- 输入：用户提出的字数范围要求、现有工程整体分析、README、前端核心页面与经验记录。
+- 输出：一份 800-1300 字范围内的系统功能文字描述，并在工程分析目录留存本次流程文档。
+
+## 影响范围
+
+- 新增本次需求分析、实现方案、测试方案。
+- 新增系统功能描述文档。
+- 追加经验记录。
+- 不修改业务源码、医学影像数据、运行态数据和部署配置。
+
+## 关键约束
+
+- 必须执行 `工程分析/代码编纂工作流.md`。
+- 描述内容应与当前系统真实能力一致，不夸大为已经接入医学级真实体素化算法。
+- 字数需控制在 800-1300 字。
+- Git 备份提交只包含本次相关文档，避免混入工作区既有删除或未跟踪文件。
+- 按项目约定执行构建与重新部署验证。
+
+## 风险点
+
+- 若描述中过度强调自动分割或真实医学诊断能力，可能与当前演示系统定位不一致。
+- 当前工作区存在大量非本次变更，提交时需要精确暂存。
+- 服务可能已由 Docker 或其他方式占用 4000 端口，重新部署前需要检查。
+
+## 待确认问题或默认假设
+
+- 默认将文字描述保存为 `工程分析/系统功能描述-2026-05-23-00-32-26.md`，并在最终回复中直接提供正文。
+- 默认按中文“字数”理解为正文字符规模，控制在 800-1300 个汉字/字符附近。