Merge dev into main – Innlevering 2

.gitignore

@@ -11,6 +11,8 @@ npm-debug.log*
 
 # Lokale miljøvariabler
 .env
+.env.test
+backend/.env.test
 .env.*.local
 .env.local
 

.prettierignore

@@ -4,3 +4,7 @@ node_modules
 dist
 coverage
 package-lock.json
+
+# Skrevet av npm run import:tools. Formatet bestemmes av skriptet, slik at en
+# ny import ikke gir formateringsfeil.
+backend/src/seed/data

backend/.env.example

@@ -0,0 +1,9 @@
+# PostgreSQL-tilkobling. Kopier til .env og tilpass verdien.
+DATABASE_URL=postgresql://bruker:passord@localhost:5432/verktoyutlan
+
+# GraphQL-server (npm run dev / npm run start)
+HOST=127.0.0.1
+PORT=3001
+
+# Valgfritt: rotsti når frontend er deployet (standard /project2).
+# PUBLIC_APP_BASE=/project2

backend/.env.test.example

@@ -0,0 +1,10 @@
+# Kopier til .env.test (committes ikke). Kun testdatabase — ikke dev eller prod.
+# Databasenavnet må slutte på _test (sjekkes av vitest.config.ts).
+#
+# Én gang per maskin:
+#   createdb verktoyutlan_test
+#   set -a && source .env.test && set +a && export DATABASE_URL="$TEST_DATABASE_URL"
+#   npm run migrate && npm run seed
+#
+# Kjøre tester: cd backend && npm test
+TEST_DATABASE_URL=postgresql://bruker@localhost:5432/verktoyutlan_test

backend/.node-pg-migraterc.json

@@ -0,0 +1,4 @@
+{
+  "migrations-dir": "migrations",
+  "migration-file-language": "ts"
+}

backend/deploy/README.md

