• Compara Carreras
  • Requisitos previos
  • Instalación y configuración
  • Desarrollo local
  • Actualización del sistema
  • Conversión de CSV a JSON
  • Despliegue
  • Contribuciones
  • Contacto

Este es el repositorio del proyecto Compara Carreras, desarrollado por IMCO. Este proyecto está construido con Next.js y utiliza GitHub Pages para el despliegue, con soporte de GitHub Actions para la automatización del proceso.

Asegúrate de tener instalado:

• Node.js (versión recomendada: 18.x o superior)
• npm
• Acceso al repositorio en GitHub

1. Clona el repositorio:

   git clone https://github.com/IMCO/compara-carreras.git
   cd compara-carreras

2. Instala las dependencias:

   npm install

Para correr el proyecto en un entorno local, ejecuta:

npm run dev

Esto levantará un servidor local en http://localhost:3000.

Para realizar actualizaciones al sistema, sigue estos pasos:

1. Crea una rama nueva basada en main:

   git checkout -b feature/nueva-funcionalidad

2. Realiza los cambios necesarios en el código y prueba el proyecto localmente.

3. Confirma y sube los cambios:

   git add .
   git commit -m "Añadida nueva funcionalidad"
   git push origin feature/nueva-funcionalidad

4. Crea un Pull Request (PR) en GitHub desde la rama creada hacia main y espera la revisión.

5. Una vez aprobado el PR, haz merge a main.

Si necesitas convertir archivos CSV a JSON para el proyecto, puedes utilizar la siguiente herramienta en línea:

https://csvjson.com/

El despliegue se realiza automáticamente mediante GitHub Actions cada vez que se hace un push a la rama main.

Para forzar un despliegue manual:

1. Ve a la pestaña Actions en GitHub.
2. Selecciona el workflow de despliegue.
3. Ejecuta manualmente el flujo de trabajo.

El sitio estará disponible en la siguiente URL:

https://comparacarreras.imco.org.mx/

Si deseas contribuir, por favor abre un Issue o un Pull Request siguiendo las mejores prácticas de desarrollo.

El proyecto incluye una sección automatizada de "Investigaciones" que muestra las últimas publicaciones de Compara Carreras.

El proceso de agregar nuevas ediciones está completamente automatizado. El sistema extrae el título, descripción e imagen directamente de la URL proporcionada.

1. Edita el archivo src/app/investigaciones/data.constants.ts.

2. Agrega la nueva configuración:

   {
     id: "cc-2026",
     year: 2026,
     url: "https://imco.org.mx/nueva-investigacion/"
   }

Para más detalles, consulta la guía completa en COMO_AGREGAR_INVESTIGACIONES.md.

El proyecto utiliza Google Analytics 4 para el seguimiento de usuarios.

• Eventos personalizados: Se rastrean cálculos de ROI (roi_calculation).
• Dimensiones personalizadas: Nivel educativo, carrera, tipo de universidad, etc.
• Métricas personalizadas: Costo total, meses de recuperación, RSI, etc.

Consulta ANALYTICS_DATA_COLLECTION.md para ver la especificación completa de eventos.

Para más información, contacta con el equipo de IMCO a través de su página oficial: https://imco.org.mx.