refactor(quality): Q38 UnifiedQueryPanel 529L→353L (-33%) — 提取 useLogQueryEngine + useLogExport 自定义 Hooks,全项目最后一个 ≥500L 业务组件清零
- useLogQueryEngine.ts (295L): 查询执行引擎 Hook — 封装 loading/entries/statTable/clusters/histogramData/totalCount/queryTime/hasMore/liveTail/hasQueried 状态 + handleRun/handleLoadMore/fetchHistogram/runLiveTailTick + Live Tail useEffect(3s) - useLogExport.ts (62L): 导出/复制 Hook — formatEntryLine + handleExportLogs(Blob) + handleCopyLogs(clipboard) - 主文件保留: 数据源加载/URL bootstrap+sync/Loki 标签名/ES mapping effects + 派生数据 + 非查询回调 + JSX 子组件编排 - 首次使用 custom Hook 提取模式进行组件拆分 - tsc -b=0, npm build✓ (16.69s), ESLint=0/66/0, go build=0, 17/17 测试通过
This commit is contained in:
1 parent
ee4d6916bb
commit
f178609d09
5 files changed
+426
-216
No files matched your search
+29
@@ -510,6 +510,7 @@ services/api.ts (1324L)
|
||||
| Q36 | 前端巨型工具文件拆分(predictUtils.ts 716L→49L barrel re-export (-93%),提取 predict-types.ts 140L 类型+常量 + capacity-predict.ts 194L 容量预测函数(linearRegression+computePredictions+buildCapacityInsightPrompt) + cost-predict.ts 434L 云成本预测函数(computeCostPredictions+buildCostInsightPrompt),3 个消费者 import 路径无需修改,tsc -b=0,npm build✓ (17.26s),ESLint=0/66/0,go build=0,17/17 测试通过) | P0 | **done** |
|
||||
| U15 | ApiAccessKeySection i18n 迁移(清理 56 个 apiaccesskey.s{hash} 乱码键为语义化 user.apiKey.* 键 + 组件全量接入 useTranslation,UI 中文 57→0,zh/en 7556=7556 对齐,零 hash 键残留) | P3 | **done** |
|
||||
| Q37 | 前端巨型工具文件拆分(k8s-yaml-utils.ts 504L→451L + k8s-helpers.ts 67L 新文件,提取 7 个通用工具函数 parseScalar/STATUS_COLORS/statusColor/aggregateByImage/formatK8sTime/elapsedSeconds/formatDuration,barrel re-export 保持 8 个消费者零修改) | P0 | **done** |
|
||||
| Q38 | 前端巨型组件拆分(UnifiedQueryPanel 529L→353L (-33%),提取 unified-query/useLogQueryEngine.ts 295L 查询执行引擎 Hook + useLogExport.ts 62L 导出/复制 Hook,全项目最后一个 ≥500L 业务组件清零) | P0 | **done** |
|
||||
|
||||
---
|
||||
|
||||
@@ -1467,4 +1468,32 @@ pending → in_progress → done / blocked
|
||||
- [x] Docker 部署 healthy,前端页面正常加载(HTTP 200)
|
||||
- [x] 流水线编辑器页功能不变(流程配置/触发器/变量/发布记录/成员管理 5 个 Tab 全部正常)
|
||||
|
||||
---
|
||||
|
||||
## Q38: 前端巨型组件拆分 — UnifiedQueryPanel [done]
|
||||
|
||||
**问题**: `UnifiedQueryPanel.tsx`(529 行)是全项目最后一个 ≥500 行的业务组件(排除 UI 库 sidebar.tsx 690L / data-table.tsx 656L),包含日志查询面板的全部逻辑:~40 个 useState 状态管理、查询执行(Loki/ES 分支 + 直方图加载 + 派生数据 + 历史记录)、加载更多(分页游标)、Live Tail 实时追踪(3s interval + 去重 + 截断)、导出/复制、以及 6 个 useEffect(URL bootstrap/sync、Loki 标签名、ES mapping、Live Tail、自动运行)。虽然 UI 子组件已提取(Q13: 682L→529L),但核心业务逻辑仍全部内联。
|
||||
|
||||
**已完成 (2026-07-10)**:
|
||||
|
||||
将查询执行逻辑和导出/复制逻辑提取为 `unified-query/` 子目录下的自定义 Hooks:
|
||||
|
||||
| 新文件 | 行数 | 职责 |
|
||||
|--------|------|------|
|
||||
| `useLogQueryEngine.ts` | 295 | 日志查询执行引擎 Hook — 封装查询状态机:loading/entries/statTable/clusters/histogramData/totalCount/queryTime/hasMore/loadingMore/liveTail/hasQueried + fetchHistogram/handleRun/handleLoadMore/runLiveTailTick + Live Tail useEffect(3s interval),接收 effEngine/query/currentSource/esIndex/queryLimit/timeRange/setTimeRange/toast/t 作为 opts |
|
||||
| `useLogExport.ts` | 62 | 日志导出/复制 Hook — formatEntryLine + handleExportLogs(Blob 下载) + handleCopyLogs(clipboard),接收 effEngine/toast/t 作为 opts |
|
||||
|
||||
主文件从 **529 行降至 353 行**(-33%),全项目无 ≥500 行业务组件。
|
||||
|
||||
**关键改进**: 项目首次使用 custom Hook 提取模式进行组件拆分。`useLogQueryEngine` 封装了完整的查询状态机(执行/加载更多/直方图/Live Tail),主组件通过 opts 传入依赖。原 `timeIsoParams` useCallback 消除(4 处使用改为直接内联),export/callback 从闭包捕获改为参数传入使 Hook 可复用。
|
||||
|
||||
**验收标准**:
|
||||
- [x] UnifiedQueryPanel.tsx 从 529 行降至 **353 行**(-33%),全项目无 ≥500 行业务组件
|
||||
- [x] `tsc -b` 零错误
|
||||
- [x] `npm run build` 零错误(✓ built in 16.69s)
|
||||
- [x] ESLint errors 保持 **0**,warnings 保持 **66**
|
||||
- [x] 全局 ESLint any 保持 **0**,unused-vars 保持 **0**
|
||||
- [x] `go build` 零错误
|
||||
- [x] 17/17 集成回归测试通过(零回归)
|
||||
- [x] Docker 部署 healthy,前端页面正常加载(HTTP 200)
|
||||
|
||||
Reference in new issue
Block a user