Files
Gset/CHANGELOG.md
T

72 lines
4.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 更新记录
版本号格式为 主版本.次版本.修订号。每个版本在仓库中有同名标签(`git show v0.2.0` 可查看说明)。
## v0.3.1
- 新增本更新记录 `CHANGELOG.md`,并为历史版本补打标签 v0.1.0 ~ v0.3.0。
- 仓库同时推送到 GitHub(treehell/gset)与 git.treemoe.cn(tree/Gset)。
## v0.3.0 — 闭环时限管控、治理成效评估、站型阈值系数
### 新增
- **闭环时限**:状态改为“处理中 / 已闭环”时自动记录接单 / 闭环时间,重新打开时清空闭环时间;
按断站分级判定响应时限(重要 2 小时、主要 4 小时、次要 24 小时),每条流水判定为
及时 / 超时 / 超时未响应 / 未到期 / 无记录。
- 影响评估页新增“闭环管控”:闭环率、及时响应率、平均闭环时长、超时未闭环条数;
退服流水管理新增“仅超时未闭环”筛选与响应时限列。
- **治理成效评估**(`/api/effect`):以分界日期把统计周期分成治理前后两段,各按天数折算后比较 8 项指标;
治理前的超长 / 高频站点逐站判定改善、持平或恶化(±10%)。
- **站型阈值系数**:站点实际阈值 = 场景阈值 × 站型系数(默认室分超长 ×0.75,分布式皮基站 ×1.5),
可在「场景与站点分级」页修改。
- 样例数据新增接单时间、闭环时间两列(独立随机数生成,原有字段不变);导入支持这两列并校验格式与先后顺序。
- `tests/test_api.py`:登录与权限、导入模板校验、闭环流程、站型系数、治理成效、无数据边界,共 41 项检查。
### 修复
- 新导入的流水没有任何告警能匹配时,根因分析报错,导致系统自带的导入模板必定导入失败(v0.2.0 引入)。
- 筛选结果为空时,超长站点清单接口返回 500。
- 闭环状态没有校验,普通用户可写入任意状态值;修改不存在的记录现在返回 404。
### 升级说明
- 旧数据库启动时自动补 `handled_at`、`closed_at` 字段和站型系数表;旧记录没有接单时间,及时响应率显示“—”。
删除 `data/outage.db` 后重启可载入带闭环时间的样例数据。
## v0.2.0 — 根因判定、退服率口径、影响评估、关联量化
### 修复
- **根因判定在非理想数据上准确率大幅下降。** 改为三级判定并带置信度:
1. 衍生关系(高):小区退服告警与退服开始相差 ≤ 2 分钟即匹配(原来要求时间完全相等);
2. 时间窗(中):时间窗按已闭环流水的提前量 95% 分位数标定,不再写死;
3. 疑似(低):时间窗放宽 3 倍命中,提示人工复核。
另外衍生告警按父告警归类,多条命中时优先选随业务恢复清除的告警。
留出集(7–9 月)准确率:
| 测试场景 | v0.1.0 | v0.2.0 |
|---|---|---|
| 仓库样例数据 | 98.42% | 99.28% |
| 小区退服告警时刻偏移 | 衍生判定 0% 命中 | 99.28% |
| 30% 干扰告警 | 89.30% | 96.08% |
| 告警提前量变宽 | 63.08% | 97.96% |
| 综合扰动 | 53.23% | 82.99% |
- **退服率**统计时长改为日历周期(原来取首末记录间隔,稀疏筛选时偏高达 78%)。
- 按站名关键字筛选时,站点数分母仍为全部站点(单站单日 185 → 1)。
- 导出报表与看板的退服率不一致(按场景筛选时相差 4–7 倍)。
- 单独查看某站时“月均”按该站有退服的月数计算,导致 23 个站超长 / 高频判定翻转。
- 重复退服率的分母改为全部站点。
### 新增
- 影响评估新增“受影响用户·小时”,并按 500 米内邻站数做覆盖补偿(原受影响用户与时长相关系数仅 0.03)。
- 告警—退服关联量化(`/api/association`):各类告警的支持度、置信度、提升度,根因页展示时间窗标定表与关联强度表。
- `tests/test_rootcause.py`(6 组扰动数据集留出检验)、`tests/test_kpi.py`、`bench.py`(性能与时长准确率)。
## v0.1.0 — 初始版本
- 用户权限(管理员 / 普通用户)、密码加盐哈希存储、操作日志。
- 退服流水、告警流、华为网管告警、5G 工参导入,逐行校验,预览确认后入库。
- 退服时长按起止时间重算,上报时长差错核对。
- 两级根因判定(衍生关系 + 固定时间窗)与分级处置建议。
- 场景阈值配置、超长 / 高频站点清单、影响评估、可视化看板、三类报表导出。
- 合成样例数据:南宁 7 个城区、185 个站、6000 条退服流水、5 类通信场景。