generated from ttipo/project-base
ttipo
0f306e71ba
데이터 기반(장소·행사 조회 API)이 생겨 앱 화면을 붙이기 시작한다. 디자인 캔버스의 1~7번(시작·둘러보기) 중 지금 API 로 바로 되는 것부터 만들었다. - 앱 뼈대: 디자인 캔버스의 색·글자 크기·선 아이콘을 옮긴 테마, go_router 하단 탭 (홈·지도·내 코스·내 정보 — 지도·내 코스·내 정보는 자리만), 한/영 문구(arb, 4개 언어 전제) - 첫 실행: 현재 위치를 쓰거나 대구 동네(도심·수성못·앞산 카페거리)를 고른다. 위치를 못 쓰면 대구 도심을 기준으로 시작하고 알린다. 좌표는 저장하지 않는다 - 홈 '이번 주말 축제·행사': 기준 위치 반경 120km 거리순, 비면 다가오는 30일 (2026-11-03 합의) - 행사 전체 목록(커서 페이지)·상세(시간·요금·예매·전화·소개·출처) - 한국어 문단은 단어 단위 줄바꿈(keepAll) — Flutter 기본은 글자 단위로 끊는다 - 공공누리 Type3 사진은 자르지 않고, 꼬리말에 관광공사·KOPIS·문화포털 출처를 적는다 - 한/영 생성물(lib/l10n/generated)은 flutter pub get 이 만들므로 git 에서 뺀다 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.0 KiB
3.0 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/ 축제·공연·행사·전시 목록·상세
├── l10n/ app_ko.arb · app_en.arb (생성물 generated/ 는 git 제외)
└── shared/ 여러 화면이 쓰는 위젯·유틸
규칙 메모
- 화면 문구는
lib/l10n/*.arb에만 쓴다. 출시는 한국어·영어, 설계는 en/ja/zh-Hans/zh-Hant 까지 전제. - 한국어 문단은
keepAll()을 거쳐 단어 단위로 줄바꿈한다(Flutter 기본은 글자 단위). - 카드·배지 대신 흰 바탕 위 평면 목록과 구분선, 색 글자로 메타 정보를 보인다.
- 공공누리 Type3 사진은 자르지 않는다(
EventImage가 contain 으로 보인다). - 실패 문구는 에러 사전(
error_lexicon.g.dart)에서만 가져온다 —errorMessageOf().