> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devmob.app.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Ticket Activity

> Histórico append-only de validação, embarque, rejeição e reimpressão de passagens.

TicketActivity registra o histórico operacional de uma passagem. O Ticket mantém o estado consolidado; TicketActivity explica como esse estado foi atingido.

## 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

```mermaid theme={null}
flowchart TD
    TRY["Driver ou operador tenta validar ticket"] --> CHECK["Sistema valida ticket, trip e trecho"]
    CHECK --> ACTIVITY["Sistema registra TicketActivity"]
    ACTIVITY --> RESULT{Resultado}
    RESULT -->|Aceito| BOARD["Ticket recebe boardedAt quando aplicável"]
    RESULT -->|Rejeitado| KEEP["Ticket mantém estado atual"]
    RESULT -->|Reimpresso| PRINT["Reimpressão fica rastreável"]
```

## 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 e `boardedAt`. TicketActivity guarda a sequência de eventos que levou a esse estado.

Veja a modelagem em [TicketActivity](/data-modelling/sales/ticket-activity).