Development

Common commands (to be used from within the wisen subdirectory):

• Run backend server: clj -M:backend
• Run backend server with repl: clj -M:backend -r PORT
• Run backend tests: clj -T:build test-clj
• Run frontend watch: clj -T:build cljs-watch

The frontend then runs on http://localhost:4321. The cljs test display is at http://localhost:9501/.

Ollama + Keycloak backing services can be started in a local QEMU VM via

nix run .#dev-vm

Note that on macOS only this requires a properly configured and booted linux-builder (nix run nixpkgs#darwin.linux-builder). Follow the instructions in the manual on how to configure your macOS system to automatically dispatch aarch64-linux builds to the linux-builder.

Java dependencies

After you updated dependencies in `deps.edn` you have to update the corresponding lockfile as well:

nix run .#update-clj-lockfile

Deployment

The live system is hosted at https://sp-eu.active-group.de. Deployment happens continually via CI pipeline.

Secret management

We use agenix to manage secrets (mainly the DB password used by the Keycloak service). See this directory.