01 Arquitetura & Clientes Pendente

01. Cenários de Clientes: WMS (Oracle) vs Cliente Local (MySQL)

Entenda os dois tipos de clientes na positivação: com estoque integrado no WMS ou operação avulsa de trade marketing.

Vídeo Explicativo: Clientes WMS vs Clientes Locais
YouTube

Conceitos & Regras de Validação

  • Fluxo Integrado ao WMS (Oracle): O cliente possui estoque físico armazenado no armazém. O vínculo operacional é realizado diretamente pelo código do Depositante WMS, sincronizando saldos e expedições.
  • Fluxo Avulso (Grupos de Positivação no MySQL): Para clientes que contratam apenas ações de trade marketing/merchandising sem WMS, o isolamento é estruturado criando um Grupo de Positivação (e depositantes locais no MySQL), agrupando seus respectivos destinatários, campanhas e promotores.
  • Gestor de Positivação no Portal (Perfil 9): Acesso voltado para o cliente ou supervisor da conta no Portal Web. Visualiza exclusivamente o dashboard, campanhas, relatórios de campo e fotos auditadas do seu próprio grupo/depositante, sem acesso a telas de armazém de terceiros.
  • Promotor de Positivação no App (Perfil 10): Acesso dedicado ao App Mobile. O promotor só visualiza a sua rota de visitas agendada, chamados atribuídos a ele e os PDVs homologados dentro do seu grupo de atendimento.
  • Administrador Geral (Perfil 1): Acesso irrestrito no Portal Web para cadastrar grupos, despachar chamados entre diferentes equipes e parametrizar regras globais e perfis no Admin.
02 Destinatários Pendente

02. Gestão e Cadastro de Destinatários

Como alimentar a base de lojas, farmácias e supermercados atendidos pela operação de positivação.

Vídeo Explicativo: Cadastro e Importação de Destinatários
YouTube

Conceitos & Regras de Validação

  • Destinatários do WMS (Oracle): Para clientes com expedição física, os destinatários vêm prontos e vinculados às ordens de transporte do sistema corporativo.
  • Cadastro Manual para Clientes Locais: Inclusão de novos destinatários via Portal com CNPJ/CPF, Inscrição Estadual, Razão Social, Nome Fantasia e Endereço.
  • Importação em Lote via Planilha: Carga massiva de centenas de pontos de venda em minutos utilizando o modelo CSV/Excel padrão da LSLOG.
  • Validação de CEP & Localização: Preenchimento estruturado de CEP, bairro, cidade e UF para facilitar a geocodificação do PDV.
03 PDVs & Geofencing Pendente

03. Cadastro de PDV pelo Portal e pelo App Mobile

Criação dos pontos de venda físicos, coordenadas geográficas e homologação em campo pelo promotor no app.

Aula 3.1: Cadastro de PDV no Portal Web (Geofencing & Coordenadas)
YouTube

3.1 Conceitos & Parâmetros no Portal Web

  • Diferença entre Destinatário e PDV: O Destinatário é o cadastro fiscal (CNPJ/Razão Social). O PDV é a loja física associada a um Canal (Supermercado, Drogaria, Conveniência) e Tipo de Loja.
  • Configuração de Coordenadas: Inserção de Latitude e Longitude precisas para validação de presença do promotor via satélite.
  • Raio de Tolerância GPS: Definição do perímetro de atendimento em metros (ex: 50m, 100m, 200m). O promotor só consegue iniciar a O.S. se estiver dentro deste raio.
  • Vínculo a Redes & Canais: Organização hierárquica para segmentar campanhas por bandeira ou canal de atendimento.
Aula 3.2: Cadastro e Homologação de PDV em Campo pelo App Mobile
YouTube

3.2 Fluxo em Campo pelo Aplicativo Mobile

  • Cadastro Direto no Local: O promotor pode cadastrar um novo PDV diretamente pelo smartphone na frente da loja.
  • Captura de GPS Real: O aplicativo captura a coordenada precisa obtida pelo hardware de GPS do aparelho.
  • Foto da Fachada: Registro fotográfico obrigatório da fachada da loja para identificação visual.
  • Fila de Homologação: O PDV cadastrado pelo app entra em status pendente de homologação pelo supervisor no Portal Web antes de ser liberado para rotas.
