wangjia
3d9ccff6e9
实现 15F 任务的三个核心组件：
capacity.go — CapacityMonitor（每 1-2 min 由 CapacityLoop 调用）
- 池水位检查：up/target < 70% 时发告警，10 min 内降频去重
- 探针失联检查：扫 probe:hb:{probeId}，缺失发「探针失联」事件
- 驱动 Grayscale.Advance 推进养机档位
breaker.go — RedisBreaker（实现 Breaker 接口）
- 滑窗 ZSET sched:breaker:{tier}:{region}，窗口 1h
- 阈值 N = ceil(池容量 × 30%)，下限 3
- 窗口内计数 ≥ N → 置 tripped 标记位 + critical 告警
- Allow 恒 false 直到窗口滑出自动恢复，或管理员调 Reset
- Reset 清除 ZSET + trip flag，写 audit_log
config.go — SchedConfig + ConfigManager（全树阈值热加载）
- SchedConfig 集中定义 15D/15E/15F 所有阈值
- 来源：默认值 → YAML 文件 → 环境变量（三层叠加）
- 监听 SIGHUP，原子替换（atomic.Pointer[SchedConfig]）
- 每次变更 diff 写 audit_log（AuditFn 回调）
测试（24 个用例，全绿）：
- 窗口内第 N 次 Record 后 Allow 返回 false
- 窗口滑出后 Allow 自动恢复
- Reset 立即恢复 + audit 条目
- 下限 3 在小池（target=2）生效
- 65% 水位 → 告警；10 min 内不重复
- 探针心跳缺失 → 失联事件；存在 → 无告警
- YAML + env 覆盖 + SIGHUP Reload → 新阈值即时生效 + diff 审计
- 替换 stub 后 15E 全部集成测试仍绿
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Pangolin Server
Go 后端控制面，负责账户、套餐、激活码、设备与节点目录管理。架构详见 ../design/server/ARCHITECTURE.md。
目录结构
server/
├── cmd/
│ ├── server/ # HTTP 服务入口（chi router，/healthz，/v1 挂载归 1d）
│ └── migrate/ # 数据库迁移 CLI 入口（实现归 1e）
├── internal/
│ ├── config/ # 配置加载（env + 文件，归 1e）
│ ├── store/ # 数据库访问层 Postgres（归 1e）
│ ├── apierr/ # 统一错误体 {code, message_zh, message_en}（归 1f）
│ ├── idgen/ # UUID + Crockford Base32 激活码（归 1f）
│ ├── auth/ # 验证码、argon2id、JWT RS256（归 1c/1d）
│ ├── codes/ # 激活码批次、兑换、审计（归 1d）
│ ├── devices/ # 设备管理（归 1d）
│ ├── nodes/ # 节点目录、connect/disconnect（归 1d）
│ ├── usage/ # 用量统计（归 1d）
│ └── admin/ # 内部管理端（归 1d）
├── Makefile
├── go.mod
├── go.sum
├── tools.go # //go:build tools — 锁定 oapi-codegen / migrate 版本
└── .golangci.yml
常用命令
make build # go build ./...
make test # go test ./...
make vet # go vet ./...
make lint # golangci-lint run ./...
make generate # oapi-codegen 代码生成（1d 填充）
make migrate-up # 执行迁移（1e 填充）
make migrate-down # 回滚迁移（1e 填充）
# 快速启动（默认监听 :8080）
go run ./cmd/server
# 指定地址
go run ./cmd/server -addr :9090
# 或通过环境变量
ADDR=:9090 go run ./cmd/server