Návod k použití

Kompletní uživatelská příručka. Ke konceptům viz Úvod.

Account

Sign up and sign in

Zaregistrujte se na eastagiletracker.com/register e-mailem a heslem, nebo continue with GitHub, pokud preferujete OAuth. Potvrďte svůj e-mail pomocí odkazu, který vám pošleme; do té doby se sice můžete přihlásit, ale některé funkce jsou omezené.

Pokud jste byli pozváni do projektu nebo organizace, klikněte na odkaz v pozvánkovém e-mailu — váš účet se vytvoří (nebo se přihlásíte) a přistanete přímo na odpovídající nástěnce.

Zapomněli jste heslo? Použijte Forgot Password na přihlašovací stránce; pošleme vám e-mail s odkazem pro reset.

Account settings

Z avataru vpravo nahoře → Account Settings:

• Profile — Zobrazované jméno, iniciály (používané v avatarech vlastníků), e-mail.
• Bio — Krátký popis vás samotných (až 4 KiB). Zobrazuje se na /me a ve výpisech členů organizace, aby si agent (nebo kolega) mohl vybrat tu správnou osobu, na kterou se obrátit. Pokud chcete, nechte prázdné.
• Password — Změňte ho kdykoli.
• Avatar — Nahrajte obrázek, nebo se vraťte k iniciálám.
• API Keys — Vytvořte osobní API tokeny; viz Příručka API.
• Theme — Agile, Labs, Dark nebo Light (lze přepínat i z postranního panelu).
• Delete Account — Dvoukrokové potvrzení. Odstraní vás ze všech organizací a projektů.

Security

Z avataru vpravo nahoře → Security:

• Two-factor (TOTP) — Nastavte si kód z libovolné autentizační aplikace (1Password, Authy, Google Authenticator, …). Získáte 10 jednorázových obnovovacích kódů — zobrazí se pouze jednou, takže si je uložte. Později jej vypnete buď aktuálním kódem, nebo obnovovacím kódem.
• Passkeys — Přidejte WebAuthn passkey vázaný na zařízení (Touch ID, Windows Hello, hardwarový bezpečnostní klíč). Poté se přihlašujte bez hesla. Klíče přidávejte, pojmenovávejte a odebírejte na téže stránce.

Sessions and refresh tokens

Úspěšné přihlášení vystaví dva tokeny: krátkodobý access JWT a dlouhodobý refresh token (30 dní, rotovaný při každém použití). SPA obnovuje přístupový token automaticky, jakmile vyprší; zůstáváte přihlášeni, dokud nevyprší obnovovací token nebo se neodhlásíte. Odhlášení zruší obnovovací token na straně serveru, takže odcizenou kopii nelze přehrát.

Billing

Většina účtů je Free Forever pro osobní použití. Pokud má váš účet měřený kreditní zůstatek, najdete jej pod Account → Billing — dobíjení přes Paddle checkout, historie transakcí.

Organizations

Každý účet patří do jedné nebo více organizací. Nová registrace získá osobní organizaci („<Name> Org”) vytvořenou automaticky ve stylu Linearu/Vercelu. Projekty žijí uvnitř organizací a členství v organizaci podmiňuje členství v projektu.

Switch organization

Klikněte na org switcher v horní liště pro přepínání mezi organizacemi, do nichž patříte. Aktivní organizace zabarví postranní panel, vymezí rozsah seznamu „Projects” a předvybere se při vytváření nového projektu.

Manage an organization (admin)

Klikněte na blok organizace v postranním panelu → Manage organization → přistanete na /organization/{id}/projects. Postranní panel zobrazí tři administrátorské záložky:

• Projects — Všechny projekty v této organizaci.
• Members — Současní členové, role a čekající pozvánky. Zvete e-mailem; pozvánka je svázaná s e-mailem, má token s TTL a strop role (členové nemohou zvát administrátory).
• Settings (pouze owners) — Název organizace, slug, tarif. Zde převedete vlastnictví na jiného člena.

Remove a member

Odebrání člena z organizace kaskáduje: jeho členství v jednotlivých projektech této organizace se zruší ve stejné transakci. Záložkované URL nástěnek přestanou fungovat ve chvíli, kdy ztratí přístup k organizaci — nezůstávají žádné osiřelé stopy.

