reFresh
gestor de ingredientes com sugestões de receitas
ao vivo: https://refresh.jestev.es/
código fonte: https://github.com/utad-reFresh
Contexto
Projeto final de curso com o objetivo de reduzir o desperdício alimentar: a app Android (Kotlin) permite registar os ingredientes que tens em casa, manualmente ou por leitura de código de barras via Open Food Facts, e sugere receitas antes que se estraguem, com alertas de validade e favoritos. O backend (ASP.NET Core + Blazor, PostgreSQL, JWT) tenta primeiro encontrar receitas na base de dados local e só recorre à API externa Spoonacular quando não há resultados suficientes, guardando o que encontra em cache para pedidos futuros.
Desafios técnicos
- híbrido local + API externa, para poupar quota — o backend só recorre à Spoonacular quando a receita ou o ingrediente ainda não existem na base de dados local, evitando gastar quota em pedidos repetidos
- leitura de código de barras — o telemóvel lê o código de barras e o backend consulta a Open Food Facts por esse código, guardando o resultado em cache associado ao próprio código de barras para não repetir o pedido a produtos já vistos
- conversão entre fontes de dados externas — cada API descreve produtos e ingredientes à sua maneira, sem um ID em comum entre elas; o backend tenta encontrar a correspondência mais parecida em vez de assumir que os dados batem certo
- normalização de dados externos — a Spoonacular devolve quantidades em unidades imperiais e métricas misturadas; o backend converte tudo para um formato consistente
- sincronização app e API — manter a lista de ingredientes do telemóvel consistente com o backend, sobretudo em cenários offline, com autenticação via JWT em cada pedido
Screenshots
