Update dependencies and modernize

.github/workflows/deploy-backend.yml

@@ -26,7 +26,7 @@ jobs:
           - sync-jira
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           submodules: true
       - name: Log in to the Container registry
@@ -44,7 +44,7 @@ jobs:
             type=semver,pattern={{version}}
             type=edge,branch=main
       - name: Build and push Docker image
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v6
         with:
           context: ./gropius-backend
           build-args: |

.github/workflows/deploy-website.yml

@@ -6,68 +6,62 @@ on:
       - main
   pull_request:
 
-env:
-  NODE_OPTIONS: '--max_old_space_size=6144'
-
 jobs:
   deploy:
     name: Deploy to GitHub Pages
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v5
         with:
           submodules: true
-      - uses: actions/setup-java@v3
+
+      # Rendering the ~5,500 generated pages peaks at roughly 11 GB resident. That fits a standard
+      # runner's 16 GB, but not with much to spare, and the default 4 GB swapfile is thin cover.
+      - name: Enlarge the swapfile
+        run: |
+          sudo swapoff -a
+          sudo fallocate -l 16G /mnt/swapfile
+          sudo chmod 600 /mnt/swapfile
+          sudo mkswap /mnt/swapfile
+          sudo swapon /mnt/swapfile
+          free -h
+
+      - uses: actions/setup-java@v4
         with:
           distribution: temurin
           java-version: 21
       - name: Setup Gradle
-        uses: gradle/gradle-build-action@v2
-      - name: Execute Gradle build
-        run: ./gradlew build dokkaHtmlMultiModule
-        working-directory: gropius-backend
-      - name: Save graphql schemas
-        run: ./website/scripts/generate-graphql-schema.sh
-      - uses: actions/setup-node@v3
+        uses: gradle/actions/setup-gradle@v4
+
+      - uses: actions/setup-node@v4
         with:
-          node-version: 21.x
+          node-version: 22.x
           cache: npm
           cache-dependency-path: "**/package-lock.json"
+
+      - name: Install website dependencies
+        run: npm ci
+        working-directory: website
       - name: Install login-service dependencies
         run: npm ci
         working-directory: gropius-login-service/backend
-      - name: Save openapi schemas
-        run: ./website/scripts/generate-openapi-schema.sh
-      - name: Modify Dokka output
-        uses: graphglue/dokka-html-mdx-transform@v1.7.20
-        with:
-          src: "gropius-backend/build/dokka/htmlMultiModule"
-          modules: |
-            core
-            api-common
-            api-public
-            api-internal
-            sync
-            sync-github
-            sync-jira
-          dest: "website/docs"
-          folder: "api"
-      - name: Install dependencies
-        run: npm ci
+
+      # Runs Dokka, boots both API modules and the login service to dump their schemas, and runs
+      # TypeDoc - the same four stages `npm run generate` runs locally.
+      - name: Generate the API references
+        run: npm run generate
         working-directory: website
-      - name: Update graphql documentation
-        run: ./website/scripts/update-graphql-doc.sh
-      - name: Update rest documentation
-        run: ./website/scripts/update-rest-doc.sh
+
       - name: Build website
-        run: npm run build
+        run: npm run site
         working-directory: website
+
       - name: Deploy to GitHub Pages
         uses: peaceiris/actions-gh-pages@v4
         if: github.ref == 'refs/heads/main'
         with:
           deploy_key: ${{ secrets.ACTIONS_DEPLOY_KEY }}
-          publish_dir: ./website/build
+          publish_dir: ./website/.vitepress/dist
           force_orphan: true
           external_repository: ccims/gropius-docs
-          publish_branch: main
+          publish_branch: main

docker-compose-testing.yaml

@@ -124,7 +124,6 @@ services:
       login-service:
         condition: service_started
     environment:
-      - LOGIN_OAUTH_CLIENT_ID=8ee1287d-71ff-4c85-becd-cba829f390a0
       - API_PUBLIC_ENDPOINT=http://api-public:8080/graphql
       - LOGIN_SERVICE_ENDPOINT=http://login-service:3000
   mongo:
@@ -149,11 +148,11 @@ services:
       - login-service
     environment:
       - SPRING_NEO4J_URI=bolt://neo4j:7687
-      - SPRING_DATA_MONGODB_HOST=mongo
-      - SPRING_DATA_MONGODB_PORT=27017
-      - SPRING_DATA_MONGODB_DATABASE=gropius
-      - SPRING_DATA_MONGODB_USERNAME=root
-      - SPRING_DATA_MONGODB_PASSWORD=root
+      - SPRING_MONGODB_HOST=mongo
+      - SPRING_MONGODB_PORT=27017
+      - SPRING_MONGODB_DATABASE=gropius
+      - SPRING_MONGODB_USERNAME=root
+      - SPRING_MONGODB_PASSWORD=root
       - GROPIUS_SYNC_LOGIN_SERVICE_BASE=http://login-service:3000/
       - GROPIUS_SYNC_API_SECRET=TODO_loginSecret
     healthcheck:
