Skip to content

REF-04-A: Catálogo de Eventos Cross-Domain

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ável

Fim de acesso

engine: enrolment_inactivated
  ├─→ engine: pausa/encerra roadmap
  └─→ moodle: revoga inscrição no curso

Polí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

Referências

  • ADR-04 — política geral de eventos
  • ADR-50 § Domain Events — eventos intra-domínio product
  • ADR-60 § Domain Events — eventos intra-domínio engine
  • ADR-70 § Domain Events — eventos intra-domínio metrics
  • ADR-80 § Domain Events — eventos intra-domínio activity
Navigation

Type to search…

↑↓ navigate↵ selectEsc close