add simulator to mimic tasks usage

Author: felixevers

shell.nix

@@ -31,6 +31,7 @@ pkgs.mkShell {
     python
     python.pkgs.pip
     python.pkgs.virtualenv
+    python.pkgs.requests
     nodejs
     pkgs.docker
     dockerCompose
@@ -80,6 +81,11 @@ pkgs.mkShell {
       fi
     fi
 
+    run-simulator() {
+      echo ">>> Running simulator"
+      (cd "$PROJECT_ROOT/simulator" && ${pkgs.python313}/bin/python3 main.py)
+    }
+
     start-docker() {
       echo ">>> Starting PostgreSQL, Redis and Keycloak via Docker..."
       (cd "$PROJECT_ROOT" && ${dockerCompose}/bin/docker-compose -f $DOCKER_COMPOSE_FILE up -d postgres redis keycloak)
@@ -153,6 +159,6 @@ pkgs.mkShell {
     }
 
     echo ">>> Environment ready."
-    echo "Commands: run-dev-backend, run-dev-web, run-dev-all, run-alembic, psql-dev, redis-cli-dev, clean-dev"
+    echo "Commands: run-dev-backend, run-dev-web, run-dev-all, run-alembic, psql-dev, redis-cli-dev, clean-dev, start-docker, stop-docker, run-simulator"
   '';
 }

simulator/README.md

@@ -0,0 +1,23 @@
+# Simulator
+
+This tool simulates clinic traffic for the helpwave tasks application. It authenticates with Keycloak using the `tasks-web` client and performs random actions on the GraphQL API.
+
+**⚠️ DEVELOPMENT USE ONLY**
+This script is designed solely for development and testing environments to mimic user behavior on the tasks application. Do not run this against production environments.
+
+## Features
+
+- **Authentication**: Implements OpenID Connect Authorization Code flow with a local callback server.
+- **Initial Population**: Automatically creates a hospital structure (Clinic, Wards, Rooms, Beds) and patients if the database is empty.
+- **Traffic Simulation**:
+  - Creates new patients.
+  - Creates tasks with random due dates assigned to patients.
+  - Randomly assigns tasks to the logged-in user.
+  - Updates task statuses (Done/Reopened).
+  - Moves patients between locations.
+  - Discharges (deletes) patients.
+
+## Prerequisites
+
+- Python 3.10+
+- The `helpwave tasks` stack (Backend, Keycloak, Postgres) must be running.