03 干扰监控端到端实现任务

执行要求：直接完成“干扰监控”真实接口和页面适配，验证后交付。频点和 dBm 聚合口径未确认，必须保留降级，不用前端 mock 补齐。

共同门禁：不执行数据库草案，不修改 V1，不 DROP/清库或插入客户测试数据；g5b2-mysql 仅用于 SHOW、SELECT 和 EXPLAIN。接口统一使用 X-Trace-Id，缺失时后端生成并写响应头；同一动作的前端日志、后端日志、错误响应、备注和审计必须同值。

1. 目标与完成判定

• 菜单：监控分析 / 干扰监控。
• 路由：/interference。
• 完成页面状态、底噪摘要、矩阵、单 CGI 阶梯趋势、全指标同小时性能证据、分页明细和备注。
• HOUR 范围不超过 24 小时时支持小区×小时矩阵；超过 24 小时时必须选择 CGI，展示日期×24 小时。
• 当前上下行频点均按 N/A 展示并隐藏频点筛选、排行和时频图。

2. 开工前必读与现状核对

1. 设置 PowerShell UTF-8，阅读仓库门禁、需求 V2.0、数据库设计第 9.3/10/11/12 节和草案相关表。
2. 阅读 InterferencePage、PublishedChart、PageFeedback、types、api/http/presentation。
3. 阅读现有 interference Controller/Service/Mapper/XML、指标备注写操作和相关测试。
4. 用 rg 查找 interference、MEAN_NOISE_DBM、LinkageEvidence、MetricNote 的全部调用方。
5. 已有 state、summary、matrix、trend、linkage、details、notes 契约；先修现有实现，不创建重复接口。

3. 现有接口基线

能力	当前接口
页面状态	GET /api/v1/interference/state
摘要	GET /api/v1/interference/summary
底噪矩阵	GET /api/v1/interference/matrix
单 CGI 趋势	GET /api/v1/interference/trend
同小时性能证据	GET /api/v1/interference/linkage
分页明细	GET /api/v1/interference/details
备注	GET/POST /api/v1/metrics/{metricResultId}/notes

4. 业务规则与降级

• MEAN_NOISE_DBM 只展示小区小时源值、动态中心/上限及已发布状态；不得在请求或前端计算跨时间/小区 dBm 均值。
• 静态底噪阈值未发布时返回 NOT_CONFIGURED；动态基线不足时返回明确原因，两者不能合并。
• DL_FREQUENCY、UL_FREQUENCY 当前事实值为空且状态为无效零值；页面显示 N/A，不把 0 当合法频点。
• 同小时性能证据必须来自同一 (cgi,businessTime) 的 PUBLISHED 有效点；缺省一次返回全部性能指标，不提供单指标查询条件。关联只称候选证据或同小时关系，不输出相关系数、因果或干扰源位置。
• 单表可用时允许展示单表结果，evidenceCompleteness=PARTIAL；缺一表不能复用旧 COMPLETE 结果。
• “平均底噪排行”不支持。只有已发布的最新小时源值排行才可展示，并必须标明业务时间。
• 无业务有效范围时只验证数值可解析，不用样本 min/max 作为阈值。

5. 后端实施顺序

1. 页面状态：返回 DataState、三个数据时间、发布运行号、发布时间、缺失原因和 traceId。
2. 查询校验：支持公共监控筛选、时间范围和 HOUR；超过 24 小时未传 CGI 返回稳定 400 错误。
3. 摘要：分别返回静态越界 CGI 数、动态越界 CGI 数、各自可用状态、最新底噪时间和可选的最新源值排行。
4. 矩阵：每单元返回 CGI、小区、businessTime、底噪源值/单位、qualityStatus、staticStatus、dynamicStatus、evidenceStatus、N/A 原因和运行号；服务端给稳定顺序。
5. 趋势：限定单 CGI、MEAN_NOISE_DBM 和有界 historyHours，直接返回源值及小时槽基线，不平滑、不补点。
6. 联动：按 CGI+business_time 配对底噪和全部白名单性能指标，返回指标编码、双方状态、缺失原因、运行号和 traceId；不得汇总成相关性结论。
7. 明细：服务端分页、白名单筛选和稳定排序，真实 total；频点字段保留 N/A 状态和原因。
8. 备注：复用已发布指标备注契约，幂等追加备注和审计。

6. 数据追溯

能力	主要来源
底噪源值/质量	tb_metric_publish_result、tb_metric_definition
频点 N/A 原因	干扰事实质量快照和发布结果；原始值只留受控原始区
静态/动态状态	tb_metric_evaluation_result、tb_baseline_result
同小时性能配对	两类 tb_metric_publish_result 按 CGI+business_time
明细维度	已发布结果关联的干扰事实快照，不得无发布回退
告警和备注	tb_alarm、tb_metric_note
版本/运行	tb_publish_run、阈值与分析配置版本

7. 前端适配

• 时间、小区筛选及分页、排序真实进入请求；矩阵、趋势、联动和明细共享已应用条件，性能联动不设置单指标筛选。
• 热力图仅把后端单元映射到坐标和颜色，不计算阈值或状态；N/A 单元明确留空。
• 超过 24 小时时未选 CGI，前端可提前提示，但以后端 400 校验为准。
• 频点筛选和频点图隐藏，页面说明“频点数据未有效提供”，不得显示 0。
• 一个 ECharts 画布使用 3×3 分面散点展示全部性能指标，各分面保留原始单位，只用后端配对点并固定显示“候选证据，非确认根因”。
• 性能页/干扰页跳转只继承共享 URL 参数；点击联动点时才把该点的 metricCode 传给性能页。
• 备注和错误态显示服务端 traceId。

8. 最小验证门禁

1. 后端测试覆盖：空库、频点 N/A、24 小时边界、单 CGI 趋势、同键配对、部分证据、分页稳定性和备注幂等。
2. 只读 EXPLAIN：底噪趋势、矩阵、配对证据和明细分页；记录真实索引选择。
3. 真实 HTTP：成功、NO_DATA、超 24 小时缺 CGI、非法时间、备注重复；核对整条 traceId。
4. 运行相关 Maven 测试、Mapper XML 检查和注解 SQL 禁止扫描。
5. 运行 cd frontend; npm run build，并验证热力图空点、频点隐藏、全指标分面散点、同小时证据和跨页参数。

9. 交付报告

列出修改文件、接口与字段追溯、测试和构建实际结果。明确频点分析、dBm 平均排行、相关性/根因结论仍未实现及原因。