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.

  1. InterfaceCLI e JavaFX, lado a lado
  2. Controllerautenticação e operações do sistema acadêmico
  3. Serviçoturmas, avaliações, relatórios e a escolha da persistência
  4. RepositórioTXT, XML ou JSON, trocáveis sem mexer no serviço
  5. Modeloo domínio, validado com Jakarta Bean Validation
As camadas, de cima para baixo. As duas interfaces chegam à mesma regra de negócio.

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.