Quanto Paguei: app Android que lê o cupom fiscal e compara preços de mercado

O Quanto Paguei é um produto da própria ALB Seven: um aplicativo Android, publicado na Google Play sob o pacote com.albseven.quantopaguei. Ele transforma o cupom fiscal do supermercado em histórico de preços. A pessoa aponta a câmera para o QR Code da NFC-e e o app registra cada produto, o preço, o mercado e a data, sem digitar nada.

O problema que ele resolve

Quem faz compra de mês sabe que o mesmo arroz custa diferente em cada mercado e que o preço muda de uma semana para outra, mas ninguém guarda cupom para conferir. Os apps de finanças pedem que a pessoa digite cada gasto, e a maioria desiste na segunda semana. A nota fiscal eletrônica já carrega todos esses dados em um QR Code; o que faltava era um leitor que os organizasse por produto e por mercado, e não só pelo total da compra.

As decisões de projeto

• Local-first, conta opcional. Compras, listas e alertas ficam no aparelho, em IndexedDB (Dexie), e o app funciona sem internet. A conta existe só para backup e para recuperar os dados ao trocar de celular; o backend, em PHP e MariaDB, não participa de nenhuma outra tela.
• Leitura da NFC-e pelo caminho oficial. O QR Code é lido no aparelho, a chave de 44 dígitos é validada localmente e os itens vêm da consulta pública da SEFAZ, pela URL do próprio QR. No Android a requisição sai nativa, pelo Capacitor; na versão web passa por um proxy PHP restrito a domínios gov.br. Há ainda um plano B por OCR do cupom impresso, com revisão obrigatória do usuário antes de salvar.
• O produto é a entidade central. Histórico, preços por mercado, listas, alertas e análises são visões sobre o mesmo registro de produto. Toda tela que mostra um item leva à página dele, com o menor, o maior e a média do que foi pago e um gráfico de evolução.
• Comparação de mercados com ressalva. A partir de uma lista, o app calcula três cenários: a compra mais barata dividindo em até três mercados, a de um mercado só e a de menos deslocamento. Cada preço mostra há quanto tempo foi registrado, e a explicação começa sempre com "com base no seu histórico", porque os preços mudam.
• Lógica pura, testada. Otimizador, planejador de lista, relatórios, insights e alertas vivem em src/domain/ sem React, cobertos por testes Vitest. As telas só compõem.
• Modelo freemium construído, mas desligado. Limites, selo Premium e paywall existem no código atrás de uma flag e, no MVP, ficam ocultos: ninguém esbarra em bloqueio. Os anúncios do AdMob só entram após consentimento (UMP) e nunca aparecem no scanner nem na importação.

Stack

Vite, React 18, TypeScript, Tailwind CSS v4, Framer Motion, Dexie, Recharts e qr-scanner no app; Capacitor 8 com AdMob para o Android; PHP 8.1 e MariaDB no backup opcional; exportação em PDF, CSV e JSON. Ícones, splash e capturas da loja são gerados por script a partir do próprio projeto.

O que isso demonstra

Que a ALB Seven leva um app do zero até a loja: integração com um serviço público (a consulta da SEFAZ), persistência local, regras de negócio testadas, consentimento de anúncios, política de privacidade e termos próprios e o processo de publicação na Google Play. É o mesmo caminho oferecido a clientes que precisam de um aplicativo próprio.