2.3 Начальные настройки

После успешной установки системы необходимо выполнить первоначальную настройку. Этот раздел описывает последовательность действий, которые необходимо выполнить в первую очередь для запуска системы в работу.

Важно: В этом разделе описаны операции, которые необходимо выполнить после установки. Некоторые настройки можно выполнить через пользовательскую админку (доступ по адресу /settings/), другие требуют доступа к системной админке Django (доступ по адресу /admin/). В описании каждого шага указано, где именно выполняется настройка.

Порядок выполнения первоначальной настройки

Рекомендуется выполнять настройку в следующем порядке:

1. Создание сотрудника
2. Системные настройки
3. Настройка электронной почты
4. Настройка LDAP
5. Настройка Telegram-ботов
6. Настройка Mattermost
7. Настройка шаблонов уведомлений
8. Добавление подразделений
9. Настройка регулярных задач
10. Настройка адреса сайта

1. Создание сотрудника

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

Создание сотрудника через системную админку

Шаги:

1. Войдите в системную админку по адресу https://ваш-домен.ru/admin/
2. Перейдите в раздел «Users» -> «Custom users»
3. Нажмите кнопку «Add custom user» (Добавить пользователя)
4. Заполните обязательные поля:
5. Email - адрес электронной почты (будет использоваться как логин)
6. Password - пароль (будет запрошен дважды для подтверждения)
7. User type - выберите employee (сотрудник)
8. First name - имя сотрудника
9. Last name - фамилия сотрудника
10. Title - должность сотрудника
11. Mobile number - мобильный телефон (рекомендуется)
12. Установите флажки:
13. Is active - обязательно установите, чтобы пользователь мог войти в систему
14. Is staff - установите, если сотруднику нужен доступ к пользовательской админке
15. Is superuser - оставьте снятым, если не требуется полный доступ к системной админке
16. Нажмите кнопку «Save»

Создание записи сотрудника:

После создания пользователя необходимо создать связанную запись сотрудника:

1. Перейдите в раздел «Personal» -> «Employees»
2. Нажмите кнопку «Add employee»
3. Заполните поля:
4. User - выберите созданного пользователя из списка
5. First name - имя (обычно заполняется автоматически)
6. Last name - фамилия (обычно заполняется автоматически)
7. Email - email (обычно заполняется автоматически)
8. Title - должность
9. Status - выберите Working (работает)
10. Manager - выберите руководителя (если есть)
11. Нажмите кнопку «Save»

Примечание: После настройки электронной почты сотрудники могут создаваться через пользовательский интерфейс, и на их email будет автоматически отправляться письмо с логином и паролем.

Подробнее: См. раздел 3. Управление пользователями

2. Системные настройки

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

Настройка основных параметров

Важно: Системные настройки настраиваются через пользовательскую админку /settings/, а не через системную админку Django.

1. Войдите в систему под учетной записью с правами настройки системы
2. Перейдите в раздел "Настройки" (иконка шестеренки в меню) или по адресу /settings/
3. В разделе "Системные настройки" найдите и настройте следующие параметры:

Основные настройки:

• SITE_TITLE - название системы, отображаемое в интерфейсе
• Пример: АСК Легарус
• Тип: String
• DEFAULT_TIMEZONE - часовой пояс по умолчанию для новых пользователей
• Пример: Europe/Moscow
• Тип: String
• Список доступных часовых поясов: Europe/Moscow, Europe/Kiev, Asia/Almaty, UTC и другие
• ALLOWEDFILEEXTENSION - разрешенные расширения файлов для загрузки (через запятую)
• Пример: pdf,doc,docx,xls,xlsx,ppt,pptx,jpg,jpeg,png,gif,zip,rar
• Тип: String
• MAXSIZEFILE - максимальный размер файла для загрузки (в мегабайтах)
• Пример: 150
• Тип: Int
• ITEMS_ON_PAGE - количество записей на странице по умолчанию
• Пример: 25
• Тип: Int
• Для каждой настройки:
• Найдите настройку в списке
• Нажмите на настройку для редактирования
• Измените значение
• Нажмите кнопку "Сохранить"

