Files
his/docs/specs/frontend-checklist.md
zhugeliang d52bbda8c3 docs: 完善三份构建门禁文档 - 补充前后端协同检查、Java后端门禁、数据库变更字段
架构评审改进项:
- frontend-checklist.md: 增加后端Maven编译、数据库脚本、接口兼容性检查
- cicd-gatekeeper.md: 补充Java后端构建配置(SpotBugs)、分阶段覆盖率目标
- commit-template.md: 增加数据库变更影响评估字段、精简截图要求
2026-04-24 18:03:45 +08:00

2.7 KiB
Raw Blame History

前端发布前检查清单

📋 基础检查项

代码质量

  • 代码已通过 ESLint 检查,无警告和错误
  • 代码已通过 Prettier 格式化
  • 无 console.log() 等调试代码残留
  • 变量命名符合规范,语义清晰
  • 函数职责单一,复杂度适中

构建验证

  • 本地执行 npm run build 成功完成
  • 构建产物无报错,体积合理
  • 静态资源路径正确无404错误
  • 环境变量配置正确(开发/测试/生产)

功能验证

  • 核心功能流程完整测试通过
  • 边界条件和异常场景已覆盖
  • 表单验证逻辑正确
  • API 接口调用正常,错误处理完善
  • 路由跳转逻辑正确

🔧 技术检查项

模块导入检查

  • 所有 import 语句引用的模块实际存在
  • 无未使用的 import 导入
  • 路径别名(@/)配置正确
  • 第三方库版本兼容性确认

性能优化

  • 组件按需加载(懒加载)已配置
  • 大数据列表已实现虚拟滚动或分页
  • 图片资源已压缩,格式合适
  • 无内存泄漏风险(事件监听器、定时器等)

安全检查

  • 用户输入已做 XSS 防护
  • 敏感信息不在前端硬编码
  • API 请求已做 CSRF 防护
  • 权限控制逻辑正确

🌐 兼容性检查

浏览器兼容

  • 主流浏览器Chrome、Firefox、Safari、Edge显示正常
  • 移动端适配良好(如适用)
  • 分辨率适配1366x768、1920x1080等

设备兼容

  • 触摸设备操作体验良好
  • 键盘导航支持完整
  • 屏幕阅读器兼容性(无障碍)

📱 发布准备

文档更新

  • 相关 API 文档已同步更新
  • 用户操作手册已更新(如适用)
  • 变更日志已记录

回滚预案

  • 回滚方案已准备
  • 数据兼容性已确认
  • 紧急联系人已明确

🔧 后端检查项

编译验证

  • Maven编译成功mvn clean compile
  • 无编译错误,仅有可接受的警告
  • 依赖版本兼容性确认

数据库脚本

  • DDL/DML脚本语法正确
  • 回滚脚本已准备
  • 数据迁移脚本已测试

🔄 前后端协同

接口兼容性

  • API接口契约变更已双方确认
  • 前端调用后端接口正常
  • 错误码处理逻辑一致

最终确认

发布前最后检查

  • 本地构建截图已附在 PR 中
  • 测试环境部署验证通过
  • Code Review 已完成并获得批准
  • 相关 Bug 已关闭或延期说明

文档版本v1.0
最后更新2026年4月24日
负责人:陈琳(文档专家)
适用范围HIS 系统所有前端项目