Instalación del Frontend

Instalación Local del Frontend

El proyecto del frontend está alojado en el repositorio CC-unison de GitHub. Para comenzar, clona el repositorio en tu equipo ejecutando el siguiente comando:

git clone [https://github.com/CC-unison/lcchub-dev.git](https://github.com/CC-unison/lcchub-dev.git)

Una vez descargado, accede a la carpeta del proyecto:

cd lcchub-dev

Requisitos Previos

Antes de instalar las dependencias, asegúrate de cumplir con las versiones de software compatibles para evitar errores de compilación o conflictos:

• Node.js: Se recomienda la versión v22.1.0 (o versiones LTS superiores).
• NPM: Una versión actualizada (generalmente se instala de forma automática junto con Node.js).

Recordatorio

Si utilizas un gestor de versiones como nvm, puedes cambiar rápidamente a la versión necesaria de Node ejecutando el comando nvm use 22.

Una vez verificados los requisitos, ejecuta el siguiente comando para instalar todas las bibliotecas y módulos necesarios definidos en el archivo package.json:

npm install

Configuración de Variables de Entorno (.env)

El proyecto requiere de ciertas credenciales para conectarse a los servicios de Azure (para la autenticación) y Firebase (para la base de datos de los alumnos).

Debes crear un archivo llamado .env o .env.local en la raíz del proyecto y copiar la siguiente plantilla, reemplazando las x con las credenciales reales:

Seguridad

Nunca subas el archivo .env al repositorio de GitHub. Este archivo contiene credenciales sensibles y debe estar incluido en tu archivo .gitignore para evitar filtraciones de seguridad.

NEXT_PUBLIC_AZURE_CLIENT_ID=xxxx-xx-x
NEXT_PUBLIC_AZURE_AUTHORITY=[https://login.microsoftonline.com/xxxx-xx-x](https://login.microsoftonline.com/xxxx-xx-x)
NEXT_PUBLIC_AZURE_REDIRECT_URI=http://localhost:62213/ o https://your-web-domain/dashboard/auth
NEXT_PUBLIC_FIREBASE_API_KEY=xxxx-xx-x
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=xxxx-xx-x
NEXT_PUBLIC_FIREBASE_DATABASE_URL=xxxx-xx-x
NEXT_PUBLIC_FIREBASE_PROJECT_ID=xxxx-xx-x
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=xxxx-xx-x
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=xxxx-xx-x
NEXT_PUBLIC_FIREBASE_APP_ID=xxxx-xx-x
NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID=xxxx-xx-x

Ejecución del Proyecto

Una vez configuradas las variables de entorno y las dependencias, inicia el servidor de desarrollo local:

npm run dev

La aplicación estará disponible para su previsualización en tu navegador a través de: http://localhost:62213.