中国移动 5G 专网智能运维与故障诊断系统需求建设详细方案
| 文档属性 |
内容 |
| 文档版本 |
V1.3（原始业务需求对齐版） |
| 修订日期 |
2026-07-16 |
| 适用阶段 |
产品评审、研发设计、测试用例设计、研发排期 |
| 编制依据 |
需求设计文档.md、需求文档修订说明.md、本轮产品范围复核结论 |
| 核心定位 |
以网络、管道、业务三层指标的动态基线、趋势预测、瓶颈预警、定界定位和预警闭环为核心的 5G 专网运维应用 |
| 数据边界 |
外部系统在内网交付性能、干扰及已确认的管道/业务指标固定模板；后端定时任务扫描、校验后原值入 MySQL，不建设通用数据处理平台 |
本版范围收敛结论：小区没有坐标，不建设地图、空间拓扑或厂区平面图；但建设基于实体、指标、依赖关系和风险状态的非地理数字孪生视图。小区及场景字段全部来自外部数据，不建设小区新增、编辑、启停、元数据导入或客户-小区映射功能。CSV 不经过浏览器上传，后端定时任务从内网交付位置导入；前端只提供调度监控和控制，不直接展示原始导入表。
一、产品整体架构图
1.1 产品业务架构分层图
静态图件：SVG｜PNG
图件待随 V1.3 Mermaid 架构同步重绘；本文件中的 Mermaid 图为当前评审与研发的权威版本。
flowchart TB
U["用户与访问层<br/>管理员 ROLE_ADMIN｜运维/值班/分析人员 ROLE_USER<br/>PC 管理后台：HTTPS + WebSocket"]
A["业务应用层<br/>SLA 与预警总览｜三层指标监控｜孪生态势<br/>48h 预测｜故障诊断与优化建议｜告警处置｜调度监控｜报告导出"]
C["算法核心层<br/>数据完整率｜Median/MAD 动态基线｜XGBoost 主预测｜Holt-Winters 兜底<br/>可解释规则诊断｜瓶颈预警｜告警状态机"]
J["后端定时调度引擎<br/>扫描内网交付位置｜任务依赖｜启停/手动执行/安全停止"]
G["数据接入与支撑层<br/>固定模板校验｜批次追溯｜结果发布｜算法配置<br/>认证授权｜操作审计"]
D[("MySQL 8.0 唯一业务数据库<br/>原始导入区 + 发布结果区 + 任务/配置/审计")]
E["内网交付位置<br/>性能/干扰/管道/业务指标固定模板"]
O["业务输出<br/>站内预警｜内网通知｜PDF 报告"]
U --> A
A -->|API 查询/控制| G
E -->|定时扫描| J
J -->|校验/原值导入| G
G --> D
D -->|原始数据| C
C -->|发布算法结果| D
D -->|发布结果/任务状态| G
G -->|业务响应| A
A --> O
1.1.1 分层职责
| 架构层 |
核心职责 |
明确边界 |
| 用户与访问层 |
登录、菜单鉴权、查询、处置、实时提醒 |
仅两类系统角色；前端隐藏菜单不是安全边界 |
| 业务应用层 |
查看网络、管道、业务三层指标、预测、孪生态势、诊断和告警，提交处置、优化建议与导出报告 |
不提供地图、地理拓扑、主数据维护或网元控制 |
| 算法核心层 |
数据完整率、动态基线、主预测/兜底预测、规则诊断、瓶颈预警和状态流转 |
诊断只输出待核验原因，不自动确认根因；每个目标时间只发布一个主预测结果 |
| 数据接入与支撑层 |
固定模板校验、任务编排、结果发布、参数配置、权限和审计 |
不做通用 ETL、外部回写或浏览器上传；按已确认模板接入三层指标 |
| 数据存储层 |
保存原始导入数据、发布结果、业务闭环、任务和审计记录 |
MySQL 为唯一业务数据库；原始区与发布结果区逻辑隔离 |
1.2 产品功能架构图
静态图件：SVG｜PNG
图件待随 V1.3 Mermaid 功能架构同步重绘；本文件中的 Mermaid 图为当前评审与研发的权威版本。
flowchart LR
I[内网 CSV 交付位置]
J[后端调度引擎]
JI[定时导入任务]
Q[模板/重复/完整性校验]
RAW[(MySQL 原始导入区)]
M[指标分析结果发布]
S[SLA 汇总]
B[Median/MAD 动态基线]
P[XGBoost 主预测 / Holt-Winters 兜底]
R[规则诊断]
A[告警去重与状态机]
PUB[(MySQL 发布结果区)]
V1[SLA 与预警总览]
V2[网络/管道/业务指标监控]
V3[预测/诊断/孪生态势]
V4[告警处置]
T[调度监控页面]
O1[PDF 报告]
O2[站内/内网通知]
O3[操作审计]
I --> JI --> Q --> RAW
RAW --> M --> PUB
RAW --> S --> PUB
RAW --> B --> PUB
B --> P --> PUB
M --> R
B --> R
P --> R
S --> A
B --> A
P --> A
R --> A --> PUB
PUB --> V1
PUB --> V2
PUB --> V3
PUB --> V4
V1 --> O1
A --> O2
T -.控制/监控.-> J
J -.调度.-> JI
J -.调度.-> M
J -.调度.-> S
J -.调度.-> B
J -.调度.-> P
J -.调度.-> R
J -.调度.-> A
J --> O3
T --> O3
V4 --> O3
1.2.1 模块依赖关系
| 上游模块 |
下游模块 |
依赖内容 |
依赖要求 |
| 定时导入任务 |
全部计算任务 |
网络、管道、业务指标记录、导入批次、数据时间范围 |
只有校验通过且已发布的结果可供前端读取 |
| 指标分析结果发布 |
SLA、基线、预测、诊断、孪生视图 |
实际 KPI、底噪、RRC、PRB、流量、时延（如提供）和数据质量状态 |
前端和后续任务不直接查原始导入表 |
| SLA 配置 |
SLA 汇总、SLA 告警、报告 |
三项阈值、无数据策略、完整率、生效版本 |
计算结果必须绑定配置版本 |
| 动态基线 |
指标监控、预测、诊断、趋势异常 |
中心值、尺度、上下限、样本数、版本 |
样本不足时明确降级，不生成伪基线 |
| 趋势预测 |
预测页面、预测性告警、孪生视图 |
未来 48h 预测值、预测模型、验证状态、模型/特征版本 |
每个小区/指标/目标时间只发布一个主预测；未验证模型不得触发告警 |
| 规则诊断 |
告警详情、故障历史、优化建议 |
候选原因、证据、缺失证据、规则版本和建议方案 |
不输出未经人工核验的确定根因或自动执行优化 |
| 告警状态机 |
处置、通知、报告 |
认领、处置、验证、关闭、重开动作 |
所有状态变化追加留痕 |
| 调度监控页面 |
定时任务 |
启停、手动执行、停止请求、执行历史 |
前端只控制后端任务，不在浏览器执行计算 |
| 全部敏感操作 |
操作审计 |
操作人、对象、前后值、请求号、结果 |
强制记录，不依赖前端主动上报 |
1.3 建设范围与非建设范围
| 类别 |
本期建设 |
明确不建设 |
| 数据接入 |
后端定时扫描内网交付位置，完成性能、干扰及已确认管道/业务指标固定模板校验、直接导入、批次追溯、失败重试 |
浏览器上传、通用 ETL、数据清洗、字段转换、第二数据库、外部回写 |
| 监控分析 |
网络层 KPI、管道层时延/可用性指标、业务层体验/成功率指标、平均底噪、多对象对比、15 分钟/小时/天/月聚合分析 |
地图、空间拓扑、厂区平面图 |
| 数字孪生 |
以实体、指标、依赖关系、健康度、预测风险和告警状态组成非地理孪生态势视图 |
依赖坐标、GIS 或实时仿真的空间孪生平台 |
| 算法 |
Median/MAD 基线、XGBoost 主预测、Holt-Winters 兜底预测、可解释规则诊断、预测性告警、瓶颈识别 |
Auto ARIMA、线性回归、RNN/LSTM 的并行生产发布；专家知识库、自动根因确认、在线自学习平台 |
| 数据维护 |
导入批次、调度任务、算法/SLA/告警配置 |
小区新增/编辑/启停、人工元数据维护、客户-小区映射 |
| 运维闭环 |
告警查看、认领、处置、验证、管理员关闭/重开 |
参数调整、重启或其他网元操作直接下发 |
| 权限 |
ROLE_ADMIN、ROLE_USER 两类固定角色和功能级权限 |
多租户、客户/地市行级隔离、自定义角色编排 |
| 报告 |
从 SLA 总览按当前区域/场景/小区范围异步生成 PDF |
独立客户主数据、客户报告权限体系、独立报告管理一级菜单 |
1.4 核心业务数据流
| 阶段 |
输入 |
处理 |
输出 |
| 1. 定时导入 |
内网网络/管道/业务指标固定模板 |
后端扫描、模板/编码/必填/哈希/唯一键校验 |
原始导入区、导入批次 |
| 2. 结果发布 |
导入成功记录 |
生成统一三层指标结果并标记发布运行号；保留源粒度 |
前端可读的 15 分钟或小时分析结果 |
| 3. 基线与 SLA |
近 30 日健康有效样本 |
SLA 汇总、Median/MAD 基线、日/月聚合 |
发布结果、样本状态和版本 |
| 4. 预测与瓶颈 |
已发布指标结果、滞后特征、流量、PRB、时延（如提供）、基线 |
XGBoost 主模型推理，Holt-Winters 在主模型不满足发布条件时兜底；预测未来 48 小时 |
已验证预测结果、性能瓶颈临界值与预计发生时间 |
| 5. 诊断、优化与预警 |
已发布三层指标、基线、预测 |
规则关联、定界定位、优化建议、去重、升级和状态机 |
诊断候选、工单建议、告警、通知、审计、报告快照 |
1.5 逻辑数据区与前端读数边界
| 数据区 |
代表表 |
写入方式 |
前端是否可直接读取 |
| 原始导入区 |
既有 tb_perf_hour、tb_interference_hour、tb_import_batch；新增三层指标时使用通用原始指标表 |
定时导入任务；保留 CSV 原值 |
否；仅供后端算法任务读取 |
| 发布结果区 |
tb_metric_analysis_hour、通用三层指标分析结果、tb_sla_daily、tb_cell_baseline、tb_cell_prediction、tb_diagnosis_result、tb_alarm |
算法任务完成后以运行号发布；保存数据截止、发布时间和发布状态 |
是；所有业务页面只读此区 |
| 调度运行区 |
tb_schedule_job、tb_schedule_instance |
调度引擎和调度监控操作 |
是；供调度监控页面查询 |
| 配置与留痕区 |
tb_sla_config、算法/告警配置、tb_report_task、tb_report_snapshot、tb_audit_log |
管理操作和异步任务 |
按角色读取 |
二、菜单级功能结构图
2.1 系统菜单树
工作台
├─ 运行概览
└─ SLA 与预警总览
└─ 孪生态势
└─ 网络、管道、业务三层健康与风险视图
监控分析
├─ 性能指标
│ ├─ 无线接通率
│ ├─ 无线掉线率
│ ├─ 切换成功率
│ └─ 多小区对比
└─ 干扰水平
└─ 平均底噪
└─ 多层指标
└─ 管道时延/可用性与业务体验指标（按已接入指标目录展示）
智能研判
├─ 趋势预测
│ └─ 48 小时趋势预测
└─ 故障分析
└─ 故障诊断记录
告警处置
└─ 告警中心
├─ 告警列表
└─ 告警详情（由列表或顶部通知进入）
运维管理（仅 ROLE_ADMIN）
└─ 调度管理
└─ 定时调度监控（任务列表、执行记录、详情抽屉）
系统管理（仅 ROLE_ADMIN）
├─ 规则配置
│ ├─ SLA 阈值配置
│ ├─ 基线与预测配置
│ └─ 告警策略配置
├─ 用户与权限
│ └─ 用户管理
└─ 审计管理
└─ 操作审计
顶部全局入口
├─ 告警铃铛（未读数、最近 20 条、查看/认领/诊断/标记已读）
└─ 当前用户（个人信息、退出登录）
报告生成不占用一级菜单：在“SLA 与预警总览”内提供“生成报告”和“报告任务”入口，任务状态与下载在抽屉中完成。
2.2 页面清单、核心按钮与字段概要
| 一级菜单 |
二级菜单 |
功能页面 |
可用角色 |
核心操作按钮 |
数据展示字段概要 |
建设批次 |
| 工作台 |
运行概览 |
SLA 与预警总览 |
管理员、普通用户 |
查询、重置、查看明细、查看告警、生成报告、报告任务 |
统计范围、监测/可评价小区数、三项 KPI、综合 SLA、完整率、告警数、配置版本 |
M1/M2 |
| 工作台 |
孪生态势 |
三层健康与风险视图 |
管理员、普通用户 |
查询、时间粒度切换、查看实体、查看告警、查看预测 |
网络/管道/业务实体、健康度、实际值、基线状态、预测风险、瓶颈临界值、预计发生时间、关联告警 |
M2 |
| 监控分析 |
性能指标 |
无线接通率 |
管理员、普通用户 |
查询、重置、查看告警、添加备注 |
时间、小区、实际值、合同阈值、动态中心/下限、越界状态、事件 |
M1/M2 |
| 监控分析 |
性能指标 |
无线掉线率 |
管理员、普通用户 |
查询、重置、查看告警、添加备注 |
时间、小区、实际值、合同阈值、动态中心/上限、越界状态、事件 |
M1/M2 |
| 监控分析 |
性能指标 |
切换成功率 |
管理员、普通用户 |
查询、重置、查看告警、添加备注 |
时间、小区、实际值、合同阈值、动态中心/下限、越界状态、事件 |
M2 |
| 监控分析 |
性能指标 |
多小区对比 |
管理员、普通用户 |
添加/移除小区、查询、重置、查看单小区 |
最多 5 个小区、指标趋势、均值、告警次数、SLA 达标率 |
M2 |
| 监控分析 |
干扰水平 |
平均底噪 |
管理员、普通用户 |
查询、重置、查看关联告警、添加备注 |
时间、小区、频段、平均底噪、动态中心/上限、越界状态 |
M2 |
| 监控分析 |
多层指标 |
管道与业务指标分析 |
管理员、普通用户 |
查询、重置、查看告警、添加备注 |
指标层级、实体、实际值、单位、动态区间、瓶颈状态、时延/可用性/业务体验指标、事件 |
M2，依赖 D06 |
| 智能研判 |
趋势预测 |
48 小时趋势预测 |
管理员、普通用户 |
查询、重置、查看预测告警、查看模型信息 |
目标时间、预测值、基线、预计越界时间、模型/特征版本、验证状态 |
M2 |
| 智能研判 |
故障分析 |
故障诊断记录 |
管理员、普通用户 |
查询、重置、一键诊断、查看证据、认领、提交处置 |
告警、小区、指标、候选原因、证据、严重度、状态、责任人、闭环时长 |
M2 |
| 告警处置 |
告警中心 |
告警列表 |
管理员、普通用户 |
查询、重置、查看详情、认领、标记已读、一键诊断 |
告警号、级别、类型、小区、触发值/阈值、时间、责任人、状态 |
M2 |
| 告警处置 |
告警中心 |
告警详情 |
管理员、普通用户 |
认领、提交核查、关联工单、提交处置/验证、申请关闭；管理员关闭/重开 |
告警指纹、证据、诊断、动作、通知、验证、关闭/重开记录 |
M2 |
| 运维管理 |
调度管理 |
定时调度监控 |
仅管理员 |
刷新、启用、停用、手动执行、停止执行、查看日志/历史 |
任务编码、任务类型、调度周期、启用状态、上次/下次执行、当前实例、进度、结果、错误 |
M1 |
| 系统管理 |
规则配置 |
SLA 阈值配置 |
仅管理员 |
查询、新建版本、复制、校验、发布、停用 |
作用域、三项阈值、无数据策略、完整率、生效期、版本、状态 |
M1/M2 |
| 系统管理 |
规则配置 |
基线与预测配置 |
仅管理员 |
查询、新建版本、校验、发布、停用、查看运行状态 |
指标、方向、样本期、最小有效日、k/floor、预测参数、模型状态 |
M2 |
| 系统管理 |
规则配置 |
告警策略配置 |
仅管理员 |
查询、新建/编辑、启用/停用、测试通道 |
告警类型、级别、去重窗口、未认领时限、通道、重试策略 |
M2/M3 |
| 系统管理 |
用户与权限 |
用户管理 |
仅管理员 |
新建、编辑、启用/停用、重置密码 |
用户名、姓名、手机号、角色、状态、创建时间、最后登录 |
M1 |
| 系统管理 |
审计管理 |
操作审计 |
仅管理员 |
查询、重置、查看详情、导出 |
审计号、操作人、时间、类型、对象、前后值、IP、请求号、结果 |
M1/M3 |
三、分模块详细功能说明
3.0 通用角色与数据口径
3.0.1 用户角色
| 系统角色 |
使用人员 |
主要职责 |
数据范围 |
ROLE_ADMIN |
系统管理员、调度管理员、配置管理员 |
调度控制、配置发布、用户管理、审计、告警最终关闭/重开 |
当前部署范围内全部数据 |
ROLE_USER |
网络运维、值班、故障分析、业务分析人员 |
查询、预测分析、告警认领、诊断、处置、验证、报告导出 |
当前部署范围内全部数据 |
3.0.2 数据口径
| 主题 |
统一规则 |
| 数据权威源 |
外部系统已完成 KPI 处理，CSV 中的比率、单位和统计粒度为本系统输入口径 |
| 调度执行 |
CSV 导入、指标分析、SLA、基线、预测、诊断和告警均由后端定时任务执行；浏览器只调用任务控制 API |
| 指标层级 |
所有指标必须归属 NETWORK、PIPELINE 或 BUSINESS；指标目录定义指标代码、实体类型、单位、劣化方向、可用粒度和是否参与 SLA/预测/诊断 |
| 时间粒度 |
保留外部数据的 15 分钟或小时原始粒度；日、月为服务端聚合结果。未提供 15 分钟数据时不得由浏览器或后端伪造插值 |
| 小区信息 |
cgi、nci、名称、区域、场景、频段、带宽全部来自导入数据；系统无“新增小区”动作 |
| 内部维度 |
如为查询性能建立 tb_cell_meta，仅按最新有效导入记录自动同步展示字段，不提供页面和写接口 |
| 前端读数 |
所有业务页面只读取发布结果区；禁止直接查询 tb_perf_hour、tb_interference_hour 等原始导入表 |
| 结果新鲜度 |
算法页面统一展示数据截止时间、计算/发布时间和发布运行号；最新任务失败或停止时展示最后成功版本及状态提示 |
| 有效时间片 |
导入批次通过、对应 (cgi,datatime) 记录存在且指标值非空即为可评价；当前版本不要求原始分子/分母 |
| 无数据 |
记录缺失或指标为空时为 N/A，不得以 0 或达标替代 |
| 比例指标 |
MySQL 和后端比较使用 0~1 小数，前端只格式化为百分比 |
| 时间 |
datatime 按 CSV 中国标准时间原样保存和展示 |
| 分页 |
列表由后端分页/游标查询，单次最多 200 条；高频查询必须带时间范围 |
| 诊断 |
只输出候选原因、命中证据和缺失证据；人工核验前不得显示为已确认根因 |
| 网元操作 |
系统只记录建议、工单和验证结果，不直接下发参数、重启或其他操作 |
3.0.3 孪生与优化的业务边界
数字孪生视图以“指标实体 + 依赖关系 + 当前健康状态 + 预测风险 + 告警/工单”为最小模型，可按网络、管道、业务层向下钻取关联证据。它不是地理地图，也不要求小区坐标、GIS 或空间拓扑。
优化方案由诊断规则基于候选原因、影响范围、证据和预测窗口生成，包含建议动作、预期改善对象、验证条件和审批要求。方案只作为工单建议，任何参数调整、重启或其他网元操作仍在既有变更流程外执行。
3.1 工作台 / SLA 与预警总览
3.1.1 模块定位与用户角色
| 项目 |
说明 |
| 模块定位 |
汇总区域、场景和小…7681 tokens truncated…对象、重试次数/间隔、状态、生效期 |
| 核心规则 |
时限必须大于 0；无外部通道仍保留站内告警；通道凭据不在页面或日志明文展示 |
| 变更规则 |
去重/升级策略只影响生效后的新触发；测试消息不改变业务告警状态 |
3.8.5 与其他模块的关联关系
| 关联模块 |
数据流向/联动 |
| 定时调度任务 |
实例启动时读取并固化生效配置版本，结果保存配置版本和运行号 |
| 告警中心 |
读取去重、升级和通知配置 |
| 报告/审计 |
报告固化配置版本；发布、停用和通道测试全部审计 |
3.9 系统管理 / 用户管理
3.9.1 模块定位与用户角色
| 项目 |
说明 |
| 模块定位 |
管理两类固定角色账号，为鉴权、告警责任和审计提供操作主体 |
| 用户角色 |
仅管理员维护；已认证用户只读取自己的会话信息 |
| 建设批次 |
M1 |
3.9.2 核心功能点与字段
| 功能 |
操作/按钮 |
核心字段 |
| 查询 |
查询、重置 |
用户名、姓名、手机号、角色、状态 |
| 维护 |
新建、编辑、启用/停用 |
用户名、真实姓名、手机号、ROLE_ADMIN/ROLE_USER、启用状态 |
| 凭据 |
重置密码 |
密码更新时间、结果；不返回明文或哈希 |
3.9.3 业务规则与校验逻辑
| 规则编号 |
规则/校验 |
| USER-01 |
用户名唯一；角色只允许 ROLE_ADMIN、ROLE_USER |
| USER-02 |
密码按平台策略校验并使用强哈希保存，禁止进入日志和导出 |
| USER-03 |
用户不物理删除，只启用/停用；停用后历史责任和审计保留 |
| USER-04 |
不允许停用系统最后一个启用的管理员 |
| USER-05 |
前端菜单可见性不代替后端接口鉴权 |
3.9.4 与其他模块的关联关系
| 关联模块 |
数据流向/联动 |
| 告警中心 |
用户作为责任人、处置人、验证人和关闭人 |
| 报告 |
记录报告创建人、重试人和下载人 |
| 操作审计 |
登录、创建、角色变更、启停和密码重置均审计 |
3.10 系统管理 / 操作审计
3.10.1 模块定位与用户角色
| 项目 |
说明 |
| 模块定位 |
记录登录、导入、配置、算法任务、诊断、告警、报告和权限操作 |
| 用户角色 |
仅管理员查询和导出；任何角色均不可修改或删除审计记录 |
| 建设批次 |
M1 审计底座；M3 完成全链路覆盖检查 |
3.10.2 核心功能点与字段
| 功能 |
操作/按钮 |
核心字段 |
| 查询 |
查询、重置 |
时间、操作人、类型、对象、结果、IP、请求号 |
| 详情 |
查看详情 |
审计号、动作、脱敏前后值、失败原因、关联业务号 |
| 导出 |
导出 |
当前筛选、导出任务号、文件哈希、下载记录 |
3.10.3 业务规则与校验逻辑
| 规则编号 |
规则/校验 |
| AUD-01 |
必须覆盖登录、定时导入、调度启停/手动执行/停止、配置发布、算法任务、诊断、告警动作、报告和用户变更 |
| AUD-02 |
tb_audit_log 只允许追加；页面不提供删除或修改操作 |
| AUD-03 |
密码、令牌、密钥和完整文件内容不得进入日志；前后值结构化且脱敏 |
| AUD-04 |
请求、任务、批次、告警和报告通过请求号/业务号关联，时间与内网 NTP 同步 |
| AUD-05 |
审计与报告快照默认保留不少于 24 个月，最终以合同为准 |
3.10.4 与其他模块的关联关系
| 关联模块 |
数据流向/联动 |
| 全部模块 |
敏感操作由后端统一记录，不依赖前端自行拼装审计内容 |
| 导入/任务/告警/报告 |
通过批次号、任务号、告警号和报告版本形成完整链路 |
3.11 研发拆分、里程碑与评审项
3.11.1 研发工作包
| 工作包 |
交付内容 |
主要前置依赖 |
目标里程碑 |
| WP01 调度与数据入口 |
后端调度引擎、内网定时导入、任务/实例表、调度监控页面、登录鉴权、审计底座 |
固定 CSV 模板、交付位置和频率 |
M1 |
| WP02 结果发布、SLA 与基线 |
指标分析结果表、原子发布、SLA/完整率、阈值版本、Median/MAD 和基础看板 |
WP01、合同阈值 |
M1/M2 |
| WP03 预测与规则诊断 |
XGBoost 主预测、Holt-Winters 兜底预测、48h 瓶颈预警、基于导入字段的定界定位与优化建议 |
WP02、30 天以上历史数据、D06 指标目录 |
M2 |
| WP04 告警闭环 |
告警去重、状态机、WebSocket、处置验证和通知 |
WP02/WP03 |
M2/M3 |
| WP05 分析前台与报告 |
三层指标趋势、多对象对比、非地理孪生态势、预测/诊断/优化建议页面、总览内嵌 PDF 任务 |
WP01~WP04 接口、D06 实体关系 |
M2 |
| WP06 集成与上线 |
权限矩阵、容量压测、内网通知/PDF、安全、备份、UAT、试运行 |
WP01~WP05 |
M3/M4 |
3.11.2 里程碑排期
| 里程碑 |
计划日期 |
交付结果 |
| M1 数据通路可用 |
2026-07-31 |
后端定时导入、调度监控、原始/发布数据区、两类账号、审计和基础 SLA 看板 |
| M2 核心算法与预警闭环就绪 |
2026-08-08 |
动态基线、主/兜底预测、瓶颈预警、规则诊断与优化建议、孪生态势、告警状态机、分析页面和报告可联调 |
| M3 集成验收完成 |
2026-08-20 |
权限、容量、内网通知/PDF、安全和备份验证通过 |
| M4 正式上线 |
2026-09-07 |
试运行、回归、培训、验收资料和上线评审完成 |
3.11.3 已关闭的范围问题
| 原问题 |
本版结论 |
| 小区无坐标 |
不建设地图、空间拓扑、平面图和相关数据契约；保留不依赖坐标的实体/指标/风险孪生态势视图 |
| 小区数据来自外部系统 |
删除小区新增、编辑、启停和元数据导入；筛选维度由导入数据自动同步 |
| 客户与小区映射 |
删除客户主数据、映射表、映射发布和客户级权限/报告范围 |
| CSV 前端导入 |
删除上传和导入页面；改为后端扫描内网交付位置，并通过调度监控页面运维 |
| KPI 无原始分子/分母 |
接受上游 KPI 为权威输入；有效时间片按记录存在且指标非空判断 |
| 无 RRC 配置容量 |
诊断改用 RRC 连接最大数与 PRB 动态异常判断“负荷/容量风险” |
3.11.4 仍需确认事项
| 编号 |
待确认事项 |
影响范围 |
要求时间 |
| D01 |
CSV 内网交付位置、命名、频率、文件完成标识和最大单文件规模 |
扫描策略、避免读取未写完文件、完整率和容量 |
M1 开发前 |
| D02 |
三项 SLA 合同阈值、N/A 策略、最小数据完整率和生效期 |
SLA、告警、报告 |
M1 联调前 |
| D03 |
每小时应收记录计划及迟到数据处理时点 |
数据完整率、日汇总、基线样本 |
M1 联调前 |
| D04 |
原始小时数据是否需超过 90 天在线保留 |
MySQL 分区、容量、备份 |
M3 容量评审前 |
| D05 |
可用的企业微信/短信/邮件内网通道和接收范围 |
告警升级 |
M3 联调前 |
| D06 |
管道层、业务层指标目录：指标代码、单位、劣化方向、源粒度、实体标识、网络实体关联、时延/体验字段和 SLA 归属 |
三层监控、预测、瓶颈、诊断、孪生态势和数据模型 |
M2 开发前 |
| D07 |
15 分钟数据是否可稳定交付，以及小时/日/月聚合口径、迟到数据处理和最小完整率 |
多粒度趋势、预测训练和报告 |
M2 开发前 |
四、非功能性需求（补充）
4.1 性能、容量与响应要求
4.1.1 验收基线
| 项目 |
基线值 |
| 小区规模 |
500 个小区 |
| 在线热数据 |
90 天，性能/干扰两张小时表约 216 万行 |
| 并发规模 |
50 个并发会话 |
| 数据库 |
MySQL 8.0；小时表按 datatime 月分区；(cgi,datatime) 唯一索引 |
| 查询策略 |
业务页面只查已发布结果；列表服务端分页/游标，单次最多 200 条 |
4.1.2 响应指标
| 编号 |
场景 |
验收目标 |
说明 |
| NFR-P01 |
SLA 与预警总览、告警列表 |
P95 <= 2 秒 |
500 小区、常用筛选和合理时间范围 |
| NFR-P02 |
近 7 天单小区趋势、5 小区对比 |
P95 <= 3 秒 |
图表和明细使用同一查询条件 |
| NFR-P03 |
普通列表筛选、分页、排序 |
P95 <= 2 秒 |
服务端分页和排序字段白名单 |
| NFR-P04 |
管理后台首次可交互 |
建议 P95 <= 3 秒 |
内网标准 PC 和已部署静态资源 |
| NFR-P05 |
告警站内实时提醒 |
建议端到端 P95 <= 5 秒 |
从告警落库到在线客户端收到提醒 |
| NFR-P06 |
报告任务提交/状态查询 |
P95 <= 2 秒 |
PDF 生成异步，不纳入同步接口时延 |
| NFR-P07 |
导入后算法流水线 |
在各任务配置超时内完成并发布或明确失败 |
导入→指标→SLA/基线→预测→诊断/告警 |
| NFR-P08 |
调度监控查询/控制 |
查询 P95 <= 2 秒；控制请求 P95 <= 2 秒 返回受理结果 |
停止完成时间取决于安全检查点 |
4.1.3 实现约束
| 层面 |
要求 |
| 数据库 |
高频查询必须带时间范围；建立必要联合索引；禁止无界全表查询 |
| 后端 |
业务查询仓储只访问发布结果表；原始表仓储仅供定时算法任务使用；分页和排序由服务端强制校验 |
| 前端 |
路由懒加载、图表按需渲染、取消失效请求；不执行定时器业务任务或自行拼接原始/算法数据 |
| WebSocket |
有限退避重连；重连后重新获取未读数和告警列表 |
| 压测报告 |
记录 P50/P95/P99、错误率、慢查询、CPU/内存和测试数据规模 |
4.2 权限控制粒度
4.2.1 权限模型
| 权限层级 |
本期要求 |
实现方式 |
| 认证级 |
所有业务 API 必须认证；停用用户不可继续访问 |
Spring Security + 内网 HTTPS |
| 功能级 |
菜单、按钮和接口按两类角色控制 |
前端控制可见性；后端注解是安全边界 |
| 操作级 |
调度启停/手动执行/停止、配置、用户、审计、告警最终关闭/重开仅管理员 |
每个写接口独立鉴权 |
| 数据级 |
已认证用户可见当前部署范围内全部数据 |
本期不做客户、地市或多租户行级隔离 |
| 对象级 |
告警动作、配置发布、报告下载同时校验角色、状态和版本 |
防止越权和并发覆盖 |
4.2.2 角色权限矩阵
| 功能/操作 |
ROLE_ADMIN |
ROLE_USER |
| SLA、性能、干扰、预测、诊断查询 |
✓ |
✓ |
| 多小区对比、添加备注 |
✓ |
✓ |
| 告警查看、认领、诊断、处置、验证、申请关闭 |
✓ |
✓ |
| 告警最终关闭、重开 |
✓ |
— |
| 生成、重试和下载 SLA 报告 |
✓ |
✓ |
| 调度任务查看、启停、手动执行、停止和查看日志 |
✓ |
— |
| SLA/基线/预测/告警配置 |
✓ |
— |
| 用户管理 |
✓ |
— |
| 审计查询与导出 |
✓ |
— |
4.2.3 权限校验规则
| 编号 |
规则 |
| NFR-A01 |
角色名称已含 ROLE_ 前缀，统一使用 hasAuthority/hasAnyAuthority |
| NFR-A02 |
前端隐藏菜单不代替后端鉴权；越权接口返回 403 并记录安全日志 |
| NFR-A03 |
告警和配置写操作采用状态/版本校验，过期页面提交必须拒绝并提示刷新 |
| NFR-A04 |
后续如需数据隔离，必须单独设计数据域，不在本期隐式拼接行级条件 |
4.3 日志与审计要求
4.3.1 日志分类
| 日志类型 |
必须记录内容 |
用途 |
| 操作审计 |
操作人、时间、类型、对象、前后值、IP、请求号、结果 |
合规追溯 |
| 安全日志 |
登录成功/失败、鉴权失败、账号锁定、异常导出 |
安全分析 |
| 任务日志 |
导入、指标发布、SLA、基线、预测、诊断/告警、报告任务的状态、阶段、耗时、停止请求、发布运行号和失败原因 |
算法与任务运维 |
| 告警动作 |
触发、合并、认领、升级、处置、验证、关闭、重开 |
生命周期追溯 |
| 通知投递 |
通道、目标、时间、结果、失败原因、重试次数 |
防止通知丢失 |
4.3.2 审计控制
| 编号 |
要求 |
| NFR-L01 |
tb_audit_log 只允许追加；任何角色均无修改/删除入口 |
| NFR-L02 |
审计必须覆盖登录、定时导入、调度控制、配置、算法任务、诊断、告警、报告和用户变更 |
| NFR-L03 |
通过请求号、批次号、任务号、告警号和报告版本关联完整链路 |
| NFR-L04 |
密码、令牌、密钥和完整文件内容不得进入日志，前后值必须脱敏 |
| NFR-L05 |
审计日志和报告快照默认保留不少于 24 个月 |
| NFR-L06 |
审计导出本身记录导出人、筛选条件、文件哈希和结果 |
4.4 数据治理与数据质量要求
| 治理主题 |
要求 |
验收证据 |
| 数据契约 |
网络、管道、业务指标固定表头、指标目录、实体标识、编码、单位、源粒度和统计口径；变化先评审，不自动兼容 |
模板与指标目录版本、正反用例 |
| 内网接入 |
后端只扫描配置允许的内网交付位置；浏览器不上传、下载或查看原始文件内容 |
菜单/API 清单、目录白名单测试 |
| 权威来源 |
KPI 和小区展示字段以外部系统导入值为准；本系统不提供人工主数据修改 |
页面与接口清单、越权测试 |
| 唯一性 |
文件哈希唯一；既有无线小时数据 (cgi,datatime) 唯一；通用指标数据按 (entity_type,entity_id,metric_code,datatime) 唯一；重复不覆盖 |
唯一索引、重复导入测试 |
| 完整性 |
按各指标目录声明的 15 分钟或小时应收计划计算完整率；记录缺失或指标为空为 N/A |
日汇总、缺口明细 |
| 原值保护 |
CSV 原值、单位和粒度不变；PDCP 的旧系统 GB 展示换算不回写源值 |
文件与数据库抽样比对 |
| 自动维度 |
小区筛选字段只从最新有效导入记录同步，无新增/编辑/启停/映射流程 |
导入后筛选联动测试 |
| 可追溯性 |
原始记录关联批次；算法/诊断/报告关联配置、模型和规则版本 |
端到端链路抽查 |
| 发布一致性 |
算法结果按运行号写入并原子发布；页面单次响应只使用一个发布版本 |
失败/停止运行、版本切换用例 |
| 生命周期 |
原始小时数据默认 90 天；汇总、报告和审计按合同保留，默认至少 24 个月 |
分区和清理策略 |
4.5 算法与预警验收要求
| 验收对象 |
必测场景 |
通过标准 |
| 动态基线 |
样本充足、少于 14 个有效日、告警样本排除、不同小时槽 |
计算符合 Median/MAD 公式；不足时不生成基线 |
| SLA/趋势异常 |
合同阈值越界、仅动态基线越界、两者同时越界 |
告警类型和证据分别保留，不混为一种口径 |
| 趋势预测 |
少于 30 日、完整率低于 95%、模型验证失败、连续两个预测点越界 |
不合格模型不发布；合格连续越界生成预测性告警 |
| 模型选择 |
XGBoost 验证通过、主模型数据不足、主模型验证失败、Holt-Winters 验证失败 |
主模型优先；仅主模型不可发布时使用同口径验证通过的 Holt-Winters；同一目标时间仅发布一个模型结果 |
| 三层瓶颈与孪生 |
网络、管道、业务层分别异常；跨层关联存在/缺失；预测临界值跨越 |
展示层级、实体、证据、风险和预计发生时间；关联缺失时明确提示，不虚构关系 |
| 干扰诊断 |
底噪越界且 KPI 劣化、仅底噪越界 |
前者输出干扰风险候选；后者显示证据不足 |
| 切换诊断 |
切换成功率低于阈值/基线 |
输出“切换性能异常待核验”，不虚构邻区根因 |
| 负荷诊断 |
RRC 连接最大数与 PRB 连续共同越界、仅单指标越界 |
前者输出负荷/容量风险候选；后者显示证据不足 |
| 优化建议 |
干扰、切换、负荷及跨层问题命中/证据不足 |
输出核查项、建议动作、影响对象、验证条件和审批要求；不下发网元操作 |
| 告警闭环 |
新建至关闭、验证失败回退、重开、去重、升级、通知失败 |
状态、动作和通知结果完整可追溯 |
| 调度流水线 |
自动触发、手动执行、任务停用、重复执行、依赖失败、安全停止 |
无重复实例；未完成结果不可见；下游不消费失败运行 |
4.6 可用性、可靠性与恢复
| 编号 |
要求 |
| NFR-R01 |
多实例部署使用 MySQL 锁保证同一任务编码同一时间只执行一个实例 |
| NFR-R02 |
任务状态、失败原因和重试次数持久化；服务重启后可查询恢复，不依赖 Redis |
| NFR-R03 |
停止任务采用持久化停止请求和安全检查点；未完成算法结果不发布，已发布旧版本继续可用 |
| NFR-R04 |
WebSocket 断开不影响任务和告警运行；重连后从服务端补拉权威状态 |
| NFR-R05 |
每日备份配置、任务实例、报告快照和审计日志；至少每季度执行一次恢复演练 |
| NFR-R06 |
生产不依赖公网；构建依赖、中文字体和部署包均在内网可用 |
| NFR-R07 |
系统时间与内网 NTP 同步，保证导入、算法、告警、任务和审计时间一致 |
| NFR-R08 |
RPO/RTO、可用率和数据库高可用形态在部署评审中确认 |
4.7 安全要求
| 编号 |
要求 |
| NFR-S01 |
全部服务使用内网 HTTPS；密码使用强哈希；认证失败不泄露账号信息 |
| NFR-S02 |
定时导入只访问配置允许的内网目录/文件服务；路径归一化，忽略临时文件，并依据完成标识避免读取写入中的文件 |
| NFR-S03 |
查询、筛选和排序采用参数化访问及字段白名单，禁止拼接用户输入形成 SQL |
| NFR-S04 |
报告下载校验授权和任务状态，不暴露服务器真实路径 |
| NFR-S05 |
日志和接口不得暴露数据库口令、令牌、通知密钥或敏感堆栈信息 |
| NFR-S06 |
调度启停/手动执行/停止、配置发布、告警关闭/重开、报告下载和审计导出记录请求号与结果 |
4.8 易用性与兼容性
| 主题 |
要求 |
| 布局 |
PC B/S 管理后台，左侧导航 + 右侧内容区，白底蓝标、信息高密度 |
| 浏览器 |
建议验收最近两个主版本的 Microsoft Edge 和 Google Chrome |
| 状态反馈 |
加载、无数据、基线不足、预测不可用、无权限和请求失败使用不同文案 |
| 调度状态 |
运行中、停止中、成功、失败、已停止、已跳过使用固定文案和颜色；危险控制需二次确认 |
| 图表表格 |
数值右对齐、时间统一、图表与表格共享筛选；状态同时使用颜色和文字/图标 |
| 表单 |
必填、格式、范围和权限错误就近提示；提交防重复；服务端状态为准 |
| 内网资源 |
字体、图标和脚本不在运行时从公网加载 |
4.9 非功能验收输出
| 验收项 |
最小交付证据 |
| 性能 |
500 小区/90 天/50 并发压测报告 |
| 权限 |
两类角色的菜单、按钮、接口和越权测试矩阵 |
| 数据质量 |
缺列、错误编码、重复文件/主键、部分失败、N/A 用例 |
| 调度 |
自动触发、启停、手动执行、重复锁、依赖失败、安全停止和执行历史用例 |
| 算法 |
基线、预测、诊断和预警的边界/降级用例与结果 |
| 告警 |
完整状态机、去重、升级、通知失败和重开用例 |
| 审计 |
业务操作到审计记录的链路、前后值和脱敏抽查 |
| 报告 |
正常、数据不足、失败重试、快照不可变和下载授权验证 |
| 内网部署 |
无公网依赖、中文 PDF、备份和恢复演练记录 |
