89 lines
1.9 KiB
Markdown
89 lines
1.9 KiB
Markdown
# Документ 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
|