For the complete documentation index, see llms.txt. This page is also available as Markdown.

Scanner de Produtos

Objetivo

Definir os requisitos mínimos para o fluxo de leitura de produtos físicos utilizando a câmera do dispositivo para escanear códigos de barras, navegando automaticamente para a tela de detalhes do produto e permitindo a adição ao carrinho de compras.

Insights

  • A interface do scanner deve seguir as melhores práticas de contraste, iluminação e segurança do usuário (ex.: sem uso intrusivo de flash automático).

  • O sistema deve ser otimizado para diferentes condições de iluminação e capacidades das câmeras dos dispositivos.

  • O tempo entre a leitura do código e o redirecionamento não deve exceder 2 segundos em condições normais.


Acesso ao Leitor (Scanner)

01 - Ícone do scanner

Deve estar posicionado ao lado do campo de busca na tela inicial. Deve utilizar um ícone padrão (leitor de código de barras ou câmera) e ser facilmente clicável.

Recomendado: Exibir uma breve animação ou destaque visual ao toque para indicar a ativação da câmera.


Interface de Scanner

02 - Área de leitura (scan frame)

Deve incluir uma área claramente definida para o alinhamento do código de barras. A câmera deve ser aberta automaticamente e manter o foco contínuo.

03 - Botão “Cancelar”

Deve estar fixado na parte inferior da tela, encerrando imediatamente o scanner e retornando à visualização do catálogo.

Recomendado: Caso o código não seja reconhecido, exibir uma mensagem clara: “Código não reconhecido. Por favor, tente novamente.”


Redirecionamento para a Tela de Detalhes do Produto

04 - Tela de detalhes do produto

Deve ser exibida imediatamente após uma leitura bem-sucedida. A tela deve apresentar todas as informações do produto:

  • Nome

  • Preço

  • Estoque

  • Descrição

Recomendado: Exibir um feedback visual (ex.: toast de confirmação ou mini popup) ao adicionar o produto via scanner.


Mensagens Obrigatórias

  • Quando o produto não for encontrado:

Produto não identificado. Verifique o código de barras ou faça a busca manualmente.

  • Quando a leitura falhar:

Não foi possível ler o código de barras. Ajuste o foco ou tente novamente.


Comportamentos Esperados

  • A câmera deve ser ativada com uma permissão única por sessão ou conforme exigido pela política de privacidade do sistema operacional.

  • Após uma leitura bem-sucedida, a visualização do scanner deve ser encerrada automaticamente e redirecionar para a tela do produto.

  • O botão “Cancelar” deve encerrar o fluxo de leitura imediatamente, sem erros ou atrasos.

  • O sistema deve mapear corretamente códigos duplicados, variantes ou equivalentes (SKU/GTIN).

Atualizado