Practical task: Unified notification platform (Notification Platform) Context In the company, there are 3 dispersed systems that send notifications to users: 1. CRM — sends emails and push notifications about orders. 2. Support Portal — sends messages about tickets via Telegram bot. 3. Security System — generates SMS alerts about suspicious logins. Each system implements its own logic: * own templates, hardcoded recipients; * no centralized notification history; * users complain about duplicates and delays; * no unified SLA, metrics, or control center. Goal Design a new Notification Platform that: * aggregates events from different sources (CRM, Support, Security), * routes them by type and channel (email, SMS, Telegram, push), * ensures uniform templates, logging, and observability, * supports SLA (p95 ≤ 3 seconds for delivery), * allows scaling and expansion of channels in the future. Candidate's task 1. Define the functional requirements of the system. 2. Describe the non-functional requirements (reliability, performance, error handling). 3. Create a context diagram (C4 Level 2). 4. Add a sequence diagram schematic. For example, sending a message from CRM.

Функциональные требования:

• Приём событий из CRM, Support Portal и Security System через API или очередь сообщений.
• Маршрутизация уведомлений по каналам: email, SMS, Telegram, push.
• Централизованное управление шаблонами уведомлений с возможностью редактирования.
• Логирование всех отправленных уведомлений с историей и статусами доставки.
• Метрики и мониторинг SLA (например, p95 ≤ 3 секунды на доставку).
• Возможность масштабирования и добавления новых каналов уведомлений.
• Управление подписками пользователей и предпочтениями каналов.

Нефункциональные требования:

• Надёжность: гарантированная доставка уведомлений или повторные попытки.
• Производительность: обработка и доставка уведомлений в пределах SLA.
• Обработка ошибок: логирование ошибок, оповещения о сбоях, fallback-каналы.
• Безопасность: аутентификация источников событий, защита данных пользователей.
• Масштабируемость: горизонтальное масштабирование компонентов.

---

Контекстная диаграмма (C4 Level 2):

• Внешние системы: CRM, Support Portal, Security System.
• Notification Platform:
  • API Gateway для приёма событий.
  • Event Processor для маршрутизации.
  • Template Manager для шаблонов.
  • Notification Dispatcher для отправки по каналам.
  • Logging & Monitoring.
  • User Preferences Service.

---

Sequence-диаграмма (отправка сообщения из CRM):

1. CRM отправляет событие уведомления в Notification Platform через API.
2. API Gateway принимает событие и передаёт его Event Processor.
3. Event Processor определяет канал (например, email) и выбирает шаблон из Template Manager.
4. Формируется сообщение и передаётся Notification Dispatcher.
5. Notification Dispatcher отправляет email через Email Service.
6. Статус отправки логируется в Logging & Monitoring.
7. Notification Platform возвращает статус CRM.

---

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