Інструкція з експлуатації

Повний посібник користувача. Щодо концепцій дивіться Вступ.

Обліковий запис

Реєстрація та вхід

Зареєструйтеся на eastagiletracker.com/register за допомогою електронної пошти та пароля, або продовжте через GitHub, якщо ви віддаєте перевагу OAuth. Підтвердьте свою електронну пошту за посиланням, яке ми надсилаємо; до того моменту ви можете входити, але деякі функції обмежені.

Якщо вас запросили до проєкту чи організації, перейдіть за посиланням у листі-запрошенні — ваш обліковий запис створюється (або ви входите), і ви потрапляєте безпосередньо на відповідну дошку.

Забули пароль? Скористайтеся Forgot Password на сторінці входу; ми надішлемо листом посилання для скидання.

Налаштування облікового запису

З аватара у верхньому правому куті → Account Settings:

• Profile — відображуване ім’я, ініціали (використовуються в аватарах власників), електронна пошта.
• Bio — короткий опис себе (до 4 КіБ). З’являється на /me та у списках учасників організації, щоб агент (чи колега) міг обрати потрібну людину, до якої звернутися. Залиште порожнім, щоб відмовитися.
• Password — змінюйте будь-коли.
• Avatar — завантажте зображення або скористайтеся своїми ініціалами.
• API Keys — створюйте особисті токени API; дивіться Посібник з API.
• Theme — Agile, Labs, Dark або Light (також перемикається з бічної панелі).
• Delete Account — двоетапне підтвердження. Видаляє вас з усіх організацій та проєктів.

Безпека

З аватара у верхньому правому куті → Security:

• Two-factor (TOTP) — налаштуйте код з будь-якого застосунку-автентифікатора (1Password, Authy, Google Authenticator, …). Отримайте 10 одноразових кодів відновлення — їх показують один раз, тож збережіть їх. Вимкніть пізніше за допомогою поточного коду або коду відновлення.
• Passkeys — додайте прив’язаний до пристрою ключ доступу WebAuthn (Touch ID, Windows Hello, апаратний ключ безпеки). Після цього входьте без пароля. Додавайте, називайте та видаляйте ключі з тієї самої сторінки.

Сесії та токени оновлення

Успішний вхід створює два токени: короткоживучий access JWT і довгоживучий токен оновлення (30 днів, ротується при кожному використанні). SPA автоматично оновлює access-токен, коли той закінчується; ви залишаєтеся в системі, доки не закінчиться токен оновлення або доки ви не вийдете. Вихід відкликає токен оновлення на стороні сервера, тож вкрадену копію не можна відтворити.

Білінг

Більшість облікових записів є Free Forever для особистого використання. Якщо ваш обліковий запис має лічильниковий баланс кредитів, знайдіть його в Account → Billing — поповніть через касу Paddle, перегляньте історію транзакцій.

Організації

Кожен обліковий запис належить одній або кільком організаціям. Щойно зареєстрований користувач отримує особисту організацію («<Name> Org»), створену автоматично в стилі Linear/Vercel. Проєкти живуть усередині організацій, а членство в організації регулює членство в проєкті.

Перемикання організації

Натисніть перемикач організацій у верхньому рядку, щоб перемикатися між організаціями, до яких ви належите. Активна організація фарбує бічну панель, обмежує список «Projects» і попередньо обирається, коли ви створюєте новий проєкт.

Керування організацією (адміністратор)

Натисніть блок організації на бічній панелі → Manage organization → ви потрапляєте на /organization/{id}/projects. Бічна панель показує три вкладки адміністрування:

• Projects — усі проєкти в цій організації.
• Members — поточні учасники, ролі та очікувані запрошення. Запрошуйте за електронною поштою; запрошення прив’язане до пошти з TTL-токеном і стелею ролей (учасники не можуть запрошувати адміністраторів).
• Settings (лише власники) — назва організації, slug, план. Тут передавайте право власності іншому учаснику.

Видалення учасника

Видалення учасника з організації каскадується: його членства в проєктах цієї організації відкликаються в тій самій транзакції. URL-адреси дошок із закладок перестають працювати тієї ж миті, коли він втрачає доступ до організації — жодних осиротілих слідів.

