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]