Skip to content

Glossario

jota edited this page Aug 25, 2026 · 1 revision

Glossário

⬅ Voltar para Documentação de Arquitetura

Termo Definição
AAA Pattern Arrange-Act-Assert: padrão de estruturação de testes dividido em 3 etapas (preparar, executar, verificar)
CI/CD Continuous Integration/Continuous Deployment: prática de integração e deploy contínuos com validação automatizada
Cobertura de Código Métrica que indica percentual de código executado durante testes automatizados
Dependency Injection (DI) Padrão de design onde dependências são fornecidas externamente ao invés de criadas internamente, facilitando testes
E2E (End-to-End) Testes que validam fluxo completo do sistema, do endpoint HTTP até o banco de dados
Flaky Test Teste instável que falha intermitentemente sem mudanças no código, geralmente por não-determinismo
Mock Objeto que simula comportamento de dependência real, usado para isolar código em testes
Ports & Adapters Padrão arquitetural (Hexagonal Architecture) que separa lógica de negócio de detalhes de infraestrutura via interfaces
Stub Tipo de test double que retorna dados pré-definidos, mais simples que mocks
Test Double Termo genérico para objetos que substituem dependências reais em testes (mocks, stubs, spies, fakes)
Test Factory Padrão de criação de objetos de teste com dados válidos por padrão, reduzindo duplicação de código
Test Isolation Princípio de que cada teste deve ser independente e não afetar outros testes
Testes de Contrato Testes que validam se a interface entre sistemas externos permanece compatível
Testes Unitários Testes que validam pequenas unidades de código (funções, métodos) de forma isolada
JWT JSON Web Token: padrão de token para autenticação stateless
DTO Data Transfer Object: objeto que transporta dados entre camadas, usado para validação de entrada
ORM Object-Relational Mapping: framework que mapeia objetos para tabelas de banco de dados (ex: Prisma)
CRON Job Tarefa agendada que executa automaticamente em intervalos definidos
Clean Architecture Arquitetura em camadas que separa lógica de negócio de frameworks e infraestrutura
Prisma ORM TypeScript-first utilizado no projeto para acesso ao PostgreSQL
NestJS Framework Node.js para construção de aplicações server-side escaláveis
Supertest Biblioteca para testes de APIs HTTP em Node.js
Jest Framework JavaScript para testes unitários e E2E
DRY Don't Repeat Yourself: princípio de evitar duplicação de código através de abstração e reutilização
SRP Single Responsibility Principle: cada classe/módulo deve ter uma única responsabilidade
DIP Dependency Inversion Principle: depender de abstrações (interfaces) ao invés de implementações concretas
SOLID Conjunto de 5 princípios de design orientado a objetos (SRP, OCP, LSP, ISP, DIP)
KISS Keep It Simple, Stupid: princípio de manter soluções simples e evitar complexidade desnecessária
YAGNI You Aren't Gonna Need It: não implementar funcionalidades até que sejam realmente necessárias
TDD Test-Driven Development: metodologia de desenvolver testes antes do código de produção
Refactoring Processo de melhorar estrutura interna do código sem alterar comportamento externo
Code Smell Indicador de possível problema no código que merece atenção (ex: funções muito longas, duplicação)
Path Alias Atalho de importação (ex: @/application) que simplifica caminhos relativos no código
Clean Code Conjunto de práticas para escrever código legível, simples e fácil de manter
Git Hooks Scripts automatizados que executam em eventos específicos do Git (commit, push, merge) para validações personalizadas
Husky Ferramenta Node.js que facilita configuração e gerenciamento de Git Hooks em projetos JavaScript/TypeScript
Pre-commit Hook do Git que executa antes de finalizar um commit, usado para validar código antes de salvá-lo no histórico
Pre-push Hook do Git que executa antes de enviar commits ao repositório remoto, última validação local antes do push
--no-verify Flag do Git que ignora execução de hooks configurados (bypass), deve ser usado apenas em emergências
Time-to-Market Tempo entre a concepção de uma ideia/produto e sua disponibilização ao mercado; quanto menor, mais rápido o feedback
Load Balancer Componente que distribui tráfego entre múltiplas instâncias de uma aplicação, garantindo disponibilidade e performance
Stateless Arquitetura onde o servidor não armazena estado de sessão; cada requisição contém todas as informações necessárias
Stateful Arquitetura onde o servidor mantém estado de sessão entre requisições (oposto de stateless)
Connection Pooling Técnica de reutilizar conexões de banco de dados ao invés de criar novas a cada requisição, melhorando performance
Query N+1 Anti-pattern onde uma query principal gera N queries adicionais, causando problemas de performance
Soft Delete Técnica de marcar registros como deletados (flag deleted_at) ao invés de removê-los fisicamente do banco
Hard Delete Remoção física de registros do banco de dados (DELETE FROM), sem possibilidade de recuperação
Prepared Statement Query SQL pré-compilada com placeholders, prevenindo SQL injection e melhorando performance
SQL Injection Ataque onde código SQL malicioso é inserido em inputs para manipular ou acessar banco de dados indevidamente
XSS Cross-Site Scripting: ataque que injeta scripts maliciosos em páginas web para roubar dados ou executar ações não autorizadas
CORS Cross-Origin Resource Sharing: mecanismo de segurança que controla quais domínios podem acessar recursos da API
ACID Atomicidade, Consistência, Isolamento, Durabilidade: propriedades que garantem confiabilidade de transações em bancos de dados
Migration Script versionado que altera schema do banco de dados de forma controlada e rastreável
Seed Script que popula banco de dados com dados iniciais para desenvolvimento ou testes
Schema Estrutura de tabelas, colunas, índices e relacionamentos do banco de dados
Foreign Key Restrição que garante integridade referencial entre tabelas relacionadas no banco de dados
SMTP Simple Mail Transfer Protocol: protocolo para envio de emails
TLS Transport Layer Security: protocolo de criptografia para comunicação segura em redes (sucessor do SSL)
SSL Secure Sockets Layer: protocolo antigo de criptografia, substituído pelo TLS (mas termo ainda usado)
MIME Multipurpose Internet Mail Extensions: padrão para formatar emails com conteúdo HTML, anexos, etc.
LGPD Lei Geral de Proteção de Dados (Lei 13.709/2018): legislação brasileira sobre privacidade e proteção de dados pessoais
PII Personally Identifiable Information: dados que podem identificar uma pessoa (nome, CPF, email, etc.)
Hash Função criptográfica que transforma dados em string fixa e irreversível, usada para armazenar senhas com segurança
Salt Dado aleatório adicionado a senhas antes do hash para prevenir ataques com rainbow tables
Rainbow Table Tabela pré-computada de hashes comuns usada para quebrar senhas fracas rapidamente
Brute Force Ataque que tenta todas as combinações possíveis para quebrar senha ou criptografia
Token String única e temporária usada para autenticação, reset de senha, ou autorização de ações específicas
Bearer Token Tipo de token de autorização enviado no header HTTP Authorization: Bearer <token>
Payload Dados úteis transportados em requisição HTTP, token JWT, ou mensagem de fila
Endpoint URL específica de uma API que aceita requisições HTTP (ex: POST /api/v1/users)
RESTful API que segue princípios REST: recursos identificados por URLs, verbos HTTP semânticos, stateless
Idempotente Operação que pode ser executada múltiplas vezes sem alterar resultado além da primeira execução (ex: GET, PUT, DELETE)
Webhook Callback HTTP que notifica sistema externo sobre eventos (ex: GitHub Actions notifica CI/CD sobre push)
Multi-Stage Build Técnica de Docker que usa múltiplos FROM para reduzir tamanho final da imagem, separando build de produção
Container Unidade de software que empacota aplicação e suas dependências de forma isolada e portável
Image Template imutável usado para criar containers Docker, contém código e runtime
Registry Repositório de imagens Docker (ex: Docker Hub, GitHub Container Registry, AWS ECR)
Orchestration Gerenciamento automatizado de múltiplos containers (deploy, scaling, networking) via ferramentas como Kubernetes
Horizontal Scaling Adicionar mais instâncias da aplicação para lidar com carga crescente (scale-out)
Vertical Scaling Aumentar recursos (CPU, RAM) de uma única instância para lidar com carga crescente (scale-up)
Monolith Aplicação única e indivisível onde todos os módulos rodam no mesmo processo
Microservices Arquitetura onde sistema é dividido em múltiplos serviços independentes que se comunicam via rede
Event-Driven Arquitetura onde componentes se comunicam via eventos assíncronos ao invés de chamadas síncronas
Pub/Sub Publish/Subscribe: padrão onde produtores publicam eventos e consumidores se inscrevem para recebê-los
Message Queue Fila de mensagens que permite comunicação assíncrona entre serviços (ex: RabbitMQ, Redis, Kafka)
DLQ Dead Letter Queue: fila de mensagens que falharam após múltiplas tentativas de processamento
Retry Logic Lógica que tenta reexecutar operação falhada após intervalo de tempo, com limite de tentativas
Exponential Backoff Estratégia de retry onde intervalo entre tentativas aumenta exponencialmente (1s, 2s, 4s, 8s...)
BusinessException Exception customizada para erros de regra de negócio, padroniza respostas e facilita testes/internacionalização
Logger Estruturado Logger que emite logs em formato JSON, facilitando análise, filtragem e ingestão por ferramentas de observabilidade
Sanitização de Logs Processo de ofuscar dados sensíveis (senhas, tokens, CPF) nos logs para conformidade com LGPD e segurança
Helmet Middleware para configurar headers de segurança HTTP, protege contra vulnerabilidades comuns
PrismaExceptionFilter Filtro global que traduz erros do Prisma ORM em respostas HTTP padronizadas, facilitando tratamento de erros de banco de dados
handlePrismaError Utilitário centralizado para tratamento de erros do Prisma, converte códigos de erro em BusinessException ou EntityNotFoundException
isPrismaError Type guard que verifica se um erro é do tipo PrismaError, usado em conjunto com handlePrismaError
PrismaErrorCode Enum com códigos de erro conhecidos do Prisma (P2002, P2025, P2003, P2004), facilita referência type-safe aos códigos
EntityNotFoundException Exception customizada para entidades de domínio não encontradas, retorna HTTP 404 com mensagem descritiva incluindo ID
Circuit Breaker Padrão que previne cascata de falhas ao desligar temporariamente comunicação com serviço instável
Saga Pattern Padrão para transações distribuídas em microserviços, coordenando operações via eventos ou orquestração
2PC Two-Phase Commit: protocolo de transação distribuída que garante atomicidade em múltiplos bancos de dados
CAP Theorem Teorema que afirma ser impossível ter simultaneamente Consistência, Disponibilidade e Tolerância a Partições em sistemas distribuídos
Eventual Consistency Modelo onde dados podem ficar inconsistentes temporariamente, mas eventualmente convergem para estado consistente
MVP Minimum Viable Product: versão mínima de produto com funcionalidades essenciais para validar hipótese com usuários
Tech Debt Technical Debt: custo acumulado de escolhas técnicas rápidas que sacrificam qualidade e exigem refatoração futura
Overfetching Problema REST onde API retorna mais dados que o necessário, desperdiçando banda e processamento
Underfetching Problema REST onde API retorna menos dados que o necessário, exigindo múltiplas requisições
GraphQL Linguagem de query para APIs que permite cliente especificar exatamente quais dados deseja, resolvendo over/underfetching
SPF Sender Policy Framework: protocolo de email que valida se servidor está autorizado a enviar emails por domínio
DKIM DomainKeys Identified Mail: assinatura criptográfica que autentica domínio remetente de email
Fábrica de Software Ambiente educacional do IFPE onde alunos desenvolvem e mantêm sistemas reais para aplicar conhecimentos de engenharia de software
Invite Convite enviado por uma associação para um produtor se juntar à plataforma, contém token único e expiração em 7 dias
User Produtor ou gestor que utiliza a plataforma QuaLeiDer para gerenciar dados de produção de leite
Animal Animal cadastrado na plataforma, associado a um produtor, com informações de saúde e produção
DailyCollection Registro diário de coleta de leite, vinculado a um produtor e possivelmente a múltiplos animais
Association Entidade que representa uma cooperativa ou grupo de produtores, pode gerenciar usuários e visualizar dados agregados
Report Relatório gerado pelo sistema com dados agregados sobre produção de leite, pode ser diário, semanal ou mensal
Notification Alerta enviado por email ou dentro da plataforma para informar sobre eventos como convites, resets de senha, etc.
Cron Job Tarefa agendada que executa ações como limpeza de convites expirados ou envio de lembretes
JWT JSON Web Token, usado para autenticação de usuários na API, expira em 24 horas
Prisma ORM utilizado para acesso ao banco de dados PostgreSQL, fornece uma camada de abstração e segurança adicional
Docker Plataforma de containerização que permite empacotar a aplicação e suas dependências em um ambiente isolado e reproduzível
GitHub Actions Ferramenta de CI/CD que automatiza o processo de testes e deploy da aplicação para o ambiente de produção
Ethereal Serviço de email temporário usado para desenvolvimento e testes, permite enviar emails sem custo
PostgreSQL Sistema de gerenciamento de banco de dados relacional usado para armazenar dados da aplicação
Redis Armazenamento em cache e fila de mensagens, usado para melhorar performance e garantir entrega de mensagens em background
BullMQ Biblioteca para gerenciamento de filas e jobs em background, utilizada para reenvio de emails e processamento de tarefas agendadas
Prometheus Sistema de monitoramento e alerta, usado para coletar métricas da aplicação e infraestrutura
Grafana Plataforma de análise e monitoramento, usada para visualizar métricas coletadas pelo Prometheus
class-validator Biblioteca para validação de objetos e DTOs, utilizada para garantir que dados de entrada estejam no formato correto
bcrypt Biblioteca para hashing de senhas, utilizada para proteger senhas de usuários com um hash seguro e único
jsonwebtoken Biblioteca para geração e verificação de tokens JWT, utilizada na autenticação de usuários
nodemailer Biblioteca para envio de emails, utilizada para enviar convites, notificações e links de reset de senha
passport Middleware de autenticação, utilizado para integrar diferentes estratégias de autenticação como JWT e OAuth2
@nestjs/jwt Pacote do NestJS para integração com a biblioteca jsonwebtoken, simplifica o uso de JWT na aplicação
@nestjs/passport Pacote do NestJS para integração com a biblioteca passport, simplifica o uso de autenticação baseada em estratégias
@nestjs/event-emitter Pacote do NestJS para implementação do padrão de eventos (Pub/Sub), utilizado para comunicação assíncrona entre diferentes partes da aplicação
@nestjs/schedule Pacote do NestJS para agendamento de tarefas (CRON jobs), utilizado para executar ações periódicas como limpeza de dados expirados
@willsoto/nestjs-prometheus Pacote para integração do NestJS com o Prometheus, utilizado para expor métricas da aplicação
@nestjs/throttler Pacote do NestJS para implementação de rate limiting, utilizado para proteger rotas contra abusos e ataques de força bruta
Helmet: Middleware para configurar headers de segurança HTTP, protege contra vulnerabilidades comuns.
Rate Limiting (Throttling) Técnica de limitar o número de requisições que um cliente pode fazer à API em um período de tempo, prevenindo abuso e ataques DoS
DoS Denial of Service: ataque que tenta sobrecarregar um sistema tornando-o indisponível para usuários legítimos através de requisições excessivas
TTL (Time To Live) Janela de tempo (ex: segundos ou milissegundos) usada no rate limiting para determinar o período em que as requisições são contadas
X-RateLimit-Limit Header HTTP que informa o número máximo de requisições permitidas em uma janela de tempo
X-RateLimit-Remaining Header HTTP que informa quantas requisições restam na janela de tempo atual antes de atingir o limite
X-RateLimit-Reset Header HTTP que informa o timestamp Unix de quando o contador de requisições será resetado
Retry-After Header HTTP que informa ao cliente quantos segundos deve aguardar antes de tentar fazer uma nova requisição após atingir o limite

Clone this wiki locally