[🛠] 과거 Daily Review를 깨뜨리지 않는 몸 기록 버전 라우팅

✨ GPT-5.6 Sol의 요약 　

몸 기록 UI를 계속 고치다 과거 일기가 최신 구조와 충돌할 수 있다는 문제를 발견하고, schema_version 하나로 renderer·schema·validator를 같은 버전에 묶은 기록.

body_review 버전은 있었지만 렌더러가 쓰지 않았다

블로그 안에 다이어트/식단 앱 MVP를 만든 뒤, 접힌 화면의 오늘과 최근 7일을 나누고 펼친 카드가 좁은 폭에서도 깨지지 않게 손봤다. 코칭 판정의 흰색 별도 몸 기록과 같은 별점으로 맞췄다.

그런데 화면을 계속 고치다 보니 더 큰 문제가 보였다. front matter에는 이미 schema_version이 있었지만, 실제 _includes/body-review.html은 그 값을 보지 않고 최신 구조를 바로 렌더링하고 있었다. 나중에 데이터 구조를 바꾸면 과거 Daily Review도 최신 renderer로 들어와 깨질 수 있었다.

schema_version으로 vN renderer를 바로 찾는다

body-review.html에는 버전별 case when을 늘어놓지 않았다. 숫자로 경로를 만들고 그 파일을 바로 부르게 했다.

{%- assign schema_version = review.schema_version | plus: 0 -%}
{%- capture renderer_path -%}body-review/v{{ schema_version }}.html{%- endcapture -%}
{% include {{ renderer_path }} review=review %}

v4면 body-review/v4.html, v100이면 body-review/v100.html로 간다. v101부터 막히는 상한도 없다. 해당 버전 파일이 실제로 있으면 같은 규칙으로 연결되고, 없으면 최신 버전으로 조용히 넘기지 않고 build가 실패한다.

renderer·schema·validator를 같은 번호로 묶었다

화면만 버전화하면 입력 검사가 다시 엇갈릴 수 있다. 그래서 한 버전은 세 파일을 한 묶음으로 갖게 했다.

_includes/body-review/v4.html
_project/blog-system/body-review-schemas/v4.yml
_project/blog-system/body-review-validators/v4.rb

검사기는 저장소에 있는 모든 vN을 찾아 세 파일 중 하나라도 없거나 renderer의 body-review--vN 표식이 빠지면 실패한다. 새 데이터 구조가 필요할 때만 다음 버전을 추가하고, 이미 공개된 글은 자신이 선언한 버전으로 계속 해석한다.

v4에는 당장 거슬리던 화면도 같이 정리했다. 접힌 요약은 오늘과 최근 7일을 서로 다른 행으로 나눴고, 펼친 카드는 component 폭에 따라 3열에서 2열, 다시 1열로 바뀐다. 몸 기록과 코칭 판정은 같은 별점 include를 사용하고, UI 문구와 접근성 label도 활성 언어별 data에서 가져온다.

이제 단순한 문구나 style 수정은 v4 안에서 고치면 된다. 반대로 data shape를 깨는 변경이라면 새 vN 묶음을 추가한다. 최신 화면을 만들 때 과거 일기까지 한꺼번에 다시 뜯어고칠 필요가 없어졌다.