@@ -173,11 +172,11 @@ services:
       - login-service
     environment:
       - SPRING_NEO4J_URI=bolt://neo4j:7687
-      - SPRING_DATA_MONGODB_HOST=mongo
-      - SPRING_DATA_MONGODB_PORT=27017
-      - SPRING_DATA_MONGODB_DATABASE=gropius
-      - SPRING_DATA_MONGODB_USERNAME=root
-      - SPRING_DATA_MONGODB_PASSWORD=root
+      - SPRING_MONGODB_HOST=mongo
+      - SPRING_MONGODB_PORT=27017
+      - SPRING_MONGODB_DATABASE=gropius
+      - SPRING_MONGODB_USERNAME=root
+      - SPRING_MONGODB_PASSWORD=root
       - GROPIUS_SYNC_LOGIN_SERVICE_BASE=http://login-service:3000/
       - GROPIUS_SYNC_API_SECRET=TODO_loginSecret
     healthcheck:

docker-compose.yaml

@@ -139,11 +139,11 @@ services:
       - SPRING_NEO4J_URI=bolt://neo4j:7687
       - SPRING_NEO4J_AUTHENTICATION_USERNAME=neo4j
       - SPRING_NEO4J_AUTHENTICATION_PASSWORD=$GROPIUS_NEO4J_PASSWORD
-      - SPRING_DATA_MONGODB_HOST=mongo
-      - SPRING_DATA_MONGODB_PORT=27017
-      - SPRING_DATA_MONGODB_DATABASE=gropius
-      - SPRING_DATA_MONGODB_USERNAME=root
-      - SPRING_DATA_MONGODB_PASSWORD=$GROPIUS_MONGO_PASSWORD
+      - SPRING_MONGODB_HOST=mongo
+      - SPRING_MONGODB_PORT=27017
+      - SPRING_MONGODB_DATABASE=gropius
+      - SPRING_MONGODB_USERNAME=root
+      - SPRING_MONGODB_PASSWORD=$GROPIUS_MONGO_PASSWORD
       - GROPIUS_SYNC_LOGIN_SERVICE_BASE=http://login-service:3000/
       - GROPIUS_SYNC_API_SECRET=$GROPIUS_SYNC_API_SECRET
     healthcheck:
@@ -165,11 +165,11 @@ services:
       - SPRING_NEO4J_URI=bolt://neo4j:7687
       - SPRING_NEO4J_AUTHENTICATION_USERNAME=neo4j
       - SPRING_NEO4J_AUTHENTICATION_PASSWORD=$GROPIUS_NEO4J_PASSWORD
-      - SPRING_DATA_MONGODB_HOST=mongo
-      - SPRING_DATA_MONGODB_PORT=27017
-      - SPRING_DATA_MONGODB_DATABASE=gropius
-      - SPRING_DATA_MONGODB_USERNAME=root
-      - SPRING_DATA_MONGODB_PASSWORD=$GROPIUS_MONGO_PASSWORD
+      - SPRING_MONGODB_HOST=mongo
+      - SPRING_MONGODB_PORT=27017
+      - SPRING_MONGODB_DATABASE=gropius
+      - SPRING_MONGODB_USERNAME=root
+      - SPRING_MONGODB_PASSWORD=$GROPIUS_MONGO_PASSWORD
       - GROPIUS_SYNC_LOGIN_SERVICE_BASE=http://login-service:3000/
       - GROPIUS_SYNC_API_SECRET=$GROPIUS_SYNC_API_SECRET
     healthcheck:

website/.gitignore

@@ -1,12 +1,20 @@
 # Dependencies
 /node_modules
 
-# Production
-/build
+# VitePress
+/.vitepress/cache
+/.vitepress/dist
 
-# Generated files
-.docusaurus
-.cache-loader
+# Generated by `npm run generate`; see scripts/docs.mjs
+/.vitepress/dokka
+/.vitepress/generated
+/docs/api
+/docs/graphql/public
+/docs/graphql/internal
+/docs/login-service
+
+# Schemas dumped from the running services
+/schemas
 
 # Misc
 .DS_Store
@@ -18,17 +26,3 @@
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
-
-# generated api documentation
-docs/api/
-docs/login-service-api/
-
-# generated schema
-schemas/
-
-# generated graphql documentation
-docs/graphql/api-public/
-docs/graphql/api-internal/
-
-# generated rest documentation
-rest-docs/login-service/