ADR-0038: Versiones del stack

• Estado: Aceptada
• Fecha: 2026-10-31

Contexto

La prueba exige PHP 8+ y Laravel 10+, así que cualquier versión posterior cumple. Lo que hay que evitar es construir sobre una versión que ya no recibe parches de seguridad.

Alternativas evaluadas

Decisión

• Backend: Laravel 13 sobre PHP 8.4.
• Frontend: Node 24 LTS, Vue 3.5, Vite y TypeScript, en las versiones que soporta Quasar.
• Servicios:
  • MySQL 8.4 LTS
  • Redis 8.4
  • Nginx 1.30, rama estable, en su variante sin root
  • Mailpit 1.31
• Tiempo real (fase 3.5): Reverb 1.12 en el back, que obliga a usar Guzzle 7.16 en lugar de 8 (ADR-0057); Laravel Echo 2.6 y pusher-js 8.6 en el front.
• Imágenes: todas con versión exacta.

Alternativas descartadas

• Laravel 11: ya no recibe parches de seguridad.
• Laravel 12: su soporte termina en pocos meses.
• PHP 8.5: es la versión más reciente, y parte del ecosistema todavía no la soporta del todo. PHP 8.4 tiene soporte hasta 2028 y es compatible con todas las librerías del proyecto (Sanctum 4, Reverb, Pest 4, Larastan 3 y Scramble).

Consecuencias

• El proyecto arranca sobre versiones con soporte por al menos dos años.
• Dependabot avisará de las actualizaciones de seguridad dentro de cada versión.

Dónde está en el código

• docker/php/Dockerfile y docker/frontend/Dockerfile
• docker-compose.yml
• backend/composer.json y frontend/package.json