P1:闭环时限管控、治理成效评估、站型阈值系数与接口测试

- 闭环状态流转自动记录接单/闭环时间,状态值校验;按断站分级判定响应时限
  (及时/超时/超时未响应/未到期/无记录),新增及时响应率、平均闭环时长、超时未闭环指标与筛选
- 新增治理成效评估 /api/effect:分界日期前后指标对比与问题站点逐站改善判定
- 新增站型阈值系数(实际阈值 = 场景阈值 × 站型系数)及配置接口与页面
- 样例数据新增接单/闭环时间(独立随机数,原字段不变),导入支持并校验
- 新增 tests/test_api.py(权限、导入模板、闭环流程、站型系数、成效评估、无数据边界)
- 修复:新流水无告警匹配时根因分析报错;空筛选时超长站点清单返回 500

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
treeandClaude Opus 5.5 committed 2026-11-18 15:14:06 +08:00
1 parent e9616af34d
commit 0e070a64fe
13 files changed
+6540 -6043

No files matched your search

+68 -14
View File
@@ -5,10 +5,10 @@
接口分组(与下方代码顺序一致):
页面与认证 / /login /logout /healthz
看板与统计 /api/meta /api/dashboard /api/stats /api/confusion /api/association /api/sites/rank
看板与统计 /api/meta /api/dashboard /api/stats /api/confusion /api/association /api/sites/rank /api/effect
退服流水 /api/outages(查询、新增、修改、删除、批量) /api/analyze
数据导入 /api/import/preview /api/import/confirm /api/template
站点与场景 /api/sites /api/scenes
站点与场景 /api/sites /api/scenes /api/site_types
导出与系统 /api/export/<报表> /api/logs /api/users
"""
import io
@@ -144,7 +144,7 @@ def meta():
overview = query("SELECT (SELECT COUNT(*) FROM sites) AS sites, COUNT(*) AS records, "
"SUM(status <> '已闭环') AS open FROM outages")[0] # 侧边栏底部的数据概况
return jsonify(scenes=core.SCENES, site_types=core.SITE_TYPES, causes=core.CAUSES, months=months,
regions=regions, vendors=vendors, status=['待处理', '处理中', '已闭环'],
regions=regions, vendors=vendors, status=core.STATUSES,
role=session['role'], user=session['user'], overview=overview)
@@ -250,6 +250,17 @@ def association():
return jsonify(rows=core.association(current_filters()), windows=core.window_table())
@app.route('/api/effect')
@login_required
def effect():
"""治理成效评估:split=YYYY-MM-DD 为治理分界日期,不传时取评估周期中点所在月的 1 日。"""
try:
result = core.effect(current_filters(), request.args.get('split') or None)
except ValueError as e:
return jsonify(error=str(e)), 400
return jsonify(result)
@app.route('/api/sites/rank')
@login_required
def site_rank():
@@ -272,7 +283,8 @@ def site_rank():
OUTAGE_LIST_COLUMNS = ['id', 'record_id', 'ne_id', 'cell_id', 'site_name', 'scene', 'site_type', 'region', 'vendor',
'start_time', 'end_time', 'duration_min', 'reported_min', 'dur_diff', 'cause_category',
'cause_detail', 'cause_code', 'ticket_id', 'root_cause', 'evidence', 'confidence', 'level',
'status', 'handler', 'remark', 'affected_users', 'user_hours', 'loss_gb', 'advice']
'status', 'handler', 'remark', 'affected_users', 'user_hours', 'loss_gb', 'advice',
'handled_at', 'closed_at', 'response_min', 'close_h', 'limit_h', 'sla']
# 新增 / 管理员修改时写入的字段,顺序与 outage_values() 返回值一致
OUTAGE_EDIT_FIELDS = ['record_id', 'ne_id', 'cell_id', 'start_time', 'end_time', 'duration_min', 'cause_category',
@@ -282,13 +294,15 @@ OUTAGE_EDIT_FIELDS = ['record_id', 'ne_id', 'cell_id', 'start_time', 'end_time',
@app.route('/api/outages')
@login_required
def outages():
"""退服流水分页查询。除通用筛选外,long=1 只看超长,diff=1 只看上报时长差错。"""
"""退服流水分页查询。除通用筛选外,long=1 只看超长,diff=1 只看上报时长差错,overdue=1 只看超时未闭环。"""
filters = current_filters()
df = core.frame(filters)
if request.args.get('long') == '1':
df = df[df['is_long']]
if request.args.get('diff') == '1':
df = df[df['dur_diff']]
if request.args.get('overdue') == '1':
df = df[(df['status'] != '已闭环') & df['sla'].isin(['超时', '超时未响应'])]
sort = request.args.get('sort', 'start_time')
if sort not in df.columns:
@@ -313,6 +327,8 @@ def outage_values(data):
raise ValueError('恢复时间早于开始时间')
if not query('SELECT 1 FROM sites WHERE ne_id=?', (data['ne_id'],)):
raise ValueError('基站不在站点库中')
if (data.get('status') or '待处理') not in core.STATUSES:
raise ValueError('闭环状态不正确')
values = {
'record_id': data.get('record_id', ''),
@@ -336,7 +352,13 @@ def outage_values(data):
def outage_add():
columns = ','.join(OUTAGE_EDIT_FIELDS)
placeholders = ','.join('?' * len(OUTAGE_EDIT_FIELDS))
new_id = execute(f'INSERT INTO outages({columns}) VALUES({placeholders})', outage_values(request.get_json()))
data = request.get_json()
try:
values = outage_values(data)
except ValueError as e:
return jsonify(error=str(e)), 400
new_id = execute(f'INSERT INTO outages({columns}) VALUES({placeholders})', values)
core.update_status([new_id], data.get('status') or '待处理') # 按状态补接单 / 闭环时间
core.analyze_all([new_id])
log(session['user'], '新增退服记录', f'id={new_id}')
return jsonify(ok=True, id=new_id)
@@ -347,20 +369,29 @@ def outage_add():
def outage_update(outage_id):
"""
两种修改:
闭环处理:普通用户(或请求中没有 ne_id 时)只更新状态、处理人、处理说明;
闭环处理:普通用户(或请求中没有 ne_id 时)只更新状态、处理人、处理说明,接单 / 闭环时间自动记录;
完整修改:管理员修改全部字段,并重新做根因分析。
"""
data = request.get_json()
is_admin = session['role'] == 'admin'
if not query('SELECT 1 FROM outages WHERE id=?', (outage_id,)):
return jsonify(error='记录不存在'), 404
if not is_admin or 'ne_id' not in data:
execute('UPDATE outages SET status=?, handler=?, remark=? WHERE id=?',
(data.get('status'), data.get('handler', ''), data.get('remark', ''), outage_id))
try:
core.update_status([outage_id], data.get('status') or '', data.get('handler', ''), data.get('remark', ''))
except ValueError as e:
return jsonify(error=str(e)), 400
log(session['user'], '更新闭环进度', f"id={outage_id} -> {data.get('status')}")
return jsonify(ok=True)
try:
values = outage_values(data)
except ValueError as e:
return jsonify(error=str(e)), 400
assignments = ','.join(f'{field}=?' for field in OUTAGE_EDIT_FIELDS)
execute(f'UPDATE outages SET {assignments} WHERE id=?', outage_values(data) + (outage_id,))
execute(f'UPDATE outages SET {assignments} WHERE id=?', values + (outage_id,))
core.update_status([outage_id], data.get('status') or '待处理')
core.analyze_all([outage_id])
log(session['user'], '修改退服记录', f'id={outage_id}')
return jsonify(ok=True)
@@ -389,7 +420,10 @@ def outage_batch():
if data.get('action') == 'delete':
execute(f'DELETE FROM outages WHERE id IN ({placeholders})', ids)
else:
execute(f'UPDATE outages SET status=? WHERE id IN ({placeholders})', [data.get('status', '已闭环')] + ids)
try:
core.update_status(ids, data.get('status', '已闭环'))
except ValueError as e:
return jsonify(error=str(e)), 400
log(session['user'], '批量维护', f"{data.get('action')} {len(ids)} 条")
return jsonify(ok=True, n=len(ids))
@@ -506,7 +540,7 @@ def template():
@login_required
def sites():
return jsonify(rows=query('SELECT * FROM sites ORDER BY scene, district, site_name'),
scenes=query('SELECT * FROM scenes'))
scenes=query('SELECT * FROM scenes'), site_types=query('SELECT * FROM site_types'))
@app.route('/api/sites/<site_id>', methods=['PUT'])
@@ -530,6 +564,22 @@ def scene_edit(scene):
return jsonify(ok=True)
@app.route('/api/site_types/<site_type>', methods=['PUT'])
@admin_required
def site_type_edit(site_type):
"""站型阈值系数:站点实际阈值 = 场景阈值 × 系数。"""
if site_type not in core.SITE_TYPES:
return jsonify(error='未知站型'), 404
data = request.get_json()
long_factor = float(data['long_factor'])
freq_factor = float(data['freq_factor'])
if not (0.1 <= long_factor <= 10 and 0.1 <= freq_factor <= 10):
return jsonify(error='系数应在 0.1 ~ 10 之间'), 400
execute('INSERT OR REPLACE INTO site_types VALUES(?,?,?)', (site_type, long_factor, freq_factor))
log(session['user'], '修改站型系数', f'{site_type}: 时长×{long_factor} 次数×{freq_factor}')
return jsonify(ok=True)
# ================================================================ 报表导出
# 导出 Excel 时的中文列名
EXPORT_COLUMN_NAMES = {
@@ -541,6 +591,8 @@ EXPORT_COLUMN_NAMES = {
'cause_detail': '原因细项', 'cause_code': '原因码', 'ticket_id': '工单号', 'root_cause': '系统判定根因',
'evidence': '关联告警', 'level': '断站分级', 'status': '闭环状态', 'advice': '处置建议', 'record_id': '流水号',
'confidence': '判定置信度', 'user_h': '受影响用户·小时', 'user_hours': '受影响用户·小时',
'handled_at': '接单时间', 'closed_at': '闭环时间', 'response_min': '响应时长(分)', 'limit_h': '响应时限(h)',
'sla': '时限判定',
}
@@ -577,7 +629,9 @@ def export(kind):
['退服率(%)', k['outage_rate']], ['网络可用率(%)', k['availability']], ['超长退服占比(%)', k['long_ratio']],
['重复退服率(%)', k['repeat_rate']], ['受影响用户数', k['users']], ['受影响用户·小时', k['user_h']],
['业务损失(GB)', k['loss_gb']], ['统计站点数', k['sites']], ['统计周期(天)', round(minutes / 1440, 1)],
['根因判定准确率(%)', k['acc']], ['闭环率(%)', k['closed']], ['上报时长差错(条)', k['dur_fix']],
['根因判定准确率(%)', k['acc']], ['闭环率(%)', k['closed']], ['及时响应率(%)', k['response_rate']],
['平均闭环时长(h)', k['avg_close_h']], ['超时未闭环(条)', k['overdue_open']],
['上报时长差错(条)', k['dur_fix']],
]
site_columns = ['ne_id', 'site_name', 'region', 'scene', 'site_type', 'count', 'total_min', 'avg_min',
'max_min', 'long_count', 'users', 'user_h', 'top_cause']
@@ -611,7 +665,7 @@ def export(kind):
long_outages = long_outages.sort_values('duration_min', ascending=False)
columns = ['record_id', 'ne_id', 'site_name', 'scene', 'start_time', 'end_time', 'duration_min',
'cause_category', 'cause_code', 'root_cause', 'evidence', 'confidence', 'level', 'status',
'ticket_id', 'advice']
'handled_at', 'response_min', 'limit_h', 'sla', 'closed_at', 'ticket_id', 'advice']
sheets = {'根因处置建议': long_outages[columns].rename(columns=EXPORT_COLUMN_NAMES)}
title = '根因处置建议清单'