Projects

Create a project

Na stránce Projects klikněte na New Project. Formulář pro vytvoření se ptá jen na dvě věci:

• Title — Povinné.
• Description — Volitelné; viditelné všem členům.

Všechno ostatní — délka iterace, počáteční den, initial velocity, škála odhadů, done state, přepínač úkolů — se nastaví později v Project Settings a je předvyplněno rozumnými výchozími hodnotami.

Project settings

V menu Settings projektu jsou čtyři záložky:

• Project — Upravte název, popis, délku iterace a počáteční den, strategii rychlosti (průměr z posledních 3 / 5 / 10), done state, škálu odhadů, přepínač úkolů.
• Member — Pozvěte, povyšte/snižte roli a odeberte lidské členy (viz Members and invitations níže).
• Agent — Vystavte a zrušte agent API klíče pro tento projekt (viz Agents níže). Pouze owner.
• Import — Přeneste stories z jiného trackeru (viz Importing from other trackers níže).

Members and invitations

V záložce Member v Project Settings zvete lidi e-mailem. Čekající pozvánky čekají v samostatném koši, dokud nejsou přijaty; vidíte, kdo je pozván, a můžete znovu odeslat nebo zrušit. Aktivním členům lze povýšit/snížit roli mezi viewer, member a owner. Owners mohou měnit nastavení projektu; viewers mohou číst, ale ne zapisovat.

Historie projektu je na vlastní stránce — každá změna nastavení projektu, každá změna členství, s aktérem (člověk nebo agent).

Stories

Create a story

Použijte ovládací prvek + Add story na libovolném panelu nástěnky (Current, Backlog, Icebox nebo vlastním) — napište název a stiskněte Enter.

Nové stories vytvořené v Current mají ve výchozím nastavení current_state = 'unstarted'. To je parita s PT: Current iterace je plán práce, nikoli rozdělení podle stavu. Vlastník story výslovně Startuje, když na ní začne pracovat — hodiny doby cyklu se nespustí dříve.

Povinné: název. Vyberte typ (výchozí feature). Přidejte popis, odhad (pouze features), štítky, vlastníky, sledující, blokátory — cokoli z toho lze doplnit později z detailního panelu.

Stiskli jste Enter dvakrát rychle? Žádný problém — tlačítko je ošetřené; dostanete přesně jednu story.

Estimate features

Features jsou jediný typ, který nese body. Klikněte na bodový kruh na kartě (nebo v detailním panelu) a vyberte ze škály. Neodhadnuté features mají prázdný kruh.

• Fibonacci scale — 0, 1, 2, 3, 5, 8, 13. Standardní XP. Cokoli většího než 13 by se mělo rozdělit na menší stories.
• East Agile scale — 0, 1, 2, 3. Užší. 3 znamená celou iteraci času jedné osoby. Nic se nevejde nad 3.
• 3-Point scale — 1, 2, 3 (Small / Medium / Large). Striktní velikosti triček — žádná nula, žádné poloviční body.

Vyberte škálu jednou v Project Settings; můžete ji změnit později (existující odhady se přemapují).

Advance state

Tři způsoby, jak posunout story životním cyklem:

1. Klikněte na inline akční tlačítko na kartě — Start, Finish, Deliver, Accept, Reject. Text tlačítka odráží další platný stav pro typ story.
2. Přetáhněte kartu do jiného sloupce. Systém aplikuje přechod, který přechod přes daný sloupec implikuje. Zpětné pohyby vyžadují potvrzení.
3. Hromadný přechod — Vyberte více stories, Transition all — každá story přechází nezávisle. Pokud je jedna nepřípustná, ostatní přesto projdou.

Detail panel

Klikněte kdekoli na řádku story pro její rozbalení inline. Detailní panel zobrazuje:

• Název (editovatelný), popis (Markdown), typ, odhad, žadatele.
• Vlastníky (přidat/odebrat členy nebo agenty), sledující, štítky.
• Úkoly (pokud jsou zapnuté), komentáře, přílohy, blokátory, odkazy, recenze.
• Třítečkové menu pro duplikaci, smazání a další méně běžné akce.

