carrydela/cryptoHermes
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
23 Commits 1 Branch 0 Tags
main
Commit Graph

7 Commits

Author SHA1 Message Date
dela
1b61541ff5 feat: 接入 CoinGlass 清算热力图隔离链路
Some checks failed
ci / build + vet + guard + race (push) Has been cancelled
Details
2026-05-25 16:57:22 +08:00
dela
622ff1d317 build: isolate go module proxy setting 2026-05-24 21:50:22 +08:00
dela
6f4e7f04cc build: pass module proxy to docker builder 2026-05-24 21:40:23 +08:00
dela
542eeefdbd deploy: harden compose harness 2026-05-24 21:18:19 +08:00
dela
ea22d06dab deploy(compose): app healthcheck + 优雅停 + 日志策略 + README 部署章节 
- Dockerfile：alpine 安装 wget；加 HEALTHCHECK（/v1/health 探测，
  interval 15s、start_period 20s、retries 3）
- docker-compose.yml app：
  · stop_grace_period 30s（配合 fiber ShutdownWithContext 10s
    + cron 任务收尾，避免 SIGKILL 截断在途请求）
  · restart unless-stopped
  · json-file logging：单文件 50MB、保留 5 个滚动文件
  · 业务日志卷 ./logs:/app/logs
- docker-compose.yml postgres：同样配 restart + logging
- logs/ 目录用 .gitkeep 保留；.gitignore 加 logs/* + !logs/.gitkeep
- README 新增'一键部署（docker compose）'整章：3 步上线、启动顺序图、
  healthcheck 说明、优雅停机、日志、回填历史、生产 checklist

所有 12 条守卫保持无输出；build / vet 干净。
 2026-05-24 21:01:45 +08:00
dela
16f7f00d7b deploy(compose): 修 4 个上生产前的阻断项 
为什么：v2.0 代码侧已 ready，但 docker compose up 起来会立刻 panic
（表不存在），且密码硬编码、Binance 直连超时、无 healthcheck。

修复：

1. migrate init container（migrate/migrate:v4.18.1）
   - depends_on postgres service_healthy 后执行
   - 跑完 up 退出；app depends_on migrate service_completed_successfully
   - 表不存在的 race 彻底消除

2. postgres healthcheck（pg_isready）
   - interval 5s、retries 10、start_period 10s
   - app 不再在 init 期连接失败

3. .env + .env.example（守卫 G9）
   - 密码、端口、Binance URL 全部从环境变量读
   - POSTGRES_PASSWORD 未设置时 docker-compose 直接报错退出（${VAR:?...} 语法）
   - .env 已在 .gitignore，.env.example 留作模板

4. HTTP_PROXY/HTTPS_PROXY/NO_PROXY 透传
   - 国内直连 fapi.binance.com 不稳（AGENTS.md §7.5）
   - NO_PROXY 默认包含 postgres 容器名，避免本地代理误走

附加：config 卷只读挂载（防容器内意外写入）；ports 端口可由
.env 覆盖；postgres 容器名走 docker DNS（替换之前硬编码的
crypto-hermes-postgres）。

验证：python yaml lint 通过；依赖链 postgres healthy →
migrate completed → app start 已确认。docker 在本机不可用，
线上验证留给 commit 9 之后的人工 smoke。
 2026-05-24 20:59:09 +08:00
dela
cc7f5a4f32 feat: 初始化 cryptoHermes 行情网关 v1 MVP + harness 工程文档 
Binance USDⓈ-M Futures 行情网关，给上游 Hermes 量化分析引擎提供单一聚合
接口 /v1/market/context（K 线 + funding + OI + 多空比 + taker volume）。
只读公共行情，不下单、不接私钥、不查账户。

## v1 实现范围（Milestone 1-5）

- Clean Architecture 4 层（controller/usecase/repo/entity），接口边界在
  internal/usecase/ports.go
- Binance Futures REST client（K 线 / ticker24h / funding / OI / 多空比
  / taker volume 共 9 个接口），全链路 string 价格避免 float64 精度问题
- TimescaleDB 5 张 hypertable（market_klines / funding_rates /
  open_interest / long_short_ratio / taker_buy_sell_volume），主键含
  时间维度，UpsertMany 幂等
- robfig/cron 定时采集（15m/1h/4h/1d/1w 多周期 K 线 + 衍生品 15 分钟
  落库），未收线 K 线 (close_time > now) 由 mapper/repo 双重过滤
- pkg/httpclient 统一限流（默认 20 req/s, burst 40）+ 重试，避免触发
  Binance 2400 weight/min IP 上限
- /v1/market/context 聚合接口：errgroup 并发拉 snapshot/funding/OI，DB
  K 线不足 200 根回源 Binance 异步补
- cmd/backfill CLI 支持指定 from/to 大段回填（Binance 历史 OI / 多空比
  官方只保留 30 天，必须自己存）
- Docker Compose + Makefile + golang-migrate，本地一键启

技术指标（support/resistance/Vegas/箱体）留待 v2，技术段返回空对象 +
warning 占位。

## Harness 工程文档

- AGENTS.md — AI agent 工作速查（10 个章节）
- ai/project-map.md — 仓库结构、扩展点、控制流
- ai/risk-guardrails.md — G1-G10 守卫规则（每条带可机械验证命令）
- ai/adr/0001-architecture-foundations.md — 9 条架构基础决策
- ai/task-templates.md — 6 种任务契约模板
- ai/harness-health.md — 当前 harness 健康度评估

3 个 grep 守卫已验证通过：controller / usecase 无具体实现依赖，全项目
无私钥/签名字段。
 2026-05-24 17:20:51 +08:00