Administração

Área do ADMIN (e, em parte, do SUPERVISOR): gente, números, conectores e trilha de auditoria.

Versão de avaliação. Este manual descreve a aplicação web 2.1 usada no ponto de retirada. A pré-release Windows v2.1.0-rc1.8 está publicada para avaliação, sem assinatura digital, em ZIP portátil. Não há SaaS público. O produto é Free; o suporte opcional é pago à parte. O GA do instalador com SQLite continua em 06 de abril de 2027. Conectores vivos no código: Mercado Livre, Shopee e Temu.

Usuários e perfis

Menu: Administração → Usuários (ADMIN). Criar, editar, desativar, resetar senha e ver histórico de acesso.

  • ADMIN — acesso total, gerencia usuários e configurações
  • SUPERVISOR — operação e exportações; não gerencia usuários
  • OPERADOR — busca, separação e dia a dia; sem exportações nem usuários

Novo usuário: nome, telefone de acesso (vira o login), perfil, tipo de mensageria, status e senha. A senha digitada exige 6 caracteres; se o campo ficar em branco, o Hub gera uma senha temporária de 8 caracteres e mostra na tela — anote e entregue em mãos. O Hub não envia senha por e-mail nem por SMS, e nesta versão o aviso automático de credenciais por WhatsApp/Telegram está desligado. Não existe bloqueio de primeiro acesso: a troca de senha é feita em Perfil.

Métricas, exportações e avisos

Métricas: acessos por configuração, uso por perfil, validações, alertas e histórico. Gráficos Chart.js com exportação em CSV e planilha .xls; cada gráfico também sai em PNG ou PDF.

Exportações: menu Exportações (ADMIN e SUPERVISOR) — escolha o assunto (gestão de pedidos, gestão de estoque, integrações, qualidade), o tipo e baixe o CSV. O Hub não envia relatório por e-mail em nenhum horário; o arquivo é baixado por quem tem acesso.

Conectores

Menu: Administração → Integrações. Conectores vivos: Mercado Livre (webhook HMAC e worker), Shopee e Temu. Não venda Amazon nem WooCommerce como prontos.

  1. Clique em Conectar no marketplace
  2. Autorize a conta na plataforma
  3. Mapeie SKU e status
  4. Faça um pedido de teste e confira se chega na fila
StatusSignificado
ConectadoAtivo
SincronizandoOperação em andamento
ErroFalhou — reconecte ou veja eventos
DesconectadoInativo

WhatsApp: com o canal configurado (Evolution API ou API compatível), pedidos parados podem gerar aviso ao cliente. O código traz um job com intervalo de 6 horas, mas ele usa agendamento de servidor de aplicações e não roda no Tomcat do pacote: hoje o envio depende de um disparo externo de POST /api/notificacoes/atraso/verificar. Sem canal configurado, nenhuma mensagem sai. O disparo automático dentro do instalador ainda não está definido.

Auditoria

Log de Auditoria — menu Administração → Auditoria (rota auditoria/lista). Registro de quem fez o quê, quando, em qual registro e o que mudou, com filtro por usuário, data ou tipo (criação, edição, exclusão, login) e exportação para análise externa. Serve para disputa, conformidade LGPD e erro operacional.

Auditoria e Logs — tela /admin/auditoria, restrita a ADMIN. Mostra as ações administrativas mais recentes sobre contas de usuário: criar, editar, desativar, ativar, redefinir senha e alterar perfil, com autor, perfil e horário. Os registros ficam na tabela usuario_auditoria e a gravação é obrigatória: se ela falhar, a operação sobre o usuário falha em vez de informar sucesso. Desde a pré-release v2.1.0-rc1.7 esta tela tem item no menu, em Administração → Auditoria e Logs, logo abaixo de Log de Auditoria; na v2.1.0-rc1.6 ela só se abria digitando a URL. A tela Log de Auditoria não exibe essas ações.