adelsonsljunior / adelsonsljunior/fastapi-cicd

Refatorar estrutura do projeto

Offen
#25 0 Kommentare 0 Reaktionen 1 zugewiesene Person Beansprucht von @adelsonsljunior Auf GitHub ansehen
enhancement
Vorherrschende Sprache
Python
Sterne
1
Forks
0
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Beschreibung

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

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

Bewertung

Dieses Issue wurde noch nicht bewertet.

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.