Este documento será um guia de link´s e fluxos e diagrams para melhor entendimento do processo de Central PDV.

Conteúdo Relevante

🧠  Integração TOTVS PDV

Documentação Oficial da Integração TOTVS PDV

📊  Monitor da Integração de Dados do TOTVS PDV

Documentação Oficial de configuração do Monitoramento TOTVS PDV

🪪  Sincronismo de Usuários via arquivo Protheus

O Framework TOTVS criou uma funcionalidade para exportar e importar estruturas de acesso de usuários, incluindo Menus através de 3 rotinas.

criamos uma camada para utilização dessa ferramenta em nosso processo.

🧰 Tecnologias que utilizam

🙋🏻‍♂️ RMIINTEUSR - Atualização de senhas de usuário (RmiInteUsr SFTP)

Ferramenta criada para Importação e Exportação de usuários utilizando servidor SFTP ( como o do T-CLOUD ) de forma assíncrona.

🙎🏻‍♂️ RMISENHAS - Função para atualização de senhas de usuário

Ferramenta criada para a Importação de usuários de forma síncrona.

📅  Configuração Schedule Protheus 

Detalhes do processo de configuração de Schedule, utilizado na Central PDV e Retaguarda para agendamento da rotina RMIINTEUSR

📐Hardware Mínimo Recomendável (Sizing)

Informações Referentes as configurações mínimas para o funcionamento do TOTVS Protheus.

🧠 Arquitetura Protheus

🧰 Tecnologias Utilizadas

⚙️ Protheus

🖥  TOTVS APPSERVER - Application Server

🛢️ TOTVS DBACCESS com PostgreSQL

🔑 TOTVS License Server Virtual 

🐘 PostgreSQL

🤝 Protheus com PostgreSQL
🐧 Instalação do PostgreSQL em Linux
📢 PostgreSQL - Informações Importantes
👉Postgres - Compatibilidade - DBAccess

🐧 Linux

🧩Protheus em Linux - Instalação

🎭Compatibilidade DBACCESS

✅Compatibilidade APPSERVER

🔗ODBC - Como fazer para criar uma fonte de dados para uso com o PostgreSQL - Linux

📆 JOBs Principais

🏭( RETAGUARDA ) RMIPUBLICA – Publicação de dados

🏭( RETAGUARDA )  RMIENVIAPDV – Envio de retorno do PDV

📍 ( CENTRAL PDV ) RMIIntePDV – Responsável por processar dados de grupos específicos de tabela

📑Gerenciamento de LOGS

O processo de integração utiliza log´s para analise das integrações nas Centrais PDV´s e Retaguarda.

A Ferramenta escolhida foi o https://fluentbit.io/ utilizado na engenharia e com Agent´s distribuídos nas Centrais e Retaguarda.

Processo de configuração dos Agentes FluentBit:

Central PDV - Configuração Agente Fluentbit LogClient Protheus

🔁 Fluxos e Comunicação

📈 Fluxo da Informação

Importante que a estrutura de comunicação entre Retaguarda e Central PDV estejam sem obstruções e bem mapeadas, alguns destaques:

🌐 Infra de Rede

• 🌍 IPs
  Acessos a redes do cliente exigem conexão VPN na estrutura
• 🚪 Portas
  Importante analise de portas caso ocorram falhas de comunicação TELNET <IP> <PORTA>
• 🔥 Firewalls
  • 📋 Abertura de Chamados: https://atendimento-totvs.atlassian.net/servicedesk/customer/portal/57/group/775
    
    

🧑‍💻 Acessos Controlados

• 🔐 SFTP
  O Acesso ao TCLOUD para arquivos é via SFTP e geralmente utilizamos WINSCP/Filezilla para analise.
• 🖥 SSH Por padrão, após o acesso via VPN os servidores Linux são acessados via SSH.

🛠 Ferramentas Essenciais

🐧 Linux

• Comandos básicos (ls, cat, tail, grep, etc.)
• 

🐘 PostgreSQL

• SELECTs simples
• Consulta de logs
• Estrutura de tabelas

