teecup/020_personal_rounds.sql

210 lines
11 KiB
MySQL
Raw Permalink Normal View History

-- =====================================================================
-- TeeCup — frittstående rundeføring med detaljert statistikk
-- (migrasjon 020, ADR-033)
-- =====================================================================
-- Frittstående runder er eid av en BRUKER (`app_user.id`), ikke en
-- organisasjon (Beslutning A) -- INGEN RLS på disse tabellene. Samme
-- allerede etablerte mønster som personlig profil (015)/HCP-historikk
-- (018)/sekundær e-post (017): `plain_connection()` (ingen
-- `app.current_org`), autorisasjon håndheves eksplisitt i app-laget med
-- `WHERE owner_user_id = $1` i hver spørring.
--
-- Banedata (Beslutning C, bekreftet med bruker): offisielle teeoff-baner
-- slås opp LIVE ved behov (ingen lokal kopi/import, kun en referanse +
-- et navne-snapshot for visning). Egendefinerte baner som ikke finnes i
-- teeoff havner i en NY, GLOBAL banekatalog (`personal_course` +
-- tilhørende hull/utslag/rating-tabeller) -- delt på tvers av ALLE
-- TeeCup-brukere (ikke org-scopet som den eksisterende `course`-tabellen),
-- med søk-før-opprett tenkt håndtert i API-/frontend-laget for å begrense
-- duplikater (ikke håndhevet i skjemaet).
--
-- `personal_course_tee_rating` har BEVISST ingen `scope`-kolonne (ulikt
-- den org-scopede `tee_rating`) -- Beslutning G sin Net-Par-tilnærming
-- for uspilte hull gjør at frittstående runder alltid regnes som en
-- 18-hulls-ekvivalent gjennom ÉN formel, uansett om 9 eller 18 hull
-- faktisk ble spilt. Ingen egen front_9/back_9-rating trengs derfor her.
--
-- Hver runde snapshotter par/stroke-index PER SPILT HULL på selve
-- `round_hole`-raden (samme reproduserbarhets-prinsipp som ADR-007 sin
-- handicap-snapshot) -- en fremtidig endring i teeoff sin banedata, eller
-- en redigering av en `personal_course`, skal ALDRI endre en allerede
-- spilt rundes tall retroaktivt.
--
-- Statistikk-modellen (Beslutning B): et fast sett navngitte felt per
-- hull, ikke fri slag-for-slag-logging. GIR er bevisst IKKE en egen
-- lagret kolonne -- den er alltid DERIVERBAR ved lesing
-- (`approach_result = 'hit' AND (score - putts) <= par - 2`), se
-- ADR-033.
--
-- Bevisst v1-avgrensning: en `round` er kun synlig/redigerbar for sin
-- `owner_user_id` -- en lenket deltaker (`round_participant.user_id`
-- satt) får IKKE egen tilgang til runden i denne runden (notert som
-- åpent punkt i ADR-033, ikke løst her).
-- =====================================================================
\set ON_ERROR_STOP on
-- ---------------------------------------------------------------------
-- Global banekatalog for egendefinerte (ikke-teeoff) baner
-- ---------------------------------------------------------------------
CREATE TABLE personal_course (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
name text NOT NULL,
created_by_user_id uuid NOT NULL REFERENCES app_user(id) ON DELETE CASCADE,
created_at timestamptz NOT NULL DEFAULT now()
);
CREATE TABLE personal_course_hole (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
personal_course_id uuid NOT NULL REFERENCES personal_course(id) ON DELETE CASCADE,
hole_number smallint NOT NULL CHECK (hole_number BETWEEN 1 AND 18),
par smallint NOT NULL CHECK (par BETWEEN 3 AND 6),
stroke_index smallint NOT NULL CHECK (stroke_index BETWEEN 1 AND 18),
UNIQUE (personal_course_id, hole_number),
UNIQUE (personal_course_id, stroke_index)
);
CREATE TABLE personal_course_tee (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
personal_course_id uuid NOT NULL REFERENCES personal_course(id) ON DELETE CASCADE,
name text NOT NULL,
UNIQUE (personal_course_id, name)
);
CREATE TABLE personal_course_tee_rating (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
personal_course_tee_id uuid NOT NULL REFERENCES personal_course_tee(id) ON DELETE CASCADE,
-- Kun m/f, ikke 'x' -- en WHS-rating er alltid for ett bestemt kjønn
-- (samme presedens som org-scopet tee_rating, ADR-029).
gender text NOT NULL CHECK (gender IN ('m', 'f')),
course_rating numeric(4,1) NOT NULL,
slope_rating smallint NOT NULL CHECK (slope_rating BETWEEN 55 AND 155),
par smallint NOT NULL,
UNIQUE (personal_course_tee_id, gender)
);
-- ---------------------------------------------------------------------
-- Selve runden
-- ---------------------------------------------------------------------
CREATE TABLE round (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
owner_user_id uuid NOT NULL REFERENCES app_user(id) ON DELETE CASCADE,
course_source text NOT NULL CHECK (course_source IN ('teeoff', 'custom')),
-- 'teeoff': live oppslag, kun referanse + navn-snapshot lagres.
teeoff_facility_slug text,
teeoff_course_id text,
-- 'custom': ekte FK til den globale katalogen over.
personal_course_id uuid REFERENCES personal_course(id),
CHECK (
(course_source = 'teeoff'
AND teeoff_facility_slug IS NOT NULL AND teeoff_course_id IS NOT NULL
AND personal_course_id IS NULL)
OR
(course_source = 'custom'
AND personal_course_id IS NOT NULL
AND teeoff_facility_slug IS NULL AND teeoff_course_id IS NULL)
),
-- Snapshot for visning uten et nytt live-oppslag hver gang runden åpnes.
course_name_snapshot text NOT NULL,
tee_name_snapshot text NOT NULL,
played_at date NOT NULL,
-- Fritt starthull (Beslutning E) -- 9/18 under er kun et UI-standardvalg,
-- IKKE håndhevet (spilleren kan avslutte etter et vilkårlig antall hull).
start_hole smallint NOT NULL DEFAULT 1 CHECK (start_hole BETWEEN 1 AND 18),
holes_planned smallint NOT NULL DEFAULT 18 CHECK (holes_planned IN (9, 18)),
completed_at timestamptz,
created_at timestamptz NOT NULL DEFAULT now()
);
CREATE INDEX ON round (owner_user_id);
-- ---------------------------------------------------------------------
-- Deltakere i runden -- eieren selv ELLER andre i flighten (Beslutning D)
-- ---------------------------------------------------------------------
CREATE TABLE round_participant (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
round_id uuid NOT NULL REFERENCES round(id) ON DELETE CASCADE,
-- Nøyaktig én av user_id/guest_name -- en ekte TeeCup-bruker som
-- spiller med, ELLER et rent navn uten konto (samme prinsipp som
-- org-scopet `player` uten `user_id`).
user_id uuid REFERENCES app_user(id),
guest_name text,
CHECK (
((user_id IS NOT NULL)::int + (guest_name IS NOT NULL)::int) = 1
),
is_owner boolean NOT NULL DEFAULT false,
-- Snapshot ved tilføyelse (samme reproduserbarhets-prinsipp som ADR-007
-- sin handicap-snapshot) -- en senere profilendring skal ikke endre en
-- allerede spilt rundes tall retroaktivt.
gender text NOT NULL CHECK (gender IN ('m', 'f', 'x')),
handicap_index_snapshot numeric(4,1), -- NULL = ingen HCP-sporing for denne deltakeren
course_handicap_snapshot smallint,
-- Fylles ved fullføring (ADR-033 Beslutning F/G) -- kun sant/satt når
-- minimums-/gyldighetskravene er oppfylt.
counts_for_handicap boolean NOT NULL DEFAULT false,
score_differential numeric(4,1),
created_at timestamptz NOT NULL DEFAULT now()
);
CREATE INDEX ON round_participant (round_id);
CREATE INDEX ON round_participant (user_id);
-- Maks én markert eier per runde.
CREATE UNIQUE INDEX round_participant_one_owner ON round_participant (round_id) WHERE is_owner;
-- ---------------------------------------------------------------------
-- Hull-for-hull -- rating-snapshot OG statistikk, per deltaker
-- ---------------------------------------------------------------------
CREATE TABLE round_hole (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
round_participant_id uuid NOT NULL REFERENCES round_participant(id) ON DELETE CASCADE,
hole_number smallint NOT NULL CHECK (hole_number BETWEEN 1 AND 18),
-- Rating-snapshot (par/stroke-index på TIDSPUNKTET runden ble spilt) --
-- se moduldoc-kommentaren øverst om hvorfor dette IKKE er en live-referanse.
par smallint NOT NULL CHECK (par BETWEEN 3 AND 6),
stroke_index smallint NOT NULL CHECK (stroke_index BETWEEN 1 AND 18),
played boolean NOT NULL DEFAULT false,
score smallint CHECK (score IS NULL OR score BETWEEN 1 AND 20),
putts smallint CHECK (putts IS NULL OR putts BETWEEN 0 AND 10),
club_off_tee text,
-- Kun meningsfullt på par 4/5 (håndheves i app-laget, ikke her).
tee_shot_result text CHECK (tee_shot_result IS NULL OR tee_shot_result IN ('fairway', 'left', 'right')),
-- "Innspillsslaget" = siste slag før første putt, uansett hullets par
-- (ADR-033 Beslutning B) -- GIR er DERIVERT herfra ved lesing, ikke en
-- egen lagret kolonne: approach_result='hit' AND (score-putts) <= par-2.
approach_result text CHECK (approach_result IS NULL OR approach_result IN ('hit', 'long', 'short', 'left', 'right')),
chip_count smallint CHECK (chip_count IS NULL OR chip_count >= 0),
bunker_shot_count smallint CHECK (bunker_shot_count IS NULL OR bunker_shot_count >= 0),
penalty_strokes smallint CHECK (penalty_strokes IS NULL OR penalty_strokes >= 0),
first_putt_distance_m numeric(4,1) CHECK (first_putt_distance_m IS NULL OR first_putt_distance_m >= 0),
UNIQUE (round_participant_id, hole_number)
);
-- ---------------------------------------------------------------------
-- Rettigheter -- INGEN RLS her (Beslutning A). teecup_app filtrerer selv
-- med WHERE owner_user_id = $1 (round) / gjennom round_id (de to andre) i
-- hver spørring, samme mønster som handicap_history/user_secondary_email.
-- ---------------------------------------------------------------------
GRANT SELECT, INSERT, UPDATE, DELETE ON personal_course TO teecup_app;
GRANT SELECT, INSERT, UPDATE, DELETE ON personal_course_hole TO teecup_app;
GRANT SELECT, INSERT, UPDATE, DELETE ON personal_course_tee TO teecup_app;
GRANT SELECT, INSERT, UPDATE, DELETE ON personal_course_tee_rating TO teecup_app;
GRANT SELECT, INSERT, UPDATE, DELETE ON round TO teecup_app;
GRANT SELECT, INSERT, UPDATE, DELETE ON round_participant TO teecup_app;
GRANT SELECT, INSERT, UPDATE, DELETE ON round_hole TO teecup_app;