Duocmatico (En construccion 🚧)

Hola! Este repo es una especie de app para ayudar a planear tu horario para los semestres.

Ojo! la idea de esto no es que la app tome ramos por ti. Solamente ayudamos a organizar mejor tu horario para que puedas ver como va quedando con los ramos que seleccionas.

⚠️ Importante

Este proyecto esta siendo actualmente desarrollado por alumnos y no es algo que sea parte de la institucion.

Si estas usando esta aplicacion actualmente, puede ser que tengas que volver a subir el archivo de los cursos entre las releases. Esto debido a que aun estamos mejorando la conversion de los datos y quizas necesitemos leer otra vez la informacion del excel con los cursos disponibles.

Documentacion

Transformacion de datos

Para poder mostrar los datos de una forma mas amigable, nos fijamos en las siguientes columnas del excel de cursos disponibles:

Columna	Motivo
Asignatura	Nombre de la asignatura
Carrera	Usada para agrupar las distintas asignaturas y secciones por la carrera a la que pertenecen
Dia	Dia de la semana en que se imparte la asignatura
Docente	Nombre del docente encargado de la seccion
Escuela	Aun no tenemos algun motivo en especifico del por que de esta columna
Horario	Bloque del dia y hora en que se imparte la seccion en formato Dia HH:MM:SS - HH:MM:SS
Jornada	Para identificar si una seccion es diurna o vespertina
Nivel	Semestre al que pertenece una asignatura
Plan	Identifica el plan de estudio al que pertenece la seccion de una asignatura. Actualmente sin repercucion visual
Sala	Lugar fisico en la sede donde se imparte la seccion
Seccion	Identificador de la seccion. Suelen ser una combinacion entre Sigla + ### + jornada
Sigla	Identificador abreviado de las asignaturas
Tipo	Identifica si una asignatura es presencial u online

Estas 13 columnas nos ayudan a poder crear las siguientes estructura de datos

Horarios

Esta estructura contiene los datos de la hora, el dia y la sala de un curso.

{
  horario: "Lu HH:MM:SS - HH:MM:SS",
  dia: "Lunes",
  sala: "301"
}

Cursos

Estructura principal para poder mostrar la informacion de los cursos disponbles y ver cuales son sus horarios, el docente, etc.

En este caso usaremos el ejemplo una de las secciones del curso Big Data para la sede San Joaquin en primer semestre del 2022

{
  asignatura: "BIG DATA",
  docente: "EMILIO GONZALO SOTO",
  escuela: "Informática y Telecomunicaciones",
  horarios: [
    {
      dia: "Viernes",
      horario: "Vi 14:31:00 - 15:50:00",
      sala: "SJ-L10"
    },
    ...
  ],
  jornada: "Diurno",
  nivel: 7,
  planes: [
    // Existen casos en donde un curso pertenece a mas de un plan de estudios
    1446103,
    ...
  ],
  seccion: "BDY7101-006D",
  sigla: "BDY7101",
}

Carreras

Por ultimo, para no tener que mostrar todos los cursos disponibles de una sede juntos, las secciones se separaron por carrears. Basicamente es un array con las distintas carreras y sus cursos.

{
  carrera: "INGENIERÍA EN INFORMÁTICA",
  cursos: [
    ...
  ]
}

Que datos guardan?

Actualmente los datos se guardan en tu propio buscador (Mozilla, Chrome, Edge, etc) y estos son exclusivamente para el funcionamiento de la aplicacion. No guardamos datos personales ni dejamos cookies en tu dispositivo.

A continuacion podraas ver un listado de los datos guardados por parte de Duocmatico

Version de la app

Este dato se guarda para saber cual fue la ultima version que usaste de la aplicacion. Debido a que aun estamos en construccion, es posible (muy posible) que realizemos cambios en como transformamos los datos del excel con los cursos y necesitemos que lo subas otra vez para poder realizar otra vez la conversion del archivo.

Tecnicamente tambien podriamos usar los datos que ya habiamos guardado. Pero existen casos en los que necesitaremos influir nueva informacion. Por lo que los datos que ya estan guardados no servirian... 🤷🏻‍♂️