Настройка логотипа

Логотип организации настраивается через системные настройки:

1. В разделе "Настройки" -> "Системные настройки" найдите настройку "SITE_LOGO" (если доступна)
2. Укажите путь к файлу логотипа или URL изображения
3. Нажмите кнопку "Сохранить"

Примечание: Логотип должен быть размещен в директории /media/ или доступен по URL. Рекомендуемый формат: PNG или SVG, размер не более 200x50 пикселей.

Подробнее: См. раздел 10. Системная панель администратора, раздел 10.2

3. Настройка электронной почты

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

Настройка SMTP-сервера

Важно: Настройка электронной почты выполняется через пользовательскую админку /settings/.

1. Войдите в систему под учетной записью с правами настройки системы
2. Перейдите в раздел "Настройки" (иконка шестеренки в меню) или по адресу /settings/
3. В разделе "Системные настройки" найдите раздел "Настройки электронной почты"
4. Заполните поля:

Основные параметры:

• Host - адрес SMTP-сервера
• Пример: smtp.example.com или smtp.mail.ru
• Для Gmail: smtp.gmail.com
• Для Яндекс: smtp.yandex.ru
• Port - порт SMTP-сервера
• Обычно: 25 (без шифрования), 465 (SSL), 587 (TLS)
• Для Gmail: 587 (TLS) или 465 (SSL)
• Для Яндекс: 465 (SSL) или 587 (TLS)
• Use TLS - установите флажок для использования TLS шифрования
• Рекомендуется: установить для портов 587 и 465
• Username - имя пользователя для авторизации на SMTP-сервере
• Пример: noreply@example.com
• Обычно совпадает с адресом отправителя
• Password - пароль для авторизации на SMTP-сервере
• Для Gmail может потребоваться "Пароль приложения" вместо обычного пароля

Адреса отправителя:

• From email - адрес отправителя для внутренних писем (сотрудникам)
• Пример: noreply@example.com
• From email external - адрес отправителя для внешних писем (клиентам)
• Пример: support@example.com
• Server email - адрес отправителя для системных уведомлений администраторам
• Пример: system@example.com
• Нажмите кнопку "Save"

Тестирование отправки почты

После настройки рекомендуется протестировать отправку:

1. Создайте тестового пользователя
2. Отправьте тестовое уведомление через систему
3. Проверьте получение письма в почтовом ящике

Примечание: Если письма не приходят, проверьте:

• Правильность настроек SMTP
• Наличие письма в папке "Спам"
• Настройки файрвола (должен быть открыт порт SMTP)
• Логи системы на наличие ошибок

Подробнее: См. раздел 7. Интеграции, раздел 7.3

4. Настройка LDAP

Если в вашей организации используется Active Directory или другой LDAP-сервер для управления пользователями, необходимо настроить интеграцию с LDAP.

Настройка LDAP-подключения

Важно: Настройка LDAP выполняется через пользовательскую админку /settings/.

1. Войдите в систему под учетной записью с правами настройки системы
2. Перейдите в раздел "Настройки" (иконка шестеренки в меню) или по адресу /settings/
3. В разделе "Системные настройки" найдите раздел "Настройки LDAP"
4. Заполните поля:

Основные настройки:

• Enabled - установите флажок для включения LDAP-авторизации
• Server URI - адрес LDAP-сервера
• Пример: ldaps://ldap.corp.domain.com:636 (для LDAPS)
• Пример: ldap://ldap.corp.domain.com:389 (для LDAP без шифрования)
• Bind DN - DN пользователя для подключения к LDAP
• Пример: CN=service_user,CN=Users,DC=corp,DC=domain,DC=com
• Bind password - пароль пользователя для подключения
• Ignore cert errors - установите флажок для игнорирования ошибок сертификата (только для тестирования)

