Bygget:
Installerbar app: app/manifest.ts, appleWebApp-metadata for iOS, service worker (public/sw.js, håndskrevet — ingen next-pwa-avhengighet), public/offline.html.
Ikoner: enkelt grønt golf-flagg generert programmatisk (måtte omgå at verken PIL, rsvg-convert eller ImageMagick fantes i miljøet — løste det med et scratch npm-oppsett av sharp). Midlertidig, notert i FEATURE_BACKLOG.md for senere erstatning, slik du ba om. Erstattet samtidig den gamle apple-icon.png som faktisk var v0.app sin generiske plassholderlogo, ikke TeeCup-merkevare.
Full offline scoreregistrering: ny lib/offline-queue.ts (IndexedDB-kø) koblet inn i scorekort-skjermen. Slag/hull-resultat registrert offline vises umiddelbart som "Lagret lokalt · venter på synk", synkes automatisk når nettet er tilbake (pluss en manuell "Synkroniser nå"-knapp). Se ADR-028 for alle designvalgene (bl.a. hvorfor køen ligger i klientkoden og ikke i service workeren, og hvorfor jeg bevisst unngikk Background Sync API — iOS Safari støtter den ikke).
Viktig å være ærlig om: jeg har ingen nettleser-verktøy tilgjengelig i denne økten, så offline-flyten er verifisert med typesjekket produksjonsbuild + en kort container-boot (curl mot manifest/service worker/ikoner — alle svarer riktig), men ikke faktisk testet i en ekte nettleser (Chrome DevTools sin Offline-bryter, ordentlig "Legg til på hjemskjerm"). Anbefaler sterkt at du selv tester scorekort-siden med DevTools offline-modus før dere stoler på det i skarp bruk.
De fire UI-hullene du meldte inn er dokumentert i FEATURE_BACKLOG.md/CLAUDE.md med root cause (ikke bare notert som klager) — den mest presserende er /orgs/{id}/members, som er en reell rewrite/dynamisk-rute-kollisjon: siden er helt utilgjengelig i dag fordi Next.js sin /orgs/:path*-proxy-regel fanger kallet før selve siden noensinne nås.
Ingen migrasjon i denne runden — kun teecup_frontend trenger redeploy.
117 KiB
CLAUDE.md — arbeidsinstruks for TeeCup
Les dette først i hver økt. Det koder hva vi har bestemt og hvordan vi jobber.
Autoritative kilder (les før du gjør noe)
ARCHITECTURE_DECISIONS.md— hva som er bestemt og hvorfor (ADR-001…018). Fasit.FEATURE_BACKLOG.md— hva som gjenstår, hva som er utsatt, hva som mangler.- Endres en beslutning: legg til en ny ADR, ikke slett historikk. Hold begge filene oppdatert når noe avgjøres.
Sikkerhetsregler (ufravikelige)
- Rør ALDRI
teeoff-databasen eller den ekteteecup_dbuten at brukeren eksplisitt har bekreftet det i samme økt. Test alltid migrasjoner mot en egen scratch-database først, og rydd opp etterpå. - Vis planen (hvilke kommandoer, mot hvilken database) FØR du kjører noe som skriver, migrerer eller sletter. Vent på bekreftelse.
- Hemmeligheter (passord, secrets) bor i
.env(filrettigheter 600), dekkes av.gitignore, committes aldri, og skrives aldri i klartekst i chatten eller i SQL-filer. Generer dem på serveren (openssl rand -base64 32). - Kjør appen som databaserollen
teecup_app(NOSUPERUSER, NOBYPASSRLS) — aldri somteeoff_admin/superuser i runtime.
Arkitektur-invarianter (ikke bryt uten en ny ADR)
- Tenant = organisasjon.
organization_idpå alle domenetabeller, håndhevet av RLS. App-koden setterapp.current_orgmedSET LOCALper transaksjon. - Verifiser at brukeren er medlem av organisasjonen FØR org-konteksten settes.
RLS stoler blindt på
app.current_org. - Egen innlogging (uavhengig av teeoff). Banedata hentes fra teeoff via lesende API, ikke delt database.
- v1 = nøyaktig to lag (Ryder Cup-format), håndhevet i app-laget. Match-modellen holdes generell (to sider) så knockout/flere lag kan komme senere.
- Handicap-/matchlogikk skal ligge i
handicap_engine.py(rent, testet, uten db/API-avhengigheter). Allowances er konfig, ikke hardkodet. - Media (bilder/video) skal i objektlagring (MinIO), ikke i Postgres. Postgres holder bare metadata + nøkkel.
Arbeidsmåte
- Inkrementelt. Ingenting tas for gitt før det er testet. Bekreft hvert steg før du går videre.
- Bruk git (remote: brukerens Forgejo). Commit i logiske steg med tydelige meldinger.
- Er du usikker på omfang eller en beslutning: spør heller enn å gjette.
Status (oppdater denne når ting endres)
Ferdig og verifisert:
-
Handicap-motor + tester (24/24, R&A-verifisert).
-
Skjema
001+ roller002+ scoring/blind draw003. Isolasjon bevist medtest_isolation.sql(RLS-oppførsel, ikke bare at skjemaet kjører). -
002 hadde en reell bug (psql interpolerer ikke
:'var'inne iDO $$...$$) — permanent fikset, verifisert mot scratch to ganger. -
API-et kjørt for ekte (ikke bare syntaks-sjekket) i en engangs Docker- container mot en scratch-database, RLS bevist gjennom hele asyncpg-pool-stacken (ikke bare i rå SQL).
-
Oppsett-endepunktene er bygget og verifisert:
app/routers/players.py(spillerpool),tournaments.py(turnering/lag/roster/økter, ADR-011 to-lags-grense håndhevet medFOR UPDATE-lås),matches.py(matcher/ deltakere/blind draw-lås, ADR-013-synlighet push-down i SQL). Delt feiloversettelse iapp/errors.py, delte synlighetsspørringer iapp/blind_draw.py.main.pyer nå bare app-factory +include_router. -
Scoring-runden er bygget og verifisert for ekte mot scratch-db (18-hulls bane med
tee_rating, 4 spillere for fourball-testing):app/handicap.py(ADR-014 fire brytere viaparse_allowance_config, handicap beregnes icompute_and_store_side_handicapsrett etter deltaker-innsetting — singles/fourball per spiller umiddelbart, foursome/greensome/scramble kun når siden er komplett),app/routers/scoring.py(hole-scores/hole-results-upsert,scorecard-GET, matchstatus-recompute medFOR UPDATE-lås mot race og SAMMENHENGENDE-prefiks-regel for uferdige hull).app/team_authz.pyskilt ut framatches.py(delt medscoring.py). Alle 10 planlagte tester bestått, inkl. fourball better-ball-aggregering (MIN av to nettoer, venter til begge partnere har registrert), poeng-caching ved tidlig avgjort match, og ADR-014-bryterenuse_handicap=false. Fant og fikset underveis:tournaments.pysinSessionCreatemangletscoring_modehelt (økter kunne aldri opprettes ihole_result-modus via API-et) — lagt til. Bevisst utelatt/kjente begrensninger: en side som aldri når forventet deltakerantall (no-show) får aldri beregnet handicap og matchen kan da aldri avgjøres — ingen manuell overstyring bygget. Score-skriving er upsert (ingen avvisning ved duplikat) — ingen audit-trail på rettelser. Kapteins-only autorisasjon fortsatt ikke bygget (FEATURE_BACKLOG ❓); bar er «rostret på laget». -
Match-lås ved avgjørelse (2026-07-16):
submit_hole_score/submit_hole_resultavviser nå 409 hvismatch.points_side_a IS NOT NULL(matchen er avgjort) — FØR upserten kjøres, både for nye hull og korrigering av allerede talte hull. Tetter en reell bug: uten dette kunne «spøkelses-hull» lagt inn etter avgjørelse endre en allerede cachet margin ved neste omregning. Automatisk, ingen ny autorisasjon involvert. -
Ekte autentisering bygget og verifisert (2026-07-16):
X-Debug-User-Id- stubben er HELT fjernet (ingen fallback). Magic-link + JWT-sesjon iapp/routers/auth.py+app/auth.py(request-link/verify-link/logout/me), ny migrasjon004_auth.sql(magic_link_token-tabell + unik e-post-indeks påapp_user). Token =secrets.token_urlsafe(32), kun SHA-256-hash lagres, atomisk forbruk (UPDATE ... RETURNING, ikke les-sjekk-skriv), generisk respons uansett om e-posten finnes (unngår enumerering), gamle uforbrukte lenker ugyldiggjøres når en ny utstedes,app_useropprettes FØRST ved vellykket verifisering (ikke ved forespørsel). Sesjons-JWT (PyJWT,algorithms=["HS256"]eksplisitt) i HttpOnly/SameSite=Lax/dynamisk-Secure-cookie, 30 dager, med et ekte eksistens-oppslag motapp_userpå hver forespørsel (faktisk tilbakekalling — en slettet bruker kan ikke ri ut sesjonen). Alle 12 planlagte tester bestått. Fant og fikset underveis:ON CONFLICT (email)matchet ikke den nye PARTIELLE unike indeksen uten eksplisittWHERE email IS NOT NULL(samme klasse feil somhole_scores partielle indekser i scoring-runden). Fant, IKKE fikset i denne runden (egen runde rett etterpå — se under):organization-tabellens RLS-policy kastet en 500 i stedet for skjemaets lovede "trygg standard: se ingenting" ved tomstreng-GUC. -
RLS-tomstreng-bug FIKSET (2026-07-16): ny migrasjon
005_rls_null_guard.sql— deltSTABLESQL-funksjonapp_current_org()gjørNULLIF(current_setting('app.current_org', true), '')::uuidi stedet for det rå uttrykket, brukt av alle 15 RLS-policyer (ALTER POLICY, 14org_isolation+org_self). Verifisert med 3 nye regresjonstester itest_isolation.sql(Test 10-12) OG ved faktisk å gjenskape original- buggen mot en ekte container (pool-størrelse 1, varm opp medorg_connection(), deretter/auth/mepå samme gjenbrukte tilkobling — gikk fra 500 til 200). Viktig presisering fra denne runden: fiksen gjør IKKE at/auth/mekan joineorganizationdirekte viaplain_connection()— det var en feilaktig antakelse i forrige runde.org_selfkrever fortsatt en MATCHENDEapp.current_orgfor å vise en rad (riktig RLS-design, ikke noe fiksen skulle endre), og en bruker kan tilhøre flere organisasjoner samtidig, så det finnes ingen ÉN kontekst å sette for en tverr-org-spørring./auth/meslår derfor opp hvert org-navn ett om gangen viaorg_connection()(N+1, N = antall org-er brukeren tilhører) — dette er riktig løsning, ikke en omvei. -
Organisasjon-bootstrap bygget og verifisert (2026-07-16): nytt
POST /orgs(app/routers/organizations.py) — det ENESTE stedet i API-et som setter inn enorganization-rad. Fant under statusgjennomgang at dette manglet helt (alle tidligere org-er var seedet med superbruker-SQL). Ingen ny migrasjon. Selvrefererende RLS-bootstrap bekreftet å fungere: generer org-ens uuid i Python, settapp.current_orgtil nøyaktig den via eksisterendeorg_connection(), sett innorganization-raden med samme id —org_selfs implisitteWITH CHECKblir da trivielt sann, ingen privilegert tilkobling nødvendig (i motsetning til hva 002s kommentar antydet). Verifisert med 5 tester inkl. en negativ kontroll (mismatchende id avvist medinsufficient_privilege) og full kryss-org-isolasjon mellom to uavhengig opprettede organisasjoner. -
Ekte SMTP-utsending bygget og verifisert (2026-07-16): ny
app/email.py(send_magic_link_email,smtplibviaasyncio.to_thread, håndterer både implisitt TLS/port 465 og STARTTLS dynamisk). Brukeren la egne SMTP-credentials i.env(TEECUP_SMTP_*,TEECUP_FROM_EMAIL— ADR-009, ikke delt med teeoff); jeg leste kun nøkkelnavnene for å bekrefte de fantes, aldri verdiene.app/config.pysinSMTP_CONFIGUREDer valgfri (ikke_required) — dev-only logging (TEECUP_DEV_LOG_MAGIC_LINKS) fortsatt fungerer uendret når SMTP ikke er satt opp. Driftsfeil i utsendingen lekker aldri til klientresponsen (bevarer anti-enumerering). Verifisert med faktisk levering: sendte én ekte test-e-post til en adresse brukeren oppga — brukeren bekreftet mottak. Første gang noe i prosjektet er bevist ved ekte levering, ikke bare curl/scratch. -
Containerisert og LIVE på
teecup.teeoff.no(2026-07-16): ekteteecup_dbopprettet (migrasjoner 001→005 kjørt permanent,test_isolation.sqlbestår),Dockerfile+docker-compose.yml(tjenesteteecup_api, joiner det eksisterendeteeoff_default-nettverket), Caddy-blokk lagt til i/opt/teeoff/deploy/Caddyfile. Ekte innlogging (magic-link → e-post → JWT-sesjon medSecure-cookie) verifisert ende-til-ende mot den live stacken.teeoff.noupåvirket gjennom hele prosessen. To reelle hendelser underveis, begge løst:- Caddy plukket ikke opp filendringen —
teeoff_caddysinCaddyfile-mount er en ENKELTFIL-bind-mount, låst til inoden som fantes da containeren sist startet. Min fil-redigering (atomisk rename) laget en ny inode på samme sti, så containeren fortsatte å lese den GAMLE filen uansett hvor mange gangercaddy validate/caddy reload/admin-API/loadble kjørt (alle validerte/lastet den uendrede gamle filen, derav ingen feilmelding). Løst med en fulldocker restart teeoff_caddy(brukeren bekreftet — avvek fra planens "kun graceful reload, ingen omstart"-løfte, noen sekunders nedetid forteeoff.no). - Alvorlig nettverksalias-kollisjon (funnet RETT ETTER omstarten, da
ekte teeoff-trafikk som
/api/facilities?...med ekte klubb-slugs dukket opp iteecup_apisin logg):docker-compose.ymlsin service-nøkkel varapi:— SAMME nøkkel som teeoffs egetapi-servicenavn (docker-compose.prod.yml). Docker Compose registrerer nettverksalias basert på service-NAVNET (ikke barecontainer_name) på delte nettverk, så BEGGE containerne fikk aliasapipåteeoff_default— Caddysreverse_proxy api:8000i teeoff sin egen config kunne da tilfeldig treffe enten ekteteeoff_apiellerteecup_api. Rettet umiddelbart (stoppetteecup_apiførst for å hindre videre feilruting av ekte teeoff-trafikk, ga service-nøkkelen navnetteecup_apii stedet, gjenopprettet — bekreftet meddocker network inspectat aliasapinå KUN peker på ekteteeoff_api). Mindre driftslærdom: (a) jeg eksponerte ved et uhellTEECUP_SMTP_PASS/TEECUP_FROM_EMAILi eget debug-output mens jeg feilsøkte en.env-korrupsjon (manglende linjeskift fra min egen>>-tilføyelse) — brukeren roterte passordet som forsiktighetsregel; (b) Docker leser IKKE.envpå nytt for en allerede kjørende container —docker compose up -d --force-recreatekreves etter enhver.env-endring som skal tas i bruk; (c) et#-tegn i et upassordet.env-passord kuttes som en kommentar av Compose sin parser — anførselstegn (fortrinnsvis enkle) løser dette.
- Caddy plukket ikke opp filendringen —
-
Dato/klokkeslett + feilkode-kontrakt + i18n-forberedelse (2026-07-17, ADR-015): reist av brukeren rett før frontend-arbeidet. Ny migrasjon
006_scheduling_and_locale.sql(alt additivt):tournament.end_date,session.scheduled_at/tee_interval_minutes/start_hole,match.tee_time_override,app_user.preferred_locale,magic_link_token.locale.match.tee_timeer UTLEDET i Python (scheduled_at + (sequence-1)*tee_interval_minutes, override vinner hvis satt) — aldri lagret per match. Full retrofit av ALLE 39 daværendeHTTPException(..., detail="norsk streng")-steder på tvers av 6 filer til en deltapp_error(status_code, code, message)-factory (app/errors.py) — responsformen er nå konsekvent{"detail":{"code":...,"message":...}}i hele API-et, verifisert med et sistegrep -rn 'detail="' app/som ga NULL treff. i18n:locale(nb/en) sendes av klienten vedrequest-link, styrer e-postmalen (ekte engelsk mal lagt inn iapp/email.py, ikke bare rørlegging) OG settes som en HELT NY brukerspreferred_locale— en eksisterende bruker som logger inn på et annet språk får IKKE sin lagrede preferanse overskrevet. Fant og fikset underveis:tournament.start_datehar ligget i skjemaet siden migrasjon 001, men var ALDRI koblet tilTournamentCreate/Tournament-modellene — funnet som en naturlig bivirkning av å legge tilend_date. Verifisert grundig mot ferskteecup_scratch(001→006,test_isolation.sqlfortsatt 12/12): feilkode-form bekreftet på tvers av 5 filer (NOT_FOUND/LIMIT_REACHEDtournaments.py,DUPLICATEroster,NOT_AUTHENTICATEDuten cookie,NOT_ROSTERED_ON_TEAMmatches.py), tee_time-beregning bekreftet (10 min intervall → 08:00/08:10/08:20, override vinner,scheduled_at=nullgirtee_time:nullikke feil), full i18n-runde bekreftet (ny brukerlocale:"en"→preferred_locale:"en"; påfølgenderequest-linkfor samme bruker medlocale:"nb"skiftet e-postmalen men IKKE den lagrede preferansen, bekreftet via/auth/me). Kjørt mot ekteteecup_db2026-07-17 (bruker bekreftet eksplisitt i samme økt): migrasjonen kjørte rent,test_isolation.sqlfortsatt 12/12 (ruller alltid tilbake, ingen domenerader berørt). Mindre driftslærdom, funnet OG rettet samme runde: et.env-filter (grep -v -i 'pass|secret|key') jeg brukte for å lese ikke-sensitive nøkler fanget ikke oppTEECUP_DATABASE_URL, som barteecup_app- passordet innebygd i selve URL-en (i tillegg til at det SAMME passordet allerede lå rent iTEECUP_APP_PASSWORD— duplisert, ikke bare skjult) — passordet ble dermed synlig i et verktøyresultat. Flagget til brukeren umiddelbart (samme mønster som SMTP-passord-hendelsen over). -
.env/tilkobling ryddet opp (2026-07-17), samme runde: roten til hendelsen over var atTEECUP_DATABASE_URLvar én sammensatt DSN-streng med passordet URL-kodet inni — usynlig for navnebaserte secret-filtre. Erstattet med fem separate, rent navngitte felt:TEECUP_DB_HOST/TEECUP_DB_PORT/TEECUP_DB_NAME/TEECUP_DB_USER/TEECUP_DB_PASS(sistnevnte omdøpt fraTEECUP_APP_PASSWORD, kun nøkkelnavnet — verdien aldri lest eller skrevet av meg).app/config.pyogapp/db.pybygger nåasyncpg-poolen fra disse fem separate feltene (host=/port=/user=/password=/database=) i stedet for én DSN — fjerner også URL-prosentkoding-problemet fra SMTP-passord-hendelsen sin klasse av feil.docker-compose.ymlsinenvironment:-liste oppdatert tilsvarende. Krevde et fullt image-rebuild, ikke bare--force-recreate:DockerfilesinCOPY app/ app/bakes inn i imaget ved build-tid (ingen bind-mount i prod, i motsetning til scratch-verifiseringens engangscontainere) — en ren--force-recreategjenbrukte det GAMLE imaget og krasjet umiddelbart på den nå fjernedeTEECUP_DATABASE_URL. Rettet meddocker compose up -d --build --force-recreate. Verifisert ende-til-ende mot den live stacken: containeren boot-et rent (Application startup completei loggen, som krever en vellykketinit_pool()— asyncpg ville kastet og forhindret akkurat den logglinjen ved feil tilkoblingsparametre),/auth/meover ekte https ga et rent401 NOT_AUTHENTICATED(ikke 500/502),teeoff.noupåvirket (200gjennom hele omstarten, kunteecup_apirestartet — ikke delt Caddy-instans, ikke samme risikoklasse som Caddy-hendelsen fra containeriseringsrunden). -
Frontend startet, innlogging LIVE (2026-07-17, ADR-016): første frontend-skjerm i prosjektet. Designet i V0 (Next.js + Tailwind + shadcn/ui), hentet inn som
frontend/— merkevare-form/farge fra Teeoff-logoen, IKKE navn/logo (egne, separate produkter, se ADR-009). Kvalitetsrunde før bruk: V0s fargetokens var OKLCH-TILNÆRMINGER, ikke eksakte — regnet ut presise verdier fra#8bc24a/#ff5722og rettet alle 6 forekomster iglobals.css. Fjernet@vercel/analytics(unødvendig på egen-hostet infra), fjernettypescript: { ignoreBuildErrors: true }(ekte typesjekk kjører nå), fjernet dødtpnpm.overrides-felt.frontend/.gitignoremanglet.pnpm-store/— årsaken til at brukerens VSCode viste 10 000 "ukjente" filer ved første commit-forsøk; rettet. Kablet mot ekte API:next.config.mjssinrewrites()proxyer/auth/*//orgs/*//healthserver-side tilteecup_api— same-origin, ingen CORS, cookie uendret (full begrunnelse i ADR-016). Login-skjermet sender ektePOST /auth/request-link; ny/verify-side mottar?token=...fra e-postlenken (auto-verifiserer) eller viser et manuelt "lim inn koden"-felt.app/email.pyfikk en nyPUBLIC_BASE_URL- innstilling og sender nå en EKTE klikkbar lenke (koden beholdes som fallback). Reell fallgruve funnet og fikset ved containerisering: Next.js sinrewrites()løses ved BUILD-tid foroutput: "standalone", ikke ved container-oppstart — en runtime-e TEECUP_API_ORIGIN=...ble stille ignorert (proxy-kall feilet medECONNREFUSEDmotlocalhost:8000). Løst med en Docker build-timeARG TEECUP_API_ORIGINifrontend/Dockerfile, satt viadocker-compose.ymlsinbuild.args. Rullet ut live: nyteecup_frontend-tjeneste idocker-compose.yml. Caddy (teecup.teeoff.no, i det SEPARATEteeoff-repoet,/opt/teeoff/deploy/Caddyfile) endret fra å peke direkte påteecup_apitil å peke påteecup_frontend— samme stale-inode-oppførsel som containeriseringsrunden (gracefulreloadplukket IKKE opp endringen,/fortsatte å giteecup_apisin egen 404 i stedet for innloggingssiden til reload faktisk skjedde). Løst likt: fulldocker restart teeoff_caddy, brukeren bekreftet eksplisitt på forhånd.teeoff.noupåvirket gjennom hele omstarten. Verifisert med FAKTISK e-postlevering: ekte magic-link sendt til brukerens egen adresse overhttps://teecup.teeoff.no, ekte e-post mottatt med en ekte klikkbar lenke, åpnet i nettleser, landet på en fungerende/verify-side, sesjon opprettet — brukeren bekreftet innlogget status. Første gang en hel bruker-vendt flyt er bevist ende-til-ende i produksjon, ikke bare API-et isolert. Merk for neste økt:deploy/Caddyfile-endringen ligger uncommitted i det SEPARATE/opt/teeoff-repoet, ikke iteecup-repoet — lett å glemme siden denne økten ellers kun har jobbet i/opt/teecup. -
Dashboard-skjerm LIVE (2026-07-18): andre V0-skjerm — organisasjon- bytter/-opprettelse + turneringsliste (
/dashboard), samme mønster som login-runden. Reell integrasjonsfelle unngått: V0s eksport denne gangen var en FULL re-eksport av hele prosjektet (inkl.login-form.tsx,next.config.mjs,package.json), ikke bare de nye filene — en naiv utpakking ville stille reversertrewrites()-proxyen,output: "standalone", den ekte fetch-kablingen i login-skjemaet, og alle V0-uavhengige opprydninger fra forrige runde. Løst ved å pakke ut til et scratch-område FØRST, diffe mot live-treet fil for fil, og kun ta inn det som faktisk var nytt (dashboard.tsx,tournament-card.tsx,tournament-status-badge.tsx,wordmark.tsx,badge.tsx,dropdown-menu.tsx,app/dashboard/page.tsx) —next.config.mjs,package.json,globals.css, Docker-filene ble bevisst IKKE overskrevet.login-form.tsxfikk en kirurgisk patch (kun Wordmark flyttet til egen fil, som V0 selv hadde gjort — all egen fetch-/feilhåndteringslogikk urørt).dashboard.tsxsitt datalag skrevet om fra bunnen (V0 leverte kun mockuseState): henter/auth/mefor organisasjonsmedlemskap,/orgs/{id}/tournamentsper valgt org,POST /orgs/POST /orgs/{id}/tournamentsfor opprettelse,POST /auth/logoutfor utlogging — presentasjonskomponentene (kort, bytter, tomme tilstander) beholdt uendret fra V0./verify-siden oppdatert til å sende brukeren videre til/dashboardetter vellykket innlogging (fantes ingen dit å gå før nå). Verifisert: ekte typesjekket build, redeploy av kunteecup_frontend(ingen Caddy-endring nødvendig denne gangen — ADR-016s mønster holder),teecup.teeoff.no/dashboard→ 200,teeoff.noupåvirket. Skrive-flyten bekreftet med EKTE data samme dag (brukeren testet selv, ikke meg): organisasjon "Tjøme Gents" og turnering "De Gamle er Eldst" opprettet via UI-et mot den ekteteecup_db— statusmerket viste riktig "Utkast", "Ingen datoer satt" håndtert korrekt (ingen krasj på manglende dato), ett-org-visningen viste riktig uten unødvendig bytter-UI. Første gang en HEL skrive-flyt (ikke bare lesing) er bevist ende-til-ende fra frontend mot ekte produksjonsdata. -
Lag/roster-skjerm LIVE (2026-07-18): tredje V0-skjerm (
/tournaments/[id]), samme re-eksport-mønster som dashboard-runden — diffet mot live-treet, tok kun inntournament-detail.tsxog etLink-baserttournament-card.tsx(navigasjon fra dashbordet). URL-design bevisst avvikende fra V0s forslag: V0s genererte side leste aldriparams.idog hadde ingen organization_id i det hele tatt — holdt derfor V0s flate/tournaments/[id]-struktur (i stedet for en nøstet/orgs/[orgId]/tournaments/[id], som ville krevd manuell ombygging ved HVER fremtidig V0-reeksport) og laorg+nametil som søkeparametre itournament-card.tsxsin lenke — API-et krever organization_id på alle team-/roster-kall (RLS). Reelt hull funnet FØR integrering, ikke etter: V0-skjermen bygger inn "fjern spiller"/"gjør til kaptein"-handlinger, men backend hadde KUN GET/POST påteam_roster— ingen DELETE eller PATCH. Spurte bruker eksplisitt (samme mønster som andre scope-avklaringer denne økten) — svar: bygg de to endepunktene nå. Lagt til iapp/routers/tournaments.py:PATCH .../roster/{roster_id}(bevisst enkel — setter/fjerneris_captainpå NØYAKTIG denne raden, håndhever IKKE "kun én kaptein per lag", siden kaptein fortsatt bare er et merke, ikke en egen autorisasjonsrolle) ogDELETE .../roster/{roster_id}(204, idempotentNOT_FOUNDved dobbel sletting — ikke krasj).tournament-detail.tsxsitt datalag skrevet om fra V0s mock: henter lag + roster (roster-radene bærer allerededisplay_name/handicap_index_snapshotfra APIet, så V0s separatepoolById-oppslag ble fjernet som overflødig) og organisasjonens spillerpool (GET /orgs/{id}/players, brukt til type-ahead ved "legg til spiller"). Alle fem mutasjonene (opprett lag, legg til eksisterende spiller, opprett ny spiller inline + rostre, endre kaptein, fjern fra roster) kablet mot ekte endepunkter — presentasjonskomponentene (kort, type-ahead, fargevelger, bekreft-fjerning) beholdt uendret fra V0. Verifisert: de to nye endepunktene testet mot en ferskteecup_scratch(PATCH setter kaptein + riktigNOT_FOUNDpå ugyldig id, DELETE gir 204 + idempotentNOT_FOUNDved gjentak,test_isolation.sqlfortsatt 12/12), ekte typesjekket frontend-build (5 ruter), redeploy av BEGGE containere (backend-endepunktene er nye),teecup.teeoff.no/dashboard→ 200,teeoff.noupåvirket. Selve skrive-flyten på/tournaments/[id](opprett lag/roster) ikke testet med ekte data i denne runden — venter på brukeren, samme mønster som dashboard-rundens skrive-test. -
ADR-017 + migrasjon 007 (2026-07-18): brukeren reiste selvregistrering rett etter at roster-skrive-flyten var bekreftet. Full ADR skrevet (5 beslutninger: offentlig påmelding uten innlogging, e-post som sammenkoblingsnøkkel mot forhåndsopprettede spillere, egen
tournament_registration-tabell atskilt frateam_rostermed konfigurerbar godkjenning/kapasitet/venteliste, utvidet spillerprofil + obligatorisk samtykke, ogpublic_tournament_org()). Migrasjon007_registration_and_player_fields.sqlskrevet og scratch-verifisert (001→007 kjører rent,test_isolation.sqlfortsatt 12/12). Reelt arkitekturproblem løst underveis, ikke bare skjema: et offentlig (uautentisert) påmeldingskall kjenner en turnering-id, men ingen org-kontekst — og utenapp.current_orgslipper RLS ingen rader gjennom, heller ikke oppslaget for å FINNE riktig org. Løst med en sneverSECURITY DEFINER-funksjon (public_tournament_org) som KUN eksponerer uuid→uuid-koblingen. Verifisert presist, ikke bare "kjørte uten feil": kalt funksjonen somteecup_app-rollen med ingenapp.current_orgsatt — ga korrekt org-id for en kjent turnering,NULL(ikke feil) for en ukjent — OG et RÅTTSELECTpåtournamentpå SAMME tilkobling/rolle ga fortsatt 0 rader, som beviser RLS ikke er brutt generelt, bare dette ene smale unntaket eksisterer. Kjørt mot ekteteecup_db2026-07-18 (bruker bekreftet eksplisitt i samme økt): migrasjonen kjørte rent,test_isolation.sqlfortsatt 12/12. -
Registrerings-API LIVE (2026-07-18), samme dag: ny
app/routers/registration.py—GET /public/tournaments/{id}ogPOST /public/tournaments/{id}/register, begge UTENget_current_userellerget_authorized_org(helt uautentisert, egen/public-prefiks, bevisst atskilt fra/orgs/...i koden). Brukerpublic_tournament_org()(migrasjon 007) til å slå opp org-kontekst FØR RLS kan håndheve noe.app/routers/players.pyutvidet med alle sju nye ADR-017-feltene (mobile/email/birth_date/nickname/country/club/club_member_number).frontend/next.config.mjssinrewrites()utvidet med/public/*(ADR-016s konsekvens: enhver ny API-prefiks MÅ inn her). Ny brukers-oppdaget notat fanget FØR bygging, ikke etter: brukeren krevde eksplisitt at synlighet (offentlig/kun org/kun turnering- deltakere) må være et VALG for fremtidige landingssider — notert grundig iFEATURE_BACKLOG.md(koblet til samme åpne spørsmål for "Banter Board"-feeden) FØR dette registrerings-API-et ble bygget, akkurat for at det ikke skal gå i glemmeboken til landingsside-runden. Verifisert grundig mot ferskteecup_scratch(001→007,test_isolation.sql12/12): hele registreringsløpet testet reelt — samtykke-avvisning (400), duplikat-avvisning (409DUPLICATE), e-post-matching mot en organisator-forhåndsopprettet spiller (BEKREFTET: ingen duplikatrad, mobil fylt inn viaCOALESCE,display_nameIKKE overskrevet), kapasitet+waitlist-policy (→waitlisted), kapasitet+closed-policy (→ 409LIMIT_REACHED),registration_ requires_approval(→pending), utløpt frist (→ 409REGISTRATION_CLOSED), ogconfirmed_countiGET-responsen talt riktig (kunconfirmed+pending, ikkewaitlisted/avviste). Rullet ut live: begge containere redeployet,teecup.teeoff.no/ dashboardog/healthfortsatt 200,teeoff.noupåvirket, det offentlige endepunktet bekreftet nåbart over ekte https (ukjent turnering-id ga korrekt404/NOT_FOUND, ikke-destruktiv sjekk — selve påmeldingsflyten med ekte data ikke testet mot prod i denne runden). E-post-basert kontosammenkobling LIVE, samme dag: ny migrasjon008_link_player_by_email.sql—link_player_by_email(user_id, email), sammeSECURITY DEFINER-mønster sompublic_tournament_org()(007), denne gangen for en tverr-org UPDATE i stedet for et lese-oppslag.verify_magic_link(app/routers/auth.py) kaller den på HVER innlogging (idempotent — funksjonensWHERE user_id IS NULLgjør gjentatte kall til en no-op), ikke bare ved førstegangsopprettelse. Verifisert presist: to separate org-er, hver med sin egen organisator-opprettede "Kari"-rad (samme e-post, ulik store/små bokstaver for å teste case-insensitivitet også) — ved Karis FØRSTE innlogging ble BEGGE radene koblet til kontoen hennes, i to org-er hun aldri har vært medlem av. Eksplisitt bekreftet:organization_membershiphar NULL rader for henne etterpå — ren identitetskobling, ingen privilegie-eskalering (å haplayer.user_idsatt gir ingen ny tilgang gjennomget_authorized_org, som fortsatt krever ekte org-medlemskap uavhengig av dette). Andre innlogging idempotent, ingen feil.test_isolation.sqlfortsatt 12/12. Kjørt mot ekteteecup_db2026-07-18, bruker bekreftet eksplisitt, backend redeployet, live sjekker OK,teeoff.noupåvirket. ADR-017s backend er dermed komplett (registrering + kontokobling). Gjenstående: frontend-påmeldingsskjema og landingssider — egen, senere ADR-runde (seFEATURE_BACKLOG.md). -
ADR-018 + migrasjon 009: landingssider, backend LIVE (2026-07-18), samme dag: trenivås synlighet (
tournament.visibility:public/org/participants, defaultorg— trygg standard) +organization.public_profile. Reell presisering funnet underveis, ikke antatt på forhånd: RLS (org_isolation) beskytter kun TENANT-grenser (org A ser aldri org B), IKKE innholds-synlighet innenfor riktig org-kontekst — det eksisterendeGET /public/tournaments/{id}(ADR-017) leste allerede fullt innhold uten synlighetssjekk, fordi RLS er fornøyd så snart org-konteksten er satt, uansett hvem som spør.visibilityhåndheves derfor eksplisitt iapp/routers/registration.py, på BÅDE lesing og registrering (ADR-018 Beslutning D: kan du ikke se turneringen, kan du heller ikke melde deg på den — bekreftet med bruker FØR bygging). Nyget_current_user_optionaliapp/auth.py(somget_current_user, men returnererNonei stedet for 401 — offentlige endepunkter skal fungere for anonyme lesere også). Ny "deltaker"-autorisasjonsvei: en innlogget bruker medplayer.user_idkoblet (ADR-017) OG entournament_registration- ellerteam_roster-rad for NØYAKTIG den turneringen får separticipants-synlige turneringer, uansett org-medlemskap. Ekte migrasjonsfeil funnet OG rettet UNDER scratch-verifisering, ikke antatt riktig: migrasjonen feilet først ("column slug already exists") —organization.slughar ligget i skjemaet siden migrasjon 001 ("f.eks. subdomene/URL-vennlig", allerede med en plainUNIQUE), noe jeg hadde oversett fullstendig og forsøkt å legge til på nytt. Rettet ved å fjerne den dobleADD COLUMN+ den overflødige partielle unik-indeksen (001 sin plainUNIQUEdekker "unik når satt" allerede, siden Postgres behandler NULL som distinkt), beholde kun de nyeCHECK-constraintene. Kjørte rent på ny etter fiksen. Lærdom: grep alltid eksisterende skjema for feltnavn FØR en ny migrasjon skrives, ikke bare stol på hukommelsen om hva som "sikkert" ikke finnes fra før. Ny tabelltournament_sponsor(navn+lenke aktivt,logo_keyinert til MinIO-runden — samme medtournament.hero_image_key). TredjeSECURITY DEFINER-bro i prosjektet:public_org_by_slug()(etterpublic_tournament_org007,link_player_by_email008) — returnererNULLfor BÅDE "finnes ikke" og "finnes, men er privat", samme anti-enumerering som magic-link. Fylte også et implisitt hull oppdaget underveis: ADR-en beskrev hvordan synlighet skulle håndheves, men ingen tidligere runde hadde bygget noen vei for organisator til faktisk å SETTE disse feltene. Lagt til:PATCH /orgs/{id}/tournaments/{id}(visibility/description/ registrerings-innstillinger, ekte PATCH-semantikk via Pydantic sinexclude_unset— et utelatt felt nullstilles IKKE),PATCH /orgs/{id}(slug/public_profile), full sponsor-CRUD._fetch_sessions()trukket ut som delt hjelpefunksjon itournaments.py(delt mellom den innloggede og den nye offentligeGET /public/tournaments/{id}/sessions— blind draw-hemmelighold, ADR-013, arves automatisk, ikke reimplementert). Verifisert grundig mot ferskteecup_scratch(001→009,test_isolation.sql12/12): hele synlighetsmatrisen testet med ekte HTTP-kall — anonym avvist påorg-synlig turnering (både lesing OG registrering),PATCHtilpublic+ beskrivelse + sponsor fungerte, anonym lesing fungerte deretter,participants-synlighet bekreftet reell chicken-and-egg-konsekvens av Beslutning D (ingen kan selv- registrere seg til enparticipants-synlig turnering, kun organisator kan legge til direkte — korrekt, ikke en bug), en organisator-rostret spiller som logget inn fikk tilgang, en tilfeldig innlogget FREMMED (ikke deltaker) ble fortsatt avvist, org-landingsside viste KUNpublic-synlige turneringer,CHECK-constraint (public_profilekreverslug) avvist korrekt, ugyldig slug-format avvist av Pydantic, sponsor-sletting fungerte. Kjørt mot ekteteecup_db2026-07-18, bruker bekreftet eksplisitt, backend redeployet, live sjekker OK,teeoff.noupåvirket. Ingen frontend-endring nødvendig for selve API-tilgangen (det brede/public/:path*-mønsteret fra ADR-016 dekker allerede/public/orgs/*). Gjenstår: selve landingsside-SKJERMENE i frontend (V0), og MinIO/bildeopplasting — bevisst utsatt, egen runde. -
Offentlig turnering-landingsside LIVE (2026-07-18), samme dag: fjerde V0-skjerm (
components/public-tournament.tsx, ny rute/t/[id]) — banner (bevisst permanent farge-/gradient-utseende, ikke en "bilde kommer"-plassholder), presenterende tekst, status (datoer + "X av Y plasser"), program, sponsorer (navn+lenke), og et påmeldingsskjema med navn+e-post synlig først og resten bak en "flere detaljer"-utvidelse — tre distinkte bekreftelsestilstander (bekreftet/venteliste/godkjenning venter), ikke én generisk "takk". Ingen ny reeksport-kollisjon denne gangen — kun étt genuint nytt filnavn (public-tournament.tsx), resten var kjent V0-revert av allerede-tilpassede filer, samme mønster som før. V0 opprettet komponenten, men ingen rute — la selv tilapp/t/[id]/ page.tsx(bevisst en FLAT/t/[id]-sti, ikke nøstet under/orgs/...som den innloggede turnering-detalj-siden, siden det offentlige API-et kun trenger turnering-id, ikke org-id). Datalaget skrevet om fra V0s mock: ektefetchmotGET /public/tournaments/{id}+/sessions, ektePOST .../register. Håndterer 403 (NOT_VISIBLE, ADR-018) og 404 med en egen tilgang-avvist- tilstand V0 ikke hadde bedt om (fantes ikke i prompten, men trengs for at siden faktisk skal fungere fororg/participants-synlige turneringer). Mappetstatus:"waitlisted"fra API-et til komponentens"waitlist", og skjemaets norske kjønnsvalg ("kvinne"/"mann"/"annet") til API-ets^[mfx]$-mønster — to reelle navnekollisjoner mellom V0s UI-språk og API-kontrakten, ikke bare et rett-frem felt-for-felt-uttrekk. Reell driftsfeil funnet OG rettet under scratch-test, ikke i produksjon:pnpm install(uten--ignore-scripts) i dev-server- testoppsettet feilet stille med tom logg og exit 1 — corepack hadde hentet en NY pnpm-versjon (11.13.1 → 11.14.0) siden sist, som gjør "ignored builds"-varselet til en hard feil i stedet for bare en advarsel. Rettet ved å bruke samme--ignore-scripts-flagg somfrontend/Dockerfileallerede bruker (upåvirket av denne — bekreftet ved at selve prod-buildet fortsatt gikk rent). Lærdom:Dockerfilesin pinning av kode er ikke det samme som å pinne verktøyene rundt (corepack henter alltid siste pnpm) — verdt å huske neste gang et scratch-dev-server-oppsett plutselig feiler uten åpenbar grunn. Verifisert grundig mot ferskteecup_scratch+ en ekte kjørende frontend-dev-server (ikke barenext build): ekte turnering med beskrivelse, kapasitet, sponsor og økt opprettet via API-et, hentet gjennom frontend-proxyen (ikke direkte mot backend) og bekreftet byte-for-byte riktig — inkludert en ektePOST-registrering som økteconfirmed_countfra 0 til 1. Rullet ut live, kunteecup_frontend(ingen backend-endring denne runden),teeoff.noupåvirket. Gjenstår: org-landingssiden (egen V0-prompt), Open Graph-metadata for deling, MinIO/bilder. -
Offentlig klubb-landingsside LIVE (2026-07-18), samme dag: femte og siste V0-skjerm i ADR-018 (
components/public-club.tsx, ny rute/clubs/[slug]). Samme banner-språk som turnering-siden, liste over klubbens turneringer (gjenbrukte eksisterendeTournamentCard), egen tom- tilstand. Reell delt-komponent-kollisjon løst, ikke duplisert bort:TournamentCardvar bygget for KUN den innloggede konteksten (krevdeorgId, lenket til/tournaments/{id}?org=...). I stedet for en egen kopi av kortet for den offentlige siden, gjortorgIdvalgfri — satt (dashbordet) gir innlogget lenke, utelatt (klubbsiden) gir/t/{id}i stedet. Samme kort, to kontekster, ingen duplisering. Bekreftet dashbordets egen bruk uendret/upåvirket etterpå. V0 opprettet denne gangen selv en rute (app/clubs/[id]/page.tsx, uten noen props sendt inn i det hele tatt) — men navnga parameteren[id]selv om den faktisk er en SLUG (public_org_by_slug(), ADR-018). Skrev selv en ny, riktigapp/clubs/[slug]/page.tsxi stedet for å bruke V0s (feilnavngitte og prop-løse) versjon. Verifisert mot ferskteecup_scratch+ ekte kjørende frontend-dev- server: org med slug+public_profile, én turnering sattpublic, én latt stå på defaultorg— klubbsiden viste GJENNOM frontend-proxyen kun den ene offentlige turneringen, den org-private var korrekt usynlig (samme filtermønster som API-et selv, bekreftet fra klientsiden også). Ukjent slug ga korrekt 404. Rullet ut live, kunteecup_frontend,teeoff.noupåvirket. ADR-018s planlagte skjermer er dermed komplette. Gjenstår: Open Graph-metadata for deling, MinIO/bilder — begge bevisst egne, senere runder. -
Open Graph-metadata LIVE (2026-07-18), samme dag — ADR-018 dermed helt ferdig:
generateMetadata()lagt til på/t/[id]og/clubs/[slug](ekte tittel/beskrivelse fra API-et,og:site_name, trygg fallback-tittel ved ukjent id/slug — feil her skal ALDRI hindre selve siden i å laste). Reell driftsfeil funnet FØR den nådde produksjon, ikke etter:generateMetadata()kjører server-side ved REQUEST-tid, ikke i nettleseren — går derfor IKKE gjennomnext.config.mjssinrewrites()(som kun gjelder nettleser-trafikk inn til Next.js- serveren). Måtte derfor leseTEECUP_API_ORIGINdirekte, men den variabelen fantes KUN iDockerfilesitt builder-steg —ENVsatt i ettFROM-steg arves ikke til et senere. Rettet ved å sette sammeARG/ENVpå nytt i runner-steget også. Verifisert presist at fiksen faktisk virker, ikke bare at bygget gikk gjennom: bygget det EKTE produksjonsimaget (ikke dev-server) pekt mot en scratch-backend med en ekte offentlig turnering+org, hentet den faktiske server-rendrede HTML-en og bekreftet ekte<title>/og:title/og:description— ikke bare at TypeScript kompilerte. Ukjent turnering-id ga korrekt trygg fallback-tittel. Bevisst utenfor omfang:og:image— ingen ekte bilde finnes ennå (MinIO-runden). La tilmetadataBaseiapp/layout.tsxnå likevel, som forarbeid slik at et fremtidig relativt bilde-URL løses riktig uten en egen fiks da. Rullet ut live, kunteecup_frontend,teeoff.noupåvirket. -
MinIO-runden LIVE (2026-07-18), samme dag — ADR-018 dermed HELT ferdig, ingenting utsatt igjen: ny
teecup-minio-tjeneste (persistent volum, genererte credentials i.env), backend-endepunkter for ekte bildeopplasting tiltournament.hero_image_key/tournament_sponsor. logo_key(som lå inerte siden migrasjon 009), offentlige API-svar bygger nå fulle URL-er,og:imagekoblet på i/t/[id]singenerateMetadata. Sent, men viktig presisert krav underveis: brukeren avbrøt en verktøyskall midtveis for å presisere at ALLE bilder skal konverteres til AVIF for plassbesparelse. Snudde HELE opplastingsarkitekturen på dette: droppet den opprinnelige planen om presignerte URL-er (nettleser laster opp DIREKTE til MinIO) til fordel for ekte multipart-opplasting GJENNOM API-et, som konverterer til AVIF (Pillow + pillow-avif-plugin) FØR lagring. Dette forenklet arkitekturen betydelig: kun ÉN MinIO-klient trengs nå (før: to separate klient-oppsett for henholdsvis internt admin-arbeid og offentlig presignering), og Caddy sin nye rute trenger ikke lenger bevare Host-headeren presist (relevant kun for SigV4- signaturverifisering av presignerte URL-er, ikke for anonym public-read). To reelle feil funnet UNDER scratch-verifisering, aldri i produksjon: (1)pillow-avif-pluginkrever ingen ekstra systempakker ipython:3.12-slim-- verifisert med et frittstående encode/decode- rundtrip FØR det ble tatt i bruk i selve API-et. (2) MinIO validererHost-headeren STRENGT og avviser understrek som ugyldig vertsnavn -- et tjenestenavn med understrek (teecup_minio, konsistent medteecup_api/teecup_frontend) feilet umiddelbart ved oppstart ("Invalid Request (invalid hostname)"). Bekreftet presist ved å teste samme oppsett med bindestrek i stedet (teecup-minio) -- fungerte umiddelbart. Alle referanser rettet til bindestrek FØR noe ble forsøkt mot ekte infrastruktur. Caddy: ny/teecup-media/*-rute på det EKSISTERENDEteecup.teeoff.no-blokket (IKKE et nytt subdomene -- en tidlig sjekk avdekket atmedia.teecup.teeoff.nofantes som en wildcard DNS-post, men pekte til en IPv6-adresse denne serveren ikke har i det hele tatt; path-prefiks på et allerede fungerende domene unngikk hele den DNS- avhengigheten). Samme stale-inode-oppførsel som alle tidligere Caddy- runder -- fulldocker restart teeoff_caddy, brukeren bekreftet eksplisitt.teeoff.noupåvirket. Verifisert grundig, i flere lag: frittstående AVIF-encode/decode- test, full scratch-kjede (fersk Postgres + en ISOLERT scratch-MinIO- container) med et ekte opplastet bilde -- bekreftet konvertert til gyldig AVIF (800×400, 406 bytes for et helfarget testbilde), bekreftet lagret med riktig nøkkel, bekreftet lesbart ANONYMT direkte mot MinIO (uten Caddy, isolerer bucket-policyen), bekreftethero_image_url/logo_urlbygget riktig i det offentlige API-svaret. Alle tre valideringsveier testet (ugyldig content-type, korrupt bildeinnhold, for stor fil >8MB) -- alle ga korrektVALIDATION_FAILED. Etter Caddy-omstart: et ekte anonymt kall mot/teecup-media/...på produksjonsdomenet ga en ekte MinIO S3-XML-feilrespons (NoSuchKeyfor en scratch-nøkkel som naturligvis ikke finnes i prod) -- beviser ruten treffer MinIO selv, ikke frontend sin egen 404-side.test_isolation.sqlfortsatt 12/12 gjennom hele runden. Bevisst utenfor omfang: ingen faktisk opplasting av et EKTE bilde til en EKTE, live turnering i denne runden (ville krevd å skrive test-data i brukerens ekte konto uten å bli spurt) -- tilbudt, ikke utført. Selve dra-og-slipp-opplastingsskjermen i frontend (V0) er fortsatt ikke bygget, som avtalt fra starten av runden. -
Program-skjerm (økter/tidsplan), bygget og SCRATCH-verifisert, IKKE live ennå (2026-07-18): sjette V0-skjerm, første i "bygg i rekkefølgen ting brukes"-serien (etter lag/roster: program → blind draw → scorekort → leaderboard).
components/tournament-program.tsx, ny rute/tournaments/[id]/program. Tidslinje over økter + opprett-skjema (format, hullomfang, scoringsmodus, poeng, klokkeslett+intervall, starthull, kollapsbar "avansert"-seksjon med ADR-014s fire brytere). Reelt blokkerende hull funnet FØR integrering:SessionCreate. course_ider påkrevd, men INGEN endepunkt kunne noensinne produsere en — ADR-004s teeoff-integrasjon er fortsatt bare vedtatt (ingen utgående HTTP-klient finnes). Spurte bruker eksplisitt — svar: bygg enkel course-CRUD nå. Nyapp/routers/courses.py(GET/POST /orgs/{id}/ courses, kunsource='custom'). Program-skjemaet fikk et type-ahead-felt for bane (samme mønster som spiller-type-ahead i roster-skjermen). Reell korrekthetsfeil rettet FØR integrering: V0-promptet mitt ba om ett generisk "Scramble"-valg, men skjemaetsCHECK-constraint oghandicap_engine.pysinFormat-enum kreverscramble_2/scramble_4som distinkte verdier -- ren"scramble"avvises med 400. Rettet i frontend-mappingen til to segment-knapper.allowance_override-JSON-formen verifisert eksakt motapp/handicap.pysinparse_allowance_config/_strategy_from_json({type: "combined"|"per_player", percentage: 0..1}, ikke en flat prosent) -- frontend velger riktigtypeut fra om formatet er side-enhet eller spiller-enhet, konverterer 0–100-skjemafelt til 0–1. Scratch-infrastruktur denne runden, bevisst forskjellig fra tidligere: brukte en ISOLERTteecup_app_scratch-rolle (GRANT teecup_app TO teecup_app_scratch) i stedet for den ekteteecup_app-rollen -- den er nå cluster-global og produksjonskritisk (delt Postgres-instans medteecup_db), så et eldre plandokuments "drop teecup_app-rolle"- opprydning (skrevet FØR go-live) er utdatert og ble bevisst IKKE fulgt. Egen isolert scratch-MinIO-container også (app-oppstart krever en nåbar MinIO forensure_bucket()). Verifisert: courses opprettet+listet, kryss-org-isolasjon bekreftet, økt med klokkeslett, økt medscramble_4+fullallowance_override- rundtur, gammel"scramble"-verdi avvist (400),test_isolation.sql12/12, ekte typesjekket PRODUKSJONSBUILD (sammeDockerfilesom faktisk deployes) kjørt og bekreftet. Diffet V0-eksporten mot live-treet FØR noe ble tatt inn (samme mønster som alle tidligere runder): kun tre reelt nye filer, resten forventede full-reverts, ikke rørt. Fjernet V0s dev-only forhåndsvisnings-toggle; lagt til fanerad ("Lag og spillere" / "Program") i BEGGE skjermene siden V0 ikke visste om den andre når den ble generert i egen prompt. Rullet ut live 2026-07-18, bruker bekreftet eksplisitt:docker compose up -d --build teecup_api teecup_frontend(kun disse to,teecup- miniourørt). Verifisert: begge containere boot-et rent (Application startup complete, Next.jsReady),teecup.teeoff.no/healthog/dashboard→ 200,teeoff.noupåvirket (200). -
ADR-004 (teeoff-banedata) kartlagt, IKKE bygget (2026-07-18): brukeren påpekte rett etter program-skjerm-rullingen at ADR-004s teeoff- integrasjon fortsatt bare er vedtatt, ikke bygget (kun
source='custom'finnes). Kartlagt/opt/teeoff/backend/main.py(annet repo, kun lest):GET /api/facilities/{slug}(offentlig, INGEN auth/API-nøkkel) returnerer allerede alt teecup trenger —courses[].holes[](par,hcp_index= stroke index),courses[].tees[](name,cr_men/slope_men,cr_women/slope_women— kjønnsdelt WHS-rating). CORS-lista på teeoff- siden ekskluderer teecups origin, men er IRRELEVANT for et server-til- server-kall (kun nettleser-fetch rammes av CORS). Ingen dokumentasjon (README/OpenAPI) finnes for dette API-et i teeoff-repoet — kartleggingen over er basert på å lese koden direkte. Stabil identifikator:facilities. slug(f.eks.borregaard-golfklubb) — selve banen har kun en intern serial-id, ingen egen slug, såcourse.external_course_refmå bære facility-slug + bane-id sammen. Oppdatering samme dag: brukeren ba meg ta fatt på dette NÅ (bevisst sidesprang fra "bygg i rekkefølgen ting brukes"-planen — blind draw- skjermen er fortsatt neste steg i den planen ETTERPÅ, ikke droppet). Design besluttet og skrevet som ADR-019 (se ARCHITECTURE_DECISIONS.md): import (kopi) ved organisators eksplisitte valg, ikke live oppslag ved hver bruk — fryser data på importtidspunktet, samme reproduserbarhets- prinsipp som handicap-snapshotten (ADR-007). Server-til-server-kall (teecup_api→http://teeoff_api:8000, internt Docker-nettverk, ingen auth trengs). Ny migrasjon010(unikexternal_course_refper org, hindrer dupliserte importer). Se ADR-019 for alle fem delbeslutningene. Bygget, scratch-verifisert MOT EKTEteeoff_api(ikke en simulert respons — ekte HTTP-kall til den kjørende produksjonscontaineren, kun lesing): søkte opp "Borregaard" i teeoff sine 174 publiserte anlegg, hentet Borregaard Golfklubb sin hovedbane (18 hull, 4 tee-farger × kjønn), importerte den til en scratch-org — alle 18 hull med riktig par/stroke-index (1-18, unik), alle 8 tee/tee_rating-rader med riktig full_18 course/slope-rating verifisert direkte i databasen, opprettet deretter en ekte økt med den importerte banen somcourse_id(beviser hele veien til handicap-motoren fungerer, ikke bare selve importen). Reimport av samme bane korrekt avvist (409 DUPLICATE, migrasjon 010 sin indeks). Kryss-org-isolasjon bekreftet, ukjent teeoff-slug ga korrekt 404,test_isolation.sql12/12. Ekte typesjekket produksjonsbuild av frontend-utvidelsen (bane-søk i program-skjemaet: søk anlegg → velg bane → importer, samme UI-mønster som spiller-/bane-type-ahead ellers i appen). Rullet ut live 2026-07-18, bruker bekreftet eksplisitt: migrasjon 010 kjørt mot ekteteecup_db(kun én ny partiell unik-indeks, ingen eksisterende rader rørt), begge containere bygget+redeployet, live sjekker OK,teeoff.noupåvirket. "Bygg i rekkefølgen ting brukes"- planen gjenopptas nå — blind draw-skjermen er neste steg. Reell produksjonsbug funnet OG fikset samme dag, rapportert av bruker som faktisk brukte funksjonen: brukeren klikket seg korrekt via dashbord → turnering → Program-fane (bekreftet med skjermbilde + full klikk-sti, ikke gjettet), åpnet "Hent bane fra teeoff", søkte "Tjøme", og fikk feilmeldingen "Mangler organisasjon i lenken" — URL-en hadde da MISTET?org=...&name=.... Root-cause:OfficialCourseSearchsitt eget søke-<form onSubmit={runSearch}>var rendret INNICreateSessionCardsitt eksisterende<form onSubmit={handleSubmit}>-- nestede<form>-elementer er ugyldig HTML. Nettleseren slår sammen de to skjemaene i den faktiske DOM-en, så "Søk"-knappen submittet i praksis det YTRE økt-skjemaet som en ekte native side-navigasjon (GET til gjeldende sti, ingen navngitte felt => tom spørrestreng) -- dette vasket bort org-parameteren og landet brukeren på siden sin egen org-guard. Fikset ved å fjerne det indre<form>-elementet helt (vanlig<div>+ Enter-tast-håndtering på inputet +type="button"i stedet fortype="submit"på søkeknappen) -- gjør nestede skjemaer strukturelt umulig fremover for denne komponenten. Ekte typesjekket produksjonsbuild kjørt på nytt, kunteecup_frontendredeployet (ingen backend-endring). Lærdom for fremtidige skjermer: en ny søk-/underskjema-widget som skal plasseres INNI et eksisterende skjema (slik som denne bane-søk-widgeten ligger inni økt-opprett-skjemaet) må ALDRI være et eget<form>-- bruk<div>+ eksplisitt klikk-/Enter-håndtering. -
Organisator-overstyring i
team_authz.py, LIVE (2026-07-18): reist av brukeren rett før blind draw-skjermen skulle designes:app/team_authz.pysinuser_may_act_for_teamkrevde tidligere enteam_roster-rad med lenket bruker-konto — ingen vei for organisatoren til å låse/legge til deltakere/føre score hvis ingen spiller hadde logget inn ennå (vanlig tidlig i en turnering). Utvidet til også å godta org-eier/admin (organization_membership.role IN ('owner','admin')), på ETHVERT lag, ingen unntak for at organisatoren selv er rostret på motstanderlaget. Det unntaket ble bevisst vurdert og avvist (brukeren spurte selv om det, jeg anbefalte det opprinnelig, men vi kom sammen frem til at det ville skapt en verre låsning: er organisatoren spillende på Lag A og Lag B heller ikke har noen innlogget spiller, ville Lag B blitt helt låst ute) — TeeCup er et tillitsbasert klubb-/vennegjeng-verktøy, ikke en sikkerhetsgrense mot en fiendtlig organisator som uansett allerede ser begge lags fulle troppe-liste (blind draw skjuler kun selve kamp-paringen). Alle 5 kallsteder oppdatert (matches.py sin add_participant/lock_lineup, scoring.py sin submit_hole_score/ submit_hole_result). Verifisert grundig i scratch: org-eier uten roster kan nå låse BEGGE lag + føre score, en vanlig 'member'-rolle fortsatt blokkert (uendret), en rostret spiller fungerer uendret uavhengig av org-rolle.test_isolation.sql12/12. Ingen migrasjon (ren Python-endring) — kunteecup_apiredeployet,teeoff.noupåvirket. -
Tee-endepunkter bygget og LIVE (2026-07-18), rett før blind draw-skjermen: fant et hull som blokkerte selve blind draw-flyten:
match_participant. tee_ider påkrevd, men det fantes INGENGET-vei for å liste en banes tee-er (selv offisielt importerte baner har tee-rader, men ingenting eksponerte dem) OG egendefinerte («custom») baner har ALDRI hatt noen vei til å FÅ tee-er i det hele tatt — dette er ikke noe ADR-019 innførte, det var et hull som fantes fra før custom-baner ble lagt til i første omgang, bare usynlig til nå. Konsekvens før fiksen: en turnering satt opp på en manuelt navngitt bane kunne ALDRI få en ekte deltaker lagt til på noen match. Presisering (brukeren spurte eksplisitt): dette er IKKE noe som må løses i teeoff.no sin kode — egendefinerte baner er per definisjon baner teeoff ikke kjenner til, så dette er en ren teecup-intern funksjon, uavhengig av ADR-019-integrasjonen. NyGET/POST /orgs/{id}/courses/{id}/teesiapp/routers/courses.py.POSTavviser eksplisitt forsøk på offisielle baner (400VALIDATION_FAILED— de får tee-ene sine fra teeoff-importen, ikke manuelt). Kun full_18-rating dekket (samme begrunnelse som ADR-019 Beslutning D). Bevisst UTENFOR omfang denne runden, egen senere sak: hull-/stroke-index-data for egendefinerte baner (hole-tabellen forblir tom for custom-baner) — trengs for korrekt slagfordeling i SCORING-fasen (ADR-008), ikke i blind draw, så det løses naturlig når scorekort- skjermen bygges (samme "bygg i rekkefølgen ting brukes"-logikk). Verifisert grundig i scratch: tom tee-liste på fersk custom-bane, opprett+list tee på custom-bane, offisiell bane viser alle 8 importerte tee-er, manuell tee-opprettelse avvist på offisiell bane, og — den faktiske payoff-en — en deltaker lagt til en match på en custom-bane-økt for FØRSTE gang noensinne (POST .../matches/{id}/participantslykkes nå med en tee_id fra en nyopprettet custom-tee).test_isolation.sql12/12. Ingen migrasjon, kunteecup_apiredeployet,teeoff.noupåvirket. -
Blind draw-skjermen LIVE (2026-07-18): syvende V0-skjerm,
components/session-blind-draw.tsx, ny rute/tournaments/[id]/sessions/[sessionId]. To lag-kolonner, hver med sine matcher ("flights"), legg til/fjern spiller+tee per plass (antall plasser avhenger av format), lås-knapp med bekreftelse, avslørings-visning når begge lag har låst. Program-skjermens økt-kort er nå klikkbare inn hit. Datamodell tilpasset fra V0s mock til API-ets faktiske sett-modell: V0 designet faste, indekserte "Slot"-arrays (kontrollert skjema-state); API-et har verken PATCH påmatch_participanteller noen slot-indeks — kun opprett/slett av en løs deltaker-mengde per side. Løst med en "legg til spiller"-inline-form (samme mønster som spiller-/bane-type-ahead ellers i appen) i stedet for faste dropdown-rader; funksjonelt likeverdig, strukturelt riktigere for API-ets faktiske form. To reelle hull funnet og fikset FØR/UNDER integrering:- Ingen
DELETEfantes formatch_participant— en kaptein kunne aldri angre et valg før låsing uten å etterlate en foreldreløs rad. NyDELETE /orgs/{id}/matches/{match_id}/participants/{participant_id}(samme ALREADY_LOCKED/NOT_ROSTERED_ON_TEAM-sjekker som opprett). - "Skriv blindt"-hull, funnet under selve scratch-testingen (ikke bare
tenkt ut på forhånd): forrige rundes org-admin-overstyring i
team_authz.pylot en organisator LEGGE TIL deltakere på et lag de ikke selv er rostret på, menapp/blind_draw.pysinown_team_ids()sjekket KUN rostret spiller for SYNLIGHET — så organisatoren så aldri sine egne tilføyelser igjen før begge lag hadde låst. Fikset ved å giown_team_ids()samme owner/admin-utvidelse somuser_may_act_for_ team()— en org-admin ser nå BEGGE lag umiddelbart (konsistent med at de uansett allerede har full tilgang, se forrige rundes resonnement), mens en faktisk rostret kaptein fortsatt kun ser sitt eget lag før reveal. Kun ett reelt kallsted (matches.pysinlist_matches). Tredje, urelatert bug fanget under samme scratch-økt og fikset på brukerens eksplisitte forespørsel:POST .../matches/{id}/participantskrasjet med en rå 500 (TypeErrorihandicap_engine.pysincourse_handicap_raw) hvis spilleren manglethandicap_indexOGuse_handicapvar på (standard) — preeksisterende, ikke noe denne runden introduserte. Fikset iapp/routers/matches.pysinadd_participant: sjekker nåhandicap_index_snapshot IS NULLEKSPLISITT FØR innsetting nåruse_handicaper sann, avviser med en klarVALIDATION_FAILED(400) i stedet for å krasje. Bekreftet atuse_handicap=falsefortsatt tillater en spiller uten handicap (scratch-spill), og at en spiller MED handicap fortsatt fungerer uendret. Verifisert grundig i scratch, flere runder: DELETE-endepunktet (fjern+idempotent 404 ved gjentak+409 etter lås), synlighetsfikset (org- admin ser begge sider, rostret kaptein ser fortsatt kun eget lag), null-handicap-fikset (avvist rent, scratch-modus upåvirket, normal spiller upåvirket), full opprett-match→legg-til-deltaker→lås→avslør- syklus ende-til-ende.test_isolation.sql12/12 etter hver runde. Ekte typesjekket produksjonsbuild. Rullet ut live, bruker bekreftet eksplisitt: begge containere bygget+redeployet (ingen migrasjon),teeoff.noupåvirket.
- Ingen
-
Backend-forarbeid for scorekort-skjermen, LIVE (2026-07-18): to hull funnet ved gjennomlesing av
scoring.pyFØR V0-prompten ble skrevet, samme føre-var-mønster som resten av økten.- Hull-/stroke-index-data for egendefinerte baner (bevisst utsatt fra
tee-rundens status-notat) —
hole-tabellen har ALDRI hatt noen vei inn for custom-baner, som blokkertestroke-scoringsmodus helt (hole_ result-modus trenger den ikke). NyGET/POST /orgs/{id}/courses/{id}/ holesiapp/routers/courses.py— engangs alle-18-på-en-gang (avviser feil antall, avviser hvis banen allerede har hull, avviser på offisielle baner som får hullene sine fra teeoff-import). GET scorecardviste kun UTLEDET vinn/tap/delt per hull, aldri de faktiske tallene som var registrert — umulig å bygge en skjerm som viser gjeldende tilstand ved gjenlasting. UtvidetScorecard-modellen iapp/routers/scoring.pymedstroke_entries/hole_result_entries(råhole_score/match_hole_result-rader, nøyaktig ett av de to fylt ut avhengig av øktens scoring_mode). Verifisert grundig i scratch: hull-validering (feil antall avvist, gjentatt oppsett avvist), og en FULLstroke-modus scoringsrunde med ekte handicap-justert nettoberegning på en egendefinert bane for FØRSTE gang noensinne (ulikt slagtall — 4 mot 5 — ga korrekt "halved" etter handicap-utjevning), scorecard sin nyestroke_entriesbekreftet å returnere nøyaktig det som ble registrert.test_isolation.sql12/12. Rullet ut live, ingen migrasjon, kunteecup_apiredeployet,teeoff.noupåvirket.
- Hull-/stroke-index-data for egendefinerte baner (bevisst utsatt fra
tee-rundens status-notat) —
-
Scorekort-skjermen LIVE (2026-07-18): åttende V0-skjerm,
components/session-scorecard.tsx, ny rute/tournaments/[id]/sessions/ [sessionId]/matches/[matchId]. Ett hull i fokus om gangen (banebruk, ikke et regneark) — store slag-steppere forstroke-modus, tre-valgs vinner-knapper forhole_result-modus, hull-chip-navigasjon, kollapsbar full oversikt, feiret "avgjort"-banner som låser alt til read-only. Blind draw sin avslørte visning lenker nå til hver match sitt scorekort. Ingen nye backend-hull denne runden — forrige rundes forarbeid (hull-endepunkter +stroke_entries/hole_result_entriesi scorecard) dekket akkurat det skjermen trengte. Verifisert grundig i scratch, inkludert et fullt oppsett som speiler NØYAKTIG frontend-ens egen last-sekvens (sessions→teams→matches→ holes→scorecard, deretter en ektePOST hole-scoresfor begge spillere på hull 1 og en refetch): status_text/derivert resultat oppdaterte seg korrekt ("1 UP (A)", hull 1 → "a"), alle feltnavn stemte eksakt med TypeScript-typene uten justering.test_isolation.sql12/12, ekte typesjekket build. Rullet ut live, ren frontend-endring,teeoff.noupåvirket. -
Leaderboard-backend LIVE (2026-07-18): ny
GET /orgs/{id}/ tournaments/{id}/leaderboardiapp/routers/tournaments.py— summerer poeng på tvers av ALLE økter/matcher i turneringen, både total og per-økt-delsum. Reelt korrekthetshull funnet OG designet rundt FØR koden ble skrevet, ikke oppdaget i ettertid:match.team_a_id/team_b_idsettes PER MATCH ved opprettelse, ikke garantert konsistent på tvers av matcher — en organisator kunne i prinsippet opprettet match 1 med team_a=Rød og match 2 med team_a=Blå. En naiv summering avpoints_side_a/points_ side_bville da blandet sammen poeng fra to ULIKE fysiske lag. Løst ved å ALDRI summere på "a"/"b"-labelen — kun på det ekte lag-id-et (points_by_team: dict[team_id, float], både i totalen og per økt). Verifisert presist, ikke bare "kjørte uten feil": bygget et scratch- scenario med 3 matcher over 2 økter der match 2 sin team_a/team_b BEVISST var byttet om i forhold til de to andre — satte poeng direkte (Rød vinner alle tre, ett delt) og bekreftet at leaderboardet likevel ga riktig total (Rød 2.5, Blå 0.5) og riktig per-økt-delsum, til tross for swap-en.test_isolation.sql12/12. Ingen migrasjon, kunteecup_apiredeployet,teeoff.noupåvirket. Frontend-skjermen gjenstår. -
Leaderboard-skjermen LIVE (2026-07-18), samme dag: niende og siste V0-skjerm i "bygg i rekkefølgen ting brukes"-serien for kamp-play-flyten.
components/tournament-leaderboard.tsx, ny rute/tournaments/[id]/ leaderboard. Stort scoreboard-kort med de to lagenes totalpoeng (lederen fremhevet), pluss en per-økt poeng-fordelingsliste med fullført/ikke-startet-status. V0 la selv til et tredje faneelement ("Leaderboard") i BÅDE program- og roster-skjermens fanerad denne runden — portert inn i de LIVE versjonene av begge (med riktigorg- parameter, som V0s eksport som vanlig manglet). Ingen nye backend-hull — forrige rundes leaderboard-endepunkt dekket akkurat det skjermen trengte. Verifisert i scratch: full datamodell-runde (samme felt-for-felt som backend-verifiseringen dagen før) OG et eget tomtilstand-scenario (fersk turnering med 2 lag, 0 økter —sessions: [],matches_total: 0) for å bekrefte at "ingen økter opprettet ennå"-meldingen vises riktig i stedet for å krasje på et tomt array.test_isolation.sql12/12, ekte typesjekket build. Rullet ut live, ren frontend-endring,teeoff.noupåvirket. Hele "bygg i rekkefølgen ting brukes"-serien for match-play-flyten er dermed komplett: oppsett (lag/roster) → program → blind draw → scorekort → leaderboard. -
Offisiell bane-import: idempotent + tydeligere navn, LIVE (2026-07-18), rapportert av brukeren som faktisk brukte funksjonen på ekte produksjonsdata: to reelle problemer, begge funnet ved å lese (kun lesing) de faktiske dataene for "De Gamle er Eldst" FØR noe ble antatt.
POST .../courses/official-importvar IKKE idempotent — å importere samme bane på nytt (helt vanlig: flere økter spilles ofte på samme bane) ga en 409DUPLICATE-feil (migrasjon 010 sin sperre) i stedet for å bare gi tilbake den allerede importerte banen. Fikset: sjekker nåexternal_course_refFØR noe teeoff-kall gjøres — finnes banen fra før, returneres den eksisterende raden direkte (også raskere, og robust mot at teeoff er nede akkurat da).- Lagret navn var kun selve banens navn ("Hovedbanen"), ikke hvilken
klubb — ubrukelig til å skille baner fra hverandre, siden mange
klubber navngir hovedbanen sin identisk. Fikset: navnet kombineres nå
til "{anlegg} – {bane}" (f.eks. "Tjøme Golfklubb – Hovedbanen") ved
import.
Reell konsekvens av hull #1 funnet i produksjonsdata: brukeren hadde,
mens hen forsøkte å søke opp Tjøme via det ØVERSTE banefeltet (som søker
organisasjonens EGNE baner, ikke teeoff), ved et uhell trigget «Opprett
ny bane: «Tj»»-snarveien og fått en tom, søppel
custom-bane hengende på Foursome-økten -- en ekte forvekslingsfelle mellom de to adskilte bane-søkeflatene (eget vs. teeoff), ikke en kodefeil i seg selv. Data ryddet opp i EKTEteecup_db, bruker bekreftet eksplisitt: Foursome-økten pekt om til den allerede importerte, ekte Tjøme-banen (samme bane som Fourball-økten allerede brukte -- nøyaktig det organisatoren egentlig ønsket), søppel-«Tj»-banen slettet (bekreftet ingen matcher/tee-er/hull hang på den FØR sletting), og den ekte banens navn oppdatert til "Tjøme Golfklubb – Hovedbanen". Verifisert i etterkant at begge økter nå peker til samme, korrekt navngitte bane. Verifisert mot ekte teeoff_api i scratch FØR utrulling: importerte Borregaard på nytt to ganger — andre kallet ga nøyaktig samme course-id (ikke en duplikat-rad), navnet kom ut som "Borregaard Golfklubb – Hovedbanen".test_isolation.sql12/12. Ingen migrasjon, kunteecup_apiredeployet,teeoff.noupåvirket.
-
PATCH/DELETEfor økter, LIVE (2026-07-18), samme dag: brukeren spurte rett etter opprydningen om det i det hele tatt var mulig å rette/slette en feiloppsatt økt — det var det ikke (kunPOST/GETfantes). NyPATCH /orgs/{id}/sessions/{id}(app/routers/ tournaments.py) for enkle felt (navn, klokkeslett/intervall, starthull, poeng, handicap-brytere) via vanligexclude_unset-mønster, PLUSS en egen gren for bane-bytte. NyDELETE /orgs/{id}/sessions/{id}— kun tomme økter (ingen matcher), avviser med 409 ellers (bruk PATCH til å korrigere i stedet). Banebytte-scenarioet brukeren selv reiste ("5 hull spilt, oppdager feil bane — slagene er ekte, utregningen er trolig feil") krevde egen design:match_participant.tee_idpeker til en tee som HØRER til den gamle banen. Løst med_remap_course()— finner en tee med samme navn+kjønn på den nye banen for hver allerede tillagte deltaker, flytter dem dit, og avviser HELE bane-byttet tydelig (400, ingenting skrevet, bekreftet transaksjonell rollback) hvis den nye banen mangler en tilsvarende tee. Etter et vellykket bytte: handicap regnes om for alle berørte deltakere, og matchstatus/poeng regnes om for HVER match i økten — bevisst uavhengig av om matchen allerede er avgjort (brukeren bekreftet eksplisitt at en bane-korrigering skal kunne endre et allerede cachet resultat).recompute_and_cache_match_stateiapp/routers/ scoring.pygjort delt (fjernet ledende understrek) for gjenbruk fra tournaments.py. Reelt, urelatert funn underveis i scratch-testingen, IKKE fikset:tee_ratinglages i dag ALLTID kun medfull_18-omfang (både ved teeoff-import og manuell tee-opprettelse) — en økt satt tilfront_9/back_9istroke-modus kan derfor ALDRI få handicap beregnet (compute_and_store_side_handicapssintee_rating-join finner aldri noen rad), og dermed aldri avgjøre noen hull.hole_result-modus upåvirket. Flagget til bruker, bevisst latt urørt denne runden. Verifisert grundig i scratch: enkelt feltbytte (kun navn), fullt banebytte-scenario bygget nøyaktig som brukerens eksempel (10 hull spilt under feil bane, matchen allerede avgjort 10&8, PATCH til riktig bane → tee-er ombyttet korrekt, handicap endret fra 7/9 til 10/13 under den nye banens rating, matchstatus regnet på nytt med UENDREDE rå slagtall), avvist bane-bytte ved manglende tee-match (bekreftet full rollback, også av det urelaterte navnefeltet i samme kall), DELETE avvist på økt med match (409) og godtatt på tom økt (204).test_isolation.sql12/12. Ingen migrasjon, kunteecup_apiredeployet,teeoff.noupåvirket. Frontend (rediger-/slett-knapper i program-skjermen) ikke bygget ennå — kun backend-kapasiteten denne runden. -
Rediger/slett-UI for økter LIVE (2026-07-19): V0-utvidelse av den eksisterende Program-skjermen (ingen ny rute) — "..."-meny (samme DropdownMenu-mønster som roster-skjermens per-spiller-handlinger) med "Rediger"/"Slett" per øktkort. Rediger bytter kortet til et inline-skjema (samme felt som PATCH støtter: navn, poeng, starthull, klokkeslett/ intervall, bane). Slett viser en bekreftelse; treffer den ekte 409-en (økt har matcher), vises backend sin egen feiltekst i stedet for en forhåndsberegnet klient-tilstand. Reell regresjon funnet OG UNNGÅTT i selve V0-eksporten, ikke i etterkant: denne rundens V0-prompt handlet kun om rediger/slett, men eksporten hadde samtidig (utilsiktet) FJERNET bane-feltet fra "Legg til økt"-skjemaet helt — nye økter ville stille blitt satt til en hardkodet mock-bane. Fanget under diff-mot-live-treet FØR noe ble tatt inn (samme rutine som alltid) —
CreateSessionCard(med sitt ekte bane-søk/ teeoff-import) beholdt fullstendig urørt; kun de nye rediger/slett- delene ble hentet inn. Bane-bytte i redigeringsskjemaet er bevisst ENKLERE enn opprett- skjemaets bane-felt — kun velg blant organisasjonens eksisterende baner eller hent fra teeoff, INGEN "opprett ny bane: X"-snarvei her (PATCH sincourse_idmå være en ekte, allerede eksisterende bane, ikke en tekststreng) — unngår at samme "Tj"-forvekslingsfelle fra forrige banebytte-hendelse kan gjenta seg via redigeringsveien. Verifisert: ekte PATCH med nøyaktig skjemaets feltform, ekte DELETE (204 tom økt, 409 med matcher — bekreftet at{"detail":{"code", "message"}}-formen leses riktig av UI-et),test_isolation.sql12/12, ekte typesjekket build. Rullet ut live, ren frontend-endring,teeoff.noupåvirket. -
Invitasjonskode + ledende side + projisert stilling, BACKEND LIVE (2026-07-19, ADR-020): brukeren reiste tre relaterte hull rett etter at "bygg i rekkefølgen ting brukes"-serien var ferdig: (1) ingen vei inn til en turnering for en spiller som bare har fått muntlig beskjed, (2) leaderboardet viser kun faktisk opptjente poeng, ikke hva stillingen ville blitt om pågående matcher holder seg, (3) ingen fargekoding i matchlister for hvem som leder. Full ADR-020 skrevet (4 delbeslutninger, se ARCHITECTURE_DECISIONS.md) — nøkkelbeslutning bekreftet eksplisitt av bruker FØR bygging: en invitasjonskode OVERSTYRER
tournament.visibilityhelt (koden ER selve invitasjonen, ikke en snarvei som fortsatt krever eksisterende tilgang). Ny migrasjon011_join_code_and_leading_side.sql:tournament.join_code(6 tegn, alfabet uten 0/O/1/I, globalt unikt, backfylt for eksisterende rader),match.leading_side(cachet fortegn avMatchState.lead, samme mønster somstatus_text/points_side_a/b), fjerdeSECURITY DEFINER-bropublic_tournament_by_code()(etterpublic_tournament_org007,link_player_by_email008,public_org_by_slug009). Backend bygget:create_tournamentgenererer koden (retry-løkke ved kollisjon, astronomisk usannsynlig med 33^6 kombinasjoner). NyGET /public/tournaments/by-code/{code}(MÅ registreres FØR/{tournament_id}i routeren, ellers tolkes "by-code" som en ugyldig UUID).GET /public/tournaments/{id},GET .../sessionsogPOST .../registergodtar alle en valgfricode-parameter som — når den matcher — hopper_check_visibility()helt over.recompute_and_cache_match_state(scoring.py) cacher nåleading_sideved HVER hull-innsending, ikke bare ved avgjørelse. Leaderboard- endepunktet fikkprojected_points/projected_points_by_team: avgjorte matcher bidrar likt til faktisk og projisert, ikke-avgjorte gir helepoints_per_matchtilleading_side(delt 0,5/0,5 ved "AS"/ikke startet) — speiler hvordan Ryder Cup-TV-dekning viser "hvis det sluttet nå". Reell hendelse underveis, håndtert transparent (ikke skjult): en feilformulertdocker exec teeoff_db env | grep -i POSTGRES-kommando (ment å liste variabelNAVN) fanget oppPOSTGRES_PASSWORDsin VERDI også, siden selve nøkkelnavnet matchet søkemønsteret — eksponerteteeoff_dbsitt superbruker-passord (teeoff_admin) i verktøyresultatet. Alvorligere enn de to tidligere passord-hendelsene i prosjektet siden dette er superbrukeren for HELE den delte Postgres-klyngen (teeoff OG teecup), ikke en enkelt tjeneste-credential. Flagget til bruker umiddelbart, som valgte å rotere. Rotert trygt UTEN å noensinne re-eksponere gammel ELLER ny verdi i noe synlig kommandoresultat:ALTER ROLEkjørt via lokal Unix-socket-trust-auth (bekreftet ved å lesepg_hba.conf, ingen hemmelighet involvert i den sjekken) — krevde altså IKKE det gamle passordet i det hele tatt. Nytt passord generert medopenssl rand -hex 32(hex, ikke base64 — unngår SAMME klasse URL-enkodings-felle somTEECUP_DATABASE_URL-hendelsen tidligere, siden verdien også ligger i enpostgres://-DSN)./opt/teeoff/.envsine TO forekomster (POSTGRES_PASSWORDogDATABASE_URL) oppdatert medsed-mønstre som ALDRI leser/skriver ut den gamle verdien.teeoff_api/teeoff_workerservice-nøklene idocker-compose.prod.ymlviste seg å heteapi/worker(ikketeeoff_api/teeoff_worker— det er kuncontainer_name), samme "service-nøkkel ≠ container-navn"-fallgruve som nettverksalias-hendelsen fra containeriseringsrunden.docker compose up -d --force-recreate api workergjenskapte OGSÅteeoff_dbselv (ikke eksplisitt navngitt) — Compose oppdager konfigurasjonsendring (${POSTGRES_PASSWORD}idb-tjenestens egenenvironment:) og gjenskaper uansett hvilke tjenester som ble navngitt. Verifisert grundig ETTERPÅ:teeoff_db-loggen viste "Skipping initialization" (datavolum urørt, ikke reinitialisert) + ren oppstart,teeoff_api/teeoff_workerren oppstart uten en eneste feil-/auth-/passord-linje i hele loggen,teeoff.noOGteecup.teeoff.no/healthbegge200etterpå. Scratch-verifisert grundig (ferskteecup_scratch001→011, isolertteecup_app_scratch-rolle, isolert scratch-MinIO, engangs API-container):test_isolation.sql12/12 (måtte først rettes — tre RÅINSERT INTO tournament-steder i selve testfilen predatertejoin_codeog traff den nye NOT NULL-constrainten, rettet med dummy-koder). Full ende-til-ende-runde: to turneringer opprettet, ulike koder bekreftet;by-code-oppslag bekreftet for kjent OG ukjent kode (404); anonym lesing av enorg-synlig turnering BLOKKERT uten kode (403 NOT_VISIBLE), TILLATT med riktig kode (inkl. case-insensitivt), FORTSATT blokkert med feil kode; samme mønster bekreftet forPOST .../register. Full hull-for-hull-simulering av en singel-match (hole_result-modus):leading_side/status_textfulgte hverandre eksakt gjennom "1 UP (A)" → "AS" (leading_side=null) → avgjort "9&7 (A)", leaderboardetsprojected_pointstraff nøyaktig 1.0/0.0 mens A ledet, 0.5/0.5 ved "AS", og ble liktpoints/projected_points(begge 1.0/0.0) etter avgjørelse. Rullet ut mot ekteteecup_db2026-07-19, bruker bekreftet eksplisitt: migrasjon 011 kjørt (eneste eksisterende turnering fikk automatisk generert kode),test_isolation.sqlfortsatt 12/12, kunteecup_apiredeployet (ingen frontend-endring i denne del-runden),teeoff.noupåvirket. Frontend fullført samme dag, egen del-runde:login-form.tsxfikk et eget kode-modus (JoinByCode) — «Har du en invitasjonskode?»-lenke bytter ut e-post-skjemaet, slår opp/public/tournaments/by-code/{code}og navigerer til/t/{id}?code=...med Next sinuseRouter.codequery-param tres gjennom hele veien:app/t/[id]/page.tsxlesersearchParams,public-tournament.tsxsender den med på BÅDE info-/sessions-lesingen og selvePOST .../register(ikke bare det første oppslaget som tok deg dit).tournament-detail.tsxviser koden i en egen kopier-chip i headeren — ingen enkelt-turnering-GETfantes, så komponenten henter i stedet hele org-ens turneringsliste (som allerede bærerjoin_code) og finner egen rad, i stedet for å legge til et nytt endepunkt kun for dette.tournament-leaderboard.tsxfikk en nySegmentedBar-komponent — ETT fargesegmentert rektangel per bar (ikke tall side om side), proporsjonalt med hvert lags poeng, 50/50 nøytralt ved 0-0. To slike bares rett under headeren: "Stilling nå" (faktisk) og "Projisert (hvis pågående matcher holder seg)" — den EKSISTERENDE store tall-scoreboarden beholdt uendret lenger ned som detaljvisning.session-blind-draw.tsxsinRevealedView: matchkortet får nå en farget toppkant (leaderensteam.color) og enstatus_text-chip (fylt farge ved avgjort match m/ konfetti-ikon, lys tone ved pågående) i stedet for kun klokkeslettet;RevealSidefor ledende side får en svak fargetonet bakgrunn.leading_side/status_text/points_side_a/blagt tilApiMatch-typen (var der allerede i API-et, bare ikke konsumert frontend-siden før nå). Verifisert: ekte typesjekket produksjonsbuild (sammeDockerfilesom deployes, ikke dev-server) kompilerte rent, alle 10 ruter listet. Rullet ut (kunteecup_frontend, ingen backend-endring i denne delen),teecup.teeoff.no/dashboardog/→ 200,teeoff.noupåvirket. Ekte smoke-test i produksjon:by-code-oppslag for "De Gamle er Eldst" sin faktiske kode ga riktig turnering-id,/t/{id}?code=...ga 200. ADR-020 er dermed helt ferdig (backend + frontend, alle fire del-ønsker: kode-basert oppdagelse, kode-felt på login, projisert stilling, fargekoding av matcher) — bortsett fra kode-regenerering, som er bevisst utsatt (se FEATURE_BACKLOG.md). Reell driftshendelse underveis (mellom backend- og frontend-delen, under scratch-oppsett): en feilformulertgrep -i POSTGRES-kommando eksponerteteeoff_dbsitt superbruker-passord ved et uhell. Flagget umiddelbart, brukeren valgte å rotere — se detaljene under backend-avsnittet over for hele hendelsen og hvordan roteringen ble gjennomført uten å noensinne re-eksponere gammel eller ny verdi. -
Sesjons-bug diagnostisert og FIKSET, LIVE (2026-07-19): brukeren rapporterte at hen måtte be om ny magic-link-kode ved HVERT besøk til
teecup.teeoff.no, til tross for ADR-009s 30-dagers sesjonscookie. Bad brukeren sjekke den EKTE cookien i nettleseren fremfor å gjette — kom tilbake korrekt satt i alle henseender (Expires30 dager frem,Secure/HttpOnly/SameSite=Lax). Rot-årsaken var derfor IKKE cookien eller backend-en:frontend/app/page.tsx(rot-siden) viste ALLTID innloggingsskjemaet uten noensinne å sjekke om en gyldig sesjon allerede fantes.Dashboard-komponenten sjekker/auth/meog sender til/ved MANGLENDE sesjon, men ingen kode gjorde det motsatte — en bruker som besøkte roten direkte (i stedet for å navigere til/dashboard) så derfor alltid innloggingsskjemaet uansett sesjonsstatus. Fikset:page.tsxgjort om til en async server-komponent som leser sesjonscookien vianext/headers, kaller/auth/meserver-til-server direkte motTEECUP_API_ORIGIN(samme mønster somgenerateMetadataiapp/t/[id]/page.tsx— IKKE gjennomnext.config.mjssinrewrites(), som kun gjelder nettleser-trafikk), og sender en allerede innlogget bruker videre til/dashboardmedredirect()FØR innloggingsskjemaet når rendres. Verifisert presist mot den ekte, live stacken, med brukerens EGEN ekte sesjonscookie (ikke en syntetisk test):curluten cookie mothttps://teecup.teeoff.no/ga200(skjemaet vises, riktig for en anonym besøkende); samme kall MED den ekte cookien ga307til/dashboard(riktig — sender en allerede innlogget bruker rett videre). Ekte typesjekket produksjonsbuild kjørt FØR utrulling (build-outputet viste selv at/nå erƒdynamisk i stedet for○statisk — bekrefter at server-sjekken faktisk ble tatt i bruk). Rullet ut live, kunteecup_frontend, ingen migrasjon,teeoff.noupåvirket. Samme runde: brukeren stilte to oppfølgingsspørsmål om autentisering/autorisasjon — «er flere-organisasjoner-eierskap tenkt gjennom» (bekreftet: ja, ADR-002 fra dag én, ingen kodeendring nødvendig) og et ønske om passord (valgfritt tillegg)+2FA. Fullt design skrevet som ADR-021 (passord/2FA) og ADR-022 (dele/invitere/frasi seg eierskap + superadmin) — se ARCHITECTURE_DECISIONS.md. -
ADR-021 (passord/2FA) + ADR-022 (org-eierskap) BYGGET OG LIVE (2026-07-19), samme dag: brukeren ba om begge sammen («Bygg det», bekreftet eksplisitt at det gjaldt begge ADR-ene i samme runde). Ny migrasjon
012_password_2fa_and_org_invitations.sql:app_user. password_hash/two_factor_method/totp_secret/is_super_admin, ny tabelltwo_factor_code(samme hash-og-utløp-mønster sommagic_link_token), ny tabellorganization_invitation(RLS org-isolert, INGEN egen klikkbar aksept-lenke — godtas automatisk ved neste innlogging med matchende e-post), femteSECURITY DEFINER-broaccept_pending_invitations_by_email()(etterpublic_tournament_org007,link_player_by_email008,public_org_by_slug009,public_tournament_by_code011). Sesjons-STADIER innført iapp/auth.py: en sesjonscookie er ikke nødvendigvis en full sesjon lenger —create_session_token()tar nå enstage-parameter (full/pending_2fa/must_enroll_2fa), lagt inn som et JWT-claim.get_current_useravviser eksplisitt alt annet ennfullELLER en ELDRE token uten stage-claim i det hele tatt (utstedt før denne runden — behandlet somfullfor bakoverkompatibilitet, ingen eksisterende bruker logget brått ut). To nye avhengigheter:get_pending_user(kun for 2FA-verifiseringsendepunktene) ogget_current_or_enrolling_user(godtar BÅDE en full sesjon — frivillig 2FA-oppsett fra kontoinnstillinger — OGmust_enroll_2fa— tvunget oppsett rett etter innlogging — samme oppsett-logikk dekker begge veiene).get_current_user_optionalfikk samme stage-sjekk for konsistens. Passord (Argon2id, ikke bcrypt): bevisst valg for å unngå bcrypt sin stille 72-byte-trunkering, siden brukeren eksplisitt ba om korrekt håndtering av spesialtegn/mellomrom.POST /auth/set-password//remove-password//login-password— sistnevnte svarer med IDENTISK 401 uansett om e-posten finnes, mangler passord, eller passordet er feil (samme anti-enumerering som magic-link). 2FA (TOTP viapyotpELLER e-post-engangskode via eksisterende SMTP, brukerens eget valg):POST /auth/2fa/setup/startgenererer en TOTP-secret UTEN å lagre den (rundturer til klienten, som ekkoer den tilbake i/setup/confirm— unngår en halvferdig 2FA-tilstand i databasen hvis brukeren forlater oppsettet). QR-kode generert server-side (qrcode-biblioteket + eksisterende Pillow-avhengighet, ingen ny ekstern tjeneste).POST /auth/2fa/verifyfullfører en PÅGÅENDE innlogging. Tvungen 2FA for org-eier/admin (ADR-021 Beslutning D):user_requires_2fa_enrollment()sjekket ved HVER innlogging (ikke bare første gang, siden en bruker kan bli eier av en NY org etter at kontoen allerede eksisterer uten 2FA) — verifisert eksplisitt: en fersk org-eier uten 2FA ble korrekt blokkert fra all normal tilgang (401) og tvunget inn i oppsett-flyten før noe annet ble tilgjengelig. Organisasjonseierskap (ADR-022):POST/GET/DELETE /orgs/{id}/invitations(owner→enhver rolle, admin→KUN member — ellers en privilegie-eskaleringsvei),PATCH/DELETE /orgs/{id}/memberships/ {id}(owner kan endre/fjerne hvem som helst; en bruker kan ALLTID SENKE egen rolle selv — aldri heve den, ville vært selv-forfremmelse — og alltid forlate selv), «siste eier»-vern (409LAST_OWNER,FOR UPDATE-lås mot race på alle eier-rader, samme TOCTOU-mønster som ADR-011s to-lags-grense). Superadmin (app_user.is_super_admin, KUN manuelt DB-tildelt — bevisst INGEN API-vei til å gi seg selv eller andre flagget) får en parallell autorisasjonssti (get_superadmin_user) som kan sette medlemskap på ENHVER org, uavhengig av eget medlemskap — bevisst avgrenset til nøyaktig dette, ikke generell tilgang til andres turnering-/spillerdata. Tre reelle bugs funnet OG fikset UNDER scratch-testing, ingen nådde produksjon:verify_magic_linksendte en rå asyncpg-UUID(ikke streng) videre til sesjonsutstedelse —jwt.encode()sin JSON-serialisering krasjet rått (500) på selve innloggingen. Fant umiddelbart ved første reelle innloggingstest. Rettet med en eksplisittstr().- OG 3. Både
2fa/setup/confirmog2fa/verifykalte først den delte_issue_login_result()-hjelpefunksjonen (ment for PRIMÆR autentisering) EN GANG TIL etter at 2FA nettopp var bekreftet — som så (korrekt, men feil kontekst) attwo_factor_methodnå var satt og krevde EN NY runde med 2FA for akkurat den samme innloggingen, en uendelig løkke. Fant ved å faktisk fullføre hele innloggings- syklusen med ekte genererte TOTP-koder (pyotpi test-scriptet), ikke bare ved å lese koden. Rettet ved at begge endepunktene nå utsteder en full sesjon DIREKTE etter vellykket 2FA-bekreftelse, ikke via gjenbruk av den generelle sjekken. Frontend:login-form.tsxfikk en tredje modus (passord, ved siden av magic-link og ADR-020s invitasjonskode-modus). Ny delttwo-factor-flow.tsx(TwoFactorVerifyForm/TwoFactorSetupForm), brukt av BÅDElogin-form.tsxogverify-form.tsxsiden begge primær-autentiseringsveiene kan returnere samme 2FA-mellomtilstand. Ny/account-skjerm (sett/fjern passord, aktiver/deaktiver 2FA) og ny/orgs/[id]/members-skjerm (invitere, endre rolle, fjerne/forlate), begge lenket fra dashbordets header/org-visning.next.config.mjssinrewrites()utvidet med/superadmin/:path*(ADR-016s konsekvens for enhver ny API-prefiks, selv om ingen frontend-UI faktisk bruker den ennå). Verifisert grundig mot ferskteecup_scratch(001→012,test_isolation.sql12/12): full magic-link-bakoverkompatibilitet (eksisterende flyt uendret for brukere uten 2FA), passord med ekte spesialtegn/mellomrom/æøå satt og brukt til pålogging, full TOTP-runde (oppsett→bekreft→logg ut→logg inn→krev 2FA→verifiser med ektepyotp-generert kode), full e-post-2FA-runde (samme mønster, feil kode avvist, kode ikke gjenbrukbar), tvungen 2FA-registrering for ny org-eier, invitasjon→auto-aksept ved førstegangsinnlogging, rolle-eskalering-forsøk avvist på tre distinkte måter (medlem kan ikke invitere, admin kan ikke gi eierskap, bruker kan ikke forfremme seg selv), siste-eier-vern (både PATCH og DELETE), duplikat-invitasjon avvist, superadmin-sti fungerer/avvises riktig i begge retninger. Ekte typesjekket produksjonsbuild av frontend (alle nye ruter listet). Rullet ut mot ekte systemer 2026-07-19, bruker bekreftet eksplisitt: migrasjon 012 kjørt mot ekteteecup_db,test_isolation.sqlfortsatt 12/12, begge containere (teecup_api,teecup_frontend) redeployet og bekreftet ren oppstart,/healthog/dashboardfortsatt 200 (eksisterende sesjoner uendret av stage-bakoverkompatibiliteten),/auth/login-passwordbekreftet nåbart over ekte https,teeoff.noupåvirket. ADR-021 og ADR-022 er dermed begge helt ferdig — backend + frontend. Bevisst utenfor omfang: dedikert superadmin-UI (brukes via API av en betrodd operatør), SMS som 2FA-metode.
-
Program-skjerm: tydeligere klikk-hint på øktkort (2026-07-19): brukeren påpekte at ingenting i grensesnittet indikerte at et øktkort er klikkbart inn til blind draw-skjermen. Lagt til en synlig "Sett opp flights og lås oppstilling →"-rad nederst i hvert kort (
components/tournament-program.tsx). Ren frontend-endring, ingen backend-rørt. -
Brukerroller: kaptein som reell autorisasjon, deltaker-avgrenset scoring (2026-07-19, ADR-023): direkte oppfølging av det lenge åpne "Brukerroller"-punktet i FEATURE_BACKLOG.md. Fire beslutninger avklart eksplisitt med bruker (AskUserQuestion) før bygging — alle anbefalte valg. Bygget:
app/team_authz.pyskrevet om —user_is_team_captain(erstatteruser_may_act_for_team) kreveris_captain=truepåteam_roster(eller org-eier/admin) for å legge til/fjerne deltakere og låse et lag (matches.py); nyuser_is_match_participantkrever en ektematch_participant-rad for brukeren i AKKURAT den matchen (valgfritt side-spesifikk viateam_side) for å føre/korrigere score (scoring.py) — uavhengig av kapteinmerket. Nye feilkoderNOT_TEAM_CAPTAINogNOT_MATCH_PARTICIPANT(erstatterNOT_ROSTERED_ON_TEAMpå disse fem stedene).app/routers/tournaments.pysinPATCH/POST .../rosterhåndhever nå "kun én kaptein per lag" (fjerner automatisk forrige kapteins merke i samme transaksjon). Reelt funn FØR utrulling, ikke antatt: sjekket (kun lesing, superbruker mot ekteteecup_db) om noen eksisterende lag ville blitt låst ute av en ren kaptein-only-regel — "De Unge" i "De Gamle er Eldst" har i dag 0 av 2 roster-rader merket kaptein. Designet derfor en bevisst fallback iuser_is_team_captain: har laget INGEN utpekt kaptein ennå, godtas enhver rostret spiller i stedet for å låse laget helt ute. Ingen lag hadde flere kapteiner, så "kun én kaptein"-håndhevelsen krevde ingen data-opprydning. Reell bug funnet OG fikset UNDER scratch-testing:user_is_match_ participantsin SQL sammenlignetmp.team_side(enum-kolonne) direkte mot en tekst-parameter uten cast nårteam_side=None(hole_result-modus) — ga en rå 500 (UndefinedFunctionError: operator does not exist: team_side = text). Rettet med et eksplisittmp.team_side::text = $3. Verifisert grundig mot ferskteecup_scratch(isolertteecup_app_scratch-rolle, isolert scratch-MinIO, engangs API-container): et 15-punkts Python/httpx-testskript som simulerte fire innloggede brukere (organisator + tre rostrede spillere på to lag) gjennom hele syklusen — lag uten kaptein tillater enhver rostret (fallback bekreftet), kaptein utpekt fjerner andre rostredes rettighet, "kun én kaptein" bekreftet (ny kaptein avsetter automatisk forrige), org-admin fungerer uendret uavhengig av kaptein, og scoring (hole_result-modus) bekreftet begrenset til faktiske matchdeltakere (en kaptein som IKKE selv spiller matchen ble korrekt avvist medNOT_MATCH_PARTICIPANT, mens en faktisk deltaker og org-admin begge fikk føre score). Måtte også oppdage og legge til et forutsetning-steg underveis:get_authorized_orgkreverorganization_membershipfor ALLE org-scopede endepunkter uansett — en rostret spiller må derfor også være invitert som org-medlem (minimum 'member', ADR-022s invitasjonsflyt) for i det hele tatt å nå team_authz-vurderingen; ikke en bug, men en forutsetning testskriptet først manglet.test_isolation.sql12/12 uendret (ingen skjemaendring). Ekte typesjekket produksjonsbuild av frontend (øktkort-hintet fra samme runde) kjørt og bekreftet, alle 11 ruter listet. Rullet ut live 2026-07-19, bruker bekreftet eksplisitt: ingen migrasjon,docker compose up -d --build teecup_api teecup_frontend, begge containere boot-et rent (Application startup complete, Next.jsReady),/healthog/dashboard→ 200,teeoff.noupåvirket. -
Walkover/konsesjon LIVE (2026-07-19, ADR-024): direkte oppfølging av Brukerroller-runden samme dag — brukeren ba eksplisitt om å ta fatt på dette som naturlig neste steg. Løser det lenge kjente hullet: en side som aldri stiller nok spillere fikk aldri beregnet handicap og matchen kunne derfor aldri avgjøres — hang uendelig. Fire beslutninger avklart eksplisitt med bruker (AskUserQuestion) før bygging — tre anbefalte valg, ett (omfang: match+turnering-nivå samtidig, ikke bare match) valgt utover anbefalingen. Bygget: ny
apply_concession-hjelpefunksjon iapp/routers/ scoring.py(skriver til de samme fire kolonnene somrecompute_and_cache_match_state--status_text/points_side_a/b/leading_side-- men direkte, ikke utledet fra hull). NyPOST /orgs/{id}/matches/{id}/concede(kun kaptein for det TAPENDE laget, speiler ekte golf-etikette -- du gir bort DITT tap, krever ikke seier på motstanderens vegne -- eller org-admin, gjenbrukeruser_is_team_captainfra ADR-023 uendret). NyPOST /orgs/{id}/tournaments/{id}/concede(app/routers/tournaments.py) som gir opp ALLE ikke-avgjorte matcher laget har i turneringen i én operasjon -- v1s to-lags-grense (ADR-011) gjør dette trivielt (bare én motstander uansett),FOR UPDATE-låser alle berørte match-rader (samme race-vern som ellers). Kan erklæres uansett hvor mange hull som allerede er registrert (match-play teller kun seier/tap/delt for poeng, ikke marginen) -- allerede registrerte hull ihole_score/match_hole_resultforblir urørt, kun matchens avgjørelses-felt endres. Frontend:session-scorecard.tsxfikk en kollapsbar "Gi opp matchen (walkover)"-seksjon (to knapper, én per lag, med bekreftelsessteg) synlig når matchen ikke er avgjort.tournament-detail.tsxsinTeamPanelfikk en tilsvarende "Gi opp resten av turneringen for laget"-knapp nederst i hvert lagkort. Ingen klientside-forhåndsfiltrering på kapteinstatus noe sted -- begge knappene vises alltid, en 403 fra backend vises bare som vanlig feiltekst (samme mønster som resten av appen). Verifisert grundig mot ferskteecup_scratch(isolertteecup_app_scratch-rolle, isolert scratch-MinIO, engangs API-container): to separate 15-punkts Python/httpx-testløp. Match-nivå: vinnende lags kaptein NEKTES å konsedere på vegne av det tapende laget (kan ikke kreve seier på andres vegne), tapende lags kaptein FÅR, allerede avgjort match avvist 409, fremmed team_id avvist 400, konsesjon ETTER at ett hull allerede er registrert bekreftet å fungere OG bekreftet at det registrerte hull-resultatet forblir synlig i scorekortet etterpå (ikke overskrevet), org-admin FÅR konsedere direkte uavhengig av kapteinmerke. Turnering-nivå: feil lags kaptein nektes, riktig kaptein FÅR gi opp resten (kun de faktisk ikke-avgjorte matchene telles -- allerede avgjorte matcher fra match-nivå-testene i samme løp ble korrekt hoppet over), gjentatt kall er trygt (0 nye, idempotent i praksis), ukjent team_id gir 404.test_isolation.sql12/12 uendret (ingen skjemaendring). Ekte typesjekket produksjonsbuild av frontend kjørt og bekreftet, alle 11 ruter listet. Rullet ut live 2026-07-19, bruker bekreftet eksplisitt: ingen migrasjon,docker compose up -d --build teecup_api teecup_frontend, begge containere boot-et rent,/healthog/dashboard→ 200,teeoff.noupåvirket. -
Turnering-status via API, SCRATCH-VERIFISERT (2026-07-19): brukeren valgte dette som neste steg etter walkover/konsesjon-runden (fikk velge mellom denne lille opprydningen og å starte Kommunikasjon-runden).
status(draft/active/completed/archived) har ligget i skjemaet siden migrasjon 001, men INGEN endepunkt kunne endre det — kunINSERT-defaulten'draft'fracreate_tournament. Bygget: lagt til iTournamentUpdate(app/routers/tournaments.py), settes via det eksisterende generiskePATCH /orgs/{id}/tournaments/{id}(exclude_unset-mønsteret, ekte PATCH-semantikk uendret). Reelt funn UNDER scratch-testing, ikke antatt riktig på forhånd:statuser -- uliktvisibility(som er rentext+CHECK) -- en EKTE Postgres ENUM-type (tournament_status). Den generiskeset_clauses-byggeren (f"{key} = ${i}") hadde derfor trengt et eksplisitt cast for at asyncpg sin ukjent-typede parameter skulle løses riktig mot en enum-kolonne -- lagt til en spesialsjekk (::tournament_statuskun forstatus-nøkkelen) FØR jeg antok mekanismen "bare fungerer" fordi den gjør det for de andre feltene. Bevisst INGEN tilstandsmaskin/overgangsregler bygget (kan f.eks. gå fracompletedtilbake tildraftfritt) -- samme tillitsnivå som resten av appen, ikke etterspurt. Frontend:tournament-status-badge.tsxfikk en ny redigerbarTournamentStatusPicker(dropdown over de fire verdiene, optimistisk UI-oppdatering med rollback ved feil), koblet inn itournament-detail.tsxsin header ved siden av invitasjonskode-chipen. Den eksisterende skrivebeskyttedeTournamentStatusBadge(dashbordets kortliste) urørt. Verifisert i scratch: ny turnering får riktig defaultdraft, PATCH tilactivebekreftet enum-castet faktisk løser problemet, PATCH med status+et annet felt samtidig fungerer, PATCH UTEN status-felt lar verdien stå urørt (regresjon på eksisterende PATCH-semantikk), ugyldig status-verdi avvist med 422 (Pydantic-mønster),GET-listen viser samme verdi etterpå.test_isolation.sql12/12 uendret (ingen skjemaendring). Ekte typesjekket produksjonsbuild kjørt og bekreftet. Rullet ut live 2026-07-19, bruker bekreftet eksplisitt: ingen migrasjon,docker compose up -d --build teecup_api teecup_frontend, begge containere boot-et rent,/healthog/dashboard→ 200,teeoff.noupåvirket. -
Kommunikasjon LIVE (2026-07-19, ADR-025) — det største enkeltløftet i prosjektet så langt: lag-intern chat («det hemmelige rommet») + offentlig runde-feed («Banter Board»), begge med bilder og ekte WebSocket-sanntid, bygget i samme runde. Fire hovedbeslutninger avklart eksplisitt med bruker (AskUserQuestion) før bygging — brukeren valgte den mest ambisiøse kombinasjonen på alle fire (begge deler nå, WebSockets fremfor polling, ekte privat chat, bilder fra start). Datamodell: ny migrasjon
013_messaging.sql— deltmessage-tabell medscope-diskriminator (team/tournament_feed) i stedet for to separate tabeller, RLS org_isolation som ellers.author_display_nameFRYSES ved skrivetidspunkt (samme prinsipp som handicap-snapshot, ADR-007) — spillerensplayer.display_namei org-en hvis den finnes, ellers e-postens lokaldel (dekker org-ansatte uten egen spillerprofil). Lag-chat er BEVISST ekte privat — nyuser_is_rostered_on_teamiapp/team_authz.py, med VILJE uten org-admin-fallback, ulikt de to andre funksjonene i samme fil (user_is_team_captain/user_is_match_participant, ADR-023, som begge har et slikt unntak). Første sted i hele appen der org-eier/admin er strukturelt utestengt fra noe. Offentlig feed: LESING gjenbrukerregistration.pysitt eksisterende trenivå-visibility-mønster (ADR-018) helt uendret, inkl. anonym tilgang. POSTING er strengere enn lesing — krever ekte innlogging OG org- medlemskap/faktisk deltakelse, selv på enpublic-synlig turnering (en helt urelatert innlogget bruker skal ikke kunne poste på en fremmed offentlig side). Moderering: forfatteren selv ELLER org-eier/admin kan slette et feed-innlegg (motsatt av lag-chatten, som ikke har noen ekstern moderator).registration.pysine fire interne hjelpefunksjoner gjort delt (fjernet ledende understrek — samme "gjort delt for gjenbruk"-mønster som tidligere runder):resolve_org,is_participant,code_matches,check_visibility.team_authz.pysin_is_org_adminlikeens →is_org_admin. Ingen atferdsendring, kun navn, for atmessaging.pyskulle kunne gjenbruke dem uendret i stedet for å duplisere logikk. WebSockets, ikke polling: in-memory tilkoblingsregister PER PROSESS iapp/routers/messaging.py— trygt med dagens eneteecup_api-container, men deles IKKE på tvers av flere prosesser/containere (samme klasse begrensning som den allerede aksepterte in-memory-cachen, se ARCHITECTURE_ DECISIONS.md "Åpne spørsmål"). Nyget_current_user_from_websocketiapp/auth.py— WS-ruter kan ikke brukeget_current_user/get_authorized_orgdirekte viaDepends()(de erRequest-typet, ingen ekte HTTP Request finnes i en WS-scope), derfor en bevisst minimal, egen kopi av samme cookie-dekode-/oppslagslogikk. Reell infrastrukturoppdagelse FØR noe ble forsøkt, ikke i etterkant: Next.js sinrewrites()proxyer ikke WebSocket-oppgraderinger pålitelig i "standalone"-modus — løst likt som MinIO-media-ruten (ADR-018): en egen Caddy-rute (handle /ws/* { reverse_proxy teecup_api:8000 }) rett til API-et, forbi Next.js/teecup_frontendhelt. Caddyfile ligger i det SEPARATE/opt/teeoff-repoet — samme stale-bind-mount-inode-oppførsel som ALLE tidligere Caddyfile-runder (graceful reload plukker ikke opp endringen), løst likt: fulldocker restart teeoff_caddy, brukeren bekreftet eksplisitt på forhånd, noen sekunders nedetid forteeoff.no. Verifisert grundig mot ferskteecup_scratch(isolertteecup_app_scratch-rolle, isolert scratch-MinIO, engangs API-container medwebsockets-Python-biblioteket installert kun for testen): et 20-punkts asyncio/httpx/websockets-testskript som dekket BEGGE meldingstyper ende-til-ende. Kritiske personvern-/sanntid-funn, alle bekreftet med ekte tilkoblinger (ikke bare REST):- Rostret spiller på lag A FÅR lese/skrive lag A sin chat; rostret spiller
på lag B NEKTES; organisatoren (org-eier) NEKTES OGSÅ — bekreftet
BÅDE over REST (
GET) og over selve WebSocket-håndtrykket (avvist med lukkekode 4403 føraccept()i det hele tatt kalles). - Sanntid bekreftet reelt: A1 koblet til lag A sin chat-socket, A2 sendte en melding over vanlig REST, A1 mottok den umiddelbart over den åpne WebSocket-tilkoblingen (ikke bare at REST-svaret så riktig ut).
- Bildeopplasting i chat bekreftet (ekte AVIF-konvertert
image_urlreturnert). - Offentlig feed: anonym NEKTES å poste (401), en tilfeldig INNLOGGET men
uvedkommende bruker NEKTES (403
NOT_A_PARTICIPANT), org-medlem FÅR, en faktisk deltaker (rostret, IKKE org-medlem) FÅR — beviseris_participant-veien fungerer uavhengig avis_member-veien. Anonym WebSocket-tilkobling til enpublic-synlig turnerings feed FÅR lov og mottar sanntidsoppdateringer. - Moderering bekreftet: forfatter sletter eget innlegg, org-admin sletter
ANDRES innlegg (feeden), uvedkommende NEKTES å slette andres innlegg.
test_isolation.sql12/12 uendret (additiv migrasjon). Ekte typesjekket produksjonsbuild av frontend kjørt og bekreftet, inkl. den nye/tournaments/[id]/teams/[teamId]/chat-ruten. Frontend: nycomponents/team-chat.tsx(meldingsliste med egen/andres- styling, bildeopplasting, sanntid via nettleserens nativeWebSocket, slett-egen-melding), lenket fra en ny chat-ikon-knapp itournament- detail.tsxsinTeamPanel. Ny seksjonTournamentFeedicomponents/public-tournament.tsx(nederst på den offentlige turneringssiden) — viser 401/403-svar fra posting som forklarende inline-tekst ("logg inn for å poste" / "du må være medlem/deltaker") i stedet for en generisk feilmelding. Rullet ut live 2026-07-19, bruker bekreftet eksplisitt for alle tre stegene (migrasjon, containere, Caddy-restart): migrasjon 013 kjørt mot ekteteecup_db,test_isolation.sqlfortsatt 12/12, begge containere boot-et rent, Caddy validert (caddy validate— "Valid configuration") FØR restart, restarten ren (ingen feil i loggen). Verifisert grundig etterpå:/health/dashboard→ 200,teeoff.no→ 200, et ektewss://-håndtrykk over produksjons-https bekreftet å nå helt frem til applikasjonslaget (testet mot en ukjent turnering-id — ingen ekte data berørt — ga korrekt 404 fra selve WS-ruten, ikke en Caddy/Next.js-feil), og et ren-HTTP-kall mot en/ws/*-sti bekreftet å returnere FastAPI sin egen JSON-404 ({"detail":"Not Found"}) og ikke Next.js sin HTML-404 — beviser Caddy-ruten faktisk trefferteecup_api, ikketeecup_frontend.
- Rostret spiller på lag A FÅR lese/skrive lag A sin chat; rostret spiller
på lag B NEKTES; organisatoren (org-eier) NEKTES OGSÅ — bekreftet
BÅDE over REST (
-
Tilskuer-rolle LIVE (2026-07-19, ADR-026): brukeren valgte dette som neste steg rett etter Kommunikasjon-runden — "tilskuer" var bevisst utsatt til feed-synligheten (ADR-025) fantes, og nå gjorde den det. Kjernebeslutning: ingen ny rolle/tabell — "tilskuer" er ganske enkelt enhver som kan SE en turnering per
tournament.visibility(ADR-018), utvidet til også å dekke LIVE-data (leaderboard, matcher, scorekort), ikke bare info-siden/programtidene som før. Bygget:GET /orgs/.../leaderboard,.../sessions/{id}/matchesog.../matches/{id}/scorecardfantes allerede (organisator-/spiller-siden), men krevde org-medlemskap — en ren spectator kunne aldri se dem. Løst ved å ekstrahere den delte kjernelogikken til gjenbrukbare funksjoner (fetch_leaderboardi tournaments.py,fetch_matchesi matches.py,fetch_scorecardi scoring.py — samme "gjort delt"-mønster som tidligere runder), og la tre nye offentlige endepunkter iregistration.pykalle dem etter egen visibility-sjekk.own_team_ids()(blind_draw.py) gjort null-sikker (user_id: str | None) -- en anonym leser har per definisjon ingen egne lag, korrekt oppførsel er tom mengde (ser kun avslørte matcher), ikke en feil. To nye sikkerhetssjekker funnet under DESIGN, ikke i etterkant, samme disiplin som tidligere ADR-018 Beslutning B-lærdommen:session_id/match_idi URL-en må eksplisitt verifiseres å høre til NØYAKTIGtournament_idi samme URL —org_connection()setter kun TENANT-grensen (RLS), ikke at stiens id-er faktisk henger sammen. Uten dette kunne noen med tilgang til én offentlig turnering i en organisasjon lest en HVILKEN SOM HELST økt/match i samme organisasjon (inkl. en privat en) ved å gjette/prøve id-er.- Scorekortet krever eksplisitt at BEGGE lag har låst oppstillingen
(blind draw, ADR-013) — leaderboard/matchliste arver reveal-skjuling
automatisk via
own_team_ids(), men scorekortet har ingen tilsvarende innebygd sjekk. Bruker valgte omfang utover anbefalingen: BÅDE leaderboard+matchliste OG fullt hull-for-hull-scorekort per match i samme runde (anbefalingen var kun de to første). Frontend: ny/t/[id]/live-side (components/public-live.tsx) — fargesegmentert stillingsbar (faktisk + projisert, samme visuelle idé som den org-autentiserte leaderboard-skjermen, men egen enklere implementasjon siden komponentene har ulik autentiseringskontekst), utvidbar øktliste → matchliste → hull-for-hull-scorekort (fargede hull-chips per lag). Lenket fra hovedsiden (public-tournament.tsx) med en ny "Følg live"-knapp. Verifisert grundig mot ferskteecup_scratch(isolertteecup_app_scratch-rolle, isolert scratch-MinIO, engangs API-container): 16 automatiserte sjekker, inkl. en PRESIS test av den nye tenant-vs-sti- sjekken (ikke bare en ukjent id, men en EKTE ANNEN turnering i SAMME org — bekreftet at match/økt fra turnering A fortsatt ikke kan leses via turnering B sin offentlige URL), full blind-draw-skjuling FØR/ETTER reveal for en anonym leser, kode-overstyring (ADR-020) fungerer uendret for de nye endepunktene, scorekort eksplisitt nektet før reveal. Ekte typesjekket produksjonsbuild av frontend, inkl. den nye/t/[id]/live- ruten. Rullet ut live 2026-07-19, bruker bekreftet eksplisitt: ingen migrasjon,docker compose up -d --build teecup_api teecup_frontend, begge containere boot-et rent,/health/dashboard→ 200,teeoff.noupåvirket.
-
"Følg live"-siden koblet til sanntid (2026-07-19, ADR-027): brukeren fulgte anbefalingen fra forrige runde —
/t/[id]/live(bygget i tilskuer-runden samme dag) krevde omlasting for nye resultater. Bygget: ny, RUTEFRI modulapp/realtime.py(in-memory tilkoblingsregister +broadcast_live_update(tournament_id)) -- ligger bevisst BAK alle routere i importgrafen for å unngå en sirkulær import (registration.pyimporterer allerede frascoring.py/tournaments.py/matches.py, ogmessaging.pyimporterer fraregistration.py; en kringkastingsfunksjon i noen av routerne ville derfor bitt seg selv i halen). Kringkastingen er lagt INN Irecompute_and_cache_match_stateogapply_concessionselv (sistnevnte fikk en ny påkrevdtournament_id- parameter) -- kallerne (hole-score/hole-result-innsending, walkover på både match- og turnering-nivå) trenger ikke huske å gjøre noe selv. Nytt WS-endepunkt/ws/public/tournaments/{id}/liveimessaging.py(gjenbruker/ws/*-Caddy-ruten fra ADR-025 uendret -- ingen ny infrastruktur). Sender bevisst kun et "noe endret seg, hent på nytt"- signal, ikke selve dataene -- unngår å duplisere leaderboardets projeksjons-regnestykke/blind draw-filtrering i kringkastings-payloaden. Frontend:components/public-live.tsxåpner en WebSocket ved montering; hver melding teller opp enrefreshKeysom utløser refetch av leaderboardet ALLTID, og av en økts matcher/et scorekort KUN hvis det faktisk er utvidet/åpent på skjermen akkurat da (ingen unødvendige kall for lukket innhold). Liten pulserende prikk lagt til ved siden av "Følg live"-teksten som visuell bekreftelse. Verifisert i scratch: anonym avvist på live-WS for enorg-synlig turnering (samme visibility-sjekk som REST), satt tilpublic, deretter bekreftet FAKTISK sanntidsmottak (ikke bare at REST-svaret så riktig ut) for BÅDE et vanlig hull-resultat OG en walkover-konsesjon -- en åpen WebSocket-tilkobling mottok kringkastings-signalet i begge tilfeller. Leaderboard fortsatt korrekt lesbar over REST etterpå (regresjon). Ekte typesjekket produksjonsbuild kjørt og bekreftet. Rullet ut live 2026-07-19, bruker bekreftet eksplisitt: ingen migrasjon, ingen ny Caddy-endring,docker compose up -d --build teecup_api teecup_frontend, begge containere boot-et rent. Verifisert grundig etterpå:/health/dashboard→ 200,teeoff.noupåvirket, OG et ektewss://-håndtrykk mot den NYE/live-ruten over produksjons-https (ukjent turnering-id, ingen ekte data berørt) ga korrekt 404 fra selve applikasjonslaget. -
Fire brukerrapporterte UI-/UX-hull, DIAGNOSTISERT OG NOTERT, IKKE fikset (2026-07-19): brukeren rapporterte fire ting fra faktisk bruk av
teecup.teeoff.norett før PWA-runden startet. Root cause funnet ved kodegjennomgang for tre av fire (ikke gjettet). Full detalj i FEATURE_BACKLOG.md sin nye seksjon "Rapporterte UI-/UX-hull (2026-07-19)". Kort:- Dashboard-turneringskortet viser "Ingen datoer satt" alltid — leser
tournament.start_date/end_date(eget felt, ADR-015), som INGEN UI-skjema noensinne skriver til. Skal enten få et faktisk skjemafelt, eller kortet bør heller utlede datoen fra øktenesscheduled_at. - Reell, bekreftet rewrite-bug:
/orgs/{id}/membersgir en rå FastAPI-404 ({"detail":"Not Found"}) i stedet for medlemssiden.next.config.mjssinrewrites()returnerer en plain array (implisitt "afterFiles") — DYNAMISKE Next.js-sider sjekkes ETTER rewrites, så/orgs/:path*-proxy-regelen (ADR-016) fanger kallet FØRapp/orgs/[id]/members/page.tsxnoensinne nås. Dette er den FØRSTE frontend-siden som er nestet direkte under et allerede proxyet prefiks — ingen tidligere skjerm har truffet dette. Selve siden/komponenten er riktig bygget, kun ruten dit er blokkert. - Ingen UI-vei til å opprette en ANDRE organisasjon når man allerede har
én —
CreateOrganizationStateidashboard.tsxvises kun ved null org-er. Backend støtter det fullt ut allerede (ADR-021). - Ingen sammendrag/indikator noe sted for "alle runder har fått dato" — må sjekkes manuelt per øktkort på program-skjermen. Ingen av de fire fikset i denne runden — kun dokumentert på brukerens eksplisitte instruks, PWA-runden prioriteres først.
- Dashboard-turneringskortet viser "Ingen datoer satt" alltid — leser
-
PWA: installasjon + full offline scoreregistrering, BYGGET, IKKE ENNÅ RULLET UT (2026-07-19, ADR-028): bruker valgte det mest ambisiøse omfanget (installerbar app OG offline scoreregistrering, ikke bare installasjon), og valgte å generere enkle ikoner nå fremfor å vente på ekte design (med eksplisitt beskjed om at de er midlertidige). Ikoner: ingen
PIL/rsvg-convert/imagemagicktilgjengelig i miljøet — løst med et scratch npm-prosjekt (sharp@0.33.5, node18-kompatibel versjon; nyestesharpkrever node ≥20 og feilet først) som genererte et enkelt grønt golf-flagg-ikonsett (public/icons/icon-192.png,icon-512.png,icon-maskable-512.png) + erstattet den gamlepublic/apple-icon.png(var v0.app sin generiske plassholderlogo, ikke TeeCup-merkevare i det hele tatt). Bygget:app/manifest.ts(Next.js sin innebygde manifest-generator, ikke en statiskmanifest.json),appleWebApp-metadata ilayout.tsx(iOS leser ikke manifest.json for hjemskjerm-oppførsel),components/sw-register.tsx(stille no-op uten SW-støtte), håndskrevetpublic/sw.js(ingen next-pwa/workbox-avhengighet — nettverk først/cache-fallback for navigasjon +/orgs/*-GET-er, BEVISST ikke stale-while-revalidate, se ADR-028 for hvorfor),public/offline.html. Offline scoreregistrering: nylib/offline-queue.ts(IndexedDB-kø, ren klientkode — ikke i SW-en), koblet inn isession-scorecard.tsxsinsubmitStroke/submitHoleResult: sjekkernavigator.onLineførst, køer kun ved en EKTE nettverksfeil (ikke ved et avvist HTTP-svar som "matchen er avgjort" — det vises fortsatt som vanlig feiltekst). Lokalt overlay (pendingStrokes/pendingResults) viser køede verdier umiddelbart, merket "Lagret lokalt · venter på synk". Auto-synk vedwindowsonline-event PLUSS en manuell "Synkroniser nå"-knapp (bevisst IKKE Background Sync API — iOS Safari støtter den ikke). Et definitivt avvist synk-forsøk (f.eks. matchen ble avgjort på en annen enhet mens denne var offline) fjernes fra køen og vises som feilmelding, henger aldri for alltid. Verifisert: ekte typesjekket produksjonsbuild (sammeDockerfilesom deployes) kjørt og bekreftet — alle 16 ruter listet inkl./manifest.webmanifest. Kort container-boot +curlbekreftet manifest/ service worker/ikoner/offline.html alle svarer riktig (200, riktig innhold). IKKE gjort denne runden, viktig å være ærlig om: ingen faktisk nettleser-basert offline-test (Chrome DevTools sin Offline-bryter, faktisk "Legg til på hjemskjerm") — intet nettleserverktøy tilgjengelig i denne økten. Kun kodegjennomgang + build-verifisering. Brukeren bør selv teste scorekort-siden med DevTools Offline-modus før tillit i skarp bruk. Ikke rullet ut ennå — venter på eksplisitt utrullingsbekreftelse. Ingen migrasjon, kunteecup_frontendtrenger redeploy.
Neste steg:
- PWA er bygget, venter på utrullingsbekreftelse — se over. ANBEFAL brukeren å browser-teste offline-flyten selv (DevTools Offline-modus) uavhengig av om/når den rulles ut.
- Fire UI-/UX-hull notert 2026-07-19 (se over) — ingen fikset ennå. Rewrite/medlemsside-bugen (#2) er den mest presserende siden siden er helt utilgjengelig i dag.
- Fortsatt åpne beslutninger fra FEATURE_BACKLOG.md: kode-regenerering for ADR-020, korrigering-godkjenning fra motpart, video/1-til-1-meldinger (bevisst utsatt i ADR-025).
- Flere turneringsformater utover Ryder Cup (Københavner/High-low-high/ Robbins/Try all, notert 2026-07-19) — ingen ADR-runde startet ennå.
- Merk for neste økt:
deploy/Caddyfile-endringen (ny/ws/*-rute, ADR-025) ligger uncommitted i det SEPARATE/opt/teeoff-repoet, ikke iteecup-repoet — samme fallgruve som ADR-016-runden sin Caddy-endring, lett å glemme siden denne økten ellers kun har jobbet i/opt/teecup. - Ved fremtidige nye V0-skjermer/-design i V0 (fortsett i samme prosjekt), FORVENT en full re-eksport hver gang — diff mot live-treet i et scratch-område før noe pakkes ut over eksisterende filer, og sjekk om V0-skjermen bygger inn handlinger backend ikke støtter ennå FØR integrering.