Проєкти

Створення проєкту

На сторінці Projects натисніть New Project. Форма створення запитує лише дві речі:

• Title — обов’язково.
• Description — необов’язково; видно всім учасникам.

Усе інше — довжина ітерації, день початку, початкова швидкість, шкала оцінювання, завершений стан, перемикач завдань — задається пізніше в Project Settings і заповнюється розумними значеннями за замовчуванням.

Налаштування проєкту

У меню Settings проєкту — чотири вкладки:

• Project — редагуйте заголовок, опис, довжину ітерації та день початку, стратегію швидкості (середнє за останні 3 / 5 / 10), завершений стан, шкалу оцінювання, перемикач завдань.
• Member — запрошуйте, підвищуйте/понижуйте та видаляйте людей-учасників (див. Учасники та запрошення нижче).
• Agent — створюйте та відкликайте ключі API агентів для цього проєкту (див. Агенти нижче). Лише для власника.
• Import — переносьте історії з іншого трекера (див. Імпорт з інших трекерів нижче).

Учасники та запрошення

У вкладці Member налаштувань проєкту запрошуйте людей за електронною поштою. Очікувані запрошення лежать в окремому кошику до прийняття; ви бачите, кого запрошено, і можете повторно надіслати чи відкликати. Активних учасників можна підвищувати/понижувати між viewer, member та owner. Власники можуть змінювати налаштування проєкту; глядачі можуть читати, але не писати.

Історія проєкту — на власній сторінці: кожна зміна налаштувань проєкту, кожна зміна членства, із зазначенням актора (людини чи агента).

Історії

Створення історії

Скористайтеся елементом + Add story на будь-якій панелі дошки (Current, Backlog, Icebox або власній) — введіть заголовок і натисніть Enter.

Нові історії, створені в Current, за замовчуванням мають current_state = 'unstarted'. Це паритет із PT: ітерація Current — це план роботи, а не розділення за станом. Власник явно Стартує історію, коли починає роботу, — годинник часу циклу не запускається до того моменту.

Обов’язково: заголовок. Оберіть тип (за замовчуванням feature). Додайте опис, оцінку (лише для функцій), мітки, власників, спостерігачів, блокери — будь-що з цього можна заповнити пізніше з панелі деталей.

Натиснули Enter двічі швидко? Не проблема — кнопка захищена; ви отримаєте рівно одну історію.

Оцінювання функцій

Функції — єдиний тип, що приймає бали. Натисніть коло балів на картці (або в панелі деталей) і оберіть значення зі шкали. Неоцінені функції показують порожнє коло.

• Шкала Fibonacci — 0, 1, 2, 3, 5, 8, 13. Стандартна XP. Усе більше за 13 слід розбити на менші історії.
• Шкала East Agile — 0, 1, 2, 3. Більш стисла. 3 означає повну ітерацію часу однієї людини. Ніщо не вписується понад 3.
• 3-бальна шкала — 1, 2, 3 (Small / Medium / Large). Сувора оцінка «за розмірами футболок» — без нульового варіанту, без половинок балів.

Оберіть шкалу один раз у Project Settings; ви можете змінити її пізніше (наявні оцінки перенесуться).

Просування стану

Три способи провести історію через життєвий цикл:

1. Натисніть вбудовану кнопку дії на картці — Start, Finish, Deliver, Accept, Reject. Текст кнопки відображає наступний дійсний стан для типу історії.
2. Перетягніть картку до іншої колонки. Система застосовує перехід, який передбачає перетин цієї колонки. Зворотні переміщення запитують підтвердження.
3. Масовий перехід — оберіть кілька історій, Transition all — кожна історія переходить незалежно. Якщо одна неприпустима, інші все одно проходять.

Панель деталей

Натисніть будь-де в рядку історії, щоб розгорнути її вбудовано. Панель деталей показує:

• Заголовок (редагований), опис (Markdown), тип, оцінку, замовника.
• Власників (додавання/видалення учасників чи агентів), спостерігачів, мітки.
• Завдання (якщо ввімкнено), коментарі, вкладення, блокери, посилання, рецензії.
• Меню з трьох крапок для дублювання, видалення та інших менш поширених дій.

