adelsonsljunior / adelsonsljunior/fastapi-cicd

Refatorar estrutura do projeto

Aperta
#25 0 commenti 0 reazioni 1 assegnatario Rivendicata da @adelsonsljunior Vedi su GitHub
enhancement
Lingua principale
Python
Stelle
1
Fork
0
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

## Contexto

Atualmente o projeto segue uma arquitetura `Model <-> Controller`, na qual o Controller acumula tanto a lógica de negócio quanto o acesso direto aos dados. Isso mistura responsabilidades em uma mesma camada, dificultando testes, manutenção e reuso.

## Objetivo

Migrar para uma arquitetura em camadas `Repository <-> Service <-> Controller`, com separação clara de responsabilidades:

- **Repository** — responsável **exclusivamente** pelo acesso a dados (queries, persistência, mapeamento com o ORM). Não contém regra de negócio.
- **Service** — concentra as **regras de negócio** e orquestra chamadas ao Repository. Não conhece detalhes de HTTP.
- **Controller** — responsável apenas por **receber a requisição e devolver a resposta** (parsing de entrada, validação de request, serialização de saída, status codes). Delega toda a lógica ao Service.

## Critérios de aceite

- Nenhum acesso a banco/ORM fora da camada Repository.
- Nenhuma regra de negócio no Controller.
- Controller não instancia Repository diretamente — depende do Service.

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.