# PGŽ SPORT — UPDATE — 29.04.2026 ~12:00 — Auto-kategorizacija po dobi

## Što je dodano u nastavku

### 1. Tablica `pgz_sport.dobne_kategorije`
- 127 kategorija definirano za **17 sportova**
- Polja: sport, naziv, oznaka, min_godina, max_godina, organizacija (HNS/HRS/HKS/HBS/HOO itd.), redoslijed, promocija_dozvoljena
- Pravila iz HR sportskih saveza i međunarodnih (FIBA, FIDE, ITF, World Athletics, FINA, UCI, WT)

### 2. Sportaš shema proširena
- `kategorije TEXT[]` — sve kategorije u koje pripada
- `promocija_kategorije TEXT[]` — kategorije u koje se može promovirati u stariju ekipu
- `spol`, `sport`, `auto_kategorija_calc_at`

### 3. Backend endpointi
- `GET /api/v2/dobne-kategorije/list?sport=X` — sve kategorije
- `GET /api/v2/dobne-kategorije/by-sport` — group by sport
- `POST /api/v2/dobne-kategorije/auto-assign` — body: {datum_rodenja, sport} → primary/additional/promocije/neeligible
- `POST /api/v2/sportas/{id}/recalc-categories` — recalc za pojedinog sportaša
- `POST /api/v2/sportas/recalc-all-categories` — bulk za sve

### 4. Frontend GUI
- `spAddNew` modal sad ima:
  - Sport dropdown (17 sportova)
  - Spol dropdown
  - Datum rođenja
  - **Live preview kategorija** — kad korisnik upiše datum + sport, AJAX poziv vraća primarnu + dodatne + promocije
  - **Checkbox za promocije** — administrator odlučuje da li mladi sportaš ide i u stariju selekciju
- Nova **Dobne kategorije** stranica u sidebar-u — pregled svih kategorija po sportu
- pageSportas profil prikazuje kategorije i promocije kao badges

### 5. Bulk recalc rezultati
- 721 sportaša dobio automatsku kategoriju
- 77 sportaša ima promocije (mladi → stariji)

## STATE NAKON RUN-A

| Metrika | Vrijednost |
|---------|-----------|
| Dobne kategorije definirane | **127** za **17 sportova** |
| Sportaša s kategorijom | **721** (od 1129) |
| Sportaša s promocijom | **77** |
| Funkcionara | 155 |
| Saveza | 220 |
| Klubova PGŽ | 1086 |
| Qdrant | ~58.500 točaka |

## Raspodjela top kategorija
- Boćanje 50+ Veterani: **371**
- Boćanje OPEN Seniori: **227**
- Boćanje U18 Kadeti: 29
- Boćanje U13 Pioniri: 23
- Rukomet OPEN: 21
- Nogomet OPEN: 12
- Košarka OPEN: 7

## Primjer auto-kategorizacije
**Marko Komadina, rod. 2012-05-15, sport: nogomet**
- Starost u sezoni 2026: 14 godina
- Primary: **U15 Mlađi kadeti** (HNS)
- Promocije dostupne:
  - U17 Kadeti
  - U19 Juniori (mogu igrati i seniorsku)

## Sportovi pokriveni
nogomet, rukomet, košarka, odbojka, vaterpolo, plivanje, boćanje, atletika, tenis, stolni tenis, veslanje, jedriličarstvo, biciklizam, karate, judo, taekwondo, šah

## URL-ovi
- /sport/ → sidebar **"Dobne kategorije"** (NEW) — pregled svih kategorija
- /sport/ → "Igrači · Foto" → "+ Novi sportaš" — modal s live preview kategorija
- /api/v2/dobne-kategorije/auto-assign — POST {datum_rodenja, sport}
- /api/v2/dobne-kategorije/list?sport=X
- /api/v2/sportas/{id}/profile — sad vraća kategorije + promocije

## TODO
1. Lokalni PGŽ savezi mogu imati specifične kategorije (npr. PGŽ Liga U13) — dodati po potrebi
2. Spol-specifične kategorije (M vs F) za sportove gdje su odvojene
3. Frontend filter sportaša po kategoriji
4. Cron job — recalc-all-categories prvi dan svakog mjeseca (kategorije se mijenjaju s godinama)
5. Veliko sutra: lokalni klubovi mogu imati svoju "ekipa" strukturu (1. ekipa, 2. ekipa, juniorska)