https://github.com/adil-faiyaz98/streaming-platform
A GraphQL and REST-based microservice for managing streaming content catalogs
https://github.com/adil-faiyaz98/streaming-platform
graph graphiql java microservice springboot springvalidations swagger-api
Last synced: 7 months ago
JSON representation
A GraphQL and REST-based microservice for managing streaming content catalogs
- Host: GitHub
- URL: https://github.com/adil-faiyaz98/streaming-platform
- Owner: adil-faiyaz98
- Created: 2025-03-08T02:21:28.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-17T08:40:38.000Z (7 months ago)
- Last Synced: 2025-03-17T09:36:48.281Z (7 months ago)
- Topics: graph, graphiql, java, microservice, springboot, springvalidations, swagger-api
- Language: Java
- Homepage: https://github.com/adil-faiyaz98/streaming-platform
- Size: 4.72 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Streaming Platform Catalog Service
## Overview
The **Streaming Platform Catalog Service** is a microservice responsible for managing movies, series, seasons, and episodes. It provides both **GraphQL and REST APIs**, allowing flexible data retrieval for different clients.
## Available APIs
- **[GraphQL API Documentation](GRAPHQL.md)**
- **[REST API Documentation](RESTAPI.md)**
## Features
- **GraphQL API** for efficient, flexible queries.
- **REST API** for standard HTTP-based integrations.
- **PostgreSQL Database** for persistence.
- **Spring Boot** backend with Spring Data JPA.
- **Dockerized Deployment** with multi-stage builds.
- **Authentication & Authorization** using Spring Security.
- **Batch Loading with DataLoader** to optimize GraphQL queries.
## Tech Stack
- **Backend:** Java 17, Spring Boot, Spring GraphQL, Spring Security
- **Database:** PostgreSQL with JPA/Hibernate
- **APIs:** GraphQL and REST
- **Build & Deployment:** Gradle, Docker, GitHub Actions CI/CD
## Getting Started
### Prerequisites
- Java 17+
- Gradle
- Docker & Docker Compose
- PostgreSQL
### Running Locally
#### Clone the Repository
```sh
git clone https://github.com/your-repo/streaming-platform.git
cd streaming-platform
```
## Start Database with Docker
```sh
docker-compose up -d
```
## Build and run the application
```sh
./gradlew bootRun
```
## Access the APIs
### GraphQL Playground:
```sh
http://localhost:8082/graphql
```
### REST API Base URL:
```sh
http://localhost:8082/api/v1
```
### Swagger API Docs:
```sh
http://localhost:8082/swagger-ui
```
### Configuration
Modify _application.yml_ for environment-specific configurations, including:
Database connection settings
Security credentials
API rate limits
## Build a Docker Image
```sh
docker build -t streaming-catalog .
```
## Run the container
```sh
docker run -p 8082:8082 streaming-catalog
```
## Future Considerations
Initially, I considered fine-tuning this project using **LLaMA** to introduce meaningful AI, but this project does not seem like the right fit. Instead, I would likely explore another project better suited for AI integration.
However, if extending this system to train a **UI-driven recommendation service**, a **neural network model like an Autoencoder** could enhance personalized recommendations. Additionally, for **user churn prediction**, leveraging **gradient boosting models like XGBoost** would be effective.
## Images
### Image 1
### Image 2
### Image 3
### Image 4
