Alati za praćenje problema
Pretvorite sesiju u tiket dok je gledate — jedno dugme u plejeru, vaše reči u opisu i već dodat link do snimka.
1. Zašto je ovaj most ručni
Svaki drugi most u MousePlayer-u pokreće se sam. Ovaj ne, i to je ceo smisao dizajna.
Tiket je posao za osobu. Kada bismo otvarali jedan za svaki klik iz frustracije, tabla bi se napunila stavkama koje niko nije procenio i za nedelju dana tim bi ih filtrirao — a tada bi bili filtrirani i stvarni problemi.
Zato ste vi okidač. Gledate sesiju, vidite problem, pritisnete dugme i napišete šta ste videli. Link do snimka je već u opisu; vi dajete procenu.
Dugme se pojavljuje samo vlasnicima i administratorima, nikada u prikazu deljenog linka. Osoba kojoj ste poslali snimak ne treba da može da otvara tikete u vašem alatu.
2. Pet alata i šta je svakom potrebno
| Gde završava | Vi dajete | |
|---|---|---|
| Jira | problem u projektu | URL sajta, imejl naloga, API token, ključ projekta, vrstu problema |
| Linear | problem u timu | API ključ, ID tima |
| Asana | zadatak u projektu | lični pristupni token, ID projekta |
| Trello | kartica u listi | ključ, token, ID liste |
| GitHub | problem u repozitorijumu | lični pristupni token, owner/repo |
Jedna pločica, jedan izabrani pružalac u datom trenutku. Kasnije dodavanje drugog alata je promena izbora, a ne migracija.
Odakle dolaze identifikatori
ID tima Linear-a i ID projekta Asana-e vidljivi su u URL-u kada otvorite tim ili projekat u pregledaču. ID Trello liste je najteži od pet: dodajte .json URL-u table i potražite željenu listu. Ključ Jira projekta je prefiks ispred svakog broja problema — ACME u ACME-1234.
3. Link u tiketu pravi naš server
Opis koji unesete je vaš. Link do snimka nije — sastavlja se na našoj strani iz sesije koju ste zaista gledali i obrazac ne može da utiče na njega.
To je važno jer na tiket klikću drugi ljudi. Kada bi link dolazio iz pregledača, posebno sastavljen zahtev mogao bi da stavi bilo koju adresu pred vaš tim unutar nečega što izgleda kao vaš alat.
HTTP 200 ne znači da tiket postoji
Linear odgovara preko GraphQL-a, a GraphQL pri odbijanju odgovara sa 200 OK i nizom errors. Most koji gleda samo statusni kôd prijavio bi uspeh za tiket koji nikada nije napravljen. Čitamo telo.
Kada alat vrati identifikator novog problema, stavljamo ga u potvrdu — tako možete da proverite da zaista postoji umesto da verujete zelenoj poruci.
4. Šta ovde namerno ne postoji
Bez automatskih tiketa
Pogledajte iznad. Ako želite automatizaciju, webhook most može da šalje signale frustracije u Zapier ili Make, a tamo odlučujete šta zaslužuje tiket.
Bez dvosmerne sinhronizacije
Zatvaranje tiketa ništa ne menja u MousePlayer-u i ništa u MousePlayer-u ga ponovo ne otvara. Sinhronizacija koja radi u jednom i po smeru gora je od nikakve jer ljudi počinju da se oslanjaju na nju.
Bez priloga
Snimak ostaje kod nas i gleda se kod nas. Izvoz videa u alat za praćenje preneo bi lične podatke u sistem sa drugačijim pravilima čuvanja od onih koje ste dogovorili sa posetiocima.
Token se čuva šifrovano pomoću AES-256-GCM i nikada se ponovo ne prikazuje. Nikada se ne stavlja ni u interni red čekanja — ovaj poziv se odvija dok čekate, direktno iz zahteva.
5. GitLab, Azure DevOps i ClickUp
Još tri alata, isto dugme, isti ručni okidač.
| Vi dajete | |
|---|---|
| GitLab | host, ID projekta i token — radi i vaš GitLab |
| Azure DevOps | organizaciju, projekat, vrstu radne stavke i PAT |
| ClickUp | ID liste i lični token |
GitLab traži host jer može da bude vaš
Za razliku od ostalih, GitLab je često samostalno hostovan, pa je host polje umesto konstante. Nalepite gitlab.com ako se tamo nalazite.
Azure DevOps ima dve posebnosti odjednom
Njegovo telo je JSON Patch dokument, a ne objekat, i tip sadržaja mora biti application/json-patch+json — sve drugo vraća 415. Znak dolara ispred vrste radne stavke u URL-u deo je adrese, a ne zamena koju smo zaboravili da popunimo.
ClickUp zahteva čist token
Bez Bearer ispred njega. Token sa dodatom rečju odbija se sa 401, što izgleda potpuno isto kao pogrešan token.
Svi ovde navedeni žigovi pripadaju svojim vlasnicima. MousePlayer nema poslovni odnos sa ovim pružaocima usluga.