📂 WinSCP / SSH

• Upload de arquivos
• Alteração de permissões

🎥 Vídeos

Treinamento NovaCarga - DEZ/2024 - https://drive.google.com/file/d/110ZbRnBVGO4zmgvj6RMahs-EhbISuE7P/view

⌛Documentação Legado ( Antigas )

https://centraldeatendimento.totvs.com/hc/pt-br/articles/235656187-Central-de-PDVs 04/08/2022

https://tdn.totvs.com/pages/releaseview.action?pageId=799267436 - 18/10/2023

👋 Contexto do Projeto FORTBRAS

🧠 Arquitetura da Solução

📡 Retaguarda (Protheus Cloud)
🏪 Central PDV (Local)

🧰 Tecnologias Utilizadas

• ⚙️ Protheus
• 🐘 PostgreSQL
• 🐧 Linux
• ☁️ TCloud

🔁 Fluxos e Comunicação

📈 Fluxo da Informação
Carga Inicial 🔁 Carga Incremental

🌐 Infra de Rede

• 🌍 IPs
  Acessos a redes do cliente exigem conexão VPN na estrutura deles ( destaque Fortbras )
• 🚪 Portas
  Importante analise de portas caso ocorram falhas de comunicação TELNET <IP> <PORTA>
• 🔥 Firewalls
  • 📋 Abertura de Chamados: https://atendimento-totvs.atlassian.net/servicedesk/customer/portal/57/group/775
    🙋Fabio Aquino ( Apoio DATA NETWORK )

📊 Métricas

• 📦 Registros por segundo
  Cliente acompanha processamento de dados de acordo com tempo;
• 🔢 Volume de dados
  Grandes quantidades de dados são ofensores de performance;
• 📋 Leitura e interpretação de logs Os Log´s são Centralizados numa estrutura;

🔐 Segurança da Informação

🧑‍💻 Acessos Controlados

• 🔐 SFTP
  O Acesso ao TCLOUD para arquivos é via SFTP e geralmente utilizamos WINSCP/Filezilla para analise.
• 🖥 SSH Por padrão, após o acesso via VPN os servidores Linux são acessados via SSH.

🪪 Tokens de Integração

• Gerados de forma segura O Cadastro do usuário pode expirar , geralmente usado na configuração da conexão
• Validação periódica

🧾 Logs e Auditoria

• 👀 Monitoramento de ações críticas
• 🕵️‍♂️ Rastreabilidade

🛠 Ferramentas Essenciais

🐧 Linux

• Comandos básicos (ls, cat, tail, grep, etc.)

🐘 PostgreSQL

• SELECTs simples
• Consulta de logs
• Estrutura de tabelas

📂 WinSCP / SSH

• Upload de arquivos
• Alteração de permissões

📝 Monitoramento via Logs

• Análise de appserver.log, runtask.log, syslog

🧱 Infraestrutura

🌐 Topologia do Ambiente

🖥 Servidores

• Banco de Dados
• Aplicação
• Pontos de Venda (PDV)

📊 Monitoramento

• CPU 🔥
• Memória RAM 📈
• Disco / I/O 📉

☁️ TCloud

🔗 Integração com TCloud

• API REST
• Token JWT

📤 Publicação de Dados

• JOBs configurados
• Respostas tratadas via logs

🛑 Logs e Falhas Comuns

• Timeout
• Token inválido
• Dados inconsistentes

🧪 Análise de Problemas

🚨 Erros de Integração

• Falha no envio
• Falta de retorno

📂 Logs da Retaguarda e do PDV

• RMI*, SIGALOJA, SIGAFAT

📌 Análise de JOBs em Falha

• Checagem de logs
• Dependência entre rotinas
• Recomendações de correção

💡 Dica Final

🧭 Documente sempre os passos realizados
🧰 Use as ferramentas com consciência
🙌 Compartilhe conhecimento com a equipe

📸 Imagens sugeridas para incluir:

• Tecnologia & servidores
• Segurança da Informação
• Ambientes Linux

🎓 Bora dominar tudo isso juntos!