REF-04-A: Catálogo de Eventos Cross-Domain
ADR: ADR-04 (Eventos para desacoplamento entre componentes) Status: Aceito Data: 2026-04-24
Contexto
Este REF consolida os eventos que cruzam fronteiras de bounded contexts no local_helico. Eventos intra-domínio (que não saem do domínio de origem) estão documentados nos ADRs de cada domínio (ADR-50, ADR-60, ADR-70, ADR-80). Este catálogo cobre somente os eventos inter-domínio — aqueles cujo consumidor está em domínio diferente do produtor.
Todos os eventos são fatos passados (nomenclatura em passado). O mecanismo de dispatch é o EventDispatcher do local_middag.
Catálogo de eventos cross-domain
| Evento | Produtor | Consumidores | Dados mínimos no payload |
|---|---|---|---|
trail_published |
product | engine | trail_id, plan_id, version |
trail_republished |
product | engine, notificações | trail_id, plan_id, version, previous_plan_id |
enrolment_created |
engine | engine (onboarding), notificações | enrolment_id, student_id, trail_id, plan_id |
enrolment_suspended |
engine | engine (execução) | enrolment_id, student_id, reason |
enrolment_inactivated |
engine | engine, moodle | enrolment_id, student_id, reason, access_policy |
access_renewed |
engine | engine (acesso) | enrolment_id, student_id, new_expiry, renewal_strategy |
onboarding_completed |
engine | engine (instanciação do plano) | enrolment_id, student_id, profile_answers |
study_block_activated |
engine | activity | student_plan_id, study_block_id, block_type, criteria |
study_block_completed |
engine | metrics | student_plan_id, study_block_id, block_type, completed_at |
study_flow_completed |
engine | metrics | student_plan_id, study_flow_id, completed_at |
execution_session_completed |
engine | metrics | execution_session_id, student_plan_id, activity_type |
activity_completed |
activity | engine, metrics | execution_session_id, student_id, activity_type, result_id |
level_classified |
metrics | engine, activity | student_id, trail_id, level, classification_id |
level_changed |
metrics | engine, activity | student_id, trail_id, previous_level, new_level |
unit_activated |
engine | content | unit_id, student_plan_id |
unidade_processada |
content | product, engine | unit_id, discipline_id, change_type |
Fluxo de eventos por fase do ciclo de vida
Fase 2 — Compilação
product: trail_published
└─→ engine: CompilationEngine.compile()Fase 3 — Instanciação
engine: enrolment_created
└─→ engine: OnboardingOrchestrator.start()
└─→ engine: onboarding_completed
└─→ engine: PlanInstantiationService.instantiate()Fase 4 — Execução
engine: study_block_activated
└─→ activity: prepara execução do bloco
activity: activity_completed
├─→ engine: ExecutionEngine.progress()
└─→ metrics: consolidar resultado
engine: study_block_completed
└─→ metrics: consolidar progresso do bloco
metrics: level_classified | level_changed
├─→ engine: adapta atividades (dispensa, recomendação)
└─→ activity: aplica dispensa se aplicávelFim de acesso
engine: enrolment_inactivated
├─→ engine: pausa/encerra roadmap
└─→ moodle: revoga inscrição no cursoPolíticas de retry e dead letter (ADR-04)
- Retry: listeners idempotentes com backoff exponencial configurável por listener
- Dead letter: eventos que falham após todas as tentativas são registrados para investigação manual
- Ordering: eventos dentro do mesmo agregado mantêm ordem causal; entre agregados distintos, não há garantia de ordem global