BELLATRIX — Инструкция пользователя

Версия: 2.0 / 31.08.2026

Содержание
  1. Вход в систему
  2. Главная страница
  3. Базы данных (контакты)
  4. Карточка контакта и комментарии
  5. WhatsApp-рассылки
  6. SMS-рассылки
  7. Администрирование (только админы)
  8. Лог активности (только админы)
  9. Импорт и экспорт CSV
  10. Частые вопросы

1. Вход в систему

Адрес: http://bellatrix.local (или ваш домен)

Что нужно:
  • Логин — ваш номер телефона (только цифры, например 79281234567)
  • Пароль — выдаётся администратором
Как войти:
  1. Откройте сайт
  2. Введите номер телефона
  3. Введите пароль
  4. Нажмите «Войти»
Если забыли пароль — обратитесь к администратору. Самостоятельное восстановление пароля недоступно.

2. Главная страница

После входа вы видите:

  • Сколько баз вам доступно
  • Сколько всего контактов в этих базах
  • Ваше имя и статус (Администратор / Модератор / Логист / Пользователь)
  • Быстрые ссылки: WhatsApp, SMS, Комментарии
  • Список доступных баз — нажмите на любую, чтобы открыть

Слева — боковое меню со списком ваших баз. Нажмите на базу — откроются её записи.

3. Базы данных (контакты)

Каждая база — это список контактов (сельхозпроизводителей, трейдеров, переработчиков).

3.1. Просмотр записей

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

  • Таблицу с записями (на компьютере)
  • Карточки с записями (на телефоне)

В каждой строке таблицы:

  • ID — номер записи
  • Наименование — название организации
  • Руководитель — ФИО контактного лица
  • Телефон — номер (замаскирован: 7903*****33)
  • Район — регион/район
  • Кнопки: 📞 позвонить, 💬 WhatsApp, ✉ SMS, 📋 карточка

3.2. Поиск

Введите текст в поле «Поиск» и нажмите «Поиск». Ищет по названию, руководителю, телефону, описанию.

3.3. Фильтр по региону

Выберите район из выпадающего списка и нажмите «Применить» — покажутся только записи из этого района.

3.4. Пагинация

Если записей много — внизу страницы будет нумерация страниц. Нажмите на номер страницы, чтобы перейти.

4. Карточка контакта и комментарии

Нажмите на кнопку 📋 (или на строку таблицы) — откроется карточка контакта.

4.1. Что в карточке

  • Все данные контакта
  • Кнопки: 📞 Позвонить, 💬 WhatsApp, ✉ SMS
  • Форма добавления комментария
  • История комментариев

4.2. Как добавить комментарий

Заполните поля:

  • Культура (пшеница, ячмень, кукуруза, подсолнечник и т.д.)
  • Качество (например: «12,5/760», «4 класс»)
  • Протеин, Натура, Сор — показатели качества
  • Объём (сколько тонн предлагает/ищет)
  • Цена (предложение/спрос)
  • Адрес (местонахождение)
  • Статус (Продает / Перезвонить / Продал / Не работает)
  • Дата перезвона (на когда назначить)
  • Комментарий (произвольный текст)

Нажмите «Сохранить» — комментарий появится в истории.

Комментарий привязан к конкретному контакту. Все пользователи с доступом к базе видят комментарии.

5. WhatsApp-рассылки

5.1. Отправка сообщения

  1. Перейдите в раздел WhatsApp
  2. Выберите базу из выпадающего списка
  3. Выберите регион (или оставьте «Все регионы»)
  4. Напишите текст сообщения
  5. Нажмите «Запустить рассылку»

После нажатия:

  • Первые 20 сообщений отправляются сразу
  • Остальные ставятся в очередь и отправляются по одному с паузой (анти-бан)
  • Результат: «Рассылка #N: 20 отправлено, 0 ошибок. Всего: 300»

5.2. Авторизация WhatsApp

Если инстанс не авторизован — на странице WhatsApp появится QR-код.

Отсканируйте его в WhatsApp: Настройки → WhatsApp Web → Сканировать код.

5.3. Активные задачи

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

  • Пауза — приостановить отправку
  • Продолжить — возобновить
  • Отменить — отменить рассылку
  • Детали — посмотреть, какие сообщения отправлены, какие с ошибкой

