Open Hospital API

This is the API project of Open Hospital: it exposes a REST API of the business logic implemented in the openhospital-core project.

Summary

• How to build [WIP]
  • Using Swagger-UI
  • Using Postman
• How to deploy backend in docker environment
• How to generate openapi specs
• Cleaning
• How to contribute
• Community
• Code style

Table of contents generated with markdown-toc

How to build [WIP]

For the moment, to build this project you should

1. fetch and build the core project

   git clone https://github.com/informatici/openhospital-core.git
   cd openhospital-core
   mvn clean install -DskipTests=true

2. clone and build this project

   git clone https://github.com/informatici/openhospital-api
   cd openhospital-api
   mvn clean install -DskipTests=true

3. prepare settings from each rsc/*.dist file

   rsc/application.properties <- set a SHA-256 jwt token
   rsc/database.properties
   rsc/log4j.properties
   rsc/...

4. set target/rsc/database.properties

   DB can be created with `docker-compose up` from `openhospital-core` or using a dedicated MySQL server

5. start openhospital-api (in target folder)

   # Windows
   java -cp "openhospital-api-0.1.0.jar;rsc/;static/" org.springframework.boot.loader.JarLauncher
   
   # Linux
   java -cp "openhospital-api-0.1.0.jar:rsc/:static/" org.springframework.boot.loader.JarLauncher

6. call services

   • URL base: http://localhost:8080
   • URL login: http://localhost:8080/auth/login
   • URL patients: http://localhost:8080/patients
   • URL swagger: http://localhost:8080/swagger-ui.html

You can see Swagger Api Documentation at: http://localhost:8080/swagger-ui/

Using Swagger-UI

1. use endpoint /auth/login to login and get the token

2. use the Authorize button at the top of the Swagger-UI, paste the token from step #1 and click Authorize

3. close the dialog

4. now all the endpoints are automatically secured and the token will be added to the request

Using Postman

1. import postman_collection.json in your Postman installation

How to deploy backend in Docker environment

Make sure you have docker with docker-compose installed, then run the following commands:

• copy dotenv file into .env and set variables as needed (the SHA-256 jwt token is needed)
• run make
• run docker compose up -d database (wait for some seconds the very first time to build the DB)
• (optional - demo data after set the database container) run docker compose run --rm oh-database-init
• run docker compose up backend

When done successfully, head over at http://localhost:[API_PORT]/swagger-ui/

You can change the deployment branch using an .env file.

How to generate openapi specs

Make sure to have API started without errors.

Run the Maven command and it will overwrite the openapi/oh.yaml

mvn springdoc-openapi:generate

To redirect the output to another file, use:

mvn springdoc-openapi:generate -Dspringdoc.outputFileName=my_revision.yaml

Cleaning

docker compose rm --stop --volumes --force
make clean

How to contribute

You can find the contribution guidelines in the Open Hospital wiki.
A list of open issues is available on Jira.

Community

You can reach out to the community of contributors by joining our Slack workspace or by subscribing to our mailing list.

Code style

This project uses a consistent code style and provides definitions for use in both IntelliJ and Eclipse IDEs.