Icatu Brasil

Farol Trade

Documentação do App

Informações técnicas e operacionais

1. Informações Gerais

Título do Sistema:

FAROL TRADE - Sistema de Gestão de Trade Marketing

Data de Criação:

Dezembro de 2025

Data de Publicação:

Janeiro de 2026

Versão Atual:

2.0.0

2. Linguagens de Programação e Tecnologias

Frontend: JavaScript (React 18.2.0)

Backend: JavaScript/TypeScript (Deno Runtime)

Estilização: CSS (Tailwind CSS 3.x)

Banco de Dados: PostgreSQL

Bibliotecas Principais: React Router, React Query, Framer Motion, Lucide React, JSPdf, JSZip

3. Campos de Aplicação

Gestão de Trade Marketing e Merchandising

Controle de Visitas em Pontos de Venda (PDV)

Monitoramento de Estoques e Preços

Gestão de Equipes de Promotores

Relatórios e Análises de Performance

Registro de Ocorrências (Rupturas, Avarias, Datas Críticas)

4. Tipo de Programa

Classificação: Aplicação Web Progressiva (PWA)

Categoria: Sistema de Gestão Empresarial (ERP - Trade Marketing)

Modalidade: Software como Serviço (SaaS)

Arquitetura: Cliente-Servidor com APIs RESTful

5. Identificação do Algoritmo Hash

Algoritmo Utilizado:

SHA-256 (Secure Hash Algorithm 256-bit)

Resumo HASH do Sistema:

e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

* Hash calculado sobre os arquivos principais do código-fonte

Componentes Incluídos no HASH:

  • Arquivos de entidades (entities/*.json)
  • Componentes React (components/**/*.jsx)
  • Páginas da aplicação (pages/**/*.js)
  • Funções backend (functions/**/*.js)
  • Arquivo de layout (Layout.js)

6. Funcionalidades do Sistema

6.1. Módulo de Autenticação

  • Login com CPF e senha
  • Controle de acesso por perfil (Promotor, Gestor, Supervisor)
  • Persistência de sessão local

6.2. Gestão de Visitas

  • Check-in/Check-out com geolocalização
  • Registro de estoque (físico e sistema)
  • Captura de preços e promoções
  • Registro de rupturas e justificativas
  • Documentação de avarias com fotos
  • Registro de pontos extras
  • Identificação de datas críticas de validade
  • Registro de abastecimento (pré e pós)

6.3. Módulo de Roteiros

  • Visualização de roteiro semanal
  • Gestão de lojas e clientes por dia
  • Priorização de visitas
  • Histórico de visitas realizadas

6.4. Follow-up e Ocorrências

  • Registro de problemas em lojas
  • Upload de evidências fotográficas
  • Contato com encarregados
  • Acompanhamento de resolução

6.5. Relatórios e Exportações

  • Exportação de dados em JSON
  • Geração de book de fotos (PDF/ZIP)
  • API pública para integração externa
  • Relatórios de visitas com filtros

6.6. Gestão de Equipes (Gestor)

  • Visualização de todas as visitas
  • Criação e gestão de avisos
  • Gerenciamento de usuários
  • Importação de dados em lote
  • Dashboard com métricas

6.7. Funcionalidades Auxiliares

  • Modo offline com sincronização
  • Scanner de código de barras
  • Pesquisa de clima organizacional
  • Solicitações de treinamento
  • Compartilhamento via WhatsApp

7. Guia de Utilização

7.1. Primeiro Acesso

  1. Acesse a URL do sistema fornecida pela empresa
  2. Clique em "Primeiro Acesso"
  3. Insira seu CPF e aguarde verificação
  4. Crie uma senha segura
  5. Faça login com CPF e senha

7.2. Realizando uma Visita (Promotor)

  1. Na tela inicial, visualize seu roteiro do dia
  2. Selecione a loja a visitar
  3. Realize o check-in (geolocalização automática)
  4. Selecione o(s) cliente(s) a atender
  5. Para cada cliente, preencha as abas: Estoque, Preços, Rupturas, Avarias, Pontos Extras, Datas Críticas
  6. Capture fotos pré-abastecimento
  7. Registre o abastecimento
  8. Capture fotos pós-abastecimento
  9. Finalize o cliente e continue com o próximo
  10. Ao finalizar todos os clientes, faça o checkout

7.3. Acessando Relatórios (Gestor)

  1. Acesse "Relatório de Visitas" no menu
  2. Use filtros por status ou período
  3. Clique em uma visita para ver detalhes
  4. Exporte dados em JSON ou use a API

7.4. Gerando Book de Fotos

  1. Acesse "Photo Book" no menu
  2. Selecione o cliente desejado
  3. Defina o período (data início e fim)
  4. Escolha entre ZIP (fotos organizadas) ou PDF (apresentação)
  5. Aguarde o processamento e download

8. Informações Legais

Titular dos Direitos Patrimoniais:

Icatu Brasil Trade Marketing

Obra Derivada:

Não aplicável - Sistema original desenvolvido especificamente para a empresa

Proteção de Dados:

O sistema está em conformidade com a LGPD (Lei Geral de Proteção de Dados)

Registro INPI:

Em processo de registro junto ao Instituto Nacional da Propriedade Industrial

🤖

9. MAYA - Assistente de IA

Desenvolvedor:

Pedro Henrique Ramos

O que é MAYA?

MAYA (My Artificial Your Assistant) é uma assistente de inteligência artificial integrada ao Farol Trade, desenvolvida especificamente para auxiliar os usuários na operação do sistema e otimizar o fluxo de trabalho das equipes de trade marketing.

Configuração:

  • • Acesso via ícone flutuante presente em todas as telas
  • • Disponível 24/7 para todos os perfis de usuário
  • • Processamento de linguagem natural em português brasileiro
  • • Integração nativa com todas as funcionalidades do sistema
  • • Aprendizado contínuo baseado nas interações

Casos de Uso:

  • • Tirar dúvidas sobre funcionalidades do aplicativo
  • • Auxiliar no preenchimento correto de formulários
  • • Explicar processos e fluxos de trabalho
  • • Consultar dados históricos e gerar relatórios rápidos
  • • Fornecer suporte contextual durante as visitas
  • • Automatizar tarefas repetitivas
  • • Sugerir melhores práticas de merchandising
  • • Resolver problemas técnicos comuns

Tecnologia:

Baseada em modelos de linguagem avançados (LLM) com treinamento específico no domínio de trade marketing, merchandising e gestão de PDV. A MAYA utiliza arquitetura híbrida que combina processamento local para respostas rápidas e conexão em nuvem para consultas complexas.

📞 Suporte Técnico

Em caso de dúvidas ou problemas técnicos, entre em contato:

  • • Email: pedro@grupoicatubrasil.com.br
  • • WhatsApp: (71) 99611-3252
  • • Horário: Segunda a Sexta, 07h às 17h