2026-06-24 · DEVELOPMENT RECORD

메뉴가 10개에서 205개로 늘자 화면이 달라졌다

메뉴가 열 개일 때 자연스러웠던 결과 화면은 백 개가 넘자 다른 문제를 만들었다. 데이터가 늘면 추천의 선택 폭은 넓어지지만, 이미지 누락과 속성 불일치도 함께 늘어난다.

작성 PPStudio 운영자게시 2026-06-24검토 2026-08-16

102개, 다음 날 205개: 데이터와 이미지 맞추기

6월 22일 메뉴 데이터는 102개, 다음 날에는 205개로 늘었다. 이 변화는 후보가 많아졌다는 뜻만은 아니었다. 각 메뉴의 이름, 이미지, 선택값, 점수, 설명이 같은 기준으로 유지되는지 확인하지 않으면 추천 결과는 그럴듯해 보여도 근거가 약해진다.

특히 음식 속성은 단일 정답으로 결정되지 않는 경우가 많다. 그래서 목록을 늘리는 속도보다 어떤 값이 왜 들어갔는지 다시 확인할 수 있는 흔적을 남기는 일이 중요했다.

메뉴 추가와 동시에 이미지 감사 목록, 미완료 목록, 메뉴 목록 문서를 갱신했다. 이미지가 있다는 사실만 확인하지 않고 카드에서 실제로 표시되는지까지 살폈다.

화면 쪽에서는 필터와 메뉴판의 상호작용을 조정하고 계절 결과 배경을 추가했다. 배경을 넣은 뒤에도 메뉴 이름과 설명을 읽을 수 있는지 카드에서 함께 확인했다.

메뉴 검색과 추천 계산을 함께 수정하고, 이미지 자산을 대량으로 추가했다. 점수와 선택 필터 값이 비어 있거나 배열 규칙을 지키지 않는 메뉴가 없는지 문서와 코드에서 반복 확인했다.

검증은 메뉴 수 자체보다 누락 이미지, 중복 또는 잘못된 ID, 필터별 후보 부족, 결과 카드의 읽기 흐름에 초점을 맞췄다. 이후 테스트 체크리스트가 생긴 배경도 이 시기의 반복 확인에 있다.

6월에는 메뉴 목록과 이미지 파일, 필터 값, 카드 설명을 함께 늘렸다. JSON에 메뉴가 있어도 이미지나 설명이 빠지면 카드가 완성되지 않았다. 서로 다른 파일을 대조하는 일이 많아지면서 원본에서 목록과 문서를 생성할 필요가 생겼다.

이 단계의 감사 결과는 유용했지만, 사람이 만든 목록이 또 하나의 관리 대상이 되는 문제도 만들었다. 메뉴를 수정할 때 JSON, 이미지, 문서가 함께 바뀌지 않으면 오래된 사실이 남는다.

그래서 다음 단계에서는 메뉴 원본과 파생 문서를 분리하고, 추천 로직도 화면 코드에서 떼어 내기로 했다. 데이터가 늘어난 것이 단순 확장이 아니라 구조 변경의 이유가 된 시점이다.

새 메뉴 한 건을 넣으면 ID와 이미지 경로뿐 아니라 어떤 필터의 후보가 늘었는지도 확인해야 했다. 205개를 채운 뒤에도 누락 이미지를 찾고 설명을 맞추는 작업이 남아 있었다.

당시에는 사람이 감사 목록을 갱신했다. JSON만 고치고 목록을 빠뜨리면 다음 점검에서 옛 데이터를 보게 된다. ID 중복과 필드 누락은 자동으로 검사하고, 매운맛이나 든든함 같은 속성은 사람이 판단하는 방식으로 나눌 필요가 있었다.