evaluations

O submódulo Evaluations é a camada de pesquisa de satisfação do HedHog LMS. Um tópico de avaliação é um template de pergunta (por exemplo, "O conteúdo estava claro?") marcado com um `targetType` — course, course_lesson, course_class_session, question ou exam — que determina qual tipo de entidade os alunos podem avaliar contra ele. Tópicos são explicitamente ordenáveis (`PATCH /topics/reorder`), de modo que o painel de admin possa controlar a sequência que os alunos veem ao avaliar, e são protegidos contra exclusão depois que coletaram notas (`422 Unprocessable Entity`), preservando a integridade dos dados históricos de pesquisa.

O `GET /lms/evaluations` é a superfície de consulta transversal: retorna as respostas de nota individuais com filtragem rica por curso, turma, instrutor, avaliador e intervalo de datas, e enriquece cada linha com um par `topicAvgScore`/`topicRatingCount`, de modo que a UI de admin possa mostrar uma resposta individual junto com o agregado de seu tópico para contexto. O `GET /lms/evaluations/filter-options` deriva os valores de dropdown disponíveis (cursos, turmas, instrutores, avaliadores) diretamente dos tópicos que já têm notas, de modo que os menus de filtro nunca mostrem opções com zero resultados.

Notavelmente, o `EvaluationService` também implementa `getCourseLessonTopics`, `getMyLessonRatings` e `submitLessonRatings` — o fluxo real de submissão voltado ao aluno — mas esses não são expostos pelo `EvaluationController` nem pelas ferramentas MCP deste submódulo; eles são consumidos pelo portal do aluno Platforma (`GET/POST /lms/platforma/lessons/:lessonId/evaluation-topics`, `/my-evaluation`, `/evaluate`), já que o `EvaluationService` é exportado do `EvaluationModule` para uso entre módulos.