Event Bus Platform — документация¶
Гетерогенная событийная шина: NATS JetStream — спина (факты, контракт), вокруг — любой зоопарк участников, соблюдающих контракт; durable-обработка живёт в движках-участниках. Граница шина↔движок — событие.
Документация организована по Diátaxis — четыре типа, каждый отвечает на свой вопрос:
🎓 Tutorials — научиться (руками, по шагам)¶
- Первый сквозной поток — опубликовать факт и увидеть, как он проходит шину → движок → обратно в шину.
- Демо-бот, задействующий всю платформу — поднять Telegram-бота и увидеть eventgate, контракт, мост, durable-шаг и fan-out разом.
🔧 How-to — решить задачу¶
- Добавить участника
- Изменить контракт (событие)
- Подключить внешнего участника (wss)
- Объявить стрим (как код)
- Задеплоить стек в Coolify
- Наблюдаемость: трейсы и DLQ
- Закрыть сервис через Authentik
📖 Reference — точные факты¶
- Контракт участника — что обязан участник
- Именование событий — форма subject'ов
- Correlation ID —
traceparentчерез границу - Доступ участников — сети и авторизация шины
- Секреты — инвентарь и доставка
- Каталог событий — кто что публикует/потребляет (генерится)
💡 Explanation — понять, почему так¶
- Архитектура — принципы и границы
- ADR 0001 — Inngest владеет своим датастором
- ADR 0002 — выбор движков/рантаймов
Полный концепт — event-bus-concept.md в корне репозитория. Рабочие правила
(всё через ишью, контракт раньше кода) — CLAUDE.md.