🤖 Instruções para Agentes Gemini

Este arquivo contém diretrizes críticas para qualquer agente de IA que interaja com este repositório.

🚀 Workflow de Deploy (OBRIGATÓRIO)

NUNCA faça commit direto na branch producao sem antes validar a configuração.

O repositório conta com um script de automação híbrido (producao/scripts/deploy_pathfinder.py) que deve ser usado para todo e qualquer deploy.

Faça suas alterações nos arquivos de configuração (nginx/).
Valide e Deploye rodando o script abaixo no terminal do Windows:
```
python producao/scripts/deploy_pathfinder.py sync --all
```
Verifique a Saída:
- O script fará o upload, testará a configuração (nginx -t) no servidor e fará o reload.
- Se houver erro, corrija antes de prosseguir. O script fará rollback automático no servidor, mas seu código local estará "quebrado".
Commit: Somente após o sucesso do comando acima ("Deploy Remoto Concluído com Sucesso!"), faça o commit das alterações.

Sincronizar Tudo (Nginx + Fail2Ban + GeoIP): python producao/scripts/deploy_pathfinder.py sync --all
Deploy de Novo Site: python producao/scripts/deploy_pathfinder.py site --deploy dominio.com
Atualizar GeoIP Manualmente: python producao/scripts/deploy_pathfinder.py geoip --update

GeoIP: O script baixa automaticamente os bancos GeoIP se faltarem. Não precisa baixar manualmente.
Paramiko: O script usa paramiko para SSH. Se não estiver instalado, instale com pip install paramiko.
Credenciais: As credenciais de acesso ao servidor estão embutidas no cabeçalho do script. Não as exponha em logs públicos.