新增 admin「渠道监控」模块(参考 BingZi-233/check-cx),独立于现有 Channel 体系。
admin 配置 + 后台定时调用上游 LLM chat completions 健康检查 + 所有登录用户只读可见。
后端:
- ent: channel_monitor + channel_monitor_history(AES-256-GCM 加密 api_key)
- service 按职责拆分:service/aggregator/validate/checker/runner/ssrf
- provider strategy map 替代 switch(openai/anthropic/gemini)
- repository batch 聚合(ListLatestForMonitorIDs + ComputeAvailabilityForMonitors)消除 N+1
- runner: ticker(5s) + pond worker pool(5) + inFlight 防并发 + TrySubmit 防雪崩
+ 凌晨 3 点 cron 清理 30 天历史
- SSRF 防护:强制 https + 私网/loopback/云元数据 IP 拒绝(127/8、10/8、172.16/12、
192.168/16、169.254/16、100.64/10、::1、fc00::/7、fe80::/10)+ DialContext
在 socket 层防 DNS rebinding
- API key sanitize:擦除 url.Error 与上游响应 body 中的 sk-/sk-ant-/AIza/JWT 模式
- APIKeyDecryptFailed 标志位 + 单 monitor 路径检测,避免空 key 调用上游
handler:
- admin: CRUD + 手动触发 + 历史接口(api_key 脱敏)
- user: 只读列表 + 状态详情(去除 api_key/endpoint)
- ParseChannelMonitorID 共用 + dto.ChannelMonitorExtraModelStatus 共用
前端:
- 路由 /admin/channels/{pricing,monitor} + /monitor(用户只读)
- AppSidebar 父项 expandOnly 支持
- ChannelMonitorView 拆为 8 个子组件 + ChannelStatusView 拆出 detail dialog
- composables/useChannelMonitorFormat + constants/channelMonitor 共享
- i18n monitorCommon namespace 消除 admin/user 两 view 重复
合规:所有文件符合 CLAUDE.md(Go ≤ 500 行 / Vue ≤ 300 行 / 函数 ≤ 30 行)
CI: go build / gofmt / golangci-lint(0 issues) / make test-unit / pnpm build 全绿
128 lines
4.2 KiB
Go
128 lines
4.2 KiB
Go
package handler
|
|
|
|
import (
|
|
"github.com/Wei-Shaw/sub2api/internal/handler/admin"
|
|
"github.com/Wei-Shaw/sub2api/internal/handler/dto"
|
|
"github.com/Wei-Shaw/sub2api/internal/pkg/response"
|
|
"github.com/Wei-Shaw/sub2api/internal/service"
|
|
|
|
"github.com/gin-gonic/gin"
|
|
)
|
|
|
|
// ChannelMonitorUserHandler 渠道监控用户只读 handler。
|
|
type ChannelMonitorUserHandler struct {
|
|
monitorService *service.ChannelMonitorService
|
|
}
|
|
|
|
// NewChannelMonitorUserHandler 创建 handler。
|
|
func NewChannelMonitorUserHandler(monitorService *service.ChannelMonitorService) *ChannelMonitorUserHandler {
|
|
return &ChannelMonitorUserHandler{monitorService: monitorService}
|
|
}
|
|
|
|
// --- Response ---
|
|
|
|
type channelMonitorUserListItem struct {
|
|
ID int64 `json:"id"`
|
|
Name string `json:"name"`
|
|
Provider string `json:"provider"`
|
|
GroupName string `json:"group_name"`
|
|
PrimaryModel string `json:"primary_model"`
|
|
PrimaryStatus string `json:"primary_status"`
|
|
PrimaryLatencyMs *int `json:"primary_latency_ms"`
|
|
Availability7d float64 `json:"availability_7d"`
|
|
ExtraModels []dto.ChannelMonitorExtraModelStatus `json:"extra_models"`
|
|
}
|
|
|
|
type channelMonitorUserDetailResponse struct {
|
|
ID int64 `json:"id"`
|
|
Name string `json:"name"`
|
|
Provider string `json:"provider"`
|
|
GroupName string `json:"group_name"`
|
|
Models []channelMonitorUserModelStat `json:"models"`
|
|
}
|
|
|
|
type channelMonitorUserModelStat struct {
|
|
Model string `json:"model"`
|
|
LatestStatus string `json:"latest_status"`
|
|
LatestLatencyMs *int `json:"latest_latency_ms"`
|
|
Availability7d float64 `json:"availability_7d"`
|
|
Availability15d float64 `json:"availability_15d"`
|
|
Availability30d float64 `json:"availability_30d"`
|
|
AvgLatency7dMs *int `json:"avg_latency_7d_ms"`
|
|
}
|
|
|
|
func userMonitorViewToItem(v *service.UserMonitorView) channelMonitorUserListItem {
|
|
extras := make([]dto.ChannelMonitorExtraModelStatus, 0, len(v.ExtraModels))
|
|
for _, e := range v.ExtraModels {
|
|
extras = append(extras, dto.ChannelMonitorExtraModelStatus{
|
|
Model: e.Model,
|
|
Status: e.Status,
|
|
LatencyMs: e.LatencyMs,
|
|
})
|
|
}
|
|
return channelMonitorUserListItem{
|
|
ID: v.ID,
|
|
Name: v.Name,
|
|
Provider: v.Provider,
|
|
GroupName: v.GroupName,
|
|
PrimaryModel: v.PrimaryModel,
|
|
PrimaryStatus: v.PrimaryStatus,
|
|
PrimaryLatencyMs: v.PrimaryLatencyMs,
|
|
Availability7d: v.Availability7d,
|
|
ExtraModels: extras,
|
|
}
|
|
}
|
|
|
|
func userMonitorDetailToResponse(d *service.UserMonitorDetail) *channelMonitorUserDetailResponse {
|
|
models := make([]channelMonitorUserModelStat, 0, len(d.Models))
|
|
for _, m := range d.Models {
|
|
models = append(models, channelMonitorUserModelStat{
|
|
Model: m.Model,
|
|
LatestStatus: m.LatestStatus,
|
|
LatestLatencyMs: m.LatestLatencyMs,
|
|
Availability7d: m.Availability7d,
|
|
Availability15d: m.Availability15d,
|
|
Availability30d: m.Availability30d,
|
|
AvgLatency7dMs: m.AvgLatency7dMs,
|
|
})
|
|
}
|
|
return &channelMonitorUserDetailResponse{
|
|
ID: d.ID,
|
|
Name: d.Name,
|
|
Provider: d.Provider,
|
|
GroupName: d.GroupName,
|
|
Models: models,
|
|
}
|
|
}
|
|
|
|
// --- Handlers ---
|
|
|
|
// List GET /api/v1/channel-monitors
|
|
func (h *ChannelMonitorUserHandler) List(c *gin.Context) {
|
|
views, err := h.monitorService.ListUserView(c.Request.Context())
|
|
if err != nil {
|
|
response.ErrorFrom(c, err)
|
|
return
|
|
}
|
|
items := make([]channelMonitorUserListItem, 0, len(views))
|
|
for _, v := range views {
|
|
items = append(items, userMonitorViewToItem(v))
|
|
}
|
|
response.Success(c, gin.H{"items": items})
|
|
}
|
|
|
|
// GetStatus GET /api/v1/channel-monitors/:id/status
|
|
func (h *ChannelMonitorUserHandler) GetStatus(c *gin.Context) {
|
|
// 复用 admin.ParseChannelMonitorID 保持错误码与日志一致。
|
|
id, ok := admin.ParseChannelMonitorID(c)
|
|
if !ok {
|
|
return
|
|
}
|
|
detail, err := h.monitorService.GetUserDetail(c.Request.Context(), id)
|
|
if err != nil {
|
|
response.ErrorFrom(c, err)
|
|
return
|
|
}
|
|
response.Success(c, userMonitorDetailToResponse(detail))
|
|
}
|