2.5 KiB
2.5 KiB
实现方案-2026-05-19-22-59-07
实现方案文档路径
工程分析/实现方案-2026-05-19-22-59-07.md
修改目标
建立并固化项目级代码编纂工作流，使后续项目修改必须留下需求分析、实现方案、测试方案、经验记录、备份 commit 与部署验证。
涉及路径
工程分析/工程整体分析.md工程分析/代码编纂工作流.md工程分析/需求分析-2026-05-19-22-59-07.md工程分析/实现方案-2026-05-19-22-59-07.md工程分析/测试方案-2026-05-19-22-59-07.md工程分析/经验记录.mdAGENTS.md
技术路线
- 记录本次开始时间
2026-05-19-22-59-07。 - 阅读项目 README、
WebSite/README.md、package.json、server.ts、API 封装和主要 React 组件。 - 从 Git 中读取旧
工程分析/工程整体分析.md、代码编纂工作流.md、经验记录.md，保留旧知识库。 - 恢复并更新三个核心文档，只处理本次必要文件。
- 新增本次需求分析、实现方案、测试方案。
- 新增根目录
AGENTS.md，提醒后续进入仓库的助手优先执行该工作流。 - 执行静态检查和构建。
- 使用
tmux重新部署WebSite服务到0.0.0.0:4000。 - 验证 HTTP 健康检查和页面响应。
- 仅暂存本次相关文档和
AGENTS.md，创建包含时间戳和简要描述的 commit，并尝试推送到 Gitea。
兼容性与回滚方案
- 本次不修改业务代码，不改变 API、前端页面和运行态数据结构。
- 若文档内容需要回滚，可回退本次 commit。
- 若部署失败，可保留当前代码构建结果，检查
tmux会话日志和端口占用后重新启动。 - 若 Gitea 推送失败，本地 commit 仍保留，可稍后网络恢复后执行
git push origin main。
预计文件变更
- 更新：
工程分析/工程整体分析.md - 更新：
工程分析/代码编纂工作流.md - 更新：
工程分析/经验记录.md - 新增：
工程分析/需求分析-2026-05-19-22-59-07.md - 新增：
工程分析/实现方案-2026-05-19-22-59-07.md - 新增：
工程分析/测试方案-2026-05-19-22-59-07.md - 新增：
AGENTS.md
提交与部署策略
- 暂存时显式列出本次文件，避免把工作区已有历史删除状态混入 commit。
- commit message 使用：
2026-05-19-22-59-07 建立代码编纂工作流 - 部署方式沿用项目约定：
tmux会话revoxelseg-dicom+npm run serve -- --host 0.0.0.0 --port 4000。