Документация ISP Architecture
Техническая документация архитектуры интернет-провайдера (ISP) — полный стек BSS/OSS, микросервисы, API, безопасность и DevOps.
Документация архитектуры ISP
Техническая документация по архитектуре современной системы автоматизации интернет-провайдера (ISP). Платформа построена на принципах микросервисной архитектуры, DDD и разделении ответственности между BSS и OSS слоями.
Что описано в документации
- BSS (Business Support Systems): Биллинг, CRM, управление продуктами и тарификацией.
- OSS (Operations Support Systems): Управление сетью, инвентаризация, AAA (FreeRADIUS) и провижининг.
- Orchestration: Автоматизация бизнес-процессов и управление заказами.
- API & Интеграции: Protobuf-контракты, ConnectRPC, RabbitMQ, паттерны надёжности.
- Security & Compliance: СОРМ, защита данных, RBAC, сетевая безопасность.
- Observability: Метрики, трейсинг, алертинг, SLA/SLO.
Архитектура
Обзор архитектуры
Высокоуровневая схема взаимодействия компонентов, принципы и разделение ответственности.
Слой BSS
Бизнес-системы: биллинг, CRM, каталог продуктов, финансы и уведомления.
Слой OSS
Системы управления сетью: инвентаризация, AAA, провижининг и медиация.
Оркестрация и Workflows
Бизнес-сценарии (Lead-to-Cash, Dunning, RMA), OMS и паттерны устойчивости.
Проектирование и Интеграции
Принципы архитектуры
SOLID, DDD, Unit of Work, CQRS, DRY, KISS — паттерны и практики для NestJS-микросервисов.
Доменная логика и События
DDD, модели сущностей (ER-диаграммы) и карта событий RabbitMQ между доменами.
API-контракты и Интеграция
Protobuf + buf.build, ConnectRPC, RabbitMQ, BullMQ, Outbox/Inbox/Saga паттерны.
Интеграция с RADIUS
FreeRADIUS: аутентификация, авторизация, CoA, схема БД и атрибуты вендоров.
Инфраструктура и Операции
Технологический стек
NestJS на Bun 1.3+, Drizzle ORM, zod v4, BullMQ, ConnectRPC, RabbitMQ, PostgreSQL, K8s, ArgoCD.
Безопасность и Комплаенс
СОРМ, ФЗ-152, Zero Trust, RBAC, шифрование, аудит и чек-лист деплоя.
Observability и Мониторинг
Логи, метрики, трейсинг, алерты, SLA/SLO, Error Budget и дашборды Grafana.