Skip to content

Commit

Permalink
chore: created readme file
Browse files Browse the repository at this point in the history
  • Loading branch information
wagner-wutzke authored Feb 20, 2025
1 parent ec82d51 commit d8d7e08
Showing 1 changed file with 37 additions and 0 deletions.
37 changes: 37 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Open Video Conference (OVC) Backend Documentation
Java Backend API for DVB Booking Portal

Backend application created using:
* Spring Boot
* Spring Web MVC Rest Controllers + Swagger
* Spring JPA + Hibernate
* Postgresql DB

## REST API Documentation (OpenAPI 3.0)
The OVC backend API has an auto-generated Swagger (OpenAPI 3.0) documentation.
One can see the REST endpoints documentation as a web page in a web-browser.

In order to see the documentation, the backend application must be running.
The url for that page follows the pattern:
`https://{{ backend-app-domain }}/swagger-ui/index.html`

For instance, for the integration environment, the url is:
https://ovc-backend.nordeck.io/swagger-ui/index.html.

## Running the docker containers for DB & App
```sh
docker compose build
docker compose up
```

## Application health
We use the Spring Actuator endpoint in order to check if the application is running:
```
http://{{ backend-app-domain }}/actuator/health
```
The response should be:
```json
{
"status": "UP"
}
```

0 comments on commit d8d7e08

Please sign in to comment.