# Máquinas compartilhadas e direcionamento de geração

O cadastro central fica em `generation_machines`, no mesmo MySQL do gerador. Master e gerador consultam a mesma tabela. O ID persistente da máquina, e não seu nome, é gravado em `generation_jobs.machine_id`.

## Uso

1. No master, abra **Máquinas** e cadastre cada computador pelo nome.
2. Em cada computador, execute a versão atualizada do gerador, conectada ao mesmo banco e ao Ollama daquele computador.
3. No gerador, selecione **Máquina deste computador** na barra lateral. A seleção é guardada naquele navegador e origem. Use um ID diferente para cada computador físico.
4. No master, selecione o cliente em **Gerador**, escolha a **Máquina de geração**, defina os arquivos por rodada e adicione à fila.
5. Inicie a fila e mantenha os geradores abertos. O job só pode ser assumido pela máquina correspondente.

A fila continua global e sequencial. Se o primeiro job estiver destinado a uma máquina fechada ou indisponível, os demais aguardam sua vez; não há salto automático nem execução simultânea em várias máquinas.

O gerador envia presença a cada 15 segundos, enquanto a aba e seu servidor conseguirem consultar a API. O master exibe a última presença registrada; essa data não comprova atividade do Ollama ou progresso recente. A seleção da máquina fica bloqueada durante uma geração local.

## Preservação e compatibilidade

A implantação criou a tabela nova e adicionou uma coluna nullable aos jobs, sem apagar registros nem alterar progresso. Jobs anteriores permanecem sem vínculo de máquina até serem assumidos por um gerador identificado ou reenfileirados com máquina explícita. Um job legado que já estava executando pode continuar salvando sem seleção de máquina.

Para transferir um job pendente, pause a fila, aguarde sair de `running` e reenfileire o mesmo cliente com a nova máquina. O gerador reutiliza o job e preserva seu plano e progresso. A troca de máquina de um job `running` é rejeitada. O reenfileiramento de um job já concluído cria um novo job, conforme o contrato anterior.

A desativação preserva o cadastro e o histórico; é bloqueada se a máquina tiver jobs pendentes ou em execução. Cadastrar novamente o mesmo nome reativa o registro existente. O cadastro antigo de máquinas no armazenamento local do master foi preservado, mas os seletores passam a ler o banco; cadastre no banco os nomes que deseja utilizar.

## Contrato adicionado

`enqueue_client` aceita `machine_id` como string decimal positiva. O formulário do master exige uma máquina ativa. O processamento continua pertencendo ao gerador e ocorre dentro da transação do comando. Comandos legados sem esse campo continuam compatíveis.

O gerador fornece `GET /machines` e `POST /machines/:id/heartbeat`. O seu frontend inclui `machine_id` como parâmetro nas chamadas à API; a seleção é conferida antes de assumir uma rodada ou salvar conteúdo de um job vinculado. Essa identificação operacional usa os controles de acesso existentes e não representa autenticação adicional.

O master fornece `GET /api/seo/machines`, `POST /api/seo/machines` com `{ "name": "PC 01" }` e `POST /api/seo/machines/:id/deactivate`. A tabela armazena ID, nome único, situação ativa, criação e última presença.

## Instalação e permissões

O comando separado `npm.cmd run setup:machines` faz somente a inicialização aditiva dessa extensão e já foi executado neste ambiente. Não é executado durante o startup do master. Em outro ambiente, execute-o com uma conta de administração; a conta normal do master precisa de SELECT, INSERT e UPDATE em `generation_machines`, além das permissões do contrato anterior. A conta do gerador precisa atualizar a presença e o vínculo dos jobs, e manter as permissões de inicialização existentes.

Distribua a versão atualizada do projeto `.gerador-seo` para os demais computadores. As versões antigas não têm o seletor nem a proteção de roteamento. Todos os computadores devem acessar o mesmo banco. O master local permanece em `http://127.0.0.1:3000`; o gerador deste computador está em `http://127.0.0.1:3001`.

Os arquivos anteriores do gerador foram preservados em `.data/generator-backups` no master. Essa pasta contém cópias de código, sem copiar `.env`.

## Verificação

Os testes Node verificam nomes e IDs. `php api/machines.test.php`, no gerador, usa SQLite em memória para testar destino, recusa da máquina incorreta, transferência de job pausado, progresso preservado e recusa de máquinas inexistentes ou inativas. As APIs reais dos dois sistemas foram verificadas em leitura. Não foram criadas máquinas fictícias, comandos de geração ou jobs de teste no banco real; a geração distribuída precisa ser conferida com as máquinas cadastradas e os geradores abertos.