Натисніть Escape, щоб закрити останню відкриту історію (вона пам’ятає стек — згортайте по одній).

Коментарі

До 10 000 символів, відрендерений Markdown. Редагуйте та видаляйте власні коментарі; журнал аудиту зберігає історію. @-згадуйте учасників, і автозаповнення їх підхопить.

Вкладення

Перетягніть файл на панель деталей або скористайтеся кнопкою завантаження. До 2 ГБ на файл — так, достатньо для відеоінструкцій із записом екрана. Використовуйте відеоплеєр вбудовано.

Мітки

Зі сторінки Labels на бічній панелі: створюйте мітки з назвами та кольорами, архівуйте, коли застаріли (архівовані мітки зникають з дошки, але залишаються доступними для пошуку). Додавайте мітки до кожної історії в панелі деталей.

Блокери, посилання, рецензії

• Блокери — нотатка у вільному тексті «це блокується X». Позначайте як вирішений/невирішений. Фільтруйте дошку за has:blocker.
• Посилання — шість типів зв’язків: relates to, duplicates, blocks, is blocked by, pull request, branch. Вставте URL GitHub, і тип визначиться автоматично.
• Рецензії — призначте рецензента (людину чи агента) зі статусом (pending, approved, rejected) та необов’язковим коментарем.

Завдання

Якщо ввімкнено в Project Settings, історії отримують підзавдання — контрольний список усередині історії. Відмічайте їх по мірі виконання; кількість з’являється на картці.

Довідник полів історії

Кожна змінна вибору на поверхні деталей історії має невеличку іконку [?] поруч зі своєю міткою. Натисніть її в застосунку, щоб побачити ту саму настанову, підсумовану нижче. Перекладачі постачають внутрішньозастосунковий текст разом із рештою інтерфейсу; цей розділ є докладною канонічною довідкою.

Поля наведено в порядку, у якому вони з’являються на вкладці Overview.

Status

Місце історії в життєвому циклі: Unstarted → Started → Finished → Delivered → Accepted (або Rejected назад до Started).

Критичний стан — це Delivered: інженер позначає її як доставлену, але вона не є завершеною, доки власник продукту явно не Прийме її відповідно до критеріїв прийняття — або відхилить її, повернувши назад. Це вбудовує цикл зворотного зв’язку з клієнтом у кожну історію, замість того щоб відкладати прийняття до демонстрації наприкінці спринту.

Якщо історії накопичуються в Delivered, це сигнал, що цикл прийняття/відхилення застопорився. Дивіться на кількість Delivered наприкінці кожної ітерації — якщо вона зростає, це ваш сигнал, що власник продукту недостатньо забезпечений ресурсами або критерії прийняття недостатньо чіткі наперед.

Iteration

У яку ітерацію заплановано історію. Залиште значення None, щоб тримати історію в Backlog, де система автоматично згрупує її під майбутньою ітерацією на основі швидкості.

Ручне перевизначення тут корисне, коли ви хочете закріпити історію за конкретною ітерацією незалежно від порядку — наприклад, прив’язати релізну історію до фіксованої дати. Інакше дозвольте порядку в Backlog керувати призначенням ітерації; саме це тримає прогноз швидкості чесним.

Owners

Хто виконує роботу. Власниками можуть бути люди або агенти — обидва відображаються як названі учасники в журналі аудиту, авторстві коментарів та аналітиці. Немає способу видати власника-агента за людину.

Кілька власників — це видимий вияв парного програмування (або пари з агентом). Додайте агента, який узяв історію, і людину, яка рецензує, — обидва імені з’являться на картці. Це тримає кількість незавершеної роботи низькою; завершення перед початком наступної історії — найбільший важіль впливу на час циклу.

Власники — це не те саме, що Спостерігачі (окреме поле на картці). Спостерігачі — це люди, яким небайдужа історія, але вони не виконують роботу — зазвичай це передплатники сповіщень.

Story type

Чотири типи не взаємозамінні — у цій різниці весь сенс моделі даних.

