# 🦅 O Blueprint Pralog: O que Importar para a Plataforma

Ao analisar o repositório `grupo_pralog_github_import` (Pralog Local Stack), identificamos padrões de engenharia de elite que resolvem as principais lacunas do `PlatformSistemas`.

## 1. Infra-as-Code (O "Prato Principal")
O projeto `PlatformSistemas` é código "cru" (raw), enquanto a stack Pralog é uma cozinha industrial completa.

- **Docker-Compose Unificado:** Define bancos de dados (Postgres 15), Object Storage (Minio), Redis e Nginx em um único orquestrador.
- **Nginx como Gatekeeper:** O `nginx.conf` da stack Pralog já inclui compressão Gzip e fallback de SPA real.
- **Dockerfile Multi-Stage:** O front-end é buildado e servido em containers Alpine minúsculos, garantindo imutabilidade entre dev, staging e prod.

> [!TIP]
> **Ação Recomendada:** Copiar o `prafrota-ui.Dockerfile` e o `nginx.conf` para a raiz do `PlatformSistemas`, adaptando o build para Vite.

## 2. Arquitetura Nx Monorepo (Back-end & Libs)
A stack Pralog utiliza **Nx**, permitindo que a lógica de negócio seja compartilhada e testada isoladamente em `/libs`.

- **Libs Core (Prisma):** Toda a modelagem de dados está encapsulada em uma biblioteca core.
- **Schema Separation:** Uso de `POSTGRES_HOST_AUTH_METHOD: scram-sha-256` e separação lógica de Tenants.
- **Encapsulamento de Integrações:** Bibliotecas específicas para integrações (S3, AWS) que evitam o espalhamento de chaves de API pelo código.

## 3. Lógicas que Devem Ser Adotadas

### A. Fluxo de Autenticação Centralizado
A stack Pralog define segredos JWT específicos para cada tipo de usuário (Tenant, API, Driver) no `docker-compose.yml`. No `PlatformSistemas`, essa separação existe no `App.jsx`, mas falta uma camada de segurança robusta no transporte/infra.

### B. Gestão de Documentos (Minio/S3)
A stack Pralog já vem com uma infraestrutura de Minio configurada. O `PlatformSistemas` pode herdar essa lógica para o módulo de "Cadastro de Motorista" e "Prafrota", substituindo uploads diretos por um sistema de Object Storage persistente.

---

## 🎭 MESA REDONDA: O VEREDITO

**[Tony Stark]:** "O monorepo Nx é o Santo Graal aqui. Se o `PlatformSistemas` quer crescer para RH, Financeiro e Frota sem virar um espaguete, ele precisa da estrutura de `libs` da stack Pralog. É modularidade atômica."

**[Gus Fring]:** "A infraestrutura do local-stack é aceitável. O uso do Nginx para proxyar a API remove problemas de CORS e melhora a segurança. É o padrão mínimo de profissionalismo."

**[Logan Roy]:** "A stack Pralog tem o que o PlatformSistemas não tem: **Estrutura de Poder**. Ela dita como o sistema escala. Parem de brincar com pastas 'Copia' e tragam o Docker agora."

---

## ✅ CHECKLIST DE IMPORTAÇÃO
1.  [ ] **Infra:** Trazer `docker-compose.yml`, `nginx.conf` e criar `Dockerfile.vite`.
2.  [ ] **Dados:** Adotar o padrão de volumes externos para persistência do Postgres.
3.  [ ] **Secrets:** Mover as variáveis de ambiente do `App.jsx` para o ecossistema de chaves do Docker.