需求设计文档修订说明

修订日期

2026-07-15

修订版本

V2.2

---

一、修订背景

外部系统已完成性能和干扰数据处理，并按固定 CSV 模板向本系统交付数据。本系统不承担数据处理平台职责；唯一业务数据库为 MySQL。

本次在 V2.1 的 SLA、基线、告警、权限和前端修订基础上，删除不必要的外部数据集成和转换设计，使方案与实际 CSV 交付边界一致。

---

二、数据架构收敛

2.1 固定 CSV 直接导入

• 性能表和干扰表以 性能表数据样例.csv、干扰表数据样例.csv 的字段模板为准。
• 本系统只检查文件类型、UTF-8 编码、固定表头、必填列和重复文件，然后直接写入 MySQL。
• 本系统不做 CSV 内容转换、清洗、聚合或外部数据回写。
• 文件名、哈希、导入时间、表类型、行数和结果写入 tb_import_batch，用于追溯和阻止重复文件导入。

2.2 主键与数据表

• cgi 直接作为应用内小区标识，datatime 直接作为采集时间。
• tb_perf_hour、tb_interference_hour 使用 (cgi, datatime) 唯一键；tb_cell_meta 使用 cgi 主键。
• 性能、干扰、SLA、基线、预测、告警、报告、用户和审计均保存于 MySQL，不引入第二个数据库。

2.3 保留的应用业务计算

• SLA、数据完整率、动态基线、预测、规则诊断和告警仍在 MySQL 导入数据之上运行；这些是运维应用功能，不改变 CSV 的源字段或承担上游数据处理。
• PDCP PDU 字节数保留 byte 原值；兼容旧系统展示与预测口径，上、下行分别按 /1024/1024 展示为 GB，合计流量按 （上行字节 + 下行字节）/ 1024^2 计算。

---

三、同步调整的功能设计

3.1 CSV 导入与运维管理

• 管理员可执行 CSV 导入和导入失败重试；普通用户只使用已导入数据进行分析和处置。
• CSV 模板变化、缺少必填列、格式错误或重复文件时，导入直接拒绝，不静默补值或覆盖历史记录。
• 外部系统的 CSV 交付通道由项目内网环境确定，本系统只要求收到固定模板文件，不依赖特定数据仓库或文件协议。

3.2 保持的 V2.1 范围收敛

• 保持“管理员 ROLE_ADMIN、普通用户 ROLE_USER”两类固定角色。
• 保持删除“专家知识库”模块，规则诊断仅提供待核验原因和工单建议。
• 保持离线拓扑、PDFBox 报告、MySQL 报告任务、内网资产和审计留存设计。

---

四、交付计划调整

里程碑	V2.2 交付内容	计划日期
M1	固定 CSV 模板校验、MySQL 标准表、两类账号和基础看板	2026-07-31
M2	SLA、基线、预测、规则诊断、告警和报告联调	2026-08-08
M3	端到端、权限、容量和内网部署验证	2026-08-20
M4	试运行、回归和上线评审完成	2026-09-07

原复杂数据接入工作项取消，改为“CSV 模板校验、直接导入和导入记录”。

---

五、修订前后对比汇总

维度	V2.1 状态	V2.2 状态
数据来源	外部数据系统对接描述复杂	外部系统交付固定 CSV，不关注其内部实现
数据库	多数据存储职责并存	仅 MySQL 作为本系统业务数据库
数据接入	复杂接入规则和转换	固定模板检查后直接导入
小区/时间键	应用内部派生键	CSV 原始 cgi / datatime
数据适配	系统内转换规则	外部系统负责，本系统不实现
应用计算	SLA、基线、预测、告警	保留，直接读取 MySQL 导入数据
权限与前端	两类角色、无知识库、离线拓扑	保持不变

---

六、待确认事项

1. 外部系统确认性能表、干扰表长期保持与样例一致的字段、编码和单位。
2. 项目确认 CSV 的内网交付方式、文件命名规则和交付频率。
3. 客户确认每类合同的 SLA 阈值、N/A 处理和最小数据完整率。
4. 项目部署方确认 MySQL 留存期限是否满足超过 90 天的查询需求。

审核状态

V2.2 已将本系统边界收敛为“固定 CSV + MySQL 运维应用”。开发前只需完成 CSV 模板和交付方式确认，无需进行额外的数据平台对接。