replace build/codegen scripts with justfile, adapt readme

README.md

@@ -3,22 +3,23 @@
 A self-hostable photo gallery. Very early, very work-in-progress and not ready for use yet. Licensed under GPLv3.
 
 ## Targeted features
+
 - Powerful user management (photos are by default private, can be shared with other users in the app, or users outside it)
 - A photo feed similar to GPhotos or Apple Photos, searchable.
 - Album management: Allow creating albums with images and share them with others
 - Automatic tagging of images
 - Easy deployment with a `docker-compose.yaml` file. (potentially also provide a Kubernetes deployment setup)
 
 ## Non-features
+
 - Support for databases other than PostgreSQL. We use PostgreSQL specific features and support for MySQL etc. is not planned.
 - Image editing support. We want to keep the scope reasonable (this is a side project).
 
 ## Developer setup
-0. Prerequisites: Install Java 17+, NodeJS 18+ and PostgreSQL 15+
-1. Install Typescript globally (`npm i -g typescript`)
-2. Create a new database (`createdb imagehive`)
-3. Set the required environment variables (`IMAGEHIVE_PG_JDBC_URL`, `IMAGEHIVE_PG_USER` and `IMAGEHIVE_PG_PASSWORD`)
-4. Run the `regenerate-code` script in the main directory (`.ps1` on windows, `.sh` on *nix)
-5. Install the frontend dependencies (`npm i`)
-6. Start the backend (in the `backend` folder, run `./mvnw mn:run`)
-7. Start the frontend (in the `frontend` folder, run `npm run dev`)
+
+0. Prerequisites: Install Java 21, NodeJS 18+ and PostgreSQL 16 (plus `nushell` and `just` if you want to use the `justfile` shortcuts)
+1. Create a new database (`createdb imagehive`)
+2. Set the required environment variables (`IMAGEHIVE_PG_JDBC_URL`, `IMAGEHIVE_PG_USER` and `IMAGEHIVE_PG_PASSWORD`)
+3. Run `just generate-client` and wait for it to succeed.
+4. To start the different apps, do `just backend start`, `just frontend start` and `just ai start` if you have `just` and `nushell` installed, otherwise
+   look in the `justfile` for the respective projects to see what commands they run.

backend/justfile

@@ -5,3 +5,6 @@ format:
 
 start:
     mvn compile mn:run
+
+build:
+    mvn compile test-compile

frontend/justfile

@@ -4,4 +4,5 @@ format:
     npm run format
 
 start:
+    npm install
     npm run dev

justfile

@@ -19,8 +19,12 @@ codegen := project + "/imagehive-codegen"
     cd {{codegen}}; just {{cmd}}
 
 format:
-  just backend format
-  just frontend format
-  just ai format
-  just codegen format
+    just backend format
+    just frontend format
+    just ai format
+    just codegen format
 
+generate-client:
+    rm -r imagehive-client
+    just backend build
+    npx @openapitools/openapi-generator-cli generate