Draft: Feature/graduation stats

[andre-sakuma]

Feature

Descrição

Implementa um endpoint para listagem de cursos com suas disciplinas populadas e outro para calcular o quanto o usuário já realizou de um dado curso.
Esse seria um primeiro passo para implementar o recomendador de disciplinas para matrícula. Com esse PR, podemos computar o que o usuário já fez de um determidado curso e o que falta para ele realizar.
Assim, com o PDF de disciplinas ofertadas, podemos recomendar quais matérias o aluno deveria pegar considerando:

• horários conflitantes
• período
• disciplinas obrigatórias
• disciplinas limitadas
• tipo de professor (futuramente)
• menores chances de ser chutado (futuramente)

GET /v1/graduations
Formato de retorno

Graduation[]

GET /v1/graduations/stats/:graduationId
Precisa de autenticação

Formato de retorno

{
    "percentage": {
        "mandatories": number // percentage [0, 1]
        "limited": number // percentage [0, 1]
    },
    "credits": {
        "mandatories": {
	    "done": number
	    "total": number
        },
        "limited": {
	    "done": number
	    "total": number
        }
    },
    "missing": {
        "mandatories": SubjectGraduation[]
        "limited": SubjectGraduation[]
    }
}

Como posso testar isso?

Pré-Requisitos:

• Ter a collection graduations populada
• Ter a collection subjectgraduations populada
• Ter a collection subjects populada

Listagem de Graduations

1. Chamar a rota GET /v1/graduations
2. Deve listar as graduações com o campo subjects populado com suas respectivas disciplinas obrigatórias e limitadas

Estatísticas da graduação

1. chamar a rota GET /v1/graduations/stats/:graduationId com o header de autenticação
2. Deve retornar seguindo o formato previamente especificado

Checklist

• Implementação dos endpoints
• Otimizar endpoints
• Garantir que o banco de prod está populado com os cursos e disciplinas corretamente, incluindo o plano de ensino (subjectgraduation)
• Garantir que as disciplinas ofertadas em 2024.2 estão populadas no banco
• Adicionar campo de horários em disciplinas ofertadas
• Implementar recomendador de matrícula em disciplinas

[Joabesv]

LGTM!