需求建设详细方案V2.0.md

document

2026年8月6日阅读约 9 分钟1,753 字

更新于 2026年8月6日

中国移动 5G 专网智能运维与故障诊断系统需求建设详细方案 V2.0

| 文档属性 | 内容 |
|---|---|---|
| 版本 | V2.1（监控分析增强版，ECharts 图表重构版） |
| 修订日期 | 2026-07-17 |
| 适用阶段 | 产品确认、研发设计、接口设计、测试验收 |
| 数据依据 | 表头样例：性能表数据样例.csv、干扰表数据样例.csv；完整时序校验：性能表_0608.csv、干扰表_0609.csv |
| 核心目标 | 基于持续交付的小时级无线性能与干扰数据，形成监控发现、证据分析、动态基线、48 小时趋势预测、告警和候选诊断闭环；通过 ECharts 多类型图表组合提升运维人员快速定位问题的效率 |

1. 范围与原则

1.1 本期目标

本期建设“无线性能与干扰风险监控”能力，让运维人员能够回答：

指定区域、基站或小区在某个小时有哪些性能或底噪指标需要优先核查。
指标变化是偶发、持续还是在固定小时重复出现，并与静态阈值、动态基线有何差异。
性能异常是否同时具备干扰、负荷、流量或切换劣化证据。
性能与干扰数据是否已到达、能否按同一 (cgi, datatime) 形成完整证据。
告警由谁认领、如何处置、是否已验证。

系统只读取后端发布结果。浏览器不处理 CSV、不计算业务规则、不直接下发网元参数。

1.2 数据边界与图表设计约束

当前可用输入均为按小区、按小时的外部 CSV：

数据集	可用核心字段
性能表	`datatime`、区域/场景、`cgi`、小区信息、无线接通率、无线掉线率、RRC 连接建立成功率、RRC 连接最大数、上/下行业务信息 PRB 占用率、切换成功率、上/下行 PDCP PDU 字节数
干扰表	`datatime`、区域/场景、`cgi`、小区信息、下/上行频点、平均底噪

两个数据集以 (cgi, datatime) 关联。记录缺失或指标为空统一展示为 N/A，不得补零或自动判为正常。

基于校验数据（性能表_0608.csv、干扰表_0609.csv）确认的图表设计约束：

数据现象	对图表的影响
上/下行频点 44,092 条记录均为 `0`	频点排行柱状图、频点×时段热力图、频点分类散点图不可用；干扰监控主分析图改为"小区×时段底噪矩阵热力图"，无法展示频点维度
上/下行 PRB 各有 2,630 条空值	负荷与流量趋势中，PRB 空值时间点标注为 `N/A`，不参与堆叠面积图计算，堆叠图中该时段留白
32 条切换成功率大于 `1`，最大值为 `2`	切换成功率在散点关联图中以异常数据质量标记，不参与基线判断
接通率 64.00% 的记录为 `1`，掉线率 78.47% 的记录为 `0`	全局均值仪表盘不适用（均值无分母），改用小区级状态分布展示
平均底噪范围 -117~-96 dBm，振幅约 20dB	底噪热力图颜色映射可有效区分，散点关联图（底噪 vs 掉线率）可检验干扰-性能相关性
平均底噪在非忙时趋于稳定（-117dBm），忙时抬升（-114~-96dBm）	忙时底噪抬升可通过阶梯折线图清晰展示，适合用于干扰模式识别

本文"静态阈值"统一指已发布的静态合同阈值；"动态基线"指按第 5.1 节规则发布的小时槽基线。两类证据必须分别保存、展示和计数。### 1.3 明确不在本期建设

管道层指标、业务层指标、业务体验、链路时延、抖动、链路可用性及其实体关系。
15 分钟粒度；当前输入为小时数据，日/月仅由服务端基于连续小时数据汇总。
数字孪生、地图、空间拓扑、厂区平面图和 GIS 能力。
Auto ARIMA、线性回归、RNN、LSTM 及并行多模型发布。
自动根因确认、自动优化、参数下发、重启和其他网元操作。
PDF 报告、客户主数据、客户-小区映射、浏览器上传 CSV。

这些能力不以“预留页面”或模拟数据形式交付，避免误认为当前已有数据与算法支撑。

2. 数据质量与可用性

2.1 当前数据校验结论

性能表数据样例.csv 和干扰表数据样例.csv 仅用于说明固定表头和字段映射。性能表_0608.csv 和干扰表_0609.csv 用于验证长周期数据形态、关联能力和监控分析方案，不代表生产固定规模。

