Files
wandergo/flutter/README.md
T
ttipo 5caed15482 fix(flutter): 함께 가기 좋은 곳을 서버 trusted 조건으로 받아 도심에서도 채움
출처와 상관없이 가까운 30곳을 받아 관광공사·확인 장소만 고르던 것을 서버 조건(trusted)으로 바꿨다.
도심에서는 받은 30곳이 모두 상가라 칸이 비었다(봉산서원 0곳 → 6곳, 김광석길 2곳 → 6곳).
자기 자신이 섞여 오므로 보일 수(6)보다 하나 더 받는다.

백엔드 trusted 조건(fix/place-hours-and-nearby)이 먼저 배포되어야 한다 — 모르는 조건은 400 이다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 00:00:14 +09:00

3.6 KiB

WanderGo 앱 (Flutter)

대구에서 시작하는 데이트·나들이 코스 앱. 화면 디자인은 디자인 캔버스(MVP 화면 20개)를 따른다.

실행

cd flutter
cp .env.example .env      # 처음 한 번 — API_URL 을 개발 백엔드 주소로
flutter pub get           # 한/영 문구(lib/l10n/generated/)도 이때 만들어진다
flutter run

API_URL 은 백엔드 글로벌 prefix /api 까지 적는다. 포트는 루트 .env.development 의 BACKEND_PORT.

실행 환경 API_URL 예
Android 에뮬레이터 http://10.0.2.2:<BACKEND_PORT>/api
실기기(같은 와이파이) http://<PC 의 사설 IP>:<BACKEND_PORT>/api
iOS 시뮬레이터 http://localhost:<BACKEND_PORT>/api
  • 평문 HTTP 는 디버그 빌드에서만 허용된다(android/app/src/debug/AndroidManifest.xml, iOS 는 로컬 네트워크만).
  • 개발 백엔드는 루트에서 docker compose -f docker-compose.yml -f docker-compose.dev.yml --env-file .env.development up -d.

검사

flutter analyze   # Warning 0
flutter test

CI(.github/workflows/ci-flutter.yml)는 flutter/ 가 바뀐 커밋에서만 돈다.

구조

lib/
├── main.dart · app.dart          앱 시작 · 테마/언어/화면 이동 연결
├── core/
│   ├── api/                      Dio + 응답 언래핑·에러 코드 (템플릿)
│   ├── router/                   go_router — 경로 상수(app_routes) · 하단 탭 틀(app_shell)
│   ├── theme/                    색(AppColors) · 테마(AppTheme) — 디자인 캔버스 값
│   ├── l10n/                     context.l10n · 앱 언어 선택
│   ├── storage/                  shared_preferences (민감하지 않은 설정만)
│   ├── icons/                    디자인 캔버스의 선 아이콘(SVG)
│   └── utils/                    순수 함수 — 거리·기간 표기, 주말 계산, 직선 거리·도보 시간, 한국어 줄바꿈(keepAll)
├── features/
│   ├── onboarding/               첫 실행 · 위치 권한
│   ├── location/                 기준 위치(현재 위치 / 대구 동네)
│   ├── home/                     홈 — 검색창·카테고리·축제·반려동물 장소 칸
│   ├── event/                    축제·공연·행사·전시 목록·상세
│   └── place/                    장소 검색·상세 (domain/ 에 검색 조건·공공데이터 원문 해석)
├── l10n/                         app_ko.arb · app_en.arb (생성물 generated/ 는 git 제외)
└── shared/                       여러 화면이 쓰는 위젯·유틸·출처 모델(공공누리 유형·출처 표기)

규칙 메모

  • 화면 문구는 lib/l10n/*.arb 에만 쓴다. 출시는 한국어·영어, 설계는 en/ja/zh-Hans/zh-Hant 까지 전제.
  • 한국어 문단은 keepAll() 을 거쳐 단어 단위로 줄바꿈한다(Flutter 기본은 글자 단위).
  • 카드·배지 대신 흰 바탕 위 평면 목록과 구분선, 색 글자로 메타 정보를 보인다.
  • 공공누리 Type3 사진은 자르지 않는다(PublicImage 가 contain 으로 보인다 — 행사·장소 사진 모두 이 위젯을 거친다).
  • 영업시간을 모르는 장소는 "영업시간 미확인 · 방문 전 확인"으로 보이고, 확인 안 된 상가정보 매장은 "함께 가기 좋은 곳"에 고르지 않는다 (서버가 trusted=true 로 거른다 — 앱에서 거르면 상가가 빽빽한 도심에서 칸이 비었다).
  • 실패 문구는 에러 사전(error_lexicon.g.dart)에서만 가져온다 — errorMessageOf().