샷 기록Shots

샷 레코드는 허브의 로컬 DB 에 먼저 저장되고 연결이 돌아오면 업로드돼요. 곡선은 10 Hz 병렬 배열이고, 허브의 Flutter 앱이 쓰는 Decent 호환 JSON 에서 필드명을 평탄화한 형태예요.

목록

GET /v1/public/shots?machine=VDAS-PRO1G-2644-9999
    &from=2026-10-01T00:00:00Z&to=2026-10-31T23:59:59Z
    &trigger=button2&min_rating=4&cursor=…&limit=50

샷 객체

{
  "id": "sh_01JB7Q",
  "machine": "VDAS-PRO1G-2644-9999",
  "device_key": "VDAS-PRO1G-2644-9999",
  "started_at": "2026-10-08T13:12:15Z",
  "duration_s": 14.0,
  "trigger": { "source": "button2", "mode": "scale" },
  "profile": "Espresso",
  "dose_g": 20.0,
  "target": { "volume_ml": null, "weight_g": 36.0 },
  "yield_g": 37.5,
  "yield_source": "scale",
  "peak": { "pressure_bar": 5.57, "flow_ml_s": 5.0 },
  "pre_shot_bar": 2.59,
  "temps": { "mix_c": 91.1, "basket_c": 87.9 },
  "rating": 4,
  "notes": "에티오피아 · 20 g · 분쇄 2.4",
  "scale": {
    "brand": "timemore", "model": "black_mirror_dot",
    "auto_stop": { "enabled": true, "reason": "target_weight", "sensitivity": 8 }
  },
  "paddle": null,
  "series": {
    "t_s":          [0.0, 0.1, 0.276, …],
    "pressure_bar": [2.59, 1.44, 0.92, …],
    "flow_ml_s":    [0.0, 0.0, 0.0, …],
    "weight_g":     [0.0, 0.0, 0.0, …],
    "temp_mix_c":   [91.1, 91.1, 91.1, …],
    "temp_basket_c":[87.9, 87.9, 87.9, …],
    "paddle_deg":   null
  }
}

단건 · 내보내기

GET /v1/public/shots/{id}                 # 항상 full
GET /v1/public/shots/{id}/export?format=decent   # Decent/Visualizer 호환 JSON
GET /v1/public/shots/export?machine=…&from=…&to=…&format=parquet   # Enterprise

Shot records are stored on the hub first and uploaded when the link is up. Curves are parallel arrays at 10 Hz, flattened from the Decent-compatible JSON the hub's Flutter app writes.

GET /v1/public/shots?machine=…&from=…&to=…&trigger=button2&min_rating=4&fields=full
GET /v1/public/shots/{id}
GET /v1/public/shots/{id}/export?format=decent