feature/approved-from-dev-to-main

.gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.env
+.DS_Store
+backend/data/

README.md

@@ -456,3 +456,38 @@ Dette kan blant annet innebære:
 - optimalisere bilder
 - unngå unødvendig tunge biblioteker
 - gjenbruke komponenter
+
+# Lagt ttil av Sofie 
+## Database og backend på VM
+
+PostgreSQL 18 er installert direkte på VM-en (it2810-01.idi.ntnu.no) med apt, uten Docker. Databasen lytter kun på localhost og er ikke tilgjengelig utenfra.
+
+- Kode: `/srv/winenot` (klonet fra dette repoet, branch `dev`)
+- Database: `winenot`, eid av brukeren `winenot_app`
+- Tilkoblingsinfo og passord: `/srv/winenot/backend/.env` (kun lesbar med sudo). Se `backend/.env.example` for hvilke variabler som trengs.
+- Tabeller opprettes med migrasjonene i `backend/db/migrations/`, kjørt i nummerert rekkefølge:
+  `psql -h localhost -U winenot_app -d winenot -v ON_ERROR_STOP=1 -f backend/db/migrations/<fil>.sql`
+
+### Starte backend
+
+```bash
+cd /srv/winenot/backend
+npm ci
+npm start
+```
+
+Backend kjører på port 3001.
+
+### Importere data (X-Wines)
+
+1. Last ned `XWines_Full_100K_wines.csv` og `XWines_Full_21M_ratings.csv` fra Google Drive-lenken i Dataset-mappen på https://github.com/rogerioxavier/X-Wines
+2. Kopier filene til `/srv/winenot/backend/data/` (mappen ligger i `.gitignore`)
+3. Kjør migrasjonene i `backend/db/migrations/` som ikke er kjørt, og deretter:
+```bash
+   cd /srv/winenot/backend
+   npm ci
+   npm run import -- data/XWines_Full_100K_wines.csv data/XWines_Full_21M_ratings.csv
+```
+Skriptet kan kjøres flere ganger, og favoritter beholdes. Uten argumenter bruker det testfilene (100 viner), som er nok til lokal utvikling.
+
+Datasett: de Azambuja, R. X., Morais, A. J., & Filipe, V. (2023). X-Wines: A Wine Dataset for Recommender Systems and Machine Learning. *Big Data and Cognitive Computing*, 7(1), 20. https://doi.org/10.3390/bdcc7010020

backend/.env.example

@@ -0,0 +1,6 @@
+# Copy to .env and fill in your own values. .env must never be committed.
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=winenot
+DB_USER=your_postgres_user
+DB_PASSWORD=

backend/db/migrations/001_create_tables.sql

