diff --git a/.env.example b/.env.example
index 3b78997..34ec0cd 100644
--- a/.env.example
+++ b/.env.example
@@ -1,14 +1,50 @@
-GOOGLE_PROJECT_ID=seu-projeto-id
-GOOGLE_LOCATION=us-central1
+# ============================================
+# CONFIGURAÇÕES DO GOOGLE CLOUD
+# ============================================
 
+GOOGLE_PROJECT_ID=id_do_seu_projeto
+GOOGLE_LOCATION=loc_do_seu_projeto
 
-# Database
-DB_HOST=Seu_host
-DB_PORT=3306
-DB_USER=Seu_usuario
-DB_PASSWORD=Sua_senha
-DB_NAME=Seu_banco_de_dados
+# ============================================
+# CONFIGURAÇÕES DO BANCO DE DADOS (LOCAL)
+# ============================================
+# Para desenvolvimento local: PostgreSQL direto
 
-# Mockaroo
-MOCKAROO_API_KEY=coloque_sua_api_key_aqui
-MOCKAROO_BASE_URL=https://my.api.mockaroo.com
\ No newline at end of file
+DB_HOST=localhost
+DB_PORT=5432
+DB_USER=orquestrador
+DB_PASSWORD=SUA_SENHA
+DB_NAME=orquestrador_db
+
+# ============================================
+# CONFIGURAÇÕES DO BANCO DE DADOS (CLOUD SQL - PRODUÇÃO)
+# ============================================
+# Comentado até fazer deploy. Descomente em produção.
+# CLOUD_SQL_CONNECTION_NAME=optimum-tensor-343619:us-central1:orquestrador-db
+
+# ============================================
+# CONFIGURAÇÕES DE API - GOOGLE GENERATIVE AI (Gemini)
+# ============================================
+# Descomente e informe a chave apenas se usar Gemini
+# GOOGLE_API_KEY=sua-chave-api-aqui
+
+# ============================================
+# CONFIGURAÇÕES DE API - MOCKAROO (Dados fictícios)
+# ============================================
+# Obrigatório: Forneça sua chave se usar Mockaroo para dados de teste
+MOCKAROO_API_KEY=sua-chave-mockaroo-aqui
+MOCKAROO_BASE_URL=https://api.mockaroo.com/api
+
+# ============================================
+# CONFIGURAÇÕES DE COMPORTAMENTO
+# ============================================
+# Usar Mockaroo para escrita de dados (apenas testes)
+USE_MOCKAROO_WRITES=false
+
+# ============================================
+# AMBIENTE E DEBUG
+# ============================================
+# Valores: development, staging, production
+ENVIRONMENT=development
+# DEBUG deve ser false em produção
+DEBUG=true
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
index c5f93a9..6a22e1e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -41,6 +41,7 @@ htmlcov/
 .env
 .env.local
 .env.*.local
+.env.prod
 
 # IDEs
 .vscode/
@@ -48,6 +49,35 @@ htmlcov/
 *.swp
 *.swo
 *~
+
+# Google Cloud
+google_credentials.json
+service-account-key.json
+*.p12
+*.pem
+
+# Docker
+.docker/
+docker-compose.override.yml
+
+# Cache de dependências
+*.lock
+
+# Logs
+*.log
+logs/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Node (caso use alguma ferramenta)
+node_modules/
+
+# Arquivos temporários
+*.tmp
+*.tmp.*
+temp/
 .DS_Store
 Thumbs.db