Print / PDF: Brug Ctrl+P (Windows) eller Cmd+P (Mac) og vælg Gem som PDF.
Kilde i repository: docs/DartNation-Funktionskatalog.md · Opdateret marts 2026.

DartNation produktkatalog

Denne version beskriver den nuværende platformfunktionalitet med fokus på klubdrift, spiloplevelse, statistik, kommunikation og administration.

Funktionskataloget er opbygget som en professionel reference for klubber, bestyrelser og samarbejdspartnere, der vil forstå både den praktiske værdi og den tekniske dybde i DartNation.

DartNation - funktionskatalog (komplet reference)

Dette dokument beskriver hvad DartNation er, hvad platformen kan, og hvordan den er bygget ud fra den aktuelle kodebase (Next.js + NestJS). Det er en teknisk/produkt-reference, ikke juridisk kontrakt.

Seneste opdatering af kataloget: marts 2026.

PDF / print-version (download)

Den fulde tekst publiceres som statisk HTML (A4-venlig CSS), så brugere kan åbne den og lave PDF via browseren (Udskriv → Gem som PDF):

URL: /DartNation-Funktionskatalog.html
Fil: frontend/public/DartNation-Funktionskatalog.html (bygges ud fra denne Markdown)

Regenerer HTML efter ændringer i kataloget:

npx marked -i docs/DartNation-Funktionskatalog.md -o frontend/public/DartNation-Funktionskatalog-body.html
node scripts/build-catalog-html.cjs

(build-catalog-html.cjs lægger den færdige fil i public/ og sletter den midlertidige body-fil.)

Valgfri binær PDF (kræver Puppeteer; kan være tungt ved første kørsel):

npx md-to-pdf docs/DartNation-Funktionskatalog.md
copy docs\DartNation-Funktionskatalog.pdf frontend\public\DartNation-Funktionskatalog.pdf

(På Mac/Linux: cp i stedet for copy.) Hvis DartNation-Funktionskatalog.pdf findes i public/, er den også tilgængelig på /DartNation-Funktionskatalog.pdf.

1. Hvad DartNation er (overordnet)

DartNation er en webplatform til danske dartklubber og spillere. Den samler:

Medlemskab og klubdrift (flere klubber pr. bruger via medlemskaber, roller, kontingentsporing).
Økonomi pr. klub (indtægter/udgifter, bilag, eksport, kontingentstatus i admin-flow).
Spil (501, cricket, træningsformater, bot, custom games, online mod ven, ranked smart matchmaking).
Statistik og udvikling (kamphistorik, personlige indsigter, trænerassistent/coaching-forslag).
Socialt (opslag, kommentarer, marketplace, venner, chat, notifikationer).
Klubliv (events, kalender, turneringer, hold, klubbeskeder, klub-vs-klub, dokumenter).
Administration (samlet “Administration”-dashboard med økonomi, medlemmer, SMS, sikkerhedslog, integrationer m.m.).
Gamification (XP, levels, badges, streaks, missioner/challenges).

