2023년 6월 17일
뮤즈캣 알파: 오락실 검색의 시작
45개 오락실 정보와 수정 제보를 갖춘 알파 공개.
도입
오락실 데이터
#오락실탐색
eric

게임을 고르면 가까운 오락실이 나오게 하려면 먼저 점포별 보유 게임과 위치를 갖춰야 한다. 검색 화면을 만들어도 비교할 자료가 없으면 후보를 보여줄 수 없다. 2월부터 준비한 뮤즈캣은 약 45개 오락실의 위치와 영업시간, 게임 목록, 수정 제보 통로를 마련해 6월 17일 한국에서 Alpha를 공개했다.

2023-06-17 Alpha 원본 코드 재현 · 합성 예시 데이터. 출시 당시 화면 구성으로 게임 조건과 가까운 장소를 확인한다.

초기 데이터와 관리자의 입력

위키와 공식 홈페이지의 정보가 같은 형식으로 정리돼 있는 것은 아니다. 이름과 위치, 영업시간과 보유 게임을 확인해 서비스가 읽을 수 있는 형태로 옮기는 작업이 필요했다.

3월에는 이용자가 짧은 문장으로 제보하면 관리자가 Firebase를 직접 수정했다. 내용 해석과 저장 형식을 맞추는 일을 모두 관리자가 맡았다. 두 명이 데이터를 관리하는 상황에서 같은 내용을 같은 JSON 형식으로 만들 도구도 필요해졌다.

Mermaid
flowchart TD
    accTitle: 알파의 데이터 준비
    accDescr: 흩어진 출처를 확인해 서비스에 넣고 비교할 수 있는 초기 목록을 마련한다.
    A["위키와 공개 정보 검토"] --> B
    B["위치 영업시간 게임 목록 입력"] --> C
    C["초기 오락실 목록"]

관리자용 JSON 입력 폼

JSON은 항목 이름과 값으로 데이터를 표현하는 형식이다. 예를 들어 영업시간을 입력할 때 매번 구조부터 쓰는 것보다 정해진 칸에 값을 넣으면 형식을 맞추기 쉽다. 4월에는 이런 입력에서 JSON을 생성하는 관리자 페이지를 만들었다.

처음 만든 폼은 Firebase에 직접 쓰지 않고 JSON 생성까지만 맡겼다. 직접 쓰기 권한에 따르는 보안 위험을 줄이기 위해서다. 공개를 준비하면서는 내용을 확인하고 Firebase로 전송하는 기능도 마련했다. 반영할 정보는 여전히 관리자가 판단한다.

Alpha의 관리자 입력 폼. 정해진 필드에서 반영할 JSON을 만든다.

Mermaid
flowchart TD
    accTitle: 초기 관리자 JSON 폼의 자동화 범위
    accDescr: 4월의 초기 폼은 구조화된 입력을 JSON으로 만들고 실제 반영은 관리자가 맡았다.
    A["관리자 입력"] --> B
    B["입력 구조 확인과 JSON 생성"] --> C
    C["관리자가 Firebase 반영"]

수정 제보와 신규 오락실 입력

5월부터 제보에 오락실 ID를 연결했다. 상세 화면에서는 해당 ID를 가진 제보 페이지를 연다. 변경 내용은 자유 문장으로 받으므로 어떤 게임이나 기체에 관한 수정인지는 이용자가 설명에 적어야 한다.

제출할 때는 오락실 ID와 메시지, 제출자의 익명 인증 UID, 접수 시각을 저장한다. UID는 익명으로 인증한 이용자를 구별하는 값으로, 대상 장소와 함께 요청에 붙는다. 접수한 내용을 검토하고 실제 데이터를 갱신하는 일은 관리자가 맡는다.

신규 오락실 요청에는 게임을 고르고 가격과 수량, 부가 정보를 입력하는 폼도 마련했다. 기존 내용의 정정과 달리 아직 목록에 없는 장소의 자료를 모으기 위해서다. 초기 정보는 공개 자료를 확인해 수동 입력했고, 커뮤니티 홍보와 Google Sheets로도 추가 제보를 받았다.

같은 Alpha 코드의 제보 입력 화면. 가상 오락실과 예시 문장을 사용했고, 재현 서버의 인증과 제출은 차단했다.

2023년 6월 17일 Alpha 소스의 신규 오락실 입력 화면 · 로컬 예시 입력 · 제출 비활성.

Mermaid
flowchart TD
    accTitle: 대상이 지정된 제보
    accDescr: 제보 경로의 오락실 ID에 자유 문장과 제출 정보를 연결해 접수하고 관리자가 검토한다.
    A["오락실 페이지 ID"] --> B
    B["자유 문장으로 변경 설명"] --> C
    C["대상이 지정된 제보"] --> D
    D["관리자 검토와 반영"]

Alpha 공개와 정보 갱신

공개한 목록에서는 원하는 게임이 있는 곳을 찾고 거리를 비교할 수 있다. 잘못된 내용을 발견한 이용자는 해당 오락실에 제보하고, 관리자는 폼으로 저장 형식을 맞춘다. 약 45개 오락실의 초기 자료와 수정할 통로를 함께 마련한 것이다.

게임이나 기체의 세부 내용은 제보 문장을 읽고 확인해야 한다. 요청이 늘면 이 작업이 반영을 늦출 가능성도 있다. 공개 이후에는 이용자가 필요로 하는 정보와 반복되는 오류를 보며 관리 방법을 검토하려 한다.

2023-06-17 코드의 오락실 상세. 샘플 데이터의 가격·수량을 당시 컴포넌트로 표시했다.

참고: 뮤즈캣 엔지니어링 기록.

뮤즈캣
리듬게이머의 최고의 파트너