fix: expose Vite dev server to local browser

docs/RUNBOOK.md

@@ -21,6 +21,17 @@ docker compose exec postgres pg_isready -U reserva -d reserva
 docker compose exec redis redis-cli ping
 ```
 
+### Página em branco no desenvolvimento
+
+Se o HTML responder mas a interface React não aparecer, confirmar que `public/hot` contém `http://localhost:5173` e não `http://0.0.0.0:5173`. Depois validar os módulos:
+
+```bash
+curl -I -H 'Origin: http://localhost:8000' http://localhost:5173/@vite/client
+curl -I -H 'Origin: http://localhost:8000' http://localhost:5173/resources/js/app.tsx
+```
+
+Ambos devem responder com estado 200 e `Access-Control-Allow-Origin: http://localhost:8000`. Reiniciar o serviço com `docker compose restart node` se o ficheiro `public/hot` estiver desatualizado.
+
 ## Atualização de código
 
 ```bash