Штиль.Дорожная карта
00 · Как пользоваться

Рабочее место команды

План, задачи, обсуждения и решения — в одном документе. Здесь берут задачи в работу, отмечают пункты, отвечают на вопросы, спорят в обсуждениях и фиксируют решения. Всё сохраняется автоматически.

1 · КТО ВЫ

Добавьте себя в команду

При первом открытии документ попросит выбрать себя или добавиться: имя, роль и цвет. Цветом подписываются отметки, сообщения и ответы.

2 · ЗАДАЧА

Раскройте и работайте

Статус, исполнители, срок и приоритет — в панели задачи. Ниже: вопросы с ответами, решение, рабочая заметка, обсуждение, пункты выполнения и ссылки на PR.

3 · СОХРАНЕНИЕ

Сервер, файл или браузер

С сервера изменения сразу видны всей команде. Состояние сохранения показано вверху справа, по клику открываются настройки хранения.

Три вида

ДОКУМЕНТ · ALT+1

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

ДОСКА · ALT+2

Задачи по статусам. Карточку можно перетащить в другую колонку, клик открывает задачу в боковой панели.

ЛЕНТА · ALT+3

Кто что сделал: отметки, статусы, сообщения, решения. Фильтр «Упоминания меня» показывает обращения через @имя.

Хранение

РежимКак включаетсяДля чего
СерверДокумент открыт с адреса roadmap-server — включается самОсновной режим. Общие данные, обновления в реальном времени, офлайн-очередь, снимки в Gitea
ФайлДокумент открыт с диска в Chrome, Edge или Яндекс.Браузере → «Подключить progress.json»Работа без сервера. Синхронизация через git
БраузерПо умолчанию, если нет ни сервера, ни файлаВременно. Перенос через экспорт и импорт JSON
Как дополняется документСодержание — в roadmap/data.js, работа команды — в progress.json. ID задач и пунктов не меняются. Чтобы раскрыть следующий шаг: «Настройки → Сводка для AI» → скопировать и передать ассистенту вместе с комментарием.
01 · Правила проекта

8 правил, которые не нарушаются

Полная версия с деталями — в AGENTS.md. Её читают и разработчики, и AI-ассистенты.

01

Монолит, функции отключаются программно

Один сервер, одна БД, одна кодовая база для SaaS и on-prem. Редакции, лимиты и незаконченные функции управляются каталогом функций.

02

Организации изолированы

tenant_id в каждой таблице + Row-Level Security. Запросов без организации не бывает.

03

Доступ = право + область

Роль назначается на подразделение и действует на всё поддерево. Проверяет сервер, интерфейс только скрывает.

04

Безопасность в основе

mTLS для агентов, подписанные команды, 2FA, неизменяемый журнал аудита, режимы удалённого доступа.

05

Контракт раньше кода

openapi.yaml и .proto — источник истины. Изменения контрактов — отдельным MR.

06

Решения записываются

Значимое решение — ADR на одну страницу в docs/adr/ и запись в журнале решений документа.

07

Только разрешённые зависимости

MIT, BSD, Apache-2.0, MPL-2.0. Без AGPL/GPL. Всё работает в закрытом контуре без интернета.

08

Узко, но правильно

Объём режется, качество основы — нет. Новое вне текущего шага — в бэклог.

Состав продукта

СЕРВЕР

shtil-server

Go, монолит. PostgreSQL, встроенный NATS, MinIO. REST API для приложения, WebSocket для агентов.

ПРИЛОЖЕНИЕ

«Штиль»

Tauri 2 + Vue 3. Одно приложение для всех ролей: владелец, администраторы, техники, офисы филиалов, аудиторы.

НА УСТРОЙСТВЕ

Агент

Go, служба без окон. Связь с сервером, инвентаризация, метрики, подписанные команды.

НА УСТРОЙСТВЕ

Помощник

Иконка в трее у сотрудника: обращения, статусы, уведомления; в фазе 2 — согласие и индикатор удалённого доступа.

