ctc_poc2026/POC-TSG匹配测试用例_DMK库表清单(1).md

# POC-TSG匹配测试用例 DMK 库表清单

## 1. 设计结论

本次查询服务建议建设 `dmk` 模式下的两类表：`td_` 维度/配置表和 `tm_` 月粒度业务指标表。设计不采用“一个业务一两张超宽表”的方式，而是按楼宇、区域栅格、重点场景、聚类质差、报表导出五个查询主题拆分指标表；在各 `tm_` 表中回填高频筛选、排序、列表展示字段，减少 Java 查询时的运行时关联。

业界实践可提炼为三点：

- 查询服务层优先围绕接口查询模式做反范式宽表，冗余常用维度字段，避免高频 Join。
- 维度表仍需保留，作为枚举、区域、楼宇、场景、图层口径的统一治理来源，避免不同指标表语义漂移。
- GIS 字段以 WKT 文本作为接口和数据交换口径，同时在 PostgreSQL/PostGIS 中使用生成列转换为 `geometry`，并建立 GiST 空间索引，兼顾 WKT 呈现和空间过滤性能；GeoServer 图层可按 `geom_column` 直接发布，也可在视图中统一别名为 `geom`。

## 2. 命名和建模约定

| 项 | 约定 |
| --- | --- |
| 数据库 | PostgreSQL + PostGIS |
| Schema | `dmk` |
| 维度/配置表 | `td_` 开头 |
| 指标/业务表 | `tm_` 开头 |
| 时间粒度 | 月账期，统一字段 `year_month`，保留 `year`、`month` |
| GIS 存储 | 原始/接口字段使用 `*_wkt`，数据库生成 `*_geom` 空间列 |
| 坐标系 | EPSG:4326 |
| 分区建议 | 数据量大的 `tm_*_m` 表按 `year_month` 做月分区或冷热分层 |
| 字段命名 | 优先沿用 PRD 和接口清单中的 `provincecode`、`citycode`、`regionid`、`x_offset_20`、`operator_name`、`network_class`、`rsrpcount`、`avgrsrp` 等字段 |

## 3. 库表总览

### 3.1 维度/配置表

| 表名 | 粒度 | 主要用途 | 支撑接口/场景 |
| --- | --- | --- | --- |
| `td_account_period` | 数据来源 + 月账期 | 可查询账期 | `/api/common/account-periods` |
| `td_region` | 行政区域 | 省/市/区县树、分权分域、GIS 钻取 | `/api/common/region-tree`、质差地图 |
| `td_dict_item` | 字典类型 + 字典值 | 枚举统一管理 | `/api/common/dict`、`/api/common/dict/types` |
| `td_metric_definition` | 模块 + 指标 + 阈值 | 指标口径、算法说明 | `/api/common/metric-definitions`、报表口径弹窗 |
| `td_layer_config` | 图层类型 + 图层角色 + 渲染模式 | GeoServer 图层基础配置 | 楼宇/栅格/场景/工参/聚类/质差 WMS 图层 |
| `td_layer_metric` | 图层类型 + 指标 | 图层指标白名单和默认样式 | `/api/common/layer-metrics` |
| `td_layer_legend` | 账号 + 图层 + 指标 | 自定义图例配置 | `/api/layers/legends/*` |
| `td_grid` | 栅格 | 栅格空间维度和中心点 | 栅格详情、空间关联、GeoServer 发布 |
| `td_cell_param_m` | 月账期 + 小区 + 网络制式 | 工参基础信息 | `/api/layers/cells`、`/api/layers/cells/detail` |
| `td_building` | 楼宇 | 楼宇基础属性、AOI、楼宇类型 | `/api/buildings/*`、`/api/ott/building-report` |
| `td_building_grid_m` | 月账期 + 楼宇 + 栅格 + 运营商 + 网络制式 + 频段 + 室内外 | 楼宇-栅格桥接、楼宇图层 | `/api/buildings/layer` |
| `td_building_cell_m` | 月账期 + 楼宇 + 小区 + 运营商 + 网络制式 + 频段 + 室内外 | 楼宇-小区桥接、楼宇小区关系 | `/api/buildings/cells` |
| `td_scene` | 重点场景 | 场景基础属性、AOI、场景类型 | `/api/scenes/*`、`/api/ott/scene-report` |
| `td_cluster_threshold` | 账号 + 聚类类型 + 网络制式 | 在线调整聚类阈值 | `/api/clusters/thresholds/*` |
| `td_custom_region` | 用户自定义区域 | GIS 绘制区域持久化和复查 | `/api/grids/custom-region` |

