From 9e1fdb71d0198d7e253ede00ffd60e9ab5898ea2 Mon Sep 17 00:00:00 2001 From: Anish Sahoo Date: Mon, 19 Oct 2026 18:43:11 -0400 Subject: [PATCH 01/11] feat: add spring boot and react starter --- .agents/rules/backend.md | 16 + .agents/rules/frontend.md | 13 + .editorconfig | 9 + .env.example | 13 + .gitattributes | 3 + .github/workflows/ci.yml | 45 + .gitignore | 19 + AGENTS.md | 38 + README.md | 136 ++ backend/Dockerfile | 23 + backend/build.gradle.kts | 57 + backend/gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 47505 bytes .../gradle/wrapper/gradle-wrapper.properties | 9 + backend/gradlew | 248 +++ backend/gradlew.bat | 82 + backend/settings.gradle.kts | 1 + .../java/com/example/app/Application.java | 18 + .../app/controller/MessageController.java | 27 + .../java/com/example/app/dao/MessageDAO.java | 32 + .../java/com/example/app/dto/MessageDTO.java | 17 + .../java/com/example/app/entity/Message.java | 29 + .../app/repository/MessageRepository.java | 12 + .../example/app/service/MessageService.java | 20 + backend/src/main/resources/application.yaml | 31 + .../db/migration/V1__create_messages.sql | 7 + compose.override.yaml | 32 + compose.yaml | 54 + contract/openapi.json | 57 + frontend/.oxfmtrc.json | 4 + frontend/.oxlintrc.json | 5 + frontend/Dockerfile | 21 + frontend/index.html | 12 + frontend/nginx.conf | 23 + frontend/openapi-ts.config.ts | 7 + frontend/package.json | 25 + frontend/pnpm-lock.yaml | 1542 +++++++++++++++++ frontend/src/App.tsx | 29 + frontend/src/main.tsx | 12 + frontend/tsconfig.json | 20 + frontend/vite.config.ts | 22 + mise.toml | 169 ++ 41 files changed, 2939 insertions(+) create mode 100644 .agents/rules/backend.md create mode 100644 .agents/rules/frontend.md create mode 100644 .editorconfig create mode 100644 .env.example create mode 100644 .gitattributes create mode 100644 .github/workflows/ci.yml create mode 100644 .gitignore create mode 100644 AGENTS.md create mode 100644 README.md create mode 100644 backend/Dockerfile create mode 100644 backend/build.gradle.kts create mode 100644 backend/gradle/wrapper/gradle-wrapper.jar create mode 100644 backend/gradle/wrapper/gradle-wrapper.properties create mode 100755 backend/gradlew create mode 100644 backend/gradlew.bat create mode 100644 backend/settings.gradle.kts create mode 100644 backend/src/main/java/com/example/app/Application.java create mode 100644 backend/src/main/java/com/example/app/controller/MessageController.java create mode 100644 backend/src/main/java/com/example/app/dao/MessageDAO.java create mode 100644 backend/src/main/java/com/example/app/dto/MessageDTO.java create mode 100644 backend/src/main/java/com/example/app/entity/Message.java create mode 100644 backend/src/main/java/com/example/app/repository/MessageRepository.java create mode 100644 backend/src/main/java/com/example/app/service/MessageService.java create mode 100644 backend/src/main/resources/application.yaml create mode 100644 backend/src/main/resources/db/migration/V1__create_messages.sql create mode 100644 compose.override.yaml create mode 100644 compose.yaml create mode 100644 contract/openapi.json create mode 100644 frontend/.oxfmtrc.json create mode 100644 frontend/.oxlintrc.json create mode 100644 frontend/Dockerfile create mode 100644 frontend/index.html create mode 100644 frontend/nginx.conf create mode 100644 frontend/openapi-ts.config.ts create mode 100644 frontend/package.json create mode 100644 frontend/pnpm-lock.yaml create mode 100644 frontend/src/App.tsx create mode 100644 frontend/src/main.tsx create mode 100644 frontend/tsconfig.json create mode 100644 frontend/vite.config.ts create mode 100644 mise.toml diff --git a/.agents/rules/backend.md b/.agents/rules/backend.md new file mode 100644 index 0000000..4957137 --- /dev/null +++ b/.agents/rules/backend.md @@ -0,0 +1,16 @@ +--- +paths: + - "backend/**" +--- + +# Backend rules + +- Keep the layers: `controller` handles HTTP, `service` holds business logic, + `dao` is the only caller of a `repository` and turns entities into DTOs. + Entities never leave the `dao` layer. +- Inject dependencies through the constructor into `private final` fields. +- Change the schema by editing an entity, then run + `mise run db:dev:migration ` and review the generated SQL. Never edit a + migration that has already been merged. +- After changing a controller or DTO, run `mise run contract` and commit the + updated `contract/openapi.json`. diff --git a/.agents/rules/frontend.md b/.agents/rules/frontend.md new file mode 100644 index 0000000..02dfa7a --- /dev/null +++ b/.agents/rules/frontend.md @@ -0,0 +1,13 @@ +--- +paths: + - "frontend/**" +--- + +# Frontend rules + +- Call the backend through the generated client in `src/api/generated`, not + hand-written `fetch` calls. +- If the client is missing an endpoint, change the backend and run + `mise run contract`. Do not edit the generated files. +- Call the API with relative `/api/...` URLs. Vite proxies them in dev and nginx + proxies them in deploy. diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..86a63dc --- /dev/null +++ b/.editorconfig @@ -0,0 +1,9 @@ +root = true + +[*] +charset = utf-8 +end_of_line = lf +indent_style = space +indent_size = 2 +insert_final_newline = true +trim_trailing_whitespace = true diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..f522d86 --- /dev/null +++ b/.env.example @@ -0,0 +1,13 @@ +# Copy to .env (`mise run setup` does it for you). .env is gitignored. +# +# Only Docker reads this file. Compose injects it into the containers, so in +# development you must run the app with `mise run dev`. Running +# `./gradlew bootRun` or `pnpm dev` directly on your machine will not load these +# values, and the app will fail on startup. + +POSTGRES_USER=app +POSTGRES_PASSWORD=app +POSTGRES_DB=app + +# Host port for connecting a database GUI to the dev db. +POSTGRES_PORT=5432 diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..9f95d99 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,3 @@ +* text=auto eol=lf +*.bat text eol=crlf +*.jar binary diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 0000000..0447263 --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,45 @@ +name: CI + +on: + pull_request: + push: + branches: [main] + +concurrency: + group: ${{ github.workflow }}-${{ github.ref }} + cancel-in-progress: ${{ github.event_name == 'pull_request' }} + +jobs: + frontend_lint: + name: frontend / lint + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + - uses: jdx/mise-action@v5 + - run: pnpm --dir frontend install --frozen-lockfile + - run: mise run lint:frontend + + frontend_format: + name: frontend / format + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + - uses: jdx/mise-action@v5 + - run: pnpm --dir frontend install --frozen-lockfile + - run: mise run fmt:frontend + + backend_lint: + name: backend / lint + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + - uses: jdx/mise-action@v5 + - run: mise run lint:backend + + backend_format: + name: backend / format + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + - uses: jdx/mise-action@v5 + - run: mise run fmt:backend diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..5ee746a --- /dev/null +++ b/.gitignore @@ -0,0 +1,19 @@ +.DS_Store +.idea/ +.vscode/* +!.vscode/extensions.json + +.env +.env.* +!.env.example + +# backend +backend/.gradle/ +backend/build/ +backend/bin/ + +# frontend +node_modules/ +frontend/dist/ +frontend/src/api/generated/ +*.tsbuildinfo diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..e1ce2f2 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,38 @@ +# Working in this repo + +Rules for anyone changing code here, human or agent. `.agents/rules/` has +extra rules for `backend/` and `frontend/`. Read the one for the folder you are +editing. Add to these files when the team agrees on a new rule. + +## Running things + +- Run the app with `mise run dev`. It starts web, backend and db in Docker at + http://localhost:8080. +- `.env` only reaches the app through Docker. `./gradlew bootRun` or `pnpm dev` + on your machine will fail on startup. That is expected, not a bug to work + around. Do not add default values to get past it. +- `mise tasks` lists every task. Run `mise run check` before you finish. It is + what CI runs. `mise run fmt:fix` fixes formatting. + +## Layout + +``` +browser -> web (nginx / vite) -> /api -> backend (Spring) -> db (Postgres) + +backend/ controller -> service -> dao -> repository -> entity +contract/ openapi.json, exported from the backend +frontend/ React app, API client generated from contract/ +``` + +## Code + +- Read the code you are changing, and the code that calls it. +- Make the smallest change that solves the problem. No speculative abstractions, + config, or dependencies. +- Follow the patterns already in the repo before inventing new ones. +- Names carry the meaning. Comments explain why, not what. +- Prefer guard clauses and early returns over nested `if`s. +- Delete dead and commented-out code. Git has it. +- Do not swallow errors. Handle them or let them surface. +- Never hand-edit generated files: `contract/openapi.json` and + `frontend/src/api/generated/`. diff --git a/README.md b/README.md new file mode 100644 index 0000000..f587256 --- /dev/null +++ b/README.md @@ -0,0 +1,136 @@ +# Spring Boot + React starter + +A Spring Boot backend, a React frontend and Postgres, all running in Docker. +The frontend talks to the backend through a client generated from the +backend's OpenAPI spec. + +``` +browser -> web :8080 -> /api/* -> backend :3000 -> db :5432 + (vite in dev, nginx in deploy) +``` + +## Requirements + +- [Docker Desktop](https://www.docker.com/products/docker-desktop/) +- [mise](https://mise.jdx.dev/getting-started.html). It installs Java 25, + Node and pnpm for you. Run `mise install` once after cloning. + +## Quick start + +```sh +mise install +mise run setup # creates .env, installs frontend deps, generates the API client +mise run dev # http://localhost:8080 +``` + +> [!IMPORTANT] +> In development, always run the app through Docker with `mise run dev`. +> Compose is the only thing that loads `.env` into the app. Running +> `./gradlew bootRun` or `pnpm dev` directly on your machine skips it, so the +> backend can't find the database and the frontend can't find the backend. + +The frontend reloads on save. The backend does not. Run `mise run dev:restart` +after changing Java code. + +## Tasks + +Run `mise tasks` for the full list. + +| Task | What it does | +| --- | --- | +| `mise run setup` | Create `.env` from `.env.example`, install frontend deps, generate the API client | +| `mise run dev` | Run web, backend and db in Docker | +| `mise run dev:restart` | Restart the backend after Java changes | +| `mise run dev:down` / `dev:logs` | Stop the containers / follow their logs | +| `mise run stack` | Run the deploy images (built jar + nginx) to check a production build | +| `mise run db:dev:psql` | Open `psql` in the dev database | +| `mise run db:dev:migration ` | Generate a migration from your entity changes | +| `mise run db:dev:reset` | Delete the dev database and start over | +| `mise run contract` | Export the OpenAPI spec and regenerate the frontend client | +| `mise run check` | Format check + lint for both apps (what CI runs) | +| `mise run fmt:fix` / `lint:fix` | Fix formatting / auto-fixable lint errors | + +## Layout + +``` +backend/ Spring Boot, Gradle, Java 25 + src/main/java/com/example/app/ + controller/ HTTP routes + service/ business logic + dao/ the only caller of repositories, maps entities to DTOs + dto/ request and response shapes (these end up in the API client) + repository/ Spring Data JPA interfaces + entity/ JPA entities, one per table + src/main/resources/ + application.yaml config, read from env vars + db/migration/ Flyway migrations +contract/openapi.json API spec, exported from the backend +frontend/ React + Vite + src/api/generated/ API client (generated, gitignored) + nginx.conf deploy server: serves the build, proxies /api +compose.yaml deploy-like stack +compose.override.yaml dev overrides, merged automatically +``` + +A request goes `controller -> service -> dao -> repository`. The DAO hands DTOs +back up, so entities never leave the data layer. + +## Changing the database + +1. Edit or add an entity in `backend/.../entity/`. +2. Run `mise run db:dev:migration add_something`. It starts the backend once, + compares your entities to the dev database, and writes the SQL needed to + match them into the next `V__add_something.sql`. +3. Read the file. Hibernate never drops columns or tables, so write those by + hand. Adjust anything else it got wrong. +4. Run `mise run dev:restart`. Flyway applies the migration on startup. + +Migrations only go forward. Never edit a migration after it has been merged. +Add a new one instead. To start over locally, run `mise run db:dev:reset`. + +## Changing the API + +1. Change a controller or DTO in the backend. +2. Run `mise run contract`. It exports `contract/openapi.json` from the running + backend and regenerates `frontend/src/api/generated/`. +3. Commit `contract/openapi.json`. The generated client is gitignored and + rebuilt from it. + +The function names in the client come from `@Operation(operationId = ...)` on +each controller method. + +## Environment variables + +`.env.example` lists every variable. `mise run setup` copies it to `.env`, +which is gitignored. To add one: + +1. Add it to `.env.example` and your `.env`. +2. Read it in `application.yaml` as `${MY_VAR}`, without a default. + +Compose passes `.env` to the `db` and `backend` containers. + +## Making it yours + +- Rename the Java package: move `backend/src/main/java/com/example/app` and + update the `package` lines, then change `group` in `backend/build.gradle.kts`. +- Rename the project in `backend/settings.gradle.kts`, `frontend/package.json` + and `frontend/index.html`. +- Delete the `messages` example (entity, repository, DAO, DTO, service, + controller, and the migration if nothing is deployed yet), then run + `mise run contract`. + +## Linting and formatting + +- Backend: [Spotless](https://github.com/diffplug/spotless) with + google-java-format, and [Error Prone](https://errorprone.info/), which runs + inside `javac` and fails the build on common bugs. +- Frontend: [oxlint](https://oxc.rs/docs/guide/usage/linter) and + [oxfmt](https://oxc.rs/docs/guide/usage/formatter), plus `tsc` for types. + +CI (`.github/workflows/ci.yml`) runs lint and format for each app on every pull +request. + +## Agents + +`AGENTS.md` and `.agents/rules/` hold the rules coding agents follow in this +repo. They are a starting point. Add rules there as your team agrees on them. diff --git a/backend/Dockerfile b/backend/Dockerfile new file mode 100644 index 0000000..5910936 --- /dev/null +++ b/backend/Dockerfile @@ -0,0 +1,23 @@ +FROM eclipse-temurin:25-jdk-alpine AS base +WORKDIR /app +COPY gradlew settings.gradle.kts build.gradle.kts ./ +COPY gradle gradle +RUN ./gradlew dependencies --no-daemon -q > /dev/null + +# Runs from source. compose.override.yaml bind-mounts src/ over /app/src, so +# `mise run dev:restart` picks up Java changes. +FROM base AS local +COPY src src +CMD ["./gradlew", "bootRun", "--no-daemon"] + +FROM base AS build +COPY src src +RUN ./gradlew bootJar --no-daemon + +FROM eclipse-temurin:25-jre-alpine AS deploy +WORKDIR /app +RUN addgroup -S app && adduser -S app -G app +USER app +COPY --from=build /app/build/libs/app-*.jar app.jar +EXPOSE 3000 +ENTRYPOINT ["java", "-jar", "app.jar"] diff --git a/backend/build.gradle.kts b/backend/build.gradle.kts new file mode 100644 index 0000000..38cb243 --- /dev/null +++ b/backend/build.gradle.kts @@ -0,0 +1,57 @@ +import net.ltgt.gradle.errorprone.errorprone + +plugins { + java + id("org.springframework.boot") version "4.1.1" + id("io.spring.dependency-management") version "1.1.7" + id("com.diffplug.spotless") version "8.10.4" + id("net.ltgt.errorprone") version "5.1.1" +} + +group = "com.example" +version = "0.0.1-SNAPSHOT" + +java { + toolchain { + languageVersion = JavaLanguageVersion.of(25) + } +} + +configurations { + compileOnly { + extendsFrom(configurations.annotationProcessor.get()) + } +} + +repositories { + mavenCentral() +} + +dependencies { + implementation("org.springframework.boot:spring-boot-starter-actuator") + implementation("org.springframework.boot:spring-boot-starter-data-jpa") + implementation("org.springframework.boot:spring-boot-starter-flyway") + implementation("org.springframework.boot:spring-boot-starter-webmvc") + implementation("org.flywaydb:flyway-database-postgresql") + implementation("org.springdoc:springdoc-openapi-starter-webmvc-api:3.1.1") + runtimeOnly("org.postgresql:postgresql") + compileOnly("org.projectlombok:lombok") + annotationProcessor("org.projectlombok:lombok") + errorprone("com.google.errorprone:error_prone_core:2.50.0") + testImplementation("org.springframework.boot:spring-boot-starter-webmvc-test") + testRuntimeOnly("org.junit.platform:junit-platform-launcher") +} + +tasks.withType().configureEach { + options.errorprone.disableWarningsInGeneratedCode = true +} + +tasks.withType { + useJUnitPlatform() +} + +spotless { + java { + googleJavaFormat() + } +} diff --git a/backend/gradle/wrapper/gradle-wrapper.jar b/backend/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..eddabd2eef8d94a5437d6168ff9c87a78ff725b3 GIT binary patch literal 47505 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 '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +# This is normally unused +# shellcheck disable=SC2034 +APP_BASE_NAME=${0##*/} +# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036) +APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + if ! command -v java >/dev/null 2>&1 + then + die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC2039,SC3045 + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC2039,SC3045 + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Collect all arguments for the java command: +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments, +# and any embedded shellness will be escaped. +# * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be +# treated as '${Hostname}' itself on the command line. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \ + "$@" + +# Stop when "xargs" is not available. +if ! command -v xargs >/dev/null 2>&1 +then + die "xargs is not available" +fi + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/backend/gradlew.bat b/backend/gradlew.bat new file mode 100644 index 0000000..a51ec4f --- /dev/null +++ b/backend/gradlew.bat @@ -0,0 +1,82 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem +@rem SPDX-License-Identifier: Apache-2.0 +@rem + +@if "%DEBUG%"=="" @echo off +@rem ########################################################################## +@rem +@rem gradlew startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables, and ensure extensions are enabled +setlocal EnableExtensions + +set DIRNAME=%~dp0 +if "%DIRNAME%"=="" set DIRNAME=. +@rem This is normally unused +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if %ERRORLEVEL% equ 0 goto execute + +echo. 1>&2 +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2 +echo. 1>&2 +echo Please set the JAVA_HOME variable in your environment to match the 1>&2 +echo location of your Java installation. 1>&2 + +"%COMSPEC%" /c exit 1 + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. 1>&2 +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2 +echo. 1>&2 +echo Please set the JAVA_HOME variable in your environment to match the 1>&2 +echo location of your Java installation. 1>&2 + +"%COMSPEC%" /c exit 1 + +:execute +@rem Setup the command line + + + +@rem Execute gradlew +@rem endlocal doesn't take effect until after the line is parsed and variables are expanded +@rem which allows us to clear the local environment before executing the java command +endlocal & "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %* & call :exitWithErrorLevel + +:exitWithErrorLevel +@rem Use "%COMSPEC%" /c exit to allow operators to work properly in scripts +"%COMSPEC%" /c exit %ERRORLEVEL% diff --git a/backend/settings.gradle.kts b/backend/settings.gradle.kts new file mode 100644 index 0000000..85cd6d2 --- /dev/null +++ b/backend/settings.gradle.kts @@ -0,0 +1 @@ +rootProject.name = "app" diff --git a/backend/src/main/java/com/example/app/Application.java b/backend/src/main/java/com/example/app/Application.java new file mode 100644 index 0000000..45cb6f8 --- /dev/null +++ b/backend/src/main/java/com/example/app/Application.java @@ -0,0 +1,18 @@ +package com.example.app; + +import io.swagger.v3.oas.annotations.OpenAPIDefinition; +import io.swagger.v3.oas.annotations.info.Info; +import io.swagger.v3.oas.annotations.servers.Server; +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; + +// Server "/" keeps the generated frontend client on relative URLs, so requests +// go through the Vite proxy in dev and nginx in deploy. +@OpenAPIDefinition(info = @Info(title = "App API", version = "v1"), servers = @Server(url = "/")) +@SpringBootApplication +public class Application { + + public static void main(String[] args) { + SpringApplication.run(Application.class, args); + } +} diff --git a/backend/src/main/java/com/example/app/controller/MessageController.java b/backend/src/main/java/com/example/app/controller/MessageController.java new file mode 100644 index 0000000..82ac491 --- /dev/null +++ b/backend/src/main/java/com/example/app/controller/MessageController.java @@ -0,0 +1,27 @@ +package com.example.app.controller; + +import com.example.app.dto.MessageDTO; +import com.example.app.service.MessageService; +import io.swagger.v3.oas.annotations.Operation; +import java.util.List; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +@RestController +@RequestMapping("/api/messages") +public class MessageController { + + private final MessageService messageService; + + public MessageController(MessageService messageService) { + this.messageService = messageService; + } + + // operationId becomes the function name in the generated frontend client. + @Operation(operationId = "listMessages") + @GetMapping + public List listMessages() { + return messageService.listMessages(); + } +} diff --git a/backend/src/main/java/com/example/app/dao/MessageDAO.java b/backend/src/main/java/com/example/app/dao/MessageDAO.java new file mode 100644 index 0000000..69b41a3 --- /dev/null +++ b/backend/src/main/java/com/example/app/dao/MessageDAO.java @@ -0,0 +1,32 @@ +package com.example.app.dao; + +import com.example.app.dto.MessageDTO; +import com.example.app.entity.Message; +import com.example.app.repository.MessageRepository; +import java.util.List; +import org.springframework.stereotype.Component; + +/** The only class that talks to {@link MessageRepository}. Hands DTOs, never entities, upward. */ +@Component +public class MessageDAO { + + private final MessageRepository repository; + + public MessageDAO(MessageRepository repository) { + this.repository = repository; + } + + public List findAll() { + return repository.findAllByOrderByCreatedAtDescIdDesc().stream() + .map(MessageDAO::toDTO) + .toList(); + } + + private static MessageDTO toDTO(Message message) { + return MessageDTO.builder() + .id(message.getId()) + .text(message.getText()) + .createdAt(message.getCreatedAt()) + .build(); + } +} diff --git a/backend/src/main/java/com/example/app/dto/MessageDTO.java b/backend/src/main/java/com/example/app/dto/MessageDTO.java new file mode 100644 index 0000000..9f6d93e --- /dev/null +++ b/backend/src/main/java/com/example/app/dto/MessageDTO.java @@ -0,0 +1,17 @@ +package com.example.app.dto; + +import java.time.Instant; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Data; +import lombok.NoArgsConstructor; + +@Data +@Builder +@NoArgsConstructor +@AllArgsConstructor +public class MessageDTO { + private long id; + private String text; + private Instant createdAt; +} diff --git a/backend/src/main/java/com/example/app/entity/Message.java b/backend/src/main/java/com/example/app/entity/Message.java new file mode 100644 index 0000000..8755904 --- /dev/null +++ b/backend/src/main/java/com/example/app/entity/Message.java @@ -0,0 +1,29 @@ +package com.example.app.entity; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import java.time.Instant; +import lombok.Getter; +import lombok.Setter; + +// @Getter/@Setter because Lombok's equals/hashCode break JPA entities. +@Entity +@Table(name = "messages") +@Getter +@Setter +public class Message { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(nullable = false, columnDefinition = "text") + private String text; + + @Column(name = "created_at", nullable = false, insertable = false, updatable = false) + private Instant createdAt; +} diff --git a/backend/src/main/java/com/example/app/repository/MessageRepository.java b/backend/src/main/java/com/example/app/repository/MessageRepository.java new file mode 100644 index 0000000..902e566 --- /dev/null +++ b/backend/src/main/java/com/example/app/repository/MessageRepository.java @@ -0,0 +1,12 @@ +package com.example.app.repository; + +import com.example.app.entity.Message; +import java.util.List; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +@Repository +public interface MessageRepository extends JpaRepository { + + List findAllByOrderByCreatedAtDescIdDesc(); +} diff --git a/backend/src/main/java/com/example/app/service/MessageService.java b/backend/src/main/java/com/example/app/service/MessageService.java new file mode 100644 index 0000000..e9cf40a --- /dev/null +++ b/backend/src/main/java/com/example/app/service/MessageService.java @@ -0,0 +1,20 @@ +package com.example.app.service; + +import com.example.app.dao.MessageDAO; +import com.example.app.dto.MessageDTO; +import java.util.List; +import org.springframework.stereotype.Service; + +@Service +public class MessageService { + + private final MessageDAO messageDAO; + + public MessageService(MessageDAO messageDAO) { + this.messageDAO = messageDAO; + } + + public List listMessages() { + return messageDAO.findAll(); + } +} diff --git a/backend/src/main/resources/application.yaml b/backend/src/main/resources/application.yaml new file mode 100644 index 0000000..f78a314 --- /dev/null +++ b/backend/src/main/resources/application.yaml @@ -0,0 +1,31 @@ +# Values in ${...} have no defaults on purpose. Docker Compose injects them +# from .env, so run the app with `mise run dev`. +server: + port: 3000 + # nginx sits in front of the backend and sets X-Forwarded-* headers. + forward-headers-strategy: framework + shutdown: graceful + +spring: + application: + name: app + datasource: + url: jdbc:postgresql://${DB_HOST}:${DB_PORT}/${POSTGRES_DB} + username: ${POSTGRES_USER} + password: ${POSTGRES_PASSWORD} + jpa: + # Flyway owns the schema. Hibernate only checks that the entities match it. + hibernate: + ddl-auto: validate + open-in-view: false + +springdoc: + api-docs: + path: /api/openapi.json + default-produces-media-type: application/json + +management: + endpoints: + web: + exposure: + include: health diff --git a/backend/src/main/resources/db/migration/V1__create_messages.sql b/backend/src/main/resources/db/migration/V1__create_messages.sql new file mode 100644 index 0000000..52ce24b --- /dev/null +++ b/backend/src/main/resources/db/migration/V1__create_messages.sql @@ -0,0 +1,7 @@ +CREATE TABLE messages ( + id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY, + text TEXT NOT NULL, + created_at TIMESTAMPTZ NOT NULL DEFAULT now() +); + +INSERT INTO messages (text) VALUES ('Hello from Postgres!'); diff --git a/compose.override.yaml b/compose.override.yaml new file mode 100644 index 0000000..0d7d500 --- /dev/null +++ b/compose.override.yaml @@ -0,0 +1,32 @@ +# Development overrides, merged automatically by `docker compose` (`mise run dev`). +services: + db: + environment: + # Fails fast with a readable message when .env is missing or incomplete. + POSTGRES_USER: ${POSTGRES_USER:?missing. Run `mise run setup` to create .env} + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?missing. Run `mise run setup` to create .env} + POSTGRES_DB: ${POSTGRES_DB:?missing. Run `mise run setup` to create .env} + ports: + - "127.0.0.1:${POSTGRES_PORT:-5432}:5432" + + backend: + build: + target: local + volumes: + - ./backend/src:/app/src + ports: + # `mise run contract` reads the OpenAPI spec from here. + - "127.0.0.1:3000:3000" + healthcheck: + start_period: 120s + + web: + build: + target: local + environment: + BACKEND_URL: http://backend:3000 + healthcheck: + test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:8080/').then((r) => process.exit(r.ok ? 0 : 1), () => process.exit(1))"] + volumes: + - ./frontend/src:/app/src + - ./contract:/contract diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 0000000..ac9b072 --- /dev/null +++ b/compose.yaml @@ -0,0 +1,54 @@ +# Deploy-like stack: built jar + nginx. `mise run stack` runs this file alone. +# `mise run dev` merges compose.override.yaml on top for development. +services: + db: + image: postgres:18-alpine + restart: unless-stopped + env_file: .env + volumes: + - db-data:/var/lib/postgresql + healthcheck: + test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"] + interval: 5s + timeout: 5s + retries: 10 + + backend: + build: + context: backend + target: deploy + restart: unless-stopped + env_file: .env + environment: + DB_HOST: db + DB_PORT: 5432 + depends_on: + db: + condition: service_healthy + healthcheck: + test: ["CMD", "wget", "-q", "--spider", "http://127.0.0.1:3000/actuator/health"] + interval: 10s + timeout: 5s + retries: 5 + start_period: 60s + + web: + build: + context: . + dockerfile: frontend/Dockerfile + target: deploy + restart: unless-stopped + ports: + - "127.0.0.1:8080:8080" + depends_on: + backend: + condition: service_healthy + healthcheck: + # Alpine resolves localhost to IPv6 first, but nginx only listens on IPv4. + test: ["CMD", "wget", "-q", "--spider", "http://127.0.0.1:8080/"] + interval: 10s + timeout: 5s + retries: 5 + +volumes: + db-data: diff --git a/contract/openapi.json b/contract/openapi.json new file mode 100644 index 0000000..e4681e7 --- /dev/null +++ b/contract/openapi.json @@ -0,0 +1,57 @@ +{ + "openapi": "3.1.0", + "info": { + "title": "App API", + "version": "v1" + }, + "servers": [ + { + "url": "/" + } + ], + "paths": { + "/api/messages": { + "get": { + "tags": [ + "message-controller" + ], + "operationId": "listMessages", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/MessageDTO" + } + } + } + } + } + } + } + } + }, + "components": { + "schemas": { + "MessageDTO": { + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64" + }, + "text": { + "type": "string" + }, + "createdAt": { + "type": "string", + "format": "date-time" + } + } + } + } + } +} diff --git a/frontend/.oxfmtrc.json b/frontend/.oxfmtrc.json new file mode 100644 index 0000000..aeb7441 --- /dev/null +++ b/frontend/.oxfmtrc.json @@ -0,0 +1,4 @@ +{ + "$schema": "./node_modules/oxfmt/configuration_schema.json", + "ignorePatterns": ["src/api/generated/**"] +} diff --git a/frontend/.oxlintrc.json b/frontend/.oxlintrc.json new file mode 100644 index 0000000..12ff3d4 --- /dev/null +++ b/frontend/.oxlintrc.json @@ -0,0 +1,5 @@ +{ + "$schema": "./node_modules/oxlint/configuration_schema.json", + "plugins": ["react", "typescript", "oxc"], + "ignorePatterns": ["src/api/generated/**"] +} diff --git a/frontend/Dockerfile b/frontend/Dockerfile new file mode 100644 index 0000000..42cd641 --- /dev/null +++ b/frontend/Dockerfile @@ -0,0 +1,21 @@ +FROM node:24-slim AS base +RUN corepack enable +WORKDIR /app +COPY frontend/package.json frontend/pnpm-lock.yaml ./ +RUN pnpm install --frozen-lockfile + +# Dev server. compose.override.yaml bind-mounts the source over /app/src. +FROM base AS local +COPY frontend ./ +COPY contract /contract +CMD ["sh", "-c", "pnpm exec openapi-ts && pnpm exec vite"] + +FROM base AS build +COPY frontend ./ +COPY contract /contract +RUN pnpm exec openapi-ts && pnpm run build + +FROM nginxinc/nginx-unprivileged:1.30-alpine AS deploy +COPY frontend/nginx.conf /etc/nginx/conf.d/default.conf +COPY --from=build /app/dist /usr/share/nginx/html +EXPOSE 8080 diff --git a/frontend/index.html b/frontend/index.html new file mode 100644 index 0000000..6e527c8 --- /dev/null +++ b/frontend/index.html @@ -0,0 +1,12 @@ + + + + + + Starter + + +
+ + + diff --git a/frontend/nginx.conf b/frontend/nginx.conf new file mode 100644 index 0000000..09f5bd5 --- /dev/null +++ b/frontend/nginx.conf @@ -0,0 +1,23 @@ +server { + listen 8080; + root /usr/share/nginx/html; + index index.html; + + # Resolving "backend" through Docker's DNS on each request keeps the proxy working + # after the backend container is recreated with a new IP. + resolver 127.0.0.11 valid=10s; + set $backend http://backend:3000; + + location /api/ { + proxy_pass $backend; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto; + } + + # Unknown paths fall back to index.html so client-side routes work on refresh. + location / { + try_files $uri $uri/ /index.html; + } +} diff --git a/frontend/openapi-ts.config.ts b/frontend/openapi-ts.config.ts new file mode 100644 index 0000000..c7e2f48 --- /dev/null +++ b/frontend/openapi-ts.config.ts @@ -0,0 +1,7 @@ +import { defineConfig } from "@hey-api/openapi-ts"; + +export default defineConfig({ + input: "../contract/openapi.json", + output: "src/api/generated", + plugins: ["@hey-api/client-fetch", "@hey-api/sdk"], +}); diff --git a/frontend/package.json b/frontend/package.json new file mode 100644 index 0000000..469b37d --- /dev/null +++ b/frontend/package.json @@ -0,0 +1,25 @@ +{ + "name": "frontend", + "private": true, + "type": "module", + "scripts": { + "dev": "vite", + "build": "vite build" + }, + "dependencies": { + "react": "19.3.1", + "react-dom": "19.3.1" + }, + "devDependencies": { + "@hey-api/openapi-ts": "0.99.0", + "@types/node": "24.19.2", + "@types/react": "19.3.0", + "@types/react-dom": "19.3.0", + "@vitejs/plugin-react": "6.1.2", + "oxfmt": "0.73.0", + "oxlint": "1.88.0", + "typescript": "6.0.3", + "vite": "8.3.4" + }, + "packageManager": "pnpm@12.14.0" +} diff --git a/frontend/pnpm-lock.yaml b/frontend/pnpm-lock.yaml new file mode 100644 index 0000000..801570f --- /dev/null +++ b/frontend/pnpm-lock.yaml @@ -0,0 +1,1542 @@ +--- +lockfileVersion: '9.0' + +importers: + + .: + configDependencies: {} + packageManagerDependencies: + pnpm: + specifier: 12.14.0 + version: 12.14.0 + +packages: + + '@pnpm/exe.android-arm64@12.14.0': + resolution: {integrity: sha512-+iSh7x21C3A2hqc+Z0ZmbKTcn6YNlzrXM142PsnQH/dLj0DYxFzoBvc6XAnL/yfQ5nnH2ebBiRj/zVxr61fZbQ==} + cpu: [arm64] + os: [android] + + '@pnpm/exe.android-x64@12.14.0': + resolution: {integrity: sha512-qT+0LqEr2wBVaxcG2T8cX/R8SSRz2Rvpp8nRR4fh8tnGUZRch87gFmsHUAoSQh7w6j1h0qTjrA384j4xi8frvw==} + cpu: [x64] + os: [android] + + '@pnpm/exe.darwin-arm64@12.14.0': + resolution: {integrity: sha512-tnrdUB8ecJoehuKKqi1YHCBVl61xtJ9XVGcx5EviC6fWO4DeGI8GtXrjvJxDBM3nuVjJeWistgsUp/N142x4sw==} + cpu: [arm64] + os: [darwin] + + '@pnpm/exe.darwin-x64@12.14.0': + resolution: {integrity: sha512-vlBfGkruqQRsEHTW43cPwpYd7QlbIJ//cvpAdb3bVXkI8SgTPoXhCnc05m+ZNiPrrEkBsX/t7KHw9aXpkzPm3Q==} + cpu: [x64] + os: [darwin] + + '@pnpm/exe.freebsd-x64@12.14.0': + resolution: {integrity: sha512-Qg5rxBrGYl6Tfso+EyygPf84fY1Fzy55E/0or+iuYKtnf0vc0MlHJfVIlT7pBukMRntQHRik7hUi0Z4s7AlJsw==} + cpu: [x64] + os: [freebsd] + + '@pnpm/exe.linux-arm64-musl@12.14.0': + resolution: {integrity: sha512-DRIe4yQkXBGA/PhVJdzlbnllxBdAtnMMvTVLLcGpsK5FvJz9kxD2Hyxtn68ovmNkVX06f6p45cQwfm3wx2jn1A==} + cpu: [arm64] + os: [linux] + libc: [musl] + + '@pnpm/exe.linux-arm64@12.14.0': + resolution: {integrity: sha512-7joGShZ44Nk3WpNU+60JoOPjCXlgxhJAq11S2UiVtwCUDgTer1yTPPfxGW8pxaD6046actYLIYDbZNlubHWs0A==} + cpu: [arm64] + os: [linux] + libc: [glibc] + + '@pnpm/exe.linux-ppc64@12.14.0': + resolution: {integrity: sha512-gSoryn7ySdXd//gjgf3MvvA8ZerJayaSbuMZMtAWq4vb2/wlVEgpl0Kvqt54y58TRj533Qjq2txKgnxd4JyoAQ==} + cpu: [ppc64] + os: [linux] + libc: [glibc] + + '@pnpm/exe.linux-riscv64@12.14.0': + resolution: {integrity: sha512-EMjew1H9WqQ7pL+tYqCPwiuB+0PeCiJRV7fyWeuFw0wwYUajFBjcaPO3IGAVu9sdmJDU+e+HYv/Zey6aKae0Vw==} + cpu: [riscv64] + os: [linux] + libc: [glibc] + + '@pnpm/exe.linux-s390x@12.14.0': + resolution: {integrity: sha512-shYOj/SFoXD35fHe0pWr2JofwSXulC0BnEIXLj2QokDi0EF//AfKsui35yKIkTEl+s2VJybc3PO4iJNhKIj5Qw==} + cpu: [s390x] + os: [linux] + libc: [glibc] + + '@pnpm/exe.linux-x64-musl@12.14.0': + resolution: {integrity: sha512-btZiZ2Ot0llKK1ndSfA5i3IRX7/S0VrmzseNH/BJ4c+Cady+S81H6vvU1zByggHMyqQhC8OgxO5PiIY7D9bH0Q==} + cpu: [x64] + os: [linux] + libc: [musl] + + '@pnpm/exe.linux-x64@12.14.0': + resolution: {integrity: sha512-F6K8e/jWxiuEYJaQtRRUG9ynBSTEHa+t7Lf86MKuOO5UA7WVVMbi+oB8nY6iKW++ncWS2yG6T9faXZGxqNsfoQ==} + cpu: [x64] + os: [linux] + libc: [glibc] + + '@pnpm/exe.win32-arm64@12.14.0': + resolution: {integrity: sha512-DOjlkVB6TtTKeAAe0hNZXn5S7YqESmo1Z6SGbR4BZNQ4isRg31XVHjX2RFTbY8gnZq68IwzyLmPqlEjMmYxofg==} + cpu: [arm64] + os: [win32] + + '@pnpm/exe.win32-x64@12.14.0': + resolution: {integrity: sha512-/LSX6mew/sLf08XqcjemuklNKf1K/Ftpgj4//hK/HKzI2dKbmxDB27a/2OaQ5a0O3/3OFzlssXDziZsi+yVBwQ==} + cpu: [x64] + os: [win32] + + pnpm@12.14.0: + resolution: {integrity: sha512-wYum2HmT09Fky16JSPMrLAbuhUSH4GzY2GeBNC+z5btGNDZwNHEehoArqpw3vqkGzhkprQjXCITJfYAd8TOJpg==} + engines: {node: '>=18.*'} + hasBin: true + +snapshots: + + '@pnpm/exe.android-arm64@12.14.0': + optional: true + + '@pnpm/exe.android-x64@12.14.0': + optional: true + + '@pnpm/exe.darwin-arm64@12.14.0': + optional: true + + '@pnpm/exe.darwin-x64@12.14.0': + optional: true + + '@pnpm/exe.freebsd-x64@12.14.0': + optional: true + + '@pnpm/exe.linux-arm64-musl@12.14.0': + optional: true + + '@pnpm/exe.linux-arm64@12.14.0': + optional: true + + '@pnpm/exe.linux-ppc64@12.14.0': + optional: true + + '@pnpm/exe.linux-riscv64@12.14.0': + optional: true + + '@pnpm/exe.linux-s390x@12.14.0': + optional: true + + '@pnpm/exe.linux-x64-musl@12.14.0': + optional: true + + '@pnpm/exe.linux-x64@12.14.0': + optional: true + + '@pnpm/exe.win32-arm64@12.14.0': + optional: true + + '@pnpm/exe.win32-x64@12.14.0': + optional: true + + pnpm@12.14.0: + optionalDependencies: + '@pnpm/exe.android-arm64': 12.14.0 + '@pnpm/exe.android-x64': 12.14.0 + '@pnpm/exe.darwin-arm64': 12.14.0 + '@pnpm/exe.darwin-x64': 12.14.0 + '@pnpm/exe.freebsd-x64': 12.14.0 + '@pnpm/exe.linux-arm64': 12.14.0 + '@pnpm/exe.linux-arm64-musl': 12.14.0 + '@pnpm/exe.linux-ppc64': 12.14.0 + '@pnpm/exe.linux-riscv64': 12.14.0 + '@pnpm/exe.linux-s390x': 12.14.0 + '@pnpm/exe.linux-x64': 12.14.0 + '@pnpm/exe.linux-x64-musl': 12.14.0 + '@pnpm/exe.win32-arm64': 12.14.0 + '@pnpm/exe.win32-x64': 12.14.0 + +--- +lockfileVersion: '9.0' + +settings: + autoInstallPeers: true + excludeLinksFromLockfile: false + +importers: + + .: + dependencies: + react: + specifier: 19.3.1 + version: 19.3.1 + react-dom: + specifier: 19.3.1 + version: 19.3.1(react@19.3.1) + devDependencies: + '@hey-api/openapi-ts': + specifier: 0.99.0 + version: 0.99.0(typescript@6.0.3) + '@types/node': + specifier: 24.19.2 + version: 24.19.2 + '@types/react': + specifier: 19.3.0 + version: 19.3.0 + '@types/react-dom': + specifier: 19.3.0 + version: 19.3.0(@types/react@19.3.0) + '@vitejs/plugin-react': + specifier: 6.1.2 + version: 6.1.2(vite@8.3.4(@types/node@24.19.2)(jiti@2.7.0)) + oxfmt: + specifier: 0.73.0 + version: 0.73.0 + oxlint: + specifier: 1.88.0 + version: 1.88.0 + typescript: + specifier: 6.0.3 + version: 6.0.3 + vite: + specifier: 8.3.4 + version: 8.3.4(@types/node@24.19.2)(jiti@2.7.0) + +packages: + + '@hey-api/codegen-core@0.9.1': + resolution: {integrity: sha512-s97jL1dgTMuiMHv2BZ1X4Tgd99Mf9GOvGdNqNcGwIMmnR+PgYNoraj4Zvp134MKsNCap/m7k0r0vKKnl56pj4w==} + engines: {node: '>=22.18.0'} + + '@hey-api/json-schema-ref-parser@1.4.4': + resolution: {integrity: sha512-otmd+zCxbYVBIp/mlMTnGkvlNYLkVKgs3VOIq0kSnenhB1+fRwLPQIeSwyWM6E51oXhUedkYjVsVpkVexeuJOA==} + engines: {node: '>=22.18.0'} + + '@hey-api/openapi-ts@0.99.0': + resolution: {integrity: sha512-SePU/5oEWWkvUBYmvzdYRctseoLuskyhs4ET0RvLIcmzc8yLQoA2R+KtBIQ8bPsoSUB0m4E5SmBnl6aGSA0szQ==} + engines: {node: '>=22.18.0'} + hasBin: true + peerDependencies: + typescript: '>=5.5.3 || >=6.0.0 || 6.0.1-rc' + + '@hey-api/shared@0.5.0': + resolution: {integrity: sha512-JN/j4Ebh4cJGYIQ5cwWuqe7GeSUyQoz7oC51WqyhKOcrejK6DKZMDkshc5d1eKTRuRL+rjozuRcoUaZZn2DGPw==} + engines: {node: '>=22.18.0'} + + '@hey-api/spec-types@0.2.0': + resolution: {integrity: sha512-ibQ8Is7evMavzr8GNyJCcTg975d8DpaMUyLmOrQ85UBdy1l6t1KuRAwgChAbesJsIlNV6gjmlXruWyegDX18Fg==} + + '@hey-api/types@0.1.4': + resolution: {integrity: sha512-thWfawrDIP7wSI9ioT13I5soaaqB5vAPIiZmgD8PbeEVKNrkonc0N/Sjj97ezl7oQgusZmaNphGdMKipPO6IBg==} + + '@jsdevtools/ono@7.1.3': + resolution: {integrity: sha512-4JQNk+3mVzK3xh2rqd6RB4J46qUR19azEHBneZyTZM+c456qOrbbM/5xcR8huNCCcbVt7+UmizG6GuUvPvKUYg==} + + '@lukeed/ms@2.0.2': + resolution: {integrity: sha512-9I2Zn6+NJLfaGoz9jN3lpwDgAYvfGeNYdbAIjJOqzs4Tpc+VU3Jqq4IofSUBKajiDS8k9fZIg18/z13mpk1bsA==} + engines: {node: '>=8'} + + '@oxc-project/types@0.154.0': + resolution: {integrity: sha512-KYOUGQFlLWR+s4QMV2Q9ko38TZm7EdO87Qm7rvZLqk/webse/cDjtyxKhg/47l0byCbs/k46LT8qc4PKjAikzA==} + + '@oxfmt/binding-android-arm-eabi@0.73.0': + resolution: {integrity: sha512-dhunAdMbi/4o0Y66/+Wl6rpsNqpvE4i26Qw6bB77A97L2lJoktWg6m+X9QOon8iOEEqzD9rEZqFi5uZ4oIzhCA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [android] + + '@oxfmt/binding-android-arm64@0.73.0': + resolution: {integrity: sha512-dBoypjC2/xeyKyIhN2waX0/XeoccH9k0lVVe+sGRc4X8HSJVRtqyZDoXdr7bGY9A75c51dX0z0dLDpGQKwCdCg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [android] + + '@oxfmt/binding-darwin-arm64@0.73.0': + resolution: {integrity: sha512-Tn7Y+qWIpCQK+qdYwBcn6YvqeBuPiuG3tcNlYg16a5QL2o3rSmrgBB1nCyYqo0uvc1LNrfQW9/CK2tzFuID/Fg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [darwin] + + '@oxfmt/binding-darwin-x64@0.73.0': + resolution: {integrity: sha512-yVb0E0tg/+9Xc9YJCBq66qF1DC/aN5mhb5nnHz0k4ikwkMANtSul2VPDSwjYdXR6/DFimc+pPUgLBqkIa5Ctuw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [darwin] + + '@oxfmt/binding-freebsd-x64@0.73.0': + resolution: {integrity: sha512-IKR4lFnBkYNL9Uqdxa5GMTQLvnLj+3sDwTvh2atHCzah0xeo+1xR5bigRU8uyXlOsA4VpXUn0UAimq4E4RBGmQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [freebsd] + + '@oxfmt/binding-linux-arm-gnueabihf@0.73.0': + resolution: {integrity: sha512-7qnZ4g0ZCO3aZevOOQpZIABYwwXJW1lLDo2elviGdPQ0i11255xKEMFsi97fC1/nauQFseCJfELUy/k2JoOP+g==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [linux] + + '@oxfmt/binding-linux-arm-musleabihf@0.73.0': + resolution: {integrity: sha512-36eBico2j/WPB84gb4FYd/jjqGCKOwU4M+TWLBUIqlnzTozQueLy0joA5BwsSp2OZFVkOlpCwvA3ndPamdiyLw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [linux] + + '@oxfmt/binding-linux-arm64-gnu@0.73.0': + resolution: {integrity: sha512-VZ3cSgCAT18knKo52DcACmAuIoqG6qVEyeZRFbJd0xmYQ8GyYjuBc6IAh6MZHijT6q7p4/HPI+6ZWsCuhdV6iw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + libc: [glibc] + + '@oxfmt/binding-linux-arm64-musl@0.73.0': + resolution: {integrity: sha512-8YVzH59XSHcqwXNgc5qK851zCqwpmBgOifARXEPPe5/xTsIbHceYoPZAyqfpYV0CfKmzSaEDBgYHFza4rhx+Zw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + libc: [musl] + + '@oxfmt/binding-linux-ppc64-gnu@0.73.0': + resolution: {integrity: sha512-MqRJnmCys0rwOgpWyEidSA7v/bvOqfNDJhPkQoR9mPVYrvSmMaW2Xhdpl28cbTA+brOM1is62GjIvJplVlUVpw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [ppc64] + os: [linux] + libc: [glibc] + + '@oxfmt/binding-linux-riscv64-gnu@0.73.0': + resolution: {integrity: sha512-4t2F3SWJSK/O/kRRFnL0elJzn75fJGGu71gs1HtiWcS80SmJOpkHiwwLnTp9suGdns8VHEPxYS0GTcyVwHKWBA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [riscv64] + os: [linux] + libc: [glibc] + + '@oxfmt/binding-linux-riscv64-musl@0.73.0': + resolution: {integrity: sha512-D8b4I8I1kLdJQFwdFXNV+cwh3xWSiNKofjdGUk0nDpc0AHOds8T+poGbP9RWQMvgsvMb9OMgp/aV7ahBR37TbQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [riscv64] + os: [linux] + libc: [musl] + + '@oxfmt/binding-linux-s390x-gnu@0.73.0': + resolution: {integrity: sha512-QrC1S5VL1+N5rvorB15jH7CPvjVHA7GyUI5oVEd8Bd9m5605RDBQYTxDQ920DuylRoZOh2V7/xXpfCtFUrojUQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [s390x] + os: [linux] + libc: [glibc] + + '@oxfmt/binding-linux-x64-gnu@0.73.0': + resolution: {integrity: sha512-dFcUKQPltCEPa+YlkF3zqufn6nJPZdG73LpnjBvZFFsU3laCMssDXSYB99mVaj43FqdEgjpz5TO6gbYXcczd9g==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + libc: [glibc] + + '@oxfmt/binding-linux-x64-musl@0.73.0': + resolution: {integrity: sha512-LmQe+nV8e+eUwfPNCxDF+owbsg88toBiR/8rZRgVOeKQP3MaGefXZRvBoc1UG37iWEQ/9JlCXG9Mc4nf4N3agw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + libc: [musl] + + '@oxfmt/binding-openharmony-arm64@0.73.0': + resolution: {integrity: sha512-8weOr1OKknE0G2DbR6ejJUT9AOsoBU6cXlsetmbihHv1K+bK7qP61T6lJxY0k/aAO7GyOJiRGNlL+04r4eH8Xg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [openharmony] + + '@oxfmt/binding-win32-arm64-msvc@0.73.0': + resolution: {integrity: sha512-mZV+QxXYgb8E18gzAFItb937VIsE4dqWdStrD3tRRC52UubOYEuU+e7NaIqUsGdB5YsJqNeuck3Ue/af2r9wyA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [win32] + + '@oxfmt/binding-win32-ia32-msvc@0.73.0': + resolution: {integrity: sha512-QJPUsbgUb97ZPPMkFUq6VQq0fLhC4Np19KL9aB/qKVwXnpKE6MIiILXqzhKnQ/UbnEDjKJ7Xv1d6zH4bYPCUdQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [ia32] + os: [win32] + + '@oxfmt/binding-win32-x64-msvc@0.73.0': + resolution: {integrity: sha512-cGcze2fu+ykIaFtkEvZlkZ3HvnCLk+WISthtq99zWTWn0x13t5L9TxvGdLZMUMvtfYR+ICkiCwKnguVubdcw0w==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [win32] + + '@oxlint/binding-android-arm-eabi@1.88.0': + resolution: {integrity: sha512-k6Fgkf86ubfeH4GvqYsRolfuVAp0pfYVZvifSlXNHPdMaWUOfxUrmLEeDD7hF6U2oJuhsVxhSWq86/xCJ+9MmA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [android] + + '@oxlint/binding-android-arm64@1.88.0': + resolution: {integrity: sha512-AsIyhl9o1ejwtac7NMbhKpMdSml6NWR0ljKjZERxC8OHYDAW8o/Om9n1QHVLi4VCEUo42Zte2/Op9kyoGpJZMg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [android] + + '@oxlint/binding-darwin-arm64@1.88.0': + resolution: {integrity: sha512-qgBjB7eEKcCB4RqjXGuoSZq74g0wD09fWFJ+HWcCJcKaga8TeUHtb+BY0SsxdleSLBgx4RZ7qmgo0EzqEq7JoQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [darwin] + + '@oxlint/binding-darwin-x64@1.88.0': + resolution: {integrity: sha512-sCz3X5Mw/xdzEzn4fsCt1Iq8NKJnGNfhR+b9B5k+4DysYAHsmIhYoocnBPiQ9kvY3+pUun2A0Z8Vtun/Nv6YoQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [darwin] + + '@oxlint/binding-freebsd-x64@1.88.0': + resolution: {integrity: sha512-xTOdYOIqCufgIj0knvxu86FBfovP6QBiD7ngNva01gb8xPQCD5gXkE5APGczH35zStim1O3zqvFbLQmY85xXRg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [freebsd] + + '@oxlint/binding-linux-arm-gnueabihf@1.88.0': + resolution: {integrity: sha512-BLadtw88NdYJBrAtC1dYzrPfSP2d5zgx6iuZycdD0YmZBJ2Nqbit9Z4PSaIb6gxK25dweArGMPbOmq/0ugwUPg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [linux] + + '@oxlint/binding-linux-arm-musleabihf@1.88.0': + resolution: {integrity: sha512-wILSczl/DaZsCcf7j7tvNbssp8hxEHIJxrv4j7+JjI3TAL1U/JTWbeUtoJJC/vo8+2hkTmHLYoKJjmiNbijdXw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [linux] + + '@oxlint/binding-linux-arm64-gnu@1.88.0': + resolution: {integrity: sha512-jutT2Hy8JCuZuMwIFHo2HtyxfOfBJHyQxlBHBK1SL9W2f8n/WhjAP0FnDMz9d/mjhv9+QA0mx5AdQ9fDjsrFFg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + libc: [glibc] + + '@oxlint/binding-linux-arm64-musl@1.88.0': + resolution: {integrity: sha512-8N8iGV9hh4Lkeuq7QsEkjoXNRRflqR1G2qyoGYXcA0k5qllrdqmfylKEXyHIVERxqNDyMO4StqDQ0uLxXcBQAg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + libc: [musl] + + '@oxlint/binding-linux-ppc64-gnu@1.88.0': + resolution: {integrity: sha512-5ydcQt3znNQ/rGEWYRvpS2cK9+T18P2VYgnyJ+eloEAwi9YUmsXy5VGrRqNWIK6qzWwHGnEE3ojVqqQNo+f0hA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [ppc64] + os: [linux] + libc: [glibc] + + '@oxlint/binding-linux-riscv64-gnu@1.88.0': + resolution: {integrity: sha512-iGx0uvFT54b/5DPJdEBCxYIrVB3v0uTy+JhRh3CyEp8/22BXDkG8rffkFwREdLsdj9mOrPbJYVOZw8ipcBuzjw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [riscv64] + os: [linux] + libc: [glibc] + + '@oxlint/binding-linux-riscv64-musl@1.88.0': + resolution: {integrity: sha512-Wt47mKMWelVjRjuR7BCFxXkB0m79K1sTEbqMHRWciKUgo5iv7sWsF4RXSOyFYHD9zerNrkRZblnN273rhwOA1Q==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [riscv64] + os: [linux] + libc: [musl] + + '@oxlint/binding-linux-s390x-gnu@1.88.0': + resolution: {integrity: sha512-g3L12KCS4+1gtUt3RbJ4F+Yxx4LNmmZLEPfhd8rAHEJjJk2lAgNfnjGoP/phJyhG5WS6VbNYbJtadJelNfvTMA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [s390x] + os: [linux] + libc: [glibc] + + '@oxlint/binding-linux-x64-gnu@1.88.0': + resolution: {integrity: sha512-og/XHVDOD9ZJgRiZkT9DgzQd4sr+JZW7e4l17Q/jVMZiIbeEd4uIu9iAoUbTF1gIvVZoRc4QDOxyVUvQGp4WHg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + libc: [glibc] + + '@oxlint/binding-linux-x64-musl@1.88.0': + resolution: {integrity: sha512-EmhBsp+xuKb6YbZNEMLBo80Xw71AZOIm18do8ni/GLX/Lw1XzNhVYpbxO1KasYtoAvrGtCOdCPULRlIE0bPbTQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + libc: [musl] + + '@oxlint/binding-openharmony-arm64@1.88.0': + resolution: {integrity: sha512-DBUcx/KwYdg1DAz+G01P/GFv512J04EsZadbHptx2FTpWT/MWRg21ZToNHt9pnsfQRBQ3et/g+vqzbvrdAVbuA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [openharmony] + + '@oxlint/binding-win32-arm64-msvc@1.88.0': + resolution: {integrity: sha512-xeVd0n4XG5HvynxfYvXi6uB+JvZbVZataowPS8cYpMbYg9mwE4sSyElFQd4LVJFifq8bRLDSR18XgEildmcXAg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [win32] + + '@oxlint/binding-win32-ia32-msvc@1.88.0': + resolution: {integrity: sha512-MA6iOw//amleaz2mVMsZrA7NHlEexjTrhIxSMFCXQi6IUuQO+3Od00GZhr2iCYw6RFzMW36jkKK/WHBXMsoQAw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [ia32] + os: [win32] + + '@oxlint/binding-win32-x64-msvc@1.88.0': + resolution: {integrity: sha512-3Sz6rVWe8Dy+ufsXurFN1GX2dX43F/lQMSLelK9gFjiba7nHvLlqlhR5cHlWVnCpSqUY1hN9pyCX9XToe6ve6g==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [win32] + + '@rolldown/binding-android-arm-eabi@1.2.14': + resolution: {integrity: sha512-aWR+XKH9+rW7m5fWq/5360J3mHycrx/o6xZM2DQFdJnTMdyP7/WzxPjhtLbVWdKo2y612/4U1bWqb3HQhiF7vg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [android] + + '@rolldown/binding-android-arm64@1.2.14': + resolution: {integrity: sha512-QiVxHofl6A8lQU7WAtOUY4QMVZXohxwz7WJJoeh8NBEUyKfIkMRKhYyq8az/1RypNiIXzNTtiS6KwHz0erxYRQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [android] + + '@rolldown/binding-darwin-arm64@1.2.14': + resolution: {integrity: sha512-lTQOzHuBIooh3jIr5XINQkjPGEuGy+Dsy0meXDr6Sjty0b99kYgGh4uBC/8mJX1T0kC8d6S0aPP1Y+bHkh6aBw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [darwin] + + '@rolldown/binding-darwin-x64@1.2.14': + resolution: {integrity: sha512-hyMKEGatjmBYCs/Q4sbIcL/GqpFEqsX3wc+HYVQ/85A4rxc1o7rPm4DUI4GV4k/h0ITddwFSGpqQunI14GXjTA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [darwin] + + '@rolldown/binding-freebsd-x64@1.2.14': + resolution: {integrity: sha512-u371GbXoVXrEgP20PwzoGNOdAOqAMhzo19JzzY+V4YmmnC+DTOoqdbMu+O+54emM59Mik/UdrtWgcuEDKWRPKA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [freebsd] + + '@rolldown/binding-linux-arm-gnueabihf@1.2.14': + resolution: {integrity: sha512-BqwKsdZQf6EqVWr8fv2MrDYzAvOZ7+NYFSJESRGs87fkseEhs0TU9TXgRJTkZoRRkxTizyEg1LKUXfU3/78uqg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [linux] + + '@rolldown/binding-linux-arm64-gnu@1.2.14': + resolution: {integrity: sha512-SD9kY8M009x/7s57Z1dgUVlP5+uYBgKQK0Tkr1WIWngrtUJmRCW1RJFMY7QDla2khXhmg2i5Io7MUjcmZNZ/KQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + libc: [glibc] + + '@rolldown/binding-linux-arm64-musl@1.2.14': + resolution: {integrity: sha512-BJ2CL19M6uuWesMgnqJzgxoI+N+eV7b0A9O9vLV42y+gitC41fNa8KElau1tHVzuLWX5GzEuxMPhAO0tQXQMkg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + libc: [musl] + + '@rolldown/binding-linux-ppc64-gnu@1.2.14': + resolution: {integrity: sha512-4+Kl8daPV8NDHaD7mfCcc1pRM+Qg7ab8DyMm5FG5WoZgv4h2i3KFN1CybYBNbQqmuYm7ftJLvmMI1eHYJ22S/Q==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [ppc64] + os: [linux] + libc: [glibc] + + '@rolldown/binding-linux-s390x-gnu@1.2.14': + resolution: {integrity: sha512-V/h8ePq1fKDrmtFMz6xcCN3DKvuvMRrwwD1q0PkBeeo4DpK64biaKvqWGVxqCeYKqeRk7gE7/iKPxLCn08O97A==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [s390x] + os: [linux] + libc: [glibc] + + '@rolldown/binding-linux-x64-gnu@1.2.14': + resolution: {integrity: sha512-WxalXzgrLVpKC93xfpaJ3gCXUWzeCr+FRCbDVD2mUAy4L6Vo3lNVz0epUEUpxPWJkLNYUwM4OSIikv36OJ9mLg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + libc: [glibc] + + '@rolldown/binding-linux-x64-musl@1.2.14': + resolution: {integrity: sha512-3G3tnAmTpdk9jO3GQtyHXqeFD2SlecfTws/Y3M2mmj9nMBwwuLT4kur8sZKeu7ENUHSpVO3cIsm5A52LEWWwlg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + libc: [musl] + + '@rolldown/binding-openharmony-arm64@1.2.14': + resolution: {integrity: sha512-qyr5XiNGxm2ytx17vvtcJ9nXn6v1gENETi503bJx3OGwZ1tSonj7BosxbMa/xeAfSl5iS9X6KjEWYXLu6v1L7Q==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [openharmony] + + '@rolldown/binding-win32-arm64-msvc@1.2.14': + resolution: {integrity: sha512-oA4o5o0S2yB199YyYXDzKUv1Z56Rc+mgOjwm7Z/vJ9Z8igiDPYvoOuDyo6g7AK/ZaF09nPhDKVnGBcYHO11GXA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [win32] + + '@rolldown/binding-win32-x64-msvc@1.2.14': + resolution: {integrity: sha512-9mE94bf2GZUaR/fUSXCMpBoWkctu421Mi0ORpm4zqfbkjKep7RxzPFa5etcGs5h+2KApoWBOA/hAJa/7saGgEQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [win32] + + '@rolldown/pluginutils@1.0.1': + resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==} + + '@types/json-schema@7.0.15': + resolution: {integrity: sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==} + + '@types/node@24.19.2': + resolution: {integrity: sha512-93d49wCWJkCyN87MxLpNN6KXPCwFw7bVUg79mGUV1OS40JGWwVCr8n61DXCSqz7CV6/VfPkb7xec7uP2M+QHWQ==} + + '@types/react-dom@19.3.0': + resolution: {integrity: sha512-ZI7bU42mZXXKHn/qNLEw2IrbiINU7X5+vfgdixBHkCNpYWXjKgfQ/P+uyGb5CjOLB9UcnTeg3rylQtV2hym44Q==} + peerDependencies: + '@types/react': ^19.3.0 + + '@types/react@19.3.0': + resolution: {integrity: sha512-N0rFCuH9YoxG9/m61l9MfpJKfmLOVU0em7ipIz6TRgSSkvReLB9vL85GB+yr8Bs5leqpvg96JSwF4ZS1s4viQg==} + + '@vitejs/plugin-react@6.1.2': + resolution: {integrity: sha512-fhJNGUdscQa4HkI0xFxwonWyhnVReCPDbXI7FH7jmzpnVCrFQI7PRrhWecO263610vOrs9tr2Y4xcf8uAdFxbw==} + engines: {node: ^20.19.0 || >=22.12.0} + peerDependencies: + '@rolldown/plugin-babel': ^0.1.7 || ^0.2.0 + babel-plugin-react-compiler: ^1.0.0 + oxc-transform-react: ^0.152.0 + vite: ^8.0.0 + peerDependenciesMeta: + '@rolldown/plugin-babel': + optional: true + babel-plugin-react-compiler: + optional: true + oxc-transform-react: + optional: true + + ansi-colors@4.1.3: + resolution: {integrity: sha512-/6w/C21Pm1A7aZitlI5Ni/2J6FFQN8i1Cvz3kHABAAbw93v/NlvKdVOqz7CCWz/3iv/JplRSEEZ83XION15ovw==} + engines: {node: '>=6'} + + argparse@2.0.1: + resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==} + + bundle-name@4.1.1: + resolution: {integrity: sha512-DdH81/zPLVS11EUgWq3tEu/xn+EzljlMYooDNdzWEnFha3R3NBMpMV1UqYIpjYHV/SgpFKMIX1Oh7o06SjM/oA==} + engines: {node: '>=18'} + + c12@3.3.4: + resolution: {integrity: sha512-cM0ApFQSBXuourJejzwv/AuPRvAxordTyParRVcHjjtXirtkzM0uK2L9TTn9s0cXZbG7E55jCivRQzoxYmRAlA==} + peerDependencies: + magicast: '*' + peerDependenciesMeta: + magicast: + optional: true + + chokidar@5.0.0: + resolution: {integrity: sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==} + engines: {node: '>= 20.19.0'} + + color-support@1.1.3: + resolution: {integrity: sha512-qiBjkpbMLO/HL68y+lh4q0/O1MZFj2RX6X/KmMa3+gJD3z+WwI1ZzDHysvqHGS3mP6mznPckpXmw1nI9cJjyRg==} + hasBin: true + + commander@15.0.0: + resolution: {integrity: sha512-z67u4ZhzCL/Tydu1lJARtEZYWbWaN7oYLHbsuzocr6y4N6WZAagG3RQ4FW61V1/0+jImpj293XfrcYnd1qxtPg==} + engines: {node: '>=22.12.0'} + + confbox@0.2.4: + resolution: {integrity: sha512-ysOGlgTFbN2/Y6Cg3Iye8YKulHw+R2fNXHrgSmXISQdMnomY6eNDprVdW9R5xBguEqI954+S6709UyiO7B+6OQ==} + + confbox@0.3.1: + resolution: {integrity: sha512-cKUSoKa8YxFZZSmraVi7onONx3amu77ngK3kGpsYHDH7drPwCRkQE1RYMPlLRrMtnciRj274XNRxcHxnKmDSnA==} + + cross-spawn@7.0.6: + resolution: {integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==} + engines: {node: '>= 8'} + + csstype@3.2.3: + resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==} + + default-browser-id@5.0.1: + resolution: {integrity: sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==} + engines: {node: '>=18'} + + default-browser@5.5.1: + resolution: {integrity: sha512-m1pAzaJgZ/gssEqlOhJkPJp8Xly7QyW6xcrkUa2KKcDeDSEMP7X8xipU3snUcfisTQx0w1AGae+9UtJSfVnXGw==} + engines: {node: '>=18'} + + define-lazy-prop@3.0.0: + resolution: {integrity: sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==} + engines: {node: '>=12'} + + defu@6.1.7: + resolution: {integrity: sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==} + + destr@2.0.5: + resolution: {integrity: sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==} + + detect-libc@2.1.2: + resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==} + engines: {node: '>=8'} + + dotenv@17.4.2: + resolution: {integrity: sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw==} + engines: {node: '>=12'} + + exsolve@1.1.3: + resolution: {integrity: sha512-kuzL9zherLQoqDeQaS55AiiIg1kb4KYXaSusTtgZTPlvKP2gGCI82LNmBNh5RjDVUXIcmgx+/Mx7vPwRzBbhJA==} + + fdir@6.5.0: + resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==} + engines: {node: '>=12.0.0'} + peerDependencies: + picomatch: ^3 || ^4 + peerDependenciesMeta: + picomatch: + optional: true + + fsevents@2.3.3: + resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==} + engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0} + os: [darwin] + + get-tsconfig@4.14.0: + resolution: {integrity: sha512-yTb+8DXzDREzgvYmh6s9vHsSVCHeC0G3PI5bEXNBHtmshPnO+S5O7qgLEOn0I5QvMy6kpZN8K1NKGyilLb93wA==} + + giget@3.3.1: + resolution: {integrity: sha512-r+mvuDjrjMpsdw46Kmeydb8bdHm7wOKw8wNBtTndkjbPjgAp5oUJUxRE76wZFknxIPokfWvep2qSXK37aXE6zg==} + hasBin: true + + is-docker@3.0.0: + resolution: {integrity: sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} + hasBin: true + + is-in-ssh@1.0.0: + resolution: {integrity: sha512-jYa6Q9rH90kR1vKB6NM7qqd1mge3Fx4Dhw5TVlK1MUBqhEOuCagrEHMevNuCcbECmXZ0ThXkRm+Ymr51HwEPAw==} + engines: {node: '>=20'} + + is-inside-container@1.0.0: + resolution: {integrity: sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==} + engines: {node: '>=14.16'} + hasBin: true + + is-wsl@3.1.1: + resolution: {integrity: sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==} + engines: {node: '>=16'} + + isexe@2.0.0: + resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==} + + jiti@2.7.0: + resolution: {integrity: sha512-AC/7JofJvZGrrneWNaEnJeOLUx+JlGt7tNa0wZiRPT4MY1wmfKjt2+6O2p2uz2+skll8OZZmJMNqeke7kKbNgQ==} + hasBin: true + + js-yaml@4.2.0: + resolution: {integrity: sha512-ePWsvanv0DWuDRsW8dnt+R4jQ31SCRCQ7hhNcPXZPsoBZiemuZNYGf7adZdqX2D86j6rvKp3RpCxVTSb8WQlOw==} + hasBin: true + + lightningcss-android-arm64@1.33.0: + resolution: {integrity: sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [android] + + lightningcss-darwin-arm64@1.33.0: + resolution: {integrity: sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [darwin] + + lightningcss-darwin-x64@1.33.0: + resolution: {integrity: sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [darwin] + + lightningcss-freebsd-x64@1.33.0: + resolution: {integrity: sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [freebsd] + + lightningcss-linux-arm-gnueabihf@1.33.0: + resolution: {integrity: sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==} + engines: {node: '>= 12.0.0'} + cpu: [arm] + os: [linux] + + lightningcss-linux-arm64-gnu@1.33.0: + resolution: {integrity: sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [linux] + libc: [glibc] + + lightningcss-linux-arm64-musl@1.33.0: + resolution: {integrity: sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [linux] + libc: [musl] + + lightningcss-linux-x64-gnu@1.33.0: + resolution: {integrity: sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [linux] + libc: [glibc] + + lightningcss-linux-x64-musl@1.33.0: + resolution: {integrity: sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [linux] + libc: [musl] + + lightningcss-win32-arm64-msvc@1.33.0: + resolution: {integrity: sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [win32] + + lightningcss-win32-x64-msvc@1.33.0: + resolution: {integrity: sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [win32] + + lightningcss@1.33.0: + resolution: {integrity: sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==} + engines: {node: '>= 12.0.0'} + + nanoid@3.3.20: + resolution: {integrity: sha512-uKdg2G3GNCKQn9byYOpxbGqrT2fGO5KRt5J/8b3pok8rT6qxGWF6hxMyJiEYtAf+FVyYuD9hRaDqX5uPFYJ4ZQ==} + engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1} + hasBin: true + + ohash@2.0.12: + resolution: {integrity: sha512-65S/5gk9YSsaRjcyf7Nfa6h/d3E8/1gslpXfI4W7Dxn/oap8IKRuNT5VXkLQ1YFKIEg4apRY4Pj6aiwFzrDdmw==} + + open@11.0.0: + resolution: {integrity: sha512-smsWv2LzFjP03xmvFoJ331ss6h+jixfA4UUV/Bsiyuu4YJPfN+FIQGOIiv4w9/+MoHkfkJ22UIaQWRVFRfH6Vw==} + engines: {node: '>=20'} + + oxfmt@0.73.0: + resolution: {integrity: sha512-Ke4xbpuzqIBP4bkd48q815RhqWNJqOBzxVA9199M4qcF0y0LtpUv7UTg1dJ5ea6jw0RBUDZvX3qOUMNmmxfxbw==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + peerDependencies: + '@astrojs/compiler-rs': ^0.4.0 || ^0.5.0 + svelte: ^5.0.0 + vite-plus: '*' + peerDependenciesMeta: + '@astrojs/compiler-rs': + optional: true + svelte: + optional: true + vite-plus: + optional: true + + oxlint@1.88.0: + resolution: {integrity: sha512-uIcFgw8BmqvFRGzH5+r7d2zJMEexwNSrEmM6WQNnGh3VkO0XYTEFoyxyNE6tjKMUib9Cue4XJA2DoWruO5D6aw==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + peerDependencies: + oxlint-tsgolint: '>=7.0.2003' + vite-plus: '*' + peerDependenciesMeta: + oxlint-tsgolint: + optional: true + vite-plus: + optional: true + + path-key@3.1.1: + resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==} + engines: {node: '>=8'} + + pathe@2.0.3: + resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==} + + perfect-debounce@2.1.0: + resolution: {integrity: sha512-LjgdTytVFXeUgtHZr9WYViYSM/g8MkcTPYDlPa3cDqMirHjKiSZPYd6DoL7pK8AJQr+uWkQvCjHNdiMqsrJs+g==} + + picocolors@1.1.1: + resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==} + + picomatch@4.0.7: + resolution: {integrity: sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==} + engines: {node: '>=12'} + + pkg-types@2.3.3: + resolution: {integrity: sha512-j/lCFdcppV0JxWpCEITdbDltBxPP6cHT+yNJ6Go2OgoSA9518X847X9z0p6LtA4Nc16+eQzCZjRrWanTGvHJ5w==} + + postcss@8.5.31: + resolution: {integrity: sha512-YUbWYCgErwnMAVkjUnYa+KlMBzGpHwiIt/DE7f0G33AuX2LH9UcTk6KgWxd3zRU+pN3u/C+Xl3EnMLM4Hea7Sg==} + engines: {node: ^10 || ^12 || >=14} + + powershell-utils@0.1.0: + resolution: {integrity: sha512-dM0jVuXJPsDN6DvRpea484tCUaMiXWjuCn++HGTqUWzGDjv5tZkEZldAJ/UMlqRYGFrD/etByo4/xOuC/snX2A==} + engines: {node: '>=20'} + + rc9@3.1.0: + resolution: {integrity: sha512-ufjkNVzbRHKcCOmTahZkmVsyc3W+MSk3jY03m+a7tGHkIsdVMG9l10/3HvFbWkkKzY5VFp3pkRsIo/UYgmFL7Q==} + + react-dom@19.3.1: + resolution: {integrity: sha512-Y0bARz53lhEC1NMCASs0/j+faB/zqt3R8hpvg1e8+61ZVJ4UL0UdC4cBbXfZMcIuhrfgeILTLe+ZeBCavQPtKQ==} + peerDependencies: + react: ^19.3.1 + + react@19.3.1: + resolution: {integrity: sha512-QNhWdt7nrgVWWQG58QuGsAR3jv3Hbe4mb4vz7w2csnHavciZJgda1CPNaldF6eVxv90ud3jUXpKlHL69gO38yw==} + engines: {node: '>=0.10.0'} + + readdirp@5.1.1: + resolution: {integrity: sha512-Kko+Y5XQ6fM+Ce3dq3m9YGxnacYZYl9cA1wZjaF3Vbry2L3i1qVg8+CAgNPsXRArPMUMCaOR7oa9Nqntc43JKA==} + engines: {node: '>= 20.19.0'} + + resolve-pkg-maps@1.0.0: + resolution: {integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==} + + rolldown@1.2.14: + resolution: {integrity: sha512-eTBTTqMR6uHKLgcUqpJP8ntzDI6V4LYA8negAMBEI7gkgVvOdrx6VsvS2Ym+83KhOPdLCHWJu0w7UQFJZhHKNw==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + + run-applescript@7.1.0: + resolution: {integrity: sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==} + engines: {node: '>=18'} + + scheduler@0.28.0: + resolution: {integrity: sha512-juorfCmIkIw8tT+p5BXSm6PJjQF/ycEYmKyzURCIt/RaZIhL+PulbQ9Yu2z1HdOJDdqDTlxA1+xKBmHXJsczAw==} + + semver@7.8.4: + resolution: {integrity: sha512-rUCObTnP32Q08R2uuIrt7r9PlEonuTmtuXYcW6s5kjdlj3xbnwe+21yXptAUYcMAABLkYYTtnmzb3w3EDZfueA==} + engines: {node: '>=10'} + hasBin: true + + shebang-command@2.0.0: + resolution: {integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==} + engines: {node: '>=8'} + + shebang-regex@3.0.0: + resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==} + engines: {node: '>=8'} + + source-map-js@1.2.2: + resolution: {integrity: sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw==} + engines: {node: '>=0.10.0'} + + tinyglobby@0.2.17: + resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==} + engines: {node: '>=12.0.0'} + + tinypool@2.2.0: + resolution: {integrity: sha512-jBrmx4lYmaC9k/mgPbylxs7kBUxHtD8256up+HjLaDFfXScKJQyil+SWXSvhAtT7XHo+yTVlpB81PGmHP8oLSQ==} + engines: {node: ^20.0.0 || >=22.0.0} + + typescript@6.0.3: + resolution: {integrity: sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==} + engines: {node: '>=14.17'} + hasBin: true + + undici-types@7.24.6: + resolution: {integrity: sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==} + + vite@8.3.4: + resolution: {integrity: sha512-IftLE8phJhdNRIGNEV4JCCvfNScoZQVfcXaN8TQropWGJtOHcu+iAB9pHcuGvmEb/kddw0LBe/jS8ztdC6xdiQ==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + peerDependencies: + '@types/node': ^20.19.0 || >=22.12.0 + '@vitejs/devtools': ^0.7.1 + esbuild: ^0.27.0 || ^0.28.0 + jiti: '>=1.21.0' + less: ^4.0.0 + sass: ^1.70.0 + sass-embedded: ^1.70.0 + stylus: '>=0.54.8' + sugarss: ^5.0.0 + terser: ^5.16.0 + tsx: ^4.8.1 + yaml: ^2.4.2 + peerDependenciesMeta: + '@types/node': + optional: true + '@vitejs/devtools': + optional: true + esbuild: + optional: true + jiti: + optional: true + less: + optional: true + sass: + optional: true + sass-embedded: + optional: true + stylus: + optional: true + sugarss: + optional: true + terser: + optional: true + tsx: + optional: true + yaml: + optional: true + + which@2.0.2: + resolution: {integrity: sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==} + engines: {node: '>= 8'} + hasBin: true + + wsl-utils@0.3.1: + resolution: {integrity: sha512-g/eziiSUNBSsdDJtCLB8bdYEUMj4jR7AGeUo96p/3dTafgjHhpF4RiCFPiRILwjQoDXx5MqkBr4fwWtR3Ky4Wg==} + engines: {node: '>=20'} + +snapshots: + + '@hey-api/codegen-core@0.9.1': + dependencies: + '@hey-api/types': 0.1.4 + ansi-colors: 4.1.3 + c12: 3.3.4 + color-support: 1.1.3 + transitivePeerDependencies: + - magicast + + '@hey-api/json-schema-ref-parser@1.4.4': + dependencies: + '@jsdevtools/ono': 7.1.3 + '@types/json-schema': 7.0.15 + js-yaml: 4.2.0 + + '@hey-api/openapi-ts@0.99.0(typescript@6.0.3)': + dependencies: + '@hey-api/codegen-core': 0.9.1 + '@hey-api/json-schema-ref-parser': 1.4.4 + '@hey-api/shared': 0.5.0 + '@hey-api/spec-types': 0.2.0 + '@hey-api/types': 0.1.4 + '@lukeed/ms': 2.0.2 + ansi-colors: 4.1.3 + color-support: 1.1.3 + commander: 15.0.0 + get-tsconfig: 4.14.0 + typescript: 6.0.3 + transitivePeerDependencies: + - magicast + + '@hey-api/shared@0.5.0': + dependencies: + '@hey-api/codegen-core': 0.9.1 + '@hey-api/json-schema-ref-parser': 1.4.4 + '@hey-api/spec-types': 0.2.0 + '@hey-api/types': 0.1.4 + ansi-colors: 4.1.3 + cross-spawn: 7.0.6 + open: 11.0.0 + semver: 7.8.4 + transitivePeerDependencies: + - magicast + + '@hey-api/spec-types@0.2.0': + dependencies: + '@hey-api/types': 0.1.4 + + '@hey-api/types@0.1.4': {} + + '@jsdevtools/ono@7.1.3': {} + + '@lukeed/ms@2.0.2': {} + + '@oxc-project/types@0.154.0': {} + + '@oxfmt/binding-android-arm-eabi@0.73.0': + optional: true + + '@oxfmt/binding-android-arm64@0.73.0': + optional: true + + '@oxfmt/binding-darwin-arm64@0.73.0': + optional: true + + '@oxfmt/binding-darwin-x64@0.73.0': + optional: true + + '@oxfmt/binding-freebsd-x64@0.73.0': + optional: true + + '@oxfmt/binding-linux-arm-gnueabihf@0.73.0': + optional: true + + '@oxfmt/binding-linux-arm-musleabihf@0.73.0': + optional: true + + '@oxfmt/binding-linux-arm64-gnu@0.73.0': + optional: true + + '@oxfmt/binding-linux-arm64-musl@0.73.0': + optional: true + + '@oxfmt/binding-linux-ppc64-gnu@0.73.0': + optional: true + + '@oxfmt/binding-linux-riscv64-gnu@0.73.0': + optional: true + + '@oxfmt/binding-linux-riscv64-musl@0.73.0': + optional: true + + '@oxfmt/binding-linux-s390x-gnu@0.73.0': + optional: true + + '@oxfmt/binding-linux-x64-gnu@0.73.0': + optional: true + + '@oxfmt/binding-linux-x64-musl@0.73.0': + optional: true + + '@oxfmt/binding-openharmony-arm64@0.73.0': + optional: true + + '@oxfmt/binding-win32-arm64-msvc@0.73.0': + optional: true + + '@oxfmt/binding-win32-ia32-msvc@0.73.0': + optional: true + + '@oxfmt/binding-win32-x64-msvc@0.73.0': + optional: true + + '@oxlint/binding-android-arm-eabi@1.88.0': + optional: true + + '@oxlint/binding-android-arm64@1.88.0': + optional: true + + '@oxlint/binding-darwin-arm64@1.88.0': + optional: true + + '@oxlint/binding-darwin-x64@1.88.0': + optional: true + + '@oxlint/binding-freebsd-x64@1.88.0': + optional: true + + '@oxlint/binding-linux-arm-gnueabihf@1.88.0': + optional: true + + '@oxlint/binding-linux-arm-musleabihf@1.88.0': + optional: true + + '@oxlint/binding-linux-arm64-gnu@1.88.0': + optional: true + + '@oxlint/binding-linux-arm64-musl@1.88.0': + optional: true + + '@oxlint/binding-linux-ppc64-gnu@1.88.0': + optional: true + + '@oxlint/binding-linux-riscv64-gnu@1.88.0': + optional: true + + '@oxlint/binding-linux-riscv64-musl@1.88.0': + optional: true + + '@oxlint/binding-linux-s390x-gnu@1.88.0': + optional: true + + '@oxlint/binding-linux-x64-gnu@1.88.0': + optional: true + + '@oxlint/binding-linux-x64-musl@1.88.0': + optional: true + + '@oxlint/binding-openharmony-arm64@1.88.0': + optional: true + + '@oxlint/binding-win32-arm64-msvc@1.88.0': + optional: true + + '@oxlint/binding-win32-ia32-msvc@1.88.0': + optional: true + + '@oxlint/binding-win32-x64-msvc@1.88.0': + optional: true + + '@rolldown/binding-android-arm-eabi@1.2.14': + optional: true + + '@rolldown/binding-android-arm64@1.2.14': + optional: true + + '@rolldown/binding-darwin-arm64@1.2.14': + optional: true + + '@rolldown/binding-darwin-x64@1.2.14': + optional: true + + '@rolldown/binding-freebsd-x64@1.2.14': + optional: true + + '@rolldown/binding-linux-arm-gnueabihf@1.2.14': + optional: true + + '@rolldown/binding-linux-arm64-gnu@1.2.14': + optional: true + + '@rolldown/binding-linux-arm64-musl@1.2.14': + optional: true + + '@rolldown/binding-linux-ppc64-gnu@1.2.14': + optional: true + + '@rolldown/binding-linux-s390x-gnu@1.2.14': + optional: true + + '@rolldown/binding-linux-x64-gnu@1.2.14': + optional: true + + '@rolldown/binding-linux-x64-musl@1.2.14': + optional: true + + '@rolldown/binding-openharmony-arm64@1.2.14': + optional: true + + '@rolldown/binding-win32-arm64-msvc@1.2.14': + optional: true + + '@rolldown/binding-win32-x64-msvc@1.2.14': + optional: true + + '@rolldown/pluginutils@1.0.1': {} + + '@types/json-schema@7.0.15': {} + + '@types/node@24.19.2': + dependencies: + undici-types: 7.24.6 + + '@types/react-dom@19.3.0(@types/react@19.3.0)': + dependencies: + '@types/react': 19.3.0 + + '@types/react@19.3.0': + dependencies: + csstype: 3.2.3 + + '@vitejs/plugin-react@6.1.2(vite@8.3.4(@types/node@24.19.2)(jiti@2.7.0))': + dependencies: + '@rolldown/pluginutils': 1.0.1 + vite: 8.3.4(@types/node@24.19.2)(jiti@2.7.0) + + ansi-colors@4.1.3: {} + + argparse@2.0.1: {} + + bundle-name@4.1.1: + dependencies: + run-applescript: 7.1.0 + + c12@3.3.4: + dependencies: + chokidar: 5.0.0 + confbox: 0.2.4 + defu: 6.1.7 + dotenv: 17.4.2 + exsolve: 1.1.3 + giget: 3.3.1 + jiti: 2.7.0 + ohash: 2.0.12 + pathe: 2.0.3 + perfect-debounce: 2.1.0 + pkg-types: 2.3.3 + rc9: 3.1.0 + + chokidar@5.0.0: + dependencies: + readdirp: 5.1.1 + + color-support@1.1.3: {} + + commander@15.0.0: {} + + confbox@0.2.4: {} + + confbox@0.3.1: {} + + cross-spawn@7.0.6: + dependencies: + path-key: 3.1.1 + shebang-command: 2.0.0 + which: 2.0.2 + + csstype@3.2.3: {} + + default-browser-id@5.0.1: {} + + default-browser@5.5.1: + dependencies: + bundle-name: 4.1.1 + default-browser-id: 5.0.1 + + define-lazy-prop@3.0.0: {} + + defu@6.1.7: {} + + destr@2.0.5: {} + + detect-libc@2.1.2: {} + + dotenv@17.4.2: {} + + exsolve@1.1.3: {} + + fdir@6.5.0(picomatch@4.0.7): + optionalDependencies: + picomatch: 4.0.7 + + fsevents@2.3.3: + optional: true + + get-tsconfig@4.14.0: + dependencies: + resolve-pkg-maps: 1.0.0 + + giget@3.3.1: {} + + is-docker@3.0.0: {} + + is-in-ssh@1.0.0: {} + + is-inside-container@1.0.0: + dependencies: + is-docker: 3.0.0 + + is-wsl@3.1.1: + dependencies: + is-inside-container: 1.0.0 + + isexe@2.0.0: {} + + jiti@2.7.0: {} + + js-yaml@4.2.0: + dependencies: + argparse: 2.0.1 + + lightningcss-android-arm64@1.33.0: + optional: true + + lightningcss-darwin-arm64@1.33.0: + optional: true + + lightningcss-darwin-x64@1.33.0: + optional: true + + lightningcss-freebsd-x64@1.33.0: + optional: true + + lightningcss-linux-arm-gnueabihf@1.33.0: + optional: true + + lightningcss-linux-arm64-gnu@1.33.0: + optional: true + + lightningcss-linux-arm64-musl@1.33.0: + optional: true + + lightningcss-linux-x64-gnu@1.33.0: + optional: true + + lightningcss-linux-x64-musl@1.33.0: + optional: true + + lightningcss-win32-arm64-msvc@1.33.0: + optional: true + + lightningcss-win32-x64-msvc@1.33.0: + optional: true + + lightningcss@1.33.0: + dependencies: + detect-libc: 2.1.2 + optionalDependencies: + lightningcss-android-arm64: 1.33.0 + lightningcss-darwin-arm64: 1.33.0 + lightningcss-darwin-x64: 1.33.0 + lightningcss-freebsd-x64: 1.33.0 + lightningcss-linux-arm-gnueabihf: 1.33.0 + lightningcss-linux-arm64-gnu: 1.33.0 + lightningcss-linux-arm64-musl: 1.33.0 + lightningcss-linux-x64-gnu: 1.33.0 + lightningcss-linux-x64-musl: 1.33.0 + lightningcss-win32-arm64-msvc: 1.33.0 + lightningcss-win32-x64-msvc: 1.33.0 + + nanoid@3.3.20: {} + + ohash@2.0.12: {} + + open@11.0.0: + dependencies: + default-browser: 5.5.1 + define-lazy-prop: 3.0.0 + is-in-ssh: 1.0.0 + is-inside-container: 1.0.0 + powershell-utils: 0.1.0 + wsl-utils: 0.3.1 + + oxfmt@0.73.0: + dependencies: + tinypool: 2.2.0 + optionalDependencies: + '@oxfmt/binding-android-arm-eabi': 0.73.0 + '@oxfmt/binding-android-arm64': 0.73.0 + '@oxfmt/binding-darwin-arm64': 0.73.0 + '@oxfmt/binding-darwin-x64': 0.73.0 + '@oxfmt/binding-freebsd-x64': 0.73.0 + '@oxfmt/binding-linux-arm-gnueabihf': 0.73.0 + '@oxfmt/binding-linux-arm-musleabihf': 0.73.0 + '@oxfmt/binding-linux-arm64-gnu': 0.73.0 + '@oxfmt/binding-linux-arm64-musl': 0.73.0 + '@oxfmt/binding-linux-ppc64-gnu': 0.73.0 + '@oxfmt/binding-linux-riscv64-gnu': 0.73.0 + '@oxfmt/binding-linux-riscv64-musl': 0.73.0 + '@oxfmt/binding-linux-s390x-gnu': 0.73.0 + '@oxfmt/binding-linux-x64-gnu': 0.73.0 + '@oxfmt/binding-linux-x64-musl': 0.73.0 + '@oxfmt/binding-openharmony-arm64': 0.73.0 + '@oxfmt/binding-win32-arm64-msvc': 0.73.0 + '@oxfmt/binding-win32-ia32-msvc': 0.73.0 + '@oxfmt/binding-win32-x64-msvc': 0.73.0 + + oxlint@1.88.0: + optionalDependencies: + '@oxlint/binding-android-arm-eabi': 1.88.0 + '@oxlint/binding-android-arm64': 1.88.0 + '@oxlint/binding-darwin-arm64': 1.88.0 + '@oxlint/binding-darwin-x64': 1.88.0 + '@oxlint/binding-freebsd-x64': 1.88.0 + '@oxlint/binding-linux-arm-gnueabihf': 1.88.0 + '@oxlint/binding-linux-arm-musleabihf': 1.88.0 + '@oxlint/binding-linux-arm64-gnu': 1.88.0 + '@oxlint/binding-linux-arm64-musl': 1.88.0 + '@oxlint/binding-linux-ppc64-gnu': 1.88.0 + '@oxlint/binding-linux-riscv64-gnu': 1.88.0 + '@oxlint/binding-linux-riscv64-musl': 1.88.0 + '@oxlint/binding-linux-s390x-gnu': 1.88.0 + '@oxlint/binding-linux-x64-gnu': 1.88.0 + '@oxlint/binding-linux-x64-musl': 1.88.0 + '@oxlint/binding-openharmony-arm64': 1.88.0 + '@oxlint/binding-win32-arm64-msvc': 1.88.0 + '@oxlint/binding-win32-ia32-msvc': 1.88.0 + '@oxlint/binding-win32-x64-msvc': 1.88.0 + + path-key@3.1.1: {} + + pathe@2.0.3: {} + + perfect-debounce@2.1.0: {} + + picocolors@1.1.1: {} + + picomatch@4.0.7: {} + + pkg-types@2.3.3: + dependencies: + confbox: 0.3.1 + exsolve: 1.1.3 + pathe: 2.0.3 + + postcss@8.5.31: + dependencies: + nanoid: 3.3.20 + picocolors: 1.1.1 + source-map-js: 1.2.2 + + powershell-utils@0.1.0: {} + + rc9@3.1.0: + dependencies: + defu: 6.1.7 + destr: 2.0.5 + + react-dom@19.3.1(react@19.3.1): + dependencies: + react: 19.3.1 + scheduler: 0.28.0 + + react@19.3.1: {} + + readdirp@5.1.1: {} + + resolve-pkg-maps@1.0.0: {} + + rolldown@1.2.14: + dependencies: + '@oxc-project/types': 0.154.0 + '@rolldown/pluginutils': 1.0.1 + optionalDependencies: + '@rolldown/binding-android-arm-eabi': 1.2.14 + '@rolldown/binding-android-arm64': 1.2.14 + '@rolldown/binding-darwin-arm64': 1.2.14 + '@rolldown/binding-darwin-x64': 1.2.14 + '@rolldown/binding-freebsd-x64': 1.2.14 + '@rolldown/binding-linux-arm-gnueabihf': 1.2.14 + '@rolldown/binding-linux-arm64-gnu': 1.2.14 + '@rolldown/binding-linux-arm64-musl': 1.2.14 + '@rolldown/binding-linux-ppc64-gnu': 1.2.14 + '@rolldown/binding-linux-s390x-gnu': 1.2.14 + '@rolldown/binding-linux-x64-gnu': 1.2.14 + '@rolldown/binding-linux-x64-musl': 1.2.14 + '@rolldown/binding-openharmony-arm64': 1.2.14 + '@rolldown/binding-win32-arm64-msvc': 1.2.14 + '@rolldown/binding-win32-x64-msvc': 1.2.14 + + run-applescript@7.1.0: {} + + scheduler@0.28.0: {} + + semver@7.8.4: {} + + shebang-command@2.0.0: + dependencies: + shebang-regex: 3.0.0 + + shebang-regex@3.0.0: {} + + source-map-js@1.2.2: {} + + tinyglobby@0.2.17: + dependencies: + fdir: 6.5.0(picomatch@4.0.7) + picomatch: 4.0.7 + + tinypool@2.2.0: {} + + typescript@6.0.3: {} + + undici-types@7.24.6: {} + + vite@8.3.4(@types/node@24.19.2)(jiti@2.7.0): + dependencies: + lightningcss: 1.33.0 + picomatch: 4.0.7 + postcss: 8.5.31 + rolldown: 1.2.14 + tinyglobby: 0.2.17 + optionalDependencies: + '@types/node': 24.19.2 + fsevents: 2.3.3 + jiti: 2.7.0 + + which@2.0.2: + dependencies: + isexe: 2.0.0 + + wsl-utils@0.3.1: + dependencies: + is-wsl: 3.1.1 + powershell-utils: 0.1.0 diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx new file mode 100644 index 0000000..eb4c400 --- /dev/null +++ b/frontend/src/App.tsx @@ -0,0 +1,29 @@ +import { useEffect, useState } from "react"; +import { listMessages, type MessageDto } from "./api/generated"; + +export function App() { + const [messages, setMessages] = useState([]); + const [error, setError] = useState(); + + useEffect(() => { + listMessages().then((result) => { + if (!result.data) { + setError("Could not load messages"); + return; + } + setMessages(result.data); + }); + }, []); + + return ( +
+

Messages

+ {error &&

{error}

} +
    + {messages.map((message) => ( +
  • {message.text}
    • + ))} +
+
+ ); +} diff --git a/frontend/src/main.tsx b/frontend/src/main.tsx new file mode 100644 index 0000000..96f2ecb --- /dev/null +++ b/frontend/src/main.tsx @@ -0,0 +1,12 @@ +import { StrictMode } from "react"; +import { createRoot } from "react-dom/client"; +import { App } from "./App"; + +const root = document.getElementById("root"); +if (!root) throw new Error("Missing #root element in index.html"); + +createRoot(root).render( + + + , +); diff --git a/frontend/tsconfig.json b/frontend/tsconfig.json new file mode 100644 index 0000000..03435fa --- /dev/null +++ b/frontend/tsconfig.json @@ -0,0 +1,20 @@ +{ + "compilerOptions": { + "target": "ES2023", + "lib": ["ES2023", "DOM", "DOM.Iterable"], + "module": "ESNext", + "moduleResolution": "bundler", + "jsx": "react-jsx", + "types": ["vite/client", "node"], + "strict": true, + "noUncheckedIndexedAccess": true, + "noUnusedLocals": true, + "noUnusedParameters": true, + "noFallthroughCasesInSwitch": true, + "verbatimModuleSyntax": true, + "isolatedModules": true, + "skipLibCheck": true, + "noEmit": true + }, + "include": ["src", "vite.config.ts", "openapi-ts.config.ts"] +} diff --git a/frontend/vite.config.ts b/frontend/vite.config.ts new file mode 100644 index 0000000..d4d03f8 --- /dev/null +++ b/frontend/vite.config.ts @@ -0,0 +1,22 @@ +import react from "@vitejs/plugin-react"; +import { defineConfig } from "vite"; + +// Set by compose.override.yaml. There is no fallback on purpose: run the app +// with `mise run dev`, not `pnpm dev` on your machine. +const backendUrl = process.env.BACKEND_URL; + +export default defineConfig(({ command }) => { + if (command === "serve" && !backendUrl) { + throw new Error("BACKEND_URL is not set. Run the app with `mise run dev`."); + } + + return { + plugins: [react()], + server: { + host: true, + port: 8080, + strictPort: true, + proxy: { "/api": backendUrl ?? "" }, + }, + }; +}); diff --git a/mise.toml b/mise.toml new file mode 100644 index 0000000..7de05d1 --- /dev/null +++ b/mise.toml @@ -0,0 +1,169 @@ +# mise only installs tools and runs tasks. It does not load .env: the app gets +# its config from Docker, so run it with `mise run dev`. + +[tools] +java = "temurin-25" +node = "24.22.0" +pnpm = "12.14.0" +jq = "1.8.2" + +# ─── setup ─── + +[tasks.setup] +description = "Create .env, install frontend dependencies, and generate the API client" +run = [ + "test -f .env || cp .env.example .env", + "pnpm --dir frontend install", + { task = "contract:client" }, +] + +# ─── dev (Docker, compose.yaml + compose.override.yaml) ─── + +[tasks.dev] +description = "Run web, backend and db in Docker (http://localhost:8080)" +run = "docker compose up --build" + +[tasks."dev:down"] +description = "Stop the dev containers" +run = "docker compose down" + +[tasks."dev:logs"] +description = "Follow the dev container logs" +run = "docker compose logs -f" + +[tasks."dev:restart"] +description = "Restart the backend to pick up Java changes" +run = "docker compose restart backend" + +# ─── stack (Docker, compose.yaml only: built jar + nginx, like a deploy) ─── + +[tasks.stack] +description = "Build and run the deploy images (http://localhost:8080)" +run = "docker compose -f compose.yaml up --build --wait" + +[tasks."stack:down"] +description = "Stop the deploy containers" +run = "docker compose -f compose.yaml down" + +# ─── db ─── + +[tasks."db:dev:start"] +description = "Start only the dev database" +run = "docker compose up -d --wait db" + +[tasks."db:dev:stop"] +description = "Stop the dev database" +run = "docker compose stop db" + +[tasks."db:dev:psql"] +description = "Open psql in the dev database" +run = "docker compose exec db sh -c 'psql -U \"$POSTGRES_USER\" \"$POSTGRES_DB\"'" + +[tasks."db:dev:reset"] +description = "Delete the dev database volume (migrations rerun on next start)" +confirm = "Delete all data in the dev database?" +run = "docker compose down -v" + +[tasks."db:dev:migration"] +description = "Generate the next Flyway migration from changes to the JPA entities" +usage = 'arg "" help="snake_case description, e.g. add_users"' +depends = ["db:dev:start"] +run = ''' +dir=backend/src/main/resources/db/migration +last=$(ls "$dir" | sed -nE 's/^V([0-9]+)__.*/\1/p' | sort -n | tail -1) +file="V$(( ${last:-0} + 1 ))__${usage_name}.sql" + +# Boots the app once without a web server: Flyway applies the existing +# migrations, then Hibernate writes the SQL needed to match the entities. +docker compose run --rm -T backend ./gradlew bootRun --no-daemon --quiet --args="\ + --spring.main.web-application-type=none \ + --spring.jpa.hibernate.ddl-auto=none \ + --spring.jpa.properties.jakarta.persistence.schema-generation.scripts.action=update \ + --spring.jpa.properties.jakarta.persistence.schema-generation.scripts.create-target=/app/src/main/resources/db/migration/$file \ + --spring.jpa.properties.hibernate.hbm2ddl.delimiter=;" + +if [ ! -s "$dir/$file" ]; then + rm -f "$dir/$file" + echo "The entities already match the database. No migration created." + exit 0 +fi +echo "Created $dir/$file. Review it before committing: Hibernate never drops columns or tables." +''' + +# ─── contract ─── + +[tasks.contract] +description = "Export the OpenAPI spec from the running backend and regenerate the client" +run = [ + "docker compose up -d --wait backend", + "curl -sf http://127.0.0.1:3000/api/openapi.json | jq . > contract/openapi.json", + { task = "contract:client" }, +] + +[tasks."contract:client"] +description = "Generate the frontend API client from contract/openapi.json" +dir = "frontend" +run = "pnpm exec openapi-ts" + +# ─── lint ─── + +[tasks."lint:backend"] +description = "Compile the backend with Error Prone" +dir = "backend" +run = "./gradlew compileJava" + +[tasks."lint:frontend"] +description = "Run oxlint and the TypeScript compiler on the frontend" +depends = ["contract:client"] +dir = "frontend" +run = ["pnpm exec oxlint", "pnpm exec tsc --noEmit"] + +[tasks.lint] +description = "Lint the backend and frontend" +depends = ["lint:backend", "lint:frontend"] + +[tasks."lint:fix"] +description = "Apply oxlint fixes to the frontend" +dir = "frontend" +run = "pnpm exec oxlint --fix" + +# ─── format ─── + +[tasks."fmt:backend"] +alias = "format:backend" +description = "Check backend formatting (Spotless)" +dir = "backend" +run = "./gradlew spotlessCheck" + +[tasks."fmt:frontend"] +alias = "format:frontend" +description = "Check frontend formatting (oxfmt)" +dir = "frontend" +run = "pnpm exec oxfmt --check" + +[tasks.fmt] +alias = "format" +description = "Check backend and frontend formatting" +depends = ["fmt:backend", "fmt:frontend"] + +[tasks."fmt:fix"] +alias = "format:fix" +description = "Format the backend and frontend" +run = [ + "cd backend && ./gradlew spotlessApply", + "cd frontend && pnpm exec oxfmt", +] + +# ─── build / check ─── + +[tasks.build] +description = "Build the backend jar and the frontend bundle" +depends = ["contract:client"] +run = [ + "cd backend && ./gradlew bootJar", + "cd frontend && pnpm run build", +] + +[tasks.check] +description = "Run everything CI runs" +depends = ["fmt", "lint"] From 390e3a93fb47e4afc19cf25e7f0e18e977d61de2 Mon Sep 17 00:00:00 2001 From: Anish Sahoo Date: Mon, 19 Oct 2026 18:47:51 -0400 Subject: [PATCH 02/11] fix: tag dev images separately from deploy images --- compose.override.yaml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/compose.override.yaml b/compose.override.yaml index 0d7d500..65a0a62 100644 --- a/compose.override.yaml +++ b/compose.override.yaml @@ -10,6 +10,8 @@ services: - "127.0.0.1:${POSTGRES_PORT:-5432}:5432" backend: + # A separate tag keeps `docker compose up` from reusing the deploy image. + image: ${COMPOSE_PROJECT_NAME}-backend:local build: target: local volumes: @@ -21,6 +23,7 @@ services: start_period: 120s web: + image: ${COMPOSE_PROJECT_NAME}-web:local build: target: local environment: From 3bac000408abea780a1b9ac6e07ba7ed202e65b9 Mon Sep 17 00:00:00 2001 From: Anish Sahoo Date: Mon, 19 Oct 2026 20:05:45 -0400 Subject: [PATCH 03/11] feat: align starter with typescript and python starters - /api/v1 health and messages endpoints with matching schemas - native SQL queries on JpaRepository, actuator removed - Flyway migrate and status tasks running in containers - spec exported to backend/openapi.json with a no-database profile - frontend matches the typescript starter, dev uses dev:up and dev:down - same mise tasks and CI jobs as the other starters --- .agents/rules/backend.md | 15 +- .agents/rules/frontend.md | 15 +- .dockerignore | 7 + .env.example | 15 +- .github/workflows/ci.yml | 20 +- AGENTS.md | 73 ++++-- README.md | 233 ++++++++++-------- backend/Dockerfile | 2 +- backend/build.gradle.kts | 28 ++- backend/openapi.json | 96 ++++++++ .../java/com/example/app/Application.java | 2 +- .../app/controller/HealthController.java | 28 +++ .../app/controller/MessageController.java | 4 +- .../java/com/example/app/dao/MessageDAO.java | 6 +- .../java/com/example/app/dto/HealthDTO.java | 8 + .../java/com/example/app/dto/MessageDTO.java | 7 +- .../java/com/example/app/entity/Message.java | 4 +- .../app/repository/MessageRepository.java | 8 +- .../example/app/service/MessageService.java | 2 +- .../main/resources/application-openapi.yaml | 21 ++ backend/src/main/resources/application.yaml | 20 +- .../db/migration/V1__create_messages.sql | 7 - .../main/resources/db/migration/V1__init.sql | 11 + compose.override.yaml | 21 +- compose.yaml | 17 +- contract/openapi.json | 57 ----- frontend/.oxfmtrc.json | 3 +- frontend/.oxlintrc.json | 5 - frontend/Dockerfile | 11 +- frontend/nginx.conf | 3 - frontend/openapi-ts.config.ts | 4 +- frontend/oxlint.config.ts | 21 ++ frontend/package.json | 4 +- frontend/pnpm-lock.yaml | 77 +++++- frontend/src/App.tsx | 32 +-- frontend/tsconfig.json | 4 +- frontend/vite.config.ts | 8 +- mise.toml | 189 +++++++------- 38 files changed, 712 insertions(+), 376 deletions(-) create mode 100644 .dockerignore create mode 100644 backend/openapi.json create mode 100644 backend/src/main/java/com/example/app/controller/HealthController.java create mode 100644 backend/src/main/java/com/example/app/dto/HealthDTO.java create mode 100644 backend/src/main/resources/application-openapi.yaml delete mode 100644 backend/src/main/resources/db/migration/V1__create_messages.sql create mode 100644 backend/src/main/resources/db/migration/V1__init.sql delete mode 100644 contract/openapi.json delete mode 100644 frontend/.oxlintrc.json create mode 100644 frontend/oxlint.config.ts diff --git a/.agents/rules/backend.md b/.agents/rules/backend.md index 4957137..0e9f4dc 100644 --- a/.agents/rules/backend.md +++ b/.agents/rules/backend.md @@ -9,8 +9,13 @@ paths: `dao` is the only caller of a `repository` and turns entities into DTOs. Entities never leave the `dao` layer. - Inject dependencies through the constructor into `private final` fields. -- Change the schema by editing an entity, then run - `mise run db:dev:migration ` and review the generated SQL. Never edit a - migration that has already been merged. -- After changing a controller or DTO, run `mise run contract` and commit the - updated `contract/openapi.json`. +- Every controller lives under `/api/v1`. Give each method + `@Operation(operationId = "...")`, which becomes the function name in the frontend + client, and `@ApiResponse` with a description. +- Name DTO schemas after the resource with `@Schema(name = "Message")` and list + `requiredProperties`, so the client types match the other starters. +- Every repository query is `@Query(value = "...", nativeQuery = true)`. See + "Queries" in `AGENTS.md`. +- Change tables only through entities and `mise run db:dev:migrate:generate `. +- After changing a controller or DTO, run `mise run contract` and commit + `backend/openapi.json`. diff --git a/.agents/rules/frontend.md b/.agents/rules/frontend.md index 02dfa7a..0f08802 100644 --- a/.agents/rules/frontend.md +++ b/.agents/rules/frontend.md @@ -3,11 +3,12 @@ paths: - "frontend/**" --- -# Frontend rules +# Frontend -- Call the backend through the generated client in `src/api/generated`, not - hand-written `fetch` calls. -- If the client is missing an endpoint, change the backend and run - `mise run contract`. Do not edit the generated files. -- Call the API with relative `/api/...` URLs. Vite proxies them in dev and nginx - proxies them in deploy. +- Call the backend only through the generated SDK in `src/api/generated`. No raw + `fetch` to `/api`. +- If the SDK is missing a route or a field, change the backend and run + `mise run contract`. Do not hand-write types for API responses. +- Use relative `/api/...` URLs. Vite proxies them in dev and nginx proxies them when + deployed. +- Use arrow functions for components and handlers: `export const App = () => {}`. diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..7ab590b --- /dev/null +++ b/.dockerignore @@ -0,0 +1,7 @@ +**/node_modules +**/dist +**/.env +backend/.gradle +backend/build +frontend/src/api/generated +.git diff --git a/.env.example b/.env.example index f522d86..845e6bb 100644 --- a/.env.example +++ b/.env.example @@ -1,13 +1,6 @@ -# Copy to .env (`mise run setup` does it for you). .env is gitignored. -# -# Only Docker reads this file. Compose injects it into the containers, so in -# development you must run the app with `mise run dev`. Running -# `./gradlew bootRun` or `pnpm dev` directly on your machine will not load these -# values, and the app will fail on startup. - -POSTGRES_USER=app -POSTGRES_PASSWORD=app +# Docker Compose reads these and passes them into the containers. +SERVICE_USER_POSTGRES=app +SERVICE_PASSWORD_POSTGRES=app POSTGRES_DB=app - -# Host port for connecting a database GUI to the dev db. POSTGRES_PORT=5432 +LOG_LEVEL=info diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 0447263..5047d5f 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -1,14 +1,16 @@ name: CI on: - pull_request: push: branches: [main] + pull_request: concurrency: - group: ${{ github.workflow }}-${{ github.ref }} - cancel-in-progress: ${{ github.event_name == 'pull_request' }} + group: ci-${{ github.workflow }}-${{ github.ref }} + cancel-in-progress: true +# Every step runs the same mise task you run locally, so `mise run check` +# passing on your machine means these pass too. jobs: frontend_lint: name: frontend / lint @@ -16,7 +18,7 @@ jobs: steps: - uses: actions/checkout@v7 - uses: jdx/mise-action@v5 - - run: pnpm --dir frontend install --frozen-lockfile + - run: pnpm install --frozen-lockfile --dir frontend - run: mise run lint:frontend frontend_format: @@ -25,7 +27,7 @@ jobs: steps: - uses: actions/checkout@v7 - uses: jdx/mise-action@v5 - - run: pnpm --dir frontend install --frozen-lockfile + - run: pnpm install --frozen-lockfile --dir frontend - run: mise run fmt:frontend backend_lint: @@ -36,6 +38,14 @@ jobs: - uses: jdx/mise-action@v5 - run: mise run lint:backend + backend_contract: + name: backend / contract + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + - uses: jdx/mise-action@v5 + - run: mise run contract:check + backend_format: name: backend / format runs-on: ubuntu-latest diff --git a/AGENTS.md b/AGENTS.md index e1ce2f2..8d7ad50 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,30 +1,30 @@ # Working in this repo -Rules for anyone changing code here, human or agent. `.agents/rules/` has -extra rules for `backend/` and `frontend/`. Read the one for the folder you are -editing. Add to these files when the team agrees on a new rule. +Rules for anyone changing code here, human or agent. Before editing `backend/` or +`frontend/`, also read the matching file in `.agents/rules/`. ## Running things -- Run the app with `mise run dev`. It starts web, backend and db in Docker at - http://localhost:8080. -- `.env` only reaches the app through Docker. `./gradlew bootRun` or `pnpm dev` - on your machine will fail on startup. That is expected, not a bug to work - around. Do not add default values to get past it. -- `mise tasks` lists every task. Run `mise run check` before you finish. It is - what CI runs. `mise run fmt:fix` fixes formatting. +- The app always runs in Docker. `mise run dev:up` starts db, backend and web; + `mise run dev:down` stops them and keeps the data. +- mise loads `.env`, and Docker Compose passes it into the containers. Running + `./gradlew bootRun` or `pnpm dev` on your machine will fail on startup. That is + expected, not a bug to work around. Do not add default values to get past it. +- Lint, format and the OpenAPI export run on your machine through mise because they + never touch the database. +- `mise tasks` lists every task. Run `mise run check` before you finish. It is what + CI runs. ## Layout ``` -browser -> web (nginx / vite) -> /api -> backend (Spring) -> db (Postgres) +browser -> web (vite / nginx) -> /api -> backend (Spring) -> db (Postgres) backend/ controller -> service -> dao -> repository -> entity -contract/ openapi.json, exported from the backend -frontend/ React app, API client generated from contract/ +frontend/ React app, API client generated from backend/openapi.json ``` -## Code +## Writing code - Read the code you are changing, and the code that calls it. - Make the smallest change that solves the problem. No speculative abstractions, @@ -34,5 +34,46 @@ frontend/ React app, API client generated from contract/ - Prefer guard clauses and early returns over nested `if`s. - Delete dead and commented-out code. Git has it. - Do not swallow errors. Handle them or let them surface. -- Never hand-edit generated files: `contract/openapi.json` and - `frontend/src/api/generated/`. +- In the frontend, write modern TypeScript: arrow functions, `type` instead of + `interface`, no `enum` or `namespace`. + +## The database + +The JPA entities in `backend/src/main/java/com/example/app/entity/` are the source of +truth for every table. Change the database only this way: + +1. Edit or add an entity. +2. Run `mise run db:dev:migrate:generate `. Hibernate compares the entities + with the database and writes the SQL to the next + `backend/src/main/resources/db/migration/V__.sql`. +3. Read the SQL. Hibernate never drops columns or tables, so add those statements + yourself. Then run `mise run db:dev:migrate:up`. +4. `mise run db:dev:migrate:status` shows whether the database is missing migrations. + +Migrations only go forward. Never edit a migration that is already on `main`. Add a +new one instead. + +## Queries + +Every query must read as SQL. Write it as a native query on a `JpaRepository`: + +```java +@Query(value = "SELECT * FROM messages WHERE id = :id", nativeQuery = true) +Optional findByIdSQL(@Param("id") Integer id); + +@Modifying +@Query(value = "INSERT INTO messages (text) VALUES (:text)", nativeQuery = true) +void insertMessage(@Param("text") String text); +``` + +- Never use derived query methods (`findByTextOrderByCreatedAtDesc`) or the built-in + `findAll`, `findById`, `save` and `delete*` methods. +- Never use JPQL, the Criteria API or string concatenation. Pass values as `:named` + parameters. + +## The API contract + +The controllers and DTOs are the source of truth for the API. `backend/openapi.json` +is generated from them and committed. `frontend/src/api/generated/` is generated from +that file and gitignored. Never edit either by hand. After changing a controller or +DTO, run `mise run contract` and commit `backend/openapi.json`. diff --git a/README.md b/README.md index f587256..e47a642 100644 --- a/README.md +++ b/README.md @@ -1,136 +1,163 @@ -# Spring Boot + React starter +# Spring Boot React starter -A Spring Boot backend, a React frontend and Postgres, all running in Docker. -The frontend talks to the backend through a client generated from the -backend's OpenAPI spec. +A three-container web app: a React frontend, a Spring Boot backend and a Postgres +database, all running in Docker. It ships with one example feature (a list of +messages) that shows a request going from React to Spring to Postgres and back. +Replace it with your own. -``` -browser -> web :8080 -> /api/* -> backend :3000 -> db :5432 - (vite in dev, nginx in deploy) -``` - -## Requirements +There are matching TypeScript (Hono) and Python (FastAPI) starters with the same API, +the same frontend and the same `mise` tasks. -- [Docker Desktop](https://www.docker.com/products/docker-desktop/) -- [mise](https://mise.jdx.dev/getting-started.html). It installs Java 25, - Node and pnpm for you. Run `mise install` once after cloning. +| Part | Stack | +| -------- | ------------------------------------------------------------------------------ | +| Frontend | React, Vite, a client generated from the API contract by `@hey-api/openapi-ts` | +| Backend | Spring Boot 4, Java 25, Spring Data JPA, springdoc-openapi, Lombok | +| Database | Postgres 18, migrations generated by Hibernate and applied by Flyway | +| Tooling | mise, Gradle, Spotless, Error Prone, oxlint, oxfmt, Docker Compose | -## Quick start - -```sh -mise install -mise run setup # creates .env, installs frontend deps, generates the API client -mise run dev # http://localhost:8080 ``` - -> [!IMPORTANT] -> In development, always run the app through Docker with `mise run dev`. -> Compose is the only thing that loads `.env` into the app. Running -> `./gradlew bootRun` or `pnpm dev` directly on your machine skips it, so the -> backend can't find the database and the frontend can't find the backend. - -The frontend reloads on save. The backend does not. Run `mise run dev:restart` -after changing Java code. - -## Tasks - -Run `mise tasks` for the full list. - -| Task | What it does | -| --- | --- | -| `mise run setup` | Create `.env` from `.env.example`, install frontend deps, generate the API client | -| `mise run dev` | Run web, backend and db in Docker | -| `mise run dev:restart` | Restart the backend after Java changes | -| `mise run dev:down` / `dev:logs` | Stop the containers / follow their logs | -| `mise run stack` | Run the deploy images (built jar + nginx) to check a production build | -| `mise run db:dev:psql` | Open `psql` in the dev database | -| `mise run db:dev:migration ` | Generate a migration from your entity changes | -| `mise run db:dev:reset` | Delete the dev database and start over | -| `mise run contract` | Export the OpenAPI spec and regenerate the frontend client | -| `mise run check` | Format check + lint for both apps (what CI runs) | -| `mise run fmt:fix` / `lint:fix` | Fix formatting / auto-fixable lint errors | +browser -> web :5173 -> /api/* -> backend :3000 -> db :5432 + (vite in dev, nginx :8080 when deployed) +``` ## Layout ``` -backend/ Spring Boot, Gradle, Java 25 +mise.toml Tool versions and every task you will run +compose.yaml The deployed stack: web, backend, db +compose.override.yaml Dev overrides: run from source, published ports +.env.example Local settings. Copy it to .env. +backend/ src/main/java/com/example/app/ - controller/ HTTP routes - service/ business logic - dao/ the only caller of repositories, maps entities to DTOs - dto/ request and response shapes (these end up in the API client) - repository/ Spring Data JPA interfaces - entity/ JPA entities, one per table + controller/ HTTP routes + service/ Business logic + dao/ The only caller of repositories, maps entities to DTOs + dto/ Request and response shapes (these end up in the API client) + repository/ JpaRepository interfaces with native SQL queries + entity/ JPA entities. The source of truth for the schema. src/main/resources/ - application.yaml config, read from env vars - db/migration/ Flyway migrations -contract/openapi.json API spec, exported from the backend -frontend/ React + Vite - src/api/generated/ API client (generated, gitignored) - nginx.conf deploy server: serves the build, proxies /api -compose.yaml deploy-like stack -compose.override.yaml dev overrides, merged automatically + application.yaml Config, read from env vars + db/migration/ Generated Flyway migrations. Commit these. + openapi.json The API contract, generated from the controllers. Commit it. +frontend/ + src/App.tsx The page + src/api/generated/ Client generated from the contract (not committed) + nginx.conf Deployed web server: serves the app and proxies /api +.agents/rules/ Extra rules for AI agents, per folder +AGENTS.md Rules for agents and humans ``` -A request goes `controller -> service -> dao -> repository`. The DAO hands DTOs -back up, so entities never leave the data layer. +## Getting started -## Changing the database +You need [mise](https://mise.jdx.dev) and Docker. -1. Edit or add an entity in `backend/.../entity/`. -2. Run `mise run db:dev:migration add_something`. It starts the backend once, - compares your entities to the dev database, and writes the SQL needed to - match them into the next `V__add_something.sql`. -3. Read the file. Hibernate never drops columns or tables, so write those by - hand. Adjust anything else it got wrong. -4. Run `mise run dev:restart`. Flyway applies the migration on startup. - -Migrations only go forward. Never edit a migration after it has been merged. -Add a new one instead. To start over locally, run `mise run db:dev:reset`. - -## Changing the API +```sh +mise install +cp .env.example .env +mise run setup:dev +``` -1. Change a controller or DTO in the backend. -2. Run `mise run contract`. It exports `contract/openapi.json` from the running - backend and regenerates `frontend/src/api/generated/`. -3. Commit `contract/openapi.json`. The generated client is gitignored and - rebuilt from it. +`setup:dev` installs the frontend packages, generates the API client and starts every +container. Open and press the button. -The function names in the client come from `@Operation(operationId = ...)` on -each controller method. +> [!IMPORTANT] +> The app always runs in Docker. mise loads `.env`, and Docker Compose passes it into +> the containers. Running `./gradlew bootRun` or `pnpm dev` on your machine skips +> that, so the backend can't find the database and the frontend can't find the +> backend. + +The frontend reloads on save. The backend does not: run `mise run dev:restart` after +changing Java code. + +`mise tasks` lists every task. The ones you will use most: + +| Task | What it does | +| ----------------------------------------- | --------------------------------------------------------------- | +| `mise run dev:up` | Build and start db, backend and web in Docker | +| `mise run dev:down` | Stop every container. Database data is kept. | +| `mise run dev:restart` | Restart the backend after changing Java code | +| `mise run contract` | Regenerate `backend/openapi.json` and the frontend client | +| `mise run db:dev:migrate:generate ` | Write a SQL migration from your changes to the entities | +| `mise run db:dev:migrate:up` | Apply pending migrations | +| `mise run db:dev:migrate:status` | Show whether the database is missing migrations | +| `mise run db:dev:studio` | Open Prisma Studio on the dev database (:5555) | +| `mise run db:dev:psql` | Open psql in the database | +| `mise run check` | Run what CI runs: format check, lint, typecheck, contract check | +| `mise run fmt:fix` | Format everything | +| `mise run stack:dev:up` | Build and run the deploy images (jar + nginx) on :8080 | + +## The API contract + +The controllers and DTOs are the source of truth. `mise run contract` does two things: + +1. `contract:generate` boots the app briefly with the `openapi` profile, which needs no + database, and saves the spec springdoc builds to `backend/openapi.json`. Commit + this file. +2. `contract:client` generates a typed client with zod validators in + `frontend/src/api/generated/`. This folder is gitignored. + +`mise run check` fails if `backend/openapi.json` is out of date with the controllers. + +The function names in the client come from `@Operation(operationId = ...)` on each +controller method, and type names come from `@Schema(name = ...)` on each DTO. + +## The database + +The entities in `backend/.../entity/` describe every table. Migrations are plain SQL +files in `backend/src/main/resources/db/migration/`. + +1. Edit or add an entity. +2. Run `mise run db:dev:migrate:generate add_something`. It boots the backend once in + a container, compares your entities to the dev database, and writes the SQL needed + to match them into the next `V__add_something.sql`. +3. Read the file. Hibernate never drops columns or tables, so write those statements + yourself. Then run `mise run db:dev:migrate:up`. +4. Commit the entity and the migration together. + +Migrations only go forward. Flyway's undo is a paid feature, so there is no down +task. Fix a mistake with a new migration, or run `mise run db:dev:reset` to start +over locally. + +After pulling a teammate's migration, `mise run db:dev:migrate:status` lists every +migration and marks the ones your database is missing as `Pending`. +`mise run db:dev:migrate:up` applies them. The backend also applies pending +migrations every time it starts. + +Queries are SQL too. Write them as `@Query(value = "...", nativeQuery = true)` on the +repository, as `MessageRepository` does, not as derived methods like +`findAllByOrderByCreatedAtDesc`. + +`mise run db:dev:studio` opens Prisma Studio on , already +connected to the dev database, to browse and edit rows. For raw SQL, use +`mise run db:dev:psql`. ## Environment variables -`.env.example` lists every variable. `mise run setup` copies it to `.env`, -which is gitignored. To add one: +`.env.example` lists every variable. Copy it to `.env`, which is gitignored. mise +loads `.env` for every task, and Docker Compose reads it to build each container's +environment. To add one: 1. Add it to `.env.example` and your `.env`. -2. Read it in `application.yaml` as `${MY_VAR}`, without a default. - -Compose passes `.env` to the `db` and `backend` containers. +2. Pass it to the `backend` service in `compose.yaml`. +3. Read it in `application.yaml` as `${MY_VAR}`, without a default. ## Making it yours -- Rename the Java package: move `backend/src/main/java/com/example/app` and - update the `package` lines, then change `group` in `backend/build.gradle.kts`. -- Rename the project in `backend/settings.gradle.kts`, `frontend/package.json` - and `frontend/index.html`. -- Delete the `messages` example (entity, repository, DAO, DTO, service, - controller, and the migration if nothing is deployed yet), then run - `mise run contract`. +- Rename the Java package: move `backend/src/main/java/com/example/app` and update + the `package` lines, then change `group` in `backend/build.gradle.kts`. +- Rename the project in `backend/settings.gradle.kts`, `frontend/package.json` and + `frontend/index.html`. +- Delete the `messages` example (entity, repository, DAO, DTO, service, controller), + run `mise run db:dev:migrate:generate remove_messages`, add the `DROP TABLE` it + can't write, then run `mise run contract`. ## Linting and formatting -- Backend: [Spotless](https://github.com/diffplug/spotless) with - google-java-format, and [Error Prone](https://errorprone.info/), which runs - inside `javac` and fails the build on common bugs. +- Backend: [Spotless](https://github.com/diffplug/spotless) with google-java-format, + and [Error Prone](https://errorprone.info/), which runs inside `javac` and fails the + build on common bugs. - Frontend: [oxlint](https://oxc.rs/docs/guide/usage/linter) and [oxfmt](https://oxc.rs/docs/guide/usage/formatter), plus `tsc` for types. CI (`.github/workflows/ci.yml`) runs lint and format for each app on every pull request. - -## Agents - -`AGENTS.md` and `.agents/rules/` hold the rules coding agents follow in this -repo. They are a starting point. Add rules there as your team agrees on them. diff --git a/backend/Dockerfile b/backend/Dockerfile index 5910936..237629f 100644 --- a/backend/Dockerfile +++ b/backend/Dockerfile @@ -5,7 +5,7 @@ COPY gradle gradle RUN ./gradlew dependencies --no-daemon -q > /dev/null # Runs from source. compose.override.yaml bind-mounts src/ over /app/src, so -# `mise run dev:restart` picks up Java changes. +# `mise run dev:restart` picks up Java changes. Migration tasks run here too. FROM base AS local COPY src src CMD ["./gradlew", "bootRun", "--no-daemon"] diff --git a/backend/build.gradle.kts b/backend/build.gradle.kts index 38cb243..81852e8 100644 --- a/backend/build.gradle.kts +++ b/backend/build.gradle.kts @@ -1,11 +1,21 @@ import net.ltgt.gradle.errorprone.errorprone +buildscript { + dependencies { + // The Flyway plugin runs outside the app, so it needs its own Postgres support. + classpath("org.flywaydb:flyway-database-postgresql:12.4.0") + classpath("org.postgresql:postgresql:42.7.13") + } +} + plugins { java id("org.springframework.boot") version "4.1.1" id("io.spring.dependency-management") version "1.1.7" id("com.diffplug.spotless") version "8.10.4" id("net.ltgt.errorprone") version "5.1.1" + id("org.flywaydb.flyway") version "12.4.0" + id("org.springdoc.openapi-gradle-plugin") version "1.9.0" } group = "com.example" @@ -28,7 +38,6 @@ repositories { } dependencies { - implementation("org.springframework.boot:spring-boot-starter-actuator") implementation("org.springframework.boot:spring-boot-starter-data-jpa") implementation("org.springframework.boot:spring-boot-starter-flyway") implementation("org.springframework.boot:spring-boot-starter-webmvc") @@ -55,3 +64,20 @@ spotless { googleJavaFormat() } } + +// `mise run db:dev:migrate:up` and `db:dev:migrate:status` use these. +flyway { + url = System.getenv("DATABASE_URL") + locations = arrayOf("filesystem:src/main/resources/db/migration") +} + +// `mise run contract` boots the app with the openapi profile, which needs no +// database, and saves the spec to backend/openapi.json. +openApi { + apiDocsUrl = "http://127.0.0.1:3999/api/v1/openapi.json" + outputDir = layout.projectDirectory + outputFileName = "openapi.json" + customBootRun { + args = listOf("--spring.profiles.active=openapi") + } +} diff --git a/backend/openapi.json b/backend/openapi.json new file mode 100644 index 0000000..63ba94b --- /dev/null +++ b/backend/openapi.json @@ -0,0 +1,96 @@ +{ + "openapi": "3.1.0", + "info": { + "title": "API", + "version": "1.0.0" + }, + "servers": [ + { + "url": "/" + } + ], + "paths": { + "/api/v1/messages": { + "get": { + "tags": [ + "message-controller" + ], + "operationId": "listMessages", + "responses": { + "200": { + "description": "The 50 most recent messages", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/Message" + } + } + } + } + } + } + } + }, + "/api/v1/health": { + "get": { + "tags": [ + "health-controller" + ], + "operationId": "getHealth", + "responses": { + "200": { + "description": "The API and database are reachable", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Health" + } + } + } + } + } + } + } + }, + "components": { + "schemas": { + "Message": { + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int32" + }, + "text": { + "type": "string" + }, + "createdAt": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "createdAt", + "id", + "text" + ] + }, + "Health": { + "type": "object", + "properties": { + "status": { + "type": "string", + "enum": [ + "ok" + ] + } + }, + "required": [ + "status" + ] + } + } + } +} \ No newline at end of file diff --git a/backend/src/main/java/com/example/app/Application.java b/backend/src/main/java/com/example/app/Application.java index 45cb6f8..c2576e2 100644 --- a/backend/src/main/java/com/example/app/Application.java +++ b/backend/src/main/java/com/example/app/Application.java @@ -8,7 +8,7 @@ // Server "/" keeps the generated frontend client on relative URLs, so requests // go through the Vite proxy in dev and nginx in deploy. -@OpenAPIDefinition(info = @Info(title = "App API", version = "v1"), servers = @Server(url = "/")) +@OpenAPIDefinition(info = @Info(title = "API", version = "1.0.0"), servers = @Server(url = "/")) @SpringBootApplication public class Application { diff --git a/backend/src/main/java/com/example/app/controller/HealthController.java b/backend/src/main/java/com/example/app/controller/HealthController.java new file mode 100644 index 0000000..92adb22 --- /dev/null +++ b/backend/src/main/java/com/example/app/controller/HealthController.java @@ -0,0 +1,28 @@ +package com.example.app.controller; + +import com.example.app.dto.HealthDTO; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.responses.ApiResponse; +import org.springframework.jdbc.core.simple.JdbcClient; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +@RestController +@RequestMapping("/api/v1/health") +public class HealthController { + + private final JdbcClient jdbcClient; + + public HealthController(JdbcClient jdbcClient) { + this.jdbcClient = jdbcClient; + } + + @Operation(operationId = "getHealth") + @ApiResponse(responseCode = "200", description = "The API and database are reachable") + @GetMapping + public HealthDTO getHealth() { + jdbcClient.sql("SELECT 1").query(Integer.class).single(); + return new HealthDTO("ok"); + } +} diff --git a/backend/src/main/java/com/example/app/controller/MessageController.java b/backend/src/main/java/com/example/app/controller/MessageController.java index 82ac491..4025d2a 100644 --- a/backend/src/main/java/com/example/app/controller/MessageController.java +++ b/backend/src/main/java/com/example/app/controller/MessageController.java @@ -3,13 +3,14 @@ import com.example.app.dto.MessageDTO; import com.example.app.service.MessageService; import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.responses.ApiResponse; import java.util.List; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; @RestController -@RequestMapping("/api/messages") +@RequestMapping("/api/v1/messages") public class MessageController { private final MessageService messageService; @@ -20,6 +21,7 @@ public MessageController(MessageService messageService) { // operationId becomes the function name in the generated frontend client. @Operation(operationId = "listMessages") + @ApiResponse(responseCode = "200", description = "The 50 most recent messages") @GetMapping public List listMessages() { return messageService.listMessages(); diff --git a/backend/src/main/java/com/example/app/dao/MessageDAO.java b/backend/src/main/java/com/example/app/dao/MessageDAO.java index 69b41a3..1042f46 100644 --- a/backend/src/main/java/com/example/app/dao/MessageDAO.java +++ b/backend/src/main/java/com/example/app/dao/MessageDAO.java @@ -16,10 +16,8 @@ public MessageDAO(MessageRepository repository) { this.repository = repository; } - public List findAll() { - return repository.findAllByOrderByCreatedAtDescIdDesc().stream() - .map(MessageDAO::toDTO) - .toList(); + public List findLatest() { + return repository.findLatest().stream().map(MessageDAO::toDTO).toList(); } private static MessageDTO toDTO(Message message) { diff --git a/backend/src/main/java/com/example/app/dto/HealthDTO.java b/backend/src/main/java/com/example/app/dto/HealthDTO.java new file mode 100644 index 0000000..33307e5 --- /dev/null +++ b/backend/src/main/java/com/example/app/dto/HealthDTO.java @@ -0,0 +1,8 @@ +package com.example.app.dto; + +import io.swagger.v3.oas.annotations.media.Schema; + +@Schema( + name = "Health", + requiredProperties = {"status"}) +public record HealthDTO(@Schema(allowableValues = "ok") String status) {} diff --git a/backend/src/main/java/com/example/app/dto/MessageDTO.java b/backend/src/main/java/com/example/app/dto/MessageDTO.java index 9f6d93e..6200ecf 100644 --- a/backend/src/main/java/com/example/app/dto/MessageDTO.java +++ b/backend/src/main/java/com/example/app/dto/MessageDTO.java @@ -1,17 +1,22 @@ package com.example.app.dto; +import io.swagger.v3.oas.annotations.media.Schema; import java.time.Instant; import lombok.AllArgsConstructor; import lombok.Builder; import lombok.Data; import lombok.NoArgsConstructor; +// name sets the type name in the generated frontend client. +@Schema( + name = "Message", + requiredProperties = {"id", "text", "createdAt"}) @Data @Builder @NoArgsConstructor @AllArgsConstructor public class MessageDTO { - private long id; + private int id; private String text; private Instant createdAt; } diff --git a/backend/src/main/java/com/example/app/entity/Message.java b/backend/src/main/java/com/example/app/entity/Message.java index 8755904..a39013c 100644 --- a/backend/src/main/java/com/example/app/entity/Message.java +++ b/backend/src/main/java/com/example/app/entity/Message.java @@ -9,6 +9,7 @@ import java.time.Instant; import lombok.Getter; import lombok.Setter; +import org.hibernate.annotations.ColumnDefault; // @Getter/@Setter because Lombok's equals/hashCode break JPA entities. @Entity @@ -19,11 +20,12 @@ public class Message { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) - private Long id; + private Integer id; @Column(nullable = false, columnDefinition = "text") private String text; + @ColumnDefault("now()") @Column(name = "created_at", nullable = false, insertable = false, updatable = false) private Instant createdAt; } diff --git a/backend/src/main/java/com/example/app/repository/MessageRepository.java b/backend/src/main/java/com/example/app/repository/MessageRepository.java index 902e566..d58b035 100644 --- a/backend/src/main/java/com/example/app/repository/MessageRepository.java +++ b/backend/src/main/java/com/example/app/repository/MessageRepository.java @@ -3,10 +3,14 @@ import com.example.app.entity.Message; import java.util.List; import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Query; import org.springframework.stereotype.Repository; @Repository -public interface MessageRepository extends JpaRepository { +public interface MessageRepository extends JpaRepository { - List findAllByOrderByCreatedAtDescIdDesc(); + @Query( + value = "SELECT * FROM messages ORDER BY created_at DESC, id DESC LIMIT 50", + nativeQuery = true) + List findLatest(); } diff --git a/backend/src/main/java/com/example/app/service/MessageService.java b/backend/src/main/java/com/example/app/service/MessageService.java index e9cf40a..60dbcc4 100644 --- a/backend/src/main/java/com/example/app/service/MessageService.java +++ b/backend/src/main/java/com/example/app/service/MessageService.java @@ -15,6 +15,6 @@ public MessageService(MessageDAO messageDAO) { } public List listMessages() { - return messageDAO.findAll(); + return messageDAO.findLatest(); } } diff --git a/backend/src/main/resources/application-openapi.yaml b/backend/src/main/resources/application-openapi.yaml new file mode 100644 index 0000000..d124b66 --- /dev/null +++ b/backend/src/main/resources/application-openapi.yaml @@ -0,0 +1,21 @@ +# Used only by `mise run contract`. Boots the app without a database so the +# OpenAPI spec can be exported anywhere, including CI and Docker builds. +server: + port: 3999 + +spring: + datasource: + url: jdbc:postgresql://localhost/placeholder + flyway: + enabled: false + jpa: + database-platform: org.hibernate.dialect.PostgreSQLDialect + hibernate: + ddl-auto: none + properties: + hibernate: + boot.allow_jdbc_metadata_access: false + +logging: + level: + root: info diff --git a/backend/src/main/resources/application.yaml b/backend/src/main/resources/application.yaml index f78a314..dfa41b2 100644 --- a/backend/src/main/resources/application.yaml +++ b/backend/src/main/resources/application.yaml @@ -1,7 +1,7 @@ -# Values in ${...} have no defaults on purpose. Docker Compose injects them -# from .env, so run the app with `mise run dev`. +# Values in ${...} come from .env, which mise loads for local tasks and Docker +# Compose passes to the containers. server: - port: 3000 + port: ${PORT:3000} # nginx sits in front of the backend and sets X-Forwarded-* headers. forward-headers-strategy: framework shutdown: graceful @@ -10,9 +10,7 @@ spring: application: name: app datasource: - url: jdbc:postgresql://${DB_HOST}:${DB_PORT}/${POSTGRES_DB} - username: ${POSTGRES_USER} - password: ${POSTGRES_PASSWORD} + url: ${DATABASE_URL} jpa: # Flyway owns the schema. Hibernate only checks that the entities match it. hibernate: @@ -21,11 +19,9 @@ spring: springdoc: api-docs: - path: /api/openapi.json + path: /api/v1/openapi.json default-produces-media-type: application/json -management: - endpoints: - web: - exposure: - include: health +logging: + level: + root: ${LOG_LEVEL:info} diff --git a/backend/src/main/resources/db/migration/V1__create_messages.sql b/backend/src/main/resources/db/migration/V1__create_messages.sql deleted file mode 100644 index 52ce24b..0000000 --- a/backend/src/main/resources/db/migration/V1__create_messages.sql +++ /dev/null @@ -1,7 +0,0 @@ -CREATE TABLE messages ( - id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY, - text TEXT NOT NULL, - created_at TIMESTAMPTZ NOT NULL DEFAULT now() -); - -INSERT INTO messages (text) VALUES ('Hello from Postgres!'); diff --git a/backend/src/main/resources/db/migration/V1__init.sql b/backend/src/main/resources/db/migration/V1__init.sql new file mode 100644 index 0000000..e762db6 --- /dev/null +++ b/backend/src/main/resources/db/migration/V1__init.sql @@ -0,0 +1,11 @@ + + create table messages ( + id integer generated by default as identity, + created_at timestamp(6) with time zone default now() not null, + text text not null, + primary key (id) + ); + +INSERT INTO messages (text) VALUES + ('Hello from the database'), + ('These rows come from the first migration'); diff --git a/compose.override.yaml b/compose.override.yaml index 65a0a62..a56ca76 100644 --- a/compose.override.yaml +++ b/compose.override.yaml @@ -1,11 +1,11 @@ -# Development overrides, merged automatically by `docker compose` (`mise run dev`). +# Development overrides, merged automatically by `docker compose` (`mise run dev:up`). services: db: environment: # Fails fast with a readable message when .env is missing or incomplete. - POSTGRES_USER: ${POSTGRES_USER:?missing. Run `mise run setup` to create .env} - POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?missing. Run `mise run setup` to create .env} - POSTGRES_DB: ${POSTGRES_DB:?missing. Run `mise run setup` to create .env} + POSTGRES_USER: ${SERVICE_USER_POSTGRES:?missing, run cp .env.example .env} + POSTGRES_PASSWORD: ${SERVICE_PASSWORD_POSTGRES:?missing, run cp .env.example .env} + POSTGRES_DB: ${POSTGRES_DB:?missing, run cp .env.example .env} ports: - "127.0.0.1:${POSTGRES_PORT:-5432}:5432" @@ -14,10 +14,12 @@ services: image: ${COMPOSE_PROJECT_NAME}-backend:local build: target: local + environment: + # Spring only colors logs on a terminal, and the container has none. + SPRING_OUTPUT_ANSI_ENABLED: always volumes: - ./backend/src:/app/src ports: - # `mise run contract` reads the OpenAPI spec from here. - "127.0.0.1:3000:3000" healthcheck: start_period: 120s @@ -28,8 +30,11 @@ services: target: local environment: BACKEND_URL: http://backend:3000 + ports: !override + - "127.0.0.1:5173:5173" + # In dev the frontend does not need to wait for the backend to be healthy. + depends_on: !reset {} healthcheck: - test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:8080/').then((r) => process.exit(r.ok ? 0 : 1), () => process.exit(1))"] + test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:5173/').then((r) => process.exit(r.ok ? 0 : 1), () => process.exit(1))"] volumes: - - ./frontend/src:/app/src - - ./contract:/contract + - ./frontend/src:/app/frontend/src diff --git a/compose.yaml b/compose.yaml index ac9b072..26bcce0 100644 --- a/compose.yaml +++ b/compose.yaml @@ -1,10 +1,13 @@ -# Deploy-like stack: built jar + nginx. `mise run stack` runs this file alone. -# `mise run dev` merges compose.override.yaml on top for development. +# Deploy-like stack: built jar + nginx. `mise run stack:dev:up` runs this file alone. +# `mise run dev:up` merges compose.override.yaml on top for development. services: db: image: postgres:18-alpine restart: unless-stopped - env_file: .env + environment: + POSTGRES_USER: ${SERVICE_USER_POSTGRES:-app} + POSTGRES_PASSWORD: ${SERVICE_PASSWORD_POSTGRES:-app} + POSTGRES_DB: ${POSTGRES_DB:-app} volumes: - db-data:/var/lib/postgresql healthcheck: @@ -18,15 +21,15 @@ services: context: backend target: deploy restart: unless-stopped - env_file: .env environment: - DB_HOST: db - DB_PORT: 5432 + PORT: 3000 + DATABASE_URL: jdbc:postgresql://db:5432/${POSTGRES_DB:-app}?user=${SERVICE_USER_POSTGRES:-app}&password=${SERVICE_PASSWORD_POSTGRES:-app} + LOG_LEVEL: ${LOG_LEVEL:-info} depends_on: db: condition: service_healthy healthcheck: - test: ["CMD", "wget", "-q", "--spider", "http://127.0.0.1:3000/actuator/health"] + test: ["CMD", "wget", "-q", "--spider", "http://127.0.0.1:3000/api/v1/health"] interval: 10s timeout: 5s retries: 5 diff --git a/contract/openapi.json b/contract/openapi.json deleted file mode 100644 index e4681e7..0000000 --- a/contract/openapi.json +++ /dev/null @@ -1,57 +0,0 @@ -{ - "openapi": "3.1.0", - "info": { - "title": "App API", - "version": "v1" - }, - "servers": [ - { - "url": "/" - } - ], - "paths": { - "/api/messages": { - "get": { - "tags": [ - "message-controller" - ], - "operationId": "listMessages", - "responses": { - "200": { - "description": "OK", - "content": { - "application/json": { - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/MessageDTO" - } - } - } - } - } - } - } - } - }, - "components": { - "schemas": { - "MessageDTO": { - "type": "object", - "properties": { - "id": { - "type": "integer", - "format": "int64" - }, - "text": { - "type": "string" - }, - "createdAt": { - "type": "string", - "format": "date-time" - } - } - } - } - } -} diff --git a/frontend/.oxfmtrc.json b/frontend/.oxfmtrc.json index aeb7441..03521aa 100644 --- a/frontend/.oxfmtrc.json +++ b/frontend/.oxfmtrc.json @@ -1,4 +1,3 @@ { - "$schema": "./node_modules/oxfmt/configuration_schema.json", - "ignorePatterns": ["src/api/generated/**"] + "ignorePatterns": ["dist/**", "src/api/generated/**", "pnpm-lock.yaml"] } diff --git a/frontend/.oxlintrc.json b/frontend/.oxlintrc.json deleted file mode 100644 index 12ff3d4..0000000 --- a/frontend/.oxlintrc.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "$schema": "./node_modules/oxlint/configuration_schema.json", - "plugins": ["react", "typescript", "oxc"], - "ignorePatterns": ["src/api/generated/**"] -} diff --git a/frontend/Dockerfile b/frontend/Dockerfile index 42cd641..f4b2cef 100644 --- a/frontend/Dockerfile +++ b/frontend/Dockerfile @@ -1,21 +1,20 @@ FROM node:24-slim AS base RUN corepack enable -WORKDIR /app +WORKDIR /app/frontend COPY frontend/package.json frontend/pnpm-lock.yaml ./ RUN pnpm install --frozen-lockfile -# Dev server. compose.override.yaml bind-mounts the source over /app/src. +# Dev server. compose.override.yaml bind-mounts the source over /app/frontend/src. FROM base AS local COPY frontend ./ -COPY contract /contract -CMD ["sh", "-c", "pnpm exec openapi-ts && pnpm exec vite"] +CMD ["pnpm", "exec", "vite"] FROM base AS build COPY frontend ./ -COPY contract /contract +COPY backend/openapi.json /app/backend/openapi.json RUN pnpm exec openapi-ts && pnpm run build FROM nginxinc/nginx-unprivileged:1.30-alpine AS deploy COPY frontend/nginx.conf /etc/nginx/conf.d/default.conf -COPY --from=build /app/dist /usr/share/nginx/html +COPY --from=build /app/frontend/dist /usr/share/nginx/html EXPOSE 8080 diff --git a/frontend/nginx.conf b/frontend/nginx.conf index 09f5bd5..72bb533 100644 --- a/frontend/nginx.conf +++ b/frontend/nginx.conf @@ -1,7 +1,6 @@ server { listen 8080; root /usr/share/nginx/html; - index index.html; # Resolving "backend" through Docker's DNS on each request keeps the proxy working # after the backend container is recreated with a new IP. @@ -10,13 +9,11 @@ server { location /api/ { proxy_pass $backend; - proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto; } - # Unknown paths fall back to index.html so client-side routes work on refresh. location / { try_files $uri $uri/ /index.html; } diff --git a/frontend/openapi-ts.config.ts b/frontend/openapi-ts.config.ts index c7e2f48..847992a 100644 --- a/frontend/openapi-ts.config.ts +++ b/frontend/openapi-ts.config.ts @@ -1,7 +1,7 @@ import { defineConfig } from "@hey-api/openapi-ts"; export default defineConfig({ - input: "../contract/openapi.json", + input: "../backend/openapi.json", output: "src/api/generated", - plugins: ["@hey-api/client-fetch", "@hey-api/sdk"], + plugins: ["@hey-api/client-fetch", "zod", { name: "@hey-api/sdk", validator: true }], }); diff --git a/frontend/oxlint.config.ts b/frontend/oxlint.config.ts new file mode 100644 index 0000000..c2dce0f --- /dev/null +++ b/frontend/oxlint.config.ts @@ -0,0 +1,21 @@ +import { defineConfig } from "oxlint"; + +export default defineConfig({ + plugins: ["typescript", "unicorn", "oxc", "import", "react"], + categories: { + correctness: "error", + suspicious: "error", + }, + ignorePatterns: ["dist/**", "src/api/generated/**"], + rules: { + "typescript/no-floating-promises": "error", + "typescript/no-explicit-any": "error", + "no-console": "error", + eqeqeq: "error", + "func-style": ["error", "expression"], + "prefer-arrow-callback": "error", + "typescript/consistent-type-definitions": ["error", "type"], + "react/react-in-jsx-scope": "off", + "typescript/consistent-return": "off", + }, +}); diff --git a/frontend/package.json b/frontend/package.json index 469b37d..4208876 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -8,7 +8,8 @@ }, "dependencies": { "react": "19.3.1", - "react-dom": "19.3.1" + "react-dom": "19.3.1", + "zod": "4.6.7" }, "devDependencies": { "@hey-api/openapi-ts": "0.99.0", @@ -18,6 +19,7 @@ "@vitejs/plugin-react": "6.1.2", "oxfmt": "0.73.0", "oxlint": "1.88.0", + "oxlint-tsgolint": "7.0.2004", "typescript": "6.0.3", "vite": "8.3.4" }, diff --git a/frontend/pnpm-lock.yaml b/frontend/pnpm-lock.yaml index 801570f..d6668f2 100644 --- a/frontend/pnpm-lock.yaml +++ b/frontend/pnpm-lock.yaml @@ -172,6 +172,9 @@ importers: react-dom: specifier: 19.3.1 version: 19.3.1(react@19.3.1) + zod: + specifier: 4.6.7 + version: 4.6.7 devDependencies: '@hey-api/openapi-ts': specifier: 0.99.0 @@ -193,7 +196,10 @@ importers: version: 0.73.0 oxlint: specifier: 1.88.0 - version: 1.88.0 + version: 1.88.0(oxlint-tsgolint@7.0.2004) + oxlint-tsgolint: + specifier: 7.0.2004 + version: 7.0.2004 typescript: specifier: 6.0.3 version: 6.0.3 @@ -360,6 +366,36 @@ packages: cpu: [x64] os: [win32] + '@oxlint-tsgolint/darwin-arm64@7.0.2004': + resolution: {integrity: sha512-uJk3ttju7Lz+Nv8WG4CsLyewoL1qf/Ny8S8OksJ7Bm/F14Tc9gMfW6arM1PCc57IzH/X/I79YsCWTgxX1FKibQ==} + cpu: [arm64] + os: [darwin] + + '@oxlint-tsgolint/darwin-x64@7.0.2004': + resolution: {integrity: sha512-0BFfHTzDxNDFPcu0UZAXT6CyCJHAXM0dZveyDb4KEHa2qF/DSnOKOrmvK/wFuFol9kvijbGM9JfuOsor+zWXRw==} + cpu: [x64] + os: [darwin] + + '@oxlint-tsgolint/linux-arm64@7.0.2004': + resolution: {integrity: sha512-TAehQc+qdRXyDN3nl/r/3/oPrBVrbtrDeGMkFyG6mf+XphpoJ2lAMVFLclyvrVZCw02RbKROjyw8h72XwQQHcw==} + cpu: [arm64] + os: [linux] + + '@oxlint-tsgolint/linux-x64@7.0.2004': + resolution: {integrity: sha512-LPunZvm6ZbWPfHMAyfZf9ci3HHvNEzLejO8zdqO3GoVGoSEHqqufHUD7+OgeatVSaJP7uXDJ2HaNOHIoH7go4Q==} + cpu: [x64] + os: [linux] + + '@oxlint-tsgolint/win32-arm64@7.0.2004': + resolution: {integrity: sha512-FVWplzDImWhiuawnIZVETaQecv4GWom6Jv4Fx2xj7hhXXDZ5okEgiw1gTCImHTIQsi2ycC5oSxVwrn69bMh7iw==} + cpu: [arm64] + os: [win32] + + '@oxlint-tsgolint/win32-x64@7.0.2004': + resolution: {integrity: sha512-7PsxuUx11Ry9DYTWcljTzRbmZY9B6O9fFFfZV+aodQEMy6pfRT3fhoQRv9PtGN/89z1pPz3nFKrsFm6WqNtX7w==} + cpu: [x64] + os: [win32] + '@oxlint/binding-android-arm-eabi@1.88.0': resolution: {integrity: sha512-k6Fgkf86ubfeH4GvqYsRolfuVAp0pfYVZvifSlXNHPdMaWUOfxUrmLEeDD7hF6U2oJuhsVxhSWq86/xCJ+9MmA==} engines: {node: ^20.19.0 || >=22.12.0} @@ -836,6 +872,10 @@ packages: vite-plus: optional: true + oxlint-tsgolint@7.0.2004: + resolution: {integrity: sha512-vQ9WDF3fiZJvRdSDosNOflerOCOpwol6vWzVDxW76RcU19cjTh7engvkHLvmv+tzedR8fAiJUVUGr6IVZdkzXQ==} + hasBin: true + oxlint@1.88.0: resolution: {integrity: sha512-uIcFgw8BmqvFRGzH5+r7d2zJMEexwNSrEmM6WQNnGh3VkO0XYTEFoyxyNE6tjKMUib9Cue4XJA2DoWruO5D6aw==} engines: {node: ^20.19.0 || >=22.12.0} @@ -993,6 +1033,9 @@ packages: resolution: {integrity: sha512-g/eziiSUNBSsdDJtCLB8bdYEUMj4jR7AGeUo96p/3dTafgjHhpF4RiCFPiRILwjQoDXx5MqkBr4fwWtR3Ky4Wg==} engines: {node: '>=20'} + zod@4.6.7: + resolution: {integrity: sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg==} + snapshots: '@hey-api/codegen-core@0.9.1': @@ -1108,6 +1151,24 @@ snapshots: '@oxfmt/binding-win32-x64-msvc@0.73.0': optional: true + '@oxlint-tsgolint/darwin-arm64@7.0.2004': + optional: true + + '@oxlint-tsgolint/darwin-x64@7.0.2004': + optional: true + + '@oxlint-tsgolint/linux-arm64@7.0.2004': + optional: true + + '@oxlint-tsgolint/linux-x64@7.0.2004': + optional: true + + '@oxlint-tsgolint/win32-arm64@7.0.2004': + optional: true + + '@oxlint-tsgolint/win32-x64@7.0.2004': + optional: true + '@oxlint/binding-android-arm-eabi@1.88.0': optional: true @@ -1412,7 +1473,16 @@ snapshots: '@oxfmt/binding-win32-ia32-msvc': 0.73.0 '@oxfmt/binding-win32-x64-msvc': 0.73.0 - oxlint@1.88.0: + oxlint-tsgolint@7.0.2004: + optionalDependencies: + '@oxlint-tsgolint/darwin-arm64': 7.0.2004 + '@oxlint-tsgolint/darwin-x64': 7.0.2004 + '@oxlint-tsgolint/linux-arm64': 7.0.2004 + '@oxlint-tsgolint/linux-x64': 7.0.2004 + '@oxlint-tsgolint/win32-arm64': 7.0.2004 + '@oxlint-tsgolint/win32-x64': 7.0.2004 + + oxlint@1.88.0(oxlint-tsgolint@7.0.2004): optionalDependencies: '@oxlint/binding-android-arm-eabi': 1.88.0 '@oxlint/binding-android-arm64': 1.88.0 @@ -1433,6 +1503,7 @@ snapshots: '@oxlint/binding-win32-arm64-msvc': 1.88.0 '@oxlint/binding-win32-ia32-msvc': 1.88.0 '@oxlint/binding-win32-x64-msvc': 1.88.0 + oxlint-tsgolint: 7.0.2004 path-key@3.1.1: {} @@ -1540,3 +1611,5 @@ snapshots: dependencies: is-wsl: 3.1.1 powershell-utils: 0.1.0 + + zod@4.6.7: {} diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx index eb4c400..65fc9c4 100644 --- a/frontend/src/App.tsx +++ b/frontend/src/App.tsx @@ -1,23 +1,25 @@ -import { useEffect, useState } from "react"; -import { listMessages, type MessageDto } from "./api/generated"; +import { useState } from "react"; +import { listMessages, type Message } from "./api/generated"; -export function App() { - const [messages, setMessages] = useState([]); +export const App = () => { + const [messages, setMessages] = useState([]); const [error, setError] = useState(); - useEffect(() => { - listMessages().then((result) => { - if (!result.data) { - setError("Could not load messages"); - return; - } - setMessages(result.data); - }); - }, []); + const load = async () => { + const result = await listMessages(); + if (!result.data) { + setError("Could not load messages"); + return; + } + setError(undefined); + setMessages(result.data); + }; return (
-