Teknisk stack: Next.js (App Router), NestJS, PostgreSQL (TypeORM), Socket.IO (realtime), planlagte jobs (@nestjs/schedule), filer under GET /uploads/*. Miljøvariabler styrer database, CORS, mail, SMS m.m. i produktion.

2. Roller og synlighed

Medlem (MED) og Administrator (ADM) på brugerniveau; mange administrationssider kræver ADM.
Medlemskab knytter brugere til klubber (memberships); adgang til klubspecifikke data afhænger af aktivt medlemskab.
Lido-administratorer (brugere med medlemskab i “Lido”-klubben) har typisk bredere adgang i admin (fx flere klubber i dropdowns).
Ikke alle ruter og API-kald er synlige for alle – UI og guards afgrænser funktioner.

3. Offentlige sider (uden login)

Rute	Beskrivelse
`/`	Forside
`/login`	Login
`/funktioner`	Marketing: oversigt over nøglefunktioner
`/funktioner/komplet-overblik`	Uddybende punktliste over platformfunktioner
`/om-os`	Om DartNation
`/statistik`	Offentlig statistik (hvor implementeret)
`/spilcenter`	Offentlig introduktion til spilcenter
`/dartklubber`	Kluboversigt
`/tilmeld-klub`	Tilmelding af klub
`/klub/[slug]`	Offentlig klubside (hvor aktiveret)
`/DartNation-Funktionskatalog.html`	Komplet funktionskatalog (print/PDF via browser; kilde: `docs/DartNation-Funktionskatalog.md`).
`/DartNation-Funktionskatalog.pdf`	Binær PDF (valgfri — kun hvis filen er lagt i `frontend/public/` efter `md-to-pdf`).

4. Dashboard – alle hovedruter (`/dashboard/…`)

Fælles navigation (shell), notifikationer, live chat-widget m.m.

4.1 Forside og profil

Rute	Beskrivelse
`/dashboard`	Overblik; blokken «Seneste funktioner» hentes dynamisk fra `GET /site/recent-features` (JSON: `backend/src/site/data/recent-features.json`).
`/dashboard/profil`	Profil (cover, billede, bio, kodeord, privatliv, opslagsfeed, rang, badges, streaks, XP, genbestykkelig sektionrækkefølge). Klubdokumenter (læsning/søgning for medlemmer) ligger som boks kun på egen profil.
`/dashboard/statistik`	Statistik; personlige indsigter `GET /stats/me/insights`; trænerassistent `GET /stats/me/coaching` (JWT).
`/dashboard/challenges`	Udfordringer/missioner, XP og leaderboard-perioder.
`/dashboard/xp-predictions`	XP-forudsigelser: leaderboard (net XP), egen historik, klub-feed for valgt klub (hyldester med klubtilknytning).
`/dashboard/mit-setup`	Dart-setup (grej), deling, likes/kommentarer.
`/dashboard/mit-kast`	Kast/videoer, synlighed på profil.

4.2 Beskeder, socialt, handel

Rute	Beskrivelse
`/dashboard/indbakke`	Indbakke (klub + tråde).
`/dashboard/messenger`	1:1-chat.
`/dashboard/notifikationer`	Notifikationer.
`/dashboard/opslag`	Feed, likes, kommentarer, rapportering.
`/dashboard/venner`	Venner, anmodninger, online-status, live spectate-indstillinger.
`/dashboard/marketplace`	Annoncer, favoritter, kommentarer, admin-features for moderator.

4.3 Spilcenter og kampe

Rute	Beskrivelse
`/dashboard/spilcenter`	Indgang til spiltyper.
`/dashboard/spilcenter/501`	501 mod anden spiller (samme enhed).
`/dashboard/spilcenter/bot`	501 mod bot (niveauer, justerbar modstand).
`/dashboard/spilcenter/ven`	Spil mod ven (delt skærm).
`/dashboard/spilcenter/online`	Online kamp mod ven (synk + realtime).
`/dashboard/spilcenter/smart-match`	Ranked smart matchmaking (ELO, kø, online-pool ± tier).
`/dashboard/spilcenter/custom`	Custom games – regelbuilder og liste.
`/dashboard/spilcenter/custom/play`	Afvikling af custom game.
`/dashboard/spilcenter/3kamp`	3-kamp.
`/dashboard/spilcenter/cricket`	Cricket.
`/dashboard/spilcenter/mickey`	Mickey-format.
`/dashboard/spilcenter/skovhugger`	Skovhugger.
`/dashboard/spilcenter/501-spectate`	Spectate-flow (501).
`/dashboard/spil`	Kampeoversigt.
`/dashboard/spil/[id]`	Kampdetalje.
`/dashboard/traeningskampe`	Træningskampe liste.
`/dashboard/traeningskampe/[id]`	Træningskamp detalje.

XP-forudsigelser i spilcenter (kort): Når modstanderens navn på brættet matcher en registreret bruger (resolver via venne-/brugeropslag), oprettes en spilsession og et kompakt XP-sats-panel kan vises under 501 (on_site/online), Cricket, Skovhugger, Mickey og under 3-kamp (én fælles session gameType: 3kamp for hele forløbet; afregning ved endelig 3-kamp-gem). Vennekampe (/dashboard/spilcenter/ven, online) bruger match-id; venner af spillerne kan også satse (synlighed håndhæves i backend). Ingen penge – kun XP. Se afsnit 5.10.

4.4 Kalender, turneringer, events, klub

Rute	Beskrivelse
`/dashboard/kalender`	Samlet kalender, personlig + klub, ICS-eksport.
`/dashboard/turneringer`	Turneringer (afhænger af rolle).
`/dashboard/events`	Events, tilmelding, fremmøde (klub kan knyttes til event).
`/dashboard/medlemmer`	Medlemsliste.
`/dashboard/medlemmer/[id]`	Medlemsprofil (anden bruger).
`/dashboard/klubber`	Klubliste.
`/dashboard/klubber/[slug]`	Klubprofil i dashboard.
`/dashboard/klub-vs-klub`	KlubArena: oversigt, kampe, turneringer, events, kalender.
`/dashboard/klub-vs-klub/[id]`	Enkelt klubkamp (lineup, delkampe, status).
`/dashboard/holdopstilling`	Hold/teams pr. klub.
`/dashboard/klubbeskeder`	Klubbeskeder (medlemsindbakke).
`/dashboard/klubregler`	Klubregler / site-regler.
`/dashboard/klubprofil-design`	Visuel profil for klub (admin).
`/dashboard/klubdokumenter`	Omdirigerer til `/dashboard/profil?vis=klubdokumenter` (bogmærker). Dokumenter administreres under Administration.
`/dashboard/klub-saeson`	Klub sæson & historik: halvårssæsoner, leaderboard, priser, all-time rekorder (baseret på træningskampe, events m.m.).

4.5 Administration og support

Rute	Beskrivelse
`/dashboard/besog`	Administration (kun ADM): kompakt menu med faner – overblik, Klubassistent, klubbeskeder, henvendelser, SMS, turneringer, events, hold, klubregler, klubprofil-design, klubdokumenter, økonomi, sikkerhedslog, kontakt, klager, opslagsrapporter, marketplace, medlemmer, API-integration (Lido), tilføj klub (Lido).
`/dashboard/kontakt-os`	Kontaktformular.
`/dashboard/indsend-klage`	Klageflow.

4.6 Teknisk / øvrigt

Rute	Beskrivelse
`/tunnel-test`	Udvikling/test (tunnel).

5. Produktfunktioner – punkt til prik (efter tema)

5.1 Medlemskab og brugere

Flere klubber pr. bruger via medlemskaber (aktiv/passiv, kontingenttype).
Admin kan oprette brugere, se lister, kontingentstatus per kvartal, medlemsvækst-serier.
Klub-udelukkelser (bans) via dedikeret API og UI i medlemsadministration.
Login med brugernavn, email eller 8-cifret login-ID (hvor aktiveret).

5.2 Økonomi

Finansposter pr. klub: indtægter/udgifter, kategorier, filtre, eksport.
Bilag på posteringer (upload/download).
Kontingent: forventet vs. registreret betaling per medlem og periode; påmindelser (site-flow).
Admin-“sundhedsscore” og diagrammer (overblik – ikke revisor-godkendt).

5.3 Klubdokumenter

Upload af filer pr. klub (PDF, Office, billeder m.m.), kategorier, fastgørelse, “skal læses”, læsestatus for medlemmer.
Medlemmer: læsning på egen profil (boks “Klubdokumenter”).
Administratorer: fuld administration under Administration → Klubdokumenter (/dashboard/besog?tab=klubdokumenter).
API: /club-documents (liste, upload multipart, download, read, read-status, PATCH, DELETE).

5.4 Klub sæson & historik

Halvårssæsoner (Forår / Efterår som YYYY-H1 / YYYY-H2).
Leaderboard, automatiske sæsonpriser (MVP, checkout, aktivitet, snit, forbedring vs. forrige sæson).
All-time rekorder (checkout, single-game snit, win streak, flest kampe/sejre).
API: /club-seasons/season-keys, /club-seasons/:clubId/overview, /club-seasons/:clubId/all-time.

5.5 Klubassistent (admin)

Regelbaseret overvågning: manglende kontingent, ingen events næste 7 dage, inaktive medlemmer (30+ dage uden login), fald i træningskampe, åbne KlubArena-kampe.
Status (grøn/gul/rød) og handlingsknapper (link til relevant admin-fane eller side).
API: GET /club-assistant/:clubId (ADM + medlem af klub).

5.6 Spil og realtime

Gemte kampe med detaljer (snit, legHistory m.m.) til statistik og sæson/assistent.
Friend matches og online match-køer (casual + ranked/smart).
Socket.IO: chat, presence, notifikationer; online ELO for ranked pool.

5.7 Socialt og indhold

Opslag, kommentarer, likes, rapportering og admin-gennemgang.
Marketplace med favoritter og moderation.
Setups og kastvideoer med feed og engagement.

5.8 KlubArena (club vs club)

Udfordringer mellem klubber, lineup, delkampe knyttet til games, status, leaderboard.

5.9 Integrationer og sikkerhed

Sikkerhedslog (login, admin-handlinger m.m.).
External API (fx DDU-test, generisk fetch).
Mail og SMS (Twilio) i site/admin-flows hvor konfigureret.

5.10 XP-forudsigelser (fuld beskrivelse)

XP-forudsigelser er gamification uden penge: brugere satser kun XP på udfald, mens en kamp stadig er aktiv. Feature er ikke betting med rigtige penge.

Formål og princip

Øge engagement omkring vennekampe og træningskampe i spilcenteret.
Belønne korrekte forudsigelser med XP-udbetaling (multiplikator defineret i backend); forkerte satser taber den indsatte XP; void (annullering) returnerer indsats, fx ved uafgjort checkout eller manglende data.

Hvem kan deltage?

Spillerne i kampen kan satse på sig selv eller den anden deltager (inden for reglerne).
Vennekampe: Brugere der er venner med mindst én af spillerne kan også oprette forudsigelser (API tjekker venskab og synlighed).
Spilcenter / træning: En XP-spilsession oprettes kun når systemet kan mappe begge spillernavne på brættet til to forskellige registrerede brugere (typisk via brugernavn og venneliste/resolve). Kan modstanderen ikke resolves til en bruger, oprettes ingen session og intet panel vises på brættet (ingen støj for “gæste”-navne).

Hvor vises funktionen?

Kontekst	Adfærd
Online/same-enhed 501 (ikke vs_friend)	Session med `gameType` `on_site` eller `online`; panel når session findes.
501 som del af 3-kamp (`from=3kamp`)	Samme 3-kamp-session som øvrige discipliner (samme par brugere).
Cricket, Skovhugger, Mickey	Egen `gameType` (`cricket`, `skovhugger`, `mickey`) eller `3kamp` hvis indlejret i 3-kamp.
3-kamp (samlet)	Én session `3kamp`; kun den afsluttende 3-kamp-gem (`gameType` 3kamp) sender `xpPlaySessionId` — ikke delkampe enkeltvis.
Vennekamp / online mod ven	`friend_match`-kilde via matchId; panel på 501-bræt når kamp kører.

Udfald (outcomes)

Kampvinder (match_winner): Hvem vinder kampen (afledt af gemt kamp / match-resultat).
Højeste checkout (highest_checkout): Afregnes bedst når der findes legHistory / kasthistorik som ved 501; andre spiltyper kan mangle checkout-data → void eller 0 for den del.

Livscyklus

Åben session eller aktiv vennekamp → canPredict true i meta-endpoints.
Bruger placerer forudsigelse: POST /xp-predictions med friendMatchId eller playSessionId, targetUserId, outcomeKind, stakeXp, valgfrit challengeNote, valgfrit supporterClubId (klub-hyldest).
Ved kampafslutning (gem træningskamp med xpPlaySessionId, eller vennekamp complete): backend afregner pending-forudsigelser, opdaterer XP, sætter status won / lost / void.
Realtime: xp_prediction_settled sendes til brugeren via Socket.IO; frontend viser post i notifikationsdropdown og på /dashboard/notifikationer.

Klub-feed

Forudsigelser kan knyttes til en klub (supporterClubId); brugeren skal være medlem af klubben.
GET /xp-predictions/club-feed/:clubId (JWT + klubmedlem): seneste rækker til visning på /dashboard/xp-predictions for valgt klub i ClubContext.

Leaderboard og historik

GET /xp-predictions/leaderboard: netto XP, sejre/tab blandt brugere med afviklede forudsigelser.
GET /xp-predictions/me: brugerens egne forudsigelser på tværs af kilder (friend_match, play_session).

Vigtige API-endpoints (alle JWT unless andet)

Metode	Sti	Formål
POST	`/xp-predictions`	Placér forudsigelse
GET	`/xp-predictions/leaderboard`	Leaderboard
GET	`/xp-predictions/me`	Min historik
GET	`/xp-predictions/club-feed/:clubId`	Klub-hyldest-feed
POST	`/xp-predictions/play-session`	Opret/genbrug åben spilsession (spiller A/B, gameType)
GET	`/xp-predictions/play-session/:id/meta`	Meta + canPredict
GET	`/xp-predictions/play-session/:id/mine`	Mine forudsigelser på session
POST	`/xp-predictions/play-session/:id/cancel`	Annuller session + void pending
GET	`/xp-predictions/friend-match/:matchId/meta`	Meta for vennekamp
GET	`/xp-predictions/friend-match/:matchId/mine`	Mine forudsigelser på match

Træningskampe: POST /games accepterer valgfri xpPlaySessionId for at knytte afregning til session.

UI i spil (implementationsnote)

Panelet er kompakt (feltlabels, ingen lange forklaringer på brættet). Vises ikke under indlæsning eller når der ikke er session/meta.
Fuld produkttekst og klub-feed: /dashboard/xp-predictions.

6. Backend API (NestJS) – moduler og præfix

REST uden globalt API-prefix. Frontend kan proxy’e via Next: /api/dartnation-backend/:path*.

Præfix	Formål
`/auth`	Login, logout, `me`, profil, adgangskode
`/users`	Brugere, admin-oprettelse, søgning
`/clubs`	Klubber
`/memberships`	Medlemskaber, kontingentbetalinger, medlemmer pr. klub, vækst
`/teams`	Hold
`/finance`	Klubøkonomi, bilag
`/bans`	Klub-udelukkelser
`/games`	Kampe, udviklingsstatistik, sletning
`/tournaments`	Turneringer
`/events`	Events og tilmeldinger
`/friend-matches`	Online vennekampe
`/custom-games`	Custom games
`/calendar`	Kalender + ICS
`/club-vs-club`	Klubkampe
`/online-match`	Køer, ELO, smart queue
`/stats`	Stats, `me/insights`, `me/coaching`, admin-aggregat
`/challenges`	Missioner, XP
`/progression`	Progression (hvor eksponeret)
`/rankings`	Ranglister
`/friends`	Venner
`/chat`	Samtaler
`/messages`	Indbakke, klubbeskeder
`/posts`	Feed, moderation
`/setups`	Setups
`/throws`	Kastvideoer
`/marketplace`	Marketplace
`/badges`	Badges
`/upload`	Filer (profil, cover, chat, posts, marketplace, video, finance-dokumenter, klubdokumenter tmp)
`/site`	Klubregler, recent-features, kontakt, klager, club messages, SMS, m.m.
`/security-log`	Sikkerhedslog
`/external-api`	Eksterne kald / DDU
`/club-documents`	Klubdokumenter
`/club-seasons`	Sæson & historik
`/club-assistant`	Klubassistent (admin)
`/xp-predictions`	XP-forudsigelser: placering, leaderboard, historik, play-session, vennekamp-meta, klub-feed

Statiske uploads: GET /uploads/*.

7. Realtid (Socket.IO)

Forbindelse typisk med JWT.
Chat, opkald, notifikationer, presence; bruges bl.a. til online-tælling i smart matchmaking.
xp_prediction_settled: payload med bl.a. predictionId, status (won / lost / void), stakeXp, payoutXp, message — bruges til notifikationer når en XP-forudsigelse er afregnet.

8. Afgrænsning og vedligehold

Enkelte UI-elementer kan være eksperimentelle eller under udvidelse.
Rettigheder og synlighed afhænger af rolle og medlemskab.
Juridiske vilkår, databehandling og support: se jeres live dokumenter – ikke dette katalog.

Slut på funktionskatalog.