From 7e690e7e6d29be1afba0fc24c4c97bde8967ef79 Mon Sep 17 00:00:00 2001 From: treehell Date: Fri, 20 Nov 2026 20:16:48 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=20CHANGELOG.md=EF=BC=8C?= =?UTF-8?q?=E8=A1=A5=E8=AE=B0=20v0.1.0=20~=20v0.3.0=20=E7=89=88=E6=9C=AC?= =?UTF-8?q?=E6=9B=B4=E6=96=B0=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- CHANGELOG.md | 71 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..33892e5 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,71 @@ +# 更新记录 + +版本号格式为 主版本.次版本.修订号。每个版本在仓库中有同名标签(`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 类通信场景。