aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md42
1 files changed, 42 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..15bc29d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,42 @@
+# Portal-prefs
+This microservice manages the user specific config for the `portal-ui` frontend application. It is a Spring Boot application that is build upon a MongoDB and Webflux.
+
+## Build
+```sh
+./gradlew build
+```
+
+## Run
+```sh
+./gradlew bootRun
+```
+
+## Test
+```sh
+./gradlew test # run all tests
+./gradlew test --tests GetTileIntegrationTest # run all tests in file
+./gradlew test --tests GetTileIntegrationTest.thatTileCanBeRetrieved # run individual test in file
+./gradlew test --tests GetTileIntegrationTest.thatTileCanBeRetrieved --debug # run individual test in file with debug enabled
+```
+
+## Development
+You can run the service locally for evaluation or development purposes using the provided `docker-compose.yml` file in the development folder. This will launch a Keycloak, a Postgres and a Mongo db in the background.
+
+**Prerequisites:** Running local docker daemon and a docker cli
+
+To start the service execute the `run.sh` in the development folder:
+```sh
+development/run.sh
+```
+
+Example request against the portal-prefs service can be run in your preferred IDE with the `request.http` file from the development folder.
+
+You can access the Keycloak UI via browser.
+URL: http://localhost:8080
+**username:** admin
+**password:** password
+
+To stop the portal-prefs service, Keycloak and the databases run:
+```sh
+development/stop.sh
+```