📘 Guia Completo de Instalação - ECOSIF

📋 Visão Geral

Este guia fornece instruções passo a passo para instalação completa do sistema ECOSIF em qualquer ambiente.

✅ Pré-requisitos

Software Necessário

Verificar Instalações

docker --version
docker compose version
python3 --version
git --version

🚀 Instalação Rápida

Passo 1: Clonar Repositório

git clone <repo-url>
cd ecosif-ia-services
cd ecosif-structure

Passo 2: Configurar Variáveis

# Executar script interativo
python3 scripts/setup-env.py

O script irá: - ✅ Criar .env se não existir - ✅ Mostrar valores atuais - ✅ Permitir configurar variáveis - ✅ Gerar senhas automaticamente (opcional)

Passo 3: Iniciar Serviços

Desenvolvimento:

./scripts/start.sh --dev

Produção:

./scripts/start.sh

Passo 4: Verificar

# Status
./scripts/status.sh

# Logs
./scripts/logs.sh --follow

📖 Instalação Detalhada

1. Preparação do Ambiente

1.1 Clonar Repositórios

# Repositório principal
git clone <repo-url>
cd ecosif-ia-services/ecosif-structure

# Atualizar submodules (se houver)
./scripts/update-submodules.sh

1.2 Verificar Requisitos

# Verificar Docker
docker ps

# Verificar portas disponíveis
netstat -tulpn | grep -E ':(80|443|8080|5432)'

2. Configuração de Variáveis

2.1 Executar Configurador

python3 scripts/setup-env.py

2.2 Variáveis Obrigatórias

Durante a execução do script, configure:

1. POSTGRES_DB: Nome do banco de dados - Exemplo: ecosif ou ecosif_prod

2. POSTGRES_USER: Usuário PostgreSQL - Exemplo: postgres ou ecosif_user

3. POSTGRES_PASSWORD: Senha do PostgreSQL - IMPORTANTE: Use senha forte - Pode ser gerada automaticamente

4. AUTH_TOKEN_SECRET: Chave secreta JWT - CRÍTICO: Mínimo 32 caracteres - Deve ser a mesma em todos os serviços - Pode ser gerada automaticamente

5. ECOSIF_DOMAIN: Domínio base - Desenvolvimento: localhost - Produção: ecosif.cliente.com

6. ECOSIF_API_BASE_URL: URL completa - Desenvolvimento: http://localhost - Produção: https://ecosif.cliente.com

2.3 Verificar Configuração

# Verificar arquivo .env criado
cat .env | grep -v PASSWORD | grep -v SECRET

# Verificar se senhas foram geradas
cat .env | grep -E "(PASSWORD|SECRET)" | head -c 50

3. Inicialização do Banco de Dados

3.1 Iniciar PostgreSQL

# Iniciar apenas PostgreSQL
./scripts/start.sh postgres

# Aguardar inicialização (30 segundos)
sleep 30

3.2 Inicializar Banco

# Executar script de inicialização
./scripts/init-database.sh

Este script: - ✅ Cria banco de dados - ✅ Cria usuário - ✅ Aplica migrations do Flyway - ✅ Insere dados iniciais (usuário admin)

4. Iniciar Todos os Serviços

Modo Desenvolvimento

# Iniciar em modo desenvolvimento
./scripts/start.sh --dev

# Ou com rebuild das imagens
./scripts/start.sh --dev --build

Modo Produção

# Iniciar em modo produção
./scripts/start.sh

# Ou com rebuild
./scripts/start.sh --build

5. Verificação Pós-Instalação

5.1 Verificar Status

# Status geral
./scripts/status.sh

# Logs em tempo real
./scripts/logs.sh --follow

5.2 Testar Acessos

Modo Desenvolvimento:

# Frontend
curl http://localhost

# API Auth
curl http://localhost/ecosif-auth/actuator/health

# Health checks
curl http://localhost:8080/ecosif-auth/actuator/health

Modo Produção:

# Frontend (HTTPS)
curl -k https://seu-dominio.com

# API Auth (HTTPS)
curl -k https://seu-dominio.com/ecosif-auth/actuator/health

🔧 Pós-Instalação

Configurar Usuário Admin

Após inicialização, acesse: - URL: http://localhost/ecosif-auth (dev) ou https://seu-dominio.com/ecosif-auth (prod) - Credenciais padrão: Verificar no script init-database.sh

Configurar SSL (Apenas Produção)

Ver guia: traefik/README-HTTPS.md

🐛 Troubleshooting

Erro: "Porta já em uso"

# Verificar qual processo está usando a porta
sudo lsof -i :80
sudo lsof -i :443

# Parar processo ou mudar porta no .env

Erro: "Container não inicia"

# Ver logs detalhados
./scripts/logs.sh [service_name]

# Verificar variáveis
docker-compose config

Erro: "Banco de dados não conecta"

# Verificar se PostgreSQL está rodando
docker ps | grep postgres

# Testar conexão
docker exec -it postgres psql -U postgres -d ecosif

Última Atualização: 2025-12-01