# 🔋 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.
