Administrativne zahteve

wkrequest odgovori na vprašanje, ki ga zaslon z zaporo odpre in ga je doslej puščal brez odgovora: kaj pa zdaj? Iz »obrnite se na skrbništvo« naredi strukturirano, sledljivo zahtevo – vloženo tam, kjer je nekdo obtičal, obdelano v enem nabiralniku in odločeno na površini, ki ji sprememba pripada.

Hitri začetek: prva administrativna zahteva in njena rešitev – najkrajša pot do prvega rezultata, v štirih korakih.

Ustvarite slepo ulico → Vložite zahtevo → Odprite nabiralnik → Najprej delo, nato zaznamek

• Prošnja skrbništvu se pojavi tam, kjer je nekdo obtičal – in samo tam, kjer bi kaj koristila. Okvir razvrsti poti: račun, ki si lahko v tridesetih sekundah pomaga sam, dobi samopomoč kot prvo možnost in zahtevo kot zadnjo; račun brez kakršne koli pravice dobi zahtevo kot prvo.
• Sedem vrst zahtev, od Zahtevaj dostop do Zahtevaj administrativno spremembo. Natanko dve je mogoče vložiti brez prijave – tisti dve, ki opisujeta človeka, ki se ne more prijaviti.
• Druga zahteva za isto zadevo se pripne obstoječi, ne shrani se dvakrat. Uporabnik, ki ne more naprej, gumb pritisne še enkrat; to ni zloraba, nabiralnik, poln kopij istega položaja, pa bi bil slabši odgovor.
• Šest stanj s končnimi točkami: Odprto, V obravnavi, Odobreno, Zavrnjeno, Rešeno, Umaknjeno. Umaknjeno lahko izbere samo oseba, ki je zahtevo vložila, in samo dokler nihče ni odločil.
• Nič skrivnega ne potuje zraven. Kontekst gre skozi natanko eno mesto, ki zavrača po imenu ključa in po obliki vrednosti – in vrednost nadomesti, namesto da bi jo odstranilo, da zavrnitev ostane vidna.

Zahteva je zaznamek, ne odobritev. V tem paketu ni programske poti, ki bi lahko kar koli dodelila. »Odobreno« ničesar ne dodeli, »Rešeno« ničesar ne izvede; sprememba se zgodi na površini, ki ji pripada, tu pa se samo zabeleži. Potrditveno besedilo to pove v istem stavku kot uspeh, ker bi golo »poslano!« bralec razumel kot obljubo.

Odobreno in Rešeno sta dve različni stvari. Med »nekdo naj dobi dostop« in »pravilo je zapisano« je prav tista vrzel, v kateri se zahteva pozabi.

Zahteva brez seje je trditev. Shrani se kot nepreverjena, na seznamu in v podrobnem pogledu je označena, v nabiralniku pa je to izrecno zapisano: v obrazec lahko vsakdo vpiše katero koli ime. Preden ukrepate, po drugi poti ugotovite, kdo sprašuje.

Vnaprej izpolnjen kontekst je podpisan. Kar zaslon z zaporo vstavi v svojo povezavo, je podpisano s sejno soljo wikija. Kar se vrne, se bodisi preveri – tedaj je ob tem ugotovil wiki – bodisi ohrani samo svojo vrsto in je označeno z navedla oseba, ki prosi. Pokvarjen podpis zahteve nikoli ne zavrne; to bi bil način, kako drugim preprečiti, da prosijo.

To ni sistem za zahtevke. Ni dodeljevanja, ni prioritet, ni rokov, ni niti komentarjev, ni nastavitev obveščanja. Vsaka od teh stvari bi bila prava zmožnost pravega izdelka – in vsaka bi iz paketa naredila drugo orodje za sledenje delu ob wkdoworkitems, ki to že je.

Skrbništvo → Administrativne zahteve, neposredno /doku.php?do=admin&page=wkrequest. Ob menijskem vnosu je število odprtih zahtev.

Nastavitve so v Splošnih nastavitvah, razdelek wkrequest:

Za ta paket stran z diagnostiko v wikiju še ni napisana; diagnostična navodila so v repozitoriju paketa, v datoteki docs/troubleshooting.md.

Vtičnik zahtevo sproži prek pomočnika, ne da bi moral ta paket obstajati:

$req = plugin_load('helper', 'wkrequest');
if (is_object($req) && method_exists($req, 'requestAction')) {
    $dejanje = $req->requestAction([
        'type'       => 'ACCESS_REQUEST',   // edini obvezni podatek
        'resource'   => $id,
        'reasonCode' => 'acl_denied',
    ]);
}

Obe preverjanji sta hišna navada: vaš vtičnik se naloži tudi, če wkrequest manjka, in tedaj preprosto ne ponudi zahteve, namesto da bi se prekinil. requestAction() poleg tega vrne vnos z available ⇒ false, kadar vrste zahteve tu ni mogoče vložiti – okvir ga tedaj izpusti. Mesto, kjer metodo uporabite, zato ne potrebuje lastnega razlikovanja primerov: vnos pripnete brezpogojno, gumb pa se pojavi samo tam, kjer bi deloval.

Vtičnik, ki ponuja površino, na kateri se neka vrsta zahteve reši, se prijavi na dogodek WKREQUEST_REGISTER_HANDLERS. Tako zabeleženi pristojni se shrani kot ključ in razreši šele ob prikazu – niz iz drugega vtičnika tako nikoli ne postane povezava, na katero bi kliknil skrbnik.

Celoten opis pogodbe, dogodkov in podatkovnega modela je v repozitoriju paketa, v datoteki docs/api-reference.md.

• Hitri začetek: prva administrativna zahteva in njena rešitev
• wkidentity – postopki, od katerih je odvisen primer zaklenjen brez drugega dejavnika
• wkcore, wkstorage in wksqliteds – paketi, brez katerih ni mogoče zabeležiti nobene zahteve
• Razširitve DokuWikija – seznam paketov

• Ime: Wolfgang van der Stille (The White Knight Labs)
• E-pošta: Wolfgang.van.der.Stille@gmail.com
• Licenca: GPL 2