PHP Classes

File: USER_GUIDE.md

Recommend this page to a friend!
  Packages of Andraž   BB   USER_GUIDE.md   Download  
File: USER_GUIDE.md
Role: Documentation
Content type: text/markdown
Description: Documentation
Class: BB
Badminton tournament management application
Author: By
Last change:
Date: 15 days ago
Size: 4,567 bytes
 

Contents

Class file image Download

? Uporabni?ka navodila ? Badminton Tournament Manager

Ta dokument opisuje tipi?en potek dela: od ustvarjanja turnirja do vna?anja rezultatov in pregleda kon?ne razpredelnice.

1. Priprava igralcev

Najprej si pripravi seznam igralcev.

  1. V meniju izberi Players / Igralci.
  2. Klikni Add / Dodaj.
  3. Vnesi podatke (npr. ime, priimek, klub?).
  4. Shrani.

To ponovi? za vse igralce, ki bodo nastopili na turnirju.

2. Ustvarjanje turnirja

  1. V meniju izberi Tournaments / Turnirji.
  2. Klikni Add / Dodaj.
  3. Vnesi: - Naziv turnirja (npr. "Badminton Open 2025"), - Datum, - po ?elji lokacijo in opis.
  4. Shrani.

Po shranitvi ima? prazen turnir, v katerega bo? dodal dogodke (kategorije).

3. Dodajanje dogodkov (kategorij)

  1. Na strani turnirja ali v meniju izberi Tournament Events / Dogodki.
  2. Klikni Add / Dodaj.
  3. Izberi: - turnir, na katerega se dogodek navezuje, - naziv dogodka (npr. "Mo?ki pari", "?enske posamezno", "Mix"), - po ?elji dodatne nastavitve (npr. opis, opombe?).
  4. Shrani.

Za vsak turnir lahko ustvari? ve? dogodkov (kategorij).

4. Prijava tekmovalcev na dogodek

Tekmovalec je "ekipa" v posameznem dogodku ? to je lahko: - en igralec (posamezno) ali - par (dva igralca) pri dvojicah.

  1. V meniju ali na strani dogodka izberi Competitors / Tekmovalci.
  2. Klikni Add / Dodaj.
  3. Izberi: - dogodek, - igralca ali igralca 1 + igralca 2 (?e gre za par), - po ?elji ?e opis/opombe (npr. naziv ekipe).
  4. Shrani.

Postopek ponovi? za vse tekmovalce v tem dogodku.

5. Generiranje tekem (parov)

Ko ima dogodek vse tekmovalce vne?ene:

  1. Odpri dogodek (view stran).
  2. Klikni gumb tipa "Generiraj tekme" / "Generate matches" (ime gumba je lahko rahlo druga?no).
  3. Sistem: - pregleda vse tekmovalce v tem dogodku, - generira pare tako, da vsak igra proti vsakemu (round-robin), - poskrbi, da isti par ne nastopi dvakrat, - za vsak par ustvari zapis v `tournament_matches`.

Po generiranju bo? na dogodku videl seznam tekem.

> Opomba: generiranje obi?ajno naredi? ?ele, ko je seznam tekmovalcev dokon?en.

6. Vnos rezultatov

  1. Odpri Tournament Matches / Tekme (obi?ajno filtrirano po dogodku ali preko linka iz dogodka).
  2. Klikni Edit / Uredi pri tekmi, kateri ?eli? vnesti rezultat.
  3. Vnesi rezultat: - odvisno od tvoje implementacije: - bodisi seti (npr. "21:15, 19:21, 21:17"), - bodisi samo kon?ne to?ke, - ali pa ozna?i? zmagovalca in vnese? osnovne podatke.
  4. Shrani.

Po shranitvi:

  • sistem dolo?i zmagovalca,
  • pove?a ?tevilo zmag pri zmagovalcu in porazov pri pora?encu,
  • po potrebi posodobi ?e to?ke / razliko to?k.

7. Spreminjanje rezultatov in ponovni prera?un

?e naredi? napako ali se rezultat spremeni:

  1. Odpri tekmo in ponovno klikni Edit / Uredi.
  2. Popravi rezultat.
  3. Shrani.

Sistem ob tem: - od?teje prej?njo statistiko, - zapi?e novo statistiko, - zagotovi, da so zmage/porazi in morebitne to?ke v tabeli aktualne.

Ni potrebno ro?no popravljati razpredelnice ? vse se prera?una avtomati?no.

8. Pregled razpredelnice (rang lista)

Na strani dogodka (event) ima? obi?ajno zavihek ali tabelo z rezultati, kjer za vsakega tekmovalca vidi?:

  • ime tekmovalca (oz. para),
  • ?tevilo odigranih tekem,
  • zmage,
  • poraze,
  • po potrebi to?ke +/? in razliko,
  • vrstni red (rang).

To ti omogo?a, da na koncu hitro razglasi? zmagovalca in kon?no uvrstitev.

9. Tipi?en potek uporabe

  1. Dodaj vse igralce.
  2. Ustvari turnir.
  3. Ustvari dogodke (kategorije).
  4. Na vsak dogodek prijavi tekmovalce (posamezniki ali pari).
  5. Za vsak dogodek za?eni generiranje tekem.
  6. Med turnirjem vna?aj rezultate tekem.
  7. Po potrebi popravi rezultate ? sistem prera?una statistiko.
  8. Na koncu preglej razpredelnico in dolo?i zmagovalce.

10. Opombe za administratorje

  • pred generiranjem tekem preveri, da ima dogodek vse tekmovalce,
  • ?e po generiranju doda? nove tekmovalce, mora? se odlo?iti, ali: - ponovno generira? tekme (in pobri?e? stare) ali - nove tekme doda? ro?no (odvisno od tvojega scenarija),
  • sistem ne bo sam vzdr?eval "double elimination" ali playoff dreves, ampak je fokus na: - vseh parih brez ponavljanja in - pravilnem prera?unu statistik.

Verzija dokumenta: 1.0 (osnova, prilagodi glede na dejanske gumbe in polja v tvojem UI).