70 lines
2.9 KiB
Markdown
70 lines
2.9 KiB
Markdown
# 需求分析
|
||
|
||
时间戳：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 处理链。
|