Администратор УК

Администратор управляющей компании настраивает организацию в админ-панели: справочники домов и лицевых счетов, пользователей и роли, категории заявок, SLA-политики, импорт данных и аудит. Кабинет открывается по адресу /admin после входа.

Разделы

Раздел	Путь	Что здесь
Рабочий стол	/admin	Сводка и чеклист внедрения: чего не хватает (дома, ЛС, пользователи, категории, SLA)
Дома	/admin/houses	Реестр многоквартирных домов
Помещения	/admin/premises	Квартиры и помещения по домам
Лицевые счета	/admin/accounts	ЛС жителей (как в квитанции)
Пользователи	/admin/users	Сотрудники и жители, роли
Категории	/admin/categories	Виды заявок и обращений
SLA-политики	/admin/sla	Сроки реакции и решения
Импорт	/admin/import	Загрузка CSV/XLSX
Аудит	/admin/audit	Журнал действий пользователей
Настройки	/admin/settings	Профиль УК, режим обслуживания, приёмка работ
API-ключи / Webhooks	/admin/api-keys, /admin/webhooks	Интеграции партнёров
ГИС ЖКХ	/admin/gis	Очередь синхронизации
Настройки AI	/admin/ai	Провайдеры и подсказки категории
FAQ для MAX	/admin/faq	Утверждённые ответы бота жителям
Ответы MAX	/admin/max-replies	Шаблоны быстрых ответов бота
Документация	/docs	Внутренние гайды

Порядок внедрения УК

1. Справочники: дома → помещения → лицевые счета (вручную или через импорт).
2. Пользователи: диспетчер, исполнители, руководитель, администратор. Роли выдаются при создании пользователя.
3. Категории и SLA: категории аварий - с короткими сроками.
4. Жители: сообщите жителям номера лицевых счетов для самостоятельной регистрации - см. Заведение жителей.
5. Ежедневно: аудит при спорах, поддержка пользователей, контроль чеклиста на рабочем столе.

Справочники: дома, помещения, лицевые счета

Порядок обязателен: сначала дом, затем помещения, затем лицевые счета.

• Дом: адрес (удобно вводить через подсказки - система сверяется с адресным справочником).
• Помещение: выберите дом, укажите номер квартиры, при необходимости подъезд и этаж.
• Лицевой счёт: выберите дом и помещение, введите номер точно как в квитанции - по нему житель будет регистрироваться.

Пользователи и роли

Создание: Пользователи → создать - email, ФИО, телефон (обязателен), роль.

Роль	Кому выдавать
Житель (RESIDENT)	Жителям, если создаёте учётки за них
Диспетчер (DISPATCHER)	Сотрудникам на очереди
Исполнитель (EXECUTOR)	Мастерам на объектах
Руководитель (SUPERVISOR)	Руководящему составу
Администратор УК (ORG_ADMIN)	Административному персоналу

Система показывает временный пароль один раз - передайте его сотруднику лично, не в общий чат. При первом входе сотрудник сменит пароль.

предупреждение

Телефон обязателен для пользователей - по нему работает привязка мессенджера MAX. Не выдавайте административные роли без необходимости.

Категории и SLA-политики

• Категории - виды заявок (сантехника, электрика, лифт, аварийные и т.д.). Аварийные категории настраивайте с короткими SLA - они формируют приоритетную очередь.
• SLA-политики - сроки реакции и решения. Политики сверяются с нормативными требованиями: политика мягче нормативного предела не сохранится - система вернёт ошибку. SLA влияет на подсветку просрочек в очереди и уведомления руководителя.

Импорт данных

Раздел Импорт: загрузка CSV или XLSX. Всегда: сначала предпросмотр (preview), потом импорт.

• Кодировка: UTF-8. Разделитель: ; (безопасно при запятых в адресах).
• Рекомендуемый тип REGISTRY - одним файлом создаёт дома (если нет), помещения и лицевые счета. Колонки: house_address;premise_number;account_number (обязательные), плюс необязательные premise_type;entrance;floor;fias_id;lat;lng.
• Пошаговый вариант: HOUSES → PREMISES → ACCOUNTS - строго в этом порядке, адреса должны совпадать с уже загруженными.
• USERS - массовое создание учёток (email, ФИО, телефон, роль); не заменяет импорт лицевых счетов.
• Шаблоны файлов скачиваются на странице импорта.

Аудит

Аудит - журнал действий: кто, когда и что менял. Используйте при спорах и разборе инцидентов. Записи не удаляются.

Настройки

• Профиль УК - название и контакты организации.
• Режим обслуживания - баннер и запрет создания заявок для жителей и диспетчеров на время техработ. Не забудьте выключить после работ.
• Приёмка работ жителем - напоминание жителю (по умолчанию 48 часов; 0 = выключено) и автозакрытие в сутках (по умолчанию 0 = выключено). Заявку автоматически не закрывает ни AI, ни сбой фоновых задач - только настроенное правило или человек.

Интеграции

• API-ключи и Webhooks - партнёрские интеграции. Секрет ключа показывается один раз; ротация отключает старый ключ. Документация для разработчиков - в разделе «Для разработчиков» кабинета.
• ГИС ЖКХ - экран очереди синхронизации; промышленный контур подключает оператор платформы.
• Настройки AI - провайдеры автоматической классификации заявок. AI только подсказывает категорию; решение принимает диспетчер. Персональные данные в AI не передаются.
• FAQ для MAX / Ответы MAX - утверждённые ответы бота жителям: контакты, часы работы, типовые вопросы. Ответ берётся из утверждённой записи, а не из свободной формулировки.

Типичные ситуации

Ситуация	Что делать
Импорт не принимается	Проверьте кодировку UTF-8, разделитель ;, обязательные колонки, порядок шагов (дома раньше помещений)
Житель не может зарегистрироваться	Проверьте, что лицевой счёт заведён и введён как в квитанции
Сотрудник «не тот кабинет»	Проверьте роль и email в «Пользователях»
Нет исполнителей при назначении	Создайте пользователя с ролью «Исполнитель»
Диспетчер просит права на дома	Дома - зона администратора УК; просмотрите аудит, если нужна проверка