Инструкция по эксплуатации

Полное руководство пользователя. Концепции см. во Введении.

Аккаунт

Регистрация и вход

Зарегистрируйтесь на 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 — Добавьте привязанный к устройству passkey WebAuthn (Touch ID, Windows Hello, аппаратный ключ безопасности). После этого входите без пароля. Добавляйте, именуйте и удаляйте ключи на той же странице.

Сессии и refresh-токены

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

Биллинг

Большинство аккаунтов бесплатны навсегда для личного использования. Если на вашем аккаунте есть измеряемый кредитный баланс, найдите его в разделе Account → Billing — пополняйте через чекаут Paddle, смотрите историю транзакций.

Организации

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

Переключение организации

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

Управление организацией (администратор)

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

• Projects — Все проекты в этой организации.
• Members — Текущие участники, роли и ожидающие приглашения. Приглашайте по электронной почте; приглашение привязано к email, имеет токен с TTL и потолок роли (участники не могут приглашать администраторов).
• Settings (только для владельцев) — Имя организации, slug, план. Здесь же передавайте право владения другому участнику.

Удаление участника

Удаление участника из организации каскадирует: его членства в проектах этой организации отзываются в той же транзакции. Закладки с URL досок перестают работать в момент потери доступа к организации — никаких осиротевших следов.

Проекты

Создание проекта

На странице Projects нажмите New Project. Форма создания запрашивает только две вещи:

• Title — Обязательно.
• Description — Опционально; видно всем участникам.

Всё остальное — длина итерации, день начала, начальная velocity, шкала оценки, состояние завершённости, переключатель задач — задаётся позже в Project Settings и инициализируется разумными значениями по умолчанию.

Настройки проекта

В меню проекта Settings четыре вкладки:

• Project — Редактируйте заголовок, описание, длину итерации и день начала, стратегию velocity (среднее за последние 3 / 5 / 10), состояние завершённости, шкалу оценки, переключатель задач.
• Member — Приглашайте, повышайте/понижайте и удаляйте участников-людей (см. Участники и приглашения ниже).
• Agent — Выпускайте и отзывайте API-ключи агентов для этого проекта (см. Агенты ниже). Только для владельцев.
• Import — Перенесите истории из другого трекера (см. Импорт из других трекеров ниже).

Участники и приглашения

На вкладке Member в Project Settings приглашайте людей по электронной почте. Ожидающие приглашения находятся в отдельной корзине, пока не приняты; вы видите, кто приглашён, и можете отправить повторно или отозвать. Активных участников можно повышать/понижать между viewer, member и owner. Владельцы могут менять настройки проекта; зрители могут читать, но не писать.

История проекта находится на своей собственной странице — каждое изменение настроек проекта, каждое изменение членства, с указанием актора (человека или агента).

Истории

Создание истории

Используйте элемент + Add story на любой панели доски (Current, Backlog, Icebox или кастомной) — введите заголовок и нажмите Enter.

Новые истории, созданные в Current, по умолчанию получают current_state = 'unstarted'. Это паритет с PT: итерация Current — это план работы, а не разделение по состоянию. Владелец явно Starts историю, когда приступает к работе, — часы времени цикла не запускаются до этого момента.

