v4 → v4-1 백엔드 변경이력
백엔드 크루가 읽는 문서다. v4에서 v4-1로 무엇이 바뀌는지만 담았다. 이전 개정(v3 → v4, 2026-08-19)의 이력은 전체 변경 이력에 있다. 화면 쪽 변경은 FE 변경이력에 있다.
2026-08-31 — 계약 v4-1 · 저장 계층 V4~V9
클라 계약 — 오류 응답이 code · message · requestId 3필드가 됐고
(retryable 삭제), 오류 코드가 9종으로 늘었고,
보드 응답에 staleAt(= observedAt + 5분, BoardFreshnessPolicy 값 그대로)이 더해졌다. 이 문서와
api·request 본문의 4필드 오류 응답 서술은 옛 판이다 —
현행은 v4-fe 2.1.0 이다.
저장 계층 — 마이그레이션이 V4~V9 로 늘었다.
관측 시각의 권위는 묶음의 response_received_at 하나가 되고 행의 observed_at 열은 삭제됐다.
좌석 미상은 seat_unknown_reason 과 배타 제약으로 저장하고,
passed_stop_order(0 이상) 열이 통과 순번의 유일한 통로다.
호출 장부의 결말(outcome)은 예약 사다리까지 9값, 예보 정산 상태(scoring_state)는
5값과 라벨 불변식이 CHECK 로 조여졌다.
이 페이지는 최신 개정 하나만 담는다. 지난 개정 이력(v3 → v4 · 평가 규약 · 팀 검토 반영)은 전체 변경 이력으로 옮겼다.