Geolocalização de clientes

Fase I - Estudo

Objetivos

Desenvolver uma PoC que, utilizando um consumer de um tópico Kafka, envie mensagens contendo chamadas, anúncios e promoções para clientes dentro de uma área referente à posição geográfica de determinada estação radio-base ,

Desenvolver uma PoC que, por meio de um sistema que lê mensagens de um tópico Kafka, envie chamadas, anúncios e promoções para clientes localizados na área de cobertura de uma determinada estação rádio-base.

Conceito

A pesquisa é impulsionada pela necessidade de comunicação eficiente e imediata com os clientes, especialmente em ambientes urbanos onde a concorrência é alta. Assim, insere-se no contexto macro do marketing digital, utilizando tecnologias móveis para alcançar os consumidores.

Há empresas que já utilizam tecnologias de geofencing (exemplo McDonalds [[1]] para identificar quando um cliente que pediu, por exemplo, pelo aplicativo, está chegando para retirar ou enviar promoções a clientes que estão nas proximidades de suas lojas.

Em um nível mais social, também estamos com um projeto semelhante envio de mensagens para pessoas de acordo com riscos climáticos em determinada localização Alerta Inteligente.

Podem existir horizontes para esse tema em automação de campanhas e até mesmo integrações com IA, que busquem maior assertividade, por exemplo, no público-alvo.

Características e Tecnologias 

Apache Kafka: Plataforma de streaming distribuído usada para construir pipelines de dados em tempo real, que envolve os componentes abaixo.

• Kafka Producer: Responsável por enviar mensagens para um tópico Kafka. As informações abrangem dados dos clientes conectados, como o número de telefone, e dados da torre em que o dispositivo está conectado, como o ponto de geolocalização.
• Kafka Topic: Um canal de comunicação onde as mensagens são publicadas pelo producer e consumidas pelo consumer.
• Kafka Consumer: O componente que consome as mensagens do tópico Kafka e as processa para posterior envio via SMS ou WhatsApp.

API de Mensagens (SMS/WhatsApp): Serviço para envio de mensagens (seja próprio ou terceiro).

Linguagem de Programação: Principalmente Python e outras que supram a necessidade de uma interface de registro das promoções.

Desafios:

• Gerenciamento de Volume de Dados: Lidar com grandes volumes de dados e garantir que o sistema continue performando bem sob alta carga.
• Conformidade com a LGPD na implementação pós PoC: Garantir que o sistema esteja em conformidade com as leis de proteção de dados, obtendo consentimento dos usuários e protegendo suas informações pessoais.

Estudo Dirigido

Características principais da tecnologia:

• Apache Kafka, plataforma de streaming distribuído usada para construir pipelines de dados em tempo real.
• API de Mensagens (SMS/WhatsApp): Serviço para envio de mensagens.

Para aprofundar a viabilidade do projeto, as seguintes atividades deverão ser conduzidas:

• Configuração de fluxos para controle do envio das promoções de forma automática.
• Avaliação das normas de LGPD, em relação ao consentimento dos clientes.
• Validação do código com a equipe de segurança da informação.

Fase II - Ensino

Conteúdo

Material da apresentação final inclui:

• Vídeo contextualizando sobre do caso de uso
• Vídeo explicando o código
• Vídeo demonstrando a aplicação rodando
• Vídeo da apresentação final
• https://www.canva.com/design/DAGp84_SLR8/uHX1kJw9ixG8KZ5Fyab7TQ/edit?ui=eyJIIjp7IkEiOnRydWV9fQ

Apresentação

O projeto foi apresentado dia 12/06/2025 para:

• Matheus Pereira dos Santos (Product Manager- Algar Telecom)
• Saymon Yury Costa Silva (Consultor em Tecnologia - Algar Telecom)

Metodologia

Descrevas as metodologias usadas. Alguns exemplos:

Estratégia de Job Rotation
Estudos básicos para conhecimento do potencial
Estudos básicos para entendimento sobre o problema
Estudos para dar base aos pesquisadores
Benchmarking com empresas estrangeiras 
Aceleradoras de empresas
Adoção de novas tecnologias
Utilização da proposta de soluções Open-source
Priorização no desenvolvimento interno
Foco na não dependência de fornecedores
Prática de formação dos talentos necessários 

Hipóteses

 Que questões envolvem a pesquisa? 
O que se espera provar?
O que se espera como resultado?
Explicações e argumentos que subsidiem a investigação em curso

Fase III - Exemplo de Caso de Negócio

Product Backlog

Descreva os requisitos deste projeto

Benefícios para quem for oferecer esta solução

    Descrever em tópicos os benefícios que uma pessoa ou uma empresa podem obter: ganhos, receitas, novos negócios, novos produtos, novas parcerias

Benefícios para o usuário

    Descrever em tópicos os benefícios para os usuários desta solução.
    Pode se inspirar no Canvas.

Direcionadores chave para esta iniciativa

    Descrever em tópicos o que esta iniciativa pode proporcionar

Possíveis modelos de negócios

    Descrever em tópicos os possíveis modelos de negócios

Pesquisa de Mercado e Análise de Tendências

 Coletar dados relevantes sobre o mercado, como tamanho, crescimento, concorrência e comportamento do consumidor. Identificar tendências tecnológicas, comportamentais ou regulatórias que possam impactar o projeto.

Análise de Concorrentes e Soluções Existentes

 Pesquisar e analisar soluções concorrentes ou similares no mercado. Entender como os concorrentes monetizam suas soluções e identificar oportunidades de diferenciação.

Público - Alvo

  Identificar os principais segmentos de clientes (B2B, B2C, etc.). Descrever as características demográficas, comportamentais e necessidades do público-alvo.

Cenários e Oportunidades

  Avaliar a possibilidade de contratar fornecedores externos para acelerar o desenvolvimento. Considerar o desenvolvimento interno da solução, se for viável. Explorar parcerias estratégicas com outras empresas ou investidores.

Premissas Financeiras

  Listar os principais custos envolvidos no desenvolvimento e operação da solução. Estimar a receita esperada com base em projeções de mercado. Considerar reajustes anuais de preços ou custos.

Riscos do Projeto

  Identificar os principais riscos do projeto (tecnológicos, financeiros, de mercado, etc.). Propor estratégias para mitigar os riscos identificados.

Business Case

• Apresentação:
  • https://www.canva.com/design/DAGpayy9hzc/0aryG3PwO05RSyOZtM1zaw/edit?utm_content=DAGpayy9hzc&utm_campaign=designshare&utm_medium=link2&utm_source=sharebutton

Alinhamento com Lei do Bem

• Projeto possui algum elemento tecnologicamente novo ou inovador?

Elemento tecnologicamente novo ou inovador pode ser entendimento como o avanço tecnológico pretendido pelo projeto, ou a hipótese que está sendo testada

• Projeto possui barreira ou desafio tecnológico superável?

Barreira ou desafio tecnológico superável pode ser entendido como aquilo que dificulta o atingimento do avanço tecnológico pretendido, ou dificulta a comprovação da hipótese

• Projeto utiliza metodologia/método para superação da barreira ou desafio tecnológico?

Metodologia/método para superação da barreira ou desafio tecnológico pode ser entendido como aqueles atividades que foram realizadas para superação da barreira ou do desafio tecnológico existente no projeto

• Projeto é desenvolvido em parceira com alguma instituição acadêmica, ICT ou startup?

Se sim, o desenvolvimento tecnológico é executado por associado ou por alguma empresa terceira? qual o nome da empresa? 
Anexar cópia do contrato

Fase IV - Protótipo orientado ao Negócio

Escopo

Explique o escopo deste protótipo

Limitações

Informe sobre as limitações técnicas, comerciais, operacionais, recursos, etc.

PoC

Desenvolva um PoC (Proof of Concept)

Privacidade (LGPD)

• Avaliar condições referentes à Lei Geral de Proteção de Dados

Detalhamento Técnico

Descreva especificamente os aspectos técnicos desta pesquisa

Histórico

Responsável: Luigi Negrini

Obtenção de acessos e liberação de firewall

• Desde 31/10/2024 estamos em processos de obtenção de acesso ao ambiente de homologação. Mesmo que outras atividades/estudos tenham sido feitos, a pesquisa fica travada nesse ponto.
• Em 05/11/2024 foi obtido o primeiro acesso pela blazon (LINUX STREAM-MONIOT-HML), entretanto foi identificado que é necessário um chamado de liberação no firewall pelo Jira SGD (SRV-1009021).
• No dia 17/11/24, houve sucesso na liberação do firewall, mas não consigo acessar o servidor de homologação via Telnet.
• Entre 19/11/24 e 21/11/24 (SRV-1010895), foi validado que ocorre um reset ao chegar no IP destino e, então a tratativa deve ser dada diretamente com o administrador da aplicação. Estou em tentativa de contato com Geovanne para obter um direcionamento.
• 10/12/24 acabamos de identificar com Weglison que os IPs que solicitamos acesso pelos chamados anteriores não são especificamente para o ambiente de homologação. Foi solicitada nova regra de firewall (SRV-1018467)
• 12/12/24 a regra foi atendida e houve o mesmo problema de possivelmente a aplicação barrar a conexão. Conversando com Weglison, foi entendido que a aplicação não barra a conexão, entretanto para identificar os possíveis problemas é necessário um troubleshooting juntamente com o criador da regra de firewall. O troubleshooting se deu hoje (18/12/24) pela manhã. O próximo direcionamento é conversar com o pessoal de rede e fazer novos testes tentando acessar a aplicação já com um consumidor.py do tópico kafka.
• 27/12/24 consegui consumir o tópico do teste enviado pelo Weglison. Não foi possível consumir o tópico almejado (ACCOUNTING_ENRICHED_STREAM) por erro de código (função decode), mas foi possível conectar!
• 06/01/25 foi informado que haveria um ajuste por parte do Weglison no tópico do Kafka.
• 08/01/25 ajuste no tópico foi concluído.

Desenvolvimento

• 13/01/25 resolvido o problema com a função decode. A obtenção dos dados via código foi realizada de forma completa.
• 14/01/25 desenvolvimento com algoritmo que identifica a distância entre a loja que quer emitir uma promoção e a torre de transmissão a qual estão conectados os dispositivos dos clientes.
• 15/01/25 reunião sobre LGPD (Cell Broadcast, com impacto direto no Geolocalização) - conclusão é que a nível de Poc não há impacto, mas para uma implementação comercial, requer discussão mais detalhada.
• 22/01/25 reunião com Ericson (Cell Broadcast) para conversar sobre a solução com CDRs para obtenção de geolocalização de clientes. E houve a obtenção do mapa de distribuição de ERBs.
• 28/01/25 feita a integração da interface/banco ao consumidor kafka.
• 29/01/25 reunião com Adriano Graziosi e time de SMS para entendermos como funciona o envio de SMS.
• 13/02/25 foram realizados testes de envio SMS no ambiente de homologação, mas não houve sucesso no recebimento do SMS.
• 17/02/25 reunião para entendimento do uso da API para envio de mensagem via WhatsApp.
• 21/02/25 houve a conclusão de que, exclusivamente para os testes desse tema, poderá ser usado o ambiente de produção. Foi solicitada a liberação para o uso do ambiente de produção para envio de SMS.
• 06/03/25 A solicitação foi atendida, os testes foram realizados, mas houve um erro que foi consertado no dia seguinte. Ainda no dia 06, foram recebidos os retornos da reunião do dia 17/02 para realização dos testes para envio via WhatsApp, obtivemos sucesso!
• 07/03/25 Reunião de debug com Israel e sucesso no envio de SMS!
• 11/03/25 Reunião com Cesar Augusto, Weglison e Geovanne para alinhamento sobre obtenção de dados de telefones via tópico kafka de homologação. Para realizar esse desenvolvimento, é preciso configurar uma APN nos dispositivos (inicialmente, Luigi, Paula, Luiz, Xandão e Ivan).
• 13/03/25 Enviado formalmente o e-mail para o Cesar solicitando a configuração da APN. O delay entre o dia 11 e 13 foi decorrente da confirmação de inclusão ou não do número da Eliane nesses testes iniciais; foi entendido que o mesmo entrará apenas para a apresentação contendo a demonstração final.

Pesquisadores

• Luigi Negrini
• Paula Nunes