校验项	性能表	干扰表
数据时间范围	2026-03-01 00:00 至 2026-06-08 15:00	2026-03-01 00:00 至 2026-06-08 23:00
记录数	47,352	44,092
小区数	20	20
已出现小时点数	2,373	2,211
`(cgi, datatime)` 重复数	0	0
全部小区均缺失的自然小时数	19	189
按文件时间范围粗算的行覆盖	98.98%	91.86%

两表共有 43,780 个 (cgi, datatime) 可关联，占性能记录 92.46%、干扰记录 99.29%；20 个小区的区域、厂家、NCI、小区名、基站名、场景、制式、频段和带宽字段在关联记录中一致。上述覆盖仅用于本次数据校验，不作为生产完整率、SLA 或验收结论。

当前数据同时确认以下产品约束：

数据现象	产品处理
性能最新时间为 2026-06-08 15:00，干扰最新时间为 2026-06-08 23:00	页面分别展示性能最新时间、干扰最新时间和最新共同证据时间，不以单一“最新时间”掩盖数据未对齐
当前校验文件的上、下行频点 44,092 条记录均为 `0`	在频点业务口径确认前按 `N/A` 降级，不展示频点排行或时频分析；生产数据是否有效以已发布数据字典为准
上、下行 PRB 各有 2,630 条空值	展示为 `N/A`；该时间点不形成需要 PRB 的负荷候选证据
32 条切换成功率大于 `1`，最大值为 `2`	标记为数据质量异常，不截断为 100%，待口径确认前不进入发布、基线、告警和诊断计算
接通率 64.00% 的记录为 `1`，掉线率 78.47% 的记录为 `0`，切换成功率 51.73% 的记录为 `1`	监控页以异常状态、时间模式和明细证据为主，不以全局均值卡片或普通分布图作为核心结论
部分小区的底噪小时槽中位数差异达到约 4.37	底噪必须按小区和小时槽使用动态基线，不能用全网统一平均值判断

生产验收仍以持续交付的完整小时数据为准：动态基线不满足启动条件时显示“基线数据不足”；预测不满足发布条件时只显示已发布基线，不得伪造预测结果。

2.2 导入与发布规则

后端从受控内网目录定时扫描性能表和干扰表，不提供浏览器上传。
每个文件记录文件哈希、导入批次、模板版本、总行数、成功行数、失败行数和失败原因。
性能数据按 (cgi, datatime) 去重；干扰数据按 (cgi, datatime) 去重。重复记录不得覆盖已成功导入的原值。
导入时按已发布数据字典校验字段类型、单位、允许范围和缺失规则。无效值可在受控原始区留痕，但不得静默截断、补零或进入发布结果。
只有性能和干扰记录均已完成校验的时间点，才参与关联诊断；单表可单独展示，但不产生跨表候选原因。
前端只能查询发布结果、导入批次状态、阈值版本、告警和审计记录，不查询原始导入表。
小时数据连续交付后，服务端按小时形成日、月聚合；不得由前端补点、插值或计算聚合结果。

2.3 数据完整性

完整率以已确认的小时应收计划计算。计划尚未确认前，页面仅展示“已收到记录数”“缺失字段数”“无法关联记录数”和三个最新数据时间，不得发布完整率结论或 SLA 结论。

监控分析页面由后端分别发布三个状态轴，不将可能同时发生的状态压缩成一个枚举：

可用性：可用 / 离线。离线表示无法取得当前发布状态，页面保留最后一次成功结果并明确标记，不显示为实时数据。
时效性：当前 / 延迟 / 未知。只有小时应收计划已确认时才能判断当前或延迟；计划未确认时固定为未知，不得借此发布 SLA 结论。
证据完整性：完整 / 部分数据 / 无数据。部分数据表示性能或干扰单表可用，但共同证据缺失；允许单表查看，不输出跨表诊断。无数据表示请求成功但当前查询范围内性能和干扰均无发布记录，页面显示空状态，不复用旧结果冒充当前结果。

请求成功/失败是独立的接口结果，不属于上述数据状态。请求失败时展示错误和 traceId，并保留上一次成功取得的三个状态轴及其更新时间。

3. 功能结构

工作台
└─ 无线运行总览

监控分析
├─ 无线性能分析
│  ├─ 异常态势
│  ├─ 趋势与周期
│  ├─ 负荷与流量
│  └─ 数据明细
└─ 干扰监控
   ├─ 干扰态势
   ├─ 周期分析
   ├─ 性能联动
   └─ 证据明细

智能研判
├─ 预测风险分析
├─ 动态基线追溯
└─ 模型运行与回测（仅 ROLE_ADMIN）

告警处置
└─ 告警中心
   ├─ 告警列表
   └─ 告警详情与候选诊断

运维管理（仅 ROLE_ADMIN）
├─ 调度监控
├─ 阈值与告警策略
└─ 基线与预测配置

