Repolode
event-catalog

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. 1

    Создайте начальную структуру нового каталога с помощью инструмента create

    npx @eventcatalog/create-eventcatalog@latest my-catalog
  2. 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 обновляется ежедневно.

Похожие проекты

Навык для агентов, который превращает запросы на естественном языке и реальные источники вроде Terraform, Kubernetes, SQL и OpenAPI в редактируемые архитектурные диаграммы draw.io.

10,3 тыс.711PythonMITОбновлён 12 дней назад

Распределённый инструмент для организации сетевого взаимодействия сервисов: обнаружения, проверки состояния и настройки сервисов, а также Service Mesh в динамичной инфраструктуре.

30,1 тыс.4,6 тыс.GoOtherОбновлён 24 часа назад