refactor: 完成全局CSS模块化治理
CSS quality / css-quality (push) Has been cancelled

This commit is contained in:
hectorzhao
2026-09-05 00:45:05 +08:00
parent 1a7a7245a6
commit 458ddd97df
31 changed files with 17265 additions and 9857 deletions
+9
View File
@@ -4511,3 +4511,12 @@ git diff --check
- 映射弹窗新增页面私有样式约束,解析预览和映射表都使用可收缩容器,长预览内容在自身区域滚动,展开“查看前10行解析预览”不再改变目标字段下拉框宽度;没有向`global.css`新增选择器。
- 控制台所示`VM*:2``reportAllChanges``startTime`调用栈不在仓库源码、依赖声明或构建入口中,形态与浏览器动态注入的Web Vitals采集脚本一致。本轮没有增加全局错误吞噬或修改业务代码掩盖该外部异常;后续真实浏览器验收需用无扩展会话区分平台脚本和注入脚本。
- 定向前端组件测试2项、定向API映射测试3项通过;前端全量13套65项、API全量55套619项通过;前后端TypeScript、API生产构建、Vite生产构建、依赖安全、部署契约、结构质量及增量ESLint通过。Vite仅保留既有Chart分块超过500kB提示,增量ESLint仅保留3条既有Hook依赖warning。本轮按用户最终要求只本地提交,不推送、不部署测试环境或预生产,不操作短信链路、余额、通道及客户配置。
## 2026-09-05 全局CSS模块化治理(本地实施与发布前验收完成)
- 重新读取根目录`AGENTS.md``docs/css-development-guidelines.md`和完整拆分方案后执行。原`global.css`为213062字节、9846行,经PostCSS统计为1749条规则、2017个选择器、5321条声明和30个既有`!important`;现已删除并按原顶层节点顺序迁入14个所有权模块,由`src/styles/domains/index.css`固定顺序加载。各业务域文件均不超过1200行建议值。
- 迁移没有改变CSS级联:格式化新模块并重新生产构建后,迁移前后主CSS均为`index-CkSy6WDi.css`SHA-256均为`d7043ee2229a402c6b9284c9153536dd6393446a3b0fe7c47ee7dd05290539c3`,工作站逐字节比较无差异。机器基线保存完整选择器顺序、模块指标、所有者、摘要、既有例外和入口顺序。
- 新增Stylelint及显式历史兼容范围;未登记新CSS默认执行标准规则。增量Prettier现覆盖CSS,跨平台调用改为直接执行Node入口。CSS治理门禁阻止重建`global.css`、改变模块顺序或AST总量、新增未登记`!important`、新增宽泛业务标签选择器及无import所有者文件;Node四项门禁测试和实际临时违规样例均验证为能拒绝,样例随后删除。
- 新增GitHub CSS质量工作流,在PR中比较目标分支、main推送中比较父提交,避免只检查工作区。实施结果、模块所有权和后续维护边界记录于`docs/css-modularization-result-20260905.md`,方案文档同步改为已实施状态。
- 发布前真实Chrome基线使用测试环境真实API和PostgreSQL数据:运营端13个核心路由、客户端10个核心路由分别在1600×1000、1366×768、390×844检查,共69张截图;页面均非空、无框架错误层、无页面级横向溢出,控制台warning/error为0。临时平台管理员和企业管理员仅用于验收,发布后将精确删除。
- 前端全量13套65项、API全量55套619项、CSS治理4项通过;前后端TypeScript、API/Vite生产构建、Stylelint、增量ESLint/Prettier、依赖安全、部署契约、结构质量、包体积和`git diff --check`通过。入口gzip 107.85KiB,低于250KiB预算;只保留既有Chart分块超过500kB提示。发布、推送、发布后69页三尺寸回归、恢复资产、服务/Stream和临时账号清理结果将在完成后追加。