adelsonsljunior / adelsonsljunior/fastapi-cicd

Refatorar estrutura do projeto

オープン
#25 コメント 0 件 リアクション 0 件 担当者 1 名 @adelsonsljunior が担当を希望しています GitHub で見る
enhancement
主要言語
Python
スター
1
フォーク
0
PR マージ指標
30日以内にマージされた PR はありません

説明

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

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

評価

この issue はまだ評価されていません。

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。