Stiskněte Escape pro zavření naposledy otevřené story (pamatuje si zásobník — sbalíte jednu po druhé).

Comments

Až 10 000 znaků, vykreslený Markdown. Upravujte a mažte vlastní komentáře; auditní log zachovává historii. Zmiňujte členy přes @ a automatické dokončování je doplní.

Attachments

Přetáhněte soubor do detailního panelu, nebo použijte tlačítko nahrávání. Až 2 GB na soubor — ano, dost velké pro videoprůchody ze screen recordingu. Použijte vestavěný video přehrávač.

Labels

Ze stránky Labels v postranním panelu: vytvořte štítky s názvy a barvami, archivujte zastaralé (archivované štítky mizí z nástěnky, ale zůstávají vyhledatelné). Štítky přidávejte u jednotlivých stories v detailním panelu.

Blockers, links, reviews

• Blockers — Volnotextová poznámka „toto je blokováno X”. Označte jako vyřešené/nevyřešené. Filtrujte nástěnku pomocí has:blocker.
• Links — Šest typů vztahů: relates to, duplicates, blocks, is blocked by, pull request, branch. Vložte GitHub URL a typ se autodetekuje.
• Reviews — Přiřaďte recenzenta (člověka nebo agenta) se stavem (pending, approved, rejected) a volitelným komentářem.

Tasks

Pokud jsou zapnuté v Project Settings, stories dostanou podúkoly — checklist uvnitř story. Odškrtávejte je, jak postupujete; počet se zobrazuje na kartě.

Story field reference

Každá výběrová proměnná na ploše detailu story nese vedle svého popisku malou ikonu [?]. Klikněte na ni v aplikaci a uvidíte stejné pokyny shrnuté níže. Překladatelé dodávají texty v aplikaci spolu se zbytkem rozhraní; tato část je dlouhou kanonickou referencí.

Pole jsou uvedena v pořadí, v jakém se objevují na záložce Overview.

Status

Místo story v životním cyklu: Unstarted → Started → Finished → Delivered → Accepted (nebo Rejected zpět na Started).

Kritickým stavem je Delivered: inženýr ji označí jako dodanou, ale není hotová, dokud ji product owner výslovně nepřijme (Accept) podle akceptačních kritérií — nebo dokud ji neodmítne, čímž ji vrátí zpět. Tím se do každé story zabuduje smyčka zpětné vazby od zákazníka, místo aby se akceptace odkládala až na demo na konci sprintu.

Pokud se stories hromadí ve stavu Delivered, je to signál, že se smyčka accept/reject zadrhla. Sledujte počet Delivered na konci každé iterace — pokud roste, je to váš signál, že product owner je nedostatečně vytížený nebo že akceptační kritéria nejsou předem dost jasná.

Iteration

Do které iterace je story naplánována. Ponechte na None, aby story zůstala v Backlogu, kde ji systém automaticky seskupí pod nadcházející iteraci podle rychlosti.

Ruční přepsání je zde užitečné, když chcete story připnout ke konkrétní iteraci bez ohledu na pořadí — např. svázat release story s pevným datem. Jinak nechte pořadí v Backlogu řídit přiřazení k iteracím; to udržuje projekci rychlosti poctivou.

Owners

Kdo dělá práci. Vlastníky mohou být lidé nebo agenti — oba se vykreslují jako pojmenovaní účastníci v auditním logu, autorství komentářů a analytice. Neexistuje způsob, jak vydávat vlastníka-agenta za člověka.

Více vlastníků je viditelným vyjádřením párového programování (nebo párování s agentem). Přidejte agenta, který story převzal, a člověka, který provádí kontrolu — obě jména se objeví na kartě. To udržuje rozpracovanou práci na nízké úrovni; dokončit před zahájením další story je tou největší pákou na dobu cyklu.

Vlastníci nejsou totéž co Followers (samostatné pole na kartě). Sledující jsou lidé, kterým na story záleží, ale práci nedělají — typicky odběratelé upozornění.

Story type

Čtyři typy nejsou zaměnitelné — jejich odlišení je celým smyslem datového modelu.

