REVOXELSEG_DICOM/工程分析/需求分析-2026-05-04-03-50-07.md

需求分析

时间戳：2026-05-04-03-50-07

原始需求摘要

用户要求严格使用代码编纂工作流处理本次修改，并在开始时复述工作流整体流程；本次需求分析、实现方案、测试方案和执行修改均不需要人工二次确认。

具体问题：

1. 当前项目总数为 1，已处理项目也是 1，统计语义不合理；已处理项目趋势折线图过于夸张。
2. 项目库中 DICOM 影像和 3D 模型看不到；如需要 Python，可新建 conda 环境，并在 README 写项目构建方案。
3. 项目库中在 DICOM 影像、3D 模型 旁边增加 分割结果。
4. 项目列表增加创建功能，可命名项目；已有项目右侧增加修改符号，可修改项目名称。
5. STL 模块列表中“会厌”不应默认蓝色突出，它和其他模块没有特殊关系。
6. 修复 Recharts 控制台警告：图表宽高为 -1。
7. 复述项目最重要达成目标，并完善系统中其他应提升但未完善的地方。

业务目标

• 让系统概况统计更符合业务语义，避免误导。
• 在项目库直接看到真实 DICOM 切片预览和真实 STL 模型预览。
• 让项目库形成 DICOM、模型、分割结果三类核心资产视图。
• 增加基础项目管理能力：创建项目、重命名项目。
• 修复 UI 不合理高亮和控制台警告。
• 补齐 README 中的构建、运行和部署说明。

输入与输出

输入：

• Head_CT_DICOM/ 下的 DICOM 切片。
• Head_CT_ReConstruct/ 下的 STL 模型。
• 用户创建或重命名项目的名称。

输出：

• 后端 DICOM 切片预览 API。
• 后端 STL 文件静态读取 API。
• 前端 DICOM canvas 预览。
• 前端 STL 模型渲染。
• 项目库新增 分割结果 视图。
• 项目创建和重命名 API 及前端入口。
• 修复后的概况统计与图表。
• README 构建方案。

影响范围

• WebSite/server.ts
• WebSite/src/lib/api.ts
• WebSite/src/types.ts
• WebSite/src/components/Overview.tsx
• WebSite/src/components/ProjectLibrary.tsx
• WebSite/README.md
• README.md
• 工程分析/经验记录.md

风险点

• DICOM 文件可能存在不同传输语法。本次优先支持当前数据可见的 Little Endian DICOM，并做保守 fallback。
• 浏览器渲染 STL 文件需要加载 three/examples/jsm/loaders/STLLoader.js，构建需验证 TypeScript/Vite 兼容。
• 创建项目若不绑定真实数据，会作为空演示项目存在；默认项目仍绑定真实 DICOM/STL。
• 图表容器警告与布局时机有关，需要给容器设置稳定 min-w-0、固定高度和加载态。

待确认问题

• 本次用户已明确无需二次人工确认，直接执行。
• 本次不创建 Python conda 环境，因为 DICOM 预览和 STL 渲染可以通过 Node/React/Three.js 完成。
• 后续若实现医学级真实体素化，可再引入 Python/conda 处理链。