feat - melhorias de qualidade de vida e novo gerencimento de alunos

[icrcode]

Este pull request introduz melhorias significativas na forma como coordenadores e cursos se relacionam, aprimora o controle de acesso aos documentos e adiciona novos endpoints para gerenciamento de cursos. O principal objetivo é oferecer suporte a coordenadores responsáveis por múltiplos cursos, garantindo que permissões e filtros reflitam corretamente esse relacionamento em todo o backend. Além disso, a base de código foi atualizada com testes abrangentes para cobrir as novas funcionalidades.

Principais alterações:

1. Suporte a múltiplos cursos para coordenadores e propagação no JWT

• Coordenadores agora podem ser associados a vários cursos por meio de um relacionamento muitos-para-muitos (coordenadores_cursos).
• O payload do JWT passou a incluir um array curso_ids para coordenadores, permitindo que o sistema reconheça todos os cursos sob sua responsabilidade.
• A lógica de autenticação e geração de tokens foi atualizada para refletir essa nova estrutura.

2. Melhorias no acesso e filtragem de documentos

• Todas as verificações de acesso e operações de listagem de documentos passaram a utilizar o array curso_ids dos coordenadores.
• Isso garante que coordenadores possam acessar apenas os documentos pertencentes aos cursos aos quais estão vinculados.
• As regras de filtragem e permissões foram ajustadas tanto nos repositórios quanto nos manipuladores de rotas.

3. Novos endpoints para gerenciamento de cursos e alunos

• Adicionado o endpoint GET /api/cursos/meus, responsável por listar todos os cursos gerenciados pelo coordenador autenticado.
• Adicionado o endpoint GET /api/cursos/:id/alunos, que retorna a lista de alunos matriculados em um curso específico, com controle de acesso para assegurar que apenas coordenadores autorizados ou administradores possam visualizar essas informações.

4. Aprimoramentos em consultas e no modelo de dados

• As consultas SQL foram ajustadas para realizar corretamente os relacionamentos com a tabela coordenadores_cursos ao buscar coordenadores ou cursos.

• Foram adicionadas funções utilitárias e métodos de repositório para:

  • listar os cursos de um coordenador;
  • verificar o vínculo entre coordenadores e cursos;
  • listar alunos de acordo com o curso informado.

5. Ampliação e atualização da cobertura de testes

• Os testes passaram a simular coordenadores vinculados a múltiplos cursos.
• Foram adicionados cenários cobrindo os novos endpoints, incluindo casos de sucesso e de erro nas operações de listagem de cursos e alunos.
• Funções auxiliares e a configuração dos testes foram atualizadas para dar suporte à nova estrutura do JWT e às novas regras de acesso.

Essas mudanças, em conjunto, aumentam a flexibilidade e a segurança do sistema em instituições nas quais coordenadores podem supervisionar múltiplos cursos, além de melhorar a manutenibilidade e a testabilidade do código do backend.

[sonarqubecloud]

Quality Gate passed

Issues
7 New issues
0 Accepted issues

Measures
0 Security Hotspots
84.3% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[gtins]

LGTM