CajuScan é uma aplicação móvel para Android, desenvolvida em Flutter, que simplifica o registo de despesas em Portugal. A aplicação permite digitalizar o QR Code (ATCUD) presente nas faturas portuguesas, extrair automaticamente os dados da transação e enviá-los para a aplicação de gestão financeira Cashew.
O objetivo é automatizar o processo manual de inserir despesas, poupando tempo e reduzindo erros.
Apresentação visual das principais funcionalidades da aplicação CajuScan.
- Leitura de código QR de faturas: Utiliza a câmara do telemóvel para digitalizar e processar instantaneamente os c+odigos QR (ATCUD) das faturas emitidas em Portugal.
- Importação de ficheiros: Permite ler o código QR diretamente de ficheiros PDF ou imagens da galeria, facilitando o registo de faturas digitais recebidas por email.
- Integração com Cashew: Envia os dados da fatura (valor, data, NIF do comerciante) diretamente para a aplicação Cashew, pré-preenchendo uma nova transação.
- Gestão inteligente de comerciantes:
- Guarda automaticamente o NIF de cada comerciante.
- Permite associar um nome personalizado (ex: "Comerciante XPTO") e uma categoria/subcategoria padrão a cada NIF.
- Na leitura seguinte de uma fatura do mesmo comerciante, sugere automaticamente o nome e a categoria guardados.
- Gestão de categorias:
- Sistema completo para criar, editar e apagar categorias e subcategorias de despesa.
- Permite restaurar uma lista de categorias padrão a qualquer momento.
- Flexibilidade no registo:
- Opção para registar a transação diretamente no Cashew (sem confirmação).
- Opção para abrir os dados no Cashew para revisão antes de guardar (requer confirmação).
- Possibilidade de apenas guardar um novo comerciante a partir de um código QR, sem criar uma transação.
- Backup e testauro:
- Funcionalidade para exportar todos os dados da aplicação (perfis de comerciantes e categorias) para um ficheiro de backup (
.json). - Permite importar dados a partir de um ficheiro de backup, facilitando a migração entre dispositivos.
- Funcionalidade para exportar todos os dados da aplicação (perfis de comerciantes e categorias) para um ficheiro de backup (
- Interface intuitiva:
- Scanner de câmara com uma sobreposição clara para facilitar o alinhamento do QR Code.
- Design limpo e focado na simplicidade de uso.
- Privacidade e segurança: Aplicação assinada digitalmente e preparada para builds reprodutíveis (Reproducible Builds).
- Framework: Flutter
- Linguagem: Dart
- Leitura de código QR: flutter_zxing
- Processamento de PDF: native_pdf_renderer
- Armazenamento local: shared_preferences
- Interação com outras apps: url_launcher
- Seleção de ficheiros: file_picker
- Informação da aplicação: package_info_plus
Para compilar o projeto, precisa de ter o Flutter SDK instalado e configurado.
-
Clonar o repositório:
git clone https://github.com/marotoweb/cajuscan.git cd cajuscan -
Instalar as dependências:
flutter pub get
-
Executar em modo de depuração: Ligue um dispositivo Android ou inicie um emulador e execute:
flutter run
-
Compilar a versão de produção (Release APK ): Para gerar o ficheiro
.apkfinal, otimizado e pronto para ser instalado:flutter build apk --release
O ficheiro de instalação será gerado em
build/app/outputs/flutter-apk/app-release.apk. Nota: Para gerar uma build assinada idêntica à oficial, é necessário configurar as variáveis de ambiente da Keystore.
Este projeto é disponibilizado sob a licença MIT.
A aplicação CajuScan é fornecida "COMO ESTÁ", sem garantias de qualquer tipo. O autor não se responsabiliza por qualquer mau funcionamento, perda de dados ou erros de registo que possam surgir do uso desta aplicação. É da exclusiva responsabilidade do utilizador verificar a correção dos dados.