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:
* 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
- Acesse a URL do sistema fornecida pela empresa
- Clique em "Primeiro Acesso"
- Insira seu CPF e aguarde verificação
- Crie uma senha segura
- Faça login com CPF e senha
7.2. Realizando uma Visita (Promotor)
- Na tela inicial, visualize seu roteiro do dia
- Selecione a loja a visitar
- Realize o check-in (geolocalização automática)
- Selecione o(s) cliente(s) a atender
- Para cada cliente, preencha as abas: Estoque, Preços, Rupturas, Avarias, Pontos Extras, Datas Críticas
- Capture fotos pré-abastecimento
- Registre o abastecimento
- Capture fotos pós-abastecimento
- Finalize o cliente e continue com o próximo
- Ao finalizar todos os clientes, faça o checkout
7.3. Acessando Relatórios (Gestor)
- Acesse "Relatório de Visitas" no menu
- Use filtros por status ou período
- Clique em uma visita para ver detalhes
- Exporte dados em JSON ou use a API
7.4. Gerando Book de Fotos
- Acesse "Photo Book" no menu
- Selecione o cliente desejado
- Defina o período (data início e fim)
- Escolha entre ZIP (fotos organizadas) ou PDF (apresentação)
- 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
