# ENG-3119 — Medição preliminar de desempenho

## Perfil executado

- Ambiente: container PHP 8.4, PostgreSQL 16.1, banco descartável `rex_test` na porta 5433. O comando `php artisan --env=testing test:database-safety` confirmou o ambiente imediatamente antes da execução.
- Dataset sintético inserido em uma transação e revertido ao final; nenhum dado oficial, saldo ou ERP foi consultado.
- 10.001 produtos no catálogo atual, distribuídos por 100 endereços, com saldo de fixture sem uso na consulta.
- 5.000 produtos com resultado local completo de quantidade zero em inventário aprovado; 5.001 sem aprovação válida.
- 20.002 tarefas abertas e sem responsável em duas rodadas de um inventário iniciado no ano corrente.
- A consulta do domínio foi executada uma vez; `EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON)` foi obtido no mesmo banco de testes.

## Resultado observado

| Medida | Resultado |
| --- | ---: |
| Consultas SQL agregadas da API de domínio | 1 |
| Tempo registrado pelo Laravel para a consulta | 40,32 ms |
| Tempo da chamada de agregação medido em PHP | 41,71 ms |
| Tempo total registrado pelo `EXPLAIN ANALYZE` | 47,61 ms |
| JSON dos agregados retornados pela consulta | 450 bytes |
| Produtos elegíveis / inventariados | 10.001 / 5.000 |
| Pontos mensais / linhas de responsável | 12 / 1 |
| Tarefas agregadas | 20.002 |

O tamanho informado serializa somente os agregados da consulta de domínio; não inclui envelope HTTP nem `generated_at`/`timezone` adicionados pelo serviço.

## Limites e decisão

O perfil sustenta, preliminarmente, que a agregação é de cardinalidade fixa e que tarefas/produtos não são enviados como registros brutos. Não foi necessário criar índice adicional para esse perfil. A medição não é um orçamento formal nem uma garantia de produção: não inclui request HTTP completo, latências p50/p95, execução fria/aquecida, perfil maior comparativo, concorrência ou topologia de produção. O dataset usa linhas sintéticas montadas no banco, não um replay integral de workflows.

Antes do aceite final, acordar o orçamento com a equipe e repetir o perfil representativo e um maior, registrando distribuição de latências e tempo HTTP ponta a ponta. Não extrapolar este resultado para produção.