Datos del archivo cargado

Estos datos se guardan unicamente si tu lo deseas. Basicamente son para que no tengas que volver a subir un archivo con los cursos cada vez que accedes a la aplicacion. El formato en como se guardan los datos lo puedes encontrar aqui

Carrera seleccionada

Este dato se guarda unicamente si tu lo deseas. En conjunto con los datos del archivo cargado, se usa para mostrar los ramos correspondiente a tu carrera cada vez que entres a Duocmatico

Estructura en Firebase

Dentro de firebase, tenemos varias opciones a organizar los datos. En bases no relacionales, suelen preferirse big collections and small documents.

En este caso particular, se prefirio un hibrido que si tiene documentos "grandes".

Para contextualizar un poco mas esta decision, vamos a tomar como ejemplo la carga academica 2022-2 SAN-JOAQUIN. Esta consta con 21 carreras distintas y en el caso de la carrera de Ingenieria en Informatica, esta cuenta con 185 secciones disponibles. Lo que se traduce en 185 documentos distintos con la informacion de cada una de las secciones.

Teniendo una estructura similar a la siguiente:

cargas-academicas/
├─2022-2 SAN-JOAQUIN
│ ├─INGENIERIA EN INFORMATICA/
│ │ ├─Seccion 1
│ │ ├─Seccion 2
...
│ │ └─Seccion 185
│ │
│ └─Carrera 2/
│   ├─Seccion 1
│   ├─Seccion 2
...
│   └-Seccion N
├─2022-2 PUENTE-ALTO
│ ├─Carrera 1/
...

Dejando cadad uno de los documentos de secciones con el siguiente formato

{
  "asignatura": "Nombre Asignatura",
  "carrera": "Carrera",
  "escuela": "Escuela",
  "horarios": [
    {
      "dia": "Dia"
      "sala": "Sala"
      "horario": "Di 00:00:00 - 00:00:00"
    },
    ...
  ],
  "jornada": "Jornada",
  "nivel": 1,
  "planes": [1234, 5678, ...],
  "seccion": "Seccion",
  "tipoAsignatura": "Tipo Asignatura",
  "tipoPlanEstudios": "Presencial u Online"

}

Si usaramos la buena practica de big collections and small documents a rajatabla, comenzar a armar un horario tendria esta cantidad de lecturas en Firebase.

• 1 Lectura para ver la carga academica a usar
• 1 Lectura para obtener la carrera a utilizar
• 185 Lecturas para obtener la informacion de todas las secciones disponibles.

Esto deja la opcion de que aproximadamente 270 alumnos de ingenieria en informatica quieran utilizar la App para consumir la cantidad de lecturas gratuitas diarias.

Ahora, existe la opcione de tener not so small documents y generar documentos con las carreras que tengan todas las secciones como un atributo. dejando asi la misma estructura anterior, pero eliminando las secciones como documento.

cargas-academicas/
├─2022-2 SAN-JOAQUIN
│ └─carreras/
│   ├─Carrera 1
│   ├─Carrera 2
...
│   └─Carrera N
│
└─2022-2 PUENTE-ALTO

Estructura de los documentos de carreras

{
  "carrera": "Nombre Carrera",
  "carga-academica": "Carga academica",
  "secciones": [
    {
      "asignatura": "Nombre Asignatura",
      "carrera": "Carrera",
      "escuela": "Escuela",
      "horarios": [
        {
          "dia": "Dia"
          "sala": "Sala"
          "horario": "Di 00:00:00 - 00:00:00"
        },
        ...
      ],
      "jornada": "Jornada",
      "nivel": 1,
      "planes": [1234, 5678, ...],
      "seccion": "Seccion",
      "tipoAsignatura": "Tipo Asignatura",
      "tipoPlanEstudios": "Presencial u Online"
    },
    ...
  ]
}

Es importante destacar que esta implementacion hace la transferencia de datos un poco mas costosa. Ya que todas las secciones de una carrera se almacenan dentro de un mismo documento.