Systémy pro správu požadavků

Proměňte relaci v požadavek přímo při sledování - jedním tlačítkem v přehrávači, s vlastním popisem a už připojeným odkazem na záznam.

1. Proč se tento most spouští ručně

Každý jiný most v MousePlayer se spouští sám. Tento ne a právě v tom spočívá jeho návrh.

Požadavek znamená práci pro člověka. Kdybychom ho otevírali pro každé vzteklé kliknutí, nástěnku by zaplnily položky, které nikdo neposoudil, a tým by je do týdne začal filtrovat - spolu s nimi by pak zmizely i skutečné problémy.

Spouštěčem jste proto vy. Sledujete relaci, vidíte problém, stisknete tlačítko a popíšete své pozorování. Odkaz na záznam už je v popisu; posouzení dodáváte vy.

Tlačítko se zobrazuje jen vlastníkům a správcům, nikdy při zobrazení přes sdílený odkaz. Příjemce vašeho záznamu nemá mít možnost otevírat požadavky ve vašem systému.

2. Pět systémů a jejich požadavky

Kam se uložíZadáte
Jiraproblém v projektuadresu URL webu, e-mail účtu, token API, klíč projektu a typ problému
Linearproblém v týmuklíč API a ID týmu
Asanaúkol v projektuosobní přístupový token a ID projektu
Trellokarta v seznamuklíč, token a ID seznamu
GitHubproblém v repozitářiosobní přístupový token a owner/repo

Jedna dlaždice, vždy jeden vybraný poskytovatel. Pozdější přidání druhého systému znamená změnu výběru, ne migraci.

Odkud získat identifikátory

ID týmu v Linear a ID projektu v Asana jsou vidět v adrese URL po otevření týmu nebo projektu v prohlížeči. ID seznamu v Trello je z pěti možností nejsložitější: připojte .json k adrese URL nástěnky a najděte požadovaný seznam. Klíč projektu v Jira je předpona každého čísla problému - ACME v ACME-1234.

3. Odkaz v požadavku sestavuje náš server

Popis píšete vy. Odkaz na přehrávání však sestavujeme na naší straně podle skutečně sledované relace a formulář ho nemůže ovlivnit.

Je to důležité, protože na požadavek klikají další lidé. Kdyby odkaz pocházel z prohlížeče, upravený požadavek by mohl vašemu týmu podstrčit libovolnou adresu uvnitř něčeho, co vypadá jako vaše vlastní nástroje.

HTTP 200 neznamená, že požadavek existuje

Linear odpovídá přes GraphQL a GraphQL při odmítnutí vrací 200 OK s polem errors . Most, který kontroluje jen stavový kód, by hlásil úspěch u požadavku, který nikdy nevznikl. Čteme tělo odpovědi.

Pokud systém vrátí identifikátor nového problému, uvedeme ho v potvrzení, abyste mohli ověřit jeho skutečnou existenci, nikoli jen důvěřovat zelené zprávě.

4. Co zde záměrně není

Žádné automatické požadavky

Viz výše. Pokud chcete automatizaci, most pro webhooky může odesílat signály frustrace do Zapier nebo Make a tam rozhodnete, co si zaslouží požadavek.

Žádná obousměrná synchronizace

Uzavření požadavku nic nezmění v MousePlayer a nic v MousePlayer ho znovu neotevře. Synchronizace fungující v jednom a půl směru je horší než žádná, protože se na ni lidé začnou spoléhat.

Žádné přílohy

Záznam zůstává u nás a u nás se přehrává. Export videa do systému požadavků by přesunul osobní údaje do prostředí s jinými pravidly uchování, než na jakých jste se dohodli s návštěvníky.

Token se ukládá zašifrovaný pomocí AES-256-GCM a nikdy se znovu nezobrazí. Také se nikdy nevkládá do interní fronty - volání proběhne přímo při zpracování požadavku, zatímco čekáte.

5. GitLab, Azure DevOps a ClickUp

Další tři systémy, stejné tlačítko a stejné ruční spuštění.

Zadáte
GitLabhostitele, ID projektu a token - funguje i vlastní GitLab
Azure DevOpsorganizaci, projekt, typ pracovní položky a PAT
ClickUpID seznamu a osobní token

GitLab se ptá na hostitele, protože může patřit vám

Na rozdíl od ostatních bývá GitLab často provozován samostatně, proto je hostitel polem, nikoli konstantou. Vložte gitlab.com , pokud používáte tuto službu.

Azure DevOps má rovnou dvě zvláštnosti

Tělo požadavku je dokument JSON Patch místo objektu a jeho typ obsahu musí být application/json-patch+json - cokoli jiného vrátí 415. Znak dolaru před typem pracovní položky v adrese URL je součástí adresy, nikoli zástupný symbol, který jsme zapomněli vyplnit.

ClickUp chce samotný token

Bez Bearer před tokenem. Token s tímto slovem na začátku bude odmítnut stavem 401, což vypadá úplně stejně jako nesprávný token.

Všechny uvedené ochranné známky patří příslušným vlastníkům. MousePlayer s těmito poskytovateli nemá obchodní vztah.