Issue#6·P2: Dashboard 后端 3 端点——①/ops/system/overview(五子系统 gateway/consumer/mysql/redis/kafka;up|degraded|down|unknown 四态诚实:lag≥10k=degraded、Redis 降级=down 不假绿;admin|ops 角色门,LagReader 闭包注入复用 Day55 只读实例);②/stats/biz(两维分布 by_business=sms|video 空值归一 + by_send_type=batch|personal|timer|file;口径修正留痕:原契约 biz_type 属审核域 audit_record 非 task 维度,以 send_type 呈现更贴运营语义;days 1~30 缺省 7);③/stats/realtime(60s 窗 idx_detail_created 覆盖索引 COUNT 零回表;平台=全局+Top5 账号+username 补齐,客户=仅自己);④openapi 1.4.0→1.5.0(+3 端点);⑤测试=ops_handler_test.go 3 组(平台/客户双口径、四态+lag 千分位、customer 403 门);门禁=vet✓/lint api 域 0/全量 -race 除 channel 存量 flaky(单跑×2 绿,挂账);人工验收挂起与 P3/P4 统一走;工作区遗留 8 文件(先前会话半成品)不纳入本提交边界

This commit is contained in:
2026-11-18 10:58:18 +08:00
parent eda275944f
commit 931d477305
8 changed files with 615 additions and 6 deletions
+21 -1
View File
@@ -1,7 +1,7 @@
openapi: 3.0.3
info:
title: go-sms API v1(阶段 2:账号与权限)
version: 1.4.0
version: 1.5.0
description: |
阶段 2(Day 21-30)交付的账号与权限域全部端点。
统一响应 {code,msg,data}:code=ISC:000 成功;错误码三位制(ISC:4xx/5xx)。
@@ -955,6 +955,26 @@ paths:
summary: 删除档位(settle:write)
parameters: [{name: id, in: path, required: true, schema: {type: integer}}]
responses: {"200": {description: ok}}
/stats/biz:
get:
tags: [stats]
summary: 业务类型分布(Issue#6 Dashboard donut;近 N 自然日,1~30 缺省 7)
parameters:
- {name: days, in: query, schema: {type: integer, default: 7, minimum: 1, maximum: 30}}
responses:
"200": {description: '{days,by_business:[{key:sms|video,count}],by_send_type:[{key:batch|personal|timer|file|other,count}]}'}
/stats/realtime:
get:
tags: [stats]
summary: 实时提交速率(Issue#6 Dashboard KPI;60s 窗口均值,覆盖索引 COUNT)
responses:
"200": {description: '{ts,window_s:60,global_submit_ps,top_accounts:[{account_id,name,submit_ps}]Top5(客户口径仅自己)}'}
/ops/system/overview:
get:
tags: [ops]
summary: 系统健康总览(Issue#6 Dashboard 系统健康卡;admin/ops,gateway 视角五子系统)
responses:
"200": {description: '{uptime_s,subsystems:[{name:gateway|consumer|mysql|redis|kafka,status:up|degraded|down|unknown,detail,latency_ms}]}'}
/stats/profit/users:
get:
tags: [settle]