# 🐳 Docker Setup Guide - Task Manager Backend

## 📋 Pré-requisitos

Você precisa ter instalado:
- ✅ [Docker Desktop](https://www.docker.com/products/docker-desktop)
- ✅ [Docker Compose](https://docs.docker.com/compose/install/) (vem com Docker Desktop)

**Verificar instalação:**
```bash
docker --version
docker-compose --version
```

---

## 🚀 Quick Start

### 1. Build da Imagem Docker

```bash
# Navegar para o diretório do projeto
cd c:\Users\Erik Silva\Documents\projetos\to-do-list

# Fazer build da imagem (primeira vez)
docker build -t todolist-backend:latest ./backend-api
```

**Esperado:**
```
[+] Building 45.3s (15/15) FINISHED
 => => naming to docker.io/library/todolist-backend:latest
```

### 2. Rodar o Container

#### Opção A: Com Docker Compose (RECOMENDADO)

```bash
# Iniciar todos os serviços
docker-compose up -d

# Ver logs
docker-compose logs -f backend

# Parar serviços
docker-compose down
```

#### Opção B: Direto com Docker

```bash
# Rodar container
docker run -d \
  --name todolist-backend \
  -p 3000:3000 \
  -e SUPABASE_URL=https://seu-projeto.supabase.co \
  -e SUPABASE_ANON_KEY=sua-anon-key \
  -e SUPABASE_SERVICE_KEY=sua-service-key \
  -e JWT_SECRET=sua-chave-secreta-32-chars \
  todolist-backend:latest

# Ver logs
docker logs -f todolist-backend

# Parar container
docker stop todolist-backend
docker rm todolist-backend
```

### 3. Testar a API

```bash
# Health check
curl http://localhost:3000/api

# Criar usuário
curl -X POST http://localhost:3000/api/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"test@example.com","password":"Test123456"}'
```

---

## 📦 Estrutura do Dockerfile

```dockerfile
STAGE 1: BUILDER (Multi-stage)
├── Node 20 Alpine
├── npm ci (instalar dependências)
├── npm run build (compilar TypeScript)

STAGE 2: RUNNER (Otimizado para produção)
├── Node 20 Alpine (imagem limpa)
├── npm ci --only=production (sem devDependencies)
├── Usuário não-root (nodejs)
├── Health check configurado
└── 150-200 MB de tamanho final
```

---

## 🔧 Configuração com Variáveis de Ambiente

### Arquivo `.env` (LOCAL)

```bash
# Copiar template
cp backend-api/.env.example backend-api/.env

# Editar com seus valores
nano backend-api/.env
```

**Conteúdo de exemplo:**
```env
NODE_ENV=development
PORT=3000
API_PREFIX=/api

# Supabase
SUPABASE_URL=https://abcdefghijk.supabase.co
SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
SUPABASE_SERVICE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

# JWT
JWT_SECRET=sua-chave-secreta-com-minimo-32-caracteres
JWT_EXPIRATION=7d
```

### Variáveis em `docker-compose.yml`

```yaml
environment:
  NODE_ENV: development
  SUPABASE_URL: ${SUPABASE_URL:-default-value}
  # ... outras variáveis
```

**Usar arquivo `.env` (NÃO recomendado para produção):**
```bash
docker-compose --env-file backend-api/.env up
```

---

## 📊 Comandos Úteis

### Build e Imagens

```bash
# Fazer build
docker build -t todolist-backend:latest ./backend-api

# Listar imagens
docker images | grep todolist

# Inspecionar imagem
docker inspect todolist-backend:latest

# Remover imagem
docker rmi todolist-backend:latest
```

### Containers

```bash
# Listar containers
docker ps -a

# Ver logs
docker logs todolist-backend
docker logs -f todolist-backend        # Follow (tempo real)
docker logs --tail 50 todolist-backend # Últimas 50 linhas

# Executar comando no container
docker exec -it todolist-backend sh

# Ver recursos utilizados
docker stats todolist-backend

# Remover container
docker rm todolist-backend
```

### Docker Compose

```bash
# Iniciar
docker-compose up              # foreground
docker-compose up -d           # background

# Ver status
docker-compose ps

# Ver logs
docker-compose logs -f backend
docker-compose logs backend --tail 50

# Recriar containers
docker-compose restart

# Remover tudo
docker-compose down            # para containers
docker-compose down -v         # remove também volumes
```

---

## 🔍 Health Check

O Dockerfile inclui um health check automático:

```bash
# Ver status
docker inspect --format='{{json .State.Health}}' todolist-backend

# Esperado:
# {"Status":"healthy","FailingStreak":0,"Passes":1,"Fails":0}
```

---

## 🚀 Otimizações

### Tamanho da Imagem

```bash
# Verificar tamanho
docker images todolist-backend

# REPOSITORY              TAG       SIZE
# todolist-backend        latest    180MB

# Reduzir size:
# - Alpine Linux: 180MB (atual) vs 900MB (sem alpine)
# - Multi-stage build: elimina dependências de build
```

### Performance

```bash
# npm ci vs npm install
# - npm ci: mais rápido, dependências exatas
# - Ideal para CI/CD e Docker

# .dockerignore
# - Reduz contexto de build
# - Evita copiar arquivos desnecessários
```

---

## ⚠️ Troubleshooting

### Erro: "Cannot find module"

```bash
# Problema: node_modules não instalado no container
# Solução:
docker-compose down
docker-compose build --no-cache
docker-compose up
```

### Erro: "EADDRINUSE: address already in use :::3000"

```bash
# Problema: Porta 3000 já está em uso
# Solução 1: Usar porta diferente
docker run -p 3001:3000 todolist-backend:latest

# Solução 2: Matar processo que está usando porta 3000
lsof -i :3000
kill -9 <PID>
```

### Erro: Variáveis de ambiente não funcionam

```bash
# Problema: .env não está sendo lido
# Solução: Usar docker-compose ou passar com -e

# ❌ Não funciona:
docker run todolist-backend:latest

# ✅ Funciona:
docker run -e SUPABASE_URL=... todolist-backend:latest
docker-compose up # lê .env automaticamente
```

### Health check falhando

```bash
# Verificar logs
docker logs todolist-backend

# Testar manualmente
docker exec todolist-backend curl http://localhost:3000/api

# Se falhar, a API não está respondendo
# Verificar: .env, credenciais Supabase, conexão de rede
```

---

## 📚 Referências

- 📖 [Docker Docs](https://docs.docker.com/)
- 📖 [Docker Compose Guide](https://docs.docker.com/compose/)
- 📖 [Best Practices](https://docs.docker.com/develop/dev-best-practices/)
- 🐳 [Alpine Linux](https://hub.docker.com/_/alpine) - Imagem base

---

## ✅ Próximos Passos

1. ✅ Dockerfile criado e testado
2. ➡️ Fazer commit (`feat(docker): Add Dockerfile and docker-compose`)
3. ➡️ Frontend Next.js (Fase 2) - **Próximo grande passo**

---

**Status**: 🐳 Docker ready for local development e produção!