adelsonsljunior / adelsonsljunior/fastapi-cicd

Refatorar estrutura do projeto

Abierto
#25 0 comentarios 0 reacciones 1 asignado Reclamado por @adelsonsljunior Ver en GitHub
enhancement
Lenguaje dominante
Python
Estrellas
1
Forks
0
Métricas de merge de PR
Sin PR fusionados en 30 d

Descripción

## 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.

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.