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 全绿。
This commit is contained in:
@@ -159,14 +159,18 @@ acceptance:
|
||||
objective: <消除哪个边界违反 / 抽取哪段重复>
|
||||
scope: <文件列表>
|
||||
out-of-scope:
|
||||
- 不改行为(API 响应字节级一致 / DB schema 不变)
|
||||
constraints: G6
|
||||
- 行为变化(默认:API 响应字节级一致 / DB schema 不变)
|
||||
- 例外:如果重构本身是为了把不该在 controller 的"错误降级 / 响应组装"搬进 usecase,
|
||||
可以一并修响应契约(如 sub-object 的 error 字段聚合为顶层 warnings)。
|
||||
必须在 acceptance 显式标 "破坏性",并在 PR 描述列出旧 → 新字段映射。
|
||||
constraints: G6 + G11(如果动 controller)
|
||||
validation:
|
||||
- go build ./... && go vet ./...
|
||||
- 全部 grep 边界检查(AGENTS.md §6)
|
||||
- make test
|
||||
acceptance:
|
||||
- diff 中不含行为变化(只是搬代码 / 重命名 / 抽接口)
|
||||
- 默认:diff 中不含行为变化(只是搬代码 / 重命名 / 抽接口)
|
||||
- 破坏性变体:列出响应字段变化,确认上游(Hermes)消费方已知或不受影响
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user