• Feature — Nová hodnota pozorovatelná uživatelem. Jediný typ, který nese body a počítá se do rychlosti. To vás nutí dělit práci na hodnotu, kterou uživatel vidí.
• Bug — Defekt. Bez bodů. Defekty nezískávají kredit na rychlost, což drží náklady na opravy viditelné, místo aby je odměňovalo.
• Chore — Nezbytná práce bez přímé hodnoty pro uživatele (refaktory, infrastruktura, nastavení). Bez bodů. Tým je tlačen sdružovat chores do features všude, kde je to možné, aby zůstal rámec hodnoty poctivý.
• Release — Nulobodový milník. Jde rovnou z Unstarted do Accepted a ukotvuje datum pro projekci.

Pokud zjistíte, že chcete obodovat bug nebo chore: nedělejte to. To rozbíjí projekci, která drží celý systém poctivý. Rychlost je měřicí přístroj; do vlastního přístroje se nezasahuje.

Priority

Nepoužívejte to, pokud se tomu lze vyhnout. Backlog je prioritou — odshora dolů, jedna priorita, žádné shody. Pořadí vlastní product owner.

Pole „priority” je klasický anti-vzor, který tiše převádí empirický, seřazený backlog zpět na zbožné plánování. Pokud máte tři P1, nemáte prioritu — máte Backlog se špatným pořadím. Opravte pořadí; smažte signál priority.

Pole existuje kvůli kompatibilitě s importy z trackerů, které ho používají (Jira, Asana, …), aby importované stories po cestě neztratily informace. U nové práce ho nechte na „None”.

Points

Relativní velikost story. Features dostávají body; bugs, chores a releases zůstávají na nule.

Odhadování je rozhovor o velikosti, nikoli slib. Nepřevádějte body na hodiny; nenafukujte body, abyste vypadali rychle. Rychlost je měřicí přístroj — do vlastního přístroje se nezasahuje.

Dodávají se tři škály:

• Fibonacci — 0, 1, 2, 3, 5, 8, 13. Klasická škála XP. Cokoli většího než 13 by se mělo rozdělit.
• East Agile — 0, 1, 2, 3. Užší škála. 3 znamená celou iteraci času jedné osoby.
• 3-Point — 1, 2, 3 (Small / Medium / Large). Striktní velikosti triček.

Pokud často odhadujete na 5, 8 nebo 13, vaše stories jsou příliš velké. Dělte je, dokud nebude každá nezávisle dodatelná (S a I v INVEST).

Requester

Kdo o story požádal. Obvykle jedna osoba — product owner, stakeholder nebo agent jednající něčím jménem.

Žadatel není vlastník. Vlastník je ten, kdo dělá práci; žadatel je ten, komu na výsledku záleží a kdo ho (ne)přijme. Mohou to být tytéž osoby, ale jsou to oddělené role. Zaznamenání žadatele je to, co vám o půl roku později dá auditní odpověď na otázku „kdo si o tohle řekl?”.

Labels

Barevné značky. Stories jich mohou nést více. Používají se k průřezové kategorizaci — mvp, tech-debt, security, konkrétní název release — a k filtrování nástěnky (label:mvp ve vyhledávacím poli, nebo uložte jako vlastní filtrovací panel).

Štítky jsou vymezené projektem. Spravujte je na stránce Labels v postranním panelu. Zastaralé štítky raději archivujte než mažte; archiv udržuje historii vyhledatelnou a zároveň uklidí nástěnku.

Blockers

Volnotextové poznámky popisující, co brání postupu této story. Po odstranění překážky označte jako vyřešené.

Blokátory jsou signál o toku, nikoli fronta. Vynášejte je na denním standupu; řešte je mimo. Pokud máte na jednu story déle než den otevřený více než jeden či dva blokátory, plánování je špatně — rozdělte story nebo změňte závislost. Cílem je, aby panel Blocked byl většinu času převážně prázdný.

Description

Co story je a jak poznáte, že je hotová. Markdown.

Akceptační kritéria patří sem — ideálně ve formě Given / When / Then, aby se přímo mapovala na akceptační testy:

Given I am signed in as a member
When I click "Add a story" in Current
Then the story is created in state "unstarted"

INVEST je kontrola, zda je story dobře utvořená:

