Biblioteca Escolar
Aplicação web de gestão de biblioteca escolar: catálogo, exemplares,
utilizadores (alunos, docentes, não docentes, externos, entidades),
empréstimos/devoluções e manuais escolares.
Stack: React + Vite + TypeScript + Tailwind, com Supabase (Postgres +
Auth + Row Level Security) e deploy na Vercel.
Perfis de acesso
- Administrador — acesso total, incluindo gestão de operadores e
parâmetros (
operador.perfil = 'administrador').
- Utilizador (staff) — operações do dia a dia: catálogo, empréstimo,
devolução, gestão de utilizadores (
operador.perfil em
bibliotecario / assistente / monitor).
- Visitante autenticado — qualquer pessoa que faça login e não
tenha uma linha em
operador: só vê o seu próprio histórico (por
email), sem acesso de escrita.
Um administrador promove alguém a "utilizador" (staff) criando uma
linha em operador com o email dessa pessoa, em Administração; a
ligação à conta de login torna-se efetiva assim que essa pessoa entra
pela primeira vez.
Desenvolvimento local
npm install
cp .env.example .env # preencher com o URL e a anon key do projeto Supabase
npm run dev
Base de dados (Supabase)
O esquema completo (tabelas, RLS, triggers, vistas) está em
supabase/migrations. Para aplicar a um
projeto Supabase:
supabase link --project-ref <project-ref>
supabase db push
Login Google / Microsoft
Configurar em Supabase → Authentication → Providers:
Depois colar Client ID + Client Secret de cada um no painel do
Supabase e ativar o provider.
Deploy (Vercel)
- Importar este repositório em vercel.com/new
(framework detetado automaticamente: Vite).
- Definir as variáveis de ambiente do projeto na Vercel:
VITE_SUPABASE_URLVITE_SUPABASE_ANON_KEY
- A partir daí, cada
git push para main dispara um novo deploy.