Поиск пользователей:

• User search base - базовый DN для поиска пользователей
• Пример: CN=Users,DC=corp,DC=domain,DC=com
• User filterstr - фильтр для поиска пользователей
• Пример: (mail=%(user)s) - поиск по email
• Пример: (userPrincipalName=%(user)s) - поиск по UPN
• User query field - поле для поиска
• Обычно: mail или userPrincipalName

Создание пользователей (опционально):

• User create base - базовый DN для создания пользователей в AD (если требуется)
• UPN - суффикс UPN
• Пример: @domain.local

Настройки групп (опционально):

• Group search base - базовый DN для поиска групп
• Group filter - фильтр для поиска групп
• User flags by group - JSON-маппинг групп на флаги пользователя
• Пример: {"Domain Admins": {"is_staff": true, "is_superuser": true}}
• Нажмите кнопку "Сохранить"

Тестирование подключения

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

1. После сохранения настроек проверьте работу LDAP-авторизации
2. Попробуйте войти в систему используя учетные данные Active Directory
3. Если возникают проблемы, проверьте логи системы на наличие ошибок

Примечание: После включения LDAP пользователи смогут входить в систему используя учетные данные Active Directory. При первом входе пользователя система автоматически создаст учетную запись в системе.

5. Настройка Telegram-ботов

В системе используются два Telegram-бота:

1. Бот для сотрудников - для работы сотрудников с задачами и уведомлениями
2. Бот для клиентов - для работы клиентов с заявками сервис-деска

Создание ботов через BotFather

1. Откройте Telegram и найдите бота @BotFather
2. Отправьте команду /newbot
3. Следуйте инструкциям:
4. Введите название бота (например: "ASK Легарус - Сотрудники")
5. Введите username бота (должен заканчиваться на "bot", например: ask_legarus_employees_bot)
6. Сохраните полученный токен бота (выглядит как 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)
7. Повторите процедуру для создания второго бота (для клиентов)

Настройка ботов в системе

Важно: Токены Telegram-ботов настраиваются через системную админку Django, так как они не доступны через пользовательский интерфейс /settings/.

Бот для сотрудников:

1. Войдите в системную админку по адресу https://ваш-домен.ru/admin/
2. Перейдите в раздел "System" -> "System settings"
3. Найдите настройку "EMPLOYEE_TELEGRAM_BOT_TOKEN"
4. Откройте карточку настройки
5. Введите токен бота для сотрудников в поле "Value"
6. Нажмите кнопку "Save"

Бот для клиентов:

1. В системной админке найдите настройку "TELEGRAM_BOT_TOKEN"
2. Откройте карточку настройки
3. Введите токен бота для клиентов в поле "Value"
4. Нажмите кнопку "Save"

Запуск ботов

Боты запускаются автоматически через supervisor. Для проверки статуса:

# Проверка статуса бота для сотрудников
sudo supervisorctl status telegram_bot_async

# Проверка статуса бота для клиентов
sudo supervisorctl status telegram_bot_support

Примечание: После настройки токенов боты должны автоматически запуститься. Если боты не работают, проверьте логи и настройки supervisor.

6. Настройка Mattermost

Mattermost используется для отправки уведомлений в корпоративный мессенджер.

Создание вебхука в Mattermost

