Arquitetura e Tecnologias

Todas as configurações são centralizadas através de arquivos de config em src/config/ e acessadas via ConfigService. As variáveis de ambiente são carregadas automaticamente.

constructor(private configService: ConfigService) {}

// Acessar configuração
const mongoUri = this.configService.get('database.mongoUri');
const redisHost = this.configService.get('redis.host');
const jwtSecret = this.configService.get('jwt.secret');

Como Funciona

O sistema de cache utiliza Redis como camada intermediária para armazenar resultados de consultas frequentes, reduzindo a carga nos bancos de dados e melhorando o tempo de resposta.

REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0
REDIS_TTL=3600  # Time to Live em segundos

Fluxo de Cache

1. Requisição chega ao interceptor de cache
2. Interceptor verifica se existe chave no Redis
3. Se existe: retorna dados do cache (cache hit)
4. Se não existe: executa query no banco, armazena no Redis e retorna (cache miss)
5. Dados expiram automaticamente após TTL configurado

Padrão do template

O template mantém MongoDB e PostgreSQL no stack. Cada domínio pode ter dois repositórios; o service escolhe um banco ou ambos (CQRS). Não há split command/query obrigatório — a escolha é por módulo.

Connection pools

Ambas as conexões usam pool explícito (config em database.config.ts). O endpoint GET /health inclui metadados do pool nos checks de postgres e mongo.

POSTGRES_POOL_MAX=10
POSTGRES_POOL_MIN=2
POSTGRES_POOL_IDLE=30000
POSTGRES_POOL_TIMEOUT=5000

MONGO_POOL_MAX=10
MONGO_POOL_MIN=0
MONGO_POOL_IDLE=30000
MONGO_POOL_TIMEOUT=5000

Exemplo: um banco só

constructor(
  private readonly postgresRepo: ResourcePostgresRepository,
) {}

async create(data: CreateResourceDto) {
  return this.postgresRepo.create(data);
}

async findAll() {
  return this.postgresRepo.findAll();
}

Exemplo: ativar CQRS

Injete ambos os repositórios no service: commands em um banco, queries no outro. Opcionalmente sincronize com Kafka para consistência eventual.

constructor(
  private readonly mongoRepo: ResourceMongoRepository,      // commands
  private readonly postgresRepo: ResourcePostgresRepository, // queries
) {}

async create(data: CreateResourceDto) {
  const resource = await this.mongoRepo.create(data);
  // publicar evento Kafka para projetar no Postgres...
  return resource;
}

async findAll() {
  return this.postgresRepo.findAll();
}

• NestJS ↔ MongoDB/PostgreSQL: Framework se comunica com bancos através de Mongoose e TypeORM; o service escolhe qual repositório usar
• NestJS ↔ Redis: Cache interceptors utilizam Redis para armazenar resultados
• NestJS ↔ Kafka: Eventos e mensagens são publicados/consumidos via Kafka (útil para projetar dados em CQRS)
• NestJS ↔ MinIO: Upload e download de arquivos via API S3-compatible
• NestJS ↔ Graylog: Logs estruturados via GELF HTTP (interceptor + exception filter)
• MongoDB ↔ PostgreSQL (opcional): Em um desenho CQRS, sincronização via eventos Kafka ou processos assíncronos