feat: optimize UI queries and seed number library

2026-08-27 20:24:18 +08:00
parent 138297d191
commit 564234b769
22 changed files with 631 additions and 84 deletions
@@ -1941,6 +1941,40 @@ corepack pnpm@10.33.0 exec vitest run apps/worker-recording/src/transfer.spec.ts
 | 数据检查 | 迁移报告记录公网/私网 IP、端口、证书、备份路径和灰度 Call-ID。 |
 | 安全检查 | SSH 不对全网开放；Redis/MySQL/Prometheus/Grafana 不公网暴露；开发 CA 和本地路径不进入生产。 |

+### 8.10 S57 页面布局、日期范围与号码库
+
+#### WEB-010 页面内容顶部对齐
+
+| 字段 | 内容 |
+| --- | --- |
+| 优先级 | P1 |
+| 步骤 | 登录后依次打开客户网关、用户、号码库以及数据量较少的配置页，检查标题、筛选区和列表面板。 |
+| 预期结果 | 所有区块按内容高度从顶部连续排列，不因视口剩余高度产生大面积空白或组件纵向拉伸。 |
+
+#### ACT-004 B 本机 OpenSIPS MI
+
+| 字段 | 内容 |
+| --- | --- |
+| 优先级 | P0 |
+| 步骤 | 1. 在 B 调用 OpenSIPS HTTP MI `dlg_list`。2. 打开当前通话。3. 发起测试呼叫后刷新。 |
+| 预期结果 | 无 A 服务器 SSH 依赖；空闲时快速返回空列表，呼叫中显示真实 dialog；MI 不可用时 3 秒内失败并显示受控提示。 |
+
+#### DATE-001 三中心默认最近一周
+
+| 字段 | 内容 |
+| --- | --- |
+| 优先级 | P1 |
+| 步骤 | 依次打开话单、质检、操作日志，检查日期输入和请求参数；修改范围查询，再点击重置。 |
+| 预期结果 | 首次和重置均为今天至前 6 天；开始日按 00:00:00、结束日按 23:59:59.999 查询；后端只返回范围内数据。 |
+
+#### NUM-004 号码库全量与分页性能
+
+| 字段 | 内容 |
+| --- | --- |
+| 优先级 | P0 |
+| 步骤 | 1. 导入器先干跑并确认未匹配为 0。2. 备份后导入。3. 核对四表数量。4. 四个页签执行首屏、翻页、页大小和筛选。 |
+| 预期结果 | 371 个行政城市、517,258 个有效七位号段、321 个区号、70 个前缀规则；首屏只读取 25 条；上一页/下一页与总数正确；页面加载不扫描或返回全表。 |
+
 ## 9. 缺陷分级

 | 级别 | 定义 | 示例 |
@@ -1965,7 +1999,7 @@ corepack pnpm@10.33.0 exec vitest run apps/worker-recording/src/transfer.spec.ts
 ## 11. 当前已知风险与补充建议

 - Redis 恢复后 OpenSIPS 热路径曾出现需要重启 `opensips` 才恢复的问题。上线前应补充 Redis 断连重连专项测试，并增加明确指标/告警。
- 当前真实 80 万手机号段尚未导入。号码库性能、导入耗时、批量校验和 CDR 归属地准确性需单独做数据量级测试。
+- S57 号码库采用 517,258 条有效七位号段；归属和运营商字段是公开号段库口径，携号转网后的当前运营商不能仅凭该字段断言，仍需运营商实时数据源校验。
 - 真实 B 浏览器登录态下的逐页按钮、真实录音播放和 Nginx X-Accel 链路仍需人工复核。
 - 阿里云迁移前必须重跑网络安全组、正式 TLS、数据盘、备份恢复、故障注入和灰度呼叫，不应直接沿用本地 KVM 结论。
 - 建议后续增加 Playwright 前端冒烟：登录、菜单遍历、权限账号、关键表单、录音播放入口，降低页面空白类问题复发概率。
@@ -16,11 +16,28 @@
 - 宽表支持横向滚动、右侧操作列固定、长文本自动断行；长列表启用浏览器内容可见性优化。
 - 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 发布结果、生产数量和浏览器证据记录在对应发布报告中。

 ## 本地验证