영도 AI 스탬프 투어 — 트래커 (Tracker)

부산 영도를 여행자에게 안내하는 AI 로컬 가이드 앱

8. 문제가 생겼을 때

증상	해결
flutter 명령을 못 찾음	Flutter의 bin 폴더를 PATH 환경변수에 추가했는지 확인
flutter doctor에 빨간 X	그 항목의 안내대로 설치/동의 진행
지도가 안 뜸	인터넷 연결 확인, 카카오 키 확인
스탬프가 안 찍힘	위치 권한 허용 확인, 실외에서 시도, 또는 카드 길게 눌러 테스트
리더보드가 비어 있음	Firebase(5번) 연결 여부 확인

---

9. 폴더 구조 (개발자용)

lib/
  config/       
  constants/    영매기 대사, 프리셋 코스 11선, 테마
  models/       데이터 구조(장소, 추천, 코스, 기록, 조건)
  services/     장소 DB 로드, AI 추천, Firebase, 로컬 저장
  screens/      화면들(홈/조건/추천/코스/지도/완주/리더보드/기록)
  widgets/      영매기 말풍선 등 공용 위젯
test/           데이터 정합성·파서·대사 무결성 테스트
assets/         장소 DB(json), 마커/영매기 이미지

개발 중 코드 검사와 테스트:

flutter analyze   # 코드 오류 검사 (0 issues 여야 함)
flutter test      # 자동 테스트 실행