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

3.0 KiB
Raw Blame History

🦅 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.