🧩 Requisitos del sistema

Para ejecutar correctamente Mantek Manager, ya sea en un entorno local o en producción, es necesario disponer de ciertos requisitos básicos tanto para el backend como para el frontend. A continuación se detallan los mínimos recomendados.

Instalación simplificada

Aunque puedes realizar la instalación manualmente, se recomienda el uso de Docker para facilitar el proceso y evitar conflictos de dependencias.

---

🔧 Requisitos generales

• Docker (opcional pero recomendado): simplifica la configuración del entorno tanto en desarrollo como en producción.
• Git: necesario para clonar el repositorio.
• Terminal con acceso a comandos básicos (Unix, macOS o Windows con WSL/Powershell/Bash).
• Acceso a puertos 8000 (backend) y 3000 (frontend) si se ejecuta localmente.

---

🖥️ Requisitos del backend (Laravel)

Para ejecutar el backend de Mantek Manager en producción o localmente:

• PHP 8.2 o superior
• Composer 2.0+
• Extensiones de PHP necesarias:
  • bcmath, ctype, fileinfo, json, mbstring, openssl, pdo, tokenizer, xml, curl
• Servidor web:
  • Recomendado: Nginx
  • Alternativa: Apache
• Base de datos:
  • MySQL 8+ o MariaDB 10.5+
• Sistema de colas y caché (recomendado):
  • Redis o base de datos como driver alternativo.
• Node.js: solo si necesitas compilar assets del backend (poco frecuente en este proyecto).
• Entorno con acceso a variables .env y configuración de claves de aplicación (APP_KEY, DB_*, etc.).

Compatibilidad con base de datos

Si utilizas otro motor de base de datos, asegúrate de revisar la configuración de tipos y compatibilidad de migraciones.

---

🌐 Requisitos del frontend (Nuxt 3)

Para ejecutar y desplegar el frontend de Mantek Manager en producción:

• Node.js 18 o superior: requerido para instalar dependencias y compilar el proyecto.
• npm 9+ o yarn 1.22+: para ejecutar scripts de instalación y construcción.
• Servidor compatible con Node.js (para SSR) o servidor web para archivos estáticos (SSG).
• Compatible con entornos como:
  • Vercel (SSR)
  • Netlify / Nginx / Apache (SSG)
  • Contenedores Docker personalizados

Compatibilidad con Docker

Puedes empaquetar el frontend con una imagen Docker que contenga Node.js 18, lo que facilita su despliegue en servicios como Fly.io, Railway, Render, etc.

Compilación del frontend

Para generar el frontend en modo producción:

npm install
npm run build
npm run preview

Evita versiones antiguas de Node.js. El uso de versiones como Node 14 o 16 puede causar errores en Nuxt 3, Vite o TanStack Query.