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)保持一致。
This commit is contained in:
dela
2026-05-25 10:43:24 +08:00
parent fa769331c2
commit 319e73d91f
4 changed files with 53 additions and 18 deletions

View File

@@ -291,7 +291,7 @@ collector:
}
```
> `technical.*` 字段在 v1 留空。v2 会补支撑压力、箱体、多空线计算
> `technical.support/resistance/rangeHigh/rangeLow/longShortLine` 目前按 primary `1h` 计算;`technical.intervals` 已提供每周期 Bollinger / Vegas。完整 per-interval `TechnicalStructure` 与箱体突破信号仍在 v2.x 待办
### `GET /v1/market/klines?symbol=BTCUSDT&interval=1h&limit=300`
@@ -379,7 +379,7 @@ v2 第一次把测试体系立住。当前覆盖:
| 包 | 测试范围 | 覆盖率 |
|---|---|---|
| `internal/usecase` (indicator.go) | pivot S/R、percentile、LSR 穿越、聚类 全分支 | 12 个函数平均 97.7% |
| `internal/usecase` | pivot S/R、percentile、LSR 穿越、Bollinger、Vegas、derivatives signal | 算法路径有表驱动与边界用例覆盖 |
| `internal/repo/webapi/binance` (mapper.go) | `parseKlineRow``toInt64`、6 个 `map*` 函数 | 9 个函数全部 100% |
| `internal/repo/persistent/postgres` | 5 个 repo 的 `UpsertMany` + `FindRecent` 正反例pgxmock | 包级 87.6% |
@@ -391,7 +391,7 @@ make test-cover
```
测试选型说明:
- 算法(`indicator.go`)采用 table-driven + `testify/require`
- 算法(`indicator.go` / `derivatives_signal.go`)采用 table-driven + `testify/require`
- Repo 层用 [`pgxmock/v4`](https://github.com/pashagolub/pgxmock) 锁 SQL 字符串与参数顺序——schema 漂移立刻可见。
- `*pgxpool.Pool` 不能直接 mock因此 5 个 repo 的字段类型被改为内部 `pgxPool` 接口(`internal/repo/persistent/postgres/pool.go`),生产代码继续传 `*pgxpool.Pool`,调用方零改动。
- 集成测试testcontainers + 真 Postgres + 真 migration留 v2.1 做 nightly。
@@ -417,8 +417,8 @@ grep -r "repo/webapi/binance\|repo/persistent" internal/usecase # 期望: 无
# 全项目不应出现私钥/账户/签名相关字段
grep -ri "apikey\|x-mbx-apikey\|hmac" . # 期望: 无输出
# G12float64 仅允许在 indicator.go 内部
grep -rn --include="*.go" "float64\|float32" internal/usecase | grep -v indicator
# G12float64 仅允许在 indicator.go / derivatives_signal.go 内部
grep -rn --include="*.go" "float64\|float32" internal/usecase | grep -vE "indicator|derivatives_signal"
# 期望: 无输出
```
@@ -427,8 +427,13 @@ grep -rn --include="*.go" "float64\|float32" internal/usecase | grep -v indicato
## 路线图
- **v1**Binance 行情 + 衍生品 + 落库 + `/v1/market/context` 聚合接口。✅
- **v2.0(当前)**技术结构计算第一波——pivot 支撑/压力 + P95/P5 区间 + LSR 穿越价位中位数primary interval `1h`)。算法 100% 测试 + repo / mapper 关键路径测试到位。✅
- **v2.x**MA / Bollinger / Vegas / 箱体per-interval 指标(`map[interval]TechnicalStructure`testcontainers 集成测试 + CI
- **v2.0**技术结构计算第一波——pivot 支撑/压力 + P95/P5 区间 + LSR 穿越价位中位数primary interval `1h`)。算法测试 + repo / mapper 关键路径测试到位。✅
- **v2.x(当前)**:进行中
- ✅ Bollinger / Vegas 已落地到 `technical.intervals`
- ✅ Derivatives signal 已落地到 `derivatives.signal`
- ⚠️ 完整 per-interval `TechnicalStructure` 尚未升级Support / Resistance / Range / LSLine 仍只按 primary `1h` 输出。
- ⚠️ 箱体与 per-interval 突破信号未实现。
- ❌ testcontainers 集成测试 + CI 未起。
- **v3**CoinGlass 清算数据、ETF Flow、CME gap、CVD、链上稳定币流动性、宏观日历、多交易所聚合。
完整设计参见 [`docs/dev.md`](docs/dev.md)。