his/docs/specs/frontend-checklist.md

前端发布前检查清单

📋 基础检查项

代码质量

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

构建验证

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

功能验证

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

🔧 技术检查项

模块导入检查

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

性能优化

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

安全检查

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

🌐 兼容性检查

浏览器兼容

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

设备兼容

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

📱 发布准备

文档更新

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

回滚预案

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

🔧 后端检查项

编译验证

• Maven编译成功（mvn clean package -DskipTests）
• 无编译错误，仅有可接受的警告
• 依赖版本兼容性确认

数据库脚本

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

🔄 前后端协同

接口兼容性

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

✅ 最终确认

发布前最后检查

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

---

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