Files
his/docs/specs/frontend-checklist.md
chenlin 0076753c19 docs: 添加三份构建门禁相关文档
- 《前端发布前检查清单》
- 《CI/CD构建门禁规范》
- 《代码提交变更说明模板》

为解决getDepartmentList导入错误等构建问题提供标准化文档支持
2026-04-24 17:04:42 +08:00

2.3 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 文档已同步更新
  • 用户操作手册已更新(如适用)
  • 变更日志已记录

回滚预案

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

最终确认

发布前最后检查

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

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