Навык для агентов, который превращает запросы на естественном языке и реальные источники вроде Terraform, Kubernetes, SQL и OpenAPI в редактируемые архитектурные диаграммы draw.io.
event-catalog/eventcatalog
Инструмент для документирования архитектуры ПО: каталог доменов, сервисов, событий, сообщений и схем для команд и AI-агентов.
- Звёзды
- 2,946
- Форки
- 281
- Открытые issues
- 79
- Последний коммит
- 4 часа назад
Что это?
EventCatalog — инструмент для документирования архитектуры ПО. Он позволяет командам описывать домены, сервисы, события, команды, сообщения и схемы как структурированные ресурсы с версиями, а затем формирует из них сайт с визуализатором связей между компонентами.
Каталог можно наполнять вручную или создавать на основе существующих спецификаций, таких как AsyncAPI, OpenAPI, Protobuf, JSON Schema и Avro, а также платформ обработки событий, например Kafka, Confluent и AWS EventBridge. К доменам и сервисам можно прикреплять записи архитектурных решений, инструкции по эксплуатации и пользовательские страницы MDX, а также описывать сквозные бизнес-процессы со ссылками на существующие сообщения и сервисы.
В проект входят встроенный AI-чат и MCP-сервер, позволяющие людям и инструментам обращаться к каталогу на естественном языке. В состав поставки входят приложение @eventcatalog/core, SDK для Node.js, CLI для создания каркаса проекта и отдельный компонент визуализатора. Исходный код доступен по лицензии Business Source License 1.1, а пакеты экосистемы — по лицензии MIT.
Ключевые возможности
- 01Документирует домены, сервисы, события, команды и сообщения в виде ресурсов с версиями.
- 02Импортирует и формирует содержимое каталога на основе AsyncAPI, OpenAPI, Protobuf, JSON Schema, Avro и платформ обработки событий, таких как Kafka и AWS EventBridge.
- 03Предоставляет обозреватель схем с поиском по каталогу и отдельным полям.
- 04Включает визуализатор архитектуры и документацию бизнес-процессов.
- 05Предоставляет AI-чат и MCP-сервер для запросов к каталогу.
Сценарии использования
- Документирование архитектуры на основе событий или микросервисов, чтобы команды могли выяснить, какие сервисы публикуют и получают каждое сообщение.
- Обеспечение доступности определений схем и сведений об их использовании во множестве сервисов.
- Предоставление AI-ассистентам структурированного доступа к каталогу архитектуры через MCP.
- Публикация записей архитектурных решений и инструкций по эксплуатации рядом с описываемыми ими сервисами.
Быстрый старт
- 1
Создайте начальную структуру нового каталога с помощью инструмента create
npx @eventcatalog/create-eventcatalog@latest my-catalog - 2
Откройте каталог в браузере по адресу localhost на порту 3000
Что важно знать
- Лицензия предоставляет доступ к исходному коду по условиям BSL 1.1, а не является лицензией с открытым исходным кодом, одобренной OSI.
- В метаданных README не указан четкий идентификатор лицензии OSI (лицензия — NOASSERTION).
В подборках
Темы
Частые вопросы
- Что такое eventcatalog?
- Инструмент для документирования архитектуры ПО: каталог доменов, сервисов, событий, сообщений и схем для команд и AI-агентов. EventCatalog — инструмент для документирования архитектуры ПО. Он позволяет командам описывать домены, сервисы, события, команды, сообщения и схемы как структурированные ресурсы с версиями, а затем формирует из них сайт с визуализатором связей между компонентами.
- eventcatalog можно использовать бесплатно? Какая у него лицензия?
- eventcatalog распространяется с открытым исходным кодом под лицензией Other. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- eventcatalog всё ещё поддерживается?
- Активно поддерживается. Последний коммит в eventcatalog — 23 окт. 2026 г..
- Для чего можно использовать eventcatalog?
- Документирование архитектуры на основе событий или микросервисов, чтобы команды могли выяснить, какие сервисы публикуют и получают каждое сообщение. Обеспечение доступности определений схем и сведений об их использовании во множестве сервисов. Предоставление AI-ассистентам структурированного доступа к каталогу архитектуры через MCP. Публикация записей архитектурных решений и инструкций по эксплуатации рядом с описываемыми ими сервисами.
- Как установить eventcatalog?
- Создайте начальную структуру нового каталога с помощью инструмента create: npx @eventcatalog/create-eventcatalog@latest my-catalog Откройте каталог в браузере по адресу localhost на порту 3000
- Где скачать eventcatalog?
- Исходный код и инструкции по установке — на GitHub: https://github.com/event-catalog/eventcatalog
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Подборка из более чем 300 инженерных статей из блогов Airbnb, Netflix, Uber, Stripe и других компаний, сгруппированных по компаниям.
Лёгкий Go-фреймворк для облачных микросервисов с единым транспортом HTTP и gRPC, middleware и генерацией кода на основе Protobuf.
Распределённый инструмент для организации сетевого взаимодействия сервисов: обнаружения, проверки состояния и настройки сервисов, а также Service Mesh в динамичной инфраструктуре.
Библиотека макросов модели C4 для PlantUML, позволяющая описывать диаграммы архитектуры ПО обычным текстом.
Язык моделирования и набор инструментов для создания актуальных диаграмм архитектуры ПО по коду с нотацией на основе C4.