5.4. Ограничения (анти-бан)

  • Пауза 5 секунд между сообщениями
  • Автопауза после 3 ошибок подряд
  • При ошибке или бане отправка приостанавливается
Это защищает ваш номер от блокировки WhatsApp.

6. SMS-рассылки

  1. Перейдите в раздел SMS
  2. Введите номер телефона
  3. Напишите текст
  4. Нажмите «Отправить»

7. Администрирование (только для админов)

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

7.1. Управление пользователями

Где: Пользователи (в меню)

Что можно делать:

  • Создать пользователя: ФИО, телефон, пароль, статус, доступ к базам
  • Редактировать пользователя: изменить ФИО, статус, доступ к базам, сменить пароль
  • Удалить пользователя: с подтверждением
Важно: При смене пароля или статуса все токены пользователя сбрасываются — нужно заново войти в систему.
Доступ к базам:
  • Выберите базы через чекбоксы (галочки)
  • Можно выбрать несколько баз
  • Базы, отмеченные галочкой — пользователь видит и может работать

7.2. Редактор баз

Где: Редактор баз (в меню)

Что можно делать:

  • Создать новую базу — задать slug, русское имя, поле региона
  • Редактировать название базы (кнопка ✏)
  • Удалить базу — полностью удаляет таблицу и все записи (необратимо!)
Удаление базы необратимо! Все записи будут потеряны.

8. Лог активности (только для админов)

Где: Лог (в меню)

Что это: Полная запись всех действий всех пользователей.

Что логируется:

  • Кто и когда заходил в систему
  • Какие карточки просматривал
  • Какие комментарии добавлял
  • Какие рассылки запускал
  • Какие импорты/экспорты делал
  • IP-адрес, с которого работал
Для чего это нужно: Контроль работы менеджеров. Просмотр, кто что делал и когда. Доказательная база при спорных ситуациях.

9. Импорт и экспорт CSV

Доступно только Модераторам и Администраторам.

Формат CSV

  • Разделитель: ; или ,
  • Первая строка: заголовки (названия столбцов)
  • Кодировка: UTF-8
Пример файла:
urlico;name;desc;tel;region
ООО Агро-Альянс;Чалый Николай;пшеница,подсолнечник;79186677555;Абинский район
ООО Степное;Валуева Светлана;пшеница,ячмень;79181827544;Анапский район

Проверка дублей

При импорте система проверяет телефон. Если такой номер уже есть в базе — запись не добавляется, а попадает в таблицу дублей.

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

Вопрос: Не могу войти в систему
Ответ: Проверьте номер телефона (только цифры, начинается с 7) и пароль. Если не помогло — обратитесь к администратору.
Вопрос: Не вижу базу, которая должна быть
Ответ: Напишите администратору — он добавит вам доступ к этой базе.
Вопрос: Нажал «Запустить рассылку», но сообщения не уходят
Ответ: Проверьте статус инстанса WhatsApp на странице рассылки. Если статус не «authorized» — отсканируйте QR-код.
Вопрос: Сколько сообщений можно отправить за раз?
Ответ: Первые 20 отправляются сразу. Остальные — по одному с паузой 5 секунд. Это защищает номер от бана.
Вопрос: Можно ли отменить рассылку?
Ответ: Да. На странице WhatsApp нажмите «Отменить» у нужной задачи.
Вопрос: Кто может добавлять/удалять записи в базах?
Ответ: Только администратор. Обычные пользователи только просматривают и комментируют.
Вопрос: Где посмотреть, что делали менеджеры?
Ответ: В разделе «Лог» (только для администраторов). Там видно все действия: кто, когда, что делал и с какого IP.
Вопрос: Я не могу удалить или изменить запись в базе
Ответ: Это нормально. Создание, редактирование и удаление записей — только для администраторов.

Статусы пользователей

СтатусПрава
User (Пользователь)Просмотр баз, карточек, комментариев
Logist (Логист)Всё что User + WhatsApp/SMS рассылки
Moderator (Модератор)Всё что Logist + импорт/экспорт CSV
Admin (Администратор)Полный доступ: управление пользователями, базами, удаление, лог

По всем вопросам: администратор системы (dante161@yandex.ru)

BELLATRIX v2.0 — 2026