$ agit // control plane
Доверие к цифрам · Altered Graph.it

Почему цифрам можно верить

AG.it — это контрольная панель, где состояние проекта не докладывают, а вычисляют. Каждое число на экране — обещание доверия, поэтому здесь честно сказано: что считается, что делает цифру истинной, и где число опирается на человеческое решение, а не на голый факт.

“Состояние проекта вычисляется из фактов — и интерфейс это доказывает.”

Обещание

Статус, деньги и риск — не то, что кто-то о себе написал. Они выводятся из трёх видов фактов и пересчитываются заново при каждом изменении.

Задачи
Снимок задач проекта на дату — что закрыто, что просрочено, что началось. Состояние собирается из снимка, как сборка из коммита.
Сигналы
Append-only поток событий: подтверждение приёмки, расход, перенос срока с причиной, soft-сигнал «заказчик назначил приёмку». Записи не правятся — изменения добавляются новым событием.
Принятые этапы
Деньги «обеспечены» только тогда, когда этап принят — подписан акт приёмки. Не «готово на 80%», а «акт подписан, платёж закрыт».

Любое число можно раскрыть до его причины: вердикт показывает строку-доказательство («N задач закрыто · M/K целей принято»), а каждое изменение в diff стоит на дате факта или сигнала. Если данных нет — об этом сказано словами, а не подставлен правдоподобный ноль.

Что считается и как

Главные показатели, которые видит покупатель. Для каждого — что он значит и что делает его истинным. Деньги всегда держатся раздельно по валютам — рубли и доллары никогда не смешиваются в одну сумму.

Выручкаденьги

Сумма по этапам, которые уже приняты. Это деньги, за которые результат зафиксирован.

Истинно, когда: этап принят — подписан акт приёмки (или приёмка явно подтверждена человеком). Пока акта нет, деньги сюда не попадают, сколько бы задач ни было закрыто.

Осталось закрытьденьги

Сумма по денежным этапам, которые ещё не приняты. Деньги в работе: результат может быть почти готов, но акт не подписан.

Истинно, когда: у этапа есть деньги и срок, но приёмки ещё нет. «Выручка + осталось закрыть» = вся денежная сумма проекта.

Под угрозойденьги

Часть «Осталось закрыть», выделенная красным: деньги, которые могут не прийти. Это подмножество «Осталось закрыть», а не отдельная сумма поверх.

Истинно, когда: непринятый денежный этап заблокирован, помечен как рисковый, или его срок уже прошёл. Просроченный срок считается угрозой, даже если работа идёт штатно — намеренно осторожно, в пользу раннего предупреждения.

Задержка

На сколько дней проект отстаёт от плана. Подсвечивается в шапке и в строке вердикта.

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

Расчётный финиш

Когда проект закончится по фактам. Вердикт вкладки «Сроки», чип «финиш» в Обзоре и точка ● на Карте портфеля — одно и то же число.

Истинно, когда: конец каждой цели берётся по явной лестнице — прогноз команды → плановый срок вехи → последняя дата привязанных задач; финиш = самый поздний конец среди непринятых целей. Полоса «окна задач» рисуется только при ≥2 датированных задачах — стартов в фактах нет, и мы их не выдумываем. Нет дат — честное «прогноз невозможен» со ссылкой в план, а не правдоподобная дата.

Прогресс

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

Истинно, когда: считается как процент закрытых задач от активных (отменённые исключены из знаменателя). Это про активность; «готово на 80%» ничего не говорит, пока нет денежного чтения рядом.

Статус проекта

Светофор проекта: в норме · риск · опасность. Один и тот же критерий для карточки проекта и реестра портфеля.

Истинно, когда: выводится из фактов — есть заблокированная цель или большая задержка → опасность; рисковая цель, ощутимая задержка или новый риск → риск; иначе норма. Чип не может светиться зелёным над баннером «деньги под угрозой» — берётся худшее из двух.

Вердикт

Одна фраза-диагноз: что сейчас главное («Деньги под угрозой — результат не зафиксирован»). Под ней — строка-доказательство из фактов.

