Files
ai-platform/.trae/specs/isolate-and-lazyload-module-styles/tasks.md
T
2026-10-18 23:02:15 +08:00

3.4 KiB
Raw Blame History

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: 修复存量违规(勘察确认共 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(存量违规清零)
  • 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(实测仅 /src/index.css)
    • SubTask 5.2: 依次跳转 supplier-platform、wuc-quotation、bomx-reuse-analyzer:按需加载对应 chunk、界面渲染正常、无控制台报错(另验 jieya-ibp 深色主题正常)
    • 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 无依赖,可并行