@@ -0,0 +1,103 @@
+-- 001_create_tables.sql
+-- Wine not? – tabeller og typer for PostgreSQL
+-- Kjør med:  psql -d winenot -v ON_ERROR_STOP=1 -f backend/db/migrations/001_create_tables.sql
+-- En migrasjon som er merget, endres ikke. Nye endringer legges i en ny, nummerert fil.
+
+BEGIN;
+
+-- ---------- Typer ----------
+-- Verdiene er de samme som i X-Wines, og rekkefølgen her bestemmer sorteringen.
+
+CREATE TYPE body_level AS ENUM (
+  'Very light-bodied',
+  'Light-bodied',
+  'Medium-bodied',
+  'Full-bodied',
+  'Very full-bodied'
+);
+
+CREATE TYPE acidity_level AS ENUM (
+  'Low',
+  'Medium',
+  'High'
+);
+
+-- ---------- Oppslagstabeller ----------
+
+CREATE TABLE countries (
+  code text PRIMARY KEY,                  -- Code fra X-Wines, f.eks. 'FR'
+  name text NOT NULL UNIQUE
+);
+
+CREATE TABLE regions (
+  id           integer PRIMARY KEY,       -- RegionID fra X-Wines
+  name         text NOT NULL,
+  country_code text NOT NULL REFERENCES countries(code)
+);
+
+CREATE TABLE wineries (
+  id      integer PRIMARY KEY,            -- WineryID fra X-Wines
+  name    text NOT NULL,
+  website text
+);
+
+CREATE TABLE grapes (
+  id   integer GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  name text NOT NULL UNIQUE
+);
+
+CREATE TABLE foods (
+  id   integer GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  name text NOT NULL UNIQUE               -- verdier fra Harmonize, f.eks. 'Beef', 'Rich Fish'
+);
+
+-- ---------- Viner ----------
+
+CREATE TABLE wines (
+  id           integer PRIMARY KEY,       -- WineID fra X-Wines
+  name         text NOT NULL,
+  type         text NOT NULL,             -- Red, White, Rosé, Sparkling, Dessert, Dessert/Port
+  elaborate    text,                      -- f.eks. 'Varietal/100%', 'Assemblage/Blend'
+  abv          numeric(4,1),              -- alkoholprosent
+  body         body_level,
+  acidity      acidity_level,
+  winery_id    integer NOT NULL REFERENCES wineries(id),
+  region_id    integer NOT NULL REFERENCES regions(id),
+  country_code text    NOT NULL REFERENCES countries(code), -- bevisst duplisert fra regions: sparer en join ved landfilter
+  vintages     integer[] NOT NULL DEFAULT '{}',             -- 'N.V.' hoppes over i importskriptet
+  avg_rating   numeric(3,2),              -- forhåndsberegnet i importskriptet
+  rating_count integer NOT NULL DEFAULT 0
+);
+
+-- ---------- Mange-til-mange ----------
+
+CREATE TABLE wine_grapes (
+  wine_id  integer NOT NULL REFERENCES wines(id)  ON DELETE CASCADE,
+  grape_id integer NOT NULL REFERENCES grapes(id) ON DELETE CASCADE,
+  PRIMARY KEY (wine_id, grape_id)
+);
+
+CREATE TABLE wine_foods (
+  wine_id integer NOT NULL REFERENCES wines(id) ON DELETE CASCADE,
+  food_id integer NOT NULL REFERENCES foods(id) ON DELETE CASCADE,
+  PRIMARY KEY (wine_id, food_id)
+);
+
+-- ---------- Brukere og favoritter (brukergenerert data) ----------
+
+CREATE TABLE users (
+  id            integer GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  username      text NOT NULL UNIQUE,
+  email         text NOT NULL UNIQUE,
+  password_hash text NOT NULL,            -- aldri klartekst; hashes med bcrypt/argon2 i backend
+  created_at    timestamptz NOT NULL DEFAULT now()
+);
+
+CREATE TABLE favorites (
+  user_id    integer NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  wine_id    integer NOT NULL REFERENCES wines(id) ON DELETE CASCADE,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  PRIMARY KEY (user_id, wine_id)          -- hindrer duplikater og dekker "mine favoritter"
+);
+
+COMMIT;

backend/db/migrations/002_create_indexes.sql

@@ -0,0 +1,31 @@
+-- 002_create_indexes.sql
+-- Wine not? – indekser for søk, filtrering og sortering
+-- Kjør med:  psql -d winenot -v ON_ERROR_STOP=1 -f backend/db/migrations/002_create_indexes.sql
+
+BEGIN;
+
+CREATE EXTENSION IF NOT EXISTS pg_trgm;   -- raskt delstreng-søk på vinnavn
+
+-- Søk: WHERE name ILIKE '%tekst%'
+CREATE INDEX wines_name_trgm_idx ON wines USING gin (name gin_trgm_ops);
+
+-- Filtre
+CREATE INDEX wines_type_idx     ON wines (type);
+CREATE INDEX wines_country_idx  ON wines (country_code);
+CREATE INDEX wines_region_idx   ON wines (region_id);
+CREATE INDEX wines_winery_idx   ON wines (winery_id);
+CREATE INDEX wines_taste_idx    ON wines (body, acidity);      -- Explore by taste
+CREATE INDEX wines_vintages_idx ON wines USING gin (vintages); -- WHERE vintages @> ARRAY[2018]
+
+-- Sortering (id som siste ledd gir stabil rekkefølge ved paginering)
+CREATE INDEX wines_name_sort_idx ON wines (name, id);
+CREATE INDEX wines_rating_idx    ON wines (avg_rating DESC NULLS LAST, id);
+CREATE INDEX wines_abv_idx       ON wines (abv, id);
+
+-- Primærnøklene dekker oppslag fra vin/bruker. Disse dekker motsatt vei.
+CREATE INDEX wine_grapes_grape_idx ON wine_grapes (grape_id);
+CREATE INDEX wine_foods_food_idx   ON wine_foods (food_id);
+CREATE INDEX favorites_wine_idx    ON favorites (wine_id);
+CREATE INDEX regions_country_idx   ON regions (country_code);
+
+COMMIT;

