4.5 KiB
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.dat2502 版本,共 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。