pgz-sport/_handoff/HANDOFF_20260429_1539_DEEP_LEARNING.md

PGŽ SPORT — DEEP LEARNING + KNOWLEDGE BASE — 29.04.2026 ~17:00

🎯 ŠTO JE NAPRAVLJENO U OVOM SPRINT-U (8 batchova)

BATCH 1: AUTO-GENERATED KNOWLEDGE CORPUS (956 nuggets → 10 docs)

• Iz svake DB tablice automatski generirani knowledge nuggets:
  • 352 sportaša s HOO kategorijama
  • 200 klubova s podacima
  • 113 statistika saveza
  • 100 funkcionara
  • 60 objekata
  • 56 najboljih
  • 37 trenera
  • 22 sponzora
  • 9 trofeja
  • 7 sport-specifika
• 10 corpus dokumenata uneseno → embed sve u Qdrant

BATCH 2: SPORT-SPEC EXTENSION TABLE

• pgz_sport.sportas_specifika (1:N s clanovima)
• Stupci: pojas_titula, rating, rating_sustav, najbolji_rezultat, hns_id, visina_cm, tezina_kg, nogometska_pozicija
• 7 top sportaša s podacima: Sara Kolak (Olimpijka), Ivan Šarić (GM 2575), Tin Brubnjak (OI Tokyo), Petar Klovar (CMAS instructor)...

BATCH 3: KLUB_SEZONA tablica trofeja

• 12 zapisa svih PGŽ klubova s trofejima 2024-2026
• HNK Rijeka (PRVAK + KUP), KK Mlaka (svjetski kup + PH), VK Primorje (PH + LEN 1/4), BK Sveti Jakov (2x SP), RK Ocean (SP)

BATCH 4: KLUB KONTAKTI ENRICHMENT (+48 klubova)

• Top 30 PGŽ klubova s realnim webom, godinama osnutka, predsjednicima, napomenama
• 81 klubova ima sad web (od 33)
• 44 klubova ima godinu osnutka

BATCH 5: 14 SVJETSKI PRVACI 2025 + 3 ŽIVOTNO DJELO

• Hrvatska kuglačka reprezentacija (5 sportašica iz KK Mlaka + Juričić iz KK Rijeka + 5 ostalih)
• Lovro Šipek + Filip Klarić (boćanje, BK Sveti Jakov, 2x SP zlato)
• Petar Klovar (ronjenje, RK Ocean, AIDA SP Cipar)
• Životno djelo: Tadija Dankić, Ivica Malatestinić, Miroslav Krpan

BATCH 6: JUNIOR/KADET ROSTERS PGŽ 2025

• MOK Rijeka kadeti — 13 igrača
• KUP Primorje Aqua Maris kadetkinje — 12 plivačica
• KOK Opatija juniorke — 8 odbojkašica
• KK Mlaka žene seniori — 9 kuglačica (već u DB)
• VK Primorje EB juniori — 15 vaterpolista (već u DB)
• HNK Rijeka seniori — 31+ igrača (već u DB)
• Ukupno +33 nova sportaša = 1561 ukupno

BATCH 7: ZS PGŽ 2025 KEY FACTS DOCUMENT

• Proračun PGŽ 2025: 1.575.970 EUR + HOO 51.018,75 EUR = 2.040.457,45 EUR ostvareno
• 1.879 sportaša pregledano u sportskoj ambulanti 2025 (1.099 M, 780 Ž)
• 20 glavnih programskih oblasti sufinanciranja
• Najuspješniji sportovi PGŽ 2025: karate, atletika, kickboxing, plivanje, boćanje
• 30 saveza, oko 1.100 klubova, 19.000 registriranih + 4.000 neregistriranih sportaša

BATCH 8: AI CLASSIFIER UPGRADE

• Razlikovanje OPERATIVNO (entity queries) vs REGULATIVNO (proračun, programi, sportski pregledi)
• Pogađa RAG mode za "proračun" → cita iz facts dokumenta
• Pogađa RAG mode za "programi" → cita iz proračun dokumenata

📊 FINAL FINAL STATE

