chore: merge dev into main

.gitignore

@@ -11,6 +11,9 @@ dist
 dist-ssr
 *.local
 
+# The Prisma client (`npm run db:generate`) and the GraphQL types (`npm run codegen`)
+backend/src/generated
+
 # Environment variables
 .env
 .env.*
@@ -26,3 +29,9 @@ dist-ssr
 *.njsproj
 *.sln
 *.sw?
+
+# Code of Points extraction: the PDF must never be committed
+scripts/extract-cop/en_1.1.-WAG-Code-of-Points-2025-2028.pdf
+scripts/extract-cop/review.html
+scripts/extract-cop/.venv
+__pycache__

backend/.env.example

@@ -0,0 +1,22 @@
+# Copy this file to .env and fill in your own values. .env is not committed.
+#
+# Runtime server connection (wag_app - restricted CRUD permissions)
+DATABASE_URL="postgresql://wag_app:YOUR_APP_PASSWORD@localhost:5432/wag_catalog"
+
+# Migration connection string (wag_migrator - schema owner for migrations & setup)
+MIGRATION_DATABASE_URL="postgresql://wag_migrator:YOUR_MIGRATOR_PASSWORD@localhost:5432/wag_catalog"
+
+# The GraphQL server (npm run dev -w backend). All three are optional.
+# The port of the server. The backend should be on 3001 on the virtual machine.
+# PORT=3001
+# The address the drawings are served from, without a final slash. In development
+# the server serves them itself. On the virtual machine it is the Apache address,
+# for example http://it2810-XX.idi.ntnu.no/project2/images
+# IMAGE_BASE_URL=http://localhost:3001/images
+# The addresses that may call the API from a browser, separated by commas.
+# CORS_ORIGIN=http://localhost:5173
+
+# Signs the access tokens (optional). At least 32 random characters. Without it there
+# are no tokens and `me` is always null.
+# Make one with: node -e "console.log(require('node:crypto').randomBytes(48).toString('base64url'))"
+# SESSION_SECRET=

backend/codegen.ts

@@ -0,0 +1,39 @@
+// GraphQL Code Generator: makes TypeScript types from src/schema.graphql, so a
+// resolver that does not match the schema fails `tsc`. Run it with
+// `npm run codegen`. The result (src/generated/graphql.ts) is not committed,
+// like the Prisma client in the same folder.
+import type { CodegenConfig } from '@graphql-codegen/cli'
+
+const config: CodegenConfig = {
+  schema: 'src/schema.graphql',
+  generates: {
+    'src/generated/graphql.ts': {
+      plugins: ['typescript', 'typescript-resolvers'],
+      config: {
+        // What every resolver gets as its third argument.
+        contextType: '../server/context.js#Context',
+        useTypeImports: true,
+        enumsAsTypes: true,
+        // GraphQL types that resolvers receive as database rows. The fields of
+        // the row do not have to match the schema: a field resolver converts
+        // them (for example Decimal to number).
+        mappers: {
+          Apparatus: '../generated/prisma/client.js#Apparatus as ApparatusRow',
+          ElementGroup:
+            '../generated/prisma/client.js#ElementGroup as ElementGroupRow',
+          Coach: '../generated/prisma/client.js#Coach as CoachRow',
+          Gymnast: '../generated/prisma/client.js#Gymnast as GymnastRow',
+          Routine: '../generated/prisma/client.js#Routine as RoutineRow',
+          // An element or vault row with a __typename, see server/items.ts.
+          CatalogItem: '../server/items.js#Item',
+          CatalogConnection: '../server/items.js#ConnectionRow',
+          Element: '../server/items.js#ElementItem',
+          Vault: '../server/items.js#VaultItem',
+        },
+        scalars: { DateTime: 'Date' },
+      },
+    },
+  },
+}
+
+export default config

backend/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "backend",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "start": "tsx src/index.ts",
+    "prebuild": "npm run generate",
+    "build": "tsc",
+    "setup": "DATABASE_URL=${MIGRATION_DATABASE_URL:-$DATABASE_URL} prisma migrate deploy && DATABASE_URL=${MIGRATION_DATABASE_URL:-$DATABASE_URL} npm run prisma:seed",
+    "pretypecheck": "npm run generate",
+    "typecheck": "tsc --noEmit",
+    "generate": "npm run prisma:generate && npm run codegen",
+    "prisma:generate": "prisma generate",
+    "codegen": "graphql-codegen --config codegen.ts",
+    "prisma:migrate": "prisma migrate dev",
+    "prisma:deploy": "prisma migrate deploy",
+    "prisma:seed": "prisma db seed",
+    "synthetic": "tsx src/seed/synthetic.ts",
+    "prisma:studio": "prisma studio"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "devDependencies": {
+    "@graphql-codegen/cli": "^7.4.6",
+    "@graphql-codegen/typescript": "^6.1.2",
+    "@graphql-codegen/typescript-resolvers": "^6.1.1",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^24.19.2",
+    "prisma": "^7.10.1",
+    "typescript": "~6.0.2"
+  },
+  "dependencies": {
+    "@apollo/server": "^5.5.1",
+    "@as-integrations/express5": "^1.1.2",
+    "@prisma/adapter-pg": "^7.10.1",
+    "@prisma/client": "^7.10.1",
+    "cors": "^2.8.6",
+    "dataloader": "^2.2.3",
+    "dotenv": "^18.0.8",
+    "express": "^5.3.0",
+    "graphql": "^16.14.2",
+    "jose": "^6.2.12",
+    "tsx": "^4.23.15"
+  }
+}

backend/prisma.config.ts

@@ -0,0 +1,16 @@
+// Prisma configuration. Prisma 7 reads the database URL from here, not from
+// schema.prisma. DATABASE_URL is loaded from backend/.env.
+import 'dotenv/config'
+import { defineConfig } from 'prisma/config'
+
+export default defineConfig({
+  schema: 'prisma/schema.prisma',
+  migrations: {
+    path: 'prisma/migrations',
+    // `prisma db seed` (npm run db:seed) runs the seed script.
+    seed: 'tsx src/seed/seed.ts',
+  },
+  datasource: {
+    url: process.env['DATABASE_URL'],
+  },
+})