• Independent — lze ji vydat bez jiných stories.
• Negotiable — zachycuje záměr, ne zmrazenou specifikaci.
• Valuable — pro uživatele nebo stakeholdera.
• Estimable — tým ji dokáže odhadnout.
• Small — pohodlně se vejde do iterace.
• Testable — má akceptační kritéria, která lze ověřit.

Story na vrcholu backlogu s vágními akceptačními kritérii je chyba plánování — ne budoucí problém, který lze ignorovat. Opravte ji, než ji necháte postoupit.

Bulk actions

Vyberte více stories na nástěnce (shift-klik pro rozsah, nebo Select all in panel). Pak:

• Hromadný přechod
• Hromadné smazání
• Hromadná duplikace

The board

Nástěnka je domovskou obrazovkou každého projektu. Tři sloupce ve výchozím nastavení:

• Current — Stories v aktivní iteraci. Seskupené podle hlavičky iterace (aktuální, pak nadcházející, pak uzavřené). Karty se objevují v časovém pořadí iterace s viditelným stavem na každé kartě; sloupec není rozdělen podle stavu — to by rozbilo časové pořadí iterace, ve kterém tým plánuje.
• Backlog — Striktně seřazená fronta. Systém automaticky seskupuje nadcházející iterace podle rychlosti. Pořadí odshora dolů vlastní product owner; čím níže scrollujete, tím více může jasnost klesat, ale nikdy ne na vrcholu.
• Icebox — Nápady bez data. Neseřazené, neodhadnuté. Icebox smí být hřbitovem.

Configurable panels — sidebar checkboxes

Sekce Board v postranním panelu vypisuje každý přednastavený sloupec se zaškrtávacím políčkem: zaškrtnutím sloupec zobrazíte, odškrtnutím skryjete. Přepínače přetrvávají per-projekt per-uživatel (synchronizují se přes GET/PUT /preferences). Přednastavené jsou:

• Current Iteration (ve výchozím nastavení zapnuto)
• Backlog (ve výchozím nastavení zapnuto)
• Icebox (ve výchozím nastavení zapnuto)
• Done — Přijaté stories.
• My Work — Stories, kde jste vlastníkem.
• Blocked — Stories s nevyřešenými blokátory.
• Epics — Souhrny na úrovni epiků.
• Chat — Chatový sloupec vymezený projektem.

Custom filter panels

Připněte vyhledávání jako panel: vložte dotaz jako type:feature label:mvp owner:claire, uložte ho. Měňte šířku sloupců dle libosti; šířky přetrvávají napříč relacemi.

Search

Vyhledávací lišta přijímá syntaxi filtrů popsanou v Úvodu. Výsledky vyhledávání žijí v panelu výsledků; klikněte na kterýkoli pro skok na nástěnce.

Current-iteration chip

Horní lišta zobrazuje číslo aktuální iterace, datový rozsah a body přijaté oproti plánovaným. Klikněte pro skok do sloupce Current.

Iterations

Systém vytváří iterace automaticky na základě délky a počátečního dne. Nemusíte je „otevírat” ani „zavírat”.

Pro plánování dopředu přetahujte stories z Backlogu do skupin nadcházejících iterací. Systém označí skupiny červeně, pokud překročí vaši rychlost. Pro plánování dál vpřed scrollujte backlogem — zobrazuje tři nebo čtyři iterace dopředu.

Pro návrat zpět: klikněte na jakoukoli hlavičku minulé iterace ve sloupci Current pro vstup do iteračního reportu.

Releases

Releases jsou typ story, ne samostatný objekt. Vytvořte release stejně, jako byste vytvořili jakoukoli story: vyberte Release jako typ, dejte mu název (např. v2.4), přetáhněte ho do iterace, kde plánujete vydat.

Releases přeskakují stavy Started/Finished/Delivered/Rejected — jdou z Unstarted do Accepted v jednom kroku. Přijměte release, když vydáte; analytické pohledy zobrazí marker release.

Analytics

Záložka Analytics (nahoře v projektu) vám nabízí šest reportů:

