-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
ec82d51
commit d8d7e08
Showing
1 changed file
with
37 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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" | ||
} | ||
``` |