### 3.2 业务指标表

| 表名 | 粒度 | 主要用途 | 支撑接口/场景 |
| --- | --- | --- | --- |
| `tm_grid_coverage_m` | 月账期 + 栅格 + 运营商 + 网络制式 + 频段 + 室内外 | 栅格级覆盖指标、GIS 渲染、单栅格详情 | `/api/grids/layer`、`/api/grids/detail`、区域/场景栅格聚合 |
| `tm_region_coverage_m` | 月账期 + 行政区域 + 运营商 + 网络制式 + 频段 + 室内外 | 区域概览、覆盖统计、地市级 OTT 报表 | `/api/grids/overview`、`/api/grids/coverage-stats`、`/api/ott/city-report` |
| `tm_building_coverage_m` | 月账期 + 楼宇 + 运营商 + 网络制式 + 频段 + 室内外 | 楼宇图层、概览、室内无线覆盖、竞对对比、4G/5G_SA 用户与市场份额、报表 | `/api/buildings/overview`、`/api/buildings/layer`、`/api/buildings/compare`、`/api/buildings/report` |
| `tm_scene_grid_coverage_m` | 月账期 + 场景 + 栅格 + 运营商 + 网络制式 + 频段 + 室内外 | 场景栅格图层、场景-栅格覆盖 | `/api/scenes/layer` |
| `tm_building_user_wifi_m` | 月账期 + 楼宇 + 运营商 | 楼宇 WiFi 用户、WiFi 市场份额和 WiFi 信号强度 | `/api/buildings/detail` |
| `tm_scene_coverage_m` | 月账期 + 场景 + 运营商 + 网络制式 + 频段 + 室内外 | 重点场景概览、用户分析、单场景覆盖扩展、对比、报表 | `/api/scenes/overview`、`/api/scenes/user-analysis`、`/api/scenes/detail`、`/api/ott/scene-report` |
| `tm_cell_grid_coverage_m` | 月账期 + 数据来源 + 运营商 + 网络制式 + 频段 + 室内外 + 小区 + 覆盖栅格 | 小区详情、覆盖扩展指标、单小区覆盖栅格、栅格与小区连线 | `/api/layers/cells/detail`、`/api/layers/cells/cover-grid`、`/api/grids/detail` |
| `tm_cluster_area_m` | 月账期 + 聚类区域 | 聚类清单、覆盖扩展指标、加权得分、多维分析、聚类 WMS | `/api/clusters/overview`、`/api/clusters/list`、`/api/clusters/detail`、`/api/clusters/score` |
| `tm_cluster_feedback` | 反馈记录 | 质差区域问题根因和解决措施 | `/api/clusters/feedback/*` |
| `tm_poor_region_metric_m` | 月账期 + 区域 + 统计页签 + 质差类型 + 指标分组 + 场景类型 + 网络制式 + 指标 | 质差场景概览、趋势、地图、排名 | `/api/poor-scenes/summary`、`/api/poor-scenes/trend`、`/api/poor-scenes/map`、`/api/poor-scenes/ranking` |
| `tm_poor_scene_list_m` | 月账期 + 质差场景记录 | 质差场景清单和导出 | `/api/poor-scenes/list`、`/api/poor-scenes/export` |
| `tm_poor_cell_list_m` | 月账期 + 质差/超忙小区记录 | 质差小区、超忙小区清单和导出 | `/api/poor-scenes/cells`、`/api/poor-scenes/export` |
| `tm_export_task` | 导出任务 | 异步导出任务状态、下载、取消 | `/api/common/export-tasks/*`、各导出接口 |

## 4. 主题域设计说明

### 4.1 通用配置域

包含 `td_account_period`、`td_region`、`td_dict_item`、`td_metric_definition`、`td_layer_config`、`td_layer_metric`、`td_layer_legend`、`tm_export_task`。该域不参与大规模指标计算，主要支撑通用筛选、口径说明、图层配置、导出任务。

