Erros comuns e como resolver

404 no portal

Sintoma: colaborador clica num card e vê "Página não encontrada".

Causa: rota do portal mudou (ex: antigo /fale-com-rh agora é /comunicacao-rh no admin).

Solução: verifique se a sidebar e os cards estão apontando para o slug correto. Se for o portal, a rota é sempre /{slug}/portal/xxx.

403 ao acessar recurso do portal

Sintoma: toast "Você não tem permissão para acessar este recurso".

Causa: flag de permissão não está ligada para a pessoa.

Solução: ir em RH → Pessoas → [abrir] → Portal → Permissões e ligar a flag correspondente.

Erro ao fechar folha

Sintoma: "Erro ao processar a folha".

Causas comuns:

• Alguma pessoa na folha sem salário base


• Rubrica referenciada foi deletada


• Valor negativo em provento / positivo em desconto

Solução: abra a folha, corrija o lançamento problemático, tente fechar de novo.

E-mail de cobrança não envia

Sintoma: "Falha ao enviar. Verifique o email do tenant e SMTP".

Causas:

1. SMTP não configurado — ir em Super Admin → Config → SMTP


2. Tenant sem usuário admin — o sistema busca o e-mail no primeiro admin ativo do tenant; se não houver, falha


3. Firewall / porta bloqueada — teste com telnet smtp.xxx 587

Tela toda quebrada / CSS sumiu

Sintoma: página aparece sem estilo, só texto cru.

Causa quase sempre: cache do navegador guardou CSS velho.

Solução: Ctrl+F5 (ou Ctrl+Shift+R). Se não resolver, cheque se os arquivos em public_html/assets/css/ foram enviados pelo FTP.

Migration falha

Sintoma: erro ao rodar .sql no MySQL.

Causas comuns:

• Banco não existe ainda — use admin_coopop_db_{slug} no início do comando


• Duplicate column name — migration já rodou antes; é seguro ignorar (migrations usam IF NOT EXISTS)


• FK violation — rodou fora de ordem; rode as migrations na ordem cronológica