Repository navigation
Glossario
jota edited this page Aug 25, 2026
·
1 revision
⬅ 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 |