# Histórico de geração

`npm.cmd run setup:generation-history` cria a tabela `master_generation_events` e os gatilhos `master_generation_event_insert` e `master_generation_event_update` na tabela compartilhada `generation_jobs`.

Cada criação de job e mudança de estado grava cliente, job, máquina, estado anterior e novo, mensagem, páginas geradas/total e data/hora UTC com precisão de microssegundos. Mensagens de erro diferentes também geram novos registros mesmo quando o estado continua `error`. Atualizações normais de progresso sem mudança de estado não duplicam eventos.

O histórico do cliente combina esses registros com `master_client_history`, ordenando por data/hora. Início, retomada, pausa, erro, fila, cancelamento e conclusão aparecem dentro do Master. A gravação ocorre na mesma transação do job e independe do Master estar aberto. Geradores que usam esse mesmo banco não precisam de alteração para registrar mudanças em `generation_jobs`.

A migração recupera horários de início e conclusão já disponíveis (`started_at` e `completed_at`). Pausas e erros anteriores à instalação não podem ser reconstruídos. O registro captura eventos persistidos pelo gerador; erros que ele não envia ao banco não podem aparecer no histórico.

A tabela de eventos não possui exclusão em cascata, preservando a auditoria quando um job é removido. A instalação precisa de permissão MySQL para criar gatilhos; essa configuração já foi aplicada no banco desta instalação.

## Geração sem avanço

`npm.cmd run setup:generation-watch` configura `master_generation_watch` e dois gatilhos que acompanham mudanças do contador de textos. Mensagens, atualizações de heartbeat e outras gravações sem mudança de contador não reiniciam o prazo.

O Master verifica a cada 5 segundos jobs em execução de clientes na fase GERACAO, com páginas restantes. Após mais de 60 minutos sem mudança no contador, registra `Problema na Máquina <nome> - DD/MM/AAAA - HH:mm` no histórico, com data/hora de São Paulo. Cada parada gera apenas um aviso. Progresso, mudança de estado ou troca de máquina iniciam um novo período de acompanhamento. O aviso não pausa o job nem altera sua fase.

O relógio é persistido no banco e continua após reiniciar o Master. A emissão do aviso depende do servidor Master em execução. Para jobs anteriores à instalação, o acompanhamento começa na instalação, sem inferir o último progresso por `updated_at`.
