cooperative-meetings is a demo app exposing REST APIs for managing meetings of a cooperative.

Implemented with Spring Boot using WebFlux for handling requests, but the app is not fully reactive. APIs are documented with OpenAPI.

Current features available:

• CRUD operations for subjects
• CRUD operations for polls of subjects
• CRUD operations for voting on polls of subjects

Requirements

Compiling, running and testing the application have different requirements.

To compile the app:

• Java SDK 11, openjdk works
• Maven, (recommended v3.6.0 or higher)

To run the app jar:

• Java JRE 11, openjdk works

To run integration tests:

• Java SDK 11, openjdk works
• Maven, (recommended v3.6.0 or higher)
• Docker, v19.03.8 or more recent is fine
• Docker Compose, v1.25.5 or more recent is fine

Conveniently there are utilities that automate running integration tests, these require:

• Be able to execute Bourne shell script, /bin/sh
• GNU Make, v4.1 or more recent is fine

Building

To create the app jar run mvn clean install. This creates the jar at target of :web-app module as well as a zip at target of :integration-test containing the jar and a docker compose file to deploy a playground with PostgreSQL.

Running

Run make deploy to have get the application running, information about APIs available can be found at http://localhost:8080/swagger-ui.html. Run the integration tests with make integration-test. Run stress test with make stress or make stress-linux if running on linux. To undeploy the application, run make undeploy

Testing

To run the integration tests execute:

$ make deploy-test

It will compile the jar if needed, deploy the playground app, run integration tests and undeploy the application at the end.