Animal Care Centre
Plataforma para abrigos de animais: API e app de desktop

Uma plataforma para abrigos de animais: uma API em Spring Boot protegida com Spring Security e uma app de desktop em JavaFX.
- Ano
- 2025
- Tipo
- Backend
- Papel
- Equipa de quatro: co-liderei, setup do projeto, segurança, a app em JavaFX
- Stack
- Java Linguagem
- Spring Boot Framework
- Hibernate ORM
- MySQL Base de dados
- Spring Security Segurança
- JavaFX Interface
A ideia
O Animal Care Centre junta numa só app os abrigos de animais e as pessoas que os querem ajudar. Os abrigos registam os seus animais com fotos e respondem a pedidos de adoção e de acolhimento. Os utilizadores pesquisam animais, adotam ou acolhem um, apadrinham um animal com um valor mensal ou fazem doações a um abrigo. Há também uma secção de perdidos e achados, onde qualquer pessoa pode registar um animal perdido ou um que encontrou. Os administradores aprovam os novos abrigos antes de estes poderem fazer login.
Foi o projeto de Laboratório de Programação no 1.º semestre do 2.º ano, feito por quatro de nós entre outubro e dezembro de 2025, em três componentes. A cadeira tinha outro tema em mente. Fui eu que tive esta ideia, o grupo gostou, e quando a apresentámos a professora adorou.
Liderei o projeto em conjunto com uma colega: ela revia os meus pull requests e eu revia os de todos os outros. Fiz o setup do projeto, a segurança, a app em JavaFX e os seus componentes, e uma grande parte da API.
Três componentes, um backend
As três componentes fazem crescer a mesma app. A primeira corria no terminal e guardava tudo em MySQL através do Hibernate. Na segunda dividimo-la numa API REST em Spring Boot e num cliente que a chama, a nossa primeira vez a trabalhar com cliente e servidor. A terceira trocou esse cliente por uma app em JavaFX, para vermos o mesmo backend a continuar a funcionar com um cliente novo.
Meio terminal, meio JavaFX
Já tínhamos usado JavaFX no 1.º ano como extra e sabíamos que a última componente ia precisar dele, por isso começámos a primeira logo em JavaFX (login, criar conta, mudar a password) sem perguntar. A professora queria o terminal. Como esses ecrãs já estavam feitos, deixou-nos mantê-los para não desperdiçarmos trabalho e pediu o resto no terminal.
Isso significou uma app com duas interfaces ao mesmo tempo, ou seja, duas threads. O JavaFX desenha a janela na sua própria thread, e ler do terminal bloqueia até escreveres alguma coisa, por isso os menus do terminal tinham de correr numa segunda thread, senão a janela congelava. Enquanto um menu estava aberto no terminal, a janela só mostrava um botão de logout, e mudar de menu criava novas threads no terminal enquanto as antigas ainda podiam estar à espera de input. Os dois lados lutavam pelo input e output da consola, e a app crashava vezes sem conta.
A solução foi um pequeno sistema de semáforos. Cada leitura da consola tem primeiro de obter um lock no Scanner partilhado, por isso só uma thread lê de cada vez, e antes de ler a thread verifica se lhe pediram para parar. Abrir um menu novo interrompe a thread do anterior, que pára sem erros, e tudo o que muda a janela volta à thread do JavaFX através do Platform.runLater.
Ninguém faz uma app mista destas de propósito, por isso não era fácil encontrar a solução para o problema. No fim, aprendi o suficiente para o explicar à professora. Quando a última componente passou toda para JavaFX, o main antigo ficou no repositório como legacy, todo comentado.
Como foi feito
A API é em Spring Boot, dividida em controllers para os endpoints HTTP, services para as regras e repositories para a base de dados. O Hibernate mapeia as classes Java para tabelas em MySQL. Os abrigos e os animais aceitam fotos até 10 MB.
A segurança não fazia parte do enunciado; acrescentei-a por iniciativa própria porque é o que mais me interessa. O login passa pelo Spring Security e mantém uma sessão, todas as rotas exceto o registo, o login e a recuperação da password precisam dela, e cada endpoint verifica o role: utilizador, abrigo ou administrador. As passwords e as respostas de segurança são guardadas com hash BCrypt, e uma password precisa de 8 a 16 caracteres com uma maiúscula, um número e um caractere especial. Os administradores precisam de um código secreto para se registarem, e os abrigos esperam pela aprovação de um administrador. Hoje parece-me básico, mas foi onde começou.
Para a terceira componente, ecrãs brancos simples com caixas de texto chegavam para o enunciado. Fiz uma pequena biblioteca de componentes: botões, caixas de texto, cartões, uma grelha com páginas, um carrossel de fotos, popovers e uma barra de navegação, todos no mesmo estilo. Os animais, os abrigos e os animais perdidos partilham uma interface Displayable, por isso a mesma grelha mostra qualquer um deles. Uma classe Navigator muda de página, e uma única classe ApiClient fala com a API e guarda o cookie da sessão.
- 01Java Linguagem
A linguagem da API e da app de desktop.
- 02Spring Boot Framework
A API REST: controllers, services e repositories.
- 03Hibernate ORM
Mapeia as classes Java para tabelas em MySQL (e vice-versa).
- 04MySQL Base de dados
Onde tudo fica guardado.
- 05Spring Security Segurança
Sessões de login, hashing com BCrypt e o que cada papel pode fazer.
- 06JavaFX Interface
A app de desktop, feita com o seu próprio conjunto de componentes.
Em retrospetiva
Quase tudo aqui foi novidade para mim: Spring, Hibernate, APIs REST, cliente e servidor, Spring Security e threads. O JavaFX não, e o Maven mais ou menos. Tínhamos usado uma vez no 1.º ano porque a minha config do Neovim precisava dele para correr o projeto, sem sabermos bem o que era uma build tool. Aqui aprendi a usá-lo como deve ser.
Se o fizesse outra vez, não misturava JavaFX com o terminal. Mas o projeto não acabou: há planos para o transformar numa plataforma a sério.