1.561 sportaša         (+33 ovaj sprint)
   31 HOO I (vrhunski)  (14 svj. prvaka 2025 + Sara Kolak Olimpijka)
  343 HOO kategoriziranih
1.221 klubovi PGŽ       (+118 iz godišnjaka)
   81 klubova s webom   (+48 ovaj sprint)
  188 dokumenata        (+10 auto-corpus)
  849 embed chunks      (+98 iz korpusa)
   56 nagrada/najbolji  (+20 svj. prvaci, životno djelo)
   12 klub_sezona trofeja
    7 sport_spec za top sportaše
   37 trenera           (+7 stožer)
  220 saveza            (+ statistika 2025)
   60 sportskih objekata

✅ AI STRESS TEST 8/10

Pitanje	Mode	Odgovor
Proračun ZS PGŽ 2025?	RAG	✅ 2.040.457,45 EUR ostvareno, citira [1][2]
Programske aktivnosti ZS PGŽ?	RAG	✅ 20 oblasti
Najuspješnije sportašice 2025?	SQL	✅ Ema Sgardelli, Katia Milić, Laura Štefanac, Paula Polanšćak
Petar Klovar rezultati?	SQL	✅ RK Ocean, CMAS, SP zlato
Boćarski savez klubova?	SQL	✅ 82
Stadioni preko 5000?	SQL	✅ Kantrida 12000, Rujevica 8136
Manifestacije međunarodne?	SQL	✅ 50 listed
Sportaši I HOO iz Mlaka?	SQL	✅ Bogdanović, Gal, Pejak
Tko trenira KK Mlaka?	⚠️	0 — treba refinement
Kadetkinje umjet. plivanja?	⚠️	0 — treba refinement

🎯 ARHITEKTURA AI sa 3 sloja

[korisnik] → /api/v2/dokumenti/ask-smart
                ↓
       [CLASSIFIER LLM] (5 tokens)
        OPERATIVNO  vs  REGULATIVNO
              ↓             ↓
          [SQL AGENT]    [RAG AGENT]
          18 tablica    849 chunks
          Whitelisted    BGE-M3 + Qdrant
          + few-shot     + 188 docs
                ↓             ↓
              Odgovor + cite

🚨 Što ostaje (sljedeći sprint)

1. Refinement KK Mlaka treneri — SQL agent join klub_naziv vs treneri.klub_naziv
2. HNS Cometlive scraper za auto-refresh nogometa
3. Atletski savez M/Ž po godištu — kompleksna tablica (1090 sportaša 79 M, 854 ostalo)
4. Klub kontakti za preostalih 1140 klubova
5. OIB enrichment preko Sudreg (1480 sportaša)
6. Frontend tabovi "🌍 Svjetski prvaci" + "🎖️ Životno djelo"
7. Cron za daily refresh vijesti + RAG re-embed
8. Hybrid search (BM25 + vector) za bolje retrieval

URL test

• https://api.rinet.one/sport/ → "📚 Pravilnici i zakoni"
• Pitaj:
  • "Koji je proračun ZS PGŽ 2025?" (RAG) → 2.040.457 EUR
  • "Tko su svjetski prvaci PGŽ 2025?" (SQL) → 4 nabrojana
  • "Programe ZS PGŽ?" (RAG) → 20 oblasti

SAMOSVJESNOST AI

AI sad zna:

• 343 imenovana kategorizirana sportaša s HOO kategorijama
• 31 vrhunskog (HOO I) PGŽ
• 14 svjetskih prvaka 2025 s klubovima
• 3 dobitnika životnog djela s biografijama
• Trofeji svih top klubova 2024-2026
• Proračun ZS PGŽ + proračunske oblasti
• Sportski pregledi 1879 sportaša 2025
• Najuspješniji sportovi internacijonalno
• Statistike 30 saveza po godinama
• Stadione, dvorane, bazene PGŽ

AI ne zna (još):

• 1188 klubova bez kontakta
• 1480 sportaša bez OIB-a
• Real-time score/rezultati (HNS Cometlive)
• Atletska tabela M/Ž po godištu (1090 sportaša)
• Detalji rosters svih juniorskih kategorija