• Feature — нова цінність, спостережувана користувачем. Єдиний тип, що несе бали і зараховується до швидкості. Це змушує вас нарізати роботу на цінність, яку користувач може бачити.
• Bug — дефект. Без балів. Дефекти не приносять кредиту швидкості, через що вартість переробок залишається видимою, а не винагороджується.
• Chore — необхідна робота без прямої користі для користувача (рефакторинг, інфраструктура, налаштування). Без балів. Команда відчуває тиск об’єднувати рутину з функціями де тільки можливо, щоб рамка цінності залишалася чесною.
• Release — маркер віхи з нулем балів. Іде прямо від Unstarted до Accepted, закріплюючи дату для прогнозу.

Якщо вам захотілося присвоїти бали багу чи рутині: не робіть цього. Це ламає прогноз, який робить усю систему чесною. Швидкість — це вимірювальний прилад; ви не псуєте власний прилад.

Priority

Не використовуйте це, якщо можете цього уникнути. Backlog і є пріоритетом — згори вниз, з єдиним пріоритетом, без нічиїх. Власник продукту володіє порядком.

Поле «пріоритет» — це класичний антипатерн, який тихо перетворює емпіричний, упорядкований беклог назад на бажане планування. Якщо у вас опинилося три P1, у вас немає пріоритету — у вас Backlog з неправильним порядком. Виправте порядок; видаліть сигнал пріоритету.

Поле існує для сумісності з імпортом із трекерів, які його використовують (Jira, Asana, …), щоб імпортовані історії не втрачали інформацію при перенесенні. Залишайте «None» у новій роботі.

Points

Відносний розмір історії. Функції отримують бали; баги, рутина та релізи залишаються на нулі.

Оцінювання — це розмова про розмір, а не обіцянка. Не переводьте бали в години; не роздувайте бали, щоб виглядати швидкими. Швидкість — це вимірювальний прилад — ви не псуєте власний прилад.

Постачаються три шкали:

• Fibonacci — 0, 1, 2, 3, 5, 8, 13. Класична шкала XP. Усе більше за 13 слід розбити.
• East Agile — 0, 1, 2, 3. Більш стисла шкала. 3 означає повну ітерацію часу однієї людини.
• 3-Point — 1, 2, 3 (Small / Medium / Large). Сувора оцінка «за розмірами футболок».

Якщо ви часто оцінюєте в 5, 8 чи 13, ваші історії занадто великі. Розбивайте, доки кожна не стане незалежно постачальною (S та I в INVEST).

Requester

Хто попросив про історію. Зазвичай одна людина — власник продукту, стейкхолдер або агент, що діє від чийогось імені.

Замовник — це не власник. Власник — це той, хто виконує роботу; замовник — це той, кому небайдужий результат і хто (або не) прийме його. Вони можуть бути однією людиною, але це окремі ролі. Запис замовника дає вам аудиторську відповідь на запитання «хто це попросив?» через шість місяців.

Labels

Кольорові теги. Історії можуть нести кілька. Використовуються для наскрізної категоризації — mvp, tech-debt, security, конкретна назва релізу — та для фільтрації дошки (label:mvp у полі пошуку або збереження як власної панелі фільтрів).

Мітки обмежені проєктом. Керуйте ними на сторінці Labels на бічній панелі. Архівуйте застарілі мітки замість видалення; архів зберігає історію доступною для пошуку, очищаючи дошку.

Blockers

Нотатки у вільному тексті, що описують, що заважає історії просуватися. Позначайте як вирішений, коли перешкоду усунуто.

Блокери — це сигнал потоку, а не черга. Використовуйте щоденний стендап, щоб виявляти їх; вирішуйте їх поза процесом. Якщо у вас більше одного-двох відкритих блокерів на історію довше ніж день, планування неправильне — розбийте історію або змініть залежність. Мета — щоб панель Blocked була переважно порожньою більшість часу.

Description

Що таке історія і як упізнати, що вона завершена. Markdown.

Критерії прийняття мають бути тут — бажано у формі Given / When / Then, щоб вони безпосередньо відповідали приймальним тестам:

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 — це перевірка на здоровий глузд щодо того, чи добре сформульована історія:

