Destrinchando o NestJS: do zero ao primeiro endpoint Directus

📂 meu-projeto
├── 📁 src
│ ├── 📁 users
│ │ ├── users.controller.ts
│ │ ├── users.service.ts
│ │ └── users.module.ts
│ ├── app.module.ts
│ ├── app.controller.ts
│ ├── app.service.ts
│ └── main.ts
├── .env
├── package.json
└── tsconfig.json

4️⃣ Entendendo os Módulos

📦 Conceito Fundamental

Os módulos no NestJS são a unidade organizacional fundamental do framework, representando um mecanismo de encapsulamento e organização que define como os componentes da aplicação se relacionam e interagem entre si.

🧩 Definição Conceitual

Um módulo no NestJS é essencialmente um contêiner lógico que agrupa funcionalidades relacionadas, fornecendo um contexto isolado onde providers, controllers, middlewares e outros elementos podem ser organizados de forma coesa.

⚙️ Características Fundamentais

1. Encapsulamento
   Cria fronteiras bem definidas entre diferentes partes da aplicação.
2. Injeção de Dependência Contextualizada
   Cada módulo possui seu próprio contexto de DI.
3. Composição Hierárquica
   Existe um módulo raiz que importa os demais módulos.

🏗️ Elementos Estruturais

Cada módulo é definido com o decorator @Module():

• imports → módulos dependentes
• controllers → controladores do módulo
• providers → serviços disponíveis
• exports → o que pode ser reutilizado por outros módulos

5️⃣ O que é Injeção de Dependência

👉 Conceito que ajuda a manter o código organizado, escalável e fácil de testar.

"A injeção de dependência é um padrão que permite que objetos recebam suas dependências de fontes externas, ao invés de criá-las internamente."

6️⃣ Lifecycle do NestJS

O ciclo de vida define como o Nest lida com instâncias, inicialização e destruição.

🔁 Principais hooks:

• onModuleInit()
• onApplicationBootstrap()
• onModuleDestroy()
• beforeApplicationShutdown()

7️⃣ Controllers

🎯 São os pontos de entrada da sua API

Responsáveis por:

• Receber requisições HTTP
• Validar dados de entrada
• Chamar os services apropriados
• Retornar respostas

8️⃣ Services

🧠 Onde fica a lógica de negócio

Responsabilidades:

• Implementar regras de negócio
• Interagir com banco de dados
• Processar dados
• Integrar com APIs externas

9️⃣ Porta da aplicação

Por padrão, o NestJS roda em:

http://localhost:3000

DATABASE_URL=postgresql://user:password@localhost:5432/mydb
JWT_SECRET=minha-chave-secreta
PORT=3000