1. В Mattermost перейдите в "Integrations" -> "Incoming Webhooks"
2. Нажмите кнопку "Add Incoming Webhook"
3. Заполните параметры:
4. Title - название вебхука (например, "ASK System")
5. Channel - канал для отправки сообщений
6. Description - описание (опционально)
7. Нажмите кнопку "Create"
8. Скопируйте URL вебхука (выглядит как https://mattermost.example.com/hooks/xxxxxxxxxxxxxxxxxxxxxx)

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

Настройка в системе

Важно: Вебхуки Mattermost настраиваются через системную админку Django, так как они не доступны через пользовательский интерфейс /settings/.

Общий канал Mattermost:

1. Войдите в системную админку по адресу https://ваш-домен.ru/admin/
2. Перейдите в раздел "System" -> "System settings"
3. Найдите настройку "PUBLIC_MM_WEBHOOK"
4. Откройте карточку настройки
5. Введите URL вебхука для общего канала в поле "Value"
6. Нажмите кнопку "Save"
7. Найдите настройку "PUBLIC_MM_ON"
8. Откройте карточку настройки
9. Установите значение "True" в поле "Value"
10. Нажмите кнопку "Save"

Персональные уведомления:

1. В системной админке найдите настройку "PRIVATE_MM_WEBHOOK"
2. Откройте карточку настройки
3. Введите URL вебхука для персональных уведомлений в поле "Value"
4. Нажмите кнопку "Save"
5. Найдите настройку "SEND_PRIVATE_MM_ON"
6. Откройте карточку настройки
7. Установите значение "True" в поле "Value"
8. Нажмите кнопку "Save"

Настройка имени пользователя Mattermost для сотрудника:

Для отправки персональных уведомлений каждому сотруднику необходимо указать его имя пользователя Mattermost:

1. Откройте карточку сотрудника (раздел "Personal" -> "Employees")
2. Найдите поле "Mattermost Username"
3. Введите имя пользователя Mattermost (без символа @)
4. Нажмите кнопку "Save"

7. Настройка шаблонов уведомлений

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

Важно: Шаблоны уведомлений настраиваются через пользовательскую админку /settings/.

Просмотр и редактирование шаблонов

1. Войдите в систему под учетной записью с правами настройки уведомлений
2. Перейдите в раздел "Настройки" (иконка шестеренки в меню) или по адресу /settings/
3. В левом меню выберите "Уведомления" или перейдите по адресу /settings/notify/
4. Найдите нужный шаблон в списке:

Для шаблонов электронной почты:

• Раздел "Шаблоны электронной почты"

Для шаблонов мессенджеров:

• Раздел "Шаблоны мессенджеров"
• Нажмите на шаблон для редактирования
• Измените поля:

Для шаблонов электронной почты:

• Subject - тема письма
• Body - тело письма (поддерживает HTML и переменные)
• Style - стили CSS для оформления письма

Для шаблонов мессенджеров:

• Body - текст сообщения (поддерживает Markdown и переменные)
• Нажмите кнопку "Сохранить"

Примечание: Если шаблоны недоступны через пользовательский интерфейс, их можно настроить через системную админку Django в разделах "System" -> "Email templates" и "System" -> "Messenger templates".

Основные шаблоны для настройки

Электронная почта:

• Шаблон приветствия нового сотрудника
• Шаблон сброса пароля
• Шаблоны уведомлений о заявках
• Шаблоны уведомлений о задачах

Мессенджеры:

• Шаблоны уведомлений в Telegram
• Шаблоны уведомлений в Mattermost

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

Подробнее: См. раздел 5. Шаблоны уведомлений

8. Добавление подразделений

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

Важно: Подразделения можно создавать через пользовательский интерфейс, если у пользователя есть соответствующие права.

Создание подразделений через пользовательский интерфейс

1. Войдите в систему под учетной записью с правами управления персоналом
2. Перейдите в раздел "Персонал" -> "Подразделения"
3. Нажмите кнопку "Создать подразделение" или "Добавить подразделение"
4. Заполните поля:
5. Название - название подразделения
6. Пример: Отдел информационных технологий
7. Родительское подразделение - родительское подразделение (для создания иерархии)
8. Оставьте пустым для корневого подразделения
9. Выберите из списка для создания дочернего подразделения
10. Описание - описание подразделения (опционально)
11. Пример: Отвечает за поддержку IT-инфраструктуры компании
12. Нажмите кнопку "Сохранить"

Создание подразделений через системную админку

Если у вас нет прав доступа через пользовательский интерфейс, подразделения можно создать через системную админку:

1. Войдите в системную админку по адресу https://ваш-домен.ru/admin/
2. Перейдите в раздел "Personal" -> "Organigrams"
3. Нажмите кнопку "Add Organigram"
4. Заполните поля аналогично описанному выше
5. Нажмите кнопку "Save"

Создание иерархии подразделений

Для создания иерархической структуры:

1. Сначала создайте корневые подразделения (без родителя)
2. Затем создайте дочерние подразделения, выбрав родительское в поле "Parent"

Пример структуры:

Организация
├── Отдел информационных технологий
│   ├── Группа поддержки
│   └── Группа разработки
├── Отдел продаж
│   ├── Региональные продажи
│   └── Корпоративные продажи
└── Отдел кадров

9. Настройка регулярных задач

Регулярные задачи (периодические задания) выполняются автоматически по расписанию. Некоторые задачи создаются автоматически при установке, другие необходимо создать вручную.

Важно: Настройка периодических задач выполняется только через системную админку Django, так как эта функция недоступна через пользовательский интерфейс.

Просмотр существующих задач

1. Войдите в системную админку по адресу https://ваш-домен.ru/admin/
2. Перейдите в раздел "Django Celery Beat" -> "Periodic tasks"
3. Вы увидите список всех периодических заданий

Задачи, создаваемые автоматически

Следующие задачи создаются автоматически из файла конфигурации config/settings.py:

• accrue_vacancy_day - начисление дней отпуска (1-е число каждого месяца, 5:00)
• check_stale_client_statuses - проверка статусов клиентов (1-е число каждого месяца, 9:00)
• check-expiring-pages-daily - проверка истекающих страниц базы знаний (каждый день, 8:00)
• remind_employees_to_acknowledge - напоминание сотрудникам о подтверждении документов (каждый день, 9:00)
• notify_manager_about_unacknowledged_documents - уведомление менеджеров о неподтвержденных документах (каждый день, 10:00)
• retrain-classifiers-weekly - переобучение моделей классификации (каждое воскресенье, 4:00)
• check-license-daily - проверка лицензии (каждый день, 3:00)
• check_clients_contracts_validity - проверка действительности договоров клиентов (каждый понедельник, 6:00)
• crm_activity_reminders - напоминания о активностях CRM (каждые 10 минут)
• crm_deal_reminders - напоминания о сделках CRM (каждый день, 8:00)
• crm_deal_actualization - актуализация сделок CRM (каждый день, 10:00)
• crm_deal_no_movement_week - уведомления о сделках без движения неделю (каждый понедельник, 9:00)
• crm_deal_no_movement_month - уведомления о сделках без движения месяц (1-е число каждого месяца, 9:00)
• calculate-kpi-monthly - расчет KPI за месяц (1-е число каждого месяца, 2:00)

Задачи, которые нужно создать вручную

Следующие задачи необходимо создать вручную, если требуется их использование:

1. Проверка входящей почты

Назначение: Автоматическая обработка входящих писем и создание заявок из писем.

Создание задачи:

1. В системной админке в разделе "Django Celery Beat" -> "Periodic tasks" нажмите "Add periodic task"
2. Заполните форму:
3. Name: check_incoming_email
4. Task: servicedesk.tasks.check_incoming_email
5. Crontab: выберите интервал (рекомендуется каждые 5-10 минут)
   • Для создания Crontab: нажмите "Add another Crontab schedule"
   • Minute: */5 (каждые 5 минут) или */10 (каждые 10 минут)
   • Hour: * (каждый час)
   • Day of month: * (каждый день)
   • Month of year: * (каждый месяц)
   • Day of week: * (каждый день недели)
6. Enabled: установите флажок
7. Нажмите кнопку "Save"

2. Отправка уведомлений о заявках

Назначение: Отправка пользовательских уведомлений о заявках.

Создание задачи:

1. Нажмите "Add periodic task"
2. Заполните форму:
3. Name: send_request_custom_notify
4. Task: servicedesk.tasks.send_request_custom_notify
5. Crontab: каждые 5-10 минут (аналогично предыдущей задаче)
6. Enabled: установите флажок
7. Нажмите кнопку "Save"

3. Отправка тревожных уведомлений

Назначение: Отправка тревожных уведомлений о критических заявках.

Создание задачи:

1. Нажмите "Add periodic task"
2. Заполните форму:
3. Name: send_request_alarm_notify
4. Task: servicedesk.tasks.send_request_alarm_notify
5. Crontab: каждые 5-10 минут
6. Enabled: установите флажок
7. Нажмите кнопку "Save"

4. Ежедневный список заявок

Назначение: Отправка ежедневного сводного списка заявок сотрудникам.

Создание задачи:

1. Нажмите "Add periodic task"
2. Заполните форму:
3. Name: daily_requests_list
4. Task: servicedesk.tasks.daily_requests_list
5. Crontab: каждый день в определенное время (например, в 9:00)
   • Minute: 0
   • Hour: 9
   • Day of month: *
   • Month of year: *
   • Day of week: *
6. Enabled: установите флажок
7. Нажмите кнопку "Save"

5. Ежедневный список задач

Назначение: Отправка ежедневного сводного списка задач сотрудникам.

Создание задачи:

1. Нажмите "Add periodic task"
2. Заполните форму:
3. Name: daily_task_list
4. Task: tasks.tasks.daily_task_list
5. Crontab: каждый день в определенное время (например, в 9:00)
   • Minute: 0
   • Hour: 9
   • Day of month: *
   • Month of year: *
   • Day of week: *
6. Enabled: установите флажок
7. Нажмите кнопку "Save"

Проверка работы задач

После создания задач проверьте их работу:

1. Убедитесь, что Celery Beat запущен:

bash sudo supervisorctl status celerybeat

1. Проверьте логи Celery Beat:

bash tail -f /var/log/celery/beat.log

1. Проверьте логи Celery Worker:

bash tail -f /var/log/celery/worker.log

Примечание: Задачи начнут выполняться согласно расписанию после сохранения. Для немедленной проверки можно запустить задачу вручную через Django shell.

10. Настройка адреса сайта

Настройка адреса сайта необходима для корректной генерации ссылок в уведомлениях и письмах.

Важно: Настройка адреса сайта выполняется только через системную админку Django, так как эта функция недоступна через пользовательский интерфейс.

Настройка через Django Sites

1. Войдите в системную админку по адресу https://ваш-домен.ru/admin/
2. Перейдите в раздел "Sites" -> "Sites"
3. Добавьте запись сайта (с ID=2)
4. Измените поля:
5. Domain name: введите доменное имя вашего сайта
6. Пример: ask.example.com или ask.example.ru
7. Важно: Не указывайте протокол (http:// или https://) и путь (/)
8. Указывайте только доменное имя и порт (если не стандартный)
9. Display name: введите отображаемое название сайта
10. Пример: АСК Легарус или Система управления компанией
11. Нажмите кнопку "Save"

Примечание: Значение SITE_ID в файле config/settings.py должно соответствовать ID записи сайта в базе данных. По умолчанию используется SITE_ID = 2.

Проверка настройки

После настройки проверьте:

1. Откройте любой шаблон уведомления
2. Убедитесь, что ссылки генерируются с правильным доменом
3. Отправьте тестовое уведомление и проверьте ссылки в письме

Проверка завершения настройки

После выполнения всех шагов рекомендуется проверить:

1. Вход в систему: Убедитесь, что созданные сотрудники могут войти в систему
2. Отправка почты: Отправьте тестовое уведомление и проверьте получение письма
3. Работа ботов: Проверьте, что Telegram-боты отвечают на команды
4. Уведомления в Mattermost: Проверьте отправку уведомлений в Mattermost
5. Работа периодических задач: Проверьте логи Celery Beat на наличие ошибок
6. Генерация ссылок: Проверьте, что ссылки в уведомлениях ведут на правильный домен