Despensa inteligente para reduzir o desperdício de alimentos ("rot less").
Projeto individual full stack, do banco de dados à publicação em produção.
📖 Sobre o Projeto
O Rotless é um web app em que os moradores de uma casa registram os alimentos da despensa, com quantidade e data de validade. Todo dia o sistema confere o que está perto de vencer e avisa cada membro pelo Telegram, para que o alimento seja consumido antes de estragar.
A aplicação é composta por uma API REST em Laravel e uma SPA em React + TypeScript, e está em produção com deploy contínuo.
🌐 Acesse em rotless.gms.xyz.br. Para explorar sem criar conta, toque três vezes no escudo da tela de login e o app abre o modo demonstração.
✨ Funcionalidades
- Casas compartilhadas: vários moradores dividem a mesma despensa, com convites e diferentes níveis de permissão.
- Cadastro por código de barras: o scanner usa a câmera do celular e preenche os dados do produto a partir do OpenFoodFacts. Também dá para cadastrar produtos manualmente, com foto.
- Dashboard de validade: os alimentos aparecem ordenados pela data de vencimento, com cores de urgência.
- Alertas pelo Telegram: avisos diários sobre o que está perto de vencer.
- Histórico da casa: uma linha do tempo com o que foi adicionado, consumido, descartado ou editado, e por quem.
- Relatórios: consumo vs. desperdício ao longo do tempo, produtos mais desperdiçados e dicas de onde agir.
- Modo demonstração: uma casa fictícia com histórico, para conhecer o app sem criar conta.
🏗️ Engenharia
- Processamento assíncrono: os alertas são enviados por filas e tarefas agendadas.
- Testes automatizados no backend e no frontend, além de lint e análise estática.
- CI/CD: cada alteração passa por testes automatizados antes de ser publicada, e a publicação volta sozinha para a versão anterior em caso de falha.
- Processo: pull requests, Conventional Commits, versionamento semântico e
CHANGELOG.
🛠️ Tecnologias Utilizadas
- Backend: PHP, Laravel
- Frontend: React, TypeScript, Vite, Tailwind CSS, TanStack Query
- Banco de dados: PostgreSQL
- Infraestrutura: Docker, GitHub Actions
- Testes: Pest, Vitest
- APIs externas: OpenFoodFacts, Telegram Bot API
Desenvolvido por
Gabriel Monteiro | Estudante de Ciência da Computação @ CIn - UFPE