系统管理（仅 ROLE_ADMIN）
└─ 操作审计

4. 页面需求

页面	核心展示	主要操作	数据来源
无线运行总览	当前运行状态、异常小区范围、持续异常 TOP、KPI 状态分布、重点小区状态热力图、未来风险和未闭环告警、数据更新时间	按区域、场景、小区、时间查询；从图表下钻性能分析/告警	已发布性能洞察、指标评估、预测风险、告警、数据状态
无线性能分析	小区-KPI 异常矩阵、日期-小时状态、实际值与基线、负荷/流量联动、同小时底噪证据和数据明细	查询、切换视图、选择小区/时间点、多小区对比、查看同时段底噪、查看告警、添加备注；单小区分析不设置核心 KPI 查询条件	性能发布结果、基线结果、干扰关联摘要、告警
干扰监控	小区-时间干扰矩阵、底噪小时槽周期、实际值与动态中心/上限、同小时性能证据和数据完整性	查询、切换视图、选择小区/时间点、小区对比、查看同时段性能、查看告警、添加备注	干扰发布结果、基线结果、性能关联摘要、告警
预测风险分析	选中小区核心 KPI 的历史实际值、动态基线、未来完整 48 小时预测、逐点越界状态、连续越界进程、风险摘要及模型版本	查询条件仅保留时间窗口、小区和核心 KPI；核心 KPI 只允许无线接通率、无线掉线率；点击预测点查看证据和预测告警	预测发布结果、风险汇总结果、基线结果、告警
动态基线追溯	小时槽样本量、健康样本日期、被排除的告警样本、中心值、尺度、上下限、参数版本、基线状态	选择小区/指标/小时槽；指标仅限无线接通率、无线掉线率、RRC 连接建立成功率和切换成功率；查看样本与版本	基线结果、告警、配置版本
模型运行与回测	训练数据截止、完整率、模型类型、特征覆盖、验证状态、MAE/RMSE/WAPE、最近运行结果、发布版本	查看运行、查看回测、发布/停用模型版本	模型运行、验证与预测发布结果
告警中心	告警号、类型、级别、小区、触发指标、阈值、触发时间、责任人、状态	查询、认领、标记已读、查看详情、提交核查、提交处置、申请关闭	告警及动作记录
告警详情与候选诊断	告警证据、实际/基线/预测对比、性能/底噪同小时数据、候选原因、缺失证据、工单建议、处置时间线	认领、提交核查、关联工单、提交处置/验证	发布指标、基线、预测、阈值版本、告警动作
调度监控	性能/干扰导入任务、结果发布任务、当前实例、执行历史、失败原因摘要	刷新、启用、停用、手动执行、停止执行、查看日志	调度任务与实例
阈值与告警策略	指标、劣化方向、阈值、作用范围、告警级别、去重窗口、生效期、版本与状态	只读查看当前固化发布版，按需查看历史版本	配置版本
基线与预测配置	当前启用版的完整动态基线指标、`k`、`floor`、历史窗口、最小有效日、训练最小天数、完整率要求、预测周期、模型状态	默认只读查看固化启用配置，按需查看历史版本和运行状态	配置版本、模型运行记录
操作审计	操作人、时间、对象、动作、结果、请求号、traceId	查询、查看详情、导出	审计日志

4.0 无线运行总览（图表化首屏与异步加载）

总览首屏服务于值班人员的四个判断：当前是否异常、影响多少小区、哪些小区最严重且是否持续、是否存在未来风险或未闭环告警。页面只展示后端已经发布的结果，不在浏览器计算平均值、SLA、综合健康分、预测或诊断结论。

首屏布局

[区域/小区/时间范围] [24小时 | 7天] [数据状态] [更新时间]
[监测小区] [当前异常小区] [未来风险小区] [未闭环告警] [最新业务时间]
[异常小区数趋势................................................]
[持续异常小区 TOP10]              [KPI 状态分布]
[重点小区状态热力图.............................................]
[预测风险/数据可信度/下钻入口]

首屏以折线图、横向条形图、环形状态图和小区×时间热力图为主，不用表格承载主结论。明细表、导入批次和 N/A 原因仅在用户进入“数据可信度/明细”后按需展开。

核心 KPI 固定为无线接通率、无线掉线率、切换成功率、RRC 建立成功率、RRC 连接最大数、上下行 PRB 占用率、上下行 PDCP 字节数和平均底噪。缺少已确认口径的跨小区平均比例、SLA 达成率、雷达归一化、dBm 平均排行、RRC 连接总数不展示。

请求与渲染契约

