MovieFinder - App Android de Busca de Filmes
ChooJeongHo/MovieFinder
Busca de filmes com TMDB, arquitetura limpa e testes robustos
Ver no GitHubAplicativo Android nativo em Kotlin que integra a TMDB API para busca e descoberta de filmes com arquitetura limpa (Clean Architecture + MVVM). Implementa recursos de produção como cache offline, dark mode, paginação infinita, deep linking e testes com 509 casos unitários. Projeto notável por documentar experimentações com IA (Claude, GitHub Actions) no desenvolvimento mobile.
Instalação
npx convez-ai ChooJeongHo/MovieFinder1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Desenvolver apps mobile Android com arquitetura profissional
- Integrar APIs REST (TMDB) em aplicações Kotlin
- Implementar padrões de cache offline e paginação
- Automatizar revisão de código e testes com IA
Veredito

Repositório técnico de alto nível para desenvolvimento Android com Clean Architecture e MVVM. Valor adicional significativo na documentação de workflows com IA (Claude para design de features, PR reviews automáticos, geração de testes). Referência prática para padrões mobile enterprise, embora foco principal seja Android nativo, não plugin/skill Claude.
README
A tradução para o português deste README ainda está na fila.
MovieFinder
TMDB API를 활용한 영화 검색 Android 앱
Clean Architecture + MVVM 패턴 기반으로, 오프라인 캐시, 다크 모드, 페이징, 딥링크 등 실무 수준의 기능을 구현했습니다.
🤖 AI 활용 하이라이트
이 프로젝트는 단순한 앱이 아니라, AI 기반 개발 워크플로우를 직접 실험한 결과물입니다.
| 실험 내용 | 도구 | Before | After |
|---|---|---|---|
| 시청 통계 기능 전체 설계 및 구현 | Claude Code | 기능 없음 | UseCase 49개, Repository 11개 인터페이스 |
| PR 코드 리뷰 자동화 | GitHub Actions + Claude API | 수동 리뷰 | PR 생성 시 자동 리뷰 코멘트 게시 |
| 테스트 커버리지 개선 | Claude Code + JaCoCo | 미측정 (0%) | Line 68% / Branch 62% 달성 |
| 유닛 테스트 작성 | Claude Code | 0개 | 509개 자동 작성 |
| 라이브러리 보안 취약점 분석 | Exa MCP | 미점검 | 실시간 웹 검색으로 실제 버그 발견 |
| think / ultra think 프롬프트 비교 | Claude Code | 단일 분석 | 4에이전트 병렬, 30개+ 이슈 자동 발견 |
📂 실험 전체 기록: AI-dev-notes
Screenshots
| Home | Search (Grid) | Search (List) | Detail | Favorite | Settings |
|---|---|---|---|---|---|
Tech Stack
| Category | Stack |
|---|---|
| Language | Kotlin 2.3.21 |
| Build | AGP 9.2.0, Gradle 9.3.1, KSP 2.3.6 |
| UI | XML Layouts, ViewBinding, Material Components 1.13.0 |
| Architecture | Clean Architecture, MVVM |
| DI | Hilt 2.59.2 |
| Network | Retrofit 3.0.0, OkHttp 5.3.2, kotlinx.serialization 1.11.0 |
| Database | Room 2.8.4, Typed DataStore 1.2.1 |
| Async | Coroutines, Flow, StateFlow, Channel |
| Paging | Paging 3.4.2, RemoteMediator |
| Image | Coil 3.4.0 |
| Navigation | Navigation Component 2.9.8, Safe Args |
| Security | Certificate Pinning (OkHttp), EncryptedSharedPreferences |
| Background | WorkManager 2.11.2 |
| Test | JUnit 4, MockK 1.14.9, Turbine 1.2.1 (509개 유닛 + 23개 Espresso) |
| CI/CD | GitHub Actions (Build / Test / Coverage / Cert Pinning) |
| Static Analysis | Detekt 2.0.0-alpha.2 + KtLint |
Architecture
API/DB → Repository → UseCase → ViewModel → Fragment (XML UI)
app/src/main/java/com/choo/moviefinder/
├── core/ # 공유 유틸리티 (ErrorMessageProvider, NetworkMonitor, 알림)
├── data/ # 데이터 레이어 (Room, Retrofit, PagingSource, RemoteMediator)
├── domain/ # 도메인 레이어 (Model, Repository 인터페이스, UseCase 49개)
├── presentation/ # 프레젠테이션 레이어 (Fragment, ViewModel, Adapter)
├── di/ # Hilt DI 모듈
├── MainActivity.kt
└── MovieFinderApp.kt
| 레이어 | 규칙 |
|---|---|
| Domain | 순수 Kotlin, Android 프레임워크 의존성 없음 |
| Repository | ISP 원칙 기반 도메인별 분리 (11개 인터페이스) |
| Presentation | Domain UseCase에만 의존, Data 레이어 직접 참조 금지 |
Features
| 화면 | 주요 기능 |
|---|---|
| 홈 | 현재 상영작 / 인기 영화 / 트렌딩 탭, Paging 3 무한 스크롤, 오프라인 캐시 (RemoteMediator), 최근 본 영화 |
| 검색 | 실시간 검색 (debounce), 연도 / 장르 / 정렬 필터, Discover 모드, 그리드 ↔ 리스트 전환, 배우 검색 |
| 영화 상세 | 출연진 / 추천 영화 / 리뷰 / 예고편 (YouTube 연결), 즐겨찾기 / 워치리스트, 내 평점, 메모, 스트리밍 정보, Shared Element Transition |
| 배우 상세 | 프로필, 바이오그래피, 필모그래피 |
| 시리즈 | 영화 컬렉션 (시리즈) 조회 |
| 즐겨찾기 | 즐겨찾기 / 워치리스트 탭, 스와이프 삭제 + Undo, 정렬, 태그, 워치리스트 개봉일 알림 |
| 설정 | 테마 / 언어 전환, 시청 목표, 데이터 백업 (JSON), TMDB 계정 연결 |
| 통계 | 시청 편수, 평균 별점, 장르 파이차트, 월별 바차트, 평점 히스토그램, 캘린더 히트맵 |
| 온보딩 | 첫 실행 시 3페이지 온보딩 화면 |
| 알림 이력 | 예약된 개봉일 알림 목록 조회 및 취소 |
기타
- 홈 화면 위젯 (인기 영화 Top 10, 1시간 자동 갱신)
- 개봉일 알림 / 시청 목표 달성 알림 (WorkManager)
- 딥링크:
moviefinder://movie/{id},moviefinder://person/{id},moviefinder://stats - 한국어 + 영어 다국어 지원 (Per-App Language)
- Baseline Profiles (19,760 rules)
Testing
유닛 테스트 509개 + Espresso UI 테스트 23개 | Line Coverage 68% | Branch Coverage 62%
# 유닛 테스트
./gradlew testDebugUnitTest
# UI 테스트 (에뮬레이터/실기기 필요)
./gradlew connectedDebugAndroidTest
# 커버리지 리포트 (최소 50% 기준)
./gradlew jacocoTestReport
CI/CD
| 워크플로우 | 트리거 | 내용 |
|---|---|---|
android-ci.yml | push / PR → main | Detekt → Lint → Build → Test → JaCoCo |
cert-pin-check.yml | 매주 월요일 | 인증서 핀 검증, 불일치 시 Issue 생성 |
pr-coverage.yml | PR → main | 커버리지 리포트 PR 코멘트 자동 게시 |
| Pre-commit Hook | git commit | Detekt + 컴파일 체크 |
| Pre-push Hook | git push | 유닛 테스트 전체 실행 |
Setup
1. API Key 발급
TMDB에서 API 키를 발급받습니다.
2. local.properties 설정
TMDB_API_KEY=your_api_key_here
3. 빌드
./gradlew assembleDebug
4. 딥링크 테스트 (adb)
adb shell am start -a android.intent.action.VIEW -d "moviefinder://movie/550"
adb shell am start -a android.intent.action.VIEW -d "moviefinder://person/6193"
adb shell am start -a android.intent.action.VIEW -d "moviefinder://stats"
CI/CD 사용 시 GitHub Secrets에
TMDB_API_KEY등록 필요
Requirements
- Android Studio (AGP 9.2.0+)
- JDK 21+
- minSdk 24 / targetSdk 36
License
MIT License