02 · Карта разработки

Фазы и шаги

Каждый шаг заканчивается работающим результатом и версией. Красным выделен текущий шаг.

03 · Как работаем

Статусы, обсуждения, решения

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

Статусы задачи

СтатусЧто значит
Не начатоЗадача в плане, никто не взял
В работеЕсть исполнитель, работа идёт. Ставится автоматически при первой отметке пункта
На проверкеОткрыт PR или решение ждёт второго разработчика
ВыполненоВсе пункты отмечены, PR смержен, решение принято
ЗаблокированоЕсть нерешённый блокер. Причина — сообщением типа «Блокер»
Автоматически
  • Первая отметка пункта → «В работе», исполнитель — вы, если никто не назначен.
  • Отмечены все пункты → предложение перевести в «Выполнено».
  • Сообщение-блокер → предложение перевести в «Заблокировано».
  • Сообщение-решение → предложение перенести текст в поле «Решение».

Типы сообщений

ТипКогда
КомментарийОбычное сообщение, ход работы
ВопросНужен ответ. Отмечается «Решено», когда ответ получен
ПредложениеВариант решения для обсуждения
БлокерРабота остановлена. Задача получает отметку «Блокер»
РешениеИтог обсуждения. Переносится в поле «Решение»

Путь решения

1Вопросы В1, В2… — ответы прямо под вопросом
2Обсуждение: предложения, вопросы, блокеры
3Решение → статус «Принято»
4ADR в docs/adr/

Ритм недели

КогдаЧто
Понедельник, 30 минДоска: задачи на неделю, исполнители, сроки
Каждый деньКороткая запись в Ленте или в задаче: сделал · делаю · мешает
По ходу работыОтметки пунктов, вопросы и решения — в задаче
Пятница, 30 минДемо друг другу, задачи «На проверке» → «Выполнено», ретро
Конец шагаСквозная проверка, тег версии, «Сводка для AI» → раскрытие следующего шага

Договорённости

  • Решение, которого нет в документе, считается непринятым.
  • @Имя — упоминание, у адресата появится отметка в Ленте.
  • #2.11 или #2.11.4 в тексте — ссылка на задачу или пункт.
  • - [ ] пункт в заметке или сообщении — галочка, которую может отметить любой.
  • Свой пункт в «Выполнении» — для работы, которой нет в плане. В конце шага ассистент переносит такие пункты в план.
  • Ссылку на PR в Gitea добавляйте в «Ссылки» задачи.
04 · Git и версии

Совместная работа без поломок

# задача [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.
05 · Прототип интерфейса

Главное окно приложения «Штиль»

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

Показать как:
ООО «Ромашка» 1
ООО «Ромашка»
513
ИИИванов И.Владелец
ОБОфис БрянскаНаблюдатель
Работа 4
ОбзорСостояние
Входящие124
Устройства1 284352
Удалённый доступ
Скрипты и задачи
Управление
Обновления
Активы и лицензии
Подразделения
Аналитика
Отчёты
Журнал аудита
Настройки
Редакция «Профи»1 284 из 1 500 устройств
Все подразделения
Филиал Брянск
5 ООО «Ромашка» · 3 филиала · 11 отделов Доступ: только просмотр Обновлено только что

Обзор

Состояние филиала

Что происходит в ИТ-парке и что требует реакции

Устройства, обращения и показатели филиала «Брянск»

