[edersoares]

Contexto

Análise do uso do Frontier no i-Educar (UI Nuxt sob /new, proxy) apontou quatro pontos fracos no
FrontendProxyController: sem timeout, status HTTP não repassado, cache em arquivo inutilizável em produção,
e nenhuma forma de fixar a versão da UI por tenant. Durante a implementação apareceram mais dois bugs:
parsing de segmentos das regras e caminho duplicado (host/web/web) para regras com prefixo.

Cada mudança é um commit isolado, com teste próprio. Cobertura de testes em 100% do início ao fim.

Mudanças

Correções

• Segmentos cache e methods(...) de uma regra passam a valer em qualquer posição, não só como último segmento.
• O caminho pedido ao host agora espelha o do navegador, inclusive barra final. Antes uma regra com prefixo
  (/new) pedia host/new/new em vez de host/new.
• A query string, antes descartada em GET/HEAD, é repassada ao host e entra na chave de cache.

Funcionalidades

• O status HTTP do host é repassado ao cliente. Um 404/500 do CDN deixa de virar 200, e respostas com
  falha não são cacheadas.
• Timeouts explícitos (FRONTIER_PROXY_TIMEOUT, FRONTIER_PROXY_CONNECT_TIMEOUT). Falha de conexão responde
  504 em vez de travar o worker do PHP-FPM.
• Cache do proxy migrado de arquivo por servidor para a Cache facade, chaveado pela URL final (host + uri +
  query), com TTL configurável e header X-Frontier-Cache: hit|miss.
• Fallback "stale": a última cópia boa é servida com 200 quando o host responde 5xx ou não responde,
  enquanto 4xx continua sendo repassado como está.
• Frontier::resolveUrlUsing() permite resolver a URL do proxy em tempo de requisição, por exemplo para
  fixar a versão da UI por tenant.

Docs

• README: tabela de segmentos das regras, envs novas, comportamento do cache e do fallback, exemplo do
  resolver, e nota de que essas melhorias valem só para o tipo proxy (o tipo http mantém o cache antigo).
• Duas envs pré-existentes que nunca tinham sido documentadas (FRONTIER_DEFAULT_ENABLED,
  FRONTIER_PROXY_ENABLED) e um typo antigo na descrição de FRONTIER_CACHE.

Breaking change

O cache do proxy não é mais limpo por php artisan view:clear. Agora é php artisan cache:clear, ou apontar
FRONTIER_PROXY_CACHE_STORE para um store dedicado que possa ser limpo isoladamente.

Validação

• composer test (Pest): 42 passed.
• XDEBUG_MODE=coverage vendor/bin/pest --coverage: 100.0% em todas as classes.
• composer lint (Pint): sem alterações pendentes.

🤖 Generated with Claude Code