`td_layer_config` 通过 `layer_role` 区分基础图层、视图层或发布层，通过 `geom_column` 明确 GeoServer 发布时实际使用的几何列名；若服务侧采用视图输出，则可统一别名为 `geom`。

### 4.2 区域栅格域

核心表为 `td_grid`、`tm_grid_coverage_m`、`tm_region_coverage_m`。`tm_grid_coverage_m` 保留栅格 WKT 和主要覆盖指标，便于 GeoServer 直接发布图层；`tm_region_coverage_m` 按省/市/区县提前聚合，用于概览卡片、覆盖统计和 OTT 地市报表，避免每次从栅格明细实时聚合。

### 4.3 楼宇域

核心表为 `td_building`、`td_building_grid_m`、`td_building_cell_m`、`tm_building_coverage_m`、`tm_building_user_wifi_m`。楼宇指标表回填楼宇类型、区域、中心点、楼宇面积、AOI WKT 等高频字段，支撑 2D/3D 图层、竞对对比、楼宇报表；室内 4G/5G_SA 无线覆盖通过 `tm_building_coverage_m.network_class='4G'/'5G_SA'` 与 `indoor_flag=1` 表达，并补充弱覆盖、重叠覆盖、过覆盖、MOD 干扰等覆盖扩展字段；楼宇无线市场份额不再作为单一核心指标，替换为 `user_count_4g`、`user_market_share_4g`、`user_count_5g`、`user_market_share_5g`。楼宇-栅格和楼宇-小区桥接表分别支撑楼宇图层与楼宇小区关系查询；WiFi 指标独立成表，避免在网络制式维度下大量重复 WiFi 字段。

### 4.4 重点场景域

核心表为 `td_scene`、`tm_scene_grid_coverage_m`、`tm_scene_coverage_m`。场景覆盖指标表回填场景类型、场景名称、AOI WKT、区域字段、用户统计字段和覆盖扩展字段，满足场景搜索、概览、用户分析、单场景详情、图层配置、场景级报表；场景-栅格桥接表支撑 `/api/scenes/layer`。

### 4.5 工参与小区覆盖域

核心表为 `td_cell_param_m`、`tm_cell_grid_coverage_m`。工参维度按月保留，避免工参随账期变化导致历史查询不一致；小区覆盖栅格表按小区与栅格关系展开，支撑单小区覆盖栅格、栅格 TOP 小区、栅格-小区连线和小区覆盖扩展指标。工参字段保留在 `td_cell_param_m`，覆盖统计字段统一落在 `tm_cell_grid_coverage_m`。入库时 WKT 需先校验类型、`SRID=4326` 与 `ST_IsValid`；若来源是 GeoJSON/BBox，先在 ETL/服务侧转换成 WKT 再入库。

### 4.6 聚类与质差域

核心表为 `td_cluster_threshold`、`tm_cluster_area_m`、`tm_cluster_feedback`、`tm_poor_region_metric_m`、`tm_poor_scene_list_m`、`tm_poor_cell_list_m`。聚类区域与质差概览分表，避免将聚类评分、质差趋势、清单导出全部塞入单张大表；`tm_cluster_area_m` 同时保留聚类区域覆盖扩展字段，用于聚类栅格详情和加权得分展示；清单表内回填排序、筛选和导出所需的区域、场景、小区字段。

## 5. 原始数据到 DMK 表映射

### 5.1 基础数据源说明

本项目所有计算依赖以下三张 ODS 基础表：

