# himanshuupadhyay029-sys/dustinhub architecture

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

- Interactive diagram: https://gitdiagram.com/himanshuupadhyay029-sys/dustinhub
- Repository: https://github.com/himanshuupadhyay029-sys/dustinhub

## Overview

Dustin Hub is a movie and web-series discovery catalog with user and administrator portals. Users sign up or log in, browse and search visible titles, open details and external links, manage their list/profile, and submit requests; administrators manage catalog visibility, accounts, tiers, and requests. The React app communicates with a FastAPI API backed by PostgreSQL. The README documents the principal capabilities; UI-to-API endpoint mappings are not shown in the excerpts, so those connections are marked unverified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/App.jsx) (Route application), [`frontend/src/api/client.js`](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/api/client.js) (API client), [`backend/app/database.py`](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/database.py) (Database sessions), [`backend/app/routes/auth_routes.py`](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/routes/auth_routes.py) (Auth routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Route application<br/>[App.jsx]"]
  node_client["API client<br/>[client.js]"]
end

subgraph group_identity["Identity and access"]
  node_authui["Auth state<br/>[useAuthStore.js]"]
  node_login["User sign-in<br/>[Login.jsx]"]
  node_signup["Registration<br/>[Signup.jsx]"]
  node_adminlogin["Admin sign-in<br/>[AdminLogin.jsx]"]
  node_authroutes["Auth routes<br/>[auth_routes.py]"]
  node_authlogic["Token and access<br/>[auth.py]"]
end

subgraph group_catalog["Catalog and requests"]
  node_home["Catalog browsing<br/>[Home.jsx]"]
  node_card["Movie card<br/>[MovieCard.jsx]"]
  node_detail["Movie details<br/>[MovieDetail.jsx]"]
  node_mylist["Saved list<br/>[MyList.jsx]"]
  node_profile["User profile<br/>[Profile.jsx]"]
  node_requestsui["User requests<br/>[UserRequests.jsx]"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_adminroutes["Admin routes<br/>[admin_routes.py]"]
  node_movieroutes["Movie routes<br/>[movie_routes.py]"]
end

subgraph group_api["API and persistence"]
  node_apiapp["FastAPI application<br/>[main.py]"]
  node_schemas["API schemas<br/>[schemas.py]"]
  node_models["Domain models<br/>[models.py]"]
  node_database["Database sessions<br/>[database.py]"]
  node_postgres[("PostgreSQL")]
end

node_visitor(("User or admin"))

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_signup
node_app -->|"routes to"| node_adminlogin
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_detail
node_app -->|"routes to"| node_mylist
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_requestsui
node_app -->|"routes to"| node_adminui
node_login -->|"updates"| node_authui
node_adminlogin -->|"updates"| node_authui
node_login -->|"calls"| node_client
node_signup -->|"calls"| node_client
node_adminlogin -->|"calls"| node_client
node_client -->|"reads token"| node_authui
node_home -->|"fetches catalog"| node_client
node_home -->|"renders"| node_card
node_detail -->|"fetches details"| node_client
node_mylist -->|"calls"| node_client
node_profile -->|"calls"| node_client
node_requestsui -->|"calls"| node_client
node_adminui -->|"calls"| node_client
node_client -.->|"HTTP API"| node_apiapp
node_apiapp -->|"registers"| node_authroutes
node_apiapp -->|"registers"| node_movieroutes
node_apiapp -->|"registers"| node_adminroutes
node_authroutes -->|"gets sessions"| node_database
node_authroutes -->|"queries users"| node_models
node_authroutes -->|"authenticates"| node_authlogic
node_movieroutes -->|"gets sessions"| node_database
node_movieroutes -->|"queries catalog"| node_models
node_movieroutes -->|"checks user"| node_authlogic
node_adminroutes -->|"gets sessions"| node_database
node_adminroutes -->|"queries records"| node_models
node_adminroutes -->|"checks admin"| node_authlogic
node_authroutes -->|"validates payloads"| node_schemas
node_movieroutes -->|"validates payloads"| node_schemas
node_adminroutes -->|"validates payloads"| node_schemas
node_authlogic -->|"loads user"| node_database
node_authlogic -->|"queries user"| node_models
node_models -->|"uses base"| node_database
node_database -->|"connects"| node_postgres

click node_app "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/App.jsx"
click node_client "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/api/client.js"
click node_authui "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/store/useAuthStore.js"
click node_login "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/Login.jsx"
click node_signup "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/Signup.jsx"
click node_adminlogin "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/AdminLogin.jsx"
click node_home "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/Home.jsx"
click node_card "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/components/MovieCard.jsx"
click node_detail "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/MovieDetail.jsx"
click node_mylist "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/MyList.jsx"
click node_profile "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/Profile.jsx"
click node_requestsui "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/UserRequests.jsx"
click node_adminui "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_apiapp "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/main.py"
click node_authroutes "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/routes/auth_routes.py"
click node_adminroutes "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/routes/admin_routes.py"
click node_movieroutes "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/routes/movie_routes.py"
click node_authlogic "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/auth.py"
click node_schemas "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/schemas.py"
click node_models "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/models.py"
click node_database "https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/database.py"

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_client,node_visitor toneBlue
class node_authui,node_login,node_signup,node_adminlogin,node_authroutes,node_authlogic toneAmber
class node_home,node_card,node_detail,node_mylist,node_profile,node_requestsui,node_adminui,node_adminroutes,node_movieroutes toneMint
class node_apiapp,node_schemas,node_models,node_database,node_postgres toneRose
```

## Components

### Web application

- [Route application](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API client](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### Identity and access

- [Auth state](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/store/useAuthStore.js): `frontend/src/store/useAuthStore.js`
- [User sign-in](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Registration](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/Signup.jsx): `frontend/src/pages/Signup.jsx`
- [Admin sign-in](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/AdminLogin.jsx): `frontend/src/pages/AdminLogin.jsx`
- [Auth routes](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/routes/auth_routes.py): `backend/app/routes/auth_routes.py`
- [Token and access](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/auth.py): `backend/app/auth.py`

### Catalog and requests

- [Catalog browsing](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Movie card](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/components/MovieCard.jsx): `frontend/src/components/MovieCard.jsx`
- [Movie details](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/MovieDetail.jsx): `frontend/src/pages/MovieDetail.jsx`
- [Saved list](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/MyList.jsx): `frontend/src/pages/MyList.jsx`
- [User profile](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/Profile.jsx): `frontend/src/pages/Profile.jsx`
- [User requests](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/UserRequests.jsx): `frontend/src/pages/UserRequests.jsx`
- [Admin dashboard](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`
- [Admin routes](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/routes/admin_routes.py): `backend/app/routes/admin_routes.py`
- [Movie routes](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/routes/movie_routes.py): `backend/app/routes/movie_routes.py`

### API and persistence

- [FastAPI application](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/main.py): `backend/app/main.py`
- [API schemas](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/schemas.py): `backend/app/schemas.py`
- [Domain models](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/models.py): `backend/app/models.py`
- [Database sessions](https://github.com/himanshuupadhyay029-sys/dustinhub/blob/main/backend/app/database.py): `backend/app/database.py`
- **PostgreSQL**

### Other components

- **User or admin**

## Connections

- User or admin → Route application: uses (evidence: `frontend/src/App.jsx`)
- Route application → User sign-in: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Registration: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Admin sign-in: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Catalog browsing: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Movie details: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Saved list: routes to (evidence: `frontend/src/App.jsx`)
- Route application → User profile: routes to (evidence: `frontend/src/App.jsx`)
- Route application → User requests: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Admin dashboard: routes to (evidence: `frontend/src/App.jsx`)
- User sign-in → Auth state: updates (evidence: `frontend/src/pages/Login.jsx`)
- Admin sign-in → Auth state: updates (evidence: `frontend/src/pages/AdminLogin.jsx`)
- User sign-in → API client: calls (evidence: `frontend/src/pages/Login.jsx`)
- Registration → API client: calls (evidence: `frontend/src/pages/Signup.jsx`)
- Admin sign-in → API client: calls (evidence: `frontend/src/pages/AdminLogin.jsx`)
- API client → Auth state: reads token (evidence: `frontend/src/api/client.js`)
- Catalog browsing → API client: fetches catalog (evidence: `frontend/src/pages/Home.jsx`)
- Catalog browsing → Movie card: renders (evidence: `frontend/src/pages/Home.jsx`)
- Movie details → API client: fetches details (evidence: `frontend/src/pages/MovieDetail.jsx`)
- Saved list → API client: calls (evidence: `frontend/src/pages/MyList.jsx`)
- User profile → API client: calls (evidence: `frontend/src/pages/Profile.jsx`)
- User requests → API client: calls (evidence: `frontend/src/pages/UserRequests.jsx`)
- Admin dashboard → API client: calls (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- API client → FastAPI application: HTTP API
- FastAPI application → Auth routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Movie routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Admin routes: registers (evidence: `backend/app/main.py`)
- Auth routes → Database sessions: gets sessions (evidence: `backend/app/routes/auth_routes.py`)
- Auth routes → Domain models: queries users (evidence: `backend/app/routes/auth_routes.py`)
- Auth routes → Token and access: authenticates (evidence: `backend/app/routes/auth_routes.py`)
- Movie routes → Database sessions: gets sessions (evidence: `backend/app/routes/movie_routes.py`)
- Movie routes → Domain models: queries catalog (evidence: `backend/app/routes/movie_routes.py`)
- Movie routes → Token and access: checks user (evidence: `backend/app/routes/movie_routes.py`)
- Admin routes → Database sessions: gets sessions (evidence: `backend/app/routes/admin_routes.py`)
- Admin routes → Domain models: queries records (evidence: `backend/app/routes/admin_routes.py`)
- Admin routes → Token and access: checks admin (evidence: `backend/app/routes/admin_routes.py`)
- Auth routes → API schemas: validates payloads (evidence: `backend/app/routes/auth_routes.py`)
- Movie routes → API schemas: validates payloads (evidence: `backend/app/routes/movie_routes.py`)
- Admin routes → API schemas: validates payloads (evidence: `backend/app/routes/admin_routes.py`)
- Token and access → Database sessions: loads user (evidence: `backend/app/auth.py`)
- Token and access → Domain models: queries user (evidence: `backend/app/auth.py`)
- Domain models → Database sessions: uses base (evidence: `backend/app/models.py`)
- Database sessions → PostgreSQL: connects (evidence: `README.md`)
