Kilpailu-moduuli
Kilpailu-moduuli on Hobin moduuli seuran kilpailujen järjestämiseen. Se sopii ylläpitäjille ja joukkueen vastuuhenkilöille — tämä sivu kuvaa käytännön toimintaa, ei teknistä API-dokumentaatiota.
Profiileille moduuli näkyy nimellä Kilpailut. Tekninen tunniste järjestelmässä on competition (URL-polut, API, oikeudet).
Kilpailujoukkue ei ole sama asia kuin joukkueurheilun kausijoukkue. Tämä moduuli vastaa kysymykseen kuka on ilmoittautunut tähän kilpailuun, ei siihen kuka treenaa millä joukkueella viikoittain.
Johdanto
Moduuli kattaa:
- Kilpailut — nimetty kilpailu omalla sivullaan (
/comp/{slug}), ilmoittautumisikkunalla ja ilmoittautumistavalla. - Kilpailujoukkueet — joukkue rosterineen ja vastuuhenkilöineen; joukkue luodaan ja sitä hallitaan osoitteessa
/comp. - Ilmoittautuminen (entry) — yksi joukkue ilmoittautuu yhteen kilpailuun. Ilmoittautuminen voi vahvistua heti tai jäädä odottamaan seuran vahvistusta.
Tyypillisiä käyttötapauksia: seuran sisäinen kilpailu tai turnausjakso, johon joukkueet ilmoittautuvat etukäteen.
Esimerkkiympäristössä Esimerkki turnaus on testi-kilpailu, esimerkiksi /comp/hob-open. Etusivulla on linkki Kilpailut (/comp).
Sanasto
| Käsite | Selitys |
|---|---|
| Kilpailu | Yksi seuran järjestämä kilpailu: nimi, slug, valinnaiset ajat ja ilmoittautumisikkuna. |
| Slug | Kilpailun tekninen tunnus URL-osoitteessa. Kilpailu avautuu osoitteessa /comp/{slug}. |
| Kilpailujoukkue | Tämän moduulin joukkue: rosteri ja vastuuhenkilöt. Ei ole joukkueurheilun kausijoukkue. |
| Ilmoittautuminen (entry) | Yhden kilpailujoukkueen ilmoittautuminen yhteen kilpailuun. |
| Yleinen manageri | Joukkueen vastuuhenkilö, joka voi hallita rosteria ja muita vastuuhenkilöitä sekä ilmoittaa joukkueen kilpailuun. Joukkueen luoja saa tämän roolin. Muut vastuuhenkilöt, joiden rooli on vapaateksti, eivät voi ilmoittaa joukkuetta. |
| Ilmoittautumisikkuna | Aika, jolloin uusia ilmoittautumisia otetaan vastaan. Ikkunan ulkopuolella ilmoittautuminen on kiinni. |
| Osallistumismaksu | Valinnainen joukkuekohtainen kertasumma, joka veloitetaan joukkueen yleiseltä managerilta, kun seura hyväksyy odottavan ilmoittautumisen. Odottavasta ilmoittautumisesta ei veloiteta. Tyhjä tai nolla tarkoittaa, ettei maksua ole. Summa lukittuu hyväksyntähetkellä. |
Kenelle sopii?
- Seurat, jotka järjestävät kilpailuja, joihin ilmoittaudutaan joukkueena
- Tilanteet, joissa joukkue kootaan ennen ilmoittautumista
- Kilpailut, joissa seura haluaa vahvistaa ilmoittautumisen ennen kuin joukkue on mukana
Profiilin näkymä
Osoitteessa /comp (Kilpailut):
- Kilpailut — seuran kilpailut. Jokaisesta avautuu sivu
/comp/{slug}. Jos ilmoittautuminen ei ole auki, se näkyy suljettuna. Listaa voi selata ilman kirjautumista. - Omat joukkueet — joukkueet, joissa profiili on mukana. Listassa näkyy, mihin kilpailuihin kukin joukkue on ilmoittautunut. Omat joukkueet, joukkueen luonti ja liittyminen edellyttävät seuran profiilia — pelkkä Hob-tili ei riitä.
- Luo joukkue — seuran profiili voi luoda kilpailujoukkueen. Luoja tulee joukkueen vastuuhenkilöksi roolilla yleinen manageri. Jos Hob-tilillä ei vielä ole profiilia tässä hob-ympäristössä, pitää ensin liittyä ympäristöön. Luonnissa voi valinnaisesti valmistella joukkueen avoinna olevaa kilpailua varten: kilpailun rosterikentät kopioituvat uudelle joukkueelle, jotta pelaajatiedot voi täyttää etukäteen. Joukkuetta ei ilmoiteta kilpailuun tällä valinnalla.
- Liity joukkueeseen — jos profiili ei ole vielä millään kilpailujoukkueella, hän voi syöttää yleisen managerin kutsukoodin ja liittyä joukkueeseen. Ilman profiilia kutsukoodia ei voi käyttää.
Joukkueen sivu /comp/team/{id} (kun profiili voi hallita joukkuetta):
- Pelaajat — yleinen manageri lisää rosterille oman profiilinsa ja aliprofiilit (esimerkiksi lapset). Samasta pelaajan lisäyksestä hän voi myös luoda uuden aliprofiilin (lapsen), joka tulee rosterille ja hänen hallintaansa. Muita seuran profiileja ei voi lisätä tästä listasta. Organisaatioprofiilia ei voi lisätä pelaajaksi. Yleinen manageri voi myös poistaa pelaajan rosterilta. Muut pelaajat tai vastuuhenkilöt eivät voi poistaa pelaajia.
- Kutsu pelaaja — samasta pelaajan lisäyksestä yleinen manageri voi luoda jaettavan kutsukoodin. Kutsuttu profiili syöttää sen
/comp-sivulla kohdassa Liity joukkueeseen, vahvistaa liittymisen ja jakaa etunimen, sukunimen, sähköpostin ja puhelinnumeron vahvistuksessa listatuille vastuuhenkilöille. Liittymisen jälkeen nämä vastuuhenkilöt näkevät nuo yhteystiedot. - Lisätiedot — jos joukkueella on rosterikenttiä (esimerkiksi numero), ne voi täyttää rosterilla. Jos kilpailu vaatii pakollisia rosterikenttiä, yleinen manageri ei voi ilmoittaa joukkuetta ennen kuin ne on täytetty jokaiselle pelaajalle.
- Vastuuhenkilöt — yleinen manageri lisää ja poistaa vastuuhenkilöitä. Rooli on vapaateksti (esimerkiksi valmentaja). Organisaatioprofiilia ei voi lisätä vastuuhenkilöksi.
Kilpailun sivulla /comp/{slug} joukkueen yleinen manageri ilmoittaa joukkueen, kun ilmoittautuminen on auki. Ennen ilmoittautumista hän voi valmistella olemassa olevan joukkueen samaa avoinna olevaa kilpailua varten: kilpailun rosterikentät kopioituvat joukkueelle, jotta pelaajatiedot voi täyttää etukäteen. Valmistelu ei ilmoita joukkuetta. Muut pelaajat tai vastuuhenkilöt eivät voi ilmoittaa joukkuetta. Jos kilpailu vaatii seuran vahvistuksen, ilmoittautuminen jää odottamaan hyväksyntää. Seuran henkilökunta voi hyväksyä sen (joukkue merkitään ilmoittautuneeksi) tai hylätä sen (ilmoittautuminen poistetaan, eikä joukkue ole mukana). Muuten ilmoittautuminen merkitään heti ilmoittautuneeksi.
Kun kilpailulla on osallistumismaksu ja henkilökunta hyväksyy odottavan ilmoittautumisen, joukkueen yleiseltä managerilta veloitetaan tuo kertasumma. Avoin maksu (kilpailun nimi, joukkueen nimi ja jäljellä oleva summa) näkyy yleisen managerin omalla sivulla. Hän maksaa tuon ilmoittautumisen viitenumerolla. Odottavasta ilmoittautumisesta ei veloiteta; hylkääminen poistaa sen ilman veloitusta.
Perhetilillä voi hallita aliprofiileja samalla tilillä: olemassa olevat aliprofiilit voi lisätä rosterille, tai uuden aliprofiilin voi luoda pelaajaa lisättäessä. Organisaatioprofiili ei kelpaa pelaajaksi eikä vastuuhenkilöksi.
Ylläpidon näkymä
Kilpailut (nimi, slug, ajat, ilmoittautumisikkuna, vaatiiko ilmoittautuminen vahvistuksen, rosterilomake ja valinnainen joukkuekohtainen osallistumismaksu) voi luoda ja päivittää MCP-avustimella. Pelkällä nimellä luotu kilpailu on ilmoittautumiselle auki, kunnes ikkuna asetetaan. Kilpailun voi poistaa vain, jos sillä ei ole ilmoittautumisia. Profiilit näkevät kilpailut osoitteessa /comp, kun ne on määritelty.
Hallintapaneelissa ei ole vielä kilpailukohtaista luontinäkymää eikä turnausryhmittelyä. Seuran henkilökunta voi hyväksyä tai hylätä odottavan ilmoittautumisen. Odottavan ilmoittautumisen hyväksyntä veloittaa joukkueen yleistä manageria, jos kilpailulla on osallistumismaksu. Pelaajakutsut ovat joukkueen sivulla, ei hallintapaneelissa.
Käyttöoikeudet
| Rooli | Oikeudet |
|---|---|
| Ilman kirjautumista | Näkee kilpailulistan osoitteessa /comp |
| Hob-tili ilman profiilia | Näkee kilpailulistan, mutta ei voi luoda joukkuetta eikä käyttää kutsukoodia ennen kuin liittyy hob-ympäristöön |
| Kirjautunut profiili | Näkee omat joukkueet, voi luoda kilpailujoukkueen ja liittyä joukkueeseen kutsukoodilla |
| Yleinen manageri | Hallitsee joukkueen rosteria ja vastuuhenkilöitä osoitteessa /comp/team/{id} (lisää ja poistaa pelaajia), voi kutsua pelaajan jaettavalla koodilla ja ilmoittaa joukkueen kilpailuun, kun ilmoittautuminen on auki |
| Seuran henkilökunta | Voi hyväksyä tai hylätä odottavan ilmoittautumisen. Kilpailun voi luoda, päivittää ja poistaa (jos ilmoittautumisia ei ole) MCP-avustimella |
Integraatiot
Kilpailujoukkueet ja ilmoittautumiset kuuluvat tähän moduuliin. Valinnainen joukkuekohtainen osallistumismaksu veloitetaan Hobin maksujen kautta, kun henkilökunta hyväksyy odottavan ilmoittautumisen. Kilpailun voi määritellä MCP-avustimella; joukkueen ilmoittaminen, ilmoittautumisen hyväksyntä ja joukkueen luonti eivät ole MCP:ssä. Jäsenluokkaan voi liittää mukautetun automaatiosäännön, joka hakee jäsenyyttä jokaiselle joukkueen pelaajalle, kun henkilökunta hyväksyy ilmoittautumisen; odottava ilmoittautuminen ei hae, eikä jo haettua jäsenyyttä haeta uudestaan. Tämä ei ole valmis sääntö jäsenluokan listassa. Jäsenyysehtoja ilmoittautumiselle (vain jäsenet) ei ole vielä tässä näkymässä.
Käytännön vinkkejä
- Luo joukkue ja lisää pelaajat ennen ilmoittautumista — ilmoittautuminen kiinnittää olemassa olevan joukkueen kilpailuun. Voit lisätä omat profiilit, luoda uuden aliprofiilin pelaajaa lisättäessä tai kutsua pelaajan koodilla. Jos kilpailulla on pakollisia rosterikenttiä, valitse luonnissa kyseinen kilpailu valmisteluksi, valmistele olemassa oleva joukkue kilpailun sivulla tai täytä kentät rosterilla ennen ilmoittautumista.
- Vain joukkueen yleinen manageri voi ilmoittaa joukkueen. Varmista ilmoittautumisikkuna: sen ulkopuolella joukkuetta ei voi ilmoittaa.
- Jos kilpailu vaatii vahvistuksen, joukkue ei ole mukana ennen seuran hyväksyntää. Hylätty odottava ilmoittautuminen poistetaan, eikä siitä veloiteta. Jos kilpailulla on osallistumismaksu, hyväksyntä veloittaa yleistä manageria; hän maksaa ilmoittautumisen viitteellä.
- Kokeile esimerkkiä osoitteessa hob.fi/ex_competition (avaa Kilpailut; liity ympäristöön, jotta voit hallita joukkueita).