Pular para o conteúdo principal

Fluxo web (baseado no front)

Esta página documenta o fluxo observado no front-end do Middleware RFID, com foco nas páginas de Login e Leitores.

Visão geral do fluxo​

O fluxo abaixo mostra a sequência mais comum de uso no front: cadastrar leitor, configurar regras, ajustar filtros e operar em modo Portal, Sensor ou Contínuo.

1. Cadastro do leitor​

Cadastro de leitor RFID

Esta é a tela usada para adicionar um novo leitor RFID ao ambiente. Nela o usuário informa os dados de acesso do equipamento antes de seguir para a operação.

2. Configuração inicial dos GPOs​

Configuração de GPOs

Aqui são definidos os eventos de acionamento dos GPOs do leitor, incluindo evento, quantidade de pulsos e comportamento após a ativação.

3. Filtros de leitura​

Filtros de leitura

Esta etapa ajusta as regras de filtragem para aceitar apenas leituras que atendam aos critérios configurados, como RSSI, prefixo/sufixo e inclusão ou exclusão.

4. Modo Portal manual​

Modo Portal manual

Neste modo, a leitura acontece de forma controlada pelo operador, ideal para pontos fixos e validação manual do início da operação.

5. Modo Portal com sensor​

Modo Portal com sensor

Essa variação do Portal usa o sensor para iniciar ou encerrar a leitura automaticamente, reduzindo intervenção manual.

6. Leitura por sensor​

Leitura por sensor

Aqui o foco está no comportamento do fluxo baseado em GPI/GPO, com parâmetros de start e stop configurados para leitura acionada por evento físico.

7. Modo contínuo​

Modo contínuo

Neste cenário o leitor realiza capturas de forma contínua e envia os eventos no intervalo configurado, sem depender de acionamento manual.

8. Operação em andamento​

Efetuando leituras

Esta tela representa a operação em execução, com a lista de EPCs lidos, RSSI, antena e timestamp para acompanhamento do processo.

1. Login​

Rota de tela:

  • /login

Comportamento observado:

  1. Usuário informa email e senha.
  2. Front chama POST /login.
  3. Em sucesso:
    • salva authToken no localStorage
    • opcionalmente salva rememberEmail no localStorage
    • redireciona para /leitores
  4. Em falha:
    • exibe alerta de erro para o usuário

Recursos de UX presentes na tela:

  • Mostrar/ocultar senha
  • Persistência opcional do email para próximo acesso
  • Feedback de carregamento no botão de login

2. Página de leitores​

Rota de tela:

  • /leitores

Comportamento observado:

  • Front consulta leitores via GET /leitores (SWR).
  • Exibe lista de leitores disponíveis.
  • Quando nenhum leitor está selecionado, mostra instrução para seleção.
  • Após selecionar leitor, a tela passa a exibir estado operacional e leituras.

2.1 Leitor selecionado e operação ativa​

Quando o leitor já foi adicionado e selecionado, a tela exibe o estado ativo do equipamento, os tags lidos e os controles de início/parada.

Exemplo visual da operação​

Leitor em operação com leituras

Este estado mostra a operação já em andamento, com leituras acumuladas na tabela principal e os controles no topo da tela.

3. Estados visuais da operação​

Estados identificados na tela:

  • Sem leitor selecionado: instrução para selecionar leitor.
  • Leitor em operação sem leituras ainda: card de carregamento.
  • Leitor com leituras: lista/visualização de leituras do leitor selecionado.

Observação de regra no front:

  • O estado de leitura em operação considera isReading e modo diferente de PORTAL-MANUAL-START para exibir o card de operação.

3.1 Canais de leitura e configuração​

As telas abaixo detalham como o front organiza a leitura por modo e por regras de filtragem.

GPOs e eventos de ação​

Configuração de GPOs

Os GPOs podem ser ligados a eventos específicos, como leitura, não leitura, erro de envio e sucesso de envio.

Sensores e disparo de leitura​

Leitura por sensor

O uso de sensor permite definir o início e o fim da leitura por sinal físico, o que é útil em esteiras, portais e docas.

Filtro por prefixo e RSSI​

Filtros de leitura

Aqui o operador restringe o que será aceito pelo sistema, ajudando a reduzir ruído e leituras fora do padrão esperado.

4. Componentes funcionais envolvidos​

Na página de leitores, o front usa os seguintes blocos funcionais:

  • Cabeçalho da aplicação
  • Lista de leitores
  • Cabeçalho contextual do leitor
  • Painel de leituras do leitor selecionado
  • Rodapé

5. Implicações para documentação operacional​

Para operação e suporte, recomenda-se registrar:

  • Pré-requisitos de login e autenticação
  • Critérios para seleção de leitor ativo
  • Significado dos estados da tela de leitores
  • Como interpretar ausência de leituras com leitor em operação
  • Fluxo de troubleshooting para erros de autenticação e ausência de leitores