1.8 KiB
1.8 KiB
Quality Guidelines
Code quality standards for frontend development.
Overview
(To be filled by the team)
Forbidden Patterns
(To be filled by the team)
Required Patterns
长驻页面的静态资源版本握手
- 前端脚本改动不能只依赖固定查询参数或服务重启来生效。已打开的标签页会继续 执行内存中的旧 JavaScript，直到页面被重新加载。
app.js的资源版本必须由服务端根据实际文件内容生成，并同时用于入口页脚本 URL、页面运行时版本和 WebSocket 鉴权结果，避免三处版本语义漂移。- 客户端只在本地版本和服务端版本均合法且不一致时刷新，并设置单次刷新 guard， 防止重连或异常版本数据造成刷新循环。
- 版本自检只能覆盖已经加载该机制的页面；机制上线前已打开的旧页面仍需手动刷新 一次，验收标准不得承诺旧代码自身无法执行的自动升级行为。
Testing Requirements
- 修改入口页、静态资源版本或 WebSocket 鉴权协议时，必须同时覆盖静态契约和隔离 服务集成测试。
- 集成测试至少验证入口页脚本 URL、页面运行时版本和
auth_result.frontendAssetVersion三者一致，并覆盖版本一致、不合法、不一致及 单次刷新 guard。
Code Review Checklist
(To be filled by the team)