# oyo1505/admin-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/oyo1505/admin-dashboard
- Repository: https://github.com/oyo1505/admin-dashboard

## Overview

Nūberu Bāgu is a multilingual film-catalogue and administration platform. Viewers browse and search films, inspect details, and manage favorites; administrators manage catalogue metadata, users, analytics, and media uploads. The graph follows the documented user and admin workflows and includes the sampled authentication, data-access, and upload layers. Some pages and API routes were not sampled, so those links reflect README-documented capabilities rather than inspected route wiring.

Main entry points: [`src/app/dashboard/(dashboard)/page.tsx`](https://github.com/oyo1505/admin-dashboard/blob/main/src/app/dashboard/(dashboard)/page.tsx) (Admin Dashboard), [`src/lib/data/movies.ts`](https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/data/movies.ts) (Movie Data), [`src/lib/auth.ts`](https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/auth.ts) (Authentication), [`src/domains/dashboard/hooks/useUploadToGoogleDrive.ts`](https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/dashboard/hooks/useUploadToGoogleDrive.ts) (Upload Interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalogue["Film Catalogue"]
  node_catalogue_pages["Catalogue Pages<br/>[page.tsx]"]
  node_search_filters["Search and Filters<br/>[search-movie.tsx]"]
  node_movie_details["Movie Details<br/>[page.tsx]"]
  node_movie_actions["Movie Actions<br/>[movie.ts]"]
  node_movie_service["Movie Service<br/>[movie.service.ts]"]
  node_movie_data["Movie Data<br/>[movies.ts]"]
  node_movie_model["Movie Model<br/>[movie.ts]"]
  node_movie_store["Movie State<br/>[movie-store.tsx]"]
end

subgraph group_identity["Identity and Access"]
  node_auth_flow["Authentication<br/>[auth.ts]"]
  node_email_access["Email Authorization"]
  node_access_checks["Access Checks<br/>[auth.ts]"]
end

subgraph group_administration["Administration"]
  node_admin_pages["Admin Dashboard<br/>[page.tsx]"]
  node_admin_actions["Admin Management<br/>[movie.ts]"]
  node_analytics["Usage Analytics"]
end

subgraph group_media["Media Uploads"]
  node_upload_ui["Upload Interface"]
  node_upload_routes["Upload API<br/>[route.ts]"]
  node_upload_service["Drive Upload Service"]
  node_upload_state["Upload State<br/>[upload-store.tsx]"]
end

subgraph group_foundation["Application Foundation"]
  node_api_errors["API Error Handling<br/>[api-wrapper.ts]"]
  node_database[("PostgreSQL via Prisma<br/>[prisma.ts]")]
  node_google_api["Google API Client<br/>[google-api.ts]"]
end

node_viewer(("Viewer"))
node_admin(("Administrator"))
node_google_drive[("Google Drive")]

node_viewer -->|"browses"| node_catalogue_pages
node_catalogue_pages -->|"offers search"| node_search_filters
node_viewer -->|"searches films"| node_search_filters
node_viewer -->|"opens details"| node_movie_details
node_viewer -->|"manages favorites"| node_movie_store
node_admin -->|"signs in"| node_auth_flow
node_auth_flow -->|"validates email"| node_email_access
node_email_access -->|"reads and writes"| node_database
node_admin_pages -.->|"requires access"| node_access_checks
node_admin -->|"manages catalogue"| node_admin_pages
node_admin_pages -->|"manages films"| node_admin_actions
node_admin_pages -->|"views statistics"| node_analytics
node_movie_details -.->|"loads movie"| node_movie_actions
node_movie_actions -.->|"delegates"| node_movie_service
node_movie_service -->|"uses data access"| node_movie_data
node_movie_data -->|"queries"| node_database
node_movie_data -->|"uses types"| node_movie_model
node_admin -->|"uploads media"| node_upload_ui
node_upload_ui -->|"updates state"| node_upload_state
node_upload_ui -.->|"sends upload"| node_upload_routes
node_upload_routes -->|"verifies admin"| node_access_checks
node_upload_routes -->|"calls service"| node_upload_service
node_upload_service -->|"uses credentials"| node_google_api
node_upload_service -->|"uploads files"| node_google_drive
node_auth_flow -->|"stores auth data"| node_database
node_api_errors -.->|"wraps API errors"| node_movie_service

click node_catalogue_pages "https://github.com/oyo1505/admin-dashboard/blob/main/src/app/movies/page.tsx"
click node_search_filters "https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/movies/components/search-movie/search-movie.tsx"
click node_movie_details "https://github.com/oyo1505/admin-dashboard/blob/main/src/app/movies/%5Bname%5D/page.tsx"
click node_movie_actions "https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/movies/actions/movie.ts"
click node_movie_service "https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/movies/services/movie.service.ts"
click node_movie_data "https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/data/movies.ts"
click node_movie_model "https://github.com/oyo1505/admin-dashboard/blob/main/src/models/movie/movie.ts"
click node_auth_flow "https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/auth.ts"
click node_email_access "https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/auth/services/email-authorization.service.ts"
click node_access_checks "https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/data/dal/core/auth.ts"
click node_admin_pages "https://github.com/oyo1505/admin-dashboard/blob/main/src/app/dashboard/(dashboard)/page.tsx"
click node_admin_actions "https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/dashboard/actions/movie.ts"
click node_analytics "https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/dashboard/services/analytics.service.ts"
click node_upload_ui "https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/dashboard/hooks/useUploadToGoogleDrive.ts"
click node_upload_routes "https://github.com/oyo1505/admin-dashboard/blob/main/src/app/api/upload/google-drive/route.ts"
click node_upload_service "https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/dashboard/services/google-drive-upload.service.ts"
click node_upload_state "https://github.com/oyo1505/admin-dashboard/blob/main/src/store/upload/upload-store.tsx"
click node_movie_store "https://github.com/oyo1505/admin-dashboard/blob/main/src/store/movie/movie-store.tsx"
click node_api_errors "https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/api-wrapper.ts"
click node_database "https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/prisma.ts"
click node_google_api "https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/google-api.ts"

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_catalogue_pages,node_search_filters,node_movie_details,node_movie_actions,node_movie_service,node_movie_data,node_movie_model,node_movie_store,node_viewer toneBlue
class node_auth_flow,node_email_access,node_access_checks,node_google_drive toneAmber
class node_admin_pages,node_admin_actions,node_analytics toneMint
class node_upload_ui,node_upload_routes,node_upload_service,node_upload_state toneRose
class node_api_errors,node_database,node_google_api,node_admin toneIndigo
```

## Components

### Film Catalogue

- [Catalogue Pages](https://github.com/oyo1505/admin-dashboard/blob/main/src/app/movies/page.tsx): `src/app/movies/page.tsx`
- [Search and Filters](https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/movies/components/search-movie/search-movie.tsx): `src/domains/movies/components/search-movie/search-movie.tsx`
- [Movie Details](https://github.com/oyo1505/admin-dashboard/blob/main/src/app/movies/%5Bname%5D/page.tsx): `src/app/movies/[name]/page.tsx`
- [Movie Actions](https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/movies/actions/movie.ts): `src/domains/movies/actions/movie.ts`
- [Movie Service](https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/movies/services/movie.service.ts): `src/domains/movies/services/movie.service.ts`
- [Movie Data](https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/data/movies.ts): `src/lib/data/movies.ts`
- [Movie Model](https://github.com/oyo1505/admin-dashboard/blob/main/src/models/movie/movie.ts): `src/models/movie/movie.ts`
- [Movie State](https://github.com/oyo1505/admin-dashboard/blob/main/src/store/movie/movie-store.tsx): `src/store/movie/movie-store.tsx`

### Identity and Access

- [Authentication](https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Email Authorization](https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/auth/services/email-authorization.service.ts): `src/domains/auth/services/email-authorization.service.ts`
- [Access Checks](https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/data/dal/core/auth.ts): `src/lib/data/dal/core/auth.ts`

### Administration

- [Admin Dashboard](https://github.com/oyo1505/admin-dashboard/blob/main/src/app/dashboard/(dashboard)/page.tsx): `src/app/dashboard/(dashboard)/page.tsx`
- [Admin Management](https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/dashboard/actions/movie.ts): `src/domains/dashboard/actions/movie.ts`
- [Usage Analytics](https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/dashboard/services/analytics.service.ts): `src/domains/dashboard/services/analytics.service.ts`

### Media Uploads

- [Upload Interface](https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/dashboard/hooks/useUploadToGoogleDrive.ts): `src/domains/dashboard/hooks/useUploadToGoogleDrive.ts`
- [Upload API](https://github.com/oyo1505/admin-dashboard/blob/main/src/app/api/upload/google-drive/route.ts): `src/app/api/upload/google-drive/route.ts`
- [Drive Upload Service](https://github.com/oyo1505/admin-dashboard/blob/main/src/domains/dashboard/services/google-drive-upload.service.ts): `src/domains/dashboard/services/google-drive-upload.service.ts`
- [Upload State](https://github.com/oyo1505/admin-dashboard/blob/main/src/store/upload/upload-store.tsx): `src/store/upload/upload-store.tsx`

### Application Foundation

- [API Error Handling](https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/api-wrapper.ts): `src/lib/api-wrapper.ts`
- [PostgreSQL via Prisma](https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- [Google API Client](https://github.com/oyo1505/admin-dashboard/blob/main/src/lib/google-api.ts): `src/lib/google-api.ts`

### Other components

- **Viewer**
- **Administrator**
- **Google Drive**

## Connections

- Viewer → Catalogue Pages: browses (evidence: `README.md`)
- Catalogue Pages → Search and Filters: offers search (evidence: `README.md`)
- Viewer → Search and Filters: searches films (evidence: `README.md`)
- Viewer → Movie Details: opens details (evidence: `README.md`)
- Viewer → Movie State: manages favorites (evidence: `README.md`)
- Administrator → Authentication: signs in (evidence: `README.md`)
- Authentication → Email Authorization: validates email (evidence: `src/lib/auth.ts`)
- Email Authorization → PostgreSQL via Prisma: reads and writes (evidence: `src/domains/auth/services/email-authorization.service.ts`)
- Admin Dashboard → Access Checks: requires access
- Administrator → Admin Dashboard: manages catalogue (evidence: `README.md`)
- Admin Dashboard → Admin Management: manages films (evidence: `README.md`)
- Admin Dashboard → Usage Analytics: views statistics (evidence: `README.md`)
- Movie Details → Movie Actions: loads movie
- Movie Actions → Movie Service: delegates
- Movie Service → Movie Data: uses data access (evidence: `src/domains/movies/services/movie.service.ts`)
- Movie Data → PostgreSQL via Prisma: queries (evidence: `src/lib/data/movies.ts`)
- Movie Data → Movie Model: uses types (evidence: `src/lib/data/movies.ts`)
- Administrator → Upload Interface: uploads media (evidence: `README.md`)
- Upload Interface → Upload State: updates state (evidence: `src/domains/dashboard/hooks/useUploadToGoogleDrive.ts`)
- Upload Interface → Upload API: sends upload
- Upload API → Access Checks: verifies admin (evidence: `src/app/api/upload/google-drive/route.ts`)
- Upload API → Drive Upload Service: calls service (evidence: `src/app/api/upload/google-drive/route.ts`)
- Drive Upload Service → Google API Client: uses credentials (evidence: `src/domains/dashboard/services/google-drive-upload.service.ts`)
- Drive Upload Service → Google Drive: uploads files (evidence: `src/domains/dashboard/services/google-drive-upload.service.ts`)
- Authentication → PostgreSQL via Prisma: stores auth data (evidence: `src/lib/auth.ts`)
- API Error Handling → Movie Service: wraps API errors
