# kmodipa/the-movie-database-project architecture

> Architecture diagram of the GitHub repository kmodipa/the-movie-database-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kmodipa/the-movie-database-project
- Repository: https://github.com/kmodipa/the-movie-database-project

## Overview

This is a movie-browsing and favorites web application: users browse or search movie listings, inspect movie details, authenticate, and manage a personal favorites list. An Angular client calls The MovieDB for movie data and a Node/Express API for account and favorites operations, with Sequelize-backed persistence. The README documents the major screens and features; source excerpts confirm key client requests and favorites flows. Some component-to-service and server route wiring is not excerpted, so those relationships are marked unverified where appropriate.

Main entry points: [`Front-End/The-Movie-Database-Project/src/app/Services/MoviesService/movies-service.service.ts`](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Services/MoviesService/movies-service.service.ts) (Movie service), [`Front-End/The-Movie-Database-Project/src/app/Services/AccountsService/accounts-service.service.ts`](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Services/AccountsService/accounts-service.service.ts) (Accounts service), [`Front-End/The-Movie-Database-Project/src/app/Components/accounts/login/login.component.ts`](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/accounts/login/login.component.ts) (Login screen), [`Front-End/The-Movie-Database-Project/src/app/app.module.ts`](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/app.module.ts) (Angular app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_app["Angular app<br/>[app.module.ts]"]
  node_environment["API configuration<br/>[environment.ts]"]
end

subgraph group_movie["Movie discovery"]
  node_home["Movie landing"]
  node_favorites["Favorites page"]
  node_moviecard["Movie card"]
  node_movieapi["Movie service"]
  node_search["Search messaging"]
  node_moviemodel["Movie model<br/>[MovieModel.ts]"]
  node_favrequest["Favorite request"]
  node_favresponse["Favorite response"]
end

subgraph group_account["Accounts and UI"]
  node_login["Login screen<br/>[login.component.ts]"]
  node_register["Registration screen"]
  node_contact["Contact page"]
  node_modal["Modal service<br/>[modal.service.ts]"]
  node_notify["Notifications"]
  node_accountapi["Accounts service"]
  node_usermodel["User model<br/>[UserModel.ts]"]
end

subgraph group_backend["Node API and storage"]
  node_server["Express server<br/>[index.js]"]
  node_userapi["User endpoints<br/>[user.js]"]
  node_moviebackend["Movie endpoints<br/>[movie.js]"]
  node_usermodeldb["User persistence<br/>[UserModel.js]"]
  node_moviemodeldb["Movie persistence<br/>[MovieModel.js]"]
  node_db["Sequelize connection<br/>[db.js]"]
end

node_visitor(("Movie viewer"))
node_tmdb["The MovieDB"]
node_mysql[("MySQL database")]

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_favorites
node_home -->|"requests listings"| node_movieapi
node_home -->|"subscribes to"| node_search
node_favorites -->|"loads favorites"| node_movieapi
node_moviecard -.->|"manages favorites"| node_movieapi
node_moviecard -.->|"opens details"| node_modal
node_movieapi -->|"fetches movies"| node_tmdb
node_movieapi -->|"reads endpoints"| node_environment
node_movieapi -->|"sends favorites"| node_moviebackend
node_movieapi -->|"types results"| node_moviemodel
node_movieapi -->|"sends request"| node_favrequest
node_movieapi -->|"types response"| node_favresponse
node_login -.->|"authenticates"| node_accountapi
node_register -.->|"registers"| node_accountapi
node_accountapi -->|"reads endpoint"| node_environment
node_accountapi -->|"accepts user data"| node_usermodel
node_accountapi -->|"calls account routes"| node_userapi
node_login -.->|"uses modal"| node_modal
node_login -.->|"shows status"| node_notify
node_visitor -->|"views contact"| node_contact
node_server -->|"registers routes"| node_userapi
node_server -->|"registers routes"| node_moviebackend
node_userapi -->|"uses model"| node_usermodeldb
node_moviebackend -->|"uses model"| node_moviemodeldb
node_usermodeldb -->|"uses connection"| node_db
node_moviemodeldb -->|"uses connection"| node_db
node_db -->|"connects to"| node_mysql

click node_app "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/app.module.ts"
click node_home "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/landing-page/landing-page.component.ts"
click node_favorites "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/movie-favorites/movie-favorites.component.ts"
click node_moviecard "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/landing-page/movie-card/movie-card.component.ts"
click node_movieapi "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Services/MoviesService/movies-service.service.ts"
click node_search "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Services/SearchService/search-service.service.ts"
click node_moviemodel "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Core/Models/MovieModel.ts"
click node_favrequest "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Core/Models/FavoriteMovieRequestModel.ts"
click node_favresponse "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Core/Models/FavoriteMoviesResponseModel.ts"
click node_login "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/accounts/login/login.component.ts"
click node_register "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/accounts/register/register.component.ts"
click node_contact "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/contact-us/contact-us.component.ts"
click node_modal "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/_modal/modal.service.ts"
click node_notify "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Services/ToasterNotificationService/toaster-notification-service.service.ts"
click node_accountapi "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Services/AccountsService/accounts-service.service.ts"
click node_usermodel "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Core/Models/UserModel.ts"
click node_environment "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/environments/environment.ts"
click node_server "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Back-End/index.js"
click node_userapi "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Back-End/api/user.js"
click node_moviebackend "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Back-End/api/movie.js"
click node_usermodeldb "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Back-End/model/UserModel.js"
click node_moviemodeldb "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Back-End/model/MovieModel.js"
click node_db "https://github.com/kmodipa/the-movie-database-project/blob/Dev/Back-End/connection/db.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_environment,node_visitor toneBlue
class node_home,node_favorites,node_moviecard,node_movieapi,node_search,node_moviemodel,node_favrequest,node_favresponse,node_mysql toneAmber
class node_login,node_register,node_contact,node_modal,node_notify,node_accountapi,node_usermodel toneMint
class node_server,node_userapi,node_moviebackend,node_usermodeldb,node_moviemodeldb,node_db toneRose
class node_tmdb toneIndigo
```

## Components

### Angular client

- [Angular app](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/app.module.ts): `Front-End/The-Movie-Database-Project/src/app/app.module.ts`
- [API configuration](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/environments/environment.ts): `Front-End/The-Movie-Database-Project/src/environments/environment.ts`

### Movie discovery

- [Movie landing](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/landing-page/landing-page.component.ts): `Front-End/The-Movie-Database-Project/src/app/Components/landing-page/landing-page.component.ts`
- [Favorites page](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/movie-favorites/movie-favorites.component.ts): `Front-End/The-Movie-Database-Project/src/app/Components/movie-favorites/movie-favorites.component.ts`
- [Movie card](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/landing-page/movie-card/movie-card.component.ts): `Front-End/The-Movie-Database-Project/src/app/Components/landing-page/movie-card/movie-card.component.ts`
- [Movie service](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Services/MoviesService/movies-service.service.ts): `Front-End/The-Movie-Database-Project/src/app/Services/MoviesService/movies-service.service.ts`
- [Search messaging](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Services/SearchService/search-service.service.ts): `Front-End/The-Movie-Database-Project/src/app/Services/SearchService/search-service.service.ts`
- [Movie model](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Core/Models/MovieModel.ts): `Front-End/The-Movie-Database-Project/src/app/Core/Models/MovieModel.ts`
- [Favorite request](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Core/Models/FavoriteMovieRequestModel.ts): `Front-End/The-Movie-Database-Project/src/app/Core/Models/FavoriteMovieRequestModel.ts`
- [Favorite response](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Core/Models/FavoriteMoviesResponseModel.ts): `Front-End/The-Movie-Database-Project/src/app/Core/Models/FavoriteMoviesResponseModel.ts`

### Accounts and UI

- [Login screen](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/accounts/login/login.component.ts): `Front-End/The-Movie-Database-Project/src/app/Components/accounts/login/login.component.ts`
- [Registration screen](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/accounts/register/register.component.ts): `Front-End/The-Movie-Database-Project/src/app/Components/accounts/register/register.component.ts`
- [Contact page](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/contact-us/contact-us.component.ts): `Front-End/The-Movie-Database-Project/src/app/Components/contact-us/contact-us.component.ts`
- [Modal service](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Components/_modal/modal.service.ts): `Front-End/The-Movie-Database-Project/src/app/Components/_modal/modal.service.ts`
- [Notifications](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Services/ToasterNotificationService/toaster-notification-service.service.ts): `Front-End/The-Movie-Database-Project/src/app/Services/ToasterNotificationService/toaster-notification-service.service.ts`
- [Accounts service](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Services/AccountsService/accounts-service.service.ts): `Front-End/The-Movie-Database-Project/src/app/Services/AccountsService/accounts-service.service.ts`
- [User model](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Front-End/The-Movie-Database-Project/src/app/Core/Models/UserModel.ts): `Front-End/The-Movie-Database-Project/src/app/Core/Models/UserModel.ts`

### Node API and storage

- [Express server](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Back-End/index.js): `Back-End/index.js`
- [User endpoints](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Back-End/api/user.js): `Back-End/api/user.js`
- [Movie endpoints](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Back-End/api/movie.js): `Back-End/api/movie.js`
- [User persistence](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Back-End/model/UserModel.js): `Back-End/model/UserModel.js`
- [Movie persistence](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Back-End/model/MovieModel.js): `Back-End/model/MovieModel.js`
- [Sequelize connection](https://github.com/kmodipa/the-movie-database-project/blob/Dev/Back-End/connection/db.js): `Back-End/connection/db.js`

### Other components

- **Movie viewer**
- **The MovieDB**
- **MySQL database**

## Connections

- Movie viewer → Angular app: uses
- Angular app → Movie landing: routes to
- Angular app → Favorites page: routes to
- Movie landing → Movie service: requests listings (evidence: `Front-End/The-Movie-Database-Project/src/app/Components/landing-page/landing-page.component.ts`)
- Movie landing → Search messaging: subscribes to (evidence: `Front-End/The-Movie-Database-Project/src/app/Components/landing-page/landing-page.component.ts`)
- Favorites page → Movie service: loads favorites (evidence: `Front-End/The-Movie-Database-Project/src/app/Components/movie-favorites/movie-favorites.component.ts`)
- Movie card → Movie service: manages favorites (evidence: `Front-End/The-Movie-Database-Project/src/app/Components/landing-page/movie-card/movie-card.component.ts`)
- Movie card → Modal service: opens details
- Movie service → The MovieDB: fetches movies (evidence: `Front-End/The-Movie-Database-Project/src/app/Services/MoviesService/movies-service.service.ts`)
- Movie service → API configuration: reads endpoints (evidence: `Front-End/The-Movie-Database-Project/src/app/Services/MoviesService/movies-service.service.ts`)
- Movie service → Movie endpoints: sends favorites (evidence: `Front-End/The-Movie-Database-Project/src/app/Services/MoviesService/movies-service.service.ts`)
- Movie service → Movie model: types results (evidence: `Front-End/The-Movie-Database-Project/src/app/Services/MoviesService/movies-service.service.ts`)
- Movie service → Favorite request: sends request (evidence: `Front-End/The-Movie-Database-Project/src/app/Services/MoviesService/movies-service.service.ts`)
- Movie service → Favorite response: types response (evidence: `Front-End/The-Movie-Database-Project/src/app/Services/MoviesService/movies-service.service.ts`)
- Login screen → Accounts service: authenticates (evidence: `Front-End/The-Movie-Database-Project/src/app/Components/accounts/login/login.component.ts`)
- Registration screen → Accounts service: registers (evidence: `Front-End/The-Movie-Database-Project/src/app/Components/accounts/register/register.component.ts`)
- Accounts service → API configuration: reads endpoint (evidence: `Front-End/The-Movie-Database-Project/src/app/Services/AccountsService/accounts-service.service.ts`)
- Accounts service → User model: accepts user data (evidence: `Front-End/The-Movie-Database-Project/src/app/Services/AccountsService/accounts-service.service.ts`)
- Accounts service → User endpoints: calls account routes (evidence: `Front-End/The-Movie-Database-Project/src/app/Services/AccountsService/accounts-service.service.ts`)
- Login screen → Modal service: uses modal
- Login screen → Notifications: shows status (evidence: `Front-End/The-Movie-Database-Project/src/app/Components/accounts/login/login.component.ts`)
- Movie viewer → Contact page: views contact
- Express server → User endpoints: registers routes (evidence: `Back-End/index.js`)
- Express server → Movie endpoints: registers routes (evidence: `Back-End/index.js`)
- User endpoints → User persistence: uses model (evidence: `Back-End/api/user.js`)
- Movie endpoints → Movie persistence: uses model (evidence: `Back-End/api/movie.js`)
- User persistence → Sequelize connection: uses connection (evidence: `Back-End/model/UserModel.js`)
- Movie persistence → Sequelize connection: uses connection (evidence: `Back-End/model/MovieModel.js`)
- Sequelize connection → MySQL database: connects to
