해외 오락실과 한국 중심의 기본값

한국어로 해외 오락실을 읽는다고 그 장소의 시간대까지 한국으로 바뀌어서는 안 된다. 한국에서 먼저 출시한 뮤즈캣은 2025년 하반기 글로벌 확장을 시작하면서, 주소와 국가 및 시간대를 한국 기준으로 처리하던 방식을 고쳐야 했다. 주소에 외국어를 더 입력하게 하는 것만으로는 현지 날짜와 요금을 올바르게 다룰 수 없기 때문이다.

장소의 공개 조건도 살펴볼 필요가 있었다. 한국의 정보를 모으며 정한 요건을 모든 나라에 그대로 적용하면, 현지의 수집 여건과 관계없이 같은 자료를 요구하게 된다. 어느 곳에나 필요한 자료를 먼저 정하고, 지역에 따라 달라지는 요건은 따로 표현하는 편이 적절했다.

flowchart TD
    accTitle: 표시 언어와 장소 정보의 분리
    accDescr: 화면 언어는 번역을 선택하고 좌표는 국가·시간대를 정하며 두 결과를 같은 오락실 화면에서 조합한다.
    L[화면 언어] --> T[번역과 표시]
    C[장소 좌표] --> G[국가와 시간대]
    T --> A[오락실 화면]
    G --> A

좌표를 이용한 국가와 시간대 설정

시간대는 한 장소의 날짜와 시각을 해석하는 기준이다. 해외용 오락실 모델을 따로 만들기보다 기존 장소에 국가와 시간대를 명시하고, 생성이나 위치 수정 때 좌표로 지리 정보를 조회해 저장하도록 했다. 주소는 방문자가 읽는 안내에 쓰고, 좌표는 거리 계산과 장소 판정에 사용한다. 화면 언어는 이 값들과 별도로 선택한다.

예를 들어 아직 공개하지 않은 초안의 위치를 잘못 잡았다면 좌표를 고치면서 국가와 시간대도 갱신할 수 있다. 반면 이미 공개된 장소는 국가가 바뀌는 위치 수정을 막는다. 기존 문서가 다른 국가의 장소로 바뀌는 것을 피하기 위해서다. 위치와 국가가 맞지 않는 문서는 공개 전환도 진행하지 않는다.

Delta에서 사용한 기존 Gamma-Web의 2026-04-01 코드 재현 · 합성 예시 데이터. 요일별 영업시간을 펼쳐 확인하는 화면.

flowchart TD
    accTitle: 위치 수정에서 공개 여부에 따른 처리
    accDescr: 비공개 초안은 새 국가·시간대를 저장하고 공개 장소는 국가가 바뀌는 변경을 막는다.
    C[새 좌표] --> G[국가와 시간대 조회]
    G --> P{공개 장소인가}
    P -->|아니오| U[초안의 국가와 시간대 갱신]
    P -->|예| K{기존 국가와 같은가}
    K -->|예| S[허용된 위치 수정]
    K -->|아니오| B[변경 거절]

지역별 공개 조건과 기존 자료 보완

공개에는 게임 등록과 SNS 또는 영업시간이라는 공통 자료를 요구한다. 시설 사진은 한국 오락실에 필요한 조건으로 분리했다. 이렇게 하면 해외 전용 서비스나 같은 API를 새로 만들지 않아도 지역 차이를 반영할 수 있다. 조회 API의 국가 필터로 국가별 목록과 검색도 같은 백엔드에서 제공한다.

새 요청에 시간대를 저장하도록 바꿔도 기존 자료의 빈 값은 남아 있다. 이를 채우는 별도 보완 작업을 backfill이라고 한다. 시간대가 없는 레코드는 연결된 기본 정보의 좌표를 읽고, 시간대를 조회해 저장한다. 신규 저장과 이 작업을 분리하면 빠진 장소를 확인하거나 다시 처리하기 쉽다.

flowchart TD
    accTitle: 기존 오락실 시간대 채우기
    accDescr: 시간대가 없는 기존 오락실은 기본 정보의 좌표로 시간대를 조회한 뒤 값을 저장한다.
    A[시간대 없는 오락실] --> B[연결된 기본 정보]
    B --> C[좌표 읽기]
    C --> T[시간대 조회]
    T --> S[오락실 시간대 저장]

화면 언어와 현지 정보의 표시

한국어와 영어 및 일본어 중 어느 화면을 선택해도 같은 오락실의 국가와 시간대는 그 장소의 값을 유지한다. 국가별 검색과 해외 등록도 하나의 모델에서 처리할 수 있다. 새 지역을 지원할 때마다 여러 화면에 숨어 있는 한국 기준을 찾아 고치는 대신, 장소에 저장한 값과 지역별 요건을 사용할 수 있게 됐다.

대신 국가와 시간대를 구하는 지리 정보 조회가 필요해졌다. 좌표가 틀리거나 조회가 실패하면 저장과 공개 과정에서 오류를 처리해야 한다. 그럴듯한 주소만으로 값을 추측하면 잘못된 현지 정보가 남을 수 있으므로, 위치를 확인한 뒤 반영하는 방법을 택했다.

참고: 엔지니어링 기록.

관련 업데이트

• 뮤즈캣 δ7 업데이트
• 뮤즈캣³ 4월 9일 3차 업데이트