This commit is contained in:
2026-10-18 21:50:40 +08:00
parent 4e2459f2c8
commit 90ee2b30f5
3 changed files with 107 additions and 0 deletions
@@ -0,0 +1,25 @@
# Tasks
- [ ] Task 1: 路由级懒加载改造
- [ ] SubTask 1.1: `src/App.tsx` 将 12 个模块组件的静态 import 全部改为 `React.lazy(() => import('...'))`
- [ ] SubTask 1.2: `<Routes>` 外层包 `<Suspense>`,提供平台风格 loading 兜底(居中 spinner + "模块加载中"文案)
- [ ] SubTask 1.3: 验证 `npx tsc -b` 类型检查通过;`npm run build` 后确认 `dist/assets` 中各模块 CSS 拆分为独立文件
- [ ] Task 2: 样式隔离自动检查脚本
- [ ] SubTask 2.1: 新增 `scripts/check-module-styles.mjs`:递归扫描 `src/modules/**/*.css`,检测 `:root`/`html`/`body`/`*` 选择器、裸元素选择器(无类/ID/命名空间前缀的元素标签规则)、`@import` 全局重置;违规输出文件+行号+选择器,非 0 退出
- [ ] SubTask 2.2: `package.json` 注册 `"check:styles": "node scripts/check-module-styles.mjs"`
- [ ] Task 3: 修复存量违规
- [ ] SubTask 3.1: `src/modules/bomx-reuse-analyzer/styles.css` 的 `:root { --xxx }` 变量迁移至模块根容器类;核对 `BomxReuseHome.tsx` 根容器类名并确认页面变量取值正常
- [ ] SubTask 3.2: `npm run check:styles` 退出码 0(存量违规清零)
- [ ] Task 4: 构建门禁与文档同步
- [ ] SubTask 4.1: `package.json` 的 `build` 脚本接入 `check:styles`(`tsc -b && npm run check:styles && vite build`)
- [ ] SubTask 4.2: 更新 `docs/react-module-integration-sop.md`:新增「路由必须 lazy 动态导入」约定与 check:styles 校验说明
- [ ] SubTask 4.3: 同步 `.trae/skills/react-module-integration/SKILL.md`(红线与验证清单补充懒加载要求)
- [ ] Task 5: 端到端验证
- [ ] SubTask 5.1: `npm run dev` 启动,浏览器验证:首页 Network 无任何模块 CSS chunk
- [ ] SubTask 5.2: 依次跳转 `supplier-platform`、`wuc-quotation`、`bomx-reuse-analyzer`:按需加载对应 chunk、界面渲染正常、无控制台报错
- [ ] SubTask 5.3: 抽查首页与登录页视觉无污染、`bomx-reuse-analyzer` 页面样式无回归
# Task Dependencies
- Task 3 依赖 Task 2(需要脚本先检测出违规)
- Task 4 依赖 Task 2、Task 3(违规清零后才接入构建门禁)
- Task 5 依赖 Task 1(懒加载完成后方可验证按需加载);SubTask 5.3 依赖 Task 3
- Task 2 与 Task 1 无依赖,可并行