# 实现方案-2026-05-21-00-58-25

实现方案文档路径：`工程分析/实现方案-2026-05-21-00-58-25.md`

## 修改目标

- 对系统进行静态、构建、API 与浏览器交互测试。
- 根据测试结果修复真实影响使用的问题。
- 更新软著说明书、登记表、代码汇总、素材清单，并重新生成说明书截图和 Word 文档。
- 按项目工作流提交代码与工程分析文档，软著材料不提交。

## 涉及路径

- 可能涉及：`WebSite/server.ts`、`WebSite/src/components/*`、`WebSite/src/lib/*`、`WebSite/src/types.ts`。
- 工程分析：`工程分析/需求分析-2026-05-21-00-58-25.md`、`工程分析/实现方案-2026-05-21-00-58-25.md`、`工程分析/测试方案-2026-05-21-00-58-25.md`、`工程分析/经验记录.md`。
- 软著材料：`新撰写软著文档/`，仅本地更新，不纳入 Gitea。

## 技术路线

1. 运行 `npm run lint`、`npm run build`、API 健康检查与关键接口抽查。
2. 使用浏览器自动化访问登录、总体概况、项目库、逆向工作区、系统管理等核心路径，观察控制台错误与页面状态。
3. 对发现的问题做小范围修复，避免引入新的数据结构风险。
4. 重新运行测试并部署。
5. 使用最新界面重新截取说明书图片，更新 Markdown 与 docx。

## 执行步骤

- 确认服务、依赖、脚本和软著材料现状。
- 执行静态与构建测试。
- 执行浏览器回归测试和页面截图。
- 修复测试中发现的缺陷。
- 重新生成软著文档和图片。
- 追加经验记录，精确暂存并提交代码/工程文档。
- 重新部署并验证服务。

## 兼容性与回滚方案

- 只修改明确发现的问题和文档内容，不改变默认医学数据。
- 如某项修复造成构建失败，回退该小范围 patch 并记录原因。
- 软著材料不提交，必要时可从本地历史文件恢复。

## 预计文件变更

- 新增本次工程分析三件套。
- 追加 `工程分析/经验记录.md`。
- 视测试结果修改少量前后端文件。
- 本地更新 `新撰写软著文档/` 下 Markdown、docx 和图片。

## 提交与部署策略

- Gitea commit 只包含本次代码修复和工程分析文档。
- Commit message 包含 `2026-05-21-00-58-25` 与简要描述。
- 使用 `tmux` 会话 `revoxelseg-dicom` 重启 `npm run serve -- --host 0.0.0.0 --port 4000`。