04 CMS & Governança de IA (Admin) Pendente

04. Perfis de Atendimento (CMS) & Gestão Global de IA

Configuração da jornada operacional no App Mobile e parametrização corporativa dos modelos de Inteligência Artificial.

Vídeo Explicativo: Configuração de Perfis no CMS & Gestão Global de IA
YouTube

1. Perfis de Atendimento (CMS) & Fluxo Operacional

  • Acesso Exclusivo no Menu Admin: Perfis de Atendimento ficam centralizados na área administrativa (`/admin/service-profiles`), garantindo governança técnica e segurança.
  • Construção das Etapas do App: Definição da ordem de fluxo em campo: Check-in por GPS, Medidas do Ponto, Fotos de Montagem, Formulário de Pesquisa e Assinatura do Gerente.
  • Questionários Globais: Perguntas de conformidade técnica e vistoria padrão que se aplicam a todos os chamados sem necessidade de recriar do zero.
  • Perfis Especializados: Criação de perfis distintos para Instalação Nova, Vistoria Periódica ou Manutenção e Desmonte de Peças.

2. ⚙️ Gestão Global de Agentes de IA

  • Configuração Centralizada da IA (LSLog Admin): Acesso exclusivo pelo menu de Administração (`/admin/positivacao-settings`) para definição dos modelos ativos (ex: Google Gemini 1.5 Flash / GPT-4o).
  • Tokens e Chaves de API Criptografadas: As chaves são protegidas com criptografia AES-256 no banco de dados e contam com botão de teste de conectividade em tempo real antes de salvar.
  • Auditoria Automatizada de Visão Computacional: O agente de IA analisa as fotos capturadas pelo promotor comparando com os materiais de referência da campanha, atribuindo nota de 0 a 10 e conformidade de layout.
  • 🔬 Playground Teste de Visão: Laboratório interativo integrado na tela para o Administrador simular prompts e testar fotos reais antes de disponibilizar para a operação em campo.
05 Pesquisas & Trade Pendente

05. Cadastro de Questionários e Pesquisas de Campo

Criação flexível de roteiros e pesquisas para coleta de inteligência no ponto de venda.

Vídeo Explicativo: Criação de Questionários e Perguntas
YouTube

Conceitos & Regras de Validação

  • Tipos de Resposta Suportados: Texto Livre, Múltipla Escolha, Seleção Única, Numérico (contagem de itens), Avaliação por Nota (1 a 5 estrelas) e Fotos Obrigatórias.
  • Obrigatoriedade e Travas de Envio: Perguntas podem ser marcadas como mandatórias, bloqueando a finalização da visita se não forem respondidas.
  • Segmentação por Marca e Canal: Exibição do questionário somente para os PDVs que atendem a marca ou canal selecionado na campanha.
  • Inteligência de Mercado: Coleta estruturada de dados sobre ruptura de estoque, preços da concorrência e conformidade do merchandising.
06 Campanhas & Materiais Pendente

06. Planejamento & Cadastro de Campanhas

Estruturação da ação de trade marketing: vigência, materiais promocionais e público-alvo.

Vídeo Explicativo: Cadastro e Parâmetros de Campanhas
YouTube

Conceitos & Regras de Validação

  • Dados Estruturais da Campanha: Nome da ação, depositante vinculado, data de início e término e canais de atendimento elegíveis.
  • Vinculação de Materiais Promocionais: Associação das peças de merchandising (ilhas pallets, wobblers, stoppers, displays e adesivos).
  • Associação com Questionários: Definição de quais roteiros de perguntas serão aplicados pelo promotor durante as visitas da campanha.
  • Segmentação de PDVs: Seleção dos pontos de venda que farão parte da ativação, permitindo filtros por região, rede ou canal.
07 Ordens de Serviço (O.S.) Pendente

07. Gestão, Abertura e Histórico de Ordens de Serviço (O.S.)

Fluxo operacional completo dividido em 3 etapas práticas: vistoria de PDV, positivação de campanha e consulta de comprovantes.

Aula 7.1: Abertura de Chamado & Tipos de O.S. (Positivação, Vistoria, Manutenção e Desmonte)
YouTube