| ODS 表名 | 数据内容 | 主要字段 |
| --- | --- | --- |
| `ods.OTT_GRID` | OTT 栅格级覆盖数据 | `year_month`, `provincecode`, `citycode`, `districtcode`, `operator_name`, `network_class`, `regionid`, `x_offset_20`, `y_offset_20`, `center_lon`, `center_lat`, `earfcn`, `freq`, `rsrpcount`, `totalrsrp`, `totalsinr`, `totalrsrq`, `avgrsrp`, `avgsinr`, `avgrsrq`, `rsrpgoodcount_105`, `rsrpgoodcount_110`, `sinrgoodcount`, `rsrqgoodcount`, `compgoodcount_105_3`, `compgoodcount_110_3` 及 RSRP/SINR/RSRQ 分级统计字段 |
| `ods.4G_MR_GRID_SCELL` | 4G 小区-栅格 MR 数据 | `provincecode`, `citycode`, `districtcode`, `cellkey`, `cell_name`, `cell_lon`, `cell_lat`, `cell_regionid`, `pci`, `indoor_flag`, `azimuth`, `freq`, `vendor`, `antenna_height`, `rspower`, `regionid`, `x_offset_20`, `y_offset_20`, `grid_lon`, `grid_lat`, `rsrpcount`, `totalrsrp`, `avgrsrp`, `weakcover_mrcount`, `overlap_mrcount`, `overlap_totalrsrp`, `overlap_avgrsrp`, `overshoot_mrcount`, `overshoot_totalrsrp`, `overshoot_avgrsrp`, `mod3interfer_mrcount`, `mod3interfer_totalrsrp`, `mod3interfer_avgrsrp`, `avg_sinr`, `is_highrail_grid`, `is_highway_grid`, `is_build_grid`, `is_road_grid` 及 RSRP 5级分段统计字段 |
| `ods.5G_MR_GRID_SCELL` | 5G 小区-栅格 MR 数据 | `provincecode`, `citycode`, `districtcode`, `cellkey`, `cell_name`, `cell_lon`, `cell_lat`, `cell_regionid`, `pci`, `indoor_flag`, `azimuth`, `freq`, `vendor`, `antenna_height`, `rspower`, `regionid`, `x_offset_20`, `y_offset_20`, `grid_lon`, `grid_lat`, `ssrsrpcount`, `totalrsrp`, `avg_rsrp`, `weak_cover_mr_nums`, `overlap_mrcount`, `overlap_totalrsrp`, `overlap_avgrsrp`, `overshoot_mrcount`, `overshoot_totalrsrp`, `overshoot_avgrsrp`, `mod30interfer_mrcount`, `mod30interfer_totalrsrp`, `mod30interfer_avgrsrp`, `avg_sinr`, `is_highrail_grid`, `is_highway_grid`, `is_build_grid`, `is_road_grid` 及 RSRP 10级分段统计字段 |

### 5.2 映射规则

