How icecold009/movie-tracker works
My Watch Tracker is a Flask-backed public watchlist with a password-protected single-admin workflow. Visitors browse movie and TV entries; the admin signs in to add titles, search TMDB metadata, edit ratings and status, or delete entries. The app stores watchlist data and aggregate usage counts in PostgreSQL, and offers explainable recommendations using saved genre metadata with popular-title fallback. The graph preserves the documented recommendation benchmark and browser features. Some route-to-module links rely on the SOURCE INDEX and README; unsampled implementation details are not inferred.
Main entry points: index.py Flask routes · database.py Watchlist operations · tmdb.py TMDB metadata lookup · observability.py Structured diagnostics
Components 15
Web application
- Flask routes
api/index.py - Watchlist interface
templates - Browser interactions
static/app.js - Admin session and validation
api/index.py
Watchlist domain
- Watchlist operations
database.py - PostgreSQL watchlist
- Structured diagnostics
observability.py
External services
- TMDB metadata lookup
tmdb.py - TMDB API
Recommendations and measurement
- Explainable recommendations
recommendations.py - Recommendations page
templates - Daily usage counts
database.py - Offline recommender evaluation
scripts/evaluate_recommender.py
Other components
- Public visitor
- Admin
Connections 19
- Public visitor → Flask routes: browses
README.md - Admin → Flask routes: manages watchlist
README.md - Flask routes → Admin session and validation: checks session
api/index.py - Flask routes → Watchlist interface: renders pages
api/index.py - Watchlist interface → Browser interactions: loads interactions
- Browser interactions → Flask routes: searches titles
static/app.js - Flask routes → Watchlist operations: reads and mutates
api/index.py - Watchlist operations → PostgreSQL watchlist: queries and updates
database.py - Flask routes → TMDB metadata lookup: searches titles
api/index.py - TMDB metadata lookup → TMDB API: requests metadata
tmdb.py - Flask routes → Explainable recommendations: builds suggestions
api/index.py - Flask routes → Recommendations page: renders suggestions
- Flask routes → Daily usage counts: records activity
api/index.py - Daily usage counts → PostgreSQL watchlist: increments counters
database.py - Offline recommender evaluation → Explainable recommendations: evaluates ranking
scripts/evaluate_recommender.py - Offline recommender evaluation → TMDB API: fetches catalog
scripts/evaluate_recommender.py - Flask routes → Structured diagnostics: emits events
api/index.py - Watchlist operations → Structured diagnostics: emits events
database.py - TMDB metadata lookup → Structured diagnostics: emits events
tmdb.py