7.1 Regras & Passo a Passo: Abertura de Chamado

  • Vínculo à Campanha ou Vistoria Prévia: Abertura do chamado selecionando a Campanha ativa (materiais e manuais) ou perfil de inspeção de loja.
  • Seleção do Perfil de Atendimento: O tipo de atendimento (Instalação, Inspeção/Vistoria, Manutenção ou Retirada) é configurado dinamicamente através do Perfil selecionado.
  • Agendamento & Atribuição: Definição da data limite prevista e atribuição ao Promotor responsável pela rota.
  • 💡 Variações Operacionais (Vistoria, Reparo e Desmonte):
    Para abrir uma Vistoria Prévia de Ponto, uma Manutenção (display danificado) ou Retirada/Desmonte, o fluxo no formulário é idêntico: basta selecionar o Perfil de Atendimento correspondente!
Aula 7.2: Atendimento e Execução do Chamado pelo Aplicativo Mobile
YouTube

7.2 Execução em Campo pelo Promotor

  • Rotas e Agendamentos no Smartphone: O promotor consulta suas visitas programadas do dia com detalhes do PDV e contato da loja.
  • Validação de Presença por Raio GPS: Ao chegar no ponto, o app realiza a validação de Geofencing para confirmar presença e liberar o início do atendimento.
  • Materiais e Manual de Instruções: Visualização dos materiais previstos e consulta ao PDF de guia de montagem da campanha.
  • Captura em Três Ângulos Obrigatórios: Registro fotográfico do ponto (Frontal, Lateral e Detalhe) com carimbo de coordenadas e hora.
  • Pesquisa de Campo & Assinatura Digital: Coleta das respostas aos questionários da ação e assinatura do gerente da loja na tela do celular.
Aula 7.3: Consulta de O.S., Comprovantes & Assinatura Digital
YouTube

7.3 Comprovação & Prestação de Contas ao Cliente

  • Tela de Detalhes da O.S.: Acesso ao relatório completo com linha do tempo de status (Agendado → Em Campo → Auditado → Concluído).
  • Galeria de Fotos do Atendimento: Visualização em alta resolução dos 3 ângulos exigidos (frontal, lateral e detalhe), com carimbo de data, hora e GPS.
  • Assinatura Digital do Gerente: Registro da assinatura coletada na tela do smartphone pelo promotor, com nome e cargo do responsável na loja.
  • Histórico do PDV: Rastreabilidade de todas as visitas realizadas na mesma loja ao longo dos meses.
08 Inteligência Artificial Pendente

08. Auditoria Inteligente e IA nas Fotos de Campo

Visão computacional automatizada para conferir conformidade de gôndolas e fachadas.

Vídeo Explicativo: Auditoria Automatizada com IA
YouTube

Conceitos & Regras de Validação

  • Visão Computacional Automatizada: Avaliação de fotos de gôndola e fachada em segundos através de modelos de IA integrados à API (Google Gemini Vision).
  • Score de Confiança: Cálculo percentual de assertividade da imagem (iluminação, foco, enquadramento e visibilidade das peças).
  • Filtro Antifraude de Imagens: Detecção de fotos de telas de computador, imagens repetidas ou capturas fora do contexto do PDV.
  • Mesa de Auditoria do Supervisor: Aprovação rápida em lote ou reprovação com justificativa para reabertura de visita.
09 Operação em Campo Pendente

09. Regras Operacionais, GPS e Execução no App Mobile

A experiência do promotor: geofencing, fotos com câmera nativa, assinatura digital e modo offline.

Vídeo Explicativo: Execução em Campo no App Mobile
YouTube

Conceitos & Regras de Validação

  • Trava de Distância GPS (Geofencing): O promotor só consegue iniciar o check-in se estiver fisicamente dentro do raio configurado no PDV (validação segura por Haversine no backend).
  • Câmera Nativa Obrigatória: Bloqueio total de fotos antigas salvas na galeria do celular. As fotos são tiradas na hora com carimbo de coordenadas, data e hora nos metadados.
  • Modo Offline Resiliente: Se o PDV não tiver sinal de internet (subsolos de shopping/mercados), o promotor executa a visita normalmente e o app sincroniza quando o sinal retornar.
  • Assinatura Digital & Fechamento: Coleta da assinatura do gerente do PDV direto na tela do smartphone e emissão do comprovante digital de positivação.