Первичная настройка кабинета администратором

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

Кто выполняет. Администратор (роль Admin).

Что нужно до начала.

1. Адрес кабинета и учётная запись с ролью Admin.
2. Доступ к Keycloak (системе входа), чтобы создавать учётные записи сотрудников.
3. Список сотрудников с email, ролями и проектами.
4. Данные почтового сервера (SMTP) и/или токен Telegram-бота, если нужны уведомления.

Время. 2–3 часа.

Порядок настройки

Выполняйте шаги по порядку: каждый следующий опирается на предыдущий.

№	Шаг	Экран	Подробный процесс
1	Проверить свой доступ	Меню «Админ»	Этот документ
2	Настроить роли	Роли	Пользователи и роли
3	Добавить пользователей	Пользователи	Пользователи и роли
4	Проверить справочники	Типы работ, Типы задач	Этот документ
5	Настроить воркфлоу	Воркфлоу	Настройка воркфлоу
6	Добавить поля	Конструктор полей	Дополнительные поля
7	Подключить транспорты уведомлений	Транспорты	Настройка уведомлений
8	Задать RACI	RACI уведомлений	Этот документ
9	Заполнить производственный календарь	Ресурсы. Календарь	Этот документ
10	Создать первый проект	Проекты	Создание проекта

Шаг 1. Проверьте свой доступ

1. Войдите в кабинет и убедитесь, что в меню есть группа Админ: Воркфлоу, Типы задач, Типы работ, Пользователи, Конструктор полей, Подписи (словарь), Роли, Журнал аудита, Сессии, Транспорты уведомлений, RACI уведомлений.
2. Если каких-то пунктов нет, проверьте роль в «Пользователях»: ваша роль должна быть Admin.

Шаг 2. Роли

Роли поставляются предустановленные: Admin, Manager, Developer. Проверьте права каждой и при необходимости создайте новые. Подробно: «Пользователи и роли».

Шаг 3. Пользователи

Создайте учётные записи в Keycloak, затем карточки в Assist с теми же email. Подробно: «Пользователи и роли».

Шаг 4. Справочники

1. Откройте Админ → Типы работ. Стандартный набор: «Общее», «Разработка», «Дизайн», «Ревью», «Встречи», «Поддержка». Добавьте недостающие, например «Аналитика». Сотрудники выбирают их при записи времени.
2. Откройте Админ → Типы задач. Предустановлены Bug и Default. Добавьте типы, нужные вашему процессу. Каждый новый тип получает собственный воркфлоу.

Шаг 5. Воркфлоу

Проверьте, подходят ли поставляемые процессы компании: «Настройка воркфлоу». Системные воркфлоу клонируйте и правьте копию.

Шаг 6. Поля

Если нужны собственные поля (например, «Номер договора» у проекта), создайте их: «Дополнительные поля».

Шаг 7. Транспорты уведомлений

1. Откройте Админ → Транспорты уведомлений.
2. Нажмите Добавить системный транспорт, выберите канал (Email, Telegram, Element, Web Push) и заполните параметры.
3. Нажмите Проверить: кабинет подтвердит работоспособность.
4. Включите переключатель Доступен пользователям.

Секреты после сохранения не показываются.

Шаг 8. RACI уведомлений

1. Откройте Админ → RACI уведомлений.
2. В списках Ответственные за результат (A), Консультанты (C) и Информируемые (I) выберите людей. Исполнитель (R) определяется из задачи.
3. Изменения сохраняются автоматически.

Для отдельных проектов правила переопределяются на вкладке «Настройки» проекта.

Шаг 9. Производственный календарь

Откройте Ресурсы → Календарь и отметьте на год рабочие, сокращённые, выходные и праздничные дни. Календарь используется в планировании ресурсов и при расчёте нормы: «Ресурсы. Календарь».

Шаг 10. Первый проект

Создайте пилотный проект и проверьте весь путь: задача, часы, релиз. Подробно: «Создание проекта».

Как проверить результат

• Каждый сотрудник может войти и видит нужные пункты меню.
• Уведомление о назначении приходит в выбранный канал.
• В пилотном проекте задача проходит стадии, часы записываются.

Типичные ошибки

Ситуация	Причина	Решение
Сотрудник входит, но видит мало	Роль по умолчанию слишком узкая	Назначьте роль в списке пользователей
Email в Assist и Keycloak различаются	Привязка идёт по email	Исправьте email в карточке
Транспорт не проходит проверку	Неверные параметры	Прочитайте текст ошибки проверки, исправьте

Что дальше

• Пользователи и роли.
• Настройка воркфлоу.