• Project Overview — Trend rychlosti, KPI nedávných iterací, burnup, burndown, kumulativní tok.
• Iteration — Detail jediné iterace: KPI, burndown, tok stavů.
• Releases & Burndowns — Časová osa releasů, burndown na jednotlivé release.
• Story Activity — Kdo co udělal, filtrovatelné podle aktéra, typu, datového rozsahu.
• Cycle Time — Průměr a distribuce času od Started do vašeho done stavu.
• Projections — Prognóza, kdy bude backlog hotový při aktuální rychlosti.

Agents

Toto je část produktu, která ho odlišuje. Agent je pojmenovaný spoluhráč — ale je to AI.

Add an agent to a project

Musíte být owner projektu (nebo admin). Otevřete Project Settings → Agents:

1. Create new agent key.
2. Dejte agentovi jméno (zobrazí se pod tímto jménem v auditních logech, autorství komentářů a avatarech vlastníků).
3. Vyberte roli — viewer (pouze pro čtení) nebo member (může zapisovat). Role owner je vyhrazena pro lidi.
4. Klíč se zobrazí jednou — zkopírujte ho; my ho neuchováváme dohledatelně. Prefix je ea_agent_….

What agents can do

Agent s rolí member může dělat vše, co lidský člen:

• Vytvářet, upravovat, posouvat, mazat stories
• Komentovat, přikládat soubory, přidávat štítky, nastavovat vlastníky
• Vybrat sám sebe jako vlastníka story
• Číst aktivitu, sledovat události

Auditní log zaznamenává každý zápis s identitou agenta. Neexistuje způsob, jak by akce agenta vypadala jako lidská.

Manage agent keys

V Project Settings → Agents uvidíte všechny aktivní klíče, jejich názvy, role a čas posledního použití. Zrušte klíč kdykoli; agent okamžitě ztrácí přístup. Minulá aktivita agenta zůstává v auditním logu navždy.

Use agents with the API

Pro ukázky kódu viz API Guide → Agent keys.

Importing from other trackers

Pokud přicházíte z jiného nástroje, máme importéry pro osm zdrojů:

• Pivotal Tracker
• Jira
• Asana
• GitLab
• Shortcut
• Trello
• Linear
• Plane

Z Project Settings → Import nahrajte export (CSV z většiny, JSON z Plane). Stories, vlastníci, komentáře, štítky a stavy se mapují automaticky; některé zdroje přinášejí i iterace.

Náhled ukáže, co se naimportuje. Nesoulady (např. štítek, který není ve vašem projektu) vyzvou k akci — vytvořit nebo přeskočit, vaše volba.

Themes

Dodávají se čtyři motivy. Přepínejte v zápatí postranního panelu (nebo v Account Settings → Theme):

• Agile — Paleta z marketingové úvodní stránky. Teplé bílé, sytě modrý akcent značky (#1f6f9f), sytě zbarvené ikony typů story. Vedoucí volba v přepínači.
• Labs — Paleta Pivotal Tracker, láskyplně zachovaná. Tmavý chrom, modrá horní lišta, pastelové mezery sloupců. Originál.
• Dark — Čistě neutrální tmavý.
• Light — Čistě neutrální světlý. Inkoust na papíře.

Váš motiv přetrvává napříč relacemi.

Language

Rozhraní je přeloženo do 15 jazyků: angličtina, francouzština, němčina, španělština, japonština, čínština, korejština, portugalština, italština, nizozemština, švédština, dánština, čeština, finština, polština. Přepínejte v zápatí postranního panelu — chrom, autentizační stránky, oblast account/security, seznam projektů a marketingová úvodní stránka se lokalizují okamžitě. Lokalizace detailu story / analytiky / nastavení se postupně doplňuje.

Keyboard shortcuts

Pár zkratek, které stojí za to:

• Escape — Sbalí naposledy otevřenou story.
• Enter v inline vstupu — Odeslat (nesbalí řádek).
• Shift-klik — Výběr rozsahu stories.

Časem se přidávají další; aktuální seznam viz Help v postranním panelu.

Self-hosting

East Agile Tracker je open source. Plný zdrojový kód je na github.com/EastAgile/agile-tracker — naklonujte jej, sestavte a provozujte na vlastní infrastruktuře. Stejná sada funkcí jako hostovaná verze.

K nastavení viz README projektu.