# Runbook — publicar no cPanel/UOL Host

## Antes de subir

1. Fazer backup de arquivos e banco.
2. Remover arquivos `.zip`, `.sql`, `.bak`, `.old` e configs reais do pacote público.
3. Validar PHP 8.1+ ou 8.3 conforme hospedagem.
4. Validar extensão `pdo_mysql`.
5. Validar permissões de `uploads/` e `storage/`.
6. Validar `.htaccess`.

## Depois de subir

1. Abrir Home.
2. Abrir Unidades.
3. Abrir uma unidade por `Detalhes.php?id=...`.
4. Testar busca `search_ajax.php?q=...`.
5. Testar NPS sem enviar dados reais.
6. Testar Fale Aqui e validar se e-mail vai somente para NPS interno.
7. Testar Franquia e SMTP se estiver habilitado.

## Erros comuns

| Erro | Causa provável | Ação |
|---|---|---|
| 500 | credencial/banco/config PHP | Ver log PHP e config. |
| 404 em rota existente | `.htaccess` ou caminho errado | Conferir rewrite e arquivo. |
| 504 | processamento pesado ou loop | Reduzir lote, remover ZIP pesado e otimizar consulta. |
| Imagem não sobe | permissão de pasta | Ajustar permissão de `uploads/` e `storage/`. |