# begzatmamatkarimov/movie_poster architecture

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

- Interactive diagram: https://gitdiagram.com/begzatmamatkarimov/movie_poster
- Repository: https://github.com/begzatmamatkarimov/movie_poster

## Overview

This is a Spring Boot movie-catalog API with authentication, user-profile management, movie discovery and maintenance, and poster-file handling. The principal workflow is a client request entering a controller, passing to a service, and—where applicable—using a repository or file service to persist or retrieve data. Authentication additionally issues and refreshes tokens, while the catalog supports pagination, sorting, title and genre search, and poster operations. The README is empty; relationships for unsampled implementations are included only where the source index establishes references.

Main entry points: [`src/main/java/com/arbek/auth/repository/UserRepository.java`](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/repository/UserRepository.java) (User repository), [`src/main/java/com/arbek/controllers/AuthController.java`](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/controllers/AuthController.java) (Auth endpoints), [`src/main/java/com/arbek/auth/services/AuthService.java`](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/services/AuthService.java) (Authentication), [`src/main/java/com/arbek/service/MovieServiceImpl.java`](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/service/MovieServiceImpl.java) (Catalog service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API endpoints"]
  node_auth_controller["Auth endpoints"]
  node_movie_controller["Movie endpoints"]
  node_user_controller["User endpoints"]
  node_file_controller["File endpoints"]
end

subgraph group_auth["Identity and security"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_jwt["JWT handling<br/>[JwtService.java]"]
  node_refresh_service["Refresh tokens"]
  node_auth_filter["Token filter"]
  node_security_config["Security setup"]
  node_user_config["User configuration"]
  node_user_entity["User identity<br/>[LocalUser.java]"]
  node_refresh_entity["Refresh-token record<br/>[RefreshToken.java]"]
  node_user_type["User roles<br/>[UserType.java]"]
  node_user_repo["User repository"]
  node_refresh_repo["Token repository"]
end

subgraph group_catalog["Movie catalog"]
  node_movie_service["Catalog service"]
  node_movie_repo["Movie repository"]
  node_movie_entity["Movie record<br/>[Movie.java]"]
  node_movie_dto["Movie data models"]
end

subgraph group_users["User profiles"]
  node_user_service["Profile service"]
  node_user_dto["Profile data models"]
end

subgraph group_files["Poster files"]
  node_file_service["File handling"]
end

node_client(("API client"))
node_database[("Relational database")]

node_client -->|"requests"| node_auth_controller
node_client -->|"requests"| node_movie_controller
node_client -->|"requests"| node_user_controller
node_client -->|"requests"| node_file_controller
node_auth_controller -->|"delegates auth"| node_auth_service
node_auth_controller -->|"verifies token"| node_refresh_service
node_auth_controller -->|"issues access token"| node_jwt
node_auth_service -->|"saves and finds users"| node_user_repo
node_auth_service -->|"generates token"| node_jwt
node_auth_service -->|"creates token"| node_refresh_service
node_refresh_service -->|"finds user"| node_user_repo
node_refresh_service -->|"reads and writes"| node_refresh_repo
node_security_config -->|"registers filter"| node_auth_filter
node_auth_filter -->|"validates token"| node_jwt
node_user_config -->|"configures user lookup"| node_user_repo
node_movie_controller -->|"delegates catalog actions"| node_movie_service
node_movie_controller -->|"uses models"| node_movie_dto
node_movie_service -->|"accesses movies"| node_movie_repo
node_movie_service -->|"handles poster files"| node_file_service
node_movie_service -->|"maps movie data"| node_movie_dto
node_file_controller -->|"delegates file actions"| node_file_service
node_user_controller -->|"delegates profile actions"| node_user_service
node_user_controller -->|"uses profile models"| node_user_dto
node_user_service -->|"loads and updates user"| node_user_repo
node_user_service -->|"reads token identity"| node_jwt
node_user_repo -->|"persists users"| node_database
node_refresh_repo -.->|"persists tokens"| node_database
node_movie_repo -.->|"persists movies"| node_database

click node_auth_controller "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/controllers/AuthController.java"
click node_movie_controller "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/controllers/MovieController.java"
click node_user_controller "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/controllers/UserController.java"
click node_file_controller "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/controllers/FileController.java"
click node_auth_service "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/services/AuthService.java"
click node_jwt "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/services/JwtService.java"
click node_refresh_service "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/services/RefreshTokenService.java"
click node_auth_filter "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/services/AuthFilterService.java"
click node_security_config "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/config/SecurityConfig.java"
click node_user_config "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/config/ApplicationConfig.java"
click node_user_entity "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/entities/LocalUser.java"
click node_refresh_entity "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/entities/RefreshToken.java"
click node_user_type "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/entities/UserType.java"
click node_user_repo "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/repository/UserRepository.java"
click node_refresh_repo "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/repository/RefreshTokenRepository.java"
click node_movie_service "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/service/MovieServiceImpl.java"
click node_movie_repo "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/repositories/MovieRepositoty.java"
click node_movie_entity "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/entities/Movie.java"
click node_movie_dto "https://github.com/begzatmamatkarimov/movie_poster/tree/main/src/main/java/com/arbek/dto"
click node_user_service "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/service/UserServiceImpl.java"
click node_user_dto "https://github.com/begzatmamatkarimov/movie_poster/tree/main/src/main/java/com/arbek/dto"
click node_file_service "https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/service/FileServiceImpl.java"

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_auth_controller,node_movie_controller,node_user_controller,node_file_controller,node_client toneBlue
class node_auth_service,node_jwt,node_refresh_service,node_auth_filter,node_security_config,node_user_config,node_user_entity,node_refresh_entity,node_user_type,node_user_repo,node_refresh_repo,node_database toneAmber
class node_movie_service,node_movie_repo,node_movie_entity,node_movie_dto toneMint
class node_user_service,node_user_dto toneRose
class node_file_service toneIndigo
```

## Components

### API endpoints

- [Auth endpoints](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/controllers/AuthController.java): `src/main/java/com/arbek/controllers/AuthController.java`
- [Movie endpoints](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/controllers/MovieController.java): `src/main/java/com/arbek/controllers/MovieController.java`
- [User endpoints](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/controllers/UserController.java): `src/main/java/com/arbek/controllers/UserController.java`
- [File endpoints](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/controllers/FileController.java): `src/main/java/com/arbek/controllers/FileController.java`

### Identity and security

- [Authentication](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/services/AuthService.java): `src/main/java/com/arbek/auth/services/AuthService.java`
- [JWT handling](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/services/JwtService.java): `src/main/java/com/arbek/auth/services/JwtService.java`
- [Refresh tokens](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/services/RefreshTokenService.java): `src/main/java/com/arbek/auth/services/RefreshTokenService.java`
- [Token filter](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/services/AuthFilterService.java): `src/main/java/com/arbek/auth/services/AuthFilterService.java`
- [Security setup](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/config/SecurityConfig.java): `src/main/java/com/arbek/auth/config/SecurityConfig.java`
- [User configuration](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/config/ApplicationConfig.java): `src/main/java/com/arbek/auth/config/ApplicationConfig.java`
- [User identity](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/entities/LocalUser.java): `src/main/java/com/arbek/auth/entities/LocalUser.java`
- [Refresh-token record](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/entities/RefreshToken.java): `src/main/java/com/arbek/auth/entities/RefreshToken.java`
- [User roles](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/entities/UserType.java): `src/main/java/com/arbek/auth/entities/UserType.java`
- [User repository](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/repository/UserRepository.java): `src/main/java/com/arbek/auth/repository/UserRepository.java`
- [Token repository](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/auth/repository/RefreshTokenRepository.java): `src/main/java/com/arbek/auth/repository/RefreshTokenRepository.java`

### Movie catalog

- [Catalog service](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/service/MovieServiceImpl.java): `src/main/java/com/arbek/service/MovieServiceImpl.java`
- [Movie repository](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/repositories/MovieRepositoty.java): `src/main/java/com/arbek/repositories/MovieRepositoty.java`
- [Movie record](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/entities/Movie.java): `src/main/java/com/arbek/entities/Movie.java`
- [Movie data models](https://github.com/begzatmamatkarimov/movie_poster/tree/main/src/main/java/com/arbek/dto): `src/main/java/com/arbek/dto`

### User profiles

- [Profile service](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/service/UserServiceImpl.java): `src/main/java/com/arbek/service/UserServiceImpl.java`
- [Profile data models](https://github.com/begzatmamatkarimov/movie_poster/tree/main/src/main/java/com/arbek/dto): `src/main/java/com/arbek/dto`

### Poster files

- [File handling](https://github.com/begzatmamatkarimov/movie_poster/blob/main/src/main/java/com/arbek/service/FileServiceImpl.java): `src/main/java/com/arbek/service/FileServiceImpl.java`

### Other components

- **API client**
- **Relational database**

## Connections

- API client → Auth endpoints: requests (evidence: `src/main/java/com/arbek/controllers/AuthController.java`)
- API client → Movie endpoints: requests (evidence: `src/main/java/com/arbek/controllers/MovieController.java`)
- API client → User endpoints: requests (evidence: `src/main/java/com/arbek/controllers/UserController.java`)
- API client → File endpoints: requests (evidence: `src/main/java/com/arbek/controllers/FileController.java`)
- Auth endpoints → Authentication: delegates auth (evidence: `src/main/java/com/arbek/controllers/AuthController.java`)
- Auth endpoints → Refresh tokens: verifies token (evidence: `src/main/java/com/arbek/controllers/AuthController.java`)
- Auth endpoints → JWT handling: issues access token (evidence: `src/main/java/com/arbek/controllers/AuthController.java`)
- Authentication → User repository: saves and finds users (evidence: `src/main/java/com/arbek/auth/services/AuthService.java`)
- Authentication → JWT handling: generates token (evidence: `src/main/java/com/arbek/auth/services/AuthService.java`)
- Authentication → Refresh tokens: creates token (evidence: `src/main/java/com/arbek/auth/services/AuthService.java`)
- Refresh tokens → User repository: finds user (evidence: `src/main/java/com/arbek/auth/services/RefreshTokenService.java`)
- Refresh tokens → Token repository: reads and writes (evidence: `src/main/java/com/arbek/auth/services/RefreshTokenService.java`)
- Security setup → Token filter: registers filter (evidence: `src/main/java/com/arbek/auth/config/SecurityConfig.java`)
- Token filter → JWT handling: validates token (evidence: `src/main/java/com/arbek/auth/services/AuthFilterService.java`)
- User configuration → User repository: configures user lookup (evidence: `src/main/java/com/arbek/auth/config/ApplicationConfig.java`)
- Movie endpoints → Catalog service: delegates catalog actions (evidence: `src/main/java/com/arbek/controllers/MovieController.java`)
- Movie endpoints → Movie data models: uses models (evidence: `src/main/java/com/arbek/controllers/MovieController.java`)
- Catalog service → Movie repository: accesses movies (evidence: `src/main/java/com/arbek/service/MovieServiceImpl.java`)
- Catalog service → File handling: handles poster files (evidence: `src/main/java/com/arbek/service/MovieServiceImpl.java`)
- Catalog service → Movie data models: maps movie data (evidence: `src/main/java/com/arbek/service/MovieServiceImpl.java`)
- File endpoints → File handling: delegates file actions (evidence: `src/main/java/com/arbek/controllers/FileController.java`)
- User endpoints → Profile service: delegates profile actions (evidence: `src/main/java/com/arbek/controllers/UserController.java`)
- User endpoints → Profile data models: uses profile models (evidence: `src/main/java/com/arbek/controllers/UserController.java`)
- Profile service → User repository: loads and updates user (evidence: `src/main/java/com/arbek/service/UserServiceImpl.java`)
- Profile service → JWT handling: reads token identity (evidence: `src/main/java/com/arbek/service/UserServiceImpl.java`)
- User repository → Relational database: persists users (evidence: `src/main/java/com/arbek/auth/repository/UserRepository.java`)
- Token repository → Relational database: persists tokens
- Movie repository → Relational database: persists movies