页面骨架、筛选区和各图表容器先渲染；任何单个接口不得作为整页 loading gate。
当前快照、性能趋势/持续异常、预测风险和告警/数据可信度分别请求；每个面板有独立 loading、空数据、部分数据、403 和错误状态，并保留已成功面板。
/api/v1/dashboard/summary 只返回最新业务小时的轻量快照和数据状态；历史趋势使用 /api/v1/performance/overview?historyHours=24|168，查询必须有明确时间上界。默认不返回导入批次、N/A 原因和基线明细等重列表。
请求和响应统一携带 X-Trace-Id。面板错误显示服务端 traceId 和可重试入口，不输出 SQL、堆栈或敏感信息。
目标：快照接口 P95 不超过 800ms；首屏骨架与筛选可用不超过 300ms，首个可用图表不超过 2s；慢接口只延迟自身面板。

响应式与数据状态

桌面端以“状态条 + 主趋势 + 两列分析 + 热力图”扫描；手机端先显示状态条、趋势和持续异常 TOP，再折叠筛选与次要证据。图表保留最近一次成功结果并标记“数据延迟/部分数据/离线”，不因重连或某一请求失败清空其他证据。颜色必须同时配合文字状态，关键数值不能只放在悬浮提示中。

预测风险分析采用与无线性能分析一致的“筛选与状态 -> 预测主图 -> 风险证据 -> 逐点处置”业务路径，并以预测为页面主体：

查询条件只保留时间窗口、小区和核心 KPI。时间窗口仅提供“最近 24 小时”和“最近 7 天”，用于控制主图左侧历史实际值；小区必选；核心 KPI 只允许无线接通率和无线掉线率。
未来预测窗口固定为 48 小时，不随历史时间窗口变化。页面必须展示后端实际发布点数 x/48；少于 48 点时明确提示“48 小时预测数据不完整”，不得补点、插值或复用旧预测。
第一主图固定为历史实际值、动态中心/上下限和未来 48 小时预测组合折线图，并明确标识未来预测区间。顶部状态条展示最新实际值、预测点覆盖、已发布风险等级、最早预计劣化时间及模型验证状态。
辅助图固定为 48 小时越界状态热力带、预测风险事件散点时间轴和连续越界进程柱状图；点击任一预测点打开证据抽屉，展示阈值、基线、连续点、模型/特征版本、发布运行和 traceId，并可进入预测告警。
页面不设置“风险态势/单小区趋势”切换，不展示全网指标分布或风险排行，也不以表格承载预测业务。风险等级、预计劣化时间和连续越界点均直接读取后端已发布结果，前端不得比较阈值、累计连续点或形成新风险结论。

所有趋势图、矩阵、表格、分页和排序必须继承当前页面的同一组查询条件。区域、场景、厂家、基站、小区、时间范围和选中时间点是两个监控页面的共享 URL 参数；指标和页内视图是页面私有参数。刷新或返回当前页面时恢复全部参数，跨页跳转只继承共享参数，不把源页面的指标或视图枚举传给目标页面。

从无线性能分析跳转干扰监控时默认进入“干扰态势”；从干扰监控的性能联动点跳转时进入无线性能分析，并按该点携带的性能指标编码定位或高亮对应指标，不将其作为单小区查询条件。

4.1 监控分析通用框架

公共筛选支持区域、一级/二级场景、厂家、基站、小区、频段、带宽和时间范围；只有一个有效值的低价值维度默认收起。频点仅在数据符合已发布数据字典且业务口径已确认时出现。
查询粒度参数为 HOUR、DAY、MONTH，默认 HOUR；DAY、MONTH 只有在服务端已发布对应聚合时才可选择。日期-小时矩阵只用于 HOUR，其他粒度展示服务端聚合趋势和明细。监控数据采用小时级周期查询，不为制造“实时感”默认接入 WebSocket。
干扰态势的时间矩阵在 HOUR 查询范围不超过 24 小时时按“小区 × 小时”展示；超过 24 小时时要求先选一个小区，再按“日期 × 24 小时”展示。无线性能“异常态势”始终为“小区 × KPI”矩阵，不适用该时间矩阵切换规则；其“趋势与周期”在选定小区和指标后展示“日期 × 24 小时”矩阵。
页面顶部固定展示性能最新时间、干扰最新时间、最新共同证据时间、性能/干扰各自的已收到记录数和缺失字段数、无法关联记录数、基线状态和关联告警数。
页面结构固定为“筛选与数据状态 -> 主分析视图 -> 选中对象证据 -> 明细与操作”，不将所有图表做成等权卡片陈列。
矩阵、排行、异常小时数、历史同期值、日/月聚合和关联证据均由服务端计算并发布；前端只负责筛选、联动和展示。
选中矩…2982 tokens truncated…本数的描述性对比。