| 原始/补充数据 | 入库目标 | 处理说明 |
| --- | --- | --- |
| `ods.OTT_GRID` | `tm_grid_coverage_m`、`tm_region_coverage_m`、`tm_building_coverage_m`、`tm_scene_coverage_m`、`tm_scene_grid_coverage_m` | 从 OTT_GRID 提取 `rsrpcount`, `totalrsrp`, `totalsinr`, `totalrsrq`, `avgrsrp`, `avgsinr`, `avgrsrq`, `rsrpgoodcount_105`, `rsrpgoodcount_110`, `sinrgoodcount`, `rsrqgoodcount`, `compgoodcount_105_3`, `compgoodcount_110_3` 及分级统计字段；计算 `mr_cover_rate_105 = rsrpgoodcount_105 / rsrpcount`、`mr_cover_rate_110 = rsrpgoodcount_110 / rsrpcount`；回填 `grid_count`（范围内总栅格数）、`mr_grid_count`（有 MR 采样点的栅格数）、`covered_grid_count_105/110`；通过 `network_class` 区分 4G/5G_SA；`operator_name` 区分运营商 |
| `ods.4G_MR_GRID_SCELL` | `td_cell_param_m`、`tm_cell_grid_coverage_m`、`tm_building_coverage_m`、`tm_scene_coverage_m`、`tm_cluster_area_m` | 工参字段（`cellkey`, `cell_name`, `cell_lon`, `cell_lat`, `pci`, `indoor_flag`, `azimuth`, `freq`, `vendor`, `antenna_height`, `rspower`）入库 `td_cell_param_m`；覆盖指标（`rsrpcount`, `avgrsrp`, `avg_sinr`, `weakcover_mrcount`, `overlap_mrcount`, `overlap_totalrsrp`, `overlap_avgrsrp`, `overshoot_mrcount`, `overshoot_totalrsrp`, `overshoot_avgrsrp`, `mod3interfer_mrcount`, `mod3interfer_totalrsrp`, `mod3interfer_avgrsrp`）标准化到各指标表；4G MOD3 干扰字段按 `mod3interfer_*` 解释 |
| `ods.5G_MR_GRID_SCELL` | `td_cell_param_m`、`tm_cell_grid_coverage_m`、`tm_building_coverage_m`、`tm_scene_coverage_m`、`tm_cluster_area_m` | 工参字段同 4G 入库 `td_cell_param_m`；覆盖指标使用 `ssrsrpcount`, `avg_rsrp`, `avg_sinr`, `weak_cover_mr_nums`, `mod30interfer_*` 等字段；5G MOD30 干扰字段按 `mod30interfer_*` 解释；注意 5G 字段命名差异（`ssrsrpcount` vs `rsrpcount`，`avg_rsrp` vs `avgrsrp`） |
| 楼宇基础/AOI 数据 | `td_building`、`td_building_grid_m`、`td_building_cell_m`、`tm_building_coverage_m` | 统一 `building_id`、`building_type`、`building_area`、`aoi_wkt`、`bbox`、人口密度 |
| 场景 AOI 数据 | `td_scene`、`tm_scene_grid_coverage_m`、`tm_scene_coverage_m`、`tm_poor_scene_list_m` | 统一 `scene_id`、`scene_type`、`aoi_wkt`、场景搜索字段 |
| 用户统计补充表 | `tm_region_coverage_m`、`tm_building_coverage_m`、`tm_scene_coverage_m`、`tm_cluster_area_m` | 回填用户数、4G/5G_SA 用户数、市场份额；楼宇侧回填 `user_count_4g`、`user_market_share_4g`、`user_count_5g`、`user_market_share_5g` |
| WiFi 统计补充表 | `tm_building_user_wifi_m` | 回填楼宇 WiFi 用户数、WiFi 市场份额、WiFi 信号强度 |
| 聚类算法结果 | `tm_cluster_area_m` | 回填加权得分、五维权重、区域 WKT、TOP 档位排序字段 |
| 质差识别结果 | `tm_poor_region_metric_m`、`tm_poor_scene_list_m`、`tm_poor_cell_list_m` | 生成概览卡片、趋势、地图、排名、清单导出所需指标 |

### 5.3 字段命名差异说明

| 差异点 | 4G 字段 | 5G 字段 | 目标表统一字段 |
| --- | --- | --- | --- |
| MR 总数 | `rsrpcount` | `ssrsrpcount` | `rsrpcount`（4G 直接用，5G 映射） |
| 平均 RSRP | `avgrsrp` | `avg_rsrp` | `avgrsrp`（4G 直接用，5G 映射为 `avgrsrp`） |
| 弱覆盖数 | `weakcover_mrcount` | `weak_cover_mr_nums` | `weakcover_mrcount`（4G 直接用，5G 映射） |
| MOD 干扰 | `mod3interfer_*` | `mod30interfer_*` | `mod_interference_*`（通用字段，按 `network_class` 解释为 MOD3 或 MOD30） |
| 平均 SINR | `avg_sinr` | `avg_sinr` | `avg_sinr` |

## 6. 接口到表映射

| 接口组 | 主要读取表 |
| --- | --- |
| 通用基础接口 | `td_account_period`、`td_region`、`td_dict_item`、`td_metric_definition`、`td_layer_metric`、`tm_export_task` |
| 楼宇覆盖与 3D 图层 | `td_building`、`td_building_grid_m`、`td_building_cell_m`、`tm_building_coverage_m`、`tm_building_user_wifi_m`、`td_layer_config`、`td_layer_legend`、`td_cell_param_m` |
| 图层、工参与自定义图例 | `td_layer_config`、`td_layer_metric`、`td_layer_legend`、`td_cell_param_m`、`tm_cell_grid_coverage_m`、`tm_scene_grid_coverage_m` |
| 区域栅格 | `tm_region_coverage_m`、`tm_grid_coverage_m`、`tm_cell_grid_coverage_m`、`td_custom_region` |
| 重点场景 | `td_scene`、`tm_scene_grid_coverage_m`、`tm_scene_coverage_m`、`td_layer_config`、`td_layer_legend` |
| 聚类栅格与加权得分 | `td_cluster_threshold`、`tm_cluster_area_m`、`tm_cluster_feedback`、`tm_export_task` |
| 质差场景概览 | `tm_poor_region_metric_m`、`tm_poor_scene_list_m`、`tm_poor_cell_list_m`、`tm_export_task` |
| OTT 报表检索 | `tm_region_coverage_m`、`tm_scene_coverage_m`、`tm_building_coverage_m`、`tm_export_task` |

