Документация

Руководство по работе с системой SAM

Быстрый старт

  1. Войдите в систему по ссылке /auth/login
  2. Суперадмин создаёт подразделения, пользователей и рабочие станции
  3. IT-администратор добавляет ПО в реестр и привязывает лицензии
  4. Сотрудник подаёт заявку — указывает ПО, рабочую станцию, обоснование
  5. Руководитель согласует; IT-администратор берёт в работу и выполняет
Тестовый аккаунт: admin / Admin123 — суперадмин с полным доступом.

Роли пользователей

Права доступа определяются ролью — она назначается суперадмином при создании аккаунта.

РольЗаявкиПО / ЛицензииИнвентаризацияОтчётыПользователи
Сотрудник Только своиПросмотр
Руководитель Все + согласованиеПросмотрПросмотр
IT-администратор Все + выполнениеПолный CRUDПолный CRUD
Суперадмин ВсеПолный CRUDПолный CRUD

Управление заявками

Создать заявку (Сотрудник)
  1. Меню → Заявки → кнопка «Новая заявка»
  2. Выбрать ПО из реестра
  3. Указать действие: Установить или Удалить
  4. Выбрать рабочую станцию (подставляется автоматически если назначена)
  5. Указать приоритет и обоснование
  6. «Сохранить черновик» — заявка не отправляется
    «Отправить на согласование» — заявка уходит руководителю
При отправке система проверяет наличие свободных мест в лицензии. Если мест нет — заявка создаётся, но появится предупреждение.
Согласовать заявку (Руководитель)
  1. Открыть заявку из списка
  2. Прочитать детали и написать комментарий (необязательно)
  3. Нажать «Одобрить» или «Отклонить»
Доступны массовые действия — отметить несколько заявок чекбоксами и применить статус сразу ко всем.
Выполнить заявку (IT-администратор)
  1. Открыть одобренную заявку
  2. Нажать «Взять в работу» — статус станет «В работе»
  3. Физически установить ПО на указанную рабочую станцию
  4. Нажать «Выполнена» — заявитель получит email
Обсуждение

На странице каждой незакрытой заявки есть блок «Обсуждение» — любой участник может оставить вопрос или комментарий без изменения статуса.

Статусы заявки

Черновик
Ожидает
Одобрена
В работе
Выполнена

Из любого незавершённого статуса возможен переход в «Отклонена» или «Отозвана».

СтатусКто устанавливаетОписание
ЧерновикСотрудникСоздана, не отправлена на согласование
ОжидаетСотрудникОтправлена руководителю на согласование
ОдобренаРуководитель / ITСогласована, готова к выполнению
В работеIT-администраторПринята IT в работу
ВыполненаIT-администраторПО установлено/удалено
ОтклоненаРуководитель / ITЗаявка отклонена с комментарием
ОтозванаСотрудник / ITЗаявка отозвана инициатором

Реестр программного обеспечения

Справочник всего ПО организации. Прежде чем добавить лицензию или подать заявку — ПО должно быть в этом реестре.

  • Просмотр — доступен всем авторизованным пользователям
  • Добавление / редактирование / удаление — только IT-администратор и Суперадмин
  • Удаление невозможно если у ПО есть привязанные лицензии
  • На карточке ПО есть кнопка «Добавить лицензию» — ПО будет предвыбрано автоматически
  • Поиск по названию и производителю прямо в списке

Реестр лицензий

Учёт всех лицензий с контролем мест и сроков действия.

Добавить лицензию
  1. Открыть ПО → кнопка «Добавить лицензию»
    или: Лицензии → «Добавить»
  2. Указать тип: Бессрочная или Подписка
  3. Количество мест, даты, стоимость
Индикатор заполненности
До 90%
90–99%
100%
Celery автоматически отправляет email IT-администраторам за 30 и 7 дней до истечения лицензии.

Инвентаризация

