Sobre AdminML Helper

Ferramenta de busca e gerenciamento de pacotes logísticos integrada com AdminML

O que é?

AdminML Helper é uma aplicação web desenvolvida para facilitar a busca e o gerenciamento de pacotes logísticos. Com uma interface intuitiva e rápida, permite que usuários carreguem dados de pacotes em formato CSV e realizem buscas instantâneas por ID ou descrição.

A ferramenta foi projetada pensando na usabilidade, oferecendo dois modos distintos de visualização: navegação paginada para exploração geral e busca em tempo real para localizar pacotes específicos.

Principais Funcionalidades

📤 Upload de CSV

Carregue arquivos CSV contendo dados de pacotes. Suporta formato padrão com separação por vírgula.

🔍 Busca em Tempo Real

Busque pacotes por ID ou descrição com filtragem instantânea enquanto você digita.

📑 Navegação Paginada

Navegue entre páginas de 50 itens com dados ordenados alfabeticamente por descrição.

🔗 Integração AdminML

Acesso direto aos pacotes no painel AdminML com um único clique.

📱 Responsivo

Interface adaptada para funcionar perfeitamente em desktop, tablet e dispositivos móveis.

⚡ Performance

Processamento rápido de dados e busca otimizada para manejara grandes volumes.

Como Usar

Preparar o Arquivo CSV: Certifique-se de que seu arquivo CSV contém as colunas esperadas: ID, Descrição, Status e Tramo. A primeira linha deve conter os cabeçalhos.
Carregar o Arquivo: Clique em "Escolher arquivo CSV" e selecione o arquivo que deseja importar.
Navegar ou Buscar: Após o upload, você verá a lista de pacotes. Use a barra de busca para encontrar pacotes específicos ou navegue pelas páginas.
Abrir Pacote: Clique em qualquer pacote para abrir seus detalhes no painel AdminML em uma nova aba.

Formato do Arquivo CSV

Seu arquivo CSV deve incluir as seguintes colunas (os nomes devem ser exatos):

					ID,Descrição,Status,Tramo PKG001,Pacote com
					Eletrônicos,Entregue,São Paulo PKG002,Envelope Frágil -
					Vidro,Em Trânsito,Rio de Janeiro PKG003,Documento
					Importante,Pendente,Minas Gerais
				

Descrição das Colunas:

ID: Identificador único do pacote (ex: PKG001, ABC123)
Descrição: Detalhes do conteúdo do pacote ou produto
Status: Situação atual do pacote (Entregue, Em Trânsito, Pendente, etc.)
Tramo: Região ou local do logístico (cidade, estado, etc.)

Modos de Visualização

Modo Browse (Padrão)

Quando você abre a aplicação ou limpa a busca, você entra no Modo Browse. Neste modo:

Todos os pacotes são exibidos em páginas de 50 itens
Os dados são ordenados alfabeticamente por descrição
Você pode navegar entre páginas usando os botões "Anterior" e "Próximo"
A contagem total de pacotes é exibida no topo

Modo Search (Busca)

Ao digitar algo na barra de busca, você entra no Modo Search. Neste modo:

Apenas pacotes que correspondem ao critério são exibidos
A busca funciona por ID ou descrição (não diferencia maiúsculas de minúsculas)
O termo pesquisado é destacado em amarelo nos resultados
Todos os resultados são exibidos em uma única lista (sem paginação)
A contagem mostra quantos resultados foram encontrados

Dicas e Truques

Busca Parcial: Você não precisa digitar o termo completo. Buscas parciais funcionam perfeitamente. Por exemplo, buscar "eletr" encontrará "Eletrônicos".
Limpar Busca: Apague o texto da barra de busca para retornar ao Modo Browse e ver todos os pacotes novamente.
Nova Importação: Clique no logo "AdminML Helper" para recarregar a página e carregar um novo arquivo CSV.
Links Diretos: Cada pacote é um link clicável que abre o painel AdminML do gerenciamento de pacotes.

Requisitos Técnicos

Navegador Moderno: Chrome, Firefox, Safari ou Edge (versões recentes)
Arquivo CSV: Formato de texto separado por vírgula, codificação UTF-8 recomendada
Conexão Internet: Para acessar o painel AdminML via links

Suporte Técnico

Para dúvidas, sugestões ou relatos de bugs, acesse o repositório do projeto no GitHub:

Acessar GitHub

Licença e Créditos

Desenvolvido por Lucas WG. A ferramenta utiliza bibliotecas de código aberto como PapaParse para leitura de arquivos CSV.