2.3 KiB
2.3 KiB
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 拆分为独立文件
- SubTask 1.1:
- 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"
- SubTask 2.1: 新增
- Task 3: 修复存量违规
- SubTask 3.1:
src/modules/bomx-reuse-analyzer/styles.css的:root { --xxx }变量迁移至模块根容器类;核对BomxReuseHome.tsx根容器类名并确认页面变量取值正常 - SubTask 3.2:
npm run check:styles退出码 0(存量违规清零)
- SubTask 3.1:
- 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(红线与验证清单补充懒加载要求)
- SubTask 4.1:
- 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页面样式无回归
- SubTask 5.1:
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 无依赖,可并行