carrydela/cryptoHermes
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
23 Commits 1 Branch 0 Tags
b15d763287d9e558a00b1bcd351b234dfb159a62
Commit Graph
10 Commits
Author SHA1 Message Date
dela 1b61541ff5 feat: 接入 CoinGlass 清算热力图隔离链路
ci / build + vet + guard + race (push) Has been cancelled
Details
2026-05-25 16:57:22 +08:00
dela 21b3078094 feat(indicator): per-interval S/R + Range + LSLine + Donchian 箱体（ADR-0003） 
按 ADR-0003 把 Support / Resistance / Range / LSLine 从顶层下沉进
IntervalTechnicals，每个周期独立计算；顶层 5 字段保留为 Intervals[primary]
镜像（单一来源，不双写）以维持向后兼容的 JSON shape。

新增 BoxBreak（Donchian 风格，lookback=20 根不含当前根，K 线 < 21 → nil），
落到 IntervalTechnicals.Box。

IndicatorComputer.Compute 签名升级到 longShortByInterval map：
market_context 改为并发拉取 15m/1h/4h/1d 的全局 LSR，1w 不在 Binance LSR
支持列表 → 加 warning lsr_unsupported_interval:1w。

测试：boxBreak 6 个 case（inside/break_up/break_down/insufficient/2 个 parse
失败）+ per-interval Support/Resistance/Range 跨周期断言 + 镜像不变量 +
缺 LSR key → LongShortLine nil。indicator.go 平均覆盖 97.26%（boxBreak 100%）。
 2026-05-25 10:44:33 +08:00
dela 319e73d91f docs: v2.x 状态对齐 — dev.md 标废弃 + AGENTS/harness-health 更新 
dev.md 是 v1 设计稿但路线图已与 README 冲突；加废弃声明 + 优先级表，
指向 README / AGENTS / ai/adr 作为权威来源。AGENTS §2 与 harness-health
同步 v2.x 进度（Bollinger / Vegas / derivatives signal ✅；per-interval
完整化 + 箱体 + CI 未完）。README 路线图分段 v2.0/v2.x/v3，与 G12 守卫
扩白名单（derivatives_signal.go）保持一致。
 2026-05-25 10:43:24 +08:00
dela fa769331c2 feat(market): Phase 1 扩展 — 更多 symbol + Bollinger/Vegas + 衍生品信号 
- collector.symbols 与 supportedSymbols 加 SOL/BNB/DOGE，env-default 与 README 同步
- entity 追加 TechnicalStructure.Intervals（每周期 Bollinger + Vegas，omitempty 不破坏既有字段）与 DerivativesBundle.Signal
- 新增纯解析 usecase derivatives_signal.go：fundingBias 绝对阈值、oiSignal 用 P20 baseline + 价格方向（OI up + 价格 up/down → long/short_building，funding 不参与方向）、lsrRegime 绝对阈值；signal 数据不足走 warnings 进 DataQuality
- indicator.go 加 sma/stddev/ema/bollinger/vegas + computeIntervalTechnicals；IndicatorComputer 签名收 klines map
- harness 同步：G12 扩入 derivatives_signal.go（含 Makefile G12.5/6 + ADR-0002 适用范围 + project-map / harness-health 更新）
 2026-05-24 23:19:57 +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 c6c25d1a45 chore(harness): ADR-0002 + G12 立指标计算的 float64 边界 
为什么：Milestone 6 引入 transient float64 用于 pivot/percentile/median
计算。G2 早已预留"统计中间过程可用 float64"的例外，但缺可机械验证
的边界。本提交把例外落地为：
- ADR-0002 记录"为什么不用 shopspring/decimal"
- G12 给出 4 条 grep 守卫（usecase float 仅限 indicator.go、
  indicator.go 不依赖 repo、不依赖 binance/postgres/pgx、entity
  仍禁 float）

代码无改动；下一 commit 开始铺 indicator.go 骨架。
 2026-05-24 20:10:13 +08:00
dela f3dc4d0939 refactor: 把 /derivatives 的多源编排从 controller 搬进 usecase 
为什么：原 controller handler 在 HTTP 层同时承担了 4 项 usecase 职责
（多源拼装、错误降级策略、limit 硬编码、响应结构组装），违反了
"controller 只做参数解析 + 调用 + 序列化" 的边界。等后续给衍生品加
缓存 / taker volume / 数据质量字段时，HTTP 层会持续变厚。

改动：
- 新增 internal/usecase/market_query.go: MarketQueryUsecase.GetDerivatives()
  并发拉 current funding/OI + 串行查历史 + 错误聚合为 warnings 返回
- /derivatives handler 退化到 4 行；MarketDeps / restapi.Deps 同步收窄
- /klines 保持直查 KlineRepo（thin query，G11 例外）
- 新增 G11 守卫：grep "FundingRepo|OIRepo|LSRepo|TakerRepo" internal/controller

破坏性 API 变更（/derivatives 响应）：
- 删除 funding.error / openInterest.error
- 新增顶层 warnings: []string
顶层 symbol / funding / openInterest / longShortRatio / takerBuySellVolume 保持。

harness 同步：
- AGENTS.md §6 加 G11 grep
- ai/project-map.md 加 market_query.go + /derivatives 数据流分支
- ai/task-templates.md T6 加"破坏性变体"分支（本次重构暴露了原假设过严）
- ai/harness-health.md W1 记一次轻量验证 + 守卫数 10→11

验收: go build / go vet / G6 grep / G11 grep 全绿。
 2026-05-24 17:51:11 +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