# Infraestrutura e Roteamento V2

A V2 utiliza um sistema de roteamento por subdomínio para coexistir com a V1 sem conflitos de URI.

## 🌐 Subdomínio `v2.`
O Laravel está configurado para casar todas as rotas V2 sob o subdomínio definido dinamicamente:
`v2. + {Host de APP_URL}`

### Configuração em Desenvolvimento (Docker)
- **APP_URL:** Deve estar como `http://localhost:10010` (ou similar) no `.env`.
- **Hosts Local:** É necessário adicionar `127.0.0.1 v2.localhost` no arquivo de `hosts` da máquina host.

## 🐳 Docker e Nginx
Para que o roteamento funcione, o Nginx deve passar o cabeçalho `Host` original para o PHP-FPM.

### Ajuste no Nginx
No arquivo `docker/nginx/lotep.conf.template`, foi adicionado:
```nginx
fastcgi_param HTTP_HOST $http_host;
```

### Server Name
O Nginx aceita conexões no subdomínio via:
```nginx
server_name localhost v2.localhost _;
```

## 🚨 Tratamento de Erros Exclusivo
O `app/Exceptions/Handler.php` foi modificado para que requisições originadas do subdomínio `v2.` utilizem os templates de erro da V2 (`404.blade.php`, `500.blade.php`, etc.), garantindo a experiência visual do novo layout mesmo em falhas.

---
[Voltar para o Índice](index.md)