Рабочее место команды
План, задачи, обсуждения и решения — в одном документе. Здесь берут задачи в работу, отмечают пункты, отвечают на вопросы, спорят в обсуждениях и фиксируют решения. Всё сохраняется автоматически.
Добавьте себя в команду
При первом открытии документ попросит выбрать себя или добавиться: имя, роль и цвет. Цветом подписываются отметки, сообщения и ответы.
Раскройте и работайте
Статус, исполнители, срок и приоритет — в панели задачи. Ниже: вопросы с ответами, решение, рабочая заметка, обсуждение, пункты выполнения и ссылки на PR.
Сервер, файл или браузер
С сервера изменения сразу видны всей команде. Состояние сохранения показано вверху справа, по клику открываются настройки хранения.
Три вида
Весь план по шагам, задачи раскрываются на месте. Удобно для обсуждения и проработки.
Задачи по статусам. Карточку можно перетащить в другую колонку, клик открывает задачу в боковой панели.
Кто что сделал: отметки, статусы, сообщения, решения. Фильтр «Упоминания меня» показывает обращения через @имя.
Хранение
| Режим | Как включается | Для чего |
|---|---|---|
| Сервер | Документ открыт с адреса roadmap-server — включается сам | Основной режим. Общие данные, обновления в реальном времени, офлайн-очередь, снимки в Gitea |
| Файл | Документ открыт с диска в Chrome, Edge или Яндекс.Браузере → «Подключить progress.json» | Работа без сервера. Синхронизация через git |
| Браузер | По умолчанию, если нет ни сервера, ни файла | Временно. Перенос через экспорт и импорт JSON |
roadmap/data.js, работа команды — в progress.json. ID задач и пунктов не меняются. Чтобы раскрыть следующий шаг: «Настройки → Сводка для AI» → скопировать и передать ассистенту вместе с комментарием.8 правил, которые не нарушаются
Полная версия с деталями — в AGENTS.md. Её читают и разработчики, и AI-ассистенты.
Монолит, функции отключаются программно
Один сервер, одна БД, одна кодовая база для SaaS и on-prem. Редакции, лимиты и незаконченные функции управляются каталогом функций.
Организации изолированы
tenant_id в каждой таблице + Row-Level Security. Запросов без организации не бывает.
Доступ = право + область
Роль назначается на подразделение и действует на всё поддерево. Проверяет сервер, интерфейс только скрывает.
Безопасность в основе
mTLS для агентов, подписанные команды, 2FA, неизменяемый журнал аудита, режимы удалённого доступа.
Контракт раньше кода
openapi.yaml и .proto — источник истины. Изменения контрактов — отдельным MR.
Решения записываются
Значимое решение — ADR на одну страницу в docs/adr/ и запись в журнале решений документа.
Только разрешённые зависимости
MIT, BSD, Apache-2.0, MPL-2.0. Без AGPL/GPL. Всё работает в закрытом контуре без интернета.
Узко, но правильно
Объём режется, качество основы — нет. Новое вне текущего шага — в бэклог.
Состав продукта
shtil-server
Go, монолит. PostgreSQL, встроенный NATS, MinIO. REST API для приложения, WebSocket для агентов.
«Штиль»
Tauri 2 + Vue 3. Одно приложение для всех ролей: владелец, администраторы, техники, офисы филиалов, аудиторы.
Агент
Go, служба без окон. Связь с сервером, инвентаризация, метрики, подписанные команды.
Помощник
Иконка в трее у сотрудника: обращения, статусы, уведомления; в фазе 2 — согласие и индикатор удалённого доступа.
Фазы и шаги
Каждый шаг заканчивается работающим результатом и версией. Красным выделен текущий шаг.
Статусы, обсуждения, решения
Документ заменяет трекер задач. Правила ниже одинаковы для всех, чтобы по статусу задачи всегда было понятно, что с ней происходит.
Статусы задачи
| Статус | Что значит |
|---|---|
| Не начато | Задача в плане, никто не взял |
| В работе | Есть исполнитель, работа идёт. Ставится автоматически при первой отметке пункта |
| На проверке | Открыт PR или решение ждёт второго разработчика |
| Выполнено | Все пункты отмечены, PR смержен, решение принято |
| Заблокировано | Есть нерешённый блокер. Причина — сообщением типа «Блокер» |
- Первая отметка пункта → «В работе», исполнитель — вы, если никто не назначен.
- Отмечены все пункты → предложение перевести в «Выполнено».
- Сообщение-блокер → предложение перевести в «Заблокировано».
- Сообщение-решение → предложение перенести текст в поле «Решение».
Типы сообщений
| Тип | Когда |
|---|---|
| Комментарий | Обычное сообщение, ход работы |
| Вопрос | Нужен ответ. Отмечается «Решено», когда ответ получен |
| Предложение | Вариант решения для обсуждения |
| Блокер | Работа остановлена. Задача получает отметку «Блокер» |
| Решение | Итог обсуждения. Переносится в поле «Решение» |
Путь решения
docs/adr/Ритм недели
| Когда | Что |
|---|---|
| Понедельник, 30 мин | Доска: задачи на неделю, исполнители, сроки |
| Каждый день | Короткая запись в Ленте или в задаче: сделал · делаю · мешает |
| По ходу работы | Отметки пунктов, вопросы и решения — в задаче |
| Пятница, 30 мин | Демо друг другу, задачи «На проверке» → «Выполнено», ретро |
| Конец шага | Сквозная проверка, тег версии, «Сводка для AI» → раскрытие следующего шага |
Договорённости
- Решение, которого нет в документе, считается непринятым.
@Имя— упоминание, у адресата появится отметка в Ленте.#2.11или#2.11.4в тексте — ссылка на задачу или пункт.- [ ] пунктв заметке или сообщении — галочка, которую может отметить любой.- Свой пункт в «Выполнении» — для работы, которой нет в плане. В конце шага ассистент переносит такие пункты в план.
- Ссылку на PR в Gitea добавляйте в «Ссылки» задачи.
Совместная работа без поломок
# задача [2.11] взята в работу git switch main && git pull --rebase git switch -c feat/2.11-tenant-isolation # маленькие коммиты, Conventional Commits git commit -m "feat(server): add WithTenantTx helper" -m "Refs: 2.11.4" git commit -m "test(server): tenant isolation" -m "Refs: 2.11.6" # перед PR — свежий main, конфликты решаются у себя git fetch && git rebase origin/main git push -u origin feat/2.11-tenant-isolation # Gitea: PR «[2.11] Изоляция организаций» → CI → ревью → squash merge
| Элемент | Формат |
|---|---|
| Ветка | feat/2.11-кратко · fix/… · chore/… · docs/… |
| Коммит | тип(область): что + строка Refs: 2.11.4 |
| Области | server agent helper console ui proto api db ci docs |
| Pull Request | Название «[ID] Название задачи». Описание — кнопка «Для PR» в задаче. Ссылку на PR — в «Ссылки» задачи |
- Пушить в
mainнапрямую и делатьforce pushв общие ветки. - Мержить при красном CI. Сломанный
mainчинится первым. - Держать ветку дольше 3 дней. Незаконченное прячется за техническим флагом функции.
- Редактировать смерженную миграцию — только новая миграция.
- Менять
openapi.yaml,proto/,migrations/внутри большого PR — только отдельным, с обсуждением. - Редактировать
progress.jsonна сервере руками — его пишет только roadmap-server.
Версии и CHANGELOG
| Версия | Когда |
|---|---|
v0.1.0 | Конец шага 2 — каркас |
v0.2.0 … v0.8.0 | Конец шагов 3–9 |
v0.9.x | Закрытая бета (фаза 2) |
v1.0.0 | Коммерческий релиз |
- До беты у всех компонентов одна общая версия репозитория; отдельно версионируется протокол агента.
CHANGELOG.mdгенерируется из коммитов (git-cliff) при постановке тега.- Прогресс дорожной карты хранится в отдельном репозитории Gitea и не засоряет историю
main.
Главное окно приложения «Штиль»
Пример того, как много функций помещаются в одно окно без перегрузки. Переключите роль: тот же экран для наблюдателя филиала становится проще — лишние разделы и действия исчезают, область закреплена.
Работа 4
Управление
Аналитика
Обзор
Состояние филиала
Что происходит в ИТ-парке и что требует реакции
Устройства, обращения и показатели филиала «Брянск»
Не печатает принтер
- 1Выбор организации. Для MSP и пользователей нескольких организаций. У остальных — просто название.
- 2Поиск и команды, Ctrl+K. Найти ПК, человека, обращение; выполнить действие с клавиатуры («подключиться к PC-BRY-014»).
- 3Уведомления. Новые обращения и алерты, в том числе системными уведомлениями при свёрнутом окне.
- 4Меню по правам и функциям. Три группы, до 11 пунктов. Недоступное по правам или отключённое по редакции скрыто.
- 5Область. Весь экран показывает выбранное подразделение. У наблюдателя закреплено с замком.
- 6Сводка из 4 чисел. По клику — отфильтрованный список устройств или обращений.
- 7Входящие. Обращения сотрудников и алерты в одном списке по важности, действие — прямо в строке.
- 8Подразделения. Сравнение филиалов, где проблемы. У наблюдателя — отделы его филиала.
- 9Карточка в боковой панели. Подробности и действия без ухода со страницы. Закрыли — вернулись к списку.
- 10Подсказка решения. Подбор скрипта по диагностике — фаза 2+. В фазе 1 скрипт выбирается вручную.
- 11Строка состояния. К какому серверу подключено приложение, версия, связь.
Как интерфейс не перегружается при росте функций
Один экран для всех уровней: данные фильтруются выбранным подразделением, а не дублируются отдельными страницами.
Стартовый экран и меню строятся по правам. Наблюдатель не видит инструментов админа вообще.
Отключённые редакцией функции не занимают место. Новый модуль — один пункт меню в нужной группе.
Всё, что требует реакции, в одном месте. Не нужно обходить разделы в поисках проблем.
Действия рядом с объектом, карточки в боковой панели, массовые операции из выделения в таблице.
Сводка сразу, детали по клику, редкие настройки в «Настройках». Ctrl+K — короткий путь к любому месту.
Помощник на ПК сотрудника и удалённый доступ
Окна Помощника (фаза 1, шаг 6) и экраны удалённого доступа (фаза 2) по решениям 1.9 и 1.10.
Пункта «Выход» нет. Иконка показывает состояние связи.
Показывается Помощником. Решение о показе принимает агент по подписанной политике.
Красная рамка по краю экрана и панель, которую нельзя скрыть. Сотрудник завершает сеанс в любой момент.
Следующие шаги и фазы
Краткое описание. Каждый шаг раскрывается подробно, когда закончен предыдущий.
Принятые и обсуждаемые решения
Собирается автоматически из полей «Решение» всех задач.