📘 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¶

Software	Versão Mínima	Como Instalar
Docker	20.10+	Instruções
Docker Compose	2.0+	Incluído no Docker Desktop
Python	3.8+	Instruções
Git	2.0+	Instruções

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:

POSTGRES_DB: Nome do banco de dados
Exemplo: ecosif ou ecosif_prod
POSTGRES_USER: Usuário PostgreSQL
Exemplo: postgres ou ecosif_user
POSTGRES_PASSWORD: Senha do PostgreSQL
IMPORTANTE: Use senha forte
Pode ser gerada automaticamente
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
ECOSIF_DOMAIN: Domínio base
Desenvolvimento: localhost
Produção: ecosif.cliente.com
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