# Patch 1.2.1 — Performance e Inteligência Pré-processada

Este patch corrige a lentidão do Patch 1.2 em bases grandes, especialmente no histórico do Cartório Copacabana.

## Principais mudanças

- Marca do sistema padronizada como **FlowReports**.
- Nova tabela `order_intelligence` para guardar dados cartorários normalizados.
- Nova tabela `report_cache` para cache dos cards inteligentes.
- Novo serviço `OrderIntelligenceService`.
- Importador XML passa a preencher a inteligência automaticamente a cada pedido importado/atualizado.
- Botão **Reprocessar inteligência** na tela Cartório inteligente.
- Cards inteligentes passam a ler de `order_intelligence`, evitando `LIKE` em milhares de metadados.
- Conferência operacional paginada.
- Relatórios com destaque visual para:
  - total de entrega/pedidos;
  - total de frete;
  - total geral.
- Carregamento progressivo: a tela Cartório inteligente não dispara a análise pesada automaticamente.

## Como aplicar

1. Faça backup dos arquivos e do banco.
2. Envie os arquivos do patch para a raiz do sistema, sobrescrevendo os existentes.
3. Execute no phpMyAdmin:

```sql
source database/migrations/2026_06_04_patch_1_2_1_performance_inteligencia.sql
```

Ou copie e cole o conteúdo da migration.

4. Acesse **Cartório inteligente**.
5. Clique em **Reprocessar inteligência** algumas vezes até o painel informar que não há mais pedidos pendentes.

## Observação sobre bases grandes

O reprocessamento trabalha em lotes. Em bases com mais de 30 mil pedidos, execute o botão repetidamente ou use o endpoint com cron/terminal:

```text
public/api.php?action=intelligence_reprocess&limit=500
```

Para uso via navegador, o botão usa limite conservador para evitar timeout.
