P1:闭环时限管控、治理成效评估、站型阈值系数与接口测试
- 闭环状态流转自动记录接单/闭环时间,状态值校验;按断站分级判定响应时限 (及时/超时/超时未响应/未到期/无记录),新增及时响应率、平均闭环时长、超时未闭环指标与筛选 - 新增治理成效评估 /api/effect:分界日期前后指标对比与问题站点逐站改善判定 - 新增站型阈值系数(实际阈值 = 场景阈值 × 站型系数)及配置接口与页面 - 样例数据新增接单/闭环时间(独立随机数,原字段不变),导入支持并校验 - 新增 tests/test_api.py(权限、导入模板、闭环流程、站型系数、成效评估、无数据边界) - 修复:新流水无告警匹配时根因分析报错;空筛选时超长站点清单返回 500 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e9616af34d
commit
0e070a64fe
13 files changed
+6540
-6043
No files matched your search
@@ -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 = '根因处置建议清单'
|
||||
|
||||
|
||||
Reference in new issue
Block a user