Gorenjska Fantasy Liga ⚽
Fantasy football aplikacija za 1. Gorenjsko nogometno ligo (MNZG Kranj). Pokriva dve ligi — člane in mladince — vsako s svojimi igralci, krogi, ekipami in lestvico. Uporabniki sestavljajo svoje ekipe iz realnih igralcev lige in zbirajo točke po uradni statistiki zapisnikov.
Ideja
Točke izhajajo iz uradnih zapisnikov MNZ Gorenjska — goli, minute, ohranjene
mreže, kartoni, enajstmetrovke. Zapisniki pa dveh stvari ne povedo, zato ju
določi skupnost z glasovanjem:
- kdo je podal asistenco za posamezni gol,
- na katerem mestu igralec igra — zapisnik označi le vratarja z
(V),
postave pa našteje po številkah dresov, ne po pozicijah.
Pri 5 glasovih za istega kandidata se podatek potrdi in začne šteti.
Izrecno pregledane zgodovinske tekme imajo lahko ohranjen uradni izid in
oznako, da statistika igralcev ni na voljo. Za te tekme ni nastopov, golov
ali glasovanja o asistencah; seštevki in cene uporabljajo le preverjene
nastope, vmesnik pa pokaže nepopolno pokritost zgodovine.
Malteški NL bootstrap ima zaprte servisne prepare/apply/receipt RPC-je in
zasebno potrdilo private_mfa_nl_history.bootstrap_receipt. Pred namestitvijo
zahteva uvoženo tekočo sezono, pregledano arhivsko politiko in nespremenjen
posnetek baze; ne uvaža individualnih statistik. Ločeno zaprto ogrodje
source/import/prices/release zahteva nespremenljivo pregledano pogodbo vira,
zunanje potrjen posnetek nogometa in svežo cenitev istega commita; pogodbe
ali novih odobritev ogrodje ne vpisuje.
Ključne funkcionalnosti
Nemški vir fussball-public uvaža samo celotne preverjene zajeme javnih
zapisnikov. Zasebna tabela private_fussball.identity_map in servisni RPC
fussball_reserve_player_ids ohranita točne profilne identitete; številčni
ključi so interne šifre SLFF, ne registrske številke DFB. Trk ustavi celoten
vpis. Uvoz ne pomeni vklopa lige; postopek je v docs/viri/nemcija.md.
- Sestavljanje ekipe — igrišče s prvo postavo in klopjo: 15 igralcev (2 vratarja,
5 branilcev, 5 vezistov, 3 napadalci), 11 v prvi postavi, največ 3 iz kluba, proračun 100.
- Kapetan — trak prinese trojne točke; če kapetan ne igra, ga prevzame namestnik.
- Samodejne menjave — igralca prve postave brez minut zamenja rezervni iste pozicije.
- Pripomoček Klop+ — enkrat na sezono v izbranem krogu štejejo tudi točke klopi.
- Glasovanje o asistencah — skupnost pove, kdo je podal; pri 5 glasovih se potrdi.
- Glasovanje o pozicijah — zapisnik pozicij ne pove, zato jih določi skupnost.
- Točkovanje — po pravilih lige iz statistike zapisnikov (glej spodaj).
- Rezultati — odigrane tekme; klik na tekmo pokaže obe postavi na igrišču in
točke, ki jih je posamezen igralec na njej zaslužil.
- Lestvica — skupna razvrstitev vseh fantasy ekip lige.
- Mini lige — zasebna lestvica med znanci (tudi čez lige). Povabilo je povezava
/l/KODA
(deljenje prek sistemskega lista, WhatsAppa, Viberja ali kopiranja); po vsakem končanem
krogu tedenski pregled: manager kroga, kapetan, skriti adut, dvigalo, klop in lesena žlica,
vsaka nagrada tudi kot slika z maskoto. Šaljive nagrade le med vsaj 4 ekipami; lastnik jih lahko izklopi.
Ustvarjalec lahko mini ligo objavi v eni ligi (javna mini liga, do 3 na ligo, kratek opis):
drugi jo najdejo na strani Mini lige in se pridružijo brez kode; tujci vidijo le lestvico
(/mini-leagues/:id), prijava lige gre v Administracijo.
- Dve ligi — v glavi se preklaplja med člani in mladinci; vsaka liga ima svoje igralce, svojo ekipo in svojo lestvico.
- Uporabniški računi — registracija in prijava z e-pošto in geslom.
- Pregled kluba/igralcev — seznam ekip in igralcev 1. GNL.
- Administracija — pregled nepopolnih zapisnikov, ročne pozicije, NZS podatki, preračun točk.
Tehnološki sklop
- Frontend: React 18 + Vite + React Router
- Backend / baza: Supabase, self-hosted (PostgreSQL + avtentikacija + PostgREST)
- Slog: Tailwind CSS
- Gostovanje: lasten strežnik pri Hetznerju — self-hosted Supabase in Caddy, spredaj Cloudflare (
docs/migracija-hetzner.md)
Točkovanje
| Točke |
|---|
| Nastop do 60 minut | +1 |
| Odigranih 60 minut ali več (brez sodniškega podaljška) | +2 |
| Gol vratarja / branilca / vezista / napadalca | +10 / +6 / +5 / +4 |
| Asistenca | +3 |
| Brez prejetega gola (vsaj 60 min) — vratar | +5 |
| Brez prejetega gola (vsaj 60 min) — branilec | +4 |
| Brez prejetega gola (vsaj 60 min) — vezist | +1 |
| Zmaga ekipe (vsaj 60 min) — vratar, branilec | +2 |
| Vsaka 2 prejeta gola — vratar, branilec | −1 |
| Obranjena enajstmetrovka | +5 |
| Zgrešena enajstmetrovka | −2 |
| Avtogol | −2 |
| Rumeni karton | −1 |
| Rdeči karton | −3 |
Prejeti goli (in s tem čista mreža) štejejo le tisti, ki padejo, ko je
igralec na igrišču.
Pravila so na enem mestu v src/lib/tockovanje.ts
(prikaz) in v funkciji tocke_za_nastop (izračun v bazi). Vsako pravilo
pokriva test v npm run smoke.
Krog nosi različico pravil (rounds.pravila_tockovanja), da sprememba ne
seže nazaj. Različica 1 (krogi, začeti pred migracijo 20260928100000) je dajala vratarju
za čisto mrežo +4, za zmago nič, prejete gole pa je štela po izidu cele
tekme.
Vrednost igralcev
Cena (4.0–12.0) se izračuna iz statistike prejšnje sezone: goli na 90 minut,
delež tekem brez prejetega gola, rednost nastopanja in disciplina. Igralci z
manj kot 270 minutami dobijo privzeto ceno, da jih en dober nastop ne preceni.
Med sezono ceno premika borza po točkah vsakega kroga, v razponu 4.0–14.0.
Od začetne cene ni omejena: kdor igra dobro vso sezono, lahko pride do 14.0.
Vrednotenje namenoma ne izhaja iz fantasy točk, ker so te odvisne od
pozicije — dokler skupnost pozicij ne izglasuje, bi to precenilo vratarje
(edine z znano pozicijo iz zapisnika).
Administrator lahko doda podatke z NZS (najvišja odigrana liga in minute v njej),
kar ceno dvigne. Iskalnik NZS je v robots.txt prepovedan robotom, zato se ti
podatki vnesejo ročno v Administraciji.
Pravila ekipe
Določena so v src/lib/pravila.js, da so na enem mestu:
| Pravilo | Vrednost |
|---|
| Velikost ekipe | 15 igralcev |
| Vratarji v kadru | 2 |
| Branilci v kadru | 5 |
| Vezisti v kadru | 5 |
| Napadalci v kadru | 3 |
| Prva postava | 11 igralcev |
| Vratarji v prvi postavi | 1 |
| Branilci v prvi postavi | 3–5 |
| Vezisti v prvi postavi | 2–5 |
| Napadalci v prvi postavi | 1–3 |
| Največ igralcev iz istega kluba | 3 |
| Proračun | 100.0 |
| Množitelj kapetana | 3× |
| Pripomoček Klop+ | enkrat na sezono |
| Rok kroga | rounds.deadline_at (privzeto 10:00 na dan tekme) |
Kvota kadra je enaka kot v Premier League Fantasy. Točke zbira prva postava; igralca
brez odigrane minute samodejno zamenja rezervni igralec iste pozicije, kapetan pa šteje
trikratno. V krogu, za katerega je vložen Klop+, se prištejejo še točke vseh štirih
rezervnih igralcev.
Podatkovni model
| Tabela | Opis |
|---|
profiles | Profili uporabnikov, zastavica is_admin, odjava od e-poštnih opomnikov brez_opomnikov in od potisnih obvestil brez_push, avatar (avatar_barva, avatar_ikona), javni_profil, display_name_changed_at |
competitions | Ligi: clani in mladinci (šifra vira, prvi fantasy krog) |
teams | Klubi — skupni obema ligama (grb, ime) |
players | Igralci ene lige (cena, pozicija, vir pozicije); ista oseba je v obeh ligah dve vrstici; anonimiziran_at = ime skrito (GDPR); ugovor proti Scoutu in privolitev sta v zaprti shemi scout |
anonimizirani_igralci | Zgoščeno izvirno ime in šifra anonimiziranega igralca, da ga uvoz še prepozna in nov zapis iste osebe z ugovorom anonimizira (zaprta tabela) |
scout.* | Rezultati nočnega stroja Scout (drzave, modeli, lige_moc, ekipe_elo, kazalniki, indeks, vektorji, vrzeli), ugovori in privolitve igralcev, računi klubov (narocnine, sedezi, dnevnik, opazovani), koledar in prisotnost kluba (dogodki, prisotnost); zaprta shema, glej docs/scout.md |
zahtevki_igralca | Zahtevki "To sem jaz": uporabnik prevzame profil igralca (cakajoc, potrjen, zavrnjen, preklican; potrdil klub, soigralci ali admin). Največ en potrjen na igralca in na uporabnika; piše le prek RPC |
kode_vabil / povabila | Zasebna povabila prijateljev; prvi strežniški čas kvalifikacije (registracija + nehišna ekipa) določa prednost prevzema. Nov prijatelj prestavi zahtevek na vrh, dodatna ekipa istega prijatelja ne |
povezani_igralci | Druge vrstice iste osebe (druga liga, mladinci, prestop), ki jih admin poveže k potrjenemu profilu |
Vsi pogledi imajo stolpec competition_id — vmesnik po njem filtrira izbrano
ligo. Pogled competition_teams pove, kateri klubi igrajo v kateri ligi.
Pogledi: appearance_points (točke nastopa),
player_overview, player_season_stats,
player_standings (lestvica igralcev: točke, forma, na tekmo, izbranost),
minute_kroga, fantasy_round_points (točke ekipe po krogih, z menjavami in kapetanom),
fantasy_team_standings, fantasy_team_budget,
stevilo_ekip_lig (število ekip po ligah, tudi hišnih; okno prvega obiska).
Funkcija ucinkovita_postava(ekipa, krog) vrne igralce, ki v krogu dejansko prinesejo
točke, in njihov množitelj. Funkcija vrh_drzave(drzava, koliko) vrne najboljše
igralce tekoče sezone vseh lig države (stran Slovenija, zavihek Igralci). Funkcija
navijaci_klubov(liga) vrne klube lige z navijači (profiles.navijam_team_id) in
povprečjem njihovih fantasy točk (Lestvica, zavihek Navijači klubov; stran kluba).
Funkcija lestvica_lige(liga, sezona) vrne pravo lestvico lige iz izidov tekem
(stran /table, ne fantasy lestvica). Funkcija isci_igralce(iskanje, omejitev)
poišče igralce vseh aktivnih lig po imenu, brez šumnikov in z dopuščeno tipkarsko
napako (izbirnik lige, stran Igralci).
Skupni stiki s klubi (klub_stik) sprejmejo tudi Nemčijo (DE); pred vsakim
mailom je obvezno preverjanje zgodovine kluba in naslova s scripts/stiki-klubov.mjs.
Varnost (RLS)
- Klubi, igralci, krogi, točke in lestvica so javno berljivi.
- Glasovi o asistencah in pozicijah so javno vidni (skupnost vidi napredek do praga), oddati pa jih je mogoče le v svojem imenu.
- Asistenco in pozicijo potrdi sprožilec v bazi, ne odjemalec — praga ni mogoče obiti iz brskalnika.
- Lastnik profila lahko spremeni le prikazno ime, klub poznavalca in klub, za katerega navija;
is_admin in
datum registracije ureja le servisna vloga.
- Lastnik lahko ustvari in preimenuje fantasy ekipo. Denar, nakupne cene in
kader spreminja izključno
shrani_ekipo, ki preveri lastništvo in obračuna
prodaje ter nakupe. Neposredno pisanje v nabor in brisanje ekipe nista dovoljena.
- Zaklepanje, potrjevanje pozicij in premikanje cen niso javni RPC-ji.
Skrbniška stran za preračun uporablja
admin_preracunaj_krog, ki preveri admina.
rounds.lineups_locked_at zaključi zajem za cel krog, tudi za prazne in
neveljavne ekipe. Shranjevanje po roku najprej posname prejšnji kader, če
cron zamuja; fantasy_teams.roster_updated_at prepreči zajem poznejših sprememb.- Klop+ in Wildcard lahko uporabnik doda, premakne ali prekliče samo pred
določenim rokom kroga iste lige. Preverbo izvaja baza.
- Prevzem profila igralca ("To sem jaz"): zahtevek potrdi odobren poznavalec kluba (sam nastavljen
insider_team_id ne šteje), dva potrjena soigralca istega kluba in lige, enkratna povezava iz maila klubu ali admin; svojega zahtevka nihče ne potrdi. Čakajoči zahtevki niso javni (javen je le pogled potrjeni_igralci). Fotografije zapiše le potrjen lastnik v mapo svojega igralca.
- Preverjeni igralci: vsako branje statusa in dodatkov gre skozi
vidi_preverjene() (stikalo preverjeni_racuni: 0 nihče, 1 admin in testerji, 2 vsi). Dodatke piše le potrjen lastnik z veljavno pravico, ročici gresta skozi prepovedano_besedilo, daljša besedila skozi prepovedane_besede (po besedah); pravico dodeli in odvzame admin ali plačilo (webhook s podpisom Stripe, servisne funkcije preverjen_* le za service_role), preklic, anonimizacija ali izbris računa jo prekliče. Naslovi naročil značk so le za admina.
- Izložba (posnetki): eno pravilo
izlozba_dovoljena(igralec) = stikalo posnetki_igralcev (vidi_posnetke) in je_preverjen in izlozba_odrasla_oseba (brez mladinske ali anonimizirane vrstice osebe). Posnetek je javen in v SLFF Club šele odobren; podpisane naslove R2 (PUT/GET) in žetone Streama izda funkcija le za uid-je, ki jih vrne s klicateljevo glavo. Prostor v R2 () nad 9 GB ustavi nalaganje.
Migracijo 20260913100000_varnost_in_roki.sql namesti pred novim frontendom,
ker ta uporablja novi skrbniški RPC. Migracija ohrani obstoječe posnetke in
zapre vse kroge s pretečenim rokom, tudi trenutni krog, če njegov prvi zajem
še ni stekel. Manjkajočih preteklih postav ne rekonstruira iz današnjih kadrov.
Namestitev načrtuj pred naslednjim rokom, po končanem zajemu že zapadlih krogov.
Zagon lokalno
Potrebuješ Node.js 20+ in Docker (za lokalni Supabase stack).
# 1. namesti odvisnosti
npm install
# 2. zaženi lokalni Supabase (PostgreSQL + Auth + API + Studio)
# prvič potegne nekaj GB Docker slik
npx supabase start
# 3. nastavi okoljske spremenljivke
cp .env.example .env
# URL in anon ključ izpiše `npx supabase status`
# 4. napolni testno okolje (zapisniki, pozicije, demo ekipe)
npm run testno-okolje
# 5. zaženi razvojni strežnik
npm run dev
Aplikacija teče na http://localhost:5173, Supabase Studio na http://localhost:54323,
prestreženo e-pošto pa vidiš v Mailpitu na http://localhost:54324.
Migracije iz supabase/migrations/ se ob supabase start (oz. npm run db:reset)
uporabijo samodejno. supabase/seed.sql vsebuje le demo podatke za prvi zagon —
za prave podatke uporabi uvoz spodaj.
Uvoz pravih podatkov
export SUPABASE_SERVICE_ROLE_KEY=$(npx supabase status -o json | jq -r .SERVICE_ROLE_KEY)
# ČLANI (privzeto tekmovanje)
node scripts/uvoz-zapisnikov.mjs --liga 1502 --pocisti # lanski arhiv, brez demo podatkov
node scripts/uvoz-zapisnikov.mjs # rezultati tekoče sezone
node scripts/uvoz-razporeda.mjs --pisi # krogi, tekme in roki
node scripts/ugani-pozicije.mjs --pisi # ugibanje pozicij
node scripts/ovrednoti-igralce.mjs --pisi # cene iz statistike
# MLADINCI — isto zaporedje z --tekmovanje mladinci
node scripts/uvoz-zapisnikov.mjs --tekmovanje mladinci --liga 1503
node scripts/uvoz-zapisnikov.mjs --tekmovanje mladinci
node scripts/uvoz-razporeda.mjs --tekmovanje mladinci --pisi
node scripts/ugani-pozicije.mjs --tekmovanje mladinci --pisi
node scripts/ovrednoti-igralce.mjs --tekmovanje mladinci --sezona 2025/26 --pisi
Na aktivni ligi ugani-pozicije --pisi (brez --samo-nove) in celotno
ovrednoti-igralce --pisi zavrneta brez --dovoli-aktivno — ljudje imajo te
igralce v ekipah; med sezono cene premika le --tedensko.
Šifra lige na mnzgkranj.si: člani 2025/26 = 1502, 2026/27 = 1601;
mladinci 2025/26 = 1503, 2026/27 = 1603. Brez --liga skripta vzame
tekočo sezono iz competitions.mnzg_liga, tako da je ob novi sezoni treba
posodobiti bazo, ne skript. Prenesene strani se predpomnijo v
scripts/.predpomnilnik/, da ponovni uvoz ne obremenjuje strani MNZ.
Mladinci vsako leto zamenjajo generacijo — kdor ni več dovolj star, gre med
člane. uvoz-razporeda zato iz razporeda razbere, kateri klubi letos igrajo,
in igralce klubov zunaj lige deaktivira, da ne ostanejo na trgu.
Zapisniki so vnešeni ročno in so občasno pomanjkljivi (manjkajoča oznaka
vratarja, postava z 10 igralci). Uvoz jih vseeno prevzame, opozorila pa zapiše
v matches.import_warnings in jih pokaže v Administraciji.
Ukazi
| Ukaz | Opis |
|---|
npm run dev | razvojni strežnik |
npm run build | produkcijski build |
npm run preview | predogled builda |
npm test | end-to-end test proti bazi (RLS, glasovanje, pragovi, točkovanje, proračun) |
npm run test:varnost | regresije pravic in rokov v lokalni transakciji; vse spremembe se razveljavijo |
npm run test:socasnost | sočasno shranjevanje in zaklepanje prek ločenih povezav v lokalno bazo |
npm run test:sources | dekoderji, novi viri, podatkovni audit in vključitev Nemčije brez baze |
npm run test:novanet / npm run test:dfb | regresije dejansko zajetih španskih in nemških zapisnikov |
npm run smoke | izris vseh strani + vsa pravila točkovanja in sestave ekipe |
npm run db:start / db:stop | zagon/ustavitev lokalnega Supabase |
npm run db:reset | ponovna uporaba migracij in seed podatkov |
npm run testno-okolje | postavi testno bazo od nule: reset + uvoz + pozicije + demo ekipe |
npm run typecheck | preverjanje tipov (TypeScript) |
npm run tipi | regeneracija src/lib/baza.types.ts iz lokalne baze |
Okoljske spremenljivke
Ustvari .env datoteko (glej .env.example) — za lokalni razvoj vpiši
vrednosti, ki jih izpiše npx supabase status:
VITE_SUPABASE_URL=http://127.0.0.1:54321
VITE_SUPABASE_ANON_KEY=sb_publishable_... # lokalni, ne produkcijski
SUPABASE_SERVICE_ROLE_KEY=sb_secret_... # samo lokalno; rabita ga npm test in uvoz
.env je v .gitignore in ne sme v repozitorij.
Zakaj je .env.production vseeno v repozitoriju. Vsebuje samo URL in
publishable ključ, ki ju brskalnik tako ali tako prenese v bundlu — nista
skrivnost. Podatke varuje RLS (vseh 24 tabel jo ima vklopljeno), ne ta ključ.
Skrivni ključ (sb_secret_… / SUPABASE_SERVICE_ROLE_KEY) obide RLS in ne sme
nikoli v git — v CI je shranjen med GitHub Secrets.
Razvojni strežnik opozori, če je priklopljen na oddaljeno bazo, in
npm run testno-okolje se proti nelokalnem URL-ju sploh ne zažene.
Mobilna aplikacija
Ista spletna stran, zapakirana s Capacitorjem (ios/, android/,
capacitor.config.ts). Gradnja in odločitve: docs/mobilna-aplikacija.md;
objava v App Store in Google Play, besedila in grafike: docs/trgovine/.
npm run build && npx cap sync # dist/ → ios/ in android/
npx cap open ios # Xcode
Objava (deploy)
Objavo naredi CI (.github/workflows/ci.yml), ne Vercelova Git povezava.
Ob vsakem pushu na main: preverjanje (tipi, build, izris) → objava →
potrditev, da produkcija res streže ta commit.
Zadnji korak ni odveč. 3. septembra 2026 se je Vercelova povezava z GitHubom
podrla, ker se je repozitorij preimenoval (lovrosplichal →
Lovro-splichal-orhanizagi); GitHub staro pot tiho preusmerja, Vercel pa ne.
Deploy se je nehal dogajati, nikjer ni bilo napake in produkcija je dva dni
stregla staro različico. Zato build v HTML zapiše
<meta name="slff-commit">, CI pa po objavi preveri, da je v zraku res on.
Za objavo potrebuje tri skrivnosti v Settings → Secrets and variables →
Actions:
| Skrivnost | Kje jo dobiš |
|---|
VERCEL_TOKEN | vercel.com → Account Settings → Tokens → Create |
VERCEL_ORG_ID | Vercel projekt → Settings → General → Team/Account ID |
VERCEL_PROJECT_ID | Vercel projekt → Settings → General → Project ID |
Brez njih se objava preskoči z opozorilom (CI ne pade zaradi tega), potrditev
deploya pa vseeno pove, da je produkcija stara.
Ker objavlja CI, naj bo Vercelova Git povezava odklopljena (Vercel projekt
→ Settings → Git → Disconnect) — sicer se ob vsakem pushu zgradita dva
deploya.
Načrt razvoja (roadmap)
Podatki lige
Podatki o klubih, igralcih in rezultatih 1. Gorenjske nogometne lige: MNZG Kranj
Licenca
Osebni/skupnostni projekt. Dodaj licenco po želji (npr. MIT).
Štiri dodatne nemške Regionallige imajo ločen varovan uvoz/vklop iz
odobrenih DFB zajemov (uvoz-dfb-regije.yml, vklop-dfb-regije.yml).
Servisni RPC varen_vklop_dfb_regije privzeto samo preveri stanje;
postopek in dokazi.
Pregledani koledarji Nord/West uporabljajo ločen manifest DFB v4 in zasebna
SQL vrata (20261018223000); vse statistike, cene in prihodnji rok ostanejo
obvezni. Koledarski dokaz ne dovoljuje manjkajočih zgodovinskih statistik.
Sestavljeni DFB v4 podpira točni zgodovinski politiki Nord2/West8
(20261018231000), atomarno namestitev označb pred uvozom in ločeno
preverjanje vseh znanih statistik. Tekoča sezona ostane strogo popolna.
