Beontag UTFPR Agro — Mobile

Aplicativo Android desenvolvido em Flutter para leitura de tags RFID UHF em campo agrícola. Integra-se ao leitor Chainway C72 (embutido no dispositivo) e à API do backend Beontag UTFPR para realizar conferências de inventário, rastreamento de itens e consulta de estoque.

---

Funcionalidades

Tela	Descrição
Conexão com leitor	Detecta automaticamente o leitor Chainway C72 integrado ao dispositivo. Também suporta conexão via Bluetooth com outros modelos de leitores. A configuração é persistida localmente.
Scan (Conferência)	Lista as conferências disponíveis no backend. Ao iniciar, lê as tags RFID em tempo real usando o gatilho físico do leitor e compara com a lista de EPCs da conferência, mostrando em verde os itens encontrados e em cinza os pendentes. Ao finalizar, envia o resultado do inventário para a API.
Histórico	Exibe todas as sessões de scan realizadas, com data, quantidade de tags lidas e status de sincronização. Permite visualizar os detalhes de cada sessão (EPC, TID, RSSI, contagem de leituras) com filtro por EPC ou TID, e reenviar uma sessão ao backend.
Busca (Tag Finder)	Realiza leitura contínua de todas as tags ao redor, ordenando-as por intensidade de sinal (RSSI). Permite selecionar um TID específico do estoque para rastrear uma tag individualmente, exibindo o histórico de RSSI em tempo real.
Configurações	Permite gerenciar a conexão com o leitor (conectar / reconectar) e ajustar a potência de leitura e escrita (faixa de 5 a 30 dBm para o C72).

---

Pré-requisitos

• Flutter SDK ≥ 3.10.8
• Android SDK (API 21+)
• Dispositivo Android físico recomendado (Chainway C72 para leitura RFID completa)
• Emulador Android aceito, mas sem suporte a hardware RFID
• Backend Beontag UTFPR em execução (padrão: https://beontag.cm.utfpr.edu.br)

---

Configuração da URL da API

O endereço do backend é definido em lib/services/api_config.dart:

const String apiBaseUrl = 'https://beontag.cm.utfpr.edu.br';

Para apontar para um backend local:

• Emulador Android: use http://10.0.2.2:<porta>
• Dispositivo físico: use o IP da sua máquina na rede local, ex.: http://192.168.1.100:<porta>

---

Como rodar o projeto

# 1. Clone o repositório
git clone <url-do-repositorio>
cd beontag-utfpr-agro-mobile

# 2. Instale as dependências
flutter pub get

# 3. Verifique se há um dispositivo/emulador disponível
flutter devices

# 4. Execute o app em modo debug
flutter run

Para selecionar um dispositivo específico:

flutter run -d <device-id>

---

Gerar APK de release

Execute o comando abaixo na raiz do projeto:

flutter build apk --release

O arquivo gerado fica em:

build/app/outputs/flutter-apk/app-release.apk

Para instalar diretamente no dispositivo conectado via USB:

flutter install --release

Dica: para gerar um APK por ABI (menor tamanho), use flutter build apk --split-per-abi --release. Os arquivos ficam no mesmo diretório com sufixos como app-arm64-v8a-release.apk.

---

Dependências principais

Pacote	Uso
http	Comunicação com a API REST do backend
shared_preferences	Persistência local de configurações e sessões de scan
cupertino_icons	Ícones auxiliares da UI