同一小时底噪与性能指标同时变化只能作为候选证据，不得表述为因果关系或已确认干扰根因。
选择底噪时间点时提供"查看同时段性能"，跳转无线性能分析并继承小区、时间范围和选中时间点。
热力图单元格点击 → 阶梯折线图切换至该小区时序 + 柱状图高亮该小区；散点图点击异常点 → 弹出关联小区列表（可跳转至无线性能分析页），联动逻辑由前端驱动。

4.4 服务端输出、降级与可访问性

监控查询响应至少携带 traceId、发布运行号、可用性状态、时效性状态、证据完整性状态、最新发布时间、源值、源单位和 N/A 原因；需要判断的指标同时返回静态阈值、动态中心/上下限及各自状态。
服务端分别提供页面状态、矩阵/排行、趋势/周期、同小时关联证据和分页明细；不得要求前端下载全量记录后自行聚合。
证据为部分数据时以当前可用的单表发布结果为主；旧的完整证据只能作为独立的“最后完整证据”展示并标明原查询快照和时间，不得替代当前单表结果。证据为无数据时显示当前查询空状态，不显示旧结果。
可用性为离线、时效性为延迟或查询失败时可保留最后一次成功发布结果，并在结果上方分别显示三个状态轴、更新时间和可复制 traceId；最后成功结果必须绑定其原始查询快照，新查询条件失败时不得将旧结果显示在新条件下，旧结果也不得伪装为实时数据。
关键值、状态和阈值不依赖悬浮提示；状态同时使用文字和颜色。移动端将宽矩阵降级为异常优先列表，通过筛选抽屉和详情抽屉保留同一分析路径。
所有 N/A 保持缺失语义，不参与补点、插值、均值或异常判断。服务端返回稳定排序键、顺序和 N/A 排位；前端只提交排序条件并展示服务端结果。

5. 告警与候选诊断

5.1 动态基线

动态基线使用 Median/MAD，不使用固定的全网统一底噪值。按 (cgi, metric_code, hour_of_day) 汇总近 30 个自然日的健康有效小时样本：

center = median(x)
scale = max(1.4826 * MAD(x), floor)

规则	要求
启动条件	至少 14 个健康有效日；数据完整率满足已发布要求；告警时间片不进入健康样本
低值劣化指标	无线接通率、切换成功率、RRC 连接建立成功率的动态下限为 `max(0, center - k * scale)`
高值劣化指标	无线掉线率、平均底噪、RRC 连接最大数、上/下行 PRB 占用率、上/下行 PDCP PDU 字节数的动态上限为 `center + k * scale`
样本不足	不生成或复用新基线，页面显示“基线数据不足”；不因缺少基线自动判定正常或异常
结果留痕	保存中心值、尺度、上下限、样本数、有效日期范围、参数版本、计算时间和发布运行号

k 和 floor 在首次上线时按版本发布。每个版本必须完整包含当前生产矩阵的十项指标；不能发布仅含预测 KPI 的局部版本，否则会导致其余动态基线配置被整版替代。首次生产版发布后配置域永久锁定，应用接口、页面、调度和脚本只读，后续变更只能经负责人批准后使用带审计和 X-Trace-Id 的手工 SQL 创建新版本。有结果引用的历史版本继续保留追溯。配置版本的创建、校验、发布时间和同链路审计时间统一使用应用 Asia/Shanghai 时钟，数据库连接固定 +08:00，不得在同一生命周期混用数据库 CURRENT_TIMESTAMP。静态合同阈值与动态基线越界必须分别标识，不能混为同一告警证据。

5.1.1 生产启用配置

当前生产启用版统一使用：historyWindowDays=30、minTrainingDays=30、minCompletenessRate=0.95、forecastHorizonHours=48、riskLookaheadHours=12、warningConsecutivePoints=2、highRiskConsecutivePoints=4、primaryModelType=XGBOOST、fallbackModelType=HOLT_WINTERS。训练参数固定为候选刷新 24h、离线验证 168h、树深 4、学习率 0.05、行/列采样率 0.8、最小子节点权重 5、最大轮数 300、早停 30、Holt-Winters 季节周期 24h 并启用阻尼趋势。

下表数值均为数据库存储单位，WAPE 使用比例值；十项配置必须位于同一个启用版本：

