🚀 Guia de Publicação — cofermetadvh.com.br (Cloudflare Pages)

Como cada nova versão do portal entra no ar. O site publica sozinho a partir do GitHub — não existe FTP, não existe upload manual.

COMO FUNCIONA HOJE

PEDIR A MUDANÇA NO CHAT
Você descreve o que quer no chat do Claude (nova tela, correção, carga de dados). A assistente altera o código no repositório ronaldobrenck-pixel/portaldvh (GitHub), na branch de trabalho.

TESTE AUTOMÁTICO ANTES DE PUBLICAR
Antes de subir, roda o smoke-test (node scripts/smoke_telas.cjs): 21 telas abertas em navegador real, procurando página morta ou erro de script. Se qualquer tela falhar, não publica.

PULL REQUEST → MERGE NA MAIN
A mudança vira um Pull Request no GitHub (histórico + comparação do que mudou). Ao aprovar/mesclar na branch main, o Cloudflare Pages detecta e faz o deploy sozinho. Nada a fazer manualmente ✔

NO AR EM ~1 MINUTO, NOS DOIS ENDEREÇOS
Produção: cofermetadvh.com.br e portaldvh.pages.dev (o mesmo site). A verificação final é abrir a tela alterada em produção.

ONDE FICAM OS DADOS (SERVIDOR)

Banco / serviço	O que guarda
D1 · dvh	Usuários, senhas (hash), permissões e liberações de área
D1 · cofermeta-dvh-etiquetas	Base de itens do app Etiquetas (21 mil itens Sankhya, cadastro de campo, eventos)
D1 · dvh-catalogo-publico	Catálogo público (páginas de QR code)
KV · SESSIONS / SHARED / KV	Sessões de login e dados compartilhados das telas (Central, pendências, chat…)
R2 · UPLOADS	Arquivos anexados (documentos, planilhas)

🌉 Regra da ponte: nunca criar bancos novos — as telas e a API já apontam para estes. Backup/consulta é pela própria assistente ou pelo painel do Cloudflare.

SE ALGO DER ERRADO

Sintoma	Causa comum	O que fazer
Tela em branco após publicar	Erro de script na página	Avisar no chat — o smoke-test pega quase tudo, mas se escapar a correção sai no mesmo dia
Mudou mas o site mostra o antigo	Cache do navegador	Ctrl+F5 (ou aba anônima); o deploy do Pages leva ~1 min após o merge
Login não funciona	Sessão expirada / senha	Tela Usuários & Autorizações (admin) redefine a senha; primeiro acesso pede troca
Dados "sumiram"	Olhando o banco errado	Os dados ficam no servidor (D1/KV), não no navegador — conferir com a assistente antes de recadastrar

🔐 Segurança: senhas nunca ficam em arquivos do site — só o hash no banco D1. O portal exige login em todas as telas internas; PINs iniciais são comunicados pessoalmente e trocados no primeiro acesso.

⛔ Exclusão de telas ou dados é feita sempre via chat, com registro no histórico do GitHub — nunca apague nada direto no painel do Cloudflare.