# 实现方案-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`
- `工程分析/经验记录.md`
- `AGENTS.md`

## 技术路线

1. 记录本次开始时间 `2026-05-19-22-59-07`。
2. 阅读项目 README、`WebSite/README.md`、`package.json`、`server.ts`、API 封装和主要 React 组件。
3. 从 Git 中读取旧 `工程分析/工程整体分析.md`、`代码编纂工作流.md`、`经验记录.md`，保留旧知识库。
4. 恢复并更新三个核心文档，只处理本次必要文件。
5. 新增本次需求分析、实现方案、测试方案。
6. 新增根目录 `AGENTS.md`，提醒后续进入仓库的助手优先执行该工作流。
7. 执行静态检查和构建。
8. 使用 `tmux` 重新部署 `WebSite` 服务到 `0.0.0.0:4000`。
9. 验证 HTTP 健康检查和页面响应。
10. 仅暂存本次相关文档和 `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`。