Pular para conteúdo

Aprender

Esta seção é explicação, no sentido de Diátaxis: contexto e raciocínio, sem instrução nenhuma misturada, sem fato específico deste serviço. Se você já conhece os conceitos abaixo, pule direto pra Arquitetura, que mostra como este serviço real os usa, ou pra Operação, o roteiro executável.

Se você precisa entender Vá pra
Por que o código é organizado em camadas, e o vocabulário de DDD/CQRS Arquitetura hexagonal, DDD e CQRS
Module, Controller, Provider, e a esteira que toda requisição atravessa NestJS
Como um objeto de código vira linha de tabela, migração, soft delete, transação ORM, migrações e transações
JWT, JWKS, OAuth2 e OIDC Autenticação
REST, GraphQL e o objeto que só transporta dado REST, GraphQL e DTO
Fila de mensagens entre serviços, RPC vs. fire-and-forget Message broker
Container vs. máquina virtual, bind mount, Docker Compose Containers e Docker
Os quatro tipos de documentação técnica, e por que misturá-los confunde o leitor Diátaxis
Documentação versionada e revisada como código, em vez de wiki solto Documentação como código
Origem das regras de redação adotadas neste site (ISO, ABNT, Acordo Ortográfico) Normas de redação técnica
flowchart LR
    Aprender[Aprender: explicação geral] --> Arquitetura[Arquitetura: referência deste serviço]
    Arquitetura --> Operacao[Operação: tutorial e how-to guide]