# Integração Absolut — Gerador

O master mantém sua gestão operacional no mesmo MySQL do gerador pelo backend Node. O cadastro principal e o dashboard usam `clients`, com os campos descritos em [CADASTRO-CLIENTES.md](./CADASTRO-CLIENTES.md). Os IDs dessa área vêm diretamente da tabela compartilhada. Associações antigas com clientes locais em `.data/seo-links.json` foram preservadas, sem associação automática por nome.

## Execução local

Use Node.js 24 (validado com 24.14.0) e execute:

```powershell
npm.cmd install
npm.cmd run dev
```

Abra `http://127.0.0.1:3000` e escolha **Gerador**. O comando inicia o backend e o Vite juntos. Para servir a compilação local: `npm.cmd run build` e `npm.cmd start`. `npm.cmd run preview` serve apenas os arquivos estáticos e não inicia a API.

O backend fica em `127.0.0.1`, pois o projeto não tem autenticação. A publicação para outras máquinas exige definir autenticação e autorização antes de expor a API.

## Banco separado

As variáveis `SEO_DB_HOST`, `SEO_DB_PORT`, `SEO_DB_NAME`, `SEO_DB_USER` e `SEO_DB_PASSWORD` ficam em `.env`, ignorado pelo repositório. Foram inicialmente copiadas do `.env` local do gerador, sem colocar credenciais no frontend. Use preferencialmente uma conta com SELECT nas tabelas documentadas e INSERT em `master_commands`; o master não requer DDL.

O servidor usa parâmetros preparados, `utf8mb4`, sessão UTC e IDs como strings. A interface apresenta datas em `America/Sao_Paulo`.

O painel verifica as estruturas e o conteúdo do template 9 sem criar ou alterar tabelas. Caso estejam ausentes, abra o gerador atualizado para que a API dele inicialize o contrato. Acesso negado indica que as credenciais, as permissões ou a liberação do IP no MySQL remoto precisam ser corrigidas pelo responsável pelo banco.

## Operações

O cadastro compartilhado de máquinas, a seleção em cada computador e o direcionamento dos jobs estão descritos em [MAQUINAS-COMPARTILHADAS.md](./MAQUINAS-COMPARTILHADAS.md). Essa extensão exige INSERT e UPDATE do master na tabela nova `generation_machines`; as alterações de clientes e fila continuam usando comandos.

Cadastre ou selecione um cliente do gerador, edite os quatro textos e as duas listas. Cada linha representa uma palavra-chave ou região. Edições enviam somente campos alterados. Aguarde o comando **Concluído** e carregue os dados confirmados antes de enfileirar.

As seis ações são enviadas somente por INSERT em `master_commands`. O master não consome comandos nem altera jobs. A chave é guardada antes do envio no navegador; reenvios usam a mesma chave. Se a conexão falhar, **Reenviar mesma operação** recupera ou envia a operação sem gerar outra chave. Um comando falho exige correção dos dados e uma nova solicitação. Comandos pendentes não são apresentados como concluídos.

Após a confirmação do cadastro, um popup de sucesso aparece por cinco segundos e a página é recarregada na área Gerador. Selecione o cliente cadastrado na lista, escolha explicitamente o cliente do master e salve a associação. Não limpe o armazenamento do navegador enquanto houver operações ainda não confirmadas. O histórico de comandos permanece disponível no painel, sem uma seção separada de acompanhamento das operações.

O gerador e seu servidor precisam permanecer abertos. O painel consulta a cada sete segundos; não existe heartbeat para confirmar atividade do executor. Iniciar a fila altera seu estado desejado; pausar pode aguardar o lote atual. Para alterar o limite de um job em execução, pause e aguarde sair de `running`. O limite é de arquivos por rodada, entre 1 e 1000000, e não muda o plano. Edições do cliente não atualizam jobs existentes.

O histórico mostra erros, revisões e jobs. Downloads vêm de `generation_files.content` como anexos; nenhum PHP gerado é executado. A listagem de versões pagina por ID por job. Conteúdo antigo pode não estar disponível mesmo com progresso registrado.

## Verificação

```powershell
npm.cmd test
npm.cmd run lint
npm.cmd run build
```

Os testes locais validam o contrato de entrada, precisão dos IDs, reenvio idempotente e falhas de conexão com armazenamento simulado. Eles não comprovam a execução do gerador ou as rodadas no banco real. A homologação de cadastro, template, edição, rodadas e pausa exige conexão liberada, aba do gerador aberta e registros de teste identificáveis, sem apagar dados existentes.
