Files
lisglosips/docs/UI_PERFORMANCE_REMEDIATION_IMPLEMENTATION_20260827.md

4.5 KiB

UI 与页面性能整改实施记录(2026-08-27)

实施范围

本次按《LisgloSIPS UI 性能整改方案》实施前端加载体验、按页面取数、Dashboard 请求合并、话单首屏性能、质检与号码库懒加载、宽表可读性和中文状态文案。TLS 证书按要求不在本次代码整改范围内,未修改证书或生产环境配置。

已完成

  • 全局请求增加 10 秒超时和主动取消;切换菜单时取消上一页面请求,避免旧响应覆盖当前页面。
  • 页面请求超过 2 秒才显示加载弹窗,完成、失败或取消后立即隐藏;表格加载中显示骨架,不再与空状态同时出现。
  • 登录首页由全站 11 组接口预加载改为按当前路由加载;Dashboard 新增 /api/v2/dashboard/overview,服务端并行取得 summary 与 trends,前端只发一个首页概览请求。
  • 话单默认页大小由 100/50 降为 25;列表与总数改为并行查询,并增加 startedAt desc, id desc 稳定排序;主表精简为核心字段,完整信息保留在详情抽屉。
  • 质检录音默认限制为 50;抽检规则及客户/线路依赖只在打开规则抽屉时加载。
  • 号码库由首次同时加载四个页签改为只加载当前页签,其他页签首次打开时再读取。
  • 当前通话自动刷新改为静默更新;失败后停止自动轮询,避免 5 秒间隔持续叠加失败请求;手动首次加载仍使用延迟弹窗。
  • 宽表支持横向滚动、右侧操作列固定、长文本自动断行;长列表启用浏览器内容可见性优化。
  • Dashboard 未接入指标明确显示“等待真实数据”,不再使用开发 fixture 伪装实时数据;操作向文案已做中文化。

S57 补充整改

  • 全局 .page-content 固定为顶部对齐和内容高度网格行,消除数据较少时标题、筛选区和列表面板被拉伸形成的大面积空白;分页和日期范围控件收敛为全局组件和样式。
  • 当前通话不再依赖 B 到 A 的 SSH 包装命令,API 改为请求 B 本机 http://127.0.0.1:8888/mi 的 OpenSIPS JSON-RPC;保留 SSH 模式作为显式回滚选项。
  • 话单中心、质检中心、操作日志统一默认查询最近 7 个自然日(含今天),结束日期覆盖至当天 23:59:59.999;重置后仍恢复最近一周,不再回到无限时间范围。
  • 质检录音和操作日志补齐后端日期过滤,操作日志查询由“只对首批 100 条做浏览器过滤”改为日期、模块、结果的服务端过滤。
  • Dashboard 删除“客户消费 TOP 10”和“失败响应码分布”两个模块。
  • 号码库默认每页 25 条,四个页签分别维护分页游标、页大小和总数,只请求当前页;增加可重复执行的数据导入脚本,导入时保存来源和批次并拒绝部分匹配。

号码库数据口径

  • 行政区划:国家统计局 2023-06-30 区划代码的 2024 整理版本;包含地级行政区和省/自治区直辖县级市,共 371 条。
  • 手机号段:phone.dat 2502 版本,共 517,258 条有效七位号段;运营商信息受携号转网影响,只表示号段原始分配归属,不作为当前在网运营商的强校验。
  • 城市区号:由号段库归属记录按城市多数匹配生成 321 条;当前表结构一个区号只能关联一个城市,共享区号按数据中出现最多的城市保存。
  • 运营商前缀:由七位号段按前三位多数归属生成 70 条,业务判定仍应优先使用七位号段。
  • 导入器要求所有有效号段均能映射到行政区代码;本批次干跑结果为未匹配 0 条。生产导入前必须先运行 MySQL/Redis 备份。

S56 时暂未直接实施(现状更新)

  • 未新增数据库索引。整改方案要求先以生产库 EXPLAIN ANALYZE 或等价执行计划确认慢点;当前没有获得生产数据库只读诊断授权和执行计划,直接增加索引可能放大写入成本。
  • 未修改 TLS 证书、Nginx 或生产部署配置。
  • S57 发布结果、生产数量和浏览器证据记录在对应发布报告中。

本地验证

  • ESLint:通过。
  • TypeScript project build/typecheck:通过。
  • Vitest:27 个测试文件、98 个测试全部通过。
  • Web production build:通过,生成 dist/index.html、CSS 和 JS hash 产物。
  • 浏览器验收:已在 B 的真实登录态逐页检查 Dashboard、客户网关、当前通话、号码库、话单、质检和操作日志;生产结果和接口耗时见 20260827_S57_UI_NUMBER_LIBRARY_RELEASE_REPORT.md