Pular para conteúdo

Template: Evento

Objetivo

Padronizar a documentação de um evento real do sistema. Nos produtos CoreFlow hoje, "evento de domínio" não é uma classe formal — é um signal Django ou uma chamada direta entre services (ver ADR-0003).


Estrutura

# Evento: <Nome>

**Mecanismo real:** signal Django (`post_save`/`pre_delete`/...) | chamada direta de service | task Celery disparada

## Gatilho

O que dispara o evento — ação do usuário, transição de estado, agendamento.

## Origem

`apps/<modulo>/signals.py` ou `apps/<modulo>/services.py`, linha/função real.

## Dados carregados

| Campo | Descrição |
|---|---|
| ... | ... |

## Consumidores reais

| Quem reage | O que faz |
|---|---|
| ... | ... |

## Efeitos

Grava auditoria? Envia e-mail? Atualiza outro model?

Regra de preenchimento

Documentar apenas eventos que existem de fato no código (signals.py, @receiver, chamadas encadeadas de service). Não descrever um barramento de eventos formal — ele não existe nos produtos reais hoje.


Referências