⚠️ Este repositorio se encuentra archivado, y contiene lo que fue creado para SoC 2020-2021.

🔗 El proyecto va a ser mantenido en open-source-uc/ucalendar.

Implementación en Rails de uc-nrc-icalendar.

Aplicación web que obtiene los cursos de Busca Cursos y crea un calendario en formato iCalendar que luego puede ser importado a Google Calendar.

Deploy en Heroku

1. Seleccionar el semestre académico.
2. Ingresar los códigos del curso junto a su sección (EJM1230-1) o el NRC de cada uno.
3. Descargar el calendario ics o copiar el url de descarga.
4. Agregar el calendario a la aplicación de calenadrio con el acrhivo ics (en google) o con el url (en google).

Antes de crear la base de datos, crear un archivo.env con la clave de postgres:

POSTGRES_PASSWORD=

Para crear el entorno de desarrollo:

bundle install
yarn install
rails db:setup

Para iniciar el servidor

sudo service postgresql start
rails s

Para que se pueda obtener los cursos, tiene que existir un periodo académico (term) en la base de datos. Tambíen, para que no se creen eventos en feriados deben crearse estos feriados (holidays).

Estos se pueden crear con las seeds o en el interfaz de administración (/admin).

HOST = 'https://ucalendar.herokuapp.com'

`${HOST}/term/${year}/${period}/schedule.ics?cs[]=${cs}&nrc[]=${nrc}`

• year: año buscado, requerido
• period: periodo buscado, requerido
• cs[]: curso con su sección (ej MAT1610-1), opcional, acepta multiples valores
• nrc[]: ncr del curso, opcional, acepta multiples valores

Ejemplo:

https://ucalendar.herokuapp.com/term/2021/1/schedule.ics?cs[]=MAT1640-1&cs[]=MAT1630-1

`${HOST}?s.ics?year=${year}&period=${period}&cs=${course_section}&nrc=${nrc}`

Acepta los mismos parámetros de el GET, pero year y period son opcionales, si no están presentes obtienen los datos de la el periodo académico.

Además, acepta:

• cs: cursos coon su sección separados por comas
• nrc: nrc de los cursos separados por comas

Ejemplos (formato HTML):

https://ucalendar.herokuapp.com/s.ics?cs=MAT1640-1,MAT1630-1

`${HOST}/terms.json`

Obtiene una lista de los periodos académicos en formato JSON.

Ya que se utiliza una vista con AJAX, esta puede ser compilada a una página estática. Para esto se usa la rama gh-pages, que es creada con la página con el comando rake gh_pages:compile.

Página en github.io.

• Página con documentación de icalendar: icalendar.org
• Diagrama de la base de datos en: dbdiagram.io