ochenstarik/agent-control-center
1
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions
agent-control-center/docs/spec-series/09_Event_Bus.md

1.9 KiB
Raw Blame History

Документ 09. Event Bus

Назначение

Документ описывает событийную архитектуру платформы Agent Control Center, правила публикации и обработки событий.

1. Принципы

  • Event Driven Architecture.
  • Асинхронная обработка.
  • Слабая связанность сервисов.
  • Идемпотентные обработчики.
  • Повторная доставка допустима.

2. Категории событий

Lifecycle

  • RunCreated
  • RunScheduled
  • RunStarted
  • RunPaused
  • RunResumed
  • RunCompleted
  • RunFailed
  • RunCancelled

Project

  • ProjectCreated
  • ProjectUpdated
  • ProjectArchived

Agent

  • AgentCreated
  • AgentUpdated
  • AgentDeleted

Connector

  • ConnectorRegistered
  • ConnectorOnline
  • ConnectorOffline
  • ConnectorHeartbeat

Memory

  • MemoryCreated
  • MemoryUpdated
  • MemoryDeleted

Artifact

  • ArtifactUploaded
  • ArtifactDeleted

Security

  • UserLoggedIn
  • PermissionChanged
  • ApprovalRequested
  • ApprovalGranted
  • ApprovalRejected

3. Формат сообщения

Каждое событие содержит: - event_id - event_type - event_version - occurred_at - producer - correlation_id - payload

4. Гарантии

  • At-least-once delivery.
  • Идемпотентность обработчиков обязательна.
  • Сохранение порядка в пределах одного aggregate.

5. Повторная обработка

Использовать: - retry policy; - dead-letter queue; - экспоненциальную задержку.

6. Наблюдаемость

Каждое событие журналируется и имеет трассировку.

Следующий документ

10_Agent_Protocol.md