Modules

Sollicitaties

Neem sollicitanten aan of wijs ze af met /sollicitatie. Presets zetten iemand meteen op het juiste rooster met de juiste rang, rollen en bekendmaking.

Met Sollicitaties neemt de staf nieuwe leden aan, of wijst ze af, met één commando. Wat aannemen precies doet (rooster, sectie, startrang, rollen, bijnaam, bekendmaking) stel je per preset in het dashboard in. Zo is "Politie – Aspirant" één keuze in plaats van vijf handelingen.

Instellen

Zet Sollicitaties aan onder Serverinstellingen.
Kies de Sollicitatiestaf: wie /sollicitatie mag gebruiken.
Kies eventueel de Kanalen waar het commando werkt, bijvoorbeeld #uitslagen.
Kies een Logkanaal voor aannames en afwijzingen die niet in een ander kanaal komen.
Klik op Preset toevoegen en stel hem in.
Klik op Opslaan.

Kanalen

Kanalen: /sollicitatie werkt alleen in deze kanalen (en threads daarin). Leeg: overal.
Plaatsen in het kanaal van het commando (standaard aan): aannames en afwijzingen komen in het kanaal waar het commando is gebruikt. Gebruik je het in #uitslagen, dan staan daar alle uitslagen. Heeft een preset een eigen Bekendmaken in, dan gaat die voor.
Anders komen ze in het Logkanaal.

De presets

Aannemen

Met de module Roosters aan:

/sollicitatie aannemen gebruiker rooster

Optie	Wat
`gebruiker`	Wie je aanneemt
`rooster`	De preset, bijvoorbeeld Politie – Aspirant. Je ziet alleen de presets die je mag gebruiken
`roepnummer`	Optioneel. Leeg: het eerste vrije roepnummer van de startrang
`naam`	De naam op het rooster; zonder naam de naam in Discord. Met Naam verplicht aan moet je hem altijd invullen
`opmerking`	Optioneel. Komt in de bekendmaking en de DM

Met de module Roosters uit:

/sollicitatie aannemen gebruiker roepnummer, met optioneel functie (een preset voor rollen, bijnaam en bekendmaking), naam en opmerking.

Zet je Naam verplicht aan, dan is naam in beide gevallen verplicht en staat hij direct na de andere verplichte opties. Het commando past zich binnen een paar seconden na Opslaan aan.

Aannemen doet in deze volgorde:

Zet het lid op het rooster van de preset, met de sectie, de startrang en vandaag als Rang sinds. Staat het lid al op een ander rooster, dan wordt dezelfde persoon gebruikt. Is het roepnummer al bezet of is de reeks van de rang vol, dan stopt het hier en verandert er niets.
Geeft en haalt de rollen van de preset weg.
Zet de bijnaam (alleen zonder rooster; een rooster regelt de bijnaam zelf).
Maakt het bekend: in het kanaal van de preset, anders het kanaal van het commando, anders het logkanaal.
Stuurt het nieuwe lid een DM.

Lukt een stap niet, bijvoorbeeld omdat een rol boven de bot staat, dan staat dat in het antwoord aan jou. De rangbeveiliging van roosters geldt hier niet: de startrang heb je zelf in de preset gekozen.

Controles

Voordat er iets verandert, controleert de bot:

of je de preset mag gebruiken en in het juiste kanaal zit;
dat je niet jezelf aanneemt en dat het geen bot is;
dat er voor dit lid geen aanvraag op goedkeuring wacht;
dat het lid nog niet op het rooster staat, de sectie en rang nog bestaan en het roepnummer vrij is.

Gebruiken meer mensen tegelijk /sollicitatie, dan handelt de bot ze in die server een voor een af. Twee aannames tegelijk krijgen dus nooit hetzelfde roepnummer.

Goedkeuring

Zet bij een preset Goedkeuring nodig aan als bijvoorbeeld trainers iemand mogen voordragen, maar de politieleiding moet goedkeuren.

Een trainer gebruikt /sollicitatie aannemen zoals altijd.
De bot controleert alles en plaatst een aanvraag met Goedkeuren en Afkeuren, in het kanaal bij Aanvragen in of anders het kanaal van het commando. De Goedkeurders worden gepingd (uit te zetten).
Goedkeuren neemt het lid aan zoals aangevraagd (met roepnummer, naam en opmerking) en zet de aanvraag op groen.
Afkeuren vraagt om een reden en zet de aanvraag op rood. Het lid krijgt daar geen bericht over.

Goedkeurders (en wie Server beheren heeft) nemen met die preset meteen aan, zonder aanvraag. Niemand keurt zijn eigen aanvraag goed, behalve wie Server beheren heeft. Per lid kan er één aanvraag tegelijk openstaan.

Afwijzen

/sollicitatie afwijzen gebruiker reden, met optioneel functie. De reden komt in de DM aan de sollicitant en in het logkanaal (beide aan of uit onder Afwijzen).

Presets

Tot 25 presets, bijvoorbeeld één per dienst en startrang.

Instelling	Wat
Naam en Omschrijving	Zo kies je hem bij `/sollicitatie`
Op rooster zetten, Sectie, Startrang	Het rooster waar het nieuwe lid op komt
Bijnaam	Zonder rooster: bijvoorbeeld `[{roepnummer}] {naam}`. Placeholders: `{roepnummer}`, `{naam}`, `{functie}` (maximaal 32 tekens; de naam wordt eerst ingekort)
Rollen geven en Rollen weghalen	Bijvoorbeeld Politie en Aspirant erbij, Burger eraf. De rollen moeten onder de rol van de bot staan
Wie deze preset mag gebruiken	Leeg: alle sollicitatiestaf. Zo laat je bijvoorbeeld alleen de politieleiding politie aannemen
Bekendmaken in	Een eigen kanaal. Standaard: het kanaal van het commando (als Plaatsen in het kanaal van het commando aan staat), anders het logkanaal
Nieuw lid pingen bij de bekendmaking	Pingt het lid boven de bekendmaking
DM aan het nieuwe lid	Een welkomst-DM met roepnummer en rang
Goedkeuring nodig	Met Goedkeurders, Aanvragen in en een ping, zie Goedkeuring

Wie mag wat

De eigenaar, leden met Server beheren en de dashboardrollen van de module mogen alles.
De Sollicitatiestaf mag /sollicitatie gebruiken, met de presets waar zijn rol bij Wie deze preset mag gebruiken staat (of die daar geen rollen hebben).
Goedkeurders van een preset mogen die preset ook gebruiken en aanvragen goed- of afkeuren.

Embeds

Vijf embeds kun je aanpassen (zie Embeds aanpassen): de aanvraag ter goedkeuring, de bekendmaking bij aannemen, de log bij afwijzen, en de twee DM's. In de aanvraag ook {requester} en {status}. Placeholders: {number}, {preset}, {reason}, {reviewer}, en bij aannemen ook {callsign}, {roster}, {section}, {rank}, {roles}, {outcome} en de gegevens van het lid ({user}, {user.displayName}).

Bewaren

Besluiten (wie werd aangenomen of afgewezen, met reden) worden 365 dagen na het besluit gewist. Zie Privacy en gegevens.