# NotiFix

> NotiFix — безопасный SaaS-шлюз уведомлений (notification gateway). Приложение отправляет один HTTP-запрос POST /api/v0/send с сабтокеном проекта (nfx_...), а NotiFix доставляет сообщение в Telegram (включая темы/topics форум-групп), MAX, VK, Discord, Slack, Mattermost, Bitrix24 или на email (SMTP, UniSender, SendGrid, Mailgun, Yandex Postbox) — через Redis-очередь с ретраями и полным аудитом.

Ключевая идея безопасности: клиентские приложения никогда не получают реальный токен бота или API-ключ почтовика. Они используют отзываемые сабтокены (Project Tokens) с ограничениями: rate limit (скользящее окно), whitelist IP, срок действия, режим HMAC-SHA256-подписей. Реальные токены хранятся зашифрованными AES-256-GCM.

## Основные страницы

- [Лендинг](https://notifix.ru/): описание сервиса, быстрый старт
- [Веб-интерфейс](https://notifix.ru/app/): личный кабинет — проекты, боты, каналы, назначения, токены, аудит
- [Swagger UI](https://notifix.ru/swagger): интерактивная документация API
- [OpenAPI спецификация](https://notifix.ru/swagger.json): машиночитаемая спецификация всех эндпоинтов
- [Health check](https://notifix.ru/api/healthz): статус сервиса

## API (кратко)

- Отправка: POST /api/v0/send, заголовок X-Project-Token: nfx_..., тело {"text": "...", "destination": "имя (опц.)", "thread_id": 217 (опц., тема Telegram)}
- Ответ: 202 Accepted + job_id (асинхронно) или ?sync=1 для ожидания результата доставки
- Идемпотентность: заголовок X-Idempotency-Key (TTL 24 ч)
- Управление (проекты, боты, каналы, назначения, токены): JWT Bearer, см. /swagger

## Понятия

- Проект: изолированный контейнер с мастер-токеном и сабтокенами
- Бот: токен мессенджер-бота (шифруется), Канал: chat_id + опционально темы Telegram (topics: name + message_thread_id)
- Назначение (destination): группа каналов и email-получателей; поддерживает выбор конкретных тем Telegram на канал
- Инбокс: уведомления без назначения сохраняются и могут быть отправлены позже

## Типовой сценарий с темами Telegram

Один форум-чат с темами dev/stage/prod; три окружения с разными nfx_-токенами шлют в один чат, но в разные темы — можно замьютить dev/stage и получать пуши только от prod.