## 7. 覆盖扩展字段清单

### 7.1 通用覆盖扩展字段

以下字段用于承接模型修正表中“需要扩展字段”的覆盖呈现要求；同一条记录仍通过 `operator_name`、`network_class`、`freq`、`indoor_flag` 区分运营商、4G/5G_SA、频段与室内外，不新增 4G/5G_SA 成对物理字段。

| 字段 | 类型 | 含义 | 适用表 |
| --- | --- | --- | --- |
| `rsrpcount` | `bigint` | RSRP/MR 采样点数 | 各覆盖指标表既有或新增 |
| `avgrsrp` / `avg_rsrp` | `numeric(10,4)` | 平均 RSRP（dBm） | `tm_building_coverage_m`、`tm_scene_coverage_m`、`tm_cell_grid_coverage_m`、`tm_cluster_area_m` |
| `avgsinr` / `avg_sinr` | `numeric(10,4)` | 平均 SINR（dB） | `tm_building_coverage_m`、`tm_scene_coverage_m`、`tm_cell_grid_coverage_m`、`tm_cluster_area_m` |
| `weakcover_mrcount` | `bigint` | 弱覆盖采样数 | `tm_building_coverage_m`、`tm_scene_coverage_m`、`tm_cell_grid_coverage_m`、`tm_cluster_area_m` |
| `overlap_mrcount` | `bigint` | 重叠覆盖采样数 | 同上 |
| `overlap_total_value` | `numeric(20,4)` | 重叠覆盖总值 | 同上 |
| `overlap_rate` | `numeric(12,6)` | 重叠覆盖率 | 同上 |
| `overlap_avgrsrp` | `numeric(10,4)` | 重叠覆盖平均 RSRP（dBm） | 同上 |
| `overshoot_mrcount` | `bigint` | 过覆盖采样数 | 同上 |
| `overshoot_total_value` | `numeric(20,4)` | 过覆盖总值 | 同上 |
| `overshoot_rate` | `numeric(12,6)` | 过覆盖率 | 同上 |
| `overshoot_avgrsrp` | `numeric(10,4)` | 过覆盖平均 RSRP（dBm） | 同上 |
| `mod_interference_mrcount` | `bigint` | MOD 干扰采样数；4G 按 MOD3、5G 按 MOD30 解释 | 同上 |
| `mod_interference_total_value` | `numeric(20,4)` | MOD 干扰采样点总值；4G 按 MOD3、5G 按 MOD30 解释 | 同上 |
| `mod_interference_avgrsrp` | `numeric(10,4)` | MOD 干扰平均 RSRP（dBm）；4G 按 MOD3、5G 按 MOD30 解释 | 同上 |
| `mod_interference_ratio` | `numeric(12,6)` | MOD 干扰占比；4G 按 MOD3、5G 按 MOD30 解释 | 同上 |

### 7.2 分表补充字段

| 表名 | 本次补充字段 | 说明 |
| --- | --- | --- |
| `tm_building_coverage_m` | `avgrsrq`、通用覆盖扩展字段、`user_count_4g`、`user_count_5g`、`user_market_share_4g`、`user_market_share_5g` | 支撑楼宇室内 4G/5G_SA 无线覆盖、竞对无线网络覆盖和“无线市场份额”替换指标。 |
| `tm_scene_coverage_m` | 通用覆盖扩展字段 | 支撑单场景详情中的覆盖相关指标；用户数、市场份额和 5G 驻留比沿用既有字段。 |
| `tm_cell_grid_coverage_m` | `totalsinr`、`rsrpgoodcount_105`、`rsrpgoodcount_110`、`mr_cover_rate_105`、`mr_cover_rate_110`、通用覆盖扩展字段中该表原缺失字段 | 支撑小区维度和栅格小区维度的覆盖详情；`avg_sinr` 维持既有命名。 |
| `tm_cluster_area_m` | `rsrpcount`、通用覆盖扩展字段 | 支撑聚类栅格详情的覆盖指标；`weak_grid_count`/`weak_grid_ratio` 继续表示弱覆盖栅格数/占比，不替代弱覆盖采样数。 |
| `tm_building_user_wifi_m` | 删除 `total_user_count`、`user_count`、`market_share`，保留 `wifi_total_user_count`、`wifi_user_count`、`wifi_market_share`、`wifi_signal_strength` | 楼宇无线用户数和市场份额迁移到 `tm_building_coverage_m` 的 4G/5G 拆分字段；该表仅承载 WiFi 指标。 |

