REVOXELSEG_DICOM/工程分析/实现方案-2026-05-21-00-58-25.md

实现方案-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。