3.4 KiB
3.4 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: 修复存量违规(勘察确认共 5 个模组存在裸选择器,修复后须全部通过 check:styles)
- SubTask 3.1:
bomx-reuse-analyzer/styles.css(根容器.bomx-app)::root→.bomx-app、::-webkit-scrollbar*/input[type=...]/select/input:focus/:focus-visible全部加前缀 - SubTask 3.2:
order-cost-analysis:为pages-orig/CostCockpit.tsx、pages-orig/AIMCockpit.tsx根 div 添加ordercost-root类,styles.css顶部级::-webkit-scrollbar三条规则加前缀 - SubTask 3.3:
jieya-ibp:App.tsx 根 div(加载态 + 主态)添加jieya-root类;index.css的button/input, textarea/::-webkit-scrollbar四条规则加前缀 - SubTask 3.4:
welltrust-qap:同 3.3,根类welltrust-root - SubTask 3.5:
supplier-platform/index.css:main、table/th/td/tr.rec-row/tbody tr等裸元素规则加.hansong-app前缀 - SubTask 3.6: 检查受影响模组的
createPortal挂载点均位于模块根容器内(bomx Drawer 挂 document.body 需包.bomx-app类包裹层);baode/bomx/jieya/welltrust 的@media (prefers-reduced-motion)内*通配规则加根前缀;jieya/welltrust 的.space-*同名不同值工具类作用域化、slide-in-right等同名不同体 keyframes 重命名 - SubTask 3.7:
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(实测仅 /src/index.css) - SubTask 5.2: 依次跳转
supplier-platform、wuc-quotation、bomx-reuse-analyzer:按需加载对应 chunk、界面渲染正常、无控制台报错(另验 jieya-ibp 深色主题正常) - 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 无依赖,可并行