Wano University
Plataforma de campus com a sua própria mini-linguagem
Uma plataforma de campus para reservar salas, estacionamento e refeições, com dashboards de sensores em direto e uma linguagem específica do sistema. Feita por uma equipa de cinco com React, Express e PostgreSQL.
- Ano
- 2026
- Tipo
- Web
- Papel
- Equipa de cinco: liderei a aplicação web, setup do projeto, code review
- Stack
- Figma Prototipagem
- React Client
- Express.js API
- Prisma ORM
- PostgreSQL Base de dados
- PLY Parser
- FastAPI API
O enunciado
Wano University é uma plataforma de gestão de campus. Estudantes e docentes reservam salas, laboratórios e equipamentos, encontram um lugar de estacionamento, bicicleta ou trotinete livre e compram refeições na cantina. Os funcionários validam senhas e acessos às salas. Os administradores gerem utilizadores, permissões e os sensores do campus, com dashboards e alertas de temperatura, consumo energético e qualidade do ar.
Foi um projeto para três cadeiras do 2.º ano ao mesmo tempo: Engenharia de Software, Laboratório de Tecnologias Web e Compiladores, que pedia uma pequena linguagem de comandos para a plataforma, a LSS. Éramos uma equipa de cinco.
Liderei a aplicação web. Fiz o setup do projeto, ensinei React, Express e Prisma ao resto da equipa e revi todos os pull requests. Trabalhei em quase todas as camadas, da base de dados e da API à interface e à LSS.
Como foi feito
Começou no Figma. Antes de qualquer código, fizemos a análise de utilizadores (duas personas, um estudante e um administrador) e um protótipo navegável dos ecrãs da aplicação, e o lado dos estudantes e o dos funcionários acabaram por ser duas interfaces diferentes. A aplicação foi feita a partir desses ecrãs.
O frontend é uma single-page app em React, feita com Vite, com React Router, Tailwind e componentes do shadcn. Fala com uma API em Express, que lê e escreve numa base de dados PostgreSQL através do Prisma. As passwords são guardadas com hash bcrypt. O login devolve um JSON Web Token, e um middleware verifica-o, juntamente com o papel do utilizador (estudante, docente, funcionário ou administrador), em todas as rotas protegidas. Sempre tinha usado sessões, por isso JWT foi novidade para mim.
Os mapas do campus são Leaflet por cima de uma imagem da planta, e os administradores clicam num ponto da planta para registar ali uma sala, um sensor ou um lugar de estacionamento. O Leaflet foi provavelmente o mais difícil de aprender. As dashboards usam Chart.js e atualizam sozinhas com SWR, que volta a pedir os dados de tempos a tempos e quando voltas ao separador. Não há hardware a sério, por isso as leituras dos sensores são números aleatórios.
A LSS vive num terminal em popup que abres em qualquer página depois do login. Um comando como rent lab: 4, 09:00, 11:00, 15/06/2026 vai para um pequeno serviço em Python (FastAPI), onde um lexer e um parser em PLY o leem e chamam a mesma API em Express com o teu token, por isso o terminal não consegue fazer nada que o teu papel não possa. Tem variáveis e aceita palavras-chave em inglês ou em português.
O frontend está na Vercel, o backend no Render e a base de dados na Neon. O plano gratuito do Render adormece o servidor quando ninguém o usa, por isso a demo demora um ou dois minutos a acordar. Foi também por isso que nunca pusemos o serviço da linguagem online: só corre localmente.
- 01Figma Prototipagem
A análise de utilizadores e o protótipo navegável a partir do qual a aplicação foi feita.
- 02React Client
A aplicação: páginas para cada papel, os mapas, as dashboards e o terminal em popup.
- 03Express.js API
A API: login, papéis, reservas, pagamentos e senhas.
- 04Prisma ORM
Transforma linhas da base de dados em objetos JavaScript (e vice-versa).
- 05PostgreSQL Base de dados
Onde tudo fica guardado.
- 06PLY Parser
Lexer e parser da LSS, a linguagem de comandos da plataforma.
- 07FastAPI API
O pequeno serviço em Python que corre os comandos da LSS contra a API em Express.
Para além do enunciado
O enunciado não pedia pagamentos, mas eu queria experimentar, por isso acrescentámos uma cantina à aplicação. Tem uma ementa e podem-se comprar senhas de refeição com o Stripe em test mode, que simula pagamentos com números de cartão de teste. Cada senha é um QR code que os funcionários leem com o telemóvel para a validar, e as reservas funcionam da mesma forma à porta da sala.
A aplicação também é uma PWA, por isso instala-se no telemóvel como uma app normal, e tem português e inglês e temas de cores personalizáveis. Os pagamentos, os QR codes e a PWA foram ideias minhas; os mapas interativos saíram dos protótipos em Figma.
Em retrospetiva
A maior parte do que usei aqui aprendi para este projeto: JWT, QR codes, pagamentos e ligar um serviço em Python a uma API em Express. A gestão do tempo foi difícil, pois a Wano foi feita no mesmo mês que o Forsaken Elegy, com exames pelo meio.
Se o fizesse outra vez, dava um prazo a cada parte do trabalho logo na primeira semana, para que menos coisas se acumulassem no fim. Não há planos para continuar o projeto.