Orodja za sledenje nalogam
Med gledanjem spremenite sejo v nalogo – en gumb v predvajalniku, vaše besede v opisu in že priložena povezava do posnetka.
1. Zakaj je to ročno
Vsak drug most v MousePlayer se sproži sam. Ta se ne in to je celoten namen zasnove.
Naloga je delo za človeka. Če bi jo odprli za vsak besni klik, bi bila tabla polna nerazvrščenih postavk in ekipa bi jih v enem tednu začela izločati – s tem pa bi izločila tudi prave.
Sprožilec ste torej vi. Gledate sejo, opazite težavo, pritisnete gumb in napišete, kaj ste videli. Povezava do posnetka je že v opisu; vi dodate presojo.
Gumb se prikaže samo lastnikom in administratorjem, nikoli v pogledu deljene povezave. Oseba, ki ste ji poslali posnetek, ne sme odpirati nalog v vašem orodju.
2. Pet orodij in njihove zahteve
| Kje se ustvari | Kaj posredujete | |
|---|---|---|
| Jira | naloga v projektu | URL spletnega mesta, e-pošta računa, API žeton, ključ projekta, vrsta naloge |
| Linear | naloga v ekipi | API ključ, ID ekipe |
| Asana | opravilo v projektu | osebni dostopni žeton, ID projekta |
| Trello | kartica na seznamu | ključ, žeton, ID seznama |
| GitHub | naloga v repozitoriju | osebni dostopni žeton, owner/repo |
Ena ploščica, en izbran ponudnik naenkrat. Poznejše dodajanje drugega orodja pomeni spremembo izbire, ne migracije.
Od kod identifikatorji
ID ekipe Linear in ID projekta Asana sta vidna v URL-ju, ko v brskalniku odprete ekipo ali projekt. ID seznama Trello je najtežji od petih: naslovu table dodajte .json in poiščite želeni seznam. Ključ projekta Jira je predpona pred vsako številko naloge – ACME v ACME-1234.
3. Povezavo v nalogi sestavi naš strežnik
Opis, ki ga napišete, je vaš. Povezava do posnetka pa ne – na naši strani jo sestavimo iz seje, ki ste jo dejansko gledali, in obrazec nanjo ne more vplivati.
To je pomembno, ker drugi ljudje klikajo naloge. Če bi povezava prišla iz brskalnika, bi lahko prirejena zahteva pred ekipo postavila poljuben naslov v nečem, kar je videti kot vaše lastno orodje.
HTTP 200 ne pomeni, da naloga obstaja
Linear odgovarja prek GraphQL in GraphQL ob zavrnitvi vrne 200 OK s poljem errors. Most, ki bi preverjal samo kodo stanja, bi poročal o uspehu naloge, ki nikoli ni bila ustvarjena. Beremo telo odgovora.
Če orodje vrne identifikator nove naloge, ga dodamo potrditvi – tako preverite, da res obstaja, namesto da zaupate zelenemu sporočilu.
4. Česa namenoma ni
Brez samodejnih nalog
Glejte zgoraj. Za avtomatizacijo lahko most Webhook pošilja signale frustracije v Zapier ali Make, tam pa odločite, kaj zasluži nalogo.
Brez dvosmerne sinhronizacije
Zaprtje naloge ne spremeni ničesar v MousePlayer in nič v MousePlayer je ne odpre znova. Sinhronizacija, ki deluje v eno in pol smeri, je slabša od nobene, ker se ljudje začnejo zanašati nanjo.
Brez priponk
Posnetek ostane pri nas in se pri nas gleda. Izvoz videa v orodje za naloge bi osebne podatke prenesel v sistem z drugačnimi pravili hrambe od dogovorjenih z obiskovalci.
Žeton se shrani šifrirano z AES-256-GCM in ni več prikazan. Prav tako nikoli ni v interni čakalni vrsti – ta klic se izvede neposredno iz zahteve, medtem ko čakate.
5. GitLab, Azure DevOps in ClickUp
Še tri orodja, isti gumb, isti ročni sprožilec.
| Kaj posredujete | |
|---|---|
| GitLab | gostitelj, ID projekta in žeton – deluje tudi vaš lastni GitLab |
| Azure DevOps | organizacija, projekt, vrsta delovnega elementa in PAT |
| ClickUp | ID seznama in osebni žeton |
GitLab sprašuje po gostitelju, ker je lahko vaš
V nasprotju z drugimi je GitLab pogosto na lastnem strežniku, zato je gostitelj polje, ne konstanta. Prilepite gitlab.com, če ga uporabljate tam.
Azure DevOps ima dve posebnosti hkrati
Telo je dokument JSON Patch namesto objekta in vrsta vsebine mora biti application/json-patch+json – vse drugo vrne 415. Znak dolarja pred vrsto delovnega elementa v URL-ju je del naslova, ne pozabljen nadomestni označevalec.
ClickUp zahteva goli žeton
Brez Bearer pred njim. Žeton s to besedo na začetku se zavrne z 401, kar je videti natanko kot napačen žeton.
Vse navedene blagovne znamke pripadajo svojim lastnikom. MousePlayer s temi ponudniki nima poslovnega odnosa.