指标编码	动态方向	k	floor	最小有效日	MAE 上限	RMSE 上限	WAPE 上限
`HANDOVER_SUCCESS_RATE`	LOW	3	0.003	14	0.0087166585	0.0255039558	0.0087775645
`MEAN_NOISE_DBM`	HIGH	3	0	14	0.9291622768	2.2516559464	0.0079947593
`PDCP_DL_BYTES`	HIGH	3	0	14	534773.7654053480	1172014.0470620925	0.3555818894
`PDCP_UL_BYTES`	HIGH	3	0	14	761498.6124863969	1677571.7265469353	0.5321733280
`PRB_DL_USAGE_RATE`	HIGH	3	0.003	14	0.0054490440	0.0096011808	0.3487552312
`PRB_UL_USAGE_RATE`	HIGH	3	0.003	14	0.0447775278	0.0897051538	0.5752517943
`RRC_CONNECTION_MAX`	HIGH	3	0	14	4.0260416667	6.7582511298	0.1738250506
`RRC_SETUP_SUCCESS_RATE`	LOW	3	0.003	14	0.0103950115	0.0177432682	0.0104884654
`WIRELESS_ACCESS_RATE`	LOW	3	0.0025	21	0.00258	0.015	0.003
`WIRELESS_DROP_RATE`	HIGH	3	0.001	21	0.0008	0.004	1.8

5.2 48 小时趋势预测

预测以无线接通率、无线掉线率两个核心 KPI 的 (cgi, metric_code) 小时序列为目标运行，不为其余配置指标单独生成预测。当前可用特征为小时、星期、1/2/24/168 小时滞后值、RRC 连接最大数、上下行 PRB 占用率、上下行 PDCP PDU 字节数和已发布动态基线。

规则	要求
主模型	`XGBoost`，用于捕捉多变量、非线性和日/周周期特征
兜底模型	`Holt-Winters`，仅在 XGBoost 因数据或验证不满足发布条件时使用
训练与发布	至少 30 天连续历史数据，近 30 天完整率不低于 95%，离线验证通过后才能发布未来 48 小时结果
单一结果	同一 `(cgi, metric_code, target_time, publish_run)` 只发布一个 `model_type` 的预测结果；候选模型不得各自发告警
预测告警	已发布预测在未来 12 小时内连续两个点跨越已发布动态基线时，生成预测性告警并附预计劣化时间与核查窗口
降级	基线不足时显示“基线数据不足”；基线可用但预测不可用时只显示实际值和基线，明确显示“预测数据不足”或“模型验证未通过”

5.2.1 预测结果与风险排序

每个已发布预测点必须保存：实际历史截止时间、目标时间、预测值、关联基线上下限、是否越界、连续越界点数、预计劣化时间、model_type、模型版本、特征版本、验证状态和发布运行号。

预测风险分析使用小区和核心 KPI 对应的已发布风险摘要作为预测主图的辅助证据，不重新计算模型结果。风险级别由配置决定，最小规则如下：

风险状态	触发条件	页面呈现
正常	预测窗口内未跨越动态基线	显示最后预测时间和模型状态
关注	未来 12 小时连续 2 个预测点跨越动态基线	黄色预测性告警、预计劣化时间、核查窗口
高风险	连续越界点数达到配置的升级阈值，或预测同时跨越动态基线和静态合同阈值	红色风险标识、关联告警、优先处置排序
不可用	基线不足、训练数据不足或模型验证未通过	明确不可用原因，不生成风险等级或告警

风险排行按严重度、预计劣化时间、连续越界点数和影响指标数排序。系统不得输出未经计算的“置信度百分比”；仅展示已保存的验证状态、回测误差和数据完整率。

5.2.2 模型运行、回测与发布

阶段	规则	可见结果
特征检查	校验小时/星期、滞后值、RRC、PRB、PDCP 流量和基线特征是否齐全	特征覆盖率、缺失字段、可训练/不可训练原因
训练	以训练截止时间之前的数据训练候选模型，不覆盖已发布版本	模型类型、训练范围、训练截止时间、模型版本
回测	使用训练后已到达实际值的时间片计算 `MAE`、`RMSE`、`WAPE`；分母为 0 时 WAPE 标记 `N/A`	指标误差、样本数、验证状态、失败原因
发布	只有通过当前指标配置的验证阈值的候选模型可发布；同一对象/指标仅一个生效版本	发布运行号、生效模型、发布时间、回滚目标
回滚	运行失败、验证失效或管理员停用时，停止新预测发布，保留上一个已发布版本和审计记录	当前状态、原因、最后成功版本

模型配置的验证阈值、升级阈值、最小训练天数和完整率要求均版本化。生产首次发布后管理员只读查看配置，普通用户只读模型状态和预测结果；后续配置变更仅允许经审批的手工 SQL。

5.3 阈值与基线告警

阈值在首次上线时以版本方式发布，生产发布后配置域永久锁定，应用接口、页面、调度和脚本只读。JOB_RULE_ALARM 创建 tb_publish_run 时必须原子固化当时的 threshold_version_id，本次运行的评估、告警和证据 SQL 只能按该快照读取规则，不得在执行中重新查询当前 PUBLISHED 阈值版；至少支持：

