61 lines
4.0 KiB
Markdown
61 lines
4.0 KiB
Markdown
# 🎯 O PONTO CENTRAL: Relatório de Consolidação Estratégica
|
||
|
||
Este relatório une o potencial do **PlatformSistemas** com a robustez do **Pralog Local Stack**, traçando o mapa definitivo para a excelência técnica.
|
||
|
||
---
|
||
|
||
## 1. Interpretação dos Sistemas
|
||
|
||
### PlatformSistemas: "O Gateway Dinâmico"
|
||
Focado em agilidade e flexibilidade. O projeto utiliza arquivos de configuração (`.json`) para tentar automatizar a interface. É uma abordagem moderna de **"UI driven by metadata"**, mas que sofre com a falta de uma infraestrutura que sustente essa complexidade.
|
||
|
||
### Pralog (GitHub Import): "A Fortaleza Arquitetônica"
|
||
Focado em estabilidade e escala. Utiliza **Nx Monorepo**, garantindo que uma mudança na lógica do banco de dados (Prisma) reflita imediatamente em todos os serviços. É o exemplo de **"Infrastructure as Code"** perfeito.
|
||
|
||
**A Melhoria:** O `PlatformSistemas` deve herdar a **infraestrutura** da Pralog para sustentar sua **lógica dinâmica**.
|
||
|
||
---
|
||
|
||
## 2. Resolução dos Problemas Críticos
|
||
|
||
### 🔌 Problema 1: Custo de Conexão Front-Back
|
||
* **Diagnóstico:** Escrever um `Service.js` para cada entidade do JSON está gerando trabalho manual duplicado.
|
||
* **A Resolução (Service Factory):** Criar um `BaseService` que interprete o JSON nativamente.
|
||
* **Ação:** Implementar um hook genérico `useContract(routeKey, params)` que use o `apiRouteManager` para resolver a URL e o `TanStack Query` para gerenciar o cache.
|
||
* **Resultado:** Conectar uma nova entidade passa a ser apenas adicionar uma linha no JSON, sem criar arquivos JS extras.
|
||
|
||
### 🔡 Problema 2: Falha no Sistema de Fontes
|
||
* **Diagnóstico:** O sistema define variáveis de fonte mas não as injeta no ciclo de vida do navegador de forma prioritária.
|
||
* **A Resolução (Hydration Loop):**
|
||
1. **Injeção Crítica:** Adicionar `@import` ou `<link>` no topo do `index.html` com `crossorigin`.
|
||
2. **CSS Var Mapping:** Vincular as variáveis do Tailwind 4 diretamente às CSS Variables do `:root` no `index.css`.
|
||
3. **Font-Swap:** Usar `font-display: swap` para evitar que o texto desapareça enquanto a fonte carrega.
|
||
|
||
### 📱 Problema 3: Problemas de Responsividade
|
||
* **Diagnóstico:** O uso de visual viewport (`vw/vh`) puro causa quebras em monitores ultrawide ou telas muito pequenas. O `radius: 1vw` é o maior culpado.
|
||
* **A Resolução (Calculated Responsiveness):**
|
||
* **Ação:** Migrar todos os valores fixos para a escala **Modular Clamp**.
|
||
* **Exemplo:** `padding: clamp(1rem, 2vw, 2.5rem)` – isso garante que o padding nunca seja ridiculamente pequeno nem gigante.
|
||
* **Radius:** Mudar para `round(min(12px, 1.5vw))` para manter a harmonia visual.
|
||
|
||
---
|
||
|
||
## 3. Melhorias na Organização do Front-end
|
||
|
||
1. **Arquitetura "Screaming Features":**
|
||
Mover tudo o que é específico de uma feature para dentro da pasta dela (incluindo Mocks e Types). Atualmente, há muita dispersão entre `src/services` e `src/features`.
|
||
2. **Centralização de Interceptores:**
|
||
Unificar a lógica de erro 401/403 (já iniciada no `api.js`) em um `AuthObserver` que não dependa de `window.location.href`, mas sim do router do React para transições suaves.
|
||
3. **Purga de Legado Automática:**
|
||
Adicionar um script no `package.json` (`npm run audit:clean`) que detecte arquivos em `descontinuado/` que não são mais importados no `App.jsx` e os mova para fora do diretório de build.
|
||
|
||
---
|
||
|
||
## 🏛️ O VEREDITO DA MESA REDONDA
|
||
|
||
**[Tony Stark]:** "Se você quer que essa API e esse Front parem de brigar, use o modelo de **Contracts** da Pralog. Defina o schema uma vez e gere o resto. O `PlatformSistemas` já tem os JSONs, só faltava a coragem de automatizar o `axios`."
|
||
|
||
**[Gordon Ramsay]:** "O seu layout não é responsivo, é uma gelatina! Use `clamp()` ou saia da minha frente! E tragam as fontes do Google de forma correta, não quero ver Times New Roman na minha tela nunca mais!"
|
||
|
||
**[Logan Roy]:** "Parem de criar pastas de backup. Se você não usa, morre. O Ponto Central é este: **Consolide as ferramentas da Pralog para salvar a agilidade do PlatformSistemas.**"
|