generated from ttipo/project-base
ttipo
af1a0f26fc
백엔드 AI 코스 API(4–6단계)를 앱에서 쓸 수 있게 화면 8–10 을 붙였다(설계 ai-course §14 7단계). - 기반: 첫 실행 때 만든 기기 ID 를 안전 저장소에 두고 X-Device-Id 로 보낸다(비로그인 하루 횟수 기준). 앱 언어를 Accept-Language 로 보내 AI 문구 언어를 맞춘다 - 홈 'AI에게 코스 맡기기' → 입력(8): 문장을 1초 멈추면 조건을 해석해 줄마다 채우고 고칠 수 있다. 서버와 같은 조건 규칙을 앱에서도 먼저 본다. 하루 횟수를 다 썼으면 만들지 않고 안내한다 - 만드는 중(9): 1.5초마다 진행을 조회한다. 나가면 취소하고(차감 없음), 만들던 생성 id 를 남겨 앱을 다시 켜거나 AI_004 를 받으면 이어 본다 - 결과(10): 사실 값 · 경고 · 이동 · 바꾸기 후보(한 번에 한 곳, 횟수 안 듦) · 평가 · 다시 만들기(확인 뒤 차감) · 출처와 AI 생성 표시. 요청 칸과 다시 만들기는 이 기기에서 입력한 생성일 때만 보인다 - 디자인 캔버스와 맞춤: 결과의 코스 제목은 빼고 'AI 추천 코스'와 요약으로 시작한다(사용자 결정). 마스코트 그림을 홈 · 입력 · 만드는 중 · 결과 · 횟수 소진에 넣었다 - 화면 전체를 못 불러왔을 때의 공통 오류 화면(그림 · 다시 시도 · 오류 코드와 추적 ID)을 만들어 만드는 중 화면에 쓴다 코스로 저장 · 지도 미리보기 · 홈의 비 소식 줄 · 횟수 소진의 로그인 버튼은 그 기능이 생기면 붙인다. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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 으로 보인다 — 행사·장소 사진 모두 이 위젯을 거친다). - 사진은 화면에 그릴 크기로 줄여 푼다(
PublicImage→decodeWidthFor). 공연 포스터는 목록 썸네일도 원본(최대 9MB)이라 그대로 풀면 메모리를 많이 쓴다. - 영업시간을 모르는 장소는 "영업시간 미확인 · 방문 전 확인"으로 보이고, 확인 안 된 상가정보 매장은 "함께 가기 좋은 곳"에 고르지 않는다
(서버가
trusted=true로 거른다 — 앱에서 거르면 상가가 빽빽한 도심에서 칸이 비었다). Semantics(excludeSemantics: true)로 버튼을 감싸면 안쪽 InkWell 의 누르기 동작까지 지워진다. Semantics 에도onTap을 같이 준다 (빠뜨리면 TalkBack·VoiceOver 로 누를 수 없다 —widget_test.dart의 화면 읽기 테스트가 잡는다).- 현재 위치를 받지 못하거나 서비스 지역(대구,
kServiceArea) 밖이면 대구 도심을 기준으로 쓰고 홈에서 이유를 한 번 알린다(BasePoint.fallback). - 실패 문구는 에러 사전(
error_lexicon.g.dart)에서만 가져온다 —errorMessageOf().