46 lines
3.0 KiB
Markdown
46 lines
3.0 KiB
Markdown
# 🔋 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.
|