Раздел доступен Руководителям, IT-администраторам и Суперадминам.

  • Список станций — статус (Онлайн / Давно / Неактивна), IP, ОС
  • Карточка станции — весь список установленного ПО с поиском, привязанные пользователи
  • Расхождения план/факт — несогласованное ПО, превышение лимитов, неиспользуемые лицензии
СтатусУсловие
🟢 ОнлайнСнимок получен менее 25 часов назад
🟡 ДавноСнимок от 25 до 72 часов назад
🔴 НеактивнаСнимок старше 72 часов
⚫ Нет данныхАгент ни разу не отправлял данные

Рабочие станции

Добавить станцию (IT-администратор)
  1. Инвентаризация → «Добавить станцию»
  2. Ввести hostname (должен совпадать с реальным именем компьютера)
  3. Выбрать ОС и подразделение
  4. После создания появится баннер с токеном агента и командой запуска — скопировать его
Привязать пользователя к станции
  1. Пользователи → кнопка 🖥️ напротив пользователя
  2. Выбрать станцию → «Сохранить»
  3. При создании заявки станция подставится автоматически

Агент инвентаризации

Python-скрипт для установки на рабочие станции. Запускается раз в сутки и отправляет список ПО на сервер.

Требования
  • Python 3.8+ (python --version)
  • Библиотека requests (pip install requests)
Запуск
python agent.py --server https://sam.loxigl.ru --token <TOKEN>
Проверка без отправки
python agent.py --server https://sam.loxigl.ru --token <TOKEN> --dry-run
Автозапуск — Windows (Task Scheduler)
python C:\sam\agent.py --server https://sam.loxigl.ru --token <TOKEN>

Запускать ежедневно в 09:00 через Планировщик заданий Windows.

Автозапуск — Linux (cron)
0 9 * * * python3 /opt/sam/agent.py --server https://sam.loxigl.ru --token <TOKEN>

Отчёты и экспорт

Доступны Руководителям, IT-администраторам и Суперадминам.

РазделОписание
ComplianceСводка лицензионного соответствия: нарушения, расхождения
ЗатратыСтоимость лицензий с фильтрацией по периоду
Экспорт ExcelСкачать реестр лицензий в формате .xlsx
Экспорт PDFСкачать форматированный отчёт в формате .pdf

Администрирование

Раздел доступен только Суперадмину.

  • Создать пользователя — указать логин, email, пароль, роль, подразделение, станцию
  • Заблокировать — кнопка «Откл.» — пользователь не сможет войти
  • Назначить станцию — кнопка 🖥️ в строке пользователя
  • Управление подразделениями — создать отделы до добавления пользователей
  • Журнал аудита — все действия в системе с фильтрацией по типу и исполнителю

Email-уведомления

Система отправляет email в следующих случаях:

СобытиеКому
Смена статуса заявкиЗаявителю (если не он изменил)
Лицензия истекает через 30 днейВсем IT-администраторам
Лицензия истекает через 7 днейВсем IT-администраторам
Обнаружены расхождения план/фактВсем IT-администраторам
Для проверки отправки email доступен тестовый почтовый ящик: mail.loxigl.ru — все письма видны там без реальной доставки.

Частые вопросы

Убедитесь что вводите логин и пароль точно как при создании аккаунта. Тестовый аккаунт: admin / Admin123. Обратитесь к суперадмину для сброса пароля.

Кнопки отображаются только для роли, которой разрешено действие в текущем статусе. Руководитель видит «Одобрить» только у заявок в статусе «Ожидает согласования».

Убедитесь что hostname на рабочей станции совпадает с hostname, указанным при создании станции в системе. Команда для проверки: hostname в терминале.

ПО добавляется в разделе «Реестр ПО» — нажать «Добавить ПО». Это может делать IT-администратор или Суперадмин. После добавления ПО появится в выпадающем списке при создании заявки.

Проверьте настройки SMTP в конфигурации системы. На тестовом стенде все письма перехватываются сендбоксом на mail.loxigl.ru — реальная доставка не происходит.