指标	劣化方向	用途
无线接通率	低于阈值	接通质量告警
无线掉线率	高于阈值	掉线质量告警
切换成功率	低于阈值	切换质量告警
RRC 连接最大数	高于阈值	负荷风险证据
上/下行 PRB 占用率	高于阈值	负荷风险证据
平均底噪	高于阈值	干扰风险证据

没有已发布静态阈值的指标只展示原始趋势；基线已发布时仍可生成“趋势异常”。没有静态阈值且基线数据不足时不生成告警。

5.4 可解释候选诊断规则

规则	条件	输出
干扰风险候选	接通率或掉线率发生静态阈值或动态基线越界，且同一 `(cgi, datatime)` 的平均底噪越过静态阈值或动态上限	“上行噪声或干扰风险待核验”，展示指标值、阈值/基线和样本状态
负荷/容量风险候选	RRC 连接最大数及上、下行 PRB 占用率在同一时间片均超过静态阈值或动态上限	“负荷/容量风险待核验”，展示 RRC、PRB、流量和阈值/基线证据
切换性能异常候选	切换成功率低于静态阈值或动态下限	“切换性能异常待核验”，展示当前值和阈值/基线
预测风险候选	已发布预测在未来 12 小时连续两个点越过动态基线	“性能劣化风险待核验”，展示预计劣化时间、预测值、基线和核查窗口
证据不足	关联记录缺失、字段为空或仅一个证据满足	“待观察或人工补充证据”，不得输出具体根因

规则输出只能是候选原因和核查建议，不得显示为“已确认根因”。所有参数调整类建议必须标记“需审批”，系统不提供下发入口。

5.5 告警生命周期

状态固定为：新建 -> 已认领 -> 处理中 -> 待验证 -> 已关闭。验证失败可回到处理中；同一对象、指标、告警类型在生效去重窗口内合并。预测性告警在实际值到达后追加“预测命中/未命中”验证记录，不因预测窗口结束自动关闭。只有管理员可执行最终关闭和重开。

6. 调度、权限与审计

6.1 预置任务

顺序	任务编码	任务名称	成功输出
1	`JOB_IMPORT_PERF`	性能 CSV 定时导入	性能原始记录、导入批次
2	`JOB_IMPORT_INTERFERENCE`	干扰 CSV 定时导入	干扰原始记录、导入批次
3	`JOB_METRIC_PUBLISH`	无线指标结果发布	前端可读性能/干扰关联结果
4	`JOB_BASELINE`	动态基线计算	已发布基线或“样本不足”运行结果
5	`JOB_PREDICTION`	48 小时趋势预测	已发布预测或“预测数据不足/验证未通过”运行结果
6	`JOB_FORECAST_EVALUATION`	预测回测与模型状态更新	回测误差、验证状态、模型运行记录
7	`JOB_RULE_ALARM`	阈值/趋势异常/预测性告警与候选诊断	告警、诊断快照、通知任务

下游任务仅消费上游成功且已发布的运行号。任务失败、停止或未发布时，不产生半成品告警。

6.2 角色

能力	ROLE_USER	ROLE_ADMIN
查询性能、干扰、告警和诊断	是	是
查询基线和预测	是	是
认领、处置、提交验证、申请关闭	是	是
最终关闭/重开告警	否	是
调度启停、手动执行、停止	否	是
阈值与告警策略发布	否	否（生产固化，变更走审批 SQL）
基线配置发布	否	否（生产固化，变更走审批 SQL）
模型发布与回滚	否	是
审计查询与导出	否	是

前端菜单可见性不构成权限控制，所有接口由后端校验角色、对象状态和版本。

6.3 Trace 与中文日志

每个 HTTP 请求携带 X-Trace-Id。同一用户操作链在前端日志、后端日志、错误响应、调度实例和审计 request_id 中使用同一个值。

新增或变更接口必须有中文日志和中文说明，说明业务目的、触发条件、处理原因和结果；不得只记录“成功”或“失败”。日志和响应不得包含密码、token、密钥、完整 CSV 内容、SQL 或内部堆栈。

7. 验收标准

