# 需求分析

时间戳：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 处理链。