• Independent — можна випустити без інших історій.
• Negotiable — фіксує намір, а не заморожену специфікацію.
• Valuable — для користувача чи стейкхолдера.
• Estimable — команда може оцінити розмір.
• Small — комфортно вписується в ітерацію.
• Testable — має критерії прийняття, які можна перевірити.

Історія на верху беклогу з розмитими критеріями прийняття — це планувальний баг, а не майбутня проблема, яку можна ігнорувати. Виправте її, перш ніж дозволити просуватися.

Масові дії

Оберіть кілька історій на дошці (shift-клік для діапазону або Select all in panel). Тоді:

• Масовий перехід
• Масове видалення
• Масове дублювання

Дошка

Дошка — це головний екран кожного проєкту. Три колонки за замовчуванням:

• Current — історії в активній ітерації. Згруповані за заголовком ітерації (поточна, потім майбутні, потім закриті). Картки з’являються в порядку часової послідовності ітерації, а їхній стан видно на кожній картці; колонка не нарізана за станом — це руйнує часову послідовність ітерації, у якій планує команда.
• Backlog — суворо впорядкована черга. Система автоматично групує майбутні ітерації на основі швидкості. Власник продукту володіє порядком згори вниз; ясності дозволено погіршуватися в міру прокручування вниз, але ніколи на верху.
• Icebox — ідеї без дати. Невпорядковані, неоцінені. Icebox дозволено бути кладовищем.

Налаштовувані панелі — прапорці бічної панелі

Розділ Board бічної панелі перелічує кожну попередньо налаштовану колонку з прапорцем: поставте позначку, щоб показати цю колонку, зніміть, щоб приховати. Перемикачі зберігаються для кожного проєкту й кожного користувача (вони синхронізуються через GET/PUT /preferences). Пресети:

• Current Iteration (увімкнено за замовчуванням)
• Backlog (увімкнено за замовчуванням)
• Icebox (увімкнено за замовчуванням)
• Done — прийняті історії.
• My Work — історії, де ви є власником.
• Blocked — історії з невирішеними блокерами.
• Epics — згортки рівня епіків.
• Chat — колонка чату, обмежена проєктом.

Власні панелі фільтрів

Закріпіть пошук як панель: вставте запит на кшталт type:feature label:mvp owner:claire, збережіть його. Змінюйте розмір колонок як вам зручно; ширина зберігається між сесіями.

Пошук

Поле пошуку приймає синтаксис фільтрів, описаний у Вступі. Результати пошуку живуть у панелі результатів; натисніть будь-який, щоб перейти до нього на дошці.

Чип поточної ітерації

Верхній рядок показує номер поточної ітерації, діапазон дат та бали прийняті проти запланованих. Натисніть, щоб перейти до колонки Current.

Ітерації

Система створює ітерації автоматично на основі вашої довжини та дня початку. Вам не потрібно «відкривати» чи «закривати» їх.

Щоб планувати наперед, перетягуйте історії з Backlog у майбутні групи ітерацій. Система позначає групи червоним, якщо вони перевищують вашу швидкість. Щоб планувати ще далі, прокручуйте беклог — він показує три-чотири ітерації наперед.

Щоб перемотати назад: натисніть будь-який заголовок минулої ітерації в колонці Current, щоб заглибитися у звіт по ітерації.

Релізи

Релізи — це тип історії, а не окремий об’єкт. Створіть реліз так само, як ви створили б будь-яку історію: оберіть Release як тип, дайте йому назву (наприклад, v2.4), перетягніть його в ітерацію, у якій плануєте випустити.

Релізи пропускають стани Started/Finished/Delivered/Rejected — вони переходять від Unstarted до Accepted за один крок. Приймайте реліз, коли випускаєте; перегляди аналітики показують маркер релізу.

Аналітика

Вкладка Analytics (вгорі проєкту) дає вам шість звітів:

