← 지도 Guide
Mabinogi Shop Map 이용 가이드

Mabinogi Shop Map — 이용 가이드

이 페이지는 docs/USAGE_GUIDE.md 내용을 웹에서 보기 편하게 옮겨둔 버전입니다.
스크린샷/이미지는 필요하면 docs/assets/에 추가한 뒤, 아래 안내에 맞춰 링크를 수정해서 사용하세요.

목차

1. 사이트 소개

가이드 이미지

2. 기본 사용법(지도 탐색)

  1. 사이트에 접속하면 지도 화면이 표시됩니다.
  2. 지도는 마우스/터치로 이동 및 확대/축소가 가능합니다.
  3. 마커를 클릭하면 상세 팝업이 열립니다.
    4. 가이드 이미지

3. 검색 기능(NPC / 아이템)

결과 메타: result_type (marker/item), area_id (없으면 “위치 미상”)

4. 필터 기능(전체/NPC/몬스터/이벤트/오브젝트)

5. 마커 팝업(아이템 목록/신고)

NPC 마커를 클릭하면:

추가로 팝업에서:

6. 데이터 제보 기능

우측 상단의 “데이터 제보” 버튼을 누르면 메뉴가 열립니다.

6.1 신규 마커 추가

  1. 데이터 제보 → 신규 마커 추가 선택
  2. 원하는 위치 클릭
  3. 이름/카테고리(필수), 설명/이미지(선택) 입력
  4. 제보하기 클릭
    5. 가이드 이미지

6.2 맵 이동 영역 추가

  1. 데이터 제보 → 맵 이동 영역 추가 선택
  2. 맵에서 이동 영역(bounds) 지정
  3. 이동할 맵 ID / 새로운 맵 이미지(선택) 입력

6.3 아이템 마스터 등록

  1. 데이터 제보 → 아이템 마스터 등록 선택
  2. 아이템 이름 입력(필수)
  3. 이미지 업로드(선택)
  4. 신규 등록 클릭
    5. 가이드 이미지

6.4 아이템 이미지 수정

데이터 제보 → 아이템 이미지 수정 메뉴에서, 아이템 이름으로 기존 아이템의 이미지를 업데이트할 수 있습니다.

  1. 데이터 제보 → 아이템 이미지 수정 선택
  2. 아이템 이름 입력(자동완성에서 정확한 이름 선택 권장)
  3. “선택된 아이템: … (ID: …)” 바인딩 상태 확인
  4. 새 이미지 파일 선택
  5. 이미지 업데이트 클릭
    6. 가이드 이미지

6.5 특정 위치에 아이템 정보 제보

NPC(또는 마커) 팝업에서 “이 위치에 정보 제보” 버튼으로 제보합니다.

6.6 잘못된 아이템 정보 신고(🚨)

마커 팝업의 아이템 리스트에서 🚨 버튼으로 아이템 소스를 신고할 수 있습니다.

6.7 마커 신고(🚨) 및 자동 숨김

마커 팝업 우측 상단의 🚨 버튼으로 마커 자체를 신고할 수 있습니다.

7. 마커 위치 수정(편집 모드)

8. 자주 묻는 질문(FAQ)

Q1. 이미지가 깨져요 / 안 보여요

Q2. 검색 결과가 안 나와요

Q3. “제보하기”를 눌렀는데 반응이 없어요

9. 운영/개발자용: 실행 방법 & 환경설정

9.1 요구사항

9.2 환경 변수(.env)

.env.example을 참고해서 .env를 구성합니다.

9.3 실행

pip install -r requirements.txt
python run.py

또는 개발용:

uvicorn main:app --reload

10. 문제 해결(트러블슈팅)

10.1 /markers는 뜨는데 아이템이 비어 있어요

10.2 새로 만든 맵으로 이동이 안 돼요

10.3 제보 업로드(이미지)가 실패해요

변경 이력

목차로