Граф Wiki
Документация / Установка и интеграция

Установка и интеграция СмИТ Биллинг v1.6.0

Пошаговое руководство по внедрению системы СмИТ Биллинг 1.6 для операторов связи и сервис-провайдеров.

Содержание страницы

Этап 1. Системные требования

Для развёртывания СмИТ Биллинг v1.6.0 требуется сервер с поддержкой Docker:

КомпонентМинимумРекомендуется
CPU2 ядра4+ ядра
RAM4 ГБ8+ ГБ
Диск40 ГБ SSD100+ ГБ SSD/NVMe
ОСLinux (Ubuntu 22.04 / Debian 12 / CentOS 9)Ubuntu 22.04 LTS
Docker24.0+Последняя стабильная
Docker Compose2.20+Последняя стабильная
Виртуальные машины (KVM, VMware, Hyper-V) полностью поддерживаются. Если необходимо хранить статистику для СОРМ (netflow, sflow), выделите отдельный диск большого объёма.

Этап 2. Установка через Docker Compose

Развёртывание системы выполняется через Docker Compose:

# 1. Клонировать репозиторий
git clone <repository-url> smit-billing
cd smit-billing

# 2. Скопировать шаблон переменных окружения
cp .env.docker .env

# 3. Отредактировать настройки (.env)
# DB_NAME, DB_USER, DB_PASSWORD, REDIS_URL, SECRET_KEY

# 4. Запустить все сервисы
docker compose up -d

# 5. Применить миграции и создать суперпользователя
docker compose exec web python manage.py migrate
docker compose exec web python manage.py createsuperuser

# 6. Собрать статические файлы
docker compose exec web python manage.py collectstatic --noinput

После запуска веб-интерфейс доступен по адресу http://<ip-сервера>.

Сервисы Docker Compose: db (PostgreSQL 16), redis (Redis 7), web (Django/Gunicorn), celery, celery-beat, freeradius, nginx.

Этап 3. Удаление демо-данных

Удалите демонстрационные тарифы и абонентов через веб-интерфейс (Настройки → Очистка базы данных) или через Django management-команду:

docker compose exec web python manage.py flush --no-input
docker compose exec web python manage.py loaddata initial_data

Этап 4. Интеграция с оборудованием

Содержание раздела

Интернет

Интегрируйте интернет-маршрутизаторы и оборудование NAS, следуя разделу документации по интеграции интернет-оборудования. Доступны руководства быстрой интеграции, включая настройку MikroTik.

Телефония

Типовой план внедрения VoIP:

  1. Настройте оборудование: сервисы, политики, профили, номера пользователей
  2. Настройте передачу CDR в СмИТ Биллинг через IP/порт, RADIUS или FTP
  3. Создайте VoIP NAS с IP-адресом АТС
  4. Настройте услуги телефонии
  5. Настройте пулы телефонных номеров
  6. Назначьте услуги и номера абонентам
  7. Протестируйте: звонки с положительным балансом, недостаточный баланс, отключение абонента во время звонка, корректность тарификации

IPTV

Трёхэтапный процесс:

  1. Настройка оборудования по выбранной схеме
  2. Настройка конкретного сервиса (IPTVPortal, Infomir Ministra, LifeStream, Megogo, TITV, NextTV, 24hTV, MOOVI)
  3. Настройка услуги IPTV в биллинге

Этап 5. Настройка тарифов

Подробная документация по тарифам и услугам — в основном руководстве

Создайте тарифы для интернета, телефонии (местная/междугородняя/международная связь) и телевидения. Полное описание раздела «Тарификация» (создание тарифов, услуги, линейки, программы лояльности, RADIUS-параметры тарифа, шейпер):

Открыть раздел «Тарификация» Создание тарифа Услуги Список тарифов (UX)

Этап 6. Добавление абонентов

Подробная документация по абонентам — в основном руководстве

Создайте абонентские аккаунты, заполните персональные данные и внесите средства на баланс. Полное описание работы с абонентами (карточка, контакты, договор, баланс, точка подключения, СОРМ-данные, юр.лица, импорт CSV):

Открыть раздел «Абоненты» Создание абонента Карточка абонента

Этап 7. Финальное тестирование

Содержание раздела

Перед вводом в эксплуатацию пройдите полный цикл на одном-двух тестовых абонентах. Это проверит, что все компоненты (биллинг, RADIUS, NAS, платёжный шлюз, ЛК) корректно связаны.

Чек-лист приёмки

  1. Тестовый абонент — создайте абонента (см. Создание абонента), назначьте тариф, привяжите учётную запись (login/password) и точку подключения.
  2. RADIUS-авторизация — выполните radtest <login> <password> 127.0.0.1 0 testing123 внутри контейнера freeradius. Ответ должен быть Access-Accept с корректным Framed-IP-Address и Mikrotik-Rate-Limit. Альтернатива — кнопка «Тест авторизации» (🧪) в карточке учётной записи (подробнее).
  3. Платёж — пополните баланс через тестовый шлюз (YooKassa тестовый магазин или ручной приход через /admin/Abonents/finance/). Убедитесь, что FinanceOperations создалась и баланс обновился.
  4. Блокировка по балансу — выставьте абоненту отрицательный баланс или активируйте флаг b_admin. Проверьте, что в RADIUS приходит Access-Reject и сессия завершается через CoA-Disconnect.
  5. Разблокировка — пополните баланс или снимите блок. Через 1–2 минуты RADIUS должен снова отвечать Access-Accept, абонент получит интернет.
  6. Личный кабинет — войдите в ЛК (/lk/) под тестовым абонентом, убедитесь, что отображаются баланс, тариф, история операций. См. документацию ЛК.
  7. Отчёты — откройте /admin/reports/dashboard/ и проверьте, что новый абонент попал в KPI «Активные», а его платёж — в «Финансовая динамика». Запустите SQL-отчёт «Активные абоненты» из конструктора отчётов.
  8. FreeScout / поддержка (если интегрирован) — создайте тестовый тикет от абонента, убедитесь, что HelpDesk-вкладка в карточке абонента подтянула тикет.

После прохождения всех 8 пунктов биллинг готов к работе. Если на одном из шагов возникла ошибка — см. Диагностика и решение проблем.

Видеоинструкции

Содержание раздела

Видеоуроки по работе с системой СмИТ Биллинг v1.6.0.

Установка

Установка СмИТ Биллинг v1.6.0

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

Создание администратора биллинга

Работа с абонентами

Создание абонента

Миграция абонентов в СмИТ Биллинг v1.6.0

Заведение юридических лиц в СмИТ Биллинг v1.6.0

ФИАС в СмИТ Биллинг v1.6.0

Тарификация

Создание тарифов и услуг

Интеграция

Интеграция оборудования на примере MikroTik

Финансовые операции

Дополнительно

Настройка шаблонов печати

Настройка шаблонов сообщений

Дочерние страницы