Files
2026-10-18 21:50:40 +08:00

2.3 KiB
Raw Permalink 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: 修复存量违规
    • 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 无依赖,可并行