teste
/
testes
Template
2
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects 1 Releases Wiki Activity
testes/brain_docs/PRALOG_POWER_UPS.md

3.0 KiB
Raw Blame History

🔋 Pralog Power-ups: Recursos Avançados para o PlatformSistemas

Além da infraestrutura e dos contratos, o repositório da Pralog contém "joias" de lógica que podem elevar o nível técnico dos módulos de Gestão de Risco (GR) e Frota.

1. Segurança de Dados (Cryptography v2)

O PlatformSistemas usa uma criptografia simples (Base64 + reverse) no front-end. A Pralog utiliza uma classe Cryptography robusta com AES-256-CBC.

  • Oportunidade: Implementar o padrão de IV_LENGTH: 16 e createCipheriv para tokens sensíveis no api.js.
  • Benefício: Proteção real contra interceptação e leitura de localStorage em caso de XSS.

2. Busca e Filtros Inteligentes (String Normalizer)

A Pralog possui um string-normalizer.ts que permite buscas insensíveis a acentos, espaços extras e caracteres especiais.

  • Oportunidade: Portar a função normalizeStringForComparison para o front-end do PlatformSistemas.
  • Benefício: Melhoria drástica na UX de busca de placas, nomes de motoristas e fornecedores, evitando que o usuário não encontre um item por causa de um "ç" ou um espaço.

3. Wrappers de Integração (KYC & Risco)

A Pralog já tem implementado o "suporte de vida" para integrações críticas:

  • IDWall: Para validação de documentos e background check.

  • Brasil Credit: Para análise de crédito de motoristas/fornecedores.

  • Planner: Para agendamentos e fluxos logísticos.

  • Oportunidade: No módulo GR (Gestão de Risco) do PlatformSistemas, em vez de refazer a lógica de integração, use os wrappers da Pralog como template.

  • Benefício: Redução de meses de desenvolvimento ao reaproveitar o tratamento de erros e o mapeamento de campos dessas APIs externas.

4. Normalização de Datas & Moedas

O arquivo date-converter.util.ts da Pralog resolve o pesadelo de fusos horários e formatos brasileiros (DD/MM/YYYY vs ISO).

  • Oportunidade: Unificar o tratamento de datas em todas as colunas de estatísticas do Prafrot.
  • Benefício: Fim das inconsistências visuais onde uma data aparece em formato americano e outra em brasileiro no mesmo painel.

🏛️ O VEREDITO FINAL DA MESA REDONDA

[Tony Stark]: "A classe de Criptografia da Pralog é o que separa um brinquedo de uma ferramenta de enterprise. Se o PlatformSistemas quer ser levado a sério, ele precisa parar de brincar de 'atob/btoa' e usar AES real."

[Elliot Alderson]: "Eles normalizam as strings antes de comparar. Isso previne falhas de lógica em filtros sensíveis. É simples, é elegante, e o PlatformSistemas precisa disso ontem."

[Gus Fring]: "A integração com IDWall e Brasil Credit é meticulosa. O tratamento de retentativas e timeouts já está lá. Errar uma integração de risco é caro; herdar o que já funciona é prudente."

✅ DICA TÉCNICA (THE STEAL): Copie o arquivo backend/libs/core/src/utils/string-normalizer.ts da Pralog e transforme em um hook useNormalizer no seu projeto. Isso vai resolver 90% das reclamações de 'filtro que não funciona' no front-end.