API Flix

REST API for managing a movie catalog and streaming services, built with Spring Boot and a modern architecture.

About the Project

Flix is a platform that allows users to discover movies available across different streaming services. The project was developed with a focus on:

• Content Organization: Efficient categorization of movies
• Multiple Services: Integration with various streaming providers
• Security: JWT authentication to protect endpoints
• Performance: Optimized queries and caching for better performance
• Scalability: Architecture designed for growth

Architecture

The project follows a layered architecture:

src/main/java/com/movieflix/
├── config/         # Spring and Security configurations
├── controller/     # REST Controllers
├── entity/         # JPA Entities
├── repository/     # Spring Data Repositories
├── service/        # Business logic
├── exception/      # Custom exceptions
└── mapper/         # DTO <-> Entity conversions

Technologies Used

Backend

• Java 17: LTS version with modern language features
• Spring Boot 3: Framework for rapid development
• Spring Security: Security and authentication
• Spring Data JPA: Data persistence
• JWT: Stateless authentication tokens
• Lombok: Reduces boilerplate code
• Bean Validation: Data validation

Database

• PostgreSQL 15: Robust relational database
• Flyway: Schema versioning and migrations

Development Tools

• Maven: Dependency management and build tool
• JUnit 5: Unit testing
• Mockito: Mocking for tests
• Swagger/OpenAPI: API documentation

Features

Authentication & Authorization

• User registration and login system
• JWT-based authentication
• Role-based route protection

Category Management

• Full CRUD for movie categories
• Data validation
• Dependency handling

Streaming Services

• Register and manage providers
• Associate movies with providers
• Integrity validations

Movie Catalog

• Detailed movie registration
• Search by multiple criteria
• Association with categories and services
• Rating system

Requirements

• Java 17+
• PostgreSQL 15+
• Maven 3.8+

How to Run

Step by Step

1. Clone the repository

git clone [repository-url]

2. Configure PostgreSQL in the application.yaml file:

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/flix
    username: your_username
    password: your_password

3. Run the application:

# Manual build
mvn clean package

# Manual run
mvn spring-boot:run

The API will be available at http://localhost:8080

API Documentation

All routes are fully documented with Swagger/OpenAPI and can be accessed at:

• http://localhost:8080/swagger-ui.html

Endpoints

Authentication

• POST /api/auth/register - Register new user
• POST /api/auth/login - User login

Categories

• POST /api/categories - Create category
• GET /api/categories - List categories
• GET /api/categories/{id} - Get category by ID
• DELETE /api/categories/{id} - Delete category

Streaming Services

• POST /api/streaming - Create streaming service
• GET /api/streaming - List streaming services
• GET /api/streaming/{id} - Get streaming service by ID
• DELETE /api/streaming/{id} - Delete streaming service

Movies

• POST /api/movies - Create movie
• GET /api/movies - List movies
• GET /api/movies/{id} - Get movie by ID
• PUT /api/movies/{id} - Update movie
• DELETE /api/movies/{id} - Delete movie
• GET /api/movies/search?category={id} - Search movies by category

Contributing

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Authors

• Vinicius Ferreira

License

This project is under development.