# laurynast/filmsite architecture

> Architecture diagram of the GitHub repository laurynast/filmsite, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/laurynast/filmsite
- Repository: https://github.com/laurynast/filmsite

## Overview

FilmSite is a full-stack movie and TV discovery platform. Users browse, search, and inspect titles and people; signed-in users can manage favorites and watchlists, while recommendations draw on favorite history and AI analysis. The frontend routes pages to browsing and detail experiences and uses API services; the ASP.NET backend exposes catalog, account, and collection endpoints, with PostgreSQL-backed state and TMDB/OpenAI integrations. Some backend wiring and frontend-to-backend requests are not shown in the excerpts, so those links are marked unverified or omitted.

Main entry points: [`FilmSiteAPI/Program.cs`](https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Program.cs) (Web API host), [`FilmSite/src/api/Api.ts`](https://github.com/laurynast/filmsite/blob/main/FilmSite/src/api/Api.ts) (API client), [`FilmSite/src/Pages`](https://github.com/laurynast/filmsite/tree/main/FilmSite/src/Pages) (Browse pages), [`FilmSiteAPI/DbContext/AppDbContext.cs`](https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/DbContext/AppDbContext.cs) (Application database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["App shell<br/>[App.tsx]"]
  node_routes["Page routing<br/>[Routes.tsx]"]
  node_pages["Browse pages"]
  node_searchui["Search interface<br/>[Search.tsx]"]
  node_detailui["Title details"]
  node_authui["Account pages<br/>[Login.tsx]"]
  node_dashboard["User dashboard<br/>[Dashboard.tsx]"]
  node_webapi["API client<br/>[Api.ts]"]
end

subgraph group_catalog["Catalog and discovery"]
  node_moviefetch["Movie data"]
  node_tvfetch["TV data<br/>[tmdbTvService.ts]"]
  node_searchfetch["Search data"]
  node_aiui["AI search<br/>[AiSearch.jsx]"]
end

subgraph group_backend["API and identity"]
  node_api["Web API host<br/>[Program.cs]"]
  node_catalogcontrollers["Catalog endpoints"]
  node_auth["Authentication<br/>[AuthController.cs]"]
end

subgraph group_personal["Personalization and state"]
  node_favorites["Favorites<br/>[FavoriteService.cs]"]
  node_watchlist["Watchlist"]
  node_recommendations["Recommendations"]
  node_db[("Application database<br/>[AppDbContext.cs]")]
end

subgraph group_integrations["External data"]
  node_tmdb["TMDB"]
  node_openai["OpenAI"]
  node_openaisvc["AI service<br/>[OpenAiService.cs]"]
end

node_visitor(("Viewer"))

node_visitor -.->|"uses"| node_app
node_app -->|"renders"| node_routes
node_routes -->|"routes to"| node_pages
node_pages -.->|"uses"| node_searchui
node_pages -.->|"uses"| node_detailui
node_pages -.->|"includes"| node_dashboard
node_routes -->|"routes to"| node_authui
node_searchui -.->|"requests"| node_searchfetch
node_aiui -.->|"uses"| node_webapi
node_moviefetch -->|"calls"| node_webapi
node_tvfetch -.->|"calls"| node_webapi
node_searchfetch -->|"calls"| node_webapi
node_webapi -.->|"HTTP requests"| node_api
node_api -->|"maps endpoints"| node_catalogcontrollers
node_api -.->|"maps endpoints"| node_auth
node_api -->|"registers service"| node_favorites
node_api -->|"registers service"| node_watchlist
node_catalogcontrollers -.->|"fetches catalog"| node_tmdb
node_auth -->|"reads/writes"| node_db
node_favorites -->|"reads/writes"| node_db
node_watchlist -->|"reads/writes"| node_db
node_recommendations -.->|"reads history"| node_db
node_recommendations -.->|"requests analysis"| node_openaisvc
node_openaisvc -.->|"analyzes"| node_openai
node_recommendations -.->|"uses history"| node_favorites

click node_app "https://github.com/laurynast/filmsite/blob/main/FilmSite/src/App.tsx"
click node_routes "https://github.com/laurynast/filmsite/blob/main/FilmSite/src/Routes/Routes.tsx"
click node_pages "https://github.com/laurynast/filmsite/tree/main/FilmSite/src/Pages"
click node_searchui "https://github.com/laurynast/filmsite/blob/main/FilmSite/src/components/search/Search.tsx"
click node_detailui "https://github.com/laurynast/filmsite/tree/main/FilmSite/src/components/details"
click node_authui "https://github.com/laurynast/filmsite/blob/main/FilmSite/src/Pages/Login.tsx"
click node_dashboard "https://github.com/laurynast/filmsite/blob/main/FilmSite/src/Pages/Dashboard.tsx"
click node_webapi "https://github.com/laurynast/filmsite/blob/main/FilmSite/src/api/Api.ts"
click node_moviefetch "https://github.com/laurynast/filmsite/blob/main/FilmSite/src/services/tmdbMovieService.ts"
click node_tvfetch "https://github.com/laurynast/filmsite/blob/main/FilmSite/src/services/tmdbTvService.ts"
click node_searchfetch "https://github.com/laurynast/filmsite/blob/main/FilmSite/src/services/tmdbSearchService.ts"
click node_aiui "https://github.com/laurynast/filmsite/blob/main/FilmSite/src/Pages/AiSearch.jsx"
click node_api "https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Program.cs"
click node_catalogcontrollers "https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Controllers/TmdbMovieController.cs"
click node_auth "https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Controllers/AuthController.cs"
click node_favorites "https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Services/FavoriteService.cs"
click node_watchlist "https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Services/WatchListService.cs"
click node_recommendations "https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Controllers/RecommendationsController.cs"
click node_db "https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/DbContext/AppDbContext.cs"
click node_openaisvc "https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Services/OpenAiService.cs"

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_routes,node_pages,node_searchui,node_detailui,node_authui,node_dashboard,node_webapi,node_visitor toneBlue
class node_moviefetch,node_tvfetch,node_searchfetch,node_aiui toneAmber
class node_api,node_catalogcontrollers,node_auth toneMint
class node_favorites,node_watchlist,node_recommendations,node_db toneRose
class node_tmdb,node_openai,node_openaisvc toneIndigo
```

## Components

### Web experience

- [App shell](https://github.com/laurynast/filmsite/blob/main/FilmSite/src/App.tsx): `FilmSite/src/App.tsx`
- [Page routing](https://github.com/laurynast/filmsite/blob/main/FilmSite/src/Routes/Routes.tsx): `FilmSite/src/Routes/Routes.tsx`
- [Browse pages](https://github.com/laurynast/filmsite/tree/main/FilmSite/src/Pages): `FilmSite/src/Pages`
- [Search interface](https://github.com/laurynast/filmsite/blob/main/FilmSite/src/components/search/Search.tsx): `FilmSite/src/components/search/Search.tsx`
- [Title details](https://github.com/laurynast/filmsite/tree/main/FilmSite/src/components/details): `FilmSite/src/components/details`
- [Account pages](https://github.com/laurynast/filmsite/blob/main/FilmSite/src/Pages/Login.tsx): `FilmSite/src/Pages/Login.tsx`
- [User dashboard](https://github.com/laurynast/filmsite/blob/main/FilmSite/src/Pages/Dashboard.tsx): `FilmSite/src/Pages/Dashboard.tsx`
- [API client](https://github.com/laurynast/filmsite/blob/main/FilmSite/src/api/Api.ts): `FilmSite/src/api/Api.ts`

### Catalog and discovery

- [Movie data](https://github.com/laurynast/filmsite/blob/main/FilmSite/src/services/tmdbMovieService.ts): `FilmSite/src/services/tmdbMovieService.ts`
- [TV data](https://github.com/laurynast/filmsite/blob/main/FilmSite/src/services/tmdbTvService.ts): `FilmSite/src/services/tmdbTvService.ts`
- [Search data](https://github.com/laurynast/filmsite/blob/main/FilmSite/src/services/tmdbSearchService.ts): `FilmSite/src/services/tmdbSearchService.ts`
- [AI search](https://github.com/laurynast/filmsite/blob/main/FilmSite/src/Pages/AiSearch.jsx): `FilmSite/src/Pages/AiSearch.jsx`

### API and identity

- [Web API host](https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Program.cs): `FilmSiteAPI/Program.cs`
- [Catalog endpoints](https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Controllers/TmdbMovieController.cs): `FilmSiteAPI/Controllers/TmdbMovieController.cs`
- [Authentication](https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Controllers/AuthController.cs): `FilmSiteAPI/Controllers/AuthController.cs`

### Personalization and state

- [Favorites](https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Services/FavoriteService.cs): `FilmSiteAPI/Services/FavoriteService.cs`
- [Watchlist](https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Services/WatchListService.cs): `FilmSiteAPI/Services/WatchListService.cs`
- [Recommendations](https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Controllers/RecommendationsController.cs): `FilmSiteAPI/Controllers/RecommendationsController.cs`
- [Application database](https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/DbContext/AppDbContext.cs): `FilmSiteAPI/DbContext/AppDbContext.cs`

### External data

- **TMDB**
- **OpenAI**
- [AI service](https://github.com/laurynast/filmsite/blob/main/FilmSiteAPI/Services/OpenAiService.cs): `FilmSiteAPI/Services/OpenAiService.cs`

### Other components

- **Viewer**

## Connections

- Viewer → App shell: uses
- App shell → Page routing: renders (evidence: `FilmSite/src/App.tsx`)
- Page routing → Browse pages: routes to (evidence: `FilmSite/src/Routes/Routes.tsx`)
- Browse pages → Search interface: uses
- Browse pages → Title details: uses
- Browse pages → User dashboard: includes
- Page routing → Account pages: routes to (evidence: `FilmSite/src/Routes/Routes.tsx`)
- Search interface → Search data: requests
- AI search → API client: uses
- Movie data → API client: calls (evidence: `FilmSite/src/services/tmdbMovieService.ts`)
- TV data → API client: calls (evidence: `FilmSite/src/services/tmdbTvService.ts`)
- Search data → API client: calls (evidence: `FilmSite/src/services/tmdbSearchService.ts`)
- API client → Web API host: HTTP requests
- Web API host → Catalog endpoints: maps endpoints (evidence: `FilmSiteAPI/Program.cs`)
- Web API host → Authentication: maps endpoints
- Web API host → Favorites: registers service (evidence: `FilmSiteAPI/Program.cs`)
- Web API host → Watchlist: registers service (evidence: `FilmSiteAPI/Program.cs`)
- Catalog endpoints → TMDB: fetches catalog
- Authentication → Application database: reads/writes (evidence: `FilmSiteAPI/Controllers/AuthController.cs`)
- Favorites → Application database: reads/writes (evidence: `FilmSiteAPI/Services/FavoriteService.cs`)
- Watchlist → Application database: reads/writes (evidence: `FilmSiteAPI/Services/WatchListService.cs`)
- Recommendations → Application database: reads history (evidence: `FilmSiteAPI/Controllers/RecommendationsController.cs`)
- Recommendations → AI service: requests analysis (evidence: `README.md`)
- AI service → OpenAI: analyzes (evidence: `README.md`)
- Recommendations → Favorites: uses history (evidence: `README.md`)
