Архитектура интернет-провайдера (ISP)

В данном разделе описывается целевая архитектура системы автоматизации провайдера, построенная на принципах микросервисов и разделении ответственности между BSS (Business Support Systems) и OSS (Operations Support Systems).

Архитектура спроектирована с учётом лучших практик ведущих ISP-платформ (Hydra Billing, Splynx, BillMax, CSG Ascendon) и адаптирована под российские регуляторные требования (СОРМ, ФЗ-152, ФЗ-374). Ключевое отличие от монолитных решений — полное разделение BSS и OSS с координацией через асинхронную оркестрацию (Saga/OMS), что обеспечивает независимое масштабирование и мультивендорную поддержку сетевого оборудования.

Полный цикл Order-to-Cash: Платформа покрывает весь бизнес-цикл ISP — от первичной заявки клиента (Lead) через проверку техвозможности, подключение, тарификацию и приём платежей до удержания абонента (Retention). Каждый этап автоматизирован и наблюдаем.

Ключевые компоненты

Система делится на три основных функциональных блока:

1. BSS (Business Support Systems)

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

• Основные функции: CRM, Биллинг, Продуктовый каталог, Платежи.
• Цель: Обеспечить корректное начисление средств и обслуживание абонентов.

2. OSS (Operations Support Systems)

"Про сеть и оборудование" Этот слой взаимодействует с реальным железом и сетью.

• Основные функции: Инвентаризация сети (Inventory), AAA (FreeRADIUS), DHCP, Сбор статистики (Mediation).
• Цель: Автоматически управлять доступом к услугам на сетевом оборудовании.

3. Оркестрация и Процессы (OMS/BPM)

"Связующее звено" Слой, который объединяет бизнес-процессы и технические действия.

• Основные функции: OMS (Order Management System) — управление заказами, Workflow Engine — движок бизнес-процессов, FSM (Field Service Management) — управление выездными работами.
• Цель: Координировать действия между BSS и OSS (например, "Клиент оплатил -> Включить порт").
• Детали: См. раздел Бизнес-сценарии и Оркестрация.

Полная карта архитектуры

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

Принципы построения

1. Domain Driven Design (DDD): Четкое разделение на домены (Billing, Customer, Network). Подробнее — Доменная логика.
2. Async Messaging: RabbitMQ как единая шина для команд, событий и телеметрии. Карта exchanges — в API-контрактах.
3. Product-Centric: Все процессы начинаются с Product Catalog.
4. Contract-first: Явные контракты для интеграций: синхронные API (для чтения/валидации) и асинхронные команды/события (для длительных процессов). Форматы и паттерны — в API-контрактах.
5. Observability: Полный трейсинг и бизнес-метрики в реальном времени. Дашборды и SLA — в Observability.
6. Security by Design: Zero Trust, RBAC, шифрование, СОРМ. Подробнее — Безопасность.

Технологии

Платформа построена на стеке NestJS (Bun 1.3+) + Drizzle ORM + zod v4 + BullMQ + Protobuf + ConnectRPC + RabbitMQ + PostgreSQL + Kubernetes (Kustomize). Go используется только для high-load компонентов (Mediation, Provisioning, AAA). Детали и Decision Log — в разделе Технологический стек.

Навигация по документации