Trollsystem

Helfendenverwaltungstool mit Gulaschgeschmack

Start via Docker Compose

For development purposes, a docker compose setup is provided to allow building running the microservices in a simple and reproducible fashion. You may need to install Docker on your system. Podman will not work.

Run the following command to start the backend microservices and database:

docker compose up --build

You can also enable watch mode to automatically recompile and restart microservices when their source code is changed:

docker compose up --build --watch

You can teardown the environment and start fresh with the following command (--volumes will delete the database volume):

docker compose down --volumes

Further usage

You can register a sample user by calling the API using curl. The command will return null the first time it is run and an error on subsequent calls.

curl -X POST http://localhost:8080/register \
 -H "Content-Type: application/json" \
 -d '{
 "username": "testuser",
 "email": "test@example.com",
 "password": "password123",
 "allow_notifications": false,
 "allow_keep_data": false
 }'

You can then list the registered users:

docker compose exec database psql -U postgres -d trollsystem-auth -c "SELECT * FROM users;"

Test users

After starting the backend you can use the following command to add test users (one for each role):

scripts/add-test-users.sh

Then, you can login using, e.g., test-admin as the username and password as the password.