EventDev Server API

API backend para a plataforma EventDev construída com NestJS, Prisma, PostgreSQL, Redis e SuperTokens.

Setup Rápido

Desenvolvimento

make setup-dev    # Criar .env
make dev-up       # Iniciar containers
make dev-logs     # Ver logs

---

Testes Locais (Simula Produção)

make test-run     # Teste completo da arquitetura
make test-up      # Ambiente de teste local
make test-api     # Testar endpoints da API
make test-down    # Parar ambiente de teste

URLs de Teste:

• HTTP: http://localhost:8080
• HTTPS: https://localhost:8443 (certificado auto-assinado)
• API Direta: http://localhost:5123

Produção

Antes de Tudo: Configurar DNS

  Adicionar Registro (Painel de Domínios)

• Type: A
• Hostname: api.eventdev.org
• Value: IP_DO_SEU_SERVIDOR  

make check-dns    # 1. Verificar DNS
make setup-prod   # 2. Criar .env (editar senhas!)
make prod-up      # 3. Deploy completo

Comandos

Comando	Descrição
make dev-up	Desenvolvimento
make test-run	Teste completo da arquitetura
make test-up	Ambiente de teste local
make prod-up	Produção
make health	Testar API HTTP
make health-https	Testar API HTTPS
make create-networks	Criar redes Docker
make status	Status dos containers
make clean	Limpar tudo

Banco de Dados

Comando	Descrição
make db-migrate	Executar migrações
make db-seed	Popular dados iniciais
make db-studio	Interface visual
make db-reset	Reset completo (dev)

Logs

Comando	Descrição
make dev-logs	Logs desenvolvimento
make prod-logs	Logs produção
make logs-all	Todos os logs

Arquitetura

Ambiente Dev

• Dockerfile.dev simplificado (sem build steps)
• Hot reload e debug port 9229
• Health checks similares ao prod
• Volume mapping para desenvolvimento

Ambiente Prod

• Health checks robustos
• Limites de recursos definidos

URLs de Acesso

Dev

• API: http://localhost:5122
• Health: http://localhost:5122/health
• Debug: localhost:9229

Prod

• API: https://api.eventdev.org
• Health: https://api.eventdev.org/health

Configuração DNS

Configure no provedor DNS:

Tipo: A
Nome: api.eventdev.org
Valor: 192.168.1.100

Verificar: make check-dns

Troubleshooting

DNS não resolve

make check-dns
nslookup api.eventdev.org

Containers não iniciam

make status
make prod-logs
make clean        # Reset completo

Configuração

Dev (.env)

NODE_ENV=development
NODE_PORT=5122
DATABASE_URL="postgresql://user:pass@localhost:5432/eventdev"
REDIS_URL="redis://localhost:6379"

Prod (.env)

NODE_ENV=production
NODE_PORT=5122
DATABASE_URL="postgresql://user:STRONG_PASS@postgres-db:5432/eventdev"
REDIS_URL="redis://redis-cache:6379"
ALLOWED_ORIGINS="https://eventdev.org,https://api.eventdev.org"

Estrutura

EventDev-Server/
├── docker-compose.dev.yml    # Desenvolvimento
├── docker-compose.prod.yml   # Produção
├── Makefile                  # Comandos
├── .docker/
│   └── node/
│       ├── Dockerfile.dev    # Build desenvolvimento
│       └── Dockerfile.prod   # Build produção
├── src/                      # Código fonte
└── prisma/                   # Schema e migrações

Tecnologias

• NestJS: Framework Node.js
• Prisma: ORM TypeScript
• PostgreSQL: Banco relacional
• Redis: Cache e sessões
• SuperTokens: Autenticação
• Docker: Containerização

Deploy

git pull
make prod-down
make prod-up
make health-https

Monitoramento

Health Checks

• API, Database, Cache, Auth
• Checks a cada 30s
• Restart automático

Log Files

make dev-logs | grep ERROR
make prod-logs | grep -i health

Diferenças Dev vs Prod

Aspecto	Dev	Prod
Build	Hot reload	Otimizado
Debug	Port 9229	Disabled
Logs	Verbosos	Estruturados
Resources	Ilimitados	Limitados

Integração

Este backend funciona em conjunto com o EventDev-Front, utilizando redes Docker compartilhadas para comunicação entre os serviços.