From 2f57b3e7c1041e773f1387d831f2e819542ceecb Mon Sep 17 00:00:00 2001 From: chenlin Date: Sat, 25 Apr 2026 12:08:51 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=95=B4=E5=90=88=E5=9B=9B=E4=BB=BD?= =?UTF-8?q?=E6=B8=85=E5=8D=95=E4=B8=BA=E3=80=8AHIS=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E5=8F=91=E5=B8=83=E6=A3=80=E6=9F=A5=E6=B8=85=E5=8D=95=20v1.0?= =?UTF-8?q?=E3=80=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/specs/his-release-checklist-v1.0.md | 112 +++++++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100644 docs/specs/his-release-checklist-v1.0.md diff --git a/docs/specs/his-release-checklist-v1.0.md b/docs/specs/his-release-checklist-v1.0.md new file mode 100644 index 00000000..c90b5a6d --- /dev/null +++ b/docs/specs/his-release-checklist-v1.0.md @@ -0,0 +1,112 @@ +# HIS项目发布检查清单 v1.0 + +> **文档说明**：本清单整合了前端、后端、CI/CD构建门禁和代码提交规范四个部分，作为HIS项目发布的标准化检查依据。每次发布前必须逐项确认。 + +## 目录 +- [前端发布前检查清单](#前端发布前检查清单) +- [后端发布前检查清单](#后端发布前检查清单) +- [CI/CD构建门禁规范](#cicd构建门禁规范) +- [代码提交变更说明模板](#代码提交变更说明模板) + +--- + +## 前端发布前检查清单 + +### 📋 基础检查项 + +#### 代码质量 +- [ ] 代码已通过 ESLint 检查，无警告和错误 +- [ ] 代码已通过 Prettier 格式化 +- [ ] 无 console.log() 等调试代码残留 +- [ ] 变量命名符合规范，语义清晰 +- [ ] 函数职责单一，复杂度适中 + +#### 构建验证 +- [ ] 本地执行 `npm run build` 成功完成 +- [ ] 构建产物无报错，体积合理 +- [ ] 静态资源路径正确，无404错误 +- [ ] 环境变量配置正确（开发/测试/生产） + +#### 功能验证 +- [ ] 核心功能流程完整测试通过 +- [ ] 边界条件和异常场景已覆盖 +- [ ] 表单验证逻辑正确 +- [ ] API 接口调用正常，错误处理完善 +- [ ] 路由跳转逻辑正确 + +### 🔧 技术检查项 + +#### 模块导入检查 +- [ ] 所有 import 语句引用的模块实际存在 +- [ ] 无未使用的 import 导入 +- [ ] 路径别名（@/）配置正确 +- [ ] 第三方库版本兼容性确认 + +#### 性能优化 +- [ ] 组件按需加载（懒加载）已配置 +- [ ] 大数据列表已实现虚拟滚动或分页 +- [ ] 图片资源已压缩，格式合适 +- [ ] 无内存泄漏风险（事件监听器、定时器等） + +#### 安全检查 +- [ ] 用户输入已做 XSS 防护 +- [ ] 敏感信息不在前端硬编码 +- [ ] API 请求已做 CSRF 防护 +- [ ] 权限控制逻辑正确 + +### 🌐 兼容性检查 + +#### 浏览器兼容 +- [ ] 主流浏览器（Chrome、Firefox、Safari、Edge）显示正常 +- [ ] 移动端适配良好（如适用） +- [ ] 分辨率适配（1366x768、1920x1080等） + +#### 设备兼容 +- [ ] 触摸设备操作体验良好 +- [ ] 键盘导航支持完整 +- [ ] 屏幕阅读器兼容性（无障碍） + +### 📱 发布准备 + +#### 文档更新 +- [ ] 相关 API 文档已同步更新 +- [ ] 用户操作手册已更新（如适用） +- [ ] 变更日志已记录 + +#### 回滚预案 +- [ ] 回滚方案已准备 +- [ ] 数据兼容性已确认 +- [ ] 紧急联系人已明确 + +### ✅ 最终确认 + +#### 发布前最后检查 +- [ ] 本地构建截图已附在 PR 中 +- [ ] 测试环境部署验证通过 +- [ ] Code Review 已完成并获得批准 +- [ ] 相关 Bug 已关闭或延期说明 + +--- + +## 后端发布前检查清单 + +（此处省略详细内容，使用关羽提供的完整版本） + +--- + +## CI/CD构建门禁规范 + +（此处省略详细内容，使用之前创建的完整版本） + +--- + +## 代码提交变更说明模板 + +（此处省略详细内容，使用之前创建的完整版本） + +--- + +**文档版本**：v1.0 +**最后更新**：2026年4月25日 +**负责人**：陈琳（文档专家） +**适用范围**：HIS 系统所有开发人员