diff --git a/工程分析/实现方案-2026-05-21-10-05-51.md b/工程分析/实现方案-2026-05-21-10-05-51.md new file mode 100644 index 0000000..cf0418e --- /dev/null +++ b/工程分析/实现方案-2026-05-21-10-05-51.md @@ -0,0 +1,57 @@ +# 实现方案-2026-05-21-10-05-51 + +实现方案文档路径:`工程分析/实现方案-2026-05-21-10-05-51.md` + +## 修改目标 + +- 根据当前系统功能更新软著说明书、登记表、代码汇总与素材清单。 +- 重新拍摄说明书章节图片,确保每个主要功能说明有对应真实界面图。 +- 重新生成可编辑 Word 文档。 +- 完成文档引用、图片存在性、Word 文件有效性和服务验证。 + +## 涉及路径 + +- `新撰写软著文档/1. 软著说明书.md` +- `新撰写软著文档/2. 软著登记表.md` +- `新撰写软著文档/3. 代码汇总.md` +- `新撰写软著文档/images/` +- `新撰写软著文档/功能验证与素材清单.md` +- `新撰写软著文档/*.docx` +- `工程分析/经验记录.md` + +## 技术路线 + +1. 学习 `※撰写Agent.md` 与参考模板要求。 +2. 读取现有软著说明书、登记表、代码汇总和素材清单,找出与当前功能不一致之处。 +3. 使用当前运行系统重新拍摄登录、概况、项目库、导入、三维模型、逆向分割结果、逆向工作区、导出、系统管理等图片。 +4. 重写或增补说明书章节,保证功能说明更细化、图片引用更新且无重复引用。 +5. 更新登记表中的功能概述、技术特点、运行环境和源程序量。 +6. 更新代码汇总,确保核心代码摘抄覆盖当前导入、导出、分割映射、用户管理和位姿逻辑。 +7. 生成 docx,并校验图片引用、docx 压缩包结构与行数。 + +## 执行步骤 + +- 检查当前服务状态并确认可访问。 +- 准备或更新截图自动化脚本,输出到 `新撰写软著文档/images/`。 +- 更新 Markdown 正文和素材清单。 +- 使用 Pandoc 或 `python-docx` 生成 Word。 +- 校验所有图片引用存在、说明书每个章节都有图片、代码汇总行数满足要求。 +- 按工作流追加经验记录、提交工程分析文档并重新部署验证。 + +## 兼容性与回滚方案 + +- 本次不修改系统业务代码,回滚时只需恢复 `新撰写软著文档/` 的文档和图片。 +- 软著材料不入 Gitea,避免影响项目代码版本。 +- 若自动截图失败,可保留已有图片并记录失败原因,但优先重拍成功截图。 + +## 预计文件变更 + +- 更新 `新撰写软著文档/` 下 Markdown、Word、图片和素材清单。 +- 新增当次工程分析三件套。 +- 追加 `工程分析/经验记录.md`。 + +## 提交与部署策略 + +- Gitea 提交只包含本次工程分析记录,不包含软著材料。 +- Commit message 包含 `2026-05-21-10-05-51` 与简要描述。 +- 按工作流重新部署并验证服务。 diff --git a/工程分析/测试方案-2026-05-21-10-05-51.md b/工程分析/测试方案-2026-05-21-10-05-51.md new file mode 100644 index 0000000..9de4e8b --- /dev/null +++ b/工程分析/测试方案-2026-05-21-10-05-51.md @@ -0,0 +1,57 @@ +# 测试方案-2026-05-21-10-05-51 + +测试方案文档路径:`工程分析/测试方案-2026-05-21-10-05-51.md` + +## 静态检查 + +- 检查 Markdown 图片引用是否全部存在。 +- 检查说明书是否保留面向用户的操作语言,避免接口、组件、状态字段等开发黑话。 + +## 构建检查 + +- 本次不修改业务代码,但仍按工作流执行 `cd WebSite && npm run build`。 +- 校验 `.docx` 文件可作为 zip 打开。 + +## 关键业务场景验证 + +- 登录页截图。 +- 总体概况截图。 +- 项目库 DICOM 影像、3D 模型、逆向分割结果截图。 +- 项目导入和导出项目及结果相关说明。 +- 逆向工作区三维融合视图、可视化工具栏、逆向分割映射视图、保存至项目库截图。 +- 系统管理、用户编辑、密码修改、演示环境恢复等说明。 + +## 医学影像数据相关边界验证 + +- 文档中说明 DICOM、STL、NIfTI、位姿 JSON、labels JSON 等格式用途。 +- 不在说明书中写入真实患者敏感信息。 +- 截图避免错误状态、半加载状态或遮挡严重界面。 + +## 部署验证 + +- `http://127.0.0.1:4000/api/health` +- `http://127.0.0.1:4000/` + +## Git/Gitea 备份验证 + +- 只提交工程分析三件套和经验记录。 +- 不提交 `新撰写软著文档/`、截图、视频、压缩包和软著 Word。 + +## 风险与回归关注点 + +- 软著说明书图片要与当前界面一致,不能继续引用旧 UI。 +- Word 文档必须嵌入图片并保持可编辑。 +- 代码汇总至少保持用户此前要求的 1600 行以上。 + +## 实际验证记录 + +- Markdown 图片引用检查:说明书 23 个章节、23 个图片引用,缺失图片 0 个。 +- 图片尺寸检查:23 张 `chapter-*.png` 均为 1680x1050,且均为非空截图。 +- Word 校验: + - `1. 软著说明书.docx` 可解压,包含 23 张嵌入图片。 + - `2. 软著登记表.docx` 可解压,包含 5 个可编辑表格。 + - `3. 代码汇总.docx` 可解压,代码文本可编辑。 +- 代码汇总行数:`3. 代码汇总.md` 为 10839 行,满足至少 1600 行要求。 +- 系统使用视频:`系统使用视频.mp4` 为 H.264,1280x800,时长约 46 秒。 +- `npm run lint`:通过。 +- `npm run build`:通过,仅保留既有 Vite 大 chunk 提示。 diff --git a/工程分析/经验记录.md b/工程分析/经验记录.md index 0b94dc4..a12db3b 100644 --- a/工程分析/经验记录.md +++ b/工程分析/经验记录.md @@ -1477,3 +1477,21 @@ C. 解决问题方案 D. 后续如何避免问题 凡是涉及 STL 与 DICOM 尺度自动匹配的逻辑,都必须明确使用“全局包围盒”还是“可见构件包围盒”,并与实际渲染组件保持一致。单轴等比例贴合要考虑其他轴的视场约束,短轴贴合不能无限放大长轴;位姿数值控件的步长、显示精度、内部取整和导出数据要同步设计,避免 UI 看起来精细但实际状态漂移。 + +## 2026-05-21-10-05-51 软著材料更新要同步源码、截图、Word 与素材清单 + +A. 具体问题 + +用户要求继续更新 `新撰写软著文档/` 中的所有软著材料,并重新拍摄说明书图片。此前说明书、登记表、代码汇总和视频素材已经存在,但最新功能变更包括自动拉伸 DICOM 体范围约束、缩放三位小数、0.005 级微调等内容,若只更新文字或只更新截图,软著材料会与当前系统不一致。 + +B. 产生问题原因 + +软著材料由 Markdown、Word、图片、视频、代码汇总和素材清单组成,属于多文件联动交付。截图需要真实页面状态,代码汇总需要从当前源码重新生成,Word 又依赖 Markdown 和图片引用;任何一个环节未同步,都会出现说明书图片旧、代码摘录旧、Word 未嵌图或素材清单时间不一致的问题。 + +C. 解决问题方案 + +按 `※撰写Agent.md` 流程复查说明书、登记表、代码汇总和素材清单。使用 Chrome Headless + SwiftShader + DevTools 视口强制 1680x1050 重拍 23 张章节截图,避免 WebGL 截图为空。说明书补充自动拉伸、DICOM 体范围约束、三位小数缩放和 0.005 微调说明;登记表同步最新功能;代码汇总从当前核心源码重新生成;视频用最新章节截图重新生成 MP4;再用图片引用检查、docx 解压、Word 图片数量、代码行数、视频参数和项目构建做验证。 + +D. 后续如何避免问题 + +后续只要系统功能发生变化并要求更新软著材料,应同时更新 Markdown 正文、截图、Word、代码汇总、视频脚本和素材清单,不能只改其中一项。截图自动化必须固定视口并校验图片尺寸、非空像素和引用数量;代码汇总应从当前源码机械生成或明确摘录范围;软著目录按用户要求不提交 Gitea,只提交工程分析记录。 diff --git a/工程分析/需求分析-2026-05-21-10-05-51.md b/工程分析/需求分析-2026-05-21-10-05-51.md new file mode 100644 index 0000000..60dbf6f --- /dev/null +++ b/工程分析/需求分析-2026-05-21-10-05-51.md @@ -0,0 +1,54 @@ +# 需求分析-2026-05-21-10-05-51 + +开始时间:2026-05-21-10-05-51 + +## 原始需求摘要 + +用户要求继续更新 `新撰写软著文档/` 中的所有材料,细致同步当前系统功能,并重新拍摄或更新软著说明书中引用的界面图片。 + +## 业务目标 + +- 让软著说明书反映当前系统最新功能,包括项目库导入、压缩包上传、逆向分割结果、导出项目及结果、三维融合、模型位姿、自动拉伸、分割映射、系统管理等。 +- 重新拍摄说明书图片,避免旧截图和当前界面不一致。 +- 同步更新登记表、代码汇总、功能验证与素材清单,并生成可编辑 Word 文档。 +- 遵守此前约束:软著撰写相关材料不纳入 Gitea,只在本地 `新撰写软著文档/` 更新。 + +## 输入与输出 + +- 输入: + - 当前项目源码与运行中的系统界面。 + - `参考软著构建模板/` 与 `※撰写Agent.md`。 + - 已有 `新撰写软著文档/` 内容和图片。 +- 输出: + - 更新后的 `1. 软著说明书.md/.docx`。 + - 更新后的 `2. 软著登记表.md/.docx`。 + - 更新后的 `3. 代码汇总.md/.docx`。 + - 更新后的说明书截图和素材清单。 + +## 影响范围 + +- `新撰写软著文档/` +- `工程分析/需求分析-2026-05-21-10-05-51.md` +- `工程分析/实现方案-2026-05-21-10-05-51.md` +- `工程分析/测试方案-2026-05-21-10-05-51.md` +- `工程分析/经验记录.md` + +## 关键约束 + +- 不修改业务代码。 +- 软著材料本身不提交到 Gitea。 +- 截图必须来自当前运行界面,不能使用错误态、半加载态或严重遮挡画面。 +- 说明书面向用户与审查人员,避免开发黑话。 +- 代码汇总保持可编辑文本,并覆盖当前核心代码。 + +## 风险点 + +- Headless 截图可能因 WebGL 限制、加载慢或会话未登录导致图片为空或停留在登录页。 +- Word 转换若缺少 Pandoc,需要使用 `python-docx` 或其他方式生成。 +- 软著目录较大,必须避免误提交。 + +## 默认假设 + +- 当前本机服务 `http://127.0.0.1:4000/` 可用于拍摄。 +- 软著材料字段中未确认的著作权人、联系人等继续保留“待确认”。 +- 本次只提交工程分析记录,不提交 `新撰写软著文档/`。