docs: 整合四份清单为《HIS项目发布检查清单 v1.0》

This commit is contained in:
2026-04-25 12:08:51 +08:00
parent 39ccd27df8
commit 2f57b3e7c1

View File

@@ -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 系统所有开发人员