convez.ai
PluginIntegração & APIsAvançado
ChooJeongHo

MovieFinder - App Android de Busca de Filmes

ChooJeongHo/MovieFinder

Busca de filmes com TMDB, arquitetura limpa e testes robustos

Ver no GitHub
InicialPluginScore · de 0 a 100

Aplicativo 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/MovieFinder

1 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

Estrelas
1
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 3 dias
Versão
v1.0.0
Issues abertas
49
Contribuidores
3

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 앱

CI License minSdk Kotlin AGP

Clean Architecture + MVVM 패턴 기반으로, 오프라인 캐시, 다크 모드, 페이징, 딥링크 등 실무 수준의 기능을 구현했습니다.


🤖 AI 활용 하이라이트

이 프로젝트는 단순한 앱이 아니라, AI 기반 개발 워크플로우를 직접 실험한 결과물입니다.

실험 내용도구BeforeAfter
시청 통계 기능 전체 설계 및 구현Claude Code기능 없음UseCase 49개, Repository 11개 인터페이스
PR 코드 리뷰 자동화GitHub Actions + Claude API수동 리뷰PR 생성 시 자동 리뷰 코멘트 게시
테스트 커버리지 개선Claude Code + JaCoCo미측정 (0%)Line 68% / Branch 62% 달성
유닛 테스트 작성Claude Code0개509개 자동 작성
라이브러리 보안 취약점 분석Exa MCP미점검실시간 웹 검색으로 실제 버그 발견
think / ultra think 프롬프트 비교Claude Code단일 분석4에이전트 병렬, 30개+ 이슈 자동 발견

📂 실험 전체 기록: AI-dev-notes

Screenshots

HomeSearch (Grid)Search (List)DetailFavoriteSettings

Tech Stack

CategoryStack
LanguageKotlin 2.3.21
BuildAGP 9.2.0, Gradle 9.3.1, KSP 2.3.6
UIXML Layouts, ViewBinding, Material Components 1.13.0
ArchitectureClean Architecture, MVVM
DIHilt 2.59.2
NetworkRetrofit 3.0.0, OkHttp 5.3.2, kotlinx.serialization 1.11.0
DatabaseRoom 2.8.4, Typed DataStore 1.2.1
AsyncCoroutines, Flow, StateFlow, Channel
PagingPaging 3.4.2, RemoteMediator
ImageCoil 3.4.0
NavigationNavigation Component 2.9.8, Safe Args
SecurityCertificate Pinning (OkHttp), EncryptedSharedPreferences
BackgroundWorkManager 2.11.2
TestJUnit 4, MockK 1.14.9, Turbine 1.2.1 (509개 유닛 + 23개 Espresso)
CI/CDGitHub Actions (Build / Test / Coverage / Cert Pinning)
Static AnalysisDetekt 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 프레임워크 의존성 없음
RepositoryISP 원칙 기반 도메인별 분리 (11개 인터페이스)
PresentationDomain 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.ymlpush / PR → mainDetekt → Lint → Build → Test → JaCoCo
cert-pin-check.yml매주 월요일인증서 핀 검증, 불일치 시 Issue 생성
pr-coverage.ymlPR → main커버리지 리포트 PR 코멘트 자동 게시
Pre-commit Hookgit commitDetekt + 컴파일 체크
Pre-push Hookgit 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

Ver o original no GitHub

Bom para

Relacionados