2026-05-04-03-50-07 完善项目库可视化和项目管理

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

@@ -0,0 +1,69 @@
+# 需求分析
+
+时间戳：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 处理链。