验收项	最小通过标准
CSV 导入	性能和干扰表头样例及完整时序校验文件可分别导入；字段缺失、重复记录和错误时间格式被拒绝并记录原因
数据语义校验	比例越界、无效频点及其他违反已发布数据字典的值可在受控原始区留痕，但不得被截断、补零或进入发布、基线、告警和诊断结果
数据关联	同一 `cgi + datatime` 的性能、干扰数据可关联；只有单表结果时仍可查看源指标，但页面明确提示关联证据不足且不产生跨表候选原因
数据状态	页面分别展示性能最新时间、干扰最新时间、最新共同证据时间、性能/干扰各自的收到记录数和缺失字段数、无法关联记录数；可用性、时效性、证据完整性三个状态轴与后端发布状态一致，未确认应收计划时时效性只能为未知；无数据时不显示旧结果
无线性能态势	能按基站/小区和 KPI 展示最新值，并分别展示静态阈值状态/越界小时数和动态基线状态/越界小时数；选择矩阵单元格后趋势、证据和明细同步到同一对象、指标和时间
性能趋势与周期	日期-小时矩阵、实际值、静态阈值、动态基线及前一小时/前一天同小时/前一周同小时值均与服务端发布结果一致，前端不自行计算结论
负荷与流量联动	质量 KPI、RRC/PRB 和 PDCP 使用共享时间轴分别展示；任一 PRB 为 `N/A` 时不输出完整负荷候选证据
干扰态势与周期	能展示小区-小时或日期-小时状态矩阵、24 小时动态中心/上限、实际底噪、样本数和数据不足状态；不使用全网统一底噪均值替代小区小时槽基线
性能/干扰联动	性能和底噪页面可按同一 `cgi + datatime` 双向跳转并恢复共享 URL 参数；性能跳转后默认进入干扰态势，干扰页点击分面散点后按该点性能指标进入无线性能分析；关联数据缺失时显示证据不足，不输出因果或已确认根因
查询粒度与矩阵	`HOUR`、`DAY`、`MONTH` 选项与服务端已发布粒度一致；干扰态势的 `HOUR` 范围不超过 24 小时时展示小区-小时矩阵，超过 24 小时时要求选择小区并展示日期-小时矩阵；性能异常态势保持小区-KPI 矩阵
频点降级	当前校验文件的频点 `0` 在口径确认前展示 `N/A` 并隐藏频点筛选、排行和时频图；生产频点是否有效以已发布数据字典为准
指标展示	三项无线 KPI、RRC 连接建立成功率、RRC 连接最大数、PRB、PDCP PDU 字节数、平均底噪和有效频点按源值、源单位、小时粒度展示；空值为 `N/A`
页面降级与可访问性	部分数据时当前单表结果优先，旧完整证据独立标记；无数据时只显示当前空状态；离线、延迟或查询失败时保留的最后成功结果绑定原查询快照，新条件失败时不得显示旧条件结果；状态同时使用文字和颜色，移动端可通过异常列表完成同一分析路径
动态基线	少于 14 个健康有效日时显示“基线数据不足”；满足条件的验收数据按 Median/MAD 公式生成中心、尺度和上下限
趋势预测	少于 30 天或完整率低于 95% 时不发布预测；满足条件的验收数据由 XGBoost 或验证通过的 Holt-Winters 发布未来 48 小时结果，且同一目标时间仅一个模型结果
风险驾驶舱	风险排行、预计劣化时间、连续越界点数和预测告警与同一发布运行号的预测结果一致；不可用模型明确呈现原因
模型回测与治理	能查询特征覆盖、训练范围、MAE/RMSE/WAPE、验证状态和发布版本；验证失败不发布，回滚后保留历史与审计
阈值/趋势异常	有效静态阈值或已发布基线按正确方向触发相应告警；无静态阈值且基线不足时不发告警
候选诊断	干扰、负荷、切换和证据不足四类规则输出正确证据与候选文案，不自动确认根因
告警闭环	认领、处置、验证、关闭/重开操作按角色和状态校验，并保留动作历史
调度与发布	上游失败时下游跳过；前端只看到最后成功的发布结果
生产配置固化	阈值与告警策略、基线与预测配置首次发布后，页面和接口均只读；ALARM 发布运行的 `threshold_version_id` 非空且评估 SQL 只按该快照读规则；十项分析参数与第 5.1.1 节矩阵完全一致；配置生命周期与审计使用同一应用时钟
Trace 与审计	一次接口请求能以同一 `X-Trace-Id` 串联前端日志、响应、后端日志和审计记录

8. 后续能力的启用条件

以下不是本期需求。只有满足条件后，才另行评审并形成新版本需求：

能力	必要前提
15 分钟分析	外部稳定交付 15 分钟数据，并定义迟到数据与聚合规则
频点分析	上、下行频点稳定提供符合已发布数据字典的有效值，数据字典明确平均底噪对应的频点方向、单位和关联口径
管道/业务分析	提供实体标识、指标目录、单位、时延/体验字段及与小区的关联关系
数字孪生	定义实体关系、状态口径和展示目标；若需要空间视图，还需坐标或离线平面图
月度报告	连续完整的跨月数据、报告统计口径、权限范围和签发模板

本版本不以样例数据不足为由伪造算法结果或预测告警。后续能力启用后，必须重新补充数据契约、接口、验收用例和页面需求。