Hibajegykövetők
Megtekintés közben alakítson egy munkamenetet hibajeggyé — egy gomb a lejátszóban, saját szavai a leírásban, a visszajátszási link pedig már csatolva.
1. Miért kézi ez az integráció
A MousePlayer minden más hídja magától aktiválódik. Ez nem; éppen ez a tervezés lényege.
A hibajegy munkát ad valakinek. Ha minden dühös kattintásra nyitnánk egyet, a táblája megtelne át nem nézett elemekkel, csapata pedig egy héten belül kiszűrné őket — velük együtt a valódi problémákat is.
Ezért Ön az indító. Megnéz egy munkamenetet, észreveszi a problémát, megnyomja a gombot, és leírja, mit látott. A felvétel linkje már a leírásban van; az értékelést Ön adja.
A gomb csak tulajdonosoknak és adminisztrátoroknak jelenik meg, megosztási linkes nézetben soha. Akinek felvételt küldött, nem nyithat hibajegyeket az Ön követőrendszerében.
2. Az öt követőrendszer és követelményeik
| Hová kerül | Mit kell megadnia | |
|---|---|---|
| Jira | hibajegy egy projektben | webhely URL-je, fiók e-mail-címe, API-token, projektkulcs, hibajegytípus |
| Linear | hibajegy egy csapatban | API-kulcs, csapatazonosító |
| Asana | feladat egy projektben | személyes hozzáférési token, projektazonosító |
| Trello | kártya egy listán | kulcs, token, listaazonosító |
| GitHub | hibajegy egy tárolóban | személyes hozzáférési token, owner/repo |
Egy csempe, egyszerre egy kiválasztott szolgáltató. Ha később második követőrendszert ad meg, az választásmódosítás, nem migráció.
Honnan származnak az azonosítók
A Linear csapatazonosítója és az Asana projektazonosítója a csapat vagy projekt böngészőben történő megnyitásakor az URL-ben látható. Az öt közül a Trello listaazonosítója a legnehezebb: a tábla URL-jéhez fűzze hozzá a .json részt, és keresse meg a kívánt listát. A Jira projektkulcsa a hibajegyszámok előtagja — ACME ebben: ACME-1234.
3. A hibajegy linkjét a szerverünk állítja össze
A beírt leírás az Öné. A visszajátszási linket mi állítjuk össze a ténylegesen megtekintett munkamenetből; az űrlap nem befolyásolhatja.
Ez azért számít, mert a hibajegyre mások kattintanak. Ha a link a böngészőből származna, egy manipulált kérés bármilyen címet csapata elé tehetne saját eszközének látszó környezetben.
A HTTP 200 nem jelenti a hibajegy létrejöttét
A Linear GraphQL-en válaszol, a GraphQL pedig elutasításkor 200 OK választ ad, benne egy errors tömbbel. A csak állapotkódot néző híd olyan hibajegyre is sikert jelezne, amely soha nem jött létre. A törzset olvassuk.
Ha a követőrendszer visszaadja az új hibajegy azonosítóját, a visszaigazolásba tesszük — így ellenőrizheti tényleges létét, nem kell egy zöld üzenetben bíznia.
4. Ami szándékosan hiányzik
Nincsenek automatikus hibajegyek
Lásd fent. Automatizáláshoz a webhookhíd frusztrációs jelzéseket küldhet a Zapiernek vagy a Make-nek; ott eldöntheti, mi érdemel hibajegyet.
Nincs kétirányú szinkronizálás
A hibajegy lezárása semmit nem változtat a MousePlayerben, és a MousePlayer sem nyitja újra. A másfél irányban működő szinkronizálás rosszabb a hiányánál, mert az emberek elkezdenek rá támaszkodni.
Nincsenek mellékletek
A felvétel nálunk marad, és nálunk nézhető meg. Videó exportálása egy követőrendszerbe személyes adatokat juttatna a látogatóival egyeztetettől eltérő megőrzési szabályokkal működő rendszerbe.
A tokent AES-256-GCM titkosítással tároljuk, és többé nem mutatjuk meg. A belső várólistába sem kerül — ez a hívás várakozása közben, közvetlenül a kérésből történik.
5. GitLab, Azure DevOps és ClickUp
További három követőrendszer, ugyanaz a gomb, ugyanaz a kézi indítás.
| Mit kell megadnia | |
|---|---|
| GitLab | kiszolgáló, projektazonosító és token — saját GitLabja is működik |
| Azure DevOps | szervezet, projekt, munkaelemtípus és PAT |
| ClickUp | listaazonosító és személyes token |
A GitLab azért kér kiszolgálót, mert az Öné is lehet
A többivel ellentétben a GitLabot gyakran saját tárhelyen üzemeltetik, ezért a kiszolgáló mező, nem állandó. Illessze be a gitlab.com címet, ha ott használja.
Az Azure DevOpsnak egyszerre két sajátossága van
A törzse objektum helyett JSON Patch dokumentum, tartalomtípusa pedig csak application/json-patch+json lehet — minden másra 415 a válasz. Az URL-ben a munkaelem típusa előtti dollárjel a cím része, nem egy kitöltetlen helyőrző.
A ClickUp a tokent önmagában kéri
Nincs előtte Bearer. Az e szóval kiegészített tokent 401-gyel utasítja el, ami pontosan hibás tokennek látszik.
Az itt említett védjegyek a tulajdonosaikhoz tartoznak. A MousePlayer nem áll üzleti kapcsolatban ezekkel a szolgáltatókkal.