Истинно, когда: выбирается по строгому приоритету правил — сначала инструментальный провал и блокеры, затем задержка, незакрытые деньги, новые риски. Доказательство («N задач закрыто · M/K целей принято») держит вердикт на фактах, а не на формулировке.

Что изменилось · diff

Разница между двумя снимками: что достигнуто, что сдвинулось, какие сигналы пришли. Каждое изменение — с датой факта.

Истинно, когда: сопоставляются два снимка плана и поток сигналов между ними. Отдельно — сверка: где человеческое «готово» подтверждено авторитетным снимком, а где ему противоречит.

Здоровье плана

Чип «N замечаний» в шапке: цель без критерия приёмки, веха без суммы, висячая зависимость, накопленные переносы срока. Это не статус работы, а качество самой модели.

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

Свежесть данных

Когда сделан последний снимок. Проект помечается «устарел», если снимок старше недели — чтобы вы знали, на какой момент смотрите.

Истинно, когда: вся панель считается от одной оси времени. Можно отмотать на любую дату (time-travel) — состояние восстанавливается из снимков, какое было тогда, воспроизводимо.

Честные оговорки

Там, где число опирается не на чистый внешний факт, мы говорим об этом прямо. Это вопрос целостности, а не дефект: доверие к цифре должно быть градуированным.

«Принято» может быть подтверждением человека
В идеале «выручка» опирается на внешний факт — подписанный акт, выписку банка, ЭДО. Но приёмку подтверждает человек, и иногда «принято» — это его явное подтверждение, а не автоматически считанная оплата. Это по дизайну: критерий правды решает человек, а не бот рисует зелёное. Поэтому цель показа — отличать «принято человеком» от «подтверждено внешним фактом».
EN-вид пересчитывает рубли в €/$ по фиксированному курсудемо-курс
В русском виде суммы — в валюте проекта (рубли). В английском виде демо-данные пересчитываются в евро/доллары по фиксированному демонстрационному курсу, а не по курсу дня. Это удобно для показа, но €/$-сумма в демо — приблизительная, а не рыночная. На реальном внедрении валюта проекта сохраняется как есть.
«Под угрозой» осторожно по построению
Денежный этап с прошедшим сроком попадает «под угрозу», даже если работа формально идёт штатно. Мы намеренно склоняемся к раннему предупреждению: лучше показать риск рано, чем узнать о срыве приёмки постфактум.
Задержка — это худшая задача, а не среднее
«Задержка +N дней» — это наибольшая задержка среди задач проекта: самая протухшая задаёт планку. Так баннер не размывается усреднением и показывает реальный край риска.
Прогресс — это темп, не результат
Процент закрытых задач полезен, но не является деньгами и не означает «сделано». Поэтому он никогда не ведёт картину один — рядом всегда денежное чтение: выручка / осталось закрыть / под угрозой.
Качество входа = качество модели
Метрика помечает свою силу честно: «сильный сигнал», «слабый», «прокси», «нет данных». Если показатель меряет цель лишь частично — об этом сказано оговоркой прямо в карточке цели. Мы не выдаём слабый сигнал за точное измерение.

Чего вы никогда не увидите

Несколько правил, которые мы держим жёстко — именно они отличают контрольную панель от красивого дашборда.

Хотите увидеть это вживую — сценарий для собственника проходит по тем же экранам шаг за шагом, на живых демо-данных.

Если встретится термин

Снимок (срез) — снимок задач проекта на дату; из него вычисляется состояние — как сборка из коммита.
Этап / веха — цель с деньгами и сроком: за её приёмку платят по акту.
Выручка / Осталось закрыть — деньги на принятых этапах (акт подписан) / на ещё не принятых (висят на критериях приёмки).
Приёмка — подтверждение, что этап принят (запись в журнале приёмок), с датой и основанием.
Сигнал — append-only событие: подтверждение, расход, перенос срока с причиной, soft-сигнал.
Diff — что изменилось между двумя снимками: что сделано, что сдвинулось, что под риском.