🚀 Guia de Publicação — cofermetadvh.com.br (UOL Host)

Como colocar cada nova versão do portal no ar. As credenciais FTP ficam somente na sua máquina — nunca no chat nem dentro do site.

ANTES DE COMEÇAR (uma única vez)

TER O PYTHON INSTALADO
Windows: baixe em python.org/downloads e, na instalação, marque "Add Python to PATH". Conferir: abra o PowerShell e digite python --version — deve responder algo como Python 3.12.

PEGAR AS CREDENCIAIS FTP NO PAINEL UOL HOST
Entre em painel.uolhost.com.br → Hospedagem → FTP (ou "Gerenciar FTP"). Anote: Servidor (ex.: ftp.cofermetadvh.com.br), Usuário e Senha. Se não lembrar a senha, use "Redefinir senha do FTP" no próprio painel.

GRAVAR AS CREDENCIAIS NO SEU COMPUTADOR
No PowerShell (colar linha a linha, com seus dados):

setx UOLHOST_HOST "ftp.cofermetadvh.com.br"
setx UOLHOST_USER "seu_usuario_ftp"
setx UOLHOST_PASS "sua_senha_ftp"

Depois feche e reabra o PowerShell. Isso fica salvo — nunca mais precisa repetir.

PUBLICAR UMA VERSÃO (rotina — sempre igual)

BAIXAR O PACOTE DA VERSÃO
No chat do Claude, baixe o PUBLICAR_AGORA_COFERMETADVH_Vn.zip (ou PUBLICAR_UOLHOST_Vn.zip) da versão que quer publicar.

EXTRAIR
Botão direito → Extrair tudo… numa pasta sua (ex.: C:\Cofermeta\publicar). Dentro vai ter PUBLICAR.bat, deploy_uolhost.py e a pasta site_deploy\ (o espelho do site).

DUPLO CLIQUE EM PUBLICAR.bat
O conector liga por FTPS (criptografado), compara e envia somente o que mudou, criando as subpastas (decisao/, assets/, fichas_pead/…). Ao final mostra o total enviado. É só isso ✔
Prefere simular antes? No PowerShell, dentro da pasta: python deploy_uolhost.py site_deploy (sem --enviar) = mostra o que SERIA enviado, sem publicar.

CONFERIR NO AR
Abra https://cofermetadvh.com.br/login.html → entre com seu usuário. Teste 1 tela de cada seção. Dica: Ctrl+F5 força o navegador a baixar a versão nova (limpa o cache).

CAMINHO ALTERNATIVO — SEM PYTHON (pelo painel UOL)

Painel UOL Host → Hospedagem → Gerenciador de Arquivos → entre na pasta raiz do site (/public_html) → Upload do arquivo PUBLICAR_UOLHOST_Vn.zip → botão direito no zip → Extrair aqui (sobrescrevendo) → apague o zip. Funciona, mas envia tudo de novo (mais lento) — o PUBLICAR.bat continua sendo o caminho recomendado.

Outra opção: FileZilla (gratuito) — Host ftp.cofermetadvh.com.br, usuário/senha do FTP, porta 21, criptografia "TLS explícito"; arraste o CONTEÚDO de site_deploy\ para /public_html.

PROBLEMAS COMUNS

Mensagem / sintoma	Causa	Solução
python não é reconhecido	Python fora do PATH	Reinstalar marcando "Add Python to PATH" (ou usar o caminho alternativo pelo painel)
Defina UOLHOST_HOST/USER/PASS	Credenciais não gravadas	Refazer o passo 3 do preparo e REABRIR o PowerShell
530 Login incorrect	Usuário/senha FTP errados	Conferir no painel UOL → FTP; se preciso, redefinir a senha e rodar os setx de novo
Timeout / não conecta	Firewall ou host errado	Conferir UOLHOST_HOST; testar rede; tentar de novo (o UOL às vezes oscila)
550 ao criar pasta	Raiz remota diferente	Rodar com `--raiz /www` (alguns planos usam /www em vez de /public_html)
Site no ar mas "velho"	Cache do navegador	Ctrl+F5; em último caso, aba anônima
Avisos/admin não salvam	api/ PHP	Normal na beta Netlify; em produção UOL funciona — conferir que a pasta api/ subiu

🔐 Segurança: nunca coloque a senha do FTP em arquivos do site, no chat ou em prints. Ela vive apenas nas variáveis de ambiente da sua máquina. Ao publicar o V35+, o portal passa a exigir login — comunique os PINs iniciais pessoalmente e troque-os no primeiro acesso (tela Usuários & Acessos).

⛔ Nunca apague pastas direto no servidor sem backup — o conector nunca apaga nada, só adiciona/atualiza. Exclusões de telas são feitas por mim com redirects e ficam registradas em _arquivo/ no projeto.