feat(flutter): 앱 뼈대와 홈 이번 주말 축제·행사 화면

데이터 기반(장소·행사 조회 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>

flutter/README.md

@@ -1,17 +1,62 @@
-# tma_app
+# WanderGo 앱 (Flutter)
 
-A new Flutter project.
+대구에서 시작하는 데이트·나들이 코스 앱. 화면 디자인은 디자인 캔버스(MVP 화면 20개)를 따른다.
 
-## Getting Started
+## 실행
 
-This project is a starting point for a Flutter application.
+```bash
+cd flutter
+cp .env.example .env      # 처음 한 번 — API_URL 을 개발 백엔드 주소로
+flutter pub get           # 한/영 문구(lib/l10n/generated/)도 이때 만들어진다
+flutter run
+```
 
-A few resources to get you started if this is your first Flutter project:
+`API_URL` 은 백엔드 글로벌 prefix `/api` 까지 적는다. 포트는 루트 `.env.development` 의 `BACKEND_PORT`.
 
-- [Learn Flutter](https://docs.flutter.dev/get-started/learn-flutter)
-- [Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
-- [Flutter learning resources](https://docs.flutter.dev/reference/learning-resources)
+| 실행 환경 | API_URL 예 |
+| --- | --- |
+| Android 에뮬레이터 | `http://10.0.2.2:<BACKEND_PORT>/api` |
+| 실기기(같은 와이파이) | `http://<PC 의 사설 IP>:<BACKEND_PORT>/api` |
+| iOS 시뮬레이터 | `http://localhost:<BACKEND_PORT>/api` |
 
-For help getting started with Flutter development, view the
-[online documentation](https://docs.flutter.dev/), which offers tutorials,
-samples, guidance on mobile development, and a full API reference.
+- 평문 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`.
+
+## 검사
+
+```bash
+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()`.