How mmileticc/movielensbackendktor works
Movienee is a Ktor backend for movie discovery and social tracking. The main workflow serves authenticated Android requests through route modules, which combine TMDB metadata, cinema availability, AI search, and user-specific data stored in PostgreSQL. A separate scraping lifecycle gathers regional cinema listings, enriches them with TMDB IDs, persists them, and refreshes semantic indexes. The README documents these flows; some route and scraper implementations were not sampled, so their links are shown only where documented or otherwise evidenced.
Main entry points: Application.kt Ktor application · db Domain repositories · TmdbService.kt TMDB catalog · ScraperJob.kt Scraping lifecycle
Components 25
API and sessions
- Ktor application
src/main/kotlin/Application.kt - Auth and vision routes
src/main/kotlin/Routing.kt
Cinema discovery
- Scraping lifecycle
src/main/kotlin/scraping/ScraperJob.kt - Concurrent scraper engine
src/main/kotlin/scraping/ScrapingEngineConcurrent.kt - Cinema chain scrapers
src/main/kotlin/scraping/scraper - Cinema listings
src/main/kotlin/scraping/model/ScrapedMovie.kt - Semantic cinema index
src/main/kotlin/services/CinemaSemanticIndex.kt
Movie services
- Movie routes
src/main/kotlin/MovieRouting.kt - Gemini AI
src/main/kotlin/services/GeminiService.kt - TMDB catalog
src/main/kotlin/services/TmdbService.kt - OMDb ratings
src/main/kotlin/services/OmdbService.kt
Social and personalization
- User action routes
src/main/kotlin/UserActionsRouting.kt - Friend routes
src/main/kotlin/FriendsRouting.kt - Comment routes
src/main/kotlin/CommentsRouting.kt - Taste profiles
src/main/kotlin/db/TasteProfileRepository.kt - Sharing and notifications
src/main/kotlin
Persistence
- Domain repositories
src/main/kotlin/db - Database tables
src/main/kotlin/db - PostgreSQL
Other components
- Android app
- Cinema websites
- Google Gemini API
- TMDB API
- OMDb API
- Firebase services
Connections 37
- Android app → Ktor application: sends requests
README.md - Ktor application → Auth and vision routes: registers routes
README.md - Ktor application → Movie routes: registers routes
README.md - Ktor application → User action routes: registers routes
README.md - Ktor application → Friend routes: registers routes
README.md - Ktor application → Comment routes: registers routes
README.md - Ktor application → Scraping lifecycle: starts lifecycle
README.md - Scraping lifecycle → Concurrent scraper engine: runs scrapers
README.md - Concurrent scraper engine → Cinema chain scrapers: dispatches concurrently
README.md - Cinema chain scrapers → Cinema websites: scrapes listings
README.md - Concurrent scraper engine → Cinema listings: produces listings
src/main/kotlin/scraping/ScrapingEngineConcurrent.kt - Scraping lifecycle → TMDB catalog: enriches movie IDs
README.md - Scraping lifecycle → Domain repositories: persists listings
README.md - Scraping lifecycle → Semantic cinema index: refreshes index
README.md - Semantic cinema index → Domain repositories: loads listings
README.md - Semantic cinema index → Google Gemini API: embeds text
src/main/kotlin/services/CinemaSemanticIndex.kt - Auth and vision routes → Gemini AI: recognizes images
README.md - Auth and vision routes → TMDB catalog: resolves candidates
README.md - Auth and vision routes → Semantic cinema index: searches repertoire
README.md - Movie routes → TMDB catalog: fetches movie data
src/main/kotlin/MovieRouting.kt - Movie routes → OMDb ratings: fetches ratings
src/main/kotlin/MovieRouting.kt - Movie routes → Taste profiles: gets genre affinities
src/main/kotlin/MovieRouting.kt - Movie routes → Domain repositories: reads movie data
src/main/kotlin/MovieRouting.kt - User action routes → Domain repositories: stores user actions
src/main/kotlin/UserActionsRouting.kt - User action routes → TMDB catalog: caches movie details
src/main/kotlin/UserActionsRouting.kt - Friend routes → Domain repositories: manages friendships
src/main/kotlin/FriendsRouting.kt - Friend routes → Taste profiles: compares tastes
src/main/kotlin/FriendsRouting.kt - Friend routes → TMDB catalog: fetches movie data
src/main/kotlin/FriendsRouting.kt - Comment routes → Domain repositories: manages comments
- Ktor application → Domain repositories: initializes services
src/main/kotlin/Application.kt - Domain repositories → Database tables: queries and updates
src/main/kotlin/db/UserActionsRepository.kt - Database tables → PostgreSQL: stores records
src/main/kotlin/db/DatabaseFactory.kt - Ktor application → Firebase services: initializes admin SDK
src/main/kotlin/Application.kt - Ktor application → TMDB API: warms API client
README.md - Gemini AI → Google Gemini API: calls model API
src/main/kotlin/services/GeminiService.kt - TMDB catalog → TMDB API: requests catalog data
src/main/kotlin/services/TmdbService.kt - OMDb ratings → OMDb API: requests ratings
src/main/kotlin/services/OmdbService.kt