💻 Instalación Local - lod1004/GII-TFG-Asistente-de-practicas-agiles-para-repositorios-en-GitHub GitHub Wiki

Esta guía está pensada para desarrolladores que deseen clonar, ejecutar y colaborar con el proyecto Asistente de Prácticas Ágiles para Repositorios en su entorno local.

⚙️ Herramientas Recomendadas

Antes de comenzar, te recomendamos instalar las siguientes herramientas para un entorno de desarrollo más cómodo y funcional:

Visual Studio Code: Editor de código versátil y extensible.

Copilot (opcional): Extensión de asistencia con IA para VS Code.

MongoDB Compass: Herramienta gráfica para explorar tu base de datos en MongoDB Atlas.

GitHub Desktop: Cliente gráfico para gestionar fácilmente el repositorio y los commits.

📥 Clonación del Proyecto

Puedes obtener el código fuente del proyecto desde el repositorio oficial: 🔗 https://github.com/lod1004/GII-TFG-Asistente-de-practicas-agiles-para-repositorios-en-GitHub

Opciones para clonar: Opción 1 - Gráfica (recomendada para principiantes):

Abre GitHub Desktop.

Selecciona File > Clone repository.

Pega la URL del repositorio.

Elige la carpeta de destino en tu disco local.

Opción 2 - Terminal: Abre una terminal y ejecuta:

git clone https://github.com/lod1004/GII-TFG-Asistente-de-practicas-agiles-para-repositorios-en-GitHub.git

🧪 Preparar el Entorno

Sigue estos pasos para configurar todo correctamente:

Instala Visual Studio Code https://code.visualstudio.com/

Instala Node.js (versión LTS recomendada) https://nodejs.org/en/download

Instala Angular CLI (v19.2.3)

Global:

npm install -g @angular/[email protected]

O local (desde el proyecto):

npm install @angular/[email protected]

Instala MongoDB Compass https://www.mongodb.com/products/compass

⚙️ Ejecutar el Backend

Navega a la carpeta del backend:

cd src/backend

Instala dependencias:

npm install

Configura el archivo .env con tu token de acceso personal de GitHub para poder realizar peticiones a la API: 👉 Guía oficial para generar tokens

También debes tener configurada una cadena de conexión válida a MongoDB Atlas (puedes usar la que ya viene configurada si lo deseas).

Inicia el servidor:

node server.js

💻 Ejecutar el Frontend

Abre una nueva terminal y navega a:

cd src/frontend

Instala dependencias:

npm install

Ejecuta la aplicación:

ng serve -o

Esto abrirá automáticamente tu navegador en http://localhost:4200.

Asegúrate de que los servicios de Angular estén usando el archivo de entorno correcto:

Para uso local: environment.ts

Para conexión con el backend desplegado: environment.prod.ts