Обязательно: заголовок. Выберите тип (по умолчанию 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 в боковой панели: создавайте метки с именами и цветами, архивируйте устаревшие (архивные метки исчезают с доски, но остаются доступными для поиска). Добавляйте метки к каждой истории в панели деталей.

Блокеры, ссылки, ревью

• Blockers (блокеры) — Свободная текстовая заметка «это заблокировано X». Помечайте как resolved/unresolved. Фильтруйте доску по has:blocker.
• Links (ссылки) — Шесть типов отношений: relates to, duplicates, blocks, is blocked by, pull request, branch. Вставьте URL GitHub, и тип определится автоматически.
• Reviews (ревью) — Назначьте ревьюера (человека или агента) со статусом (pending, approved, rejected) и опциональным комментарием.

Задачи

Если включено в Project Settings, истории получают подзадачи — чек-лист внутри истории. Отмечайте их по мере выполнения; счётчик появляется на карточке.

Справочник по полям истории

Каждая переменная выбора на поверхности деталей истории несёт рядом со своей меткой небольшую иконку [?]. Нажмите её в приложении, чтобы увидеть те же рекомендации, которые кратко изложены ниже. Переводчики поставляют внутренний текст приложения вместе с остальным интерфейсом; этот раздел — развёрнутый канонический справочник.

Поля перечислены в том порядке, в котором они появляются на вкладке Overview.

Status (статус)

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

Критическое состояние — Delivered: инженер помечает её как доставленную, но она не считается завершённой, пока владелец продукта явно не Accepts её по критериям приёмки — или не отклонит, вернув обратно. Это встраивает цикл обратной связи с заказчиком в каждую историю, а не откладывает приёмку до демонстрации в конце спринта.

Если истории накапливаются в Delivered, это сигнал о том, что цикл приёмки/отклонения застопорился. Смотрите на счётчик Delivered в конце каждой итерации — если он растёт, это ваш сигнал о том, что владелец продукта недостаточно загружен ресурсами или критерии приёмки недостаточно ясны заранее.

Iteration (итерация)

В какую итерацию запланирована история. Оставьте значение None, чтобы держать историю в Backlog, где система автоматически сгруппирует её под предстоящей итерацией на основе velocity.

Ручное переопределение здесь полезно, когда вы хотите закрепить историю за конкретной итерацией независимо от порядка — например, привязать релизную историю к фиксированной дате. В остальных случаях позвольте порядку в Backlog управлять назначением итераций; именно это сохраняет честность прогноза velocity.

Owners (владельцы)

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

Несколько владельцев — это видимое выражение парного программирования (или пары с агентом). Добавьте агента, который взял историю, и человека, который проверяет, — оба имени появятся на карточке. Это держит объём незавершённой работы низким; завершение перед началом следующей истории — самый большой рычаг влияния на время цикла.

Владельцы — это не то же самое, что Followers (подписчики) (отдельное поле на карточке). Подписчики — это люди, которым важна история, но которые не делают работу — обычно подписчики на уведомления.

Story type (тип истории)

Четыре типа не взаимозаменяемы — различие между ними и есть весь смысл модели данных.

• Feature (фича) — Новая наблюдаемая пользователем ценность. Единственный тип, который несёт баллы и засчитывается в velocity. Это заставляет вас нарезать работу на ценность, которую пользователь может увидеть.
• Bug (баг) — Дефект. Без баллов. Дефекты не приносят зачётных баллов velocity, что сохраняет видимость стоимости переработки, а не вознаграждает её.
• Chore (рутинная задача) — Необходимая работа без прямой пользовательской ценности (рефакторинги, инфраструктура, настройка). Без баллов. Команду подталкивают объединять рутинные задачи с фичами везде, где это возможно, чтобы фрейминг ценности оставался честным.
• Release (релиз) — Маркер вехи с нулём баллов. Идёт напрямую из Unstarted в Accepted, закрепляя дату для прогноза.

Если вам захотелось оценить баг или рутинную задачу в баллах: не делайте этого. Это ломает прогноз, делающий всю систему честной. Velocity — это измерительный инструмент; вы не подкручиваете собственный инструмент.

Priority (приоритет)

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

Поле «приоритета» — это классический антипаттерн, который тихо превращает эмпирический, упорядоченный бэклог обратно в планирование на основе пожеланий. Если у вас оказалось три P1, у вас нет приоритета — у вас Backlog с неправильным порядком. Исправьте порядок; удалите сигнал приоритета.

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

Points (баллы)

Относительный размер истории. Фичи получают баллы; баги, рутинные задачи и релизы остаются на нуле.

Оценка — это разговор о размере, а не обещание. Не переводите баллы в часы; не раздувайте баллы, чтобы выглядеть быстрыми. Velocity — это измерительный инструмент; вы не подкручиваете собственный инструмент.

Поставляются три шкалы:

• 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 (блокеры)

Свободные текстовые заметки, описывающие, что мешает этой истории продвигаться. Помечайте как resolved, когда препятствие снято.

Блокеры — это сигнал потока, а не очередь. Используйте ежедневный стендап, чтобы их выявлять; устраняйте их вне процесса. Если у вас более одного-двух открытых блокеров на историю дольше дня, планирование неверно — разбейте историю или измените зависимость. Цель в том, чтобы панель 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 — Строго упорядоченная очередь. Система автоматически группирует предстоящие итерации на основе velocity. Владелец продукта владеет порядком сверху вниз; ясности позволено снижаться по мере прокрутки вниз, но никогда у вершины.
• Icebox — Идеи без даты. Неупорядоченные, неоценённые. Icebox имеет право быть кладбищем.

Настраиваемые панели — флажки боковой панели

Раздел Board боковой панели перечисляет каждую пресет-колонку с флажком: поставьте галочку, чтобы показать эту колонку, снимите, чтобы скрыть. Переключатели сохраняются для каждого проекта и каждого пользователя (они синхронизируются через GET/PUT /preferences). Пресеты:

• Current Iteration (включено по умолчанию)
• Backlog (включено по умолчанию)
• Icebox (включено по умолчанию)
• Done — Принятые истории.
• My Work — Истории, где вы владелец.
• Blocked — Истории с нерешёнными блокерами.
• Epics — Сводки на уровне эпиков.
• Chat — Колонка чата, ограниченная проектом.

Кастомные панели фильтров

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

Поиск

Строка поиска принимает синтаксис фильтров, описанный во Введении. Результаты поиска живут в панели результатов; нажмите на любой, чтобы перейти к нему на доске.

Чип текущей итерации

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

Итерации

Система создаёт итерации автоматически на основе вашей длины и дня начала. Вам не нужно «открывать» или «закрывать» их.

Чтобы планировать наперёд, перетаскивайте истории из Backlog в группы предстоящих итераций. Система помечает группы красным, если они превышают вашу velocity. Чтобы планировать ещё дальше, прокручивайте бэклог — он показывает три или четыре итерации вперёд.

Чтобы отмотать назад: нажмите на любой заголовок прошлой итерации в колонке Current, чтобы погрузиться в отчёт по итерации.

Релизы

Релизы — это тип истории, а не отдельный объект. Создайте релиз так же, как создавали бы любую историю: выберите Release в качестве типа, дайте ему имя (например, v2.4), перетащите в итерацию, в которой намерены выпустить.

Релизы пропускают состояния Started/Finished/Delivered/Rejected — они идут из Unstarted в Accepted в один шаг. Примите релиз, когда выпускаете; представления аналитики отображают маркер релиза.

Аналитика

Вкладка Analytics (вверху проекта) даёт вам шесть отчётов:

• Project Overview — Тренд velocity, KPI недавних итераций, burnup, burndown, кумулятивный поток.
• Iteration — Погружение в отдельную итерацию: KPI, burndown, поток состояний.
• Releases & Burndowns — Таймлайн релизов, burndown по каждому релизу.
• Story Activity — Кто что сделал, с фильтрацией по актору, типу, диапазону дат.
• Cycle Time — Среднее и распределение времени от Started до вашего состояния завершённости.
• Projections — Прогноз того, когда бэклог будет завершён при текущей velocity.

Агенты

Это та часть продукта, которая отличает его от других. Агент — это именованный член команды, но это ИИ.

Добавление агента в проект

Вы должны быть владельцем проекта (или администратором). Откройте Project Settings → Agents:

1. Create new agent key.
2. Дайте агенту имя (оно будет отображаться как это имя в журналах аудита, авторстве комментариев и аватарах владельцев).
3. Выберите роль — viewer (только чтение) или member (может писать). Роль owner зарезервирована для людей.
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 в боковой панели для актуального списка.

Self-hosting

East Agile Tracker имеет открытый исходный код. Полный исходный код находится на github.com/EastAgile/agile-tracker — клонируйте его, соберите, запустите на собственной инфраструктуре. Тот же набор функций, что и в размещённой версии.

Для настройки см. README проекта.