@@ -0,0 +1,161 @@
+# Deploy: systemd og port 3001 (prosjekt 2)
+
+Mal for å kjøre GraphQL-backenden som egen systemd-tjeneste på
+`it2810-36.idi.ntnu.no`. Steg-for-steg på VM: [docs/vm-backend.md §7](../../docs/vm-backend.md#7-graphql-med-systemd-port-3001).
+
+**Verifisert på VM (oktober 2026):** tjenesten kjører som `User=birkjr`,
+`Group=eall_s`, med Node
+`/home/birkjr/.nvm/versions/node/v24.21.0/bin/node`,
+`WorkingDirectory=/home/birkjr/T36-Project-2/backend`, miljø fra
+`/etc/t36-project2/backend.env`. GraphQL svarer på `127.0.0.1:3001/graphql`
+(`health`, `listings`, `createListing`); `systemctl restart` og `enabled` er
+testet. VM-reboot er ikke testet.
+
+## Avhengighet før enable
+
+Før `systemctl enable --now` må repoet ha minst:
+
+- `backend/src/server.ts` som **leser `HOST` og `PORT` fra miljø** og binder til
+  **`127.0.0.1:3001`** (verdier fra `/etc/t36-project2/backend.env` — ikke
+  hardkode `0.0.0.0`).
+- `npm ci` kjørt i `backend/`, slik at `node_modules/tsx/dist/cli.mjs` finnes.
+- `npm run start` (eller `dev`) verifisert mot VM-database etter deploy av kode.
+- Valgfritt senere: `npm run build` + `ExecStart` mot `dist/server.js` i stedet
+  for tsx.
+
+## Filer
+
+| Fil                            | Formål                                                               |
+| ------------------------------ | -------------------------------------------------------------------- |
+| `t36-project2-backend.service` | systemd-enhet (`__DEPLOY_USER__`, `__BACKEND_DIR__`, `__NODE_BIN__`) |
+| `backend.env.example`          | Mal for `/etc/t36-project2/backend.env`                              |
+
+Migrasjon/seed kan fortsatt bruke `~/T36-Project-2/backend/.env`. Tjenesten leser
+**kun** `/etc/t36-project2/backend.env` (utenfor git).
+
+## Plassholdere
+
+| Plassholder       | Betydning                                                                          |
+| ----------------- | ---------------------------------------------------------------------------------- |
+| `__DEPLOY_USER__` | NTNU-bruker på VM (ikke root)                                                      |
+| `__BACKEND_DIR__` | Absolutt sti, f.eks. `/home/<NTNU_BRUKERNAVN>/T36-Project-2/backend`               |
+| `__NODE_BIN__`    | Full sti til Node 24, f.eks. `/home/<bruker>/.nvm/versions/node/v24.21.0/bin/node` |
+
+Etter `sed` fra malen: på IT2810-VM kan **`Group=`** settes til primærgruppen
+(f.eks. `eall_s`) i stedet for brukernavn, hvis `systemd` krever det. Rediger
+`/etc/systemd/system/t36-project2-backend.service` og kjør `daemon-reload`.
+
+## Forberedelse på VM (etter GraphQL er merget)
+
+Erstatt `<NTNU_BRUKERNAVN>` med faktisk bruker (samme som eier repoet).
+
+```bash
+export DEPLOY_USER="<NTNU_BRUKERNAVN>"
+export BACKEND_DIR="/home/${DEPLOY_USER}/T36-Project-2/backend"
+
+cd "${BACKEND_DIR}/.."
+git pull
+cd "${BACKEND_DIR}"
+nvm use 24
+npm ci
+npm run typecheck
+test -f node_modules/tsx/dist/cli.mjs
+# npm run build  — hvis dere bytter ExecStart til dist/server.js
+```
+
+Noter Node-sti:
+
+```bash
+export NODE_BIN="$(which node)"
+echo "${NODE_BIN}"
+```
+
+## Miljøfil utenfor git
+
+Tjenesten kjører som **`DEPLOY_USER`** ( ikke root ). Filen skal være lesbar for
+prosessen, men ikke for «alle» på VM:
+
+```bash
+export DEPLOY_USER="<NTNU_BRUKERNAVN>"
+
+sudo mkdir -p /etc/t36-project2
+sudo cp "/home/${DEPLOY_USER}/T36-Project-2/backend/deploy/backend.env.example" \
+  /etc/t36-project2/backend.env
+sudo nano /etc/t36-project2/backend.env   # DATABASE_URL, HOST, PORT
+sudo chmod 640 /etc/t36-project2/backend.env
+sudo chown "root:${DEPLOY_USER}" /etc/t36-project2/backend.env
+```
+
+**Krav i filen:** `HOST=127.0.0.1`, `PORT=3001`. GraphQL-implementasjonen må respektere
+disse.
+
+## Installere tjenesten (manuelt, én gang)
+
+Kjør på VM etter `nvm use 24` og `npm ci` i backend:
+
+```bash
+export DEPLOY_USER="<NTNU_BRUKERNAVN>"
+export BACKEND_DIR="/home/${DEPLOY_USER}/T36-Project-2/backend"
+export NODE_BIN="$(which node)"
+
+sed -e "s|__DEPLOY_USER__|${DEPLOY_USER}|g" \
+    -e "s|__BACKEND_DIR__|${BACKEND_DIR}|g" \
+    -e "s|__NODE_BIN__|${NODE_BIN}|g" \
+    "${BACKEND_DIR}/deploy/t36-project2-backend.service" \
+  | sudo tee /etc/systemd/system/t36-project2-backend.service > /dev/null
+
+sudo systemctl daemon-reload
+```
+
+Test manuelt før `enable` (miljø fra `/etc/t36-project2/backend.env`):
+
+```bash
+set -a && source /etc/t36-project2/backend.env && set +a
+"${NODE_BIN}" "${BACKEND_DIR}/node_modules/tsx/dist/cli.mjs" "${BACKEND_DIR}/src/server.ts"
+```
+
+Deretter:
+
+```bash
+sudo systemctl enable t36-project2-backend
+sudo systemctl start t36-project2-backend
+```
+
+## Kontroll
+
+```bash
+sudo systemctl status t36-project2-backend --no-pager
+sudo systemctl is-enabled t36-project2-backend
+journalctl -u t36-project2-backend -n 50 --no-pager
+ss -tlnp | grep 3001 || true
+
+curl -sS -X POST http://127.0.0.1:3001/graphql \
+  -H 'Content-Type: application/json' \
+  -d '{"query":"{ health listings(limit: 1) { totalCount } }"}'
+```
+
+Stopp / restart:
+
+```bash
+sudo systemctl stop t36-project2-backend
+sudo systemctl restart t36-project2-backend
+```
+
+Ved OS-omstart: autostart når enheten er **enabled** (`Restart=on-failure` ved krasj).
+
+## Prosjekt 1
+
+- Enheten heter `t36-project2-backend` og bruker port **3001** — ikke endre
+  prosjekt 1s tjenester eller Apache-vhosts.
+
+## Oppdatere etter pull
+
+```bash
+export BACKEND_DIR="/home/<NTNU_BRUKERNAVN>/T36-Project-2/backend"
+cd "${BACKEND_DIR}" && npm ci
+sudo systemctl restart t36-project2-backend
+```
+
+Ved bytt til produksjonsbuild, oppdater `ExecStart` i
+`/etc/systemd/system/t36-project2-backend.service` (f.eks. `node dist/server.js`),
+deretter `daemon-reload` og `restart`.

backend/deploy/backend.env.example

@@ -0,0 +1,21 @@
+# Eksempel for systemd-tjenesten på VM.
+# Kopier til /etc/t36-project2/backend.env (aldri commit med passord).
+#
+# sudo mkdir -p /etc/t36-project2
+# sudo cp backend/deploy/backend.env.example /etc/t36-project2/backend.env
+# sudo chmod 640 /etc/t36-project2/backend.env
+# sudo chown root:__DEPLOY_USER__ /etc/t36-project2/backend.env
+#
+# Tjenesten kjører som __DEPLOY_USER__ (ikke root). Med 640 og gruppe =
+# deploy-brukeren kan prosessen lese filen; andre brukere på VM kan ikke.
+
+DATABASE_URL=postgresql://t36_project2:PASSORD@localhost:5432/t36_project2
+
+# GraphQL-server (src/server.ts): les HOST og PORT, lytt kun på 127.0.0.1 — ikke
+# 0.0.0.0. Apache proxyer mot http://127.0.0.1:3001/graphql (se deploy/apache/).
+HOST=127.0.0.1
+PORT=3001
+NODE_ENV=production
+
+# Valgfritt: offentlig rot for seed-bilder
+# PUBLIC_APP_BASE=/project2

backend/deploy/t36-project2-backend.service

@@ -0,0 +1,33 @@
+# Mal for gruppens Ubuntu-VM. Ikke enable før npm ci, backend.env og GraphQL er
+# verifisert lokalt (src/server.ts leser HOST/PORT, default 127.0.0.1:3001).
+#
+# Installasjon: se backend/deploy/README.md (erstatt __DEPLOY_USER__, __BACKEND_DIR__,
+# __NODE_BIN__).
+
+[Unit]
+Description=T36 Project 2 backend (GraphQL, port 3001)
+Documentation=file://__BACKEND_DIR__/deploy/README.md
+After=network-online.target postgresql.service
+Wants=network-online.target
+# Prosjekt 2 egen enhet — ikke delt med prosjekt 1
+
+[Service]
+Type=simple
+User=__DEPLOY_USER__
+Group=__DEPLOY_USER__
+WorkingDirectory=__BACKEND_DIR__
+
+# Hemmeligheter utenfor git (DATABASE_URL, HOST, PORT, osv.)
+EnvironmentFile=/etc/t36-project2/backend.env
+
+# Node 24 (nvm) + tsx fra backend/node_modules etter «npm ci» — ikke global tsx
+ExecStart=__NODE_BIN__ __BACKEND_DIR__/node_modules/tsx/dist/cli.mjs __BACKEND_DIR__/src/server.ts
+
+Restart=on-failure
+RestartSec=5
+TimeoutStopSec=30
+
+NoNewPrivileges=true
+
+[Install]
+WantedBy=multi-user.target

backend/migrations/1791895214550_create-listings-table.ts

@@ -0,0 +1,48 @@
+import type { ColumnDefinitions, MigrationBuilder } from 'node-pg-migrate';
+
+export const shorthands: ColumnDefinitions | undefined = undefined;
+
+const LISTING_CATEGORIES = [
+  'powerTools',
+  'handTools',
+  'garden',
+  'painting',
+  'measuring',
+  'cleaning',
+] as const;
+
+const LISTING_CONDITIONS = ['likeNew', 'good', 'worn'] as const;
+
+function sqlInList(values: readonly string[]): string {
+  return values.map((value) => `'${value}'`).join(', ');
+}
+
+export async function up(pgm: MigrationBuilder): Promise<void> {
+  pgm.createTable('listings', {
+    id: { type: 'text', primaryKey: true },
+    title: { type: 'text', notNull: true },
+    category: { type: 'text', notNull: true },
+    description: { type: 'text', notNull: true },
+    area: { type: 'text', notNull: true },
+    daily_price: { type: 'integer', notNull: true },
+    condition: { type: 'text', notNull: true },
+    accessories: { type: 'text[]', notNull: true, default: '{}' },
+    image_url: { type: 'text', notNull: false },
+  });
+
+  pgm.addConstraint('listings', 'listings_category_check', {
+    check: `category IN (${sqlInList(LISTING_CATEGORIES)})`,
+  });
+
+  pgm.addConstraint('listings', 'listings_condition_check', {
+    check: `condition IN (${sqlInList(LISTING_CONDITIONS)})`,
+  });
+
+  pgm.addConstraint('listings', 'listings_daily_price_check', {
+    check: 'daily_price >= 0',
+  });
+}
+
+export async function down(pgm: MigrationBuilder): Promise<void> {
+  pgm.dropTable('listings');
+}

backend/migrations/1791978982612_add-listings-created-at.ts

@@ -0,0 +1,24 @@
+import type { ColumnDefinitions, MigrationBuilder } from 'node-pg-migrate';
+
+export const shorthands: ColumnDefinitions | undefined = undefined;
+
+/**
+ * Legger til når annonsen ble opprettet. Trengs for å sortere på «nyeste» og
+ * for å spre genererte annonser utover tid.
+ *
+ * Eksisterende rader får tidspunktet migrasjonen kjøres. Nye rader får
+ * tidspunktet de settes inn, med mindre seed-skriptet oppgir et eget.
+ */
+export async function up(pgm: MigrationBuilder): Promise<void> {
+  pgm.addColumn('listings', {
+    created_at: {
+      type: 'timestamptz',
+      notNull: true,
+      default: pgm.func('current_timestamp'),
+    },
+  });
+}
+
+export async function down(pgm: MigrationBuilder): Promise<void> {
+  pgm.dropColumn('listings', 'created_at');
+}

backend/migrations/1792006352081_add-listings-created-at-index.ts

@@ -0,0 +1,24 @@
+import type { ColumnDefinitions, MigrationBuilder } from 'node-pg-migrate';
+
+export const shorthands: ColumnDefinitions | undefined = undefined;
+
+/**
+ * Indeks for standardsorteringen i listings: nyeste først, med id som andre
+ * nøkkel. Indeksen har samme rekkefølge som ORDER BY created_at DESC, id DESC,
+ * så PostgreSQL kan lese den første siden rett fra indeksen i stedet for å
+ * sortere hele tabellen for hver forespørsel.
+ */
+export async function up(pgm: MigrationBuilder): Promise<void> {
+  pgm.createIndex(
+    'listings',
+    [
+      { name: 'created_at', sort: 'DESC' },
+      { name: 'id', sort: 'DESC' },
+    ],
+    { name: 'listings_created_at_id_idx' },
+  );
+}
+
+export async function down(pgm: MigrationBuilder): Promise<void> {
+  pgm.dropIndex('listings', [], { name: 'listings_created_at_id_idx' });
+}