• Project Overview — тренд швидкості, KPI останньої ітерації, діаграма зростання, діаграма згоряння, кумулятивний потік.
• Iteration — заглиблення в одну ітерацію: KPI, діаграма згоряння, потік станів.
• Releases & Burndowns — часова шкала релізів, діаграма згоряння по кожному релізу.
• Story Activity — хто що зробив, з фільтрацією за актором, типом, діапазоном дат.
• Cycle Time — середнє значення та розподіл часу від Started до вашого завершеного стану.
• Projections — прогноз, коли беклог буде завершено за поточної швидкості.

Агенти

Це частина продукту, яка вирізняє його з-поміж інших. Агент — це названий член команди, але це AI.

Додавання агента до проєкту

Ви маєте бути власником проєкту (чи адміністратором). Відкрийте Project Settings → Agents:

1. Create new agent key.
2. Дайте агенту ім’я (воно з’явиться як це ім’я в журналах аудиту, авторстві коментарів та аватарах власників).
3. Оберіть роль — viewer (лише читання) або member (може писати). Роль власника обмежена людьми.
4. Ключ показується один раз — скопіюйте його; ми не зберігаємо його у відновлюваному вигляді. Префікс — ea_agent_….

Що можуть робити агенти

Агент з роллю member може робити все, що може людина-учасник:

• Створювати, редагувати, переводити, видаляти історії
• Коментувати, прикріплювати файли, додавати мітки, призначати власників
• Обирати себе власником історії
• Читати активність, слідкувати за подіями

Журнал аудиту записує кожен запис з ідентичністю агента. Немає способу зробити так, щоб дія агента виглядала як дія людини.

Керування ключами агентів

У Project Settings → Agents ви бачите всі активні ключі, їхні імена, ролі та позначку часу останнього використання. Відкличте ключ будь-коли; агент негайно втрачає доступ. Минула активність агента залишається в журналі аудиту назавжди.

Використання агентів з API

Дивіться Посібник з API → Ключі агентів для прикладів коду.

Імпорт з інших трекерів

Якщо ви переходите з іншого інструмента, у нас є імпортери для восьми джерел:

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

З Project Settings → Import завантажте експорт (CSV з більшості, JSON з Plane). Історії, власники, коментарі, мітки та стани зіставляються автоматично; деякі джерела також приносять ітерації.

Попередній перегляд показує, що буде імпортовано. Невідповідності (наприклад, мітка, якої немає у вашому проєкті) викликають запит — створити чи пропустити, на ваш вибір.

Теми

Постачаються чотири теми. Перемикайте у нижньому колонтитулі бічної панелі (або в Account Settings → Theme):

• Agile — палітра маркетингової лендинг-сторінки. Теплі білі тони, темно-синій фірмовий акцент (#1f6f9f), насичені іконки типів історій. Провідний варіант у перемикачі.
• Labs — палітра Pivotal Tracker, дбайливо збережена. Темний інтерфейс, синій верхній рядок, пастельні проміжки між колонками. Оригінал.
• Dark — чистий нейтральний темний.
• Light — чистий нейтральний світлий. Чорнило на папері.

Ваша тема зберігається між сесіями.

Мова

Інтерфейс перекладено 15 мовами: англійська, французька, німецька, іспанська, японська, китайська, корейська, португальська, італійська, нідерландська, шведська, данська, чеська, фінська, польська. Перемикайте у нижньому колонтитулі бічної панелі — інтерфейс, сторінки автентифікації, область облікового запису/безпеки, список проєктів та маркетингова лендинг-сторінка локалізуються негайно. Локалізація деталей історії / аналітики / налаштувань на підході.

Сполучення клавіш

Кілька, що виправдовують своє існування:

• Escape — згорнути останню відкриту історію.
• Enter у вбудованому полі введення — надіслати (не згортає рядок).
• Shift-клік — вибір історій діапазоном.

З часом додаються нові; дивіться Help на бічній панелі для поточного списку.

Самостійний хостинг

East Agile Tracker має відкритий код. Повний вихідний код за адресою github.com/EastAgile/agile-tracker — клонуйте його, зберіть, запустіть на власній інфраструктурі. Той самий набір функцій, що й у розміщеної версії.

Щодо налаштування дивіться README проєкту.