O problema
Um sistema acadêmico parece simples até a segunda interface. Aí a regra de negócio, que estava escondida na tela, precisa existir em dois lugares — e normalmente é copiada. O mesmo acontece com persistência: o primeiro formato vira premissa e trocá-lo depois vira reescrita.
O trabalho pedia, além disso, crescer por entregas incrementais — uma história de usuário por vez, ao longo do projeto — sem que cada entrega transformasse a anterior em dívida.
O que eu fiz
Uma aplicação em camadas onde a interface é a parte descartável.
CLI e JavaFX falam com a mesma camada de serviço. Trocar ou acrescentar uma interface não arrasta o domínio junto — que era exatamente a hipótese a ser provada.
- InterfaceCLI e JavaFX, lado a lado
- Controllerautenticação e operações do sistema acadêmico
- Serviçoturmas, avaliações, relatórios e a escolha da persistência
- RepositórioTXT, XML ou JSON, trocáveis sem mexer no serviço
- Modeloo domínio, validado com Jakarta Bean Validation
O controle de acesso é RBAC, com autenticação, autorização por papel, sessão e logout. A persistência fica atrás de repositórios, com estratégias intercambiáveis para TXT, XML e JSON: o formato deixou de ser uma decisão irreversível.
Validação de domínio com Jakarta Bean Validation, log estruturado com SLF4J e Logback, e testes com JUnit Jupiter e Mockito onde uma mudança pode quebrar o sistema de verdade. Docker dá um ambiente reproduzível e quatro workflows no GitHub Actions cuidam de CI, validação de pull request, publicação da imagem e release.
Sobre o fork — o que é meu
Este repositório é um fork de
pagliares/academic-system-semester-assignment-2026,
o repositório inicial da disciplina de Programação Orientada a Objetos da UNIFAL-MG.
Trabalhar sobre o fork era o formato exigido pelo trabalho, e a relação é mantida
de propósito.
O ponto de partida era um esqueleto Maven: pom.xml, .gitignore, LICENSE, um
README de exemplo e uma classe Main vazia — dez arquivos.
Todo o resto foi escrito por mim: 59 classes de aplicação, 14 classes de teste, o
Dockerfile e os quatro workflows, além das mudanças no pom.xml e no .gitignore.
São 88 arquivos e cerca de 3.700 linhas acrescentadas em 13 commits sobre o esqueleto.
O modelo de domínio, a arquitetura em camadas, o RBAC, as três persistências, os
relatórios, a interface JavaFX e a suíte de testes fazem parte desse trabalho.
Stack
Java SE 25, Maven, Lombok, Jakarta Bean Validation, JUnit Jupiter, Mockito, SLF4J com Logback, JavaFX, Docker e GitHub Actions.
Resultado
Concluído. Foi o trabalho do terceiro período, entregue e avaliado pelo professor da disciplina, e não há mudanças previstas.
É o retrato mais completo de como eu organizo software: regra de negócio separada da interface, decisões explícitas, e o tipo de teste que impede uma refatoração de passar despercebida. A aposta principal — trocar de interface sem arrastar o domínio junto — foi cobrada na prática quando o JavaFX entrou depois da CLI, e se sustentou.