backend/db/migrations/003_add_food_category.sql

@@ -0,0 +1,14 @@
+-- 003_add_food_category.sql
+-- Wine not? – grovere matkategorier til Find wine by food
+-- Kjør med:  psql -d winenot -v ON_ERROR_STOP=1 -f backend/db/migrations/003_add_food_category.sql
+--
+-- Hver matverdi fra X-Wines (f.eks. 'Rich Fish', 'Shellfish') får én kategori (f.eks. 'Fish & seafood').
+-- Selve grupperingen ligger i db/seeds/food_categories.sql og kjøres av importskriptet.
+
+BEGIN;
+
+ALTER TABLE foods ADD COLUMN category text;
+
+CREATE INDEX foods_category_idx ON foods (category);
+
+COMMIT;

backend/db/seeds/food_categories.sql

@@ -0,0 +1,76 @@
+-- food_categories.sql
+-- Grupperer matverdiene fra X-Wines (kolonnen Harmonize) i kategorier for Find wine by food.
+--
+-- Kjøres automatisk av importskriptet etter at maten er satt inn, og kan også kjøres alene:
+--   psql -d winenot -1 -v ON_ERROR_STOP=1 -f backend/db/seeds/food_categories.sql
+-- (-1 kjører hele filen som én transaksjon. Filen har ikke egen BEGIN/COMMIT,
+--  fordi importskriptet kjører den inne i sin egen transaksjon.)
+--
+-- Endre en kategori: bytt navnet i høyre kolonne og kjør filen på nytt.
+-- Ny matverdi uten kategori: importskriptet lister dem opp. Legg dem til her.
+-- Matverdier som ikke står her, får category = NULL og vises ikke i Find wine by food.
+
+UPDATE foods SET category = NULL;
+
+UPDATE foods AS f
+SET category = m.category
+FROM (VALUES
+  -- Kjøtt
+  ('Beef',             'Meat'),
+  ('Lamb',             'Meat'),
+  ('Veal',             'Meat'),
+  ('Pork',             'Meat'),
+  ('Game Meat',        'Meat'),
+  ('Barbecue',         'Meat'),
+  ('Grilled',          'Meat'),
+
+  -- Fjærkre
+  ('Poultry',          'Poultry'),
+  ('Chicken',          'Poultry'),
+
+  -- Fisk og sjømat
+  ('Fish',             'Fish & seafood'),
+  ('Rich Fish',        'Fish & seafood'),
+  ('Lean Fish',        'Fish & seafood'),
+  ('Seafood',          'Fish & seafood'),
+  ('Shellfish',        'Fish & seafood'),
+
+  -- Ost
+  ('Maturated Cheese', 'Cheese'),
+  ('Soft Cheese',      'Cheese'),
+  ('Hard Cheese',      'Cheese'),
+  ('Blue Cheese',      'Cheese'),
+  ('Goat Cheese',      'Cheese'),
+
+  -- Pasta, pizza og gryter
+  ('Pasta',            'Pasta, pizza & stews'),
+  ('Pizza',            'Pasta, pizza & stews'),
+  ('Risotto',          'Pasta, pizza & stews'),
+  ('Tomato Dishes',    'Pasta, pizza & stews'),
+  ('Light Stews',      'Pasta, pizza & stews'),
+
+  -- Vegetar
+  ('Vegetarian',       'Vegetarian'),
+  ('Salad',            'Vegetarian'),
+  ('Mushrooms',        'Vegetarian'),
+
+  -- Sterk mat
+  ('Spicy Food',       'Spicy food'),
+
+  -- Småretter og aperitiff
+  ('Appetizer',        'Snacks & starters'),
+  ('Snack',            'Snacks & starters'),
+  ('Aperitif',         'Snacks & starters'),
+  ('Cured Meat',       'Snacks & starters'),
+  ('Cold Cuts',        'Snacks & starters'),
+  ('French Fries',     'Snacks & starters'),
+
+  -- Dessert
+  ('Sweet Dessert',    'Dessert'),
+  ('Fruit Dessert',    'Dessert'),
+  ('Cake',             'Dessert'),
+  ('Chocolate',        'Dessert'),
+  ('Fruit',            'Dessert'),
+  ('Cream',            'Dessert')
+) AS m(food, category)
+WHERE f.name = m.food;