## 8. 索引建议

| 表类型 | 索引策略 |
| --- | --- |
| 月粒度指标表 | 组合索引以 `year_month` 起始，追加区域、运营商、网络制式、频段、室内外等高频筛选字段 |
| 列表/排名表 | 对 `weighted_score`、`rank_no`、`grid_cover_rate`、`mr_cover_rate` 等排序字段建立局部或组合索引 |
| GIS 表 | 对 `*_geom` 生成列建立 GiST 索引；保留 `bbox` 供接口快速返回地图视野 |
| 模糊搜索 | 场景名、楼宇名可按实际 PostgreSQL 扩展情况补充 `pg_trgm` GIN 索引 |
| 写入配置表 | 按 `account_id`、`layer_type`、`metric_code`、`cluster_type` 建唯一或普通索引 |

## 9. 口径约束

- `mr_cover_rate_105 = sum(rsrpgoodcount_105) / sum(rsrpcount)`，主要支撑 FUNC-065 口径。
- `mr_cover_rate_110 = sum(rsrpgoodcount_110) / sum(rsrpcount)`，主要支撑 FUNC-014、FUNC-016 口径。
- `grid_cover_rate_105 = covered_grid_count_105 / mr_grid_count`、`grid_cover_rate_110 = covered_grid_count_110 / mr_grid_count`，即 MR 覆盖率达到 -105/-110 阈值的栅格数除以有 MR 采样点的栅格数（`rsrpcount > 0` 的栅格数）；`grid_count` 表示该范围内的总栅格数，仅作分母参考，不直接用于栅格覆盖率计算。
- 4G/5G_SA 指标拆分优先通过 `network_class='4G'/'5G_SA'` 表达，不新增 `avgrsrp_4g`、`avgrsrp_5g`、`grid_cover_rate_4g`、`grid_cover_rate_5g` 等成对物理字段。
- `RSRP低于-105/-110采样点` 可由 `rsrpcount - rsrpgoodcount_105/110` 派生，不在指标表中重复存储。
- 楼宇无线市场份额不再作为单一核心指标，替换为 `tm_building_coverage_m.user_count_4g`、`user_market_share_4g`、`user_count_5g`、`user_market_share_5g`；楼宇 WiFi 用户与 WiFi 市场份额仍保留在 `tm_building_user_wifi_m`。
- `operator_5g_reside_rate`、`user_market_share_*`、`tm_building_coverage_m.total_user_count` 来自用户统计补充表，不从 OTT 栅格表硬推导；其中 `total_user_count` 直接支撑 `/api/ott/building-report` 楼宇总用户数字段。楼宇侧 5G 驻留比按 CSV 标记不再作为新增核心字段，区域和场景侧继续保留。
- 覆盖扩展字段中的 `mod_interference_*` 为通用 MOD 干扰字段，4G 展示为 MOD3，5G 展示为 MOD30。
- CSV 标记“可废弃”的指标不作为本次新增核心字段；既有字段如 `grid_cover_rate_105/110` 因区域、场景、图层和报表仍使用而保留。
- `cql_filter` 由 Java 服务基于白名单字段拼装；表中提供生成过滤条件所需的基础字段，不存储用户原始输入拼接结果。
- WKT 入库前需做类型、`SRID=4326`、`ST_IsValid` 校验；GeoJSON/BBox 等来源统一先转换为 WKT 再写入，失败记录应返回明确的入库错误。