# Publicação no cPanel

Este pacote é uma aplicação Node.js completa. A pasta `dist/` contém apenas a interface; o acesso ao MySQL ocorre no processo Node em `server/`.

## Requisitos

- cPanel com **Setup Node.js App** (Node.js 20 ou superior) habilitado.
- Acesso do IP do servidor cPanel ao MySQL remoto.
- Um usuário MySQL com acesso de leitura e escrita ao banco usado pelo Gerador/Master.

## Instalação

1. No cPanel, crie uma aplicação em **Setup Node.js App** com Node.js 20+ e defina o domínio ou subdomínio desejado.
2. Envie o conteúdo deste pacote para a pasta raiz da aplicação. Não envie `node_modules`.
3. No Terminal do cPanel, dentro da pasta da aplicação, execute `npm ci --omit=dev`.
4. Crie o arquivo `.env` a partir de `.env.example` e preencha `SEO_DB_HOST`, `SEO_DB_PORT`, `SEO_DB_NAME`, `SEO_DB_USER` e `SEO_DB_PASSWORD`. Essas variáveis são lidas somente pelo backend e não entram em `dist/`.
5. Execute `npm run setup:auth` para criar localmente os hashes de senha dos perfis Administrador, Visualizador e Vendas. O comando pede as senhas no terminal e grava `.data/auth.json`.
6. Em **Setup Node.js App**, use `app.js` como arquivo de inicialização e reinicie a aplicação. Esse é o nome padrão reconhecido pelo Passenger/cPanel.

## Opcional: planilha Google

Se a sincronização com a planilha for usada, envie a chave da conta de serviço para `.data/google-service-account.json` e preencha `GOOGLE_SHEETS_ID`, `GOOGLE_SHEETS_TAB` e `GOOGLE_SHEETS_CREDENTIALS_FILE` no `.env`.

## Segurança e manutenção

- Listas grandes de palavras-chave: a API de cadastro aceita JSON até 128 MB e aguarda até 10 minutos. O proxy/Passenger da hospedagem também precisa permitir o tamanho e o tempo da requisição. Respostas 413 e 504 indicam limites de tamanho e tempo, respectivamente. O cadastro pendente é guardado no IndexedDB do navegador para preservar a chave de reenvio sem depender da pequena cota do localStorage.

- Não envie `.env`, `.data/auth.json` ou a chave Google para e-mail, Git ou uma pasta pública.
- O banco já precisa conter as tabelas e gatilhos do Master. Não execute as migrações no cPanel se ele estiver usando o mesmo banco que a instalação atual.
- Caso apareça erro de conexão, libere o IP público do servidor cPanel no firewall/MySQL remoto e confira as permissões do usuário do banco.
