# evandro-esd/api-rest-treino architecture

> Architecture diagram of the GitHub repository evandro-esd/api-rest-treino, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/evandro-esd/api-rest-treino
- Repository: https://github.com/evandro-esd/api-rest-treino

## Overview

Esta API REST expõe consulta e CRUD de funcionários, com validações de negócio e respostas HTTP. O fluxo implementado liga servidor, aplicação Express, rotas, controller, service e repositório PostgreSQL. Embora o README descreva persistência em JSON, o service importado usa o repositório PostgreSQL; o repositório JSON existe como implementação alternativa, mas não há evidência de que esteja conectado ao fluxo ativo. As relações abaixo se baseiam no README e nos arquivos amostrados; não inferi ligações para módulos não inspecionados.

Main entry points: [`server.js`](https://github.com/evandro-esd/api-rest-treino/blob/main/server.js) (Servidor HTTP), [`app.js`](https://github.com/evandro-esd/api-rest-treino/blob/main/app.js) (Aplicação Express), [`app/routes/funcionarios.routes.js`](https://github.com/evandro-esd/api-rest-treino/blob/main/app/routes/funcionarios.routes.js) (Rotas de funcionários), [`app/controllers/funcionarios.controller.js`](https://github.com/evandro-esd/api-rest-treino/blob/main/app/controllers/funcionarios.controller.js) (Controller de funcionários)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["Interface HTTP"]
  node_server["Servidor HTTP<br/>[server.js]"]
  node_express["Aplicação Express<br/>[app.js]"]
  node_routes["Rotas de funcionários"]
  node_controller["Controller de funcionários"]
end

subgraph group_business["Regras de negócio"]
  node_service["Service de funcionários"]
end

subgraph group_persistence["Persistência PostgreSQL"]
  node_repository["Repositório PostgreSQL"]
  node_pool["Pool PostgreSQL<br/>[database.js]"]
  node_postgres[("Banco api_rest_treino")]
end

subgraph group_alternate["Persistência JSON alternativa"]
  node_json_repository["Repositório JSON alternativo"]
  node_json_data["Dados JSON<br/>[funcionarios.json]"]
end

node_client(("Cliente da API"))

node_client -->|"envia requisições"| node_server
node_server -->|"inicia"| node_express
node_express -->|"registra"| node_routes
node_routes -->|"despacha"| node_controller
node_controller -->|"invoca operações"| node_service
node_service -->|"invoca operações"| node_repository
node_repository -->|"consulta"| node_pool
node_pool -->|"conecta"| node_postgres
node_json_repository -->|"lê e grava"| node_json_data

click node_server "https://github.com/evandro-esd/api-rest-treino/blob/main/server.js"
click node_express "https://github.com/evandro-esd/api-rest-treino/blob/main/app.js"
click node_routes "https://github.com/evandro-esd/api-rest-treino/blob/main/app/routes/funcionarios.routes.js"
click node_controller "https://github.com/evandro-esd/api-rest-treino/blob/main/app/controllers/funcionarios.controller.js"
click node_service "https://github.com/evandro-esd/api-rest-treino/blob/main/app/services/funcionarios.service.js"
click node_repository "https://github.com/evandro-esd/api-rest-treino/blob/main/app/repositories/funcionarios.repositories.js"
click node_pool "https://github.com/evandro-esd/api-rest-treino/blob/main/app/config/database.js"
click node_json_repository "https://github.com/evandro-esd/api-rest-treino/blob/main/app/repositories/funcionarios.repositoriesForJSON.js"
click node_json_data "https://github.com/evandro-esd/api-rest-treino/blob/main/data/funcionarios.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_express,node_routes,node_controller,node_client toneBlue
class node_service toneAmber
class node_repository,node_pool,node_postgres toneMint
class node_json_repository,node_json_data toneRose
```

## Components

### Interface HTTP

- [Servidor HTTP](https://github.com/evandro-esd/api-rest-treino/blob/main/server.js): `server.js`
- [Aplicação Express](https://github.com/evandro-esd/api-rest-treino/blob/main/app.js): `app.js`
- [Rotas de funcionários](https://github.com/evandro-esd/api-rest-treino/blob/main/app/routes/funcionarios.routes.js): `app/routes/funcionarios.routes.js`
- [Controller de funcionários](https://github.com/evandro-esd/api-rest-treino/blob/main/app/controllers/funcionarios.controller.js): `app/controllers/funcionarios.controller.js`

### Regras de negócio

- [Service de funcionários](https://github.com/evandro-esd/api-rest-treino/blob/main/app/services/funcionarios.service.js): `app/services/funcionarios.service.js`

### Persistência PostgreSQL

- [Repositório PostgreSQL](https://github.com/evandro-esd/api-rest-treino/blob/main/app/repositories/funcionarios.repositories.js): `app/repositories/funcionarios.repositories.js`
- [Pool PostgreSQL](https://github.com/evandro-esd/api-rest-treino/blob/main/app/config/database.js): `app/config/database.js`
- **Banco api_rest_treino**

### Persistência JSON alternativa

- [Repositório JSON alternativo](https://github.com/evandro-esd/api-rest-treino/blob/main/app/repositories/funcionarios.repositoriesForJSON.js): `app/repositories/funcionarios.repositoriesForJSON.js`
- [Dados JSON](https://github.com/evandro-esd/api-rest-treino/blob/main/data/funcionarios.json): `data/funcionarios.json`

### Other components

- **Cliente da API**

## Connections

- Cliente da API → Servidor HTTP: envia requisições (evidence: `README.md`)
- Servidor HTTP → Aplicação Express: inicia (evidence: `server.js`)
- Aplicação Express → Rotas de funcionários: registra (evidence: `app.js`)
- Rotas de funcionários → Controller de funcionários: despacha (evidence: `app/routes/funcionarios.routes.js`)
- Controller de funcionários → Service de funcionários: invoca operações (evidence: `app/controllers/funcionarios.controller.js`)
- Service de funcionários → Repositório PostgreSQL: invoca operações (evidence: `app/services/funcionarios.service.js`)
- Repositório PostgreSQL → Pool PostgreSQL: consulta (evidence: `app/repositories/funcionarios.repositories.js`)
- Pool PostgreSQL → Banco api_rest_treino: conecta (evidence: `app/config/database.js`)
- Repositório JSON alternativo → Dados JSON: lê e grava (evidence: `app/repositories/funcionarios.repositoriesForJSON.js`)
