feat: 换到 Gin 主流栈并补齐运维能力

HTTP 用 Gin,配置用 Viper,日志用 zap,数据用 sqlx;保留原有接口与会商行为。
顺带补上就绪探活、请求号、滚动日志、systemd 与 Dockerfile。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
gozerosandCursor committed 2026-11-04 09:51:41 +08:00
1 parent 0c45b86d67
commit bd427b57a1
26 files changed
+1213 -302

No files matched your search

+46
View File
@@ -0,0 +1,46 @@
# eightbf-analysis-go 运维要点
对齐 [服务端开发设计要求.md](./服务端开发设计要求.md) §9–§11。
## 健康检查
| 路径 | 含义 |
|------|------|
| `GET /api/v1/analysis/health` | 存活:进程在听即可 |
| `GET /api/v1/analysis/ready` | 就绪:至少 MySQL `Ping` 成功,否则 **503** |
Nginx / 编排探活建议:liveness → health;readiness → ready。
## 日志
| 变量 | 说明 |
|------|------|
| `LOG_LEVEL` | debug / info / warn / error,默认 info |
| `LOG_FILE` | 非空则 **stdout + 滚动文件**(zap + lumberjack,控制台键值格式) |
| `LOG_MAX_MB` | 单文件上限 MB,默认 100 |
| `LOG_MAX_AGE_DAYS` | 保留天数,默认 14 |
| `LOG_MAX_BACKUPS` | 备份份数,默认 14 |
业务键:`jobId=` `requestId=` `accountId=` `reqId=` `status=` `phase=` `model=`。
不写 token / 密码 / 完整 dialogues。
采集:systemd journal 或扫 `LOG_FILE` 目录 → Filebeat/Vector → Loki/ELK。
## 配置校验
- 启动时 `Validate()`:非法 mode/端口、空 DSN 直接退出。
- `EBA_STRICT_CONFIG=true`:live 仍用联调默认 DeerFlow 密码则 **拒绝启动**。
- 非 strict 仅 WARN。
## 优雅停机
捕获 SIGINT/SIGTERM → `http.Server.Shutdown`(最长 15s)。
进行中的 LiveRunner 可能仍在跑当前席;取消靠库内 `cancel_flag`。
## systemd
见 `deploy/eightbf-analysis-go.service`,环境文件建议 `/etc/eightbf-analysis-go.env`(勿提交 Git)。
## 单活约束
与 Java 实例、或第二份 Go 进程 **不要** 同时抢同一 MySQL 的 `queued`(尚无领取互斥)。