v1.0 · Projeto de portfólio
O eduAssets registra quem retirou o quê, mantém o estoque atualizado, acompanha manutenções e quebras e exporta relatórios em CSV, Excel e PDF.
Abre em Guest Mode: somente leitura, sem cadastro.
Projeto de portfólio
Sistema web full-stack para controle de estoque, empréstimos, devoluções e ocorrências de equipamentos escolares.
Escolas frequentemente controlam notebooks, tablets e acessórios por planilhas dispersas, dificultando saber o que está disponível, emprestado, em manutenção ou quebrado.
O eduAssets centraliza estoque, empréstimos, devoluções, ocorrências, permissões e exportação de relatórios em uma aplicação web.
TypeScript, Vite e arquitetura feature-first.
Node.js, Express 5, Prisma e Zod.
PostgreSQL gerenciado no Neon.
JWT, controle de sessão e níveis de acesso por responsabilidade.
Integração com Raspberry Pi ou Arduino Nano.
CI/CD, deploy da aplicação e API, e documentação operacional.
A VM Oracle possui apenas 1 GB de RAM. Manter o PostgreSQL gerenciado reduz consumo de memória, simplifica backups e separa a disponibilidade do banco da máquina da API.
O frontend estático pode ser servido globalmente pelo Cloudflare Pages, enquanto a API permanece em uma VM com controle operacional independente.
Para permitir avaliação e interação imediata do sistema sem criar contas ou expor credenciais administrativas.
O sistema continua útil com login convencional e pode receber hardware quando for hospedado localmente ou quando a operação justificar o investimento.
Fluxo de empréstimos
Cada passo atualiza o estoque na hora, para que o saldo disponível seja sempre o real.
Informe solicitante, responsável, data e hora e os itens com suas quantidades.
Se não houver saldo disponível suficiente, o registro é bloqueado.
Na lista de abertos, confirme a devolução com data e hora. Os itens voltam ao estoque.
Todo empréstimo fica registrado com status Aberto ou Devolvido.
Funcionalidades
Registre empréstimos com vários itens e processe devoluções a partir da lista de empréstimos em aberto.
Total, disponíveis, emprestados, em manutenção e quebrados em cards de resumo. O estoque é listado por categoria e o histórico traz todos os empréstimos.
Registre observações, manutenções e equipamentos quebrados. Ao resolver um registro, descreva a solução aplicada e o item volta ao estoque.
O estoque muda a cada ação, sem edição manual.
Também incluído
Além dos painéis, o que o sistema oferece no uso diário.
Qualquer pessoa explora o sistema em modo leitura, sem cadastro.
A restrição por nível não depende só da interface: toda rota de escrita valida o token.
Baixa atômica por transação e bloqueio do registro quando falta saldo.
Login por cartão com Raspberry Pi ou Arduino Nano. O login por senha continua disponível.
Histórico de empréstimos e inventário em CSV, Excel ou PDF.
Interface nos dois idiomas, com modo claro, escuro ou do sistema.
Acesso e segurança
A restrição existe na interface e é aplicada também no backend.
Entra sem login. Visualiza Dashboard, histórico e estoque. Não cria, edita nem exclui.
Registra empréstimos, processa devoluções e cria ou edita registros de Controle.
Acesso total: Cadastros, exclusão de registros, troca de senha e cartões RFID.
Hardware opcional
O usuário encosta o cartão no leitor e entra sem digitar senha.
O administrador gera um token em Cadastros → Usuários e grava no cartão. O servidor guarda só o hash.
Um serviço em Python, em um Raspberry Pi ou Arduino Nano, lê o cartão e envia o token ao backend.
O backend valida o token e avisa as abas abertas por WebSocket. A sessão inicia sozinha.
O leitor emite sons distintos para cartão detectado, sucesso e erro. O RFID nunca é obrigatório.
Tecnologia
Documentação
Consulte os materiais de uso, arquitetura, API, desenvolvimento, implantação, hospedagem e operação.
Repositório de origem:GitHub
Perfil pessoal
Desenvolvedor, técnico em informática e estudante de Engenharia da Computação.
Desenvolvedor · Técnico em informática · Estudante de Engenharia da Computação
São Paulo, Brasil
Abra o eduAssets em Guest Mode e navegue pelos painéis, sem cadastro.
