Separar responsabilidades
Organizar controllers REST, serviços, entidades JPA e DTOs para os recursos de pessoas, categorias e lançamentos.
Todos os projetos01 02 03
05 / SOFTWARE · BACKEND E ORGANIZAÇÃO DOS DADOS
Financial Control API.
API REST de estudo para organizar pessoas, categorias e lançamentos financeiros, com validação e respostas de erro consistentes.
Projeto de estudo · implementação disponível no repositórioAbrir repositório
01 / CONTEXTO
A pergunta de partida
Como estruturar o cadastro e a consulta de receitas e despesas em uma API com responsabilidades claras?
Projeto de estudo e portfólio de backend. Os lançamentos são associados a uma pessoa e a uma categoria; os dados trafegam por DTOs separados das entidades persistidas.
Minha contribuição
O README atribui o desenvolvimento a João Vitor. O repositório disponibiliza controllers, serviços, DTOs, entidades e tratamento centralizado de exceções.
Perguntas investigadas
- Como separar entrada, regras e persistência?
- Como paginar consultas e comunicar erros de validação?
02 / ABORDAGEM
As decisões do caminho
Validar a entrada
Aplicar Bean Validation com @Valid e restrições como @NotBlank e @NotNull nos dados de cadastro.
Padronizar consultas e erros
Usar Pageable nas listagens e @RestControllerAdvice para respostas a entidades não encontradas e entradas inválidas.
03 / ENTREGAS E LEITURAS
O que ficou disponível
- API REST com operações de cadastro, consulta, atualização e exclusão
- Listagens paginadas e DTOs de entrada e saída
- Tratamento centralizado de erros de validação e entidades ausentes
O que a análise documenta
O controller de lançamentos usa paginação com tamanho padrão de dez itens e ordenação por descrição.
O tratamento global diferencia respostas 400 para validação e 404 para recursos não encontrados.
APRENDIZADO EVIDENCIADO
A clareza do contrato da API depende tanto dos caminhos de sucesso quanto da validação das entradas e da forma de comunicar falhas.
04 / EVIDÊNCIAS
Consulte a implementação.
Documentação e código
Fontes consultadas na revisão de 03/11/2026. Os links para arquivos usam a revisão examinada.
05 / LIMITAÇÕES
Até onde as evidências vão
- Autenticação, autorização, documentação Swagger, testes automatizados de negócio e deploy estão listados como próximos passos no README.
- A revisão verificou documentação e código; não executou a API contra um MySQL neste ambiente.
- O projeto não é apresentado como sistema financeiro em produção nem como evidência de impacto empresarial.
Situação documentada
Projeto de estudo · implementação disponível no repositório. Esta descrição se baseia nos artefatos consultados; não estabelece conclusão ou atividade do projeto pela data do último commit.