[BUG] Bug na avaliação técnica

[Junior-Shyko]

Corrigir Duplicação de Avaliações e Permitir Ajuste de Notas por Administradores

Contexto

No fluxo de avaliação dos Editais de Cultura Popular (Etapa de Análise Técnica), foi identificada uma falha crítica na plataforma. Anteriormente, era possível atualizar as notas de um parecerista para alinhamento com a planilha oficial de gestão. Atualmente, qualquer tentativa de alteração de nota — seja pelo administrador ou pelo próprio parecerista — resulta na criação de uma nova avaliação (duplicação) em vez da atualização da existente. Isso corrompe o cálculo da média final, pois o sistema soma a avaliação antiga e a nova no denominador da média.

Objetivo

Como um Programador (Dev)
Quero corrigir o bug de duplicação de avaliações e implementar ferramentas de gestão para Super Admins
Para garantir a integridade dos resultados dos editais e permitir a correção de discrepâncias sem corromper a média dos projetos.

Escopo

• Correção de Bug: Investigar e corrigir a lógica de salvamento de avaliações para que o sistema identifique registros existentes e realize o update em vez de um novo insert.
• Funcionalidade Super Admin: Criar botão/ação para que usuários com perfil Super Admin possam excluir avaliações duplicadas.
• Recálculo Automático: Garantir que, ao excluir ou editar uma avaliação, o sistema dispare o gatilho de recálculo da média final do projeto imediatamente.
• Permissão de Edição: Permitir que Administradores da Oportunidade editem notas de pareceristas sem gerar novos registros de avaliação.

Fora de Escopo

• Automatização da importação da planilha de notas (o processo continuará sendo manual via plataforma).
• Alteração nos critérios de avaliação ou pesos dos editais.
• Mudança na interface de visualização pública dos resultados.

Critérios de Aceitação (Gherkin/Cucumber)

• Atualização de nota sem duplicação

Dado que um parecerista já enviou uma avaliação para um projeto
Quando o parecerista ou o administrador altera uma nota de critério e salva
Então o sistema deve atualizar o registro existente no banco de dados
E não deve criar uma nova linha de avaliação (ID duplicado) para o mesmo avaliador/projeto.

• Exclusão de avaliação por Super Admin

Dado que existem avaliações duplicadas em um projeto devido ao bug anterior
E eu estou logado como Super Admin
Quando eu clico na opção de excluir uma avaliação específica
Então o registro deve ser removido do banco de dados
E a média final do projeto deve ser recalculada instantaneamente considerando apenas as avaliações restantes.

• Ajuste de notas por Administrador da Oportunidade

Dado que eu sou Administrador de uma Oportunidade
Quando eu acesso a avaliação de um parecerista e altero a pontuação para refletir a planilha oficial
Então o sistema deve permitir o salvamento da alteração
E manter o nome do parecerista original vinculado àquela avaliação.

Observações

• Urgência: Esta demanda é prioritária, pois impacta diretamente a classificação final dos proponentes e pode gerar questionamentos jurídicos nos certames.
• Log de Auditoria: É recomendável que, ao ser feita uma alteração por um Administrador na nota de um Parecerista, o sistema registre quem fez a alteração e quando (log interno).
  Chamado: https://suporte.secult.ce.gov.br/front/ticket.form.php?id=9876