Messages

+ {error &&

{error}

}
    {messages.map((message) => ( @@ -26,4 +28,4 @@ export function App() {
); -} +}; diff --git a/frontend/tsconfig.json b/frontend/tsconfig.json index 03435fa..ae1155d 100644 --- a/frontend/tsconfig.json +++ b/frontend/tsconfig.json @@ -8,13 +8,15 @@ "types": ["vite/client", "node"], "strict": true, "noUncheckedIndexedAccess": true, + "noImplicitOverride": true, "noUnusedLocals": true, "noUnusedParameters": true, "noFallthroughCasesInSwitch": true, "verbatimModuleSyntax": true, + "erasableSyntaxOnly": true, "isolatedModules": true, "skipLibCheck": true, "noEmit": true }, - "include": ["src", "vite.config.ts", "openapi-ts.config.ts"] + "include": ["src", "vite.config.ts", "openapi-ts.config.ts", "oxlint.config.ts"] } diff --git a/frontend/vite.config.ts b/frontend/vite.config.ts index d4d03f8..88bdd00 100644 --- a/frontend/vite.config.ts +++ b/frontend/vite.config.ts @@ -1,20 +1,20 @@ import react from "@vitejs/plugin-react"; import { defineConfig } from "vite"; -// Set by compose.override.yaml. There is no fallback on purpose: run the app -// with `mise run dev`, not `pnpm dev` on your machine. +// Set by compose.override.yaml. There is no fallback on purpose: the frontend +// runs in Docker with `mise run dev:up`, not with `pnpm dev` on your machine. const backendUrl = process.env.BACKEND_URL; export default defineConfig(({ command }) => { if (command === "serve" && !backendUrl) { - throw new Error("BACKEND_URL is not set. Run the app with `mise run dev`."); + throw new Error("BACKEND_URL is not set. Run the app with `mise run dev:up`."); } return { plugins: [react()], server: { host: true, - port: 8080, + port: 5173, strictPort: true, proxy: { "/api": backendUrl ?? "" }, }, diff --git a/mise.toml b/mise.toml index 7de05d1..590b13a 100644 --- a/mise.toml +++ b/mise.toml @@ -1,73 +1,70 @@ -# mise only installs tools and runs tasks. It does not load .env: the app gets -# its config from Docker, so run it with `mise run dev`. +# The app always runs in Docker. mise loads .env, and Docker Compose passes it +# into the containers. Lint, format and the OpenAPI export run on your machine +# because they never need the database. [tools] java = "temurin-25" node = "24.22.0" pnpm = "12.14.0" -jq = "1.8.2" +"npm:prisma" = "7.9.1" -# ─── setup ─── +[env] +_.file = ".env" -[tasks.setup] -description = "Create .env, install frontend dependencies, and generate the API client" -run = [ - "test -f .env || cp .env.example .env", - "pnpm --dir frontend install", - { task = "contract:client" }, -] +[tasks."setup:dev"] +description = "Install frontend dependencies, generate the contract, and start every container" +run = ["pnpm install --dir frontend", { task = "contract" }, { task = "dev:up" }] -# ─── dev (Docker, compose.yaml + compose.override.yaml) ─── - -[tasks.dev] -description = "Run web, backend and db in Docker (http://localhost:8080)" -run = "docker compose up --build" +[tasks."dev:up"] +description = "Build and start db, backend and web in Docker (web on :5173)" +run = "docker compose up -d --build --wait" [tasks."dev:down"] -description = "Stop the dev containers" +description = "Stop every container. Database data is kept." run = "docker compose down" [tasks."dev:logs"] -description = "Follow the dev container logs" +description = "Follow the logs of every container" run = "docker compose logs -f" [tasks."dev:restart"] description = "Restart the backend to pick up Java changes" run = "docker compose restart backend" -# ─── stack (Docker, compose.yaml only: built jar + nginx, like a deploy) ─── - -[tasks.stack] -description = "Build and run the deploy images (http://localhost:8080)" +[tasks."stack:dev:up"] +description = "Build and start the deploy images (built jar + nginx, web on :8080)" run = "docker compose -f compose.yaml up --build --wait" -[tasks."stack:down"] +[tasks."stack:dev:down"] description = "Stop the deploy containers" run = "docker compose -f compose.yaml down" -# ─── db ─── +[tasks."stack:dev:logs"] +description = "Follow the logs of the deploy containers" +run = "docker compose -f compose.yaml logs -f" [tasks."db:dev:start"] -description = "Start only the dev database" -run = "docker compose up -d --wait db" +description = "Start the development database" +run = "docker compose up -d db --wait" [tasks."db:dev:stop"] -description = "Stop the dev database" +description = "Stop the development database" run = "docker compose stop db" -[tasks."db:dev:psql"] -description = "Open psql in the dev database" -run = "docker compose exec db sh -c 'psql -U \"$POSTGRES_USER\" \"$POSTGRES_DB\"'" +[tasks."db:dev:studio"] +description = "Open Prisma Studio on the development database (http://localhost:5555)" +depends = ["db:dev:start"] +run = 'prisma studio --port 5555 --url "postgresql://$SERVICE_USER_POSTGRES:$SERVICE_PASSWORD_POSTGRES@localhost:$POSTGRES_PORT/$POSTGRES_DB"' -[tasks."db:dev:reset"] -description = "Delete the dev database volume (migrations rerun on next start)" -confirm = "Delete all data in the dev database?" -run = "docker compose down -v" +[tasks."db:dev:psql"] +description = "Open psql in the development database" +depends = ["db:dev:start"] +run = "docker compose exec db sh -c 'psql -U \"$POSTGRES_USER\" -d \"$POSTGRES_DB\"'" -[tasks."db:dev:migration"] -description = "Generate the next Flyway migration from changes to the JPA entities" +[tasks."db:dev:migrate:generate"] +description = "Generate the next Flyway migration from changes to the JPA entities (arg: name)" usage = 'arg "" help="snake_case description, e.g. add_users"' -depends = ["db:dev:start"] +depends = ["db:dev:migrate:up"] run = ''' dir=backend/src/main/resources/db/migration last=$(ls "$dir" | sed -nE 's/^V([0-9]+)__.*/\1/p' | sort -n | tail -1) @@ -75,95 +72,119 @@ file="V$(( ${last:-0} + 1 ))__${usage_name}.sql" # Boots the app once without a web server: Flyway applies the existing # migrations, then Hibernate writes the SQL needed to match the entities. -docker compose run --rm -T backend ./gradlew bootRun --no-daemon --quiet --args="\ +docker compose run --rm --no-deps -T backend ./gradlew bootRun --no-daemon --quiet --args="\ --spring.main.web-application-type=none \ --spring.jpa.hibernate.ddl-auto=none \ --spring.jpa.properties.jakarta.persistence.schema-generation.scripts.action=update \ --spring.jpa.properties.jakarta.persistence.schema-generation.scripts.create-target=/app/src/main/resources/db/migration/$file \ - --spring.jpa.properties.hibernate.hbm2ddl.delimiter=;" + --spring.jpa.properties.hibernate.hbm2ddl.delimiter=; \ + --spring.jpa.properties.hibernate.format_sql=true" if [ ! -s "$dir/$file" ]; then rm -f "$dir/$file" - echo "The entities already match the database. No migration created." - exit 0 + echo "The entities already match the database. No migration created." >&2 + exit 1 fi -echo "Created $dir/$file. Review it before committing: Hibernate never drops columns or tables." +echo "Created $dir/$file. Review it, then run: mise run db:dev:migrate:up" ''' -# ─── contract ─── +[tasks."db:dev:migrate:up"] +description = "Apply pending migrations to the development database" +depends = ["db:dev:start"] +run = "docker compose run --rm --no-deps -T backend ./gradlew flywayMigrate --no-daemon --quiet" + +[tasks."db:dev:migrate:status"] +description = "Show whether the development database is missing any migrations" +depends = ["db:dev:start"] +run = "docker compose run --rm --no-deps -T backend ./gradlew flywayInfo --no-daemon --quiet" + +[tasks."db:dev:reset"] +description = "Delete the development database volume (migrations rerun on next start)" +confirm = "Delete all data in the development database?" +run = "docker compose down -v" [tasks.contract] -description = "Export the OpenAPI spec from the running backend and regenerate the client" -run = [ - "docker compose up -d --wait backend", - "curl -sf http://127.0.0.1:3000/api/openapi.json | jq . > contract/openapi.json", - { task = "contract:client" }, -] - -[tasks."contract:client"] -description = "Generate the frontend API client from contract/openapi.json" -dir = "frontend" -run = "pnpm exec openapi-ts" +description = "Regenerate backend/openapi.json, then the frontend client from it" +run = [{ task = "contract:backend:generate" }, { task = "contract:frontend:generate" }] + +[tasks."contract:backend:generate"] +description = "Write the backend's OpenAPI spec to backend/openapi.json" +dir = "backend" +run = "./gradlew generateOpenApiDocs --quiet" -# ─── lint ─── +[tasks."contract:frontend:generate"] +description = "Generate the frontend client in frontend/src/api/generated from backend/openapi.json" +run = "pnpm --dir frontend exec openapi-ts" + +[tasks."contract:check"] +description = "Fail if backend/openapi.json is out of date with the backend code" +depends = ["contract:backend:generate"] +run = "git diff --exit-code --stat backend/openapi.json || (echo 'backend/openapi.json is out of date. Run mise run contract and commit it.' >&2; exit 1)" [tasks."lint:backend"] -description = "Compile the backend with Error Prone" +description = "Lint and typecheck the backend" dir = "backend" -run = "./gradlew compileJava" +run = "./gradlew compileJava --quiet" [tasks."lint:frontend"] -description = "Run oxlint and the TypeScript compiler on the frontend" -depends = ["contract:client"] +description = "Lint and typecheck the frontend" +depends = ["contract:frontend:generate"] +dir = "frontend" +run = ["pnpm exec oxlint --type-aware", "pnpm exec tsc --noEmit"] + +[tasks."lint:frontend:fix"] +description = "Fix frontend lint issues" dir = "frontend" -run = ["pnpm exec oxlint", "pnpm exec tsc --noEmit"] +run = "pnpm exec oxlint --type-aware --fix" [tasks.lint] -description = "Lint the backend and frontend" +description = "Lint and typecheck everything" depends = ["lint:backend", "lint:frontend"] [tasks."lint:fix"] -description = "Apply oxlint fixes to the frontend" -dir = "frontend" -run = "pnpm exec oxlint --fix" - -# ─── format ─── +description = "Fix lint issues everywhere" +depends = ["lint:frontend:fix"] [tasks."fmt:backend"] alias = "format:backend" -description = "Check backend formatting (Spotless)" +description = "Check backend formatting" +dir = "backend" +run = "./gradlew spotlessCheck --quiet" + +[tasks."fmt:backend:fix"] +alias = "format:backend:fix" +description = "Format the backend" dir = "backend" -run = "./gradlew spotlessCheck" +run = "./gradlew spotlessApply --quiet" [tasks."fmt:frontend"] alias = "format:frontend" -description = "Check frontend formatting (oxfmt)" +description = "Check frontend formatting" dir = "frontend" run = "pnpm exec oxfmt --check" +[tasks."fmt:frontend:fix"] +alias = "format:frontend:fix" +description = "Format the frontend" +dir = "frontend" +run = "pnpm exec oxfmt" + [tasks.fmt] alias = "format" -description = "Check backend and frontend formatting" +description = "Check formatting everywhere" depends = ["fmt:backend", "fmt:frontend"] [tasks."fmt:fix"] alias = "format:fix" -description = "Format the backend and frontend" -run = [ - "cd backend && ./gradlew spotlessApply", - "cd frontend && pnpm exec oxfmt", -] - -# ─── build / check ─── +description = "Format everything" +depends = ["fmt:backend:fix", "fmt:frontend:fix"] [tasks.build] -description = "Build the backend jar and the frontend bundle" -depends = ["contract:client"] -run = [ - "cd backend && ./gradlew bootJar", - "cd frontend && pnpm run build", -] +description = "Build the backend and frontend" +depends = ["contract:frontend:generate"] +run = ["cd backend && ./gradlew bootJar --quiet", "pnpm --dir frontend run build"] [tasks.check] description = "Run everything CI runs" -depends = ["fmt", "lint"] +# One after another: parallel Gradle builds in one project fight over its lock. +run = [{ task = "fmt" }, { task = "lint" }, { task = "contract:check" }] From eeb3566fa251f2073553b51da0a7cf1bd63e23bc Mon Sep 17 00:00:00 2001 From: Anish Sahoo Date: Mon, 19 Oct 2026 20:06:17 -0400 Subject: [PATCH 04/11] docs: cut README down to setup, dev and migrations - add a short docs/ARCHITECTURE.md with the request flow --- README.md | 166 +++++++------------------------------------ docs/ARCHITECTURE.md | 16 +++++ 2 files changed, 41 insertions(+), 141 deletions(-) create mode 100644 docs/ARCHITECTURE.md diff --git a/README.md b/README.md index e47a642..2cfb4a9 100644 --- a/README.md +++ b/README.md @@ -1,55 +1,18 @@ # Spring Boot React starter -A three-container web app: a React frontend, a Spring Boot backend and a Postgres -database, all running in Docker. It ships with one example feature (a list of -messages) that shows a request going from React to Spring to Postgres and back. -Replace it with your own. +React, Spring Boot and Postgres. `mise tasks` lists every task. -There are matching TypeScript (Hono) and Python (FastAPI) starters with the same API, -the same frontend and the same `mise` tasks. +## Install mise -| Part | Stack | -| -------- | ------------------------------------------------------------------------------ | -| Frontend | React, Vite, a client generated from the API contract by `@hey-api/openapi-ts` | -| Backend | Spring Boot 4, Java 25, Spring Data JPA, springdoc-openapi, Lombok | -| Database | Postgres 18, migrations generated by Hibernate and applied by Flyway | -| Tooling | mise, Gradle, Spotless, Error Prone, oxlint, oxfmt, Docker Compose | - -``` -browser -> web :5173 -> /api/* -> backend :3000 -> db :5432 - (vite in dev, nginx :8080 when deployed) -``` - -## Layout - -``` -mise.toml Tool versions and every task you will run -compose.yaml The deployed stack: web, backend, db -compose.override.yaml Dev overrides: run from source, published ports -.env.example Local settings. Copy it to .env. -backend/ - src/main/java/com/example/app/ - controller/ HTTP routes - service/ Business logic - dao/ The only caller of repositories, maps entities to DTOs - dto/ Request and response shapes (these end up in the API client) - repository/ JpaRepository interfaces with native SQL queries - entity/ JPA entities. The source of truth for the schema. - src/main/resources/ - application.yaml Config, read from env vars - db/migration/ Generated Flyway migrations. Commit these. - openapi.json The API contract, generated from the controllers. Commit it. -frontend/ - src/App.tsx The page - src/api/generated/ Client generated from the contract (not committed) - nginx.conf Deployed web server: serves the app and proxies /api -.agents/rules/ Extra rules for AI agents, per folder -AGENTS.md Rules for agents and humans +```sh +curl https://mise.run | sh ``` -## Getting started +Then follow the printed step to activate it in your shell. See + for other installers. You also need +Docker. -You need [mise](https://mise.jdx.dev) and Docker. +## Set up ```sh mise install @@ -57,107 +20,28 @@ cp .env.example .env mise run setup:dev ``` -`setup:dev` installs the frontend packages, generates the API client and starts every -container. Open and press the button. - -> [!IMPORTANT] -> The app always runs in Docker. mise loads `.env`, and Docker Compose passes it into -> the containers. Running `./gradlew bootRun` or `pnpm dev` on your machine skips -> that, so the backend can't find the database and the frontend can't find the -> backend. - -The frontend reloads on save. The backend does not: run `mise run dev:restart` after -changing Java code. - -`mise tasks` lists every task. The ones you will use most: - -| Task | What it does | -| ----------------------------------------- | --------------------------------------------------------------- | -| `mise run dev:up` | Build and start db, backend and web in Docker | -| `mise run dev:down` | Stop every container. Database data is kept. | -| `mise run dev:restart` | Restart the backend after changing Java code | -| `mise run contract` | Regenerate `backend/openapi.json` and the frontend client | -| `mise run db:dev:migrate:generate ` | Write a SQL migration from your changes to the entities | -| `mise run db:dev:migrate:up` | Apply pending migrations | -| `mise run db:dev:migrate:status` | Show whether the database is missing migrations | -| `mise run db:dev:studio` | Open Prisma Studio on the dev database (:5555) | -| `mise run db:dev:psql` | Open psql in the database | -| `mise run check` | Run what CI runs: format check, lint, typecheck, contract check | -| `mise run fmt:fix` | Format everything | -| `mise run stack:dev:up` | Build and run the deploy images (jar + nginx) on :8080 | - -## The API contract - -The controllers and DTOs are the source of truth. `mise run contract` does two things: - -1. `contract:generate` boots the app briefly with the `openapi` profile, which needs no - database, and saves the spec springdoc builds to `backend/openapi.json`. Commit - this file. -2. `contract:client` generates a typed client with zod validators in - `frontend/src/api/generated/`. This folder is gitignored. +## Run -`mise run check` fails if `backend/openapi.json` is out of date with the controllers. +Everything runs in Docker. -The function names in the client come from `@Operation(operationId = ...)` on each -controller method, and type names come from `@Schema(name = ...)` on each DTO. - -## The database - -The entities in `backend/.../entity/` describe every table. Migrations are plain SQL -files in `backend/src/main/resources/db/migration/`. - -1. Edit or add an entity. -2. Run `mise run db:dev:migrate:generate add_something`. It boots the backend once in - a container, compares your entities to the dev database, and writes the SQL needed - to match them into the next `V__add_something.sql`. -3. Read the file. Hibernate never drops columns or tables, so write those statements - yourself. Then run `mise run db:dev:migrate:up`. -4. Commit the entity and the migration together. - -Migrations only go forward. Flyway's undo is a paid feature, so there is no down -task. Fix a mistake with a new migration, or run `mise run db:dev:reset` to start -over locally. - -After pulling a teammate's migration, `mise run db:dev:migrate:status` lists every -migration and marks the ones your database is missing as `Pending`. -`mise run db:dev:migrate:up` applies them. The backend also applies pending -migrations every time it starts. - -Queries are SQL too. Write them as `@Query(value = "...", nativeQuery = true)` on the -repository, as `MessageRepository` does, not as derived methods like -`findAllByOrderByCreatedAtDesc`. - -`mise run db:dev:studio` opens Prisma Studio on , already -connected to the dev database, to browse and edit rows. For raw SQL, use -`mise run db:dev:psql`. - -## Environment variables - -`.env.example` lists every variable. Copy it to `.env`, which is gitignored. mise -loads `.env` for every task, and Docker Compose reads it to build each container's -environment. To add one: +```sh +mise run dev:up # start db, backend and web +mise run dev:restart # after changing Java code +mise run dev:down # stop everything, data is kept +``` -1. Add it to `.env.example` and your `.env`. -2. Pass it to the `backend` service in `compose.yaml`. -3. Read it in `application.yaml` as `${MY_VAR}`, without a default. +Open . The API is on . -## Making it yours +## Migrations -- Rename the Java package: move `backend/src/main/java/com/example/app` and update - the `package` lines, then change `group` in `backend/build.gradle.kts`. -- Rename the project in `backend/settings.gradle.kts`, `frontend/package.json` and - `frontend/index.html`. -- Delete the `messages` example (entity, repository, DAO, DTO, service, controller), - run `mise run db:dev:migrate:generate remove_messages`, add the `DROP TABLE` it - can't write, then run `mise run contract`. +Tables are defined by the entities in `backend/src/main/java/com/example/app/entity/`. Change them there, then generate a migration. -## Linting and formatting +```sh +mise run db:dev:migrate:generate add_something # write SQL from your model changes +mise run db:dev:migrate:up # apply pending migrations +mise run db:dev:migrate:status # is the database behind? +``` -- Backend: [Spotless](https://github.com/diffplug/spotless) with google-java-format, - and [Error Prone](https://errorprone.info/), which runs inside `javac` and fails the - build on common bugs. -- Frontend: [oxlint](https://oxc.rs/docs/guide/usage/linter) and - [oxfmt](https://oxc.rs/docs/guide/usage/formatter), plus `tsc` for types. +Read the generated SQL before committing it. Hibernate never writes `DROP` statements, so add those yourself. There is no down migration: fix mistakes with a new one. -CI (`.github/workflows/ci.yml`) runs lint and format for each app on every pull -request. +`mise run db:dev:studio` opens Prisma Studio on . diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md new file mode 100644 index 0000000..60c3883 --- /dev/null +++ b/docs/ARCHITECTURE.md @@ -0,0 +1,16 @@ +# Architecture + +Local development: + +``` +browser -> Vite :5173 -> /api -> Spring :3000 -> Postgres :5432 (all in Docker) +``` + +Deployed (`compose.yaml`): + +``` +browser -> nginx :8080 -> /api -> Spring :3000 -> Postgres +``` + +The frontend only calls relative `/api/...` URLs. Vite forwards them in development and +nginx does it when deployed. From bdd31bdbc91629bbe3d34185b6b097f4d320173a Mon Sep 17 00:00:00 2001 From: Anish Sahoo Date: Mon, 19 Oct 2026 20:19:39 -0400 Subject: [PATCH 05/11] chore: simplify health check and dev tasks - health no longer queries the database - rename stack:dev:* to docker:dev:* - fold db:dev:down into db:dev:stop, which keeps the data - make func-style a lint warning --- backend/openapi.json | 2 +- .../com/example/app/controller/HealthController.java | 10 +--------- frontend/oxlint.config.ts | 4 +++- mise.toml | 10 +++++----- 4 files changed, 10 insertions(+), 16 deletions(-) diff --git a/backend/openapi.json b/backend/openapi.json index 63ba94b..5e75efb 100644 --- a/backend/openapi.json +++ b/backend/openapi.json @@ -41,7 +41,7 @@ "operationId": "getHealth", "responses": { "200": { - "description": "The API and database are reachable", + "description": "The API is reachable", "content": { "application/json": { "schema": { diff --git a/backend/src/main/java/com/example/app/controller/HealthController.java b/backend/src/main/java/com/example/app/controller/HealthController.java index 92adb22..fe75118 100644 --- a/backend/src/main/java/com/example/app/controller/HealthController.java +++ b/backend/src/main/java/com/example/app/controller/HealthController.java @@ -3,7 +3,6 @@ import com.example.app.dto.HealthDTO; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.responses.ApiResponse; -import org.springframework.jdbc.core.simple.JdbcClient; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; @@ -12,17 +11,10 @@ @RequestMapping("/api/v1/health") public class HealthController { - private final JdbcClient jdbcClient; - - public HealthController(JdbcClient jdbcClient) { - this.jdbcClient = jdbcClient; - } - @Operation(operationId = "getHealth") - @ApiResponse(responseCode = "200", description = "The API and database are reachable") + @ApiResponse(responseCode = "200", description = "The API is reachable") @GetMapping public HealthDTO getHealth() { - jdbcClient.sql("SELECT 1").query(Integer.class).single(); return new HealthDTO("ok"); } } diff --git a/frontend/oxlint.config.ts b/frontend/oxlint.config.ts index c2dce0f..d924fc5 100644 --- a/frontend/oxlint.config.ts +++ b/frontend/oxlint.config.ts @@ -12,7 +12,9 @@ export default defineConfig({ "typescript/no-explicit-any": "error", "no-console": "error", eqeqeq: "error", - "func-style": ["error", "expression"], + // A warning, not an error: TypeScript overloads and hoisted helpers need + // function declarations. + "func-style": ["warn", "expression"], "prefer-arrow-callback": "error", "typescript/consistent-type-definitions": ["error", "type"], "react/react-in-jsx-scope": "off", diff --git a/mise.toml b/mise.toml index 590b13a..de58623 100644 --- a/mise.toml +++ b/mise.toml @@ -31,15 +31,15 @@ run = "docker compose logs -f" description = "Restart the backend to pick up Java changes" run = "docker compose restart backend" -[tasks."stack:dev:up"] +[tasks."docker:dev:up"] description = "Build and start the deploy images (built jar + nginx, web on :8080)" run = "docker compose -f compose.yaml up --build --wait" -[tasks."stack:dev:down"] +[tasks."docker:dev:down"] description = "Stop the deploy containers" run = "docker compose -f compose.yaml down" -[tasks."stack:dev:logs"] +[tasks."docker:dev:logs"] description = "Follow the logs of the deploy containers" run = "docker compose -f compose.yaml logs -f" @@ -48,8 +48,8 @@ description = "Start the development database" run = "docker compose up -d db --wait" [tasks."db:dev:stop"] -description = "Stop the development database" -run = "docker compose stop db" +description = "Stop and remove the development database container. Its data is kept." +run = "docker compose down db" [tasks."db:dev:studio"] description = "Open Prisma Studio on the development database (http://localhost:5555)" From d5c6465f6aaa1c10f4dcce235b8a669ea7c1d4cd Mon Sep 17 00:00:00 2001 From: Anish Sahoo Date: Mon, 19 Oct 2026 20:29:00 -0400 Subject: [PATCH 06/11] fix: keep log colors behind the mise task prefix - force colors for tasks and the dev web container - rename db:dev:start and db:dev:stop to db:dev:up and db:dev:down --- compose.override.yaml | 2 ++ mise.toml | 15 +++++++++------ 2 files changed, 11 insertions(+), 6 deletions(-) diff --git a/compose.override.yaml b/compose.override.yaml index a56ca76..87ed175 100644 --- a/compose.override.yaml +++ b/compose.override.yaml @@ -30,6 +30,8 @@ services: target: local environment: BACKEND_URL: http://backend:3000 + # Vite only colors its output on a terminal, and the container has none. + FORCE_COLOR: "1" ports: !override - "127.0.0.1:5173:5173" # In dev the frontend does not need to wait for the backend to be healthy. diff --git a/mise.toml b/mise.toml index de58623..bbc6b60 100644 --- a/mise.toml +++ b/mise.toml @@ -10,6 +10,9 @@ pnpm = "12.14.0" [env] _.file = ".env" +# mise pipes task output to add the [task] prefix. Without this, tools see a pipe +# instead of a terminal and drop their colors. +FORCE_COLOR = "1" [tasks."setup:dev"] description = "Install frontend dependencies, generate the contract, and start every container" @@ -43,22 +46,22 @@ run = "docker compose -f compose.yaml down" description = "Follow the logs of the deploy containers" run = "docker compose -f compose.yaml logs -f" -[tasks."db:dev:start"] +[tasks."db:dev:up"] description = "Start the development database" run = "docker compose up -d db --wait" -[tasks."db:dev:stop"] +[tasks."db:dev:down"] description = "Stop and remove the development database container. Its data is kept." run = "docker compose down db" [tasks."db:dev:studio"] description = "Open Prisma Studio on the development database (http://localhost:5555)" -depends = ["db:dev:start"] +depends = ["db:dev:up"] run = 'prisma studio --port 5555 --url "postgresql://$SERVICE_USER_POSTGRES:$SERVICE_PASSWORD_POSTGRES@localhost:$POSTGRES_PORT/$POSTGRES_DB"' [tasks."db:dev:psql"] description = "Open psql in the development database" -depends = ["db:dev:start"] +depends = ["db:dev:up"] run = "docker compose exec db sh -c 'psql -U \"$POSTGRES_USER\" -d \"$POSTGRES_DB\"'" [tasks."db:dev:migrate:generate"] @@ -90,12 +93,12 @@ echo "Created $dir/$file. Review it, then run: mise run db:dev:migrate:up" [tasks."db:dev:migrate:up"] description = "Apply pending migrations to the development database" -depends = ["db:dev:start"] +depends = ["db:dev:up"] run = "docker compose run --rm --no-deps -T backend ./gradlew flywayMigrate --no-daemon --quiet" [tasks."db:dev:migrate:status"] description = "Show whether the development database is missing any migrations" -depends = ["db:dev:start"] +depends = ["db:dev:up"] run = "docker compose run --rm --no-deps -T backend ./gradlew flywayInfo --no-daemon --quiet" [tasks."db:dev:reset"] From 19f865e0dc72d4e5031dadd1dd3a22667bf414d7 Mon Sep 17 00:00:00 2001 From: Anish Sahoo Date: Mon, 19 Oct 2026 21:02:50 -0400 Subject: [PATCH 07/11] refactor: generate constructors with Lombok - use @RequiredArgsConstructor instead of hand-written constructors - document the pattern in the backend rules --- .agents/rules/backend.md | 3 ++- .../java/com/example/app/controller/MessageController.java | 6 ++---- backend/src/main/java/com/example/app/dao/MessageDAO.java | 7 ++----- .../main/java/com/example/app/service/MessageService.java | 6 ++---- 4 files changed, 8 insertions(+), 14 deletions(-) diff --git a/.agents/rules/backend.md b/.agents/rules/backend.md index 0e9f4dc..acfb877 100644 --- a/.agents/rules/backend.md +++ b/.agents/rules/backend.md @@ -8,7 +8,8 @@ paths: - Keep the layers: `controller` handles HTTP, `service` holds business logic, `dao` is the only caller of a `repository` and turns entities into DTOs. Entities never leave the `dao` layer. -- Inject dependencies through the constructor into `private final` fields. +- Inject dependencies as `private final` fields and put `@RequiredArgsConstructor` on + the class. Spring uses that constructor; no `@Autowired`, no hand-written constructor. - Every controller lives under `/api/v1`. Give each method `@Operation(operationId = "...")`, which becomes the function name in the frontend client, and `@ApiResponse` with a description. diff --git a/backend/src/main/java/com/example/app/controller/MessageController.java b/backend/src/main/java/com/example/app/controller/MessageController.java index 4025d2a..c93b45e 100644 --- a/backend/src/main/java/com/example/app/controller/MessageController.java +++ b/backend/src/main/java/com/example/app/controller/MessageController.java @@ -5,20 +5,18 @@ import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.responses.ApiResponse; import java.util.List; +import lombok.RequiredArgsConstructor; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; @RestController @RequestMapping("/api/v1/messages") +@RequiredArgsConstructor public class MessageController { private final MessageService messageService; - public MessageController(MessageService messageService) { - this.messageService = messageService; - } - // operationId becomes the function name in the generated frontend client. @Operation(operationId = "listMessages") @ApiResponse(responseCode = "200", description = "The 50 most recent messages") diff --git a/backend/src/main/java/com/example/app/dao/MessageDAO.java b/backend/src/main/java/com/example/app/dao/MessageDAO.java index 1042f46..e0517f8 100644 --- a/backend/src/main/java/com/example/app/dao/MessageDAO.java +++ b/backend/src/main/java/com/example/app/dao/MessageDAO.java @@ -4,18 +4,15 @@ import com.example.app.entity.Message; import com.example.app.repository.MessageRepository; import java.util.List; +import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Component; -/** The only class that talks to {@link MessageRepository}. Hands DTOs, never entities, upward. */ @Component +@RequiredArgsConstructor public class MessageDAO { private final MessageRepository repository; - public MessageDAO(MessageRepository repository) { - this.repository = repository; - } - public List findLatest() { return repository.findLatest().stream().map(MessageDAO::toDTO).toList(); } diff --git a/backend/src/main/java/com/example/app/service/MessageService.java b/backend/src/main/java/com/example/app/service/MessageService.java index 60dbcc4..db9c707 100644 --- a/backend/src/main/java/com/example/app/service/MessageService.java +++ b/backend/src/main/java/com/example/app/service/MessageService.java @@ -3,17 +3,15 @@ import com.example.app.dao.MessageDAO; import com.example.app.dto.MessageDTO; import java.util.List; +import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Service; @Service +@RequiredArgsConstructor public class MessageService { private final MessageDAO messageDAO; - public MessageService(MessageDAO messageDAO) { - this.messageDAO = messageDAO; - } - public List listMessages() { return messageDAO.findLatest(); } From ae615026d7b4a7af94c79ffe94c3bed8dd7a3446 Mon Sep 17 00:00:00 2001 From: Anish Sahoo Date: Mon, 19 Oct 2026 21:08:23 -0400 Subject: [PATCH 08/11] chore: rename setup:dev to setup --- README.md | 2 +- mise.toml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 2cfb4a9..031e81d 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ Docker. ```sh mise install cp .env.example .env -mise run setup:dev +mise run setup ``` ## Run diff --git a/mise.toml b/mise.toml index bbc6b60..506b83e 100644 --- a/mise.toml +++ b/mise.toml @@ -14,7 +14,7 @@ _.file = ".env" # instead of a terminal and drop their colors. FORCE_COLOR = "1" -[tasks."setup:dev"] +[tasks.setup] description = "Install frontend dependencies, generate the contract, and start every container" run = ["pnpm install --dir frontend", { task = "contract" }, { task = "dev:up" }] From f63501bd0faaa67ec64887cf07c80303e24eb5de Mon Sep 17 00:00:00 2001 From: Anish Sahoo Date: Mon, 19 Oct 2026 21:13:10 -0400 Subject: [PATCH 09/11] feat: log one line per request in the backend - add RequestLogger, a servlet filter matching the other starters' format - skip successful health checks, warn on 4xx, error on 5xx --- .agents/rules/backend.md | 2 + AGENTS.md | 1 + .../example/app/middleware/RequestLogger.java | 47 +++++++++++++++++++ 3 files changed, 50 insertions(+) create mode 100644 backend/src/main/java/com/example/app/middleware/RequestLogger.java diff --git a/.agents/rules/backend.md b/.agents/rules/backend.md index acfb877..40ba63e 100644 --- a/.agents/rules/backend.md +++ b/.agents/rules/backend.md @@ -8,6 +8,8 @@ paths: - Keep the layers: `controller` handles HTTP, `service` holds business logic, `dao` is the only caller of a `repository` and turns entities into DTOs. Entities never leave the `dao` layer. +- Code that runs around every request goes in `middleware/` as a `OncePerRequestFilter` + `@Component`, like `RequestLogger`. Log with Lombok's `@Slf4j`, never `System.out`. - Inject dependencies as `private final` fields and put `@RequiredArgsConstructor` on the class. Spring uses that constructor; no `@Autowired`, no hand-written constructor. - Every controller lives under `/api/v1`. Give each method diff --git a/AGENTS.md b/AGENTS.md index 8d7ad50..98c01dd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -21,6 +21,7 @@ Rules for anyone changing code here, human or agent. Before editing `backend/` o browser -> web (vite / nginx) -> /api -> backend (Spring) -> db (Postgres) backend/ controller -> service -> dao -> repository -> entity + middleware/ runs around every request (request logging) frontend/ React app, API client generated from backend/openapi.json ``` diff --git a/backend/src/main/java/com/example/app/middleware/RequestLogger.java b/backend/src/main/java/com/example/app/middleware/RequestLogger.java new file mode 100644 index 0000000..fb48b92 --- /dev/null +++ b/backend/src/main/java/com/example/app/middleware/RequestLogger.java @@ -0,0 +1,47 @@ +package com.example.app.middleware; + +import jakarta.servlet.FilterChain; +import jakarta.servlet.ServletException; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.servlet.http.HttpServletResponse; +import java.io.IOException; +import lombok.extern.slf4j.Slf4j; +import org.slf4j.event.Level; +import org.springframework.stereotype.Component; +import org.springframework.web.filter.OncePerRequestFilter; + +/** Logs one line per request once its response is ready, e.g. "GET /api/v1/messages 200 36ms". */ +@Slf4j +@Component +public class RequestLogger extends OncePerRequestFilter { + + @Override + protected void doFilterInternal( + HttpServletRequest request, HttpServletResponse response, FilterChain chain) + throws ServletException, IOException { + long start = System.nanoTime(); + chain.doFilter(request, response); + + int status = response.getStatus(); + String path = request.getRequestURI(); + + // no logs for healthchecks to reduce unnecessary noise + if (path.equals("/api/v1/health") && status < 400) { + return; + } + + long durationMs = (System.nanoTime() - start) / 1_000_000; + log.atLevel(levelFor(status)) + .log("{} {} {} {}ms", request.getMethod(), path, status, durationMs); + } + + private static Level levelFor(int status) { + if (status >= 500) { + return Level.ERROR; + } + if (status >= 400) { + return Level.WARN; + } + return Level.INFO; + } +} From a403880357e47a25451ac42795d1b8404e6917fd Mon Sep 17 00:00:00 2001 From: Anish Sahoo Date: Mon, 19 Oct 2026 21:32:09 -0400 Subject: [PATCH 10/11] fix: run dev migrations only on request - apply and check migrations with the Flyway CLI from mise, using DATABASE_URL from .env - stop the dev backend from migrating on start; deploys still do - setup installs deps, migrates and generates the contract, like the other starters - drop the Flyway Gradle plugin - shorten console logs to date, level, logger and message - stop serving the OpenAPI spec at runtime - remove PORT and LOG_LEVEL defaults from application.yaml --- .env.example | 3 +++ AGENTS.md | 4 ++++ README.md | 2 +- backend/build.gradle.kts | 15 --------------- .../src/main/resources/application-openapi.yaml | 4 ++++ backend/src/main/resources/application.yaml | 9 +++++---- compose.override.yaml | 2 ++ mise.toml | 13 +++++++++---- 8 files changed, 28 insertions(+), 24 deletions(-) diff --git a/.env.example b/.env.example index 845e6bb..2fb0b09 100644 --- a/.env.example +++ b/.env.example @@ -3,4 +3,7 @@ SERVICE_USER_POSTGRES=app SERVICE_PASSWORD_POSTGRES=app POSTGRES_DB=app POSTGRES_PORT=5432 +# Used by commands that run on your machine, like db:dev:migrate:up. The backend +# container gets its own URL from compose.yaml. +DATABASE_URL=jdbc:postgresql://localhost:5432/app?user=app&password=app LOG_LEVEL=info diff --git a/AGENTS.md b/AGENTS.md index 98c01dd..e98a0b6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -51,6 +51,10 @@ truth for every table. Change the database only this way: yourself. Then run `mise run db:dev:migrate:up`. 4. `mise run db:dev:migrate:status` shows whether the database is missing migrations. +In dev the backend never migrates on its own, so a pending migration only applies +when you run `db:dev:migrate:up`. The deployed backend applies pending migrations +every time it starts. + Migrations only go forward. Never edit a migration that is already on `main`. Add a new one instead. diff --git a/README.md b/README.md index 031e81d..07c4ee2 100644 --- a/README.md +++ b/README.md @@ -42,6 +42,6 @@ mise run db:dev:migrate:up # apply pending migrations mise run db:dev:migrate:status # is the database behind? ``` -Read the generated SQL before committing it. Hibernate never writes `DROP` statements, so add those yourself. There is no down migration: fix mistakes with a new one. +Migrations only apply when you run `db:dev:migrate:up`. Read the generated SQL before committing it. Hibernate never writes `DROP` statements, so add those yourself. There is no down migration: fix mistakes with a new one. `mise run db:dev:studio` opens Prisma Studio on . diff --git a/backend/build.gradle.kts b/backend/build.gradle.kts index 81852e8..65a24f1 100644 --- a/backend/build.gradle.kts +++ b/backend/build.gradle.kts @@ -1,20 +1,11 @@ import net.ltgt.gradle.errorprone.errorprone -buildscript { - dependencies { - // The Flyway plugin runs outside the app, so it needs its own Postgres support. - classpath("org.flywaydb:flyway-database-postgresql:12.4.0") - classpath("org.postgresql:postgresql:42.7.13") - } -} - plugins { java id("org.springframework.boot") version "4.1.1" id("io.spring.dependency-management") version "1.1.7" id("com.diffplug.spotless") version "8.10.4" id("net.ltgt.errorprone") version "5.1.1" - id("org.flywaydb.flyway") version "12.4.0" id("org.springdoc.openapi-gradle-plugin") version "1.9.0" } @@ -65,12 +56,6 @@ spotless { } } -// `mise run db:dev:migrate:up` and `db:dev:migrate:status` use these. -flyway { - url = System.getenv("DATABASE_URL") - locations = arrayOf("filesystem:src/main/resources/db/migration") -} - // `mise run contract` boots the app with the openapi profile, which needs no // database, and saves the spec to backend/openapi.json. openApi { diff --git a/backend/src/main/resources/application-openapi.yaml b/backend/src/main/resources/application-openapi.yaml index d124b66..1c3bcbd 100644 --- a/backend/src/main/resources/application-openapi.yaml +++ b/backend/src/main/resources/application-openapi.yaml @@ -3,6 +3,10 @@ server: port: 3999 +springdoc: + api-docs: + enabled: true + spring: datasource: url: jdbc:postgresql://localhost/placeholder diff --git a/backend/src/main/resources/application.yaml b/backend/src/main/resources/application.yaml index dfa41b2..c446c24 100644 --- a/backend/src/main/resources/application.yaml +++ b/backend/src/main/resources/application.yaml @@ -1,7 +1,5 @@ -# Values in ${...} come from .env, which mise loads for local tasks and Docker -# Compose passes to the containers. server: - port: ${PORT:3000} + port: ${PORT} # nginx sits in front of the backend and sets X-Forwarded-* headers. forward-headers-strategy: framework shutdown: graceful @@ -19,9 +17,12 @@ spring: springdoc: api-docs: + enabled: false path: /api/v1/openapi.json default-produces-media-type: application/json logging: level: - root: ${LOG_LEVEL:info} + root: ${LOG_LEVEL} + pattern: + console: "%clr(%d{yyyy-MM-dd HH:mm:ss}){faint} %clr(%5p) %clr(%logger{30}){cyan} %clr(:){faint} %m%n%wEx" diff --git a/compose.override.yaml b/compose.override.yaml index 87ed175..1c385f6 100644 --- a/compose.override.yaml +++ b/compose.override.yaml @@ -17,6 +17,8 @@ services: environment: # Spring only colors logs on a terminal, and the container has none. SPRING_OUTPUT_ANSI_ENABLED: always + # In dev, migrations only apply when you run `mise run db:dev:migrate:up`. + SPRING_FLYWAY_ENABLED: "false" volumes: - ./backend/src:/app/src ports: diff --git a/mise.toml b/mise.toml index 506b83e..d93f0e0 100644 --- a/mise.toml +++ b/mise.toml @@ -6,6 +6,8 @@ java = "temurin-25" node = "24.22.0" pnpm = "12.14.0" +# Same Flyway version Spring Boot uses, for db:dev:migrate:up and status. +flyway = "12.4.0" "npm:prisma" = "7.9.1" [env] @@ -13,10 +15,13 @@ _.file = ".env" # mise pipes task output to add the [task] prefix. Without this, tools see a pipe # instead of a terminal and drop their colors. FORCE_COLOR = "1" +# The Flyway CLI reads these, so db:dev:migrate:up and status use DATABASE_URL from .env. +FLYWAY_URL = "{{env.DATABASE_URL}}" +FLYWAY_LOCATIONS = "filesystem:{{config_root}}/backend/src/main/resources/db/migration" [tasks.setup] -description = "Install frontend dependencies, generate the contract, and start every container" -run = ["pnpm install --dir frontend", { task = "contract" }, { task = "dev:up" }] +description = "Install dependencies, start and migrate the database, and generate the contract" +run = ["pnpm install --dir frontend", { task = "db:dev:migrate:up" }, { task = "contract" }] [tasks."dev:up"] description = "Build and start db, backend and web in Docker (web on :5173)" @@ -94,12 +99,12 @@ echo "Created $dir/$file. Review it, then run: mise run db:dev:migrate:up" [tasks."db:dev:migrate:up"] description = "Apply pending migrations to the development database" depends = ["db:dev:up"] -run = "docker compose run --rm --no-deps -T backend ./gradlew flywayMigrate --no-daemon --quiet" +run = "flyway migrate -skipCheckForUpdate" [tasks."db:dev:migrate:status"] description = "Show whether the development database is missing any migrations" depends = ["db:dev:up"] -run = "docker compose run --rm --no-deps -T backend ./gradlew flywayInfo --no-daemon --quiet" +run = "flyway info -skipCheckForUpdate" [tasks."db:dev:reset"] description = "Delete the development database volume (migrations rerun on next start)" From cc71d98957fba694d7f515e5291ec7bbbe7f1ddf Mon Sep 17 00:00:00 2001 From: Anish Sahoo Date: Mon, 19 Oct 2026 21:34:45 -0400 Subject: [PATCH 11/11] fix: let mise load without a .env file - pass DATABASE_URL to Flyway in the migrate tasks instead of templating it in [env] --- mise.toml | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/mise.toml b/mise.toml index d93f0e0..50149a2 100644 --- a/mise.toml +++ b/mise.toml @@ -15,8 +15,7 @@ _.file = ".env" # mise pipes task output to add the [task] prefix. Without this, tools see a pipe # instead of a terminal and drop their colors. FORCE_COLOR = "1" -# The Flyway CLI reads these, so db:dev:migrate:up and status use DATABASE_URL from .env. -FLYWAY_URL = "{{env.DATABASE_URL}}" +# The Flyway CLI reads this. db:dev:migrate:up and status pass DATABASE_URL from .env. FLYWAY_LOCATIONS = "filesystem:{{config_root}}/backend/src/main/resources/db/migration" [tasks.setup] @@ -99,12 +98,12 @@ echo "Created $dir/$file. Review it, then run: mise run db:dev:migrate:up" [tasks."db:dev:migrate:up"] description = "Apply pending migrations to the development database" depends = ["db:dev:up"] -run = "flyway migrate -skipCheckForUpdate" +run = 'flyway migrate -url="$DATABASE_URL" -skipCheckForUpdate' [tasks."db:dev:migrate:status"] description = "Show whether the development database is missing any migrations" depends = ["db:dev:up"] -run = "flyway info -skipCheckForUpdate" +run = 'flyway info -url="$DATABASE_URL" -skipCheckForUpdate' [tasks."db:dev:reset"] description = "Delete the development database volume (migrations rerun on next start)"