https://github.com/arminv/movie-app-api

Spring Boot API for a Movie App
https://github.com/arminv/movie-app-api

docker java lombok maven mongodb oauth2 spring spring-boot spring-data-mongodb spring-security-oauth2 swagger-ui testcontainers

Last synced: 2 months ago
JSON representation

Spring Boot API for a Movie App

• Host: GitHub
• URL: https://github.com/arminv/movie-app-api
• Owner: arminv
• License: mit
• Created: 2024-09-26T07:05:47.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-10-17T02:12:56.000Z (over 1 year ago)
• Last Synced: 2025-02-13T05:30:23.542Z (over 1 year ago)
• Topics: docker, java, lombok, maven, mongodb, oauth2, spring, spring-boot, spring-data-mongodb, spring-security-oauth2, swagger-ui, testcontainers
• Language: Java
• Homepage:
• Size: 122 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Movie App API

Backend API for a Movie App similar to [this app](https://react-movies-list.netlify.app/).

Stack/tools include the following:

- Java (23 SDK)

- Spring Boot

- Spring Security (OAuth2)

- Spring Data MongoDB

- MongoDB

- Docker

- Lombok

- Model Mapper

- Testcontainers

- Swagger

- Maven

## Env Variables

The following environment variables are needed:

```bash

ACTIVE_SPRING_PROFILE=test|dev|prod

MONGO_URI=get-your-own

GB_CLIENT_ID=get-your-own (OAuth2)

GB_CLIENT_SECRET=get-your-own (OAuth2)

```

## Swagger UI

`http://localhost:8080/swagger-ui/index.html`

![screencapture-localhost-8080-swagger-ui-index-html-2024-10-14-16_07_03](https://github.com/user-attachments/assets/4e946b6d-9c89-4844-b22e-a2d7f6dbad50)

## Mongo Express UI

- To run Mongo DB locally (via Docker), make sure Docker is up and running, then update `docker-compose.yaml` and `application.yml` files to uncomment sections for local setup.

`http://localhost:8081/`

![screencapture-localhost-8081-db-movieapp-2024-10-14-16_23_26](https://github.com/user-attachments/assets/c10deabb-4750-45c7-a975-a8873f15ac47)

## Tests

- Make sure Docker is up and running.

- Integration tests (that rely on Testcontainers) need to extend the `BaseMongoTest` abstract base class.

## TODO

- Add tests (integration, unit)

- Add and use custom Exception classes

- Implement authorization & role levels/types

- Add Google (OAuth provider)

- Implement JWT-based auth flow