🐋 Guía de Inicialización del Entorno Local

A continuación se detallan las instrucciones técnicas necesarias para desplegar y ejecutar Edunoly de forma aislada a través de Docker y Laravel Sail.

Recuerde que es necesario tener Docker Desktop activo en su máquina. Si le surge cualquier tipo de duda durante el proceso, ¡póngase en contacto con nosotros en fp.sblancocalsina@salesianosdosa.com y le ayudaremos encantados! :))

Preparación del entorno

1. Descomprimir el archivo: Extraiga el contenido del archivo TFG.zip en una carpeta de su disco local.
2. Abrir la terminal: Acceda mediante la consola de comandos o el terminal de su IDE a la raíz de la carpeta del proyecto.

   cd /ruta_de_extraccion/TFG

3. Instanciar las variables de entorno: Genere el archivo operativo de configuración duplicando la plantilla base.

   cp .env.example .env

⚠️ CRÍTICO PARA WINDOWS: Abra el archivo .env recién creado con cualquier editor de texto (Notepad, VS Code, etc.) y añada la siguiente línea al principio del archivo para evitar que Docker asigne nombres aleatorios a los contenedores:

COMPOSE_PROJECT_NAME=tfg-main

4. Construcción de la Carpeta vendor (Descarga de Dependencias): vamos a generar de forma temporal las dependencias correspondiente a su sistema operativo para generar el entorno de forma aislada.

En macOS / Linux / Windows (Terminal Git Bash):

   docker run --rm -u "$(id -u):$(id -g)" -v "$(pwd):/var/www/html" -w /var/www/html laravelsail/php84-composer:latest composer install

En Windows (Terminal PowerShell estándar):

   docker run --rm -v "${PWD}:/var/www/html" -w /var/www/html laravelsail/php84-composer:latest composer install

5. Inicializar la infraestructura Cloud local: Levante los contenedores del servidor de aplicaciones, Mailpit y la base de datos relacional MySQL en segundo plano.

En macOS / Linux / Windows (Terminal Git Bash):

   vendor/bin/sail up -d

En Windows (Terminal PowerShell estándar):

   bash vendor/bin/sail up -d

6. Generar la clave criptográfica del sistema: Registre una clave única de cifrado de sesiones ejecutando.

En macOS / Linux / Windows (Terminal Git Bash):

   vendor/bin/sail artisan key:generate

En Windows (Terminal PowerShell estándar):

   bash vendor/bin/sail artisan key:generate

7. Construir y poblar la Base de Datos: Ejecute las migraciones cronológicas estructurales para armar las tablas en Tercera Forma Normal (3NF) y realice la siembra automatizada del set de datos de prueba.

En macOS / Linux / Windows (Terminal Git Bash):

   vendor/bin/sail artisan migrate:fresh --seed

En Windows (Terminal PowerShell estándar):

   bash vendor/bin/sail artisan migrate:fresh --seed

Visualizacion en el navegador

1. Plataforma Educativa (Frontend/Backend): http://localhost:8080
2. Bandeja de Entrada de Alertas de Correo (Mailpit): http://localhost:8025