RetroQuest is a website that enables teams to run retrospectives online and in a fun way. It is designed to accomodate both local and distributed teams.
If you are unfamiliar with what a retrospective is, it is a meeting that is held at the and of each iteration on a Agile team. Retrospectives are designed to allow the team time to decompress and reflect upon what happened during the iteration and indentify actions that can improve the team as a whole.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
What you need to install before building our project. This guide will assume you have a basic understanding of Git operations.
- OpenJDK11
- Lombok
- Docker and Docker Compose (Which is included in the desktop docker applications for Mac/Windows) or Postgresql
- Node.js
- Open a terminal in the api directory (location of gradle.build)
- Build the project with the following command:
./gradlew clean build withPostgresThis will trigger the backend tests to run.
- If you do not wish to run the tests and only want to build the application, use
./gradlew clean assemble withPostgres
Note: If you are using a different database, then choose the appropriate withDB syntax
- Open a terminal in the ui directory (location of package.json)
- Run
yarn installto install the dependencies - Build the project with the following command:
yarn build-prod
- This will place the compiled output into the
api/src/main/resources/staticand will be bundled in the next backend build
Running the application locally can be done with either an H2 in-memory database or with a docker container of Postgresql.
The simplest way to get the application spun up is by using the in-memory database via Gradle:
./gradlew bootRun
or
SPRING_PROFILES_ACTIVE=local ./gradlew bootRun withH2
The schema produced for H2 may not conform exactly to the Postgresql schema used in production.
Running the application locally with Postgresql requires a running instance of the Docker Postgresql container:
cd ./api && docker-compose up
Start the backend with Gradle:
./gradlew bootRunDockerDb
or
SPRING_PROFILES_ACTIVE=dockerdb ./gradlew bootRun withPostgres
If you are only working on the backend, a static build will be accessible from localhost:8080 after running yarn build-prod
Start the frontend with yarn for live development:
yarn start
This will start the frontend with a proxy to direct all requests to localhost:8080 where the api is running. The application will start at localhost:4200
This project includes unit tests, API tests, and Selenium tests.
The following Gradle targets will run the various test suites:
./gradlew test -- Java Unit Tests
./gradlew apiTest -- API Level integration tests with and H2 database
./gradlew apiTestDockerDb -- API Level integration tests with and production representative database
To run both the backend api and unit tests at once:
./gradlew runAllTests
To run both the backend api and unit tests at once against a production representative database:
./gradlew runAllTestsDockerDb
Navigate to the ui folder, making sure you've already followed the build steps for the frontend and run any of the following commands:
yarn unit -- Runs all tests and closes
yarn unit-watch -- Runs all tests. Reruns tests if changes are made.
yarn unit-coverage -- Runs all tests, collects unit test coverage and closes
Start the database
cd ./api && docker-compose up
Start the backend application
./gradlew bootRunDockerDb
Run the end to end tests
cd ./ui
yarn cypress
...Or to run the tests visually from the cypress tool (good for troubleshooting)
cd ./ui
yarn cypress-supervise
The application uses a Postgresql instance. The connection properties can be found in the application's property file.
Please read GOOGLE_APP_ENGINE.md for details on deploying Retroquest to Google App Engine.
Please read CONTRIBUTING.md for details on our code of conduct, and the process for contributing, including how to fork and submit pull requests.