Установить агентЗапустить скрипт
Отчёт за месяц
В сети 61 231340из 1 284из 352
Требуют внимания72+2 за часалерта
Открытые обращения1243 срочных1 срочное
Индекс здоровья8784+3за неделю
Входящие · требует реакции7Все 19 →Все 6 →
ОбращениеНе печатает принтерИванова М. · Бухгалтерия, Брянск · PC-BRY-014 · 3 мин
ВзятьНовое
АлертSRV-1C-01: диск D заполнен на 94%Головной офис · растёт 2% в день · 12 мин
Очистить
СрочноНе открывается 1СОрлова Е. · Склад, Москва · WH-MSK-03 · 25 мин
Взять
АлертНе в сети 2 ч: KASSA-BRY-02Торговый зал, Брянск · последняя связь 10:02
Проверить
ОбращениеНужен доступ к папке «Отчёты»Белов А. · Экономисты, Брянск · 1 ч
ВзятьВ работе
Подразделения8Все →
НазваниеУстр.В сетиЗдоровье
Головной офис41299%
Филиал Москва52095%
Филиал Брянск35297%
Отделы филиала
ОтделУстр.В сетиЗдоровье
Бухгалтерия38100%
Торговый зал9694%
Склад5498%
Парк по ОС
Windows 10/11
61%
Astra Linux
27%
РЕД ОС
8%
Альт
4%
Последние действия
Козлов Д. запустил «Очистка временных файлов» на 48 устройствах
Петров С. подключился к SRV-1C-01 без согласия · причина: «обновление 1С»
Смирнов А. назначил Белову А. роль «Техник» · Брянск
Обращение № 128Новое · 3 мин назад9

Не печатает принтер

ИМ
Иванова МарияБухгалтерия · Филиал Брянск · каб. 214 · доб. 2141
С утра не печатает, документы висят в очереди. Перезагружала — не помогло.
Диагностика · собрана автоматически
УстройствоPC-BRY-014 · Windows 11 · 10.2.14.37
ПринтерHP LaserJet M404 — нет связи
Очередь печати3 задания, первое с ошибкой
СетьШлюз и сервер «Штиль» доступны
НагрузкаCPU 12% · ОЗУ 61% · C: 38 ГБ свободно
Похоже на зависшую очередь печати. Скрипт «Сброс очереди печати» решал это 14 раз.10
Взять в работу Сброс очереди Подключиться Ответить
Только просмотр · ответственный ещё не назначен
shtil.romashka.localv0.1.0Агентов в сети: 1 231Роль: Наблюдатель · БрянскСинхронизация 12:0411
  • 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.

Меню в трееФаза 1
Ш
Штиль ПомощникPC-BRY-014 · Иванова М.
Сообщить о проблеме
Мои обращения1 в работе
О программе
Связь с ИТ-отделом есть
RUШ12:04

Пункта «Выход» нет. Иконка показывает состояние связи.

Сообщить о проблемеФаза 1
Сообщить о проблеме
Что случилось?
Не печатаетНет сетиМедленноПрограммаДоступ / ПОДругое
С утра не печатает, документы висят в очереди…
Снимок экрана будет приложенУбрать
ОбычнаяСрочно — работа стоит
каб. 214 · доб. 2141 изменить
Отправить в ИТ-отдел
Сведения о компьютере добавятся автоматически.
Статус обращенияФаза 1
Мои обращения
№ 128 · Не печатает принтерВ работе
Козлов Д., ИТ-отдел: Вижу проблему с очередью печати, исправлю удалённо за пару минут.
№ 97 · Медленно работаетРешено
Написать ответ…
Запрос согласияФаза 2

Показывается Помощником. Решение о показе принимает агент по подписанной политике.

Идёт сеансФаза 2
К вам подключён Козлов Д. · 04:12 ЧатЗавершить

Красная рамка по краю экрана и панель, которую нельзя скрыть. Сотрудник завершает сеанс в любой момент.

Подключение без согласияФаза 2
SRV-1C-01 · Головной офис
Политика «Серверы»: без согласия
Причина подключения *
Код из приложения-аутентификатора
481
Подключиться
Сеанс, причина и все действия записываются в журнал аудита.
→ · Дальше

Следующие шаги и фазы

Краткое описание. Каждый шаг раскрывается подробно, когда закончен предыдущий.

✓ · Журнал решений

Принятые и обсуждаемые решения

Собирается автоматически из полей «Решение» всех задач.

≡ · История документа

Изменения