Obito1903 / what2watch

Movie Finder

Architecture

Solution

• Frontend
  • Svelte
    • shadcn
• API
  • FastAPI
• Recommendation Engine
  • Go
• Database
  • MariaDB
• Caching
  • Redis
  • Go-Proxy-Cache
• Auth & Idp
  • Keycloak
• Deployment
  • Docker
  • Docker Compose
  • Traefik
• Observability
  • Prometheus
  • Grafana
  • Loki
  • Grafana-Agent

Instructions

To start the service, get a TMDB api key by logging in and going to this page. Then you can execute export TMDB_API_KEY=YOUR_TMDB_API_KEY.

Then, to start the service, simply execute docker compose up --build. Wait until all the services are started, then head to http://what2watch.localhost/.

Website navigation

There you will be prompted to login. You can register a new account, and then you will be redirected to the website.

The first tab is the movie tab. It allows you to browse the top and popular movies, and to rate them by clicking "View details", then selecting a note from 1 to 5 and then clicking "Add to my movies".

You can also add your preferred genres by clicking on the icon at the top right of the page, and clicking "Preferences". In this page you can add genres to your favourite genres.

In the second tab you can browse the movies you added to your list. You can also remove a movie from your list.

Then, there is the recommendations page. But first, you need to create a group in the "Group" tab. To do that simply enter the group name, and click the "Create group" button. Then you can add people to the group by clicking "Add someone to this group", and entering the email address they used to register to this website. If you want locally to test with multiple users, you can create multiple accounts.

Once your group is created, you can go to the recommendations page, and click on the "Get recommendations" button in the group that you want to get recommendations for.