Implementar o módulo de Período de Avaliação

[ReneDouglas]

Descrição

O objetivo desta tarefa é desenvolver o módulo de período de avaliação, implementando as operações básicas de CRUD (Criar, Ler, Atualizar e Deletar), seguindo as melhores práticas de mercado para nomenclatura, métodos HTTP e códigos de status.

Endpoints e especificações

Criar Período de Avaliação

• POST /periodos-avaliacoes

Alterar Período de Avaliação

• PUT /periodos-avaliacoes/{id}

Deletar Período de Avaliação (soft delete)

• DELETE /periodos-avaliacoes/{id}

Listar Todas os Períodos de Avaliações

• GET /periodos-avaliacoes

Exemplo de payload de cadastro da Período de Avaliação

{
    "bimestre" : "1_BIMESTRE",
    "semestre" : "2_SEMESTRE",
    "dataInicio" : "2025-08-20",
    "dataHoraFim" : "2025-08-27T23:59:59-03:00",
    "ativo" : true,
    "professores" : [
        {
            "professorId" : "123abc",
            "disciplinas" : [
                {
                    "disciplinaId" : "123aaa",
                    "turmas" : [
                        {
                            "turmaId" : "111aaa"
                        },
                        {
                            "turmaId" : "222bbb"
                        }
                    ]
                },
                {
                    "disciplinaId" : "333fff",
                    "turmas" : [
                        {
                            "turmaId" : "111aaa"
                        }
                    ]
                }

            ]

        }
    ]
}