Quando registrar
| Situação | Exemplo |
|---|---|
| Validação | Leitura de QR Code no embarque. |
| Embarque | Ticket aceito e passageiro embarcado. |
| Rejeição | QR Code inválido, ticket cancelado ou trecho incorreto. |
| Falha | Erro técnico ou tentativa incompleta de validação. |
| Reimpressão | Impressão adicional feita por operador autorizado. |
Fluxo
Regras
- O histórico é append-only.
- Toda tentativa relevante deve registrar ator, origem, resultado e metadata disponível.
- Tentativa aceita pode atualizar o estado consolidado do Ticket.
- Tentativa rejeitada não deve apagar histórico anterior.
- Reimpressão deve registrar usuário, motivo e contexto operacional.
- O histórico ajuda auditoria de embarque, suporte e prevenção de fraude.
Relação com Ticket
Ticket guarda dados atuais da passagem, como status eboardedAt. TicketActivity guarda a sequência de eventos que levou a esse estado.
Veja a modelagem em TicketActivity.