Manual de Utilização — Sistema de Avaliação

1. Uso Geral

1.1 Conceitos do sistema

1.2 Iniciar sessão

1. Aceda à página de login.
2. Introduza o Código de utilizador (cod_user) e a senha.
3. Clique em "Entrar".

Nota: Após o primeiro acesso, a conta passa a estar ativa para login normal. Professores, admins e superadmins recebem credenciais diretamente. Alunos usam o processo de primeiro acesso para definir a sua senha.

1.3 Primeiro acesso

Disponível para alunos que ainda não definiram senha.

1. Na página de login, clique em "Primeiro acesso".
2. Introduza o Código de utilizador fornecido pela escola.
3. Receberá um e-mail com um link.
4. No e-mail, clique no link para aceder ao formulário de registo e definir a sua senha.

Critérios da senha: A senha deve ter no mínimo 8 caracteres e conter pelo menos letras e números. Os critérios são visíveis no ecrã para facilitar a inserção correta.

Validade do link: 30 minutos.

1.4 Recuperação de senha

1. Na página de login, clique em "Recuperar senha".
2. Introduza o Código de utilizador.
3. Receberá um e-mail com um link para redefinir a senha.

Critérios da senha: Tal como no primeiro acesso, a nova senha deve cumprir os requisitos de segurança (mínimo 8 caracteres, com letras e números).

Validade do link: 30 minutos.

1.5 Terminar sessão

Clique em "Sair" no menu superior. O sistema encaminha automaticamente para a página de login.

1.6 Ajuda contextual

Em todas as páginas do sistema existe um botão "? Ajuda" no cabeçalho da página (ao lado do botão "Voltar" ou "Sair").

• Clique em "? Ajuda" para abrir o manual diretamente na secção correspondente à página onde está.
• O manual abre num separador novo, sem sair do sistema.

Nota: Os links de ajuda apontam sempre para o manual mais atual. Se o manual for atualizado, os links refletem automaticamente as alterações.

2. Aluno

2.1 Painel do aluno

Após o login, o aluno vê o seu painel de comando harmonizado, com:

• Resumo do aluno — dados da turma, inscrições ativas, total de avaliações ativas/a concluir e uma barra de progresso indicando quantas avaliações já foram concluídas (ex: "2 de 3 avaliações concluídas").
• Avaliações — cartões individuais para cada disciplina, ordenados com as avaliações ainda pendentes primeiro, com indicação do estado da avaliação (Em curso, Reaberto ou Concluído) e sub-estados individuais de hetero e auto-avaliação.
• Ações claras por avaliação:
  • Botão único de "Avaliar" (ou "Reavaliar" se reaberto).
  • Botão de "Consultar minhas avaliações" (disponível apenas para avaliações já concluídas).

Fluxo guiado e independente: O aluno avalia cada disciplina de forma independente. O processo é sequencial: a hetero-avaliação deve ser concluída antes de preencher a auto-avaliação.

2.2 Hetero-avaliação

1. No cartão da avaliação pretendida, clique no botão "Avaliar" (ou "Reavaliar").
2. A página mostra a lista de colegas inscritos na mesma disciplina.
3. Atribua uma nota (0 até à escala máxima da avaliação) a cada colega.
4. Clique em "Submeter".

Regras:

• É obrigatório avaliar todos os colegas apresentados no formulário.
• Ao clicar em submeter, o sistema grava as notas e encaminha-o automaticamente para a página de auto-avaliação da mesma avaliação.
• Se a turma tiver apenas um aluno inscrito, o sistema salta esta etapa e abre diretamente a auto-avaliação.

Validação e feedback: se faltar uma nota ou o valor for inválido, o erro aparece junto ao campo em causa. Ao clicar em "Submeter", o botão fica desativado com um indicador de carregamento até a gravação terminar.

2.3 Auto-avaliação

1. Na página de auto-avaliação, introduza uma nota para si próprio (0 até à escala máxima da avaliação).
2. Preencha obrigatoriamente o campo "Justificação" justificando a sua nota com base no seu desempenho.
3. Clique em "Submeter".

Texto de orientação: O professor pode definir um texto orientador com critérios que aparece no topo da página de auto-avaliação para o ajudar na reflexão.

Edição pós-submissão: Depois de submetido, o botão desaparece e as notas ficam gravadas, não sendo possível editá-las exceto se o professor reabrir a avaliação para si.

Validação e feedback: a nota e a justificação são validadas antes de gravar — erros aparecem junto ao campo respetivo, e o botão "Submeter" mostra um indicador de carregamento enquanto a gravação está em curso.

2.4 Consultar resultados

Para consultar as suas notas de uma determinada avaliação, clique no botão "Consultar minhas avaliações" dentro do cartão dessa avaliação no painel.

Restrição de segurança: O botão de consulta é independente para cada avaliação e só fica disponível quando submete **tanto** a hetero-avaliação **como** a auto-avaliação para essa avaliação específica. Tentar aceder diretamente ao link de consulta sem concluir as avaliações resulta em bloqueio e redirecionamento de segurança para o painel.

O ecrã de consulta apresenta:

• Notas que deu aos colegas (com detalhe por colega).
• Notas que recebeu dos colegas (detalhe anónimo, apenas mostrando as pontuações e a respetiva média de hetero-avaliação).
• Nota da sua auto-avaliação.
• Nota atribuída pelo professor.
• Resultado final calculado.
• Se a ponderação ("Pesos Pesados") estiver ativa, os pesos efetivos aplicados e eventuais bónus.

3. Professor

3.1 Painel do professor

O painel divide-se em duas áreas visuais:

• As minhas disciplinas: turmas/disciplinas que leciona (segundo as atribuições configuradas).
  • Mostra avaliação aberta atual (se existir) e botão para gerir a avaliação.
• Área de DT: turmas em que exerce função de Diretor de Turma (se aplicável).

3.2 Criar avaliação

A página "Avaliações" lista todas as avaliações às quais tem acesso, com filtros por Turma, Disciplina e Estado, e ordenação por coluna (clique no cabeçalho da tabela; clique novamente para inverter a ordem).

1. No painel, clique em "Nova avaliação" (ou aceda a "Avaliações > Criar Avaliação").
2. Selecione a turma e a disciplina.
3. Dê um nome à avaliação (ex: "1º Período — Matemática").
4. Defina a escala máxima (padrão vem das configurações do sistema, tipicamente 20).
5. Clique em "Criar".

Regras:

• O professor só pode criar avaliações para turmas/disciplinas que lhe estão atribuídas (ou para turmas onde é DT).
• Só pode existir uma avaliação aberta por turma/disciplina de cada vez.
• Ao criar, os pesos predefinidos são: Professor 50%, Auto 25%, Hetero 25%.
• Administradores e superadministradores podem selecionar várias turmas e disciplinas em simultâneo para criar avaliações em massa.
• A lista de disciplinas é filtrada pelas turmas selecionadas: aparecem apenas as disciplinas que todas as turmas selecionadas oferecem (interseção). Sem nenhuma turma selecionada, nenhuma disciplina fica disponível. Isto impede a criação de avaliações para combinações inexistentes (turma sem essa disciplina). Se uma disciplina necessária não aparece, atribua-a primeiro à turma em Gestão de turmas.

3.3 Gerir notas e pesos

Aceda à página de uma avaliação:

Lançar notas do professor

• Na tabela de alunos, preencha a nota (0 até à escala máxima) para cada aluno.
• Todos os alunos inscritos devem ter nota lançada.
• Clique em "Guardar notas". O botão mostra um indicador de carregamento durante a gravação e, se alguma nota for inválida, o erro aparece junto ao campo do aluno em causa.

Ajustar pesos

• Introduza os percentuais desejados para: Nota do professor, Auto-avaliação, Hetero-avaliação.
• A soma deve ser exatamente 100%.
• Clique em "Atualizar pesos".

Texto de orientação da auto-avaliação

• O professor pode editar o texto que os alunos veem no topo da página de auto-avaliação.
• Útil para contextualizar os critérios de avaliação.

3.4 Fechar e reabrir avaliações

Fechar uma avaliação

1. Na página da avaliação, altere o estado para "Fechado".

Nota: Após a avaliação estar fechada, os alunos não podem alterar nem reavaliar as suas notas, e o botão correspondente no seu dashboard fica ausente.

Nota final automática para alunos sem avaliações: ao fechar, qualquer aluno ativo que tenha nota lançada pelo professor mas que não tenha completado a auto e/ou hetero-avaliação fica com nota final = nota do professor. Isto garante que ninguém fica sem nota só porque não completou a sua parte. Para alunos sem nota do professor não se cria nada (continuam por avaliar).

Importante: Reabrir uma avaliação (mudar de "Fechado" para "Aberto") não reabre automaticamente nenhum aluno. Os alunos já submetidos permanecem como "Submetido" — para os deixar refazer é preciso uma ação explícita ("Reabrir aluno" ou "Reabrir todos"). As respostas anteriores ficam sempre guardadas e continuam a contar para o cálculo final enquanto o aluno não submeter de novo.

Reabrir um aluno individual

• Na tabela de alunos, clique em "Reabrir" ao lado do aluno pretendido.
• O estado do aluno passa de "Submetido" para "Reaberto". No painel do aluno, o botão muda para "Reavaliar" e permite editar as respostas anteriores que já se encontram carregadas.
• Se o aluno não reenviar, as respostas anteriores continuam válidas e são as usadas no cálculo final.
• Quando o aluno reenvia, volta automaticamente a "Submetido" com os novos dados.

Reabrir todos os alunos

• Clique em "Reabrir todos". Útil para permitir que toda a turma faça correções, mantendo os valores preenchidos.

Prazo de reabertura (opcional)

Em Criar avaliação e no painel de pesos da avaliação existe o campo "Prazo de reabertura (horas)" (ex.: 1, 6, 12, 24, 48). Quando definido, qualquer aluno reaberto tem esse número de horas para refazer. Decorrido o prazo sem reenvio, o aluno volta automaticamente a "Submetido" e o cálculo passa a usar as respostas anteriores (verificação preguiçosa — não requer tarefa agendada). Vazio = sem prazo, reabertura indefinida até reenvio.

Cálculo dos resultados finais (automático)

O cálculo da nota final já não depende de nenhuma ação manual. O sistema recalcula automaticamente sempre que uma das condições relevantes muda:

• Um aluno submete a hetero-avaliação ou a auto-avaliação.
• O professor lança/atualiza as notas da turma.
• Os pesos do ciclo (professor/auto/hetero) ou o prazo de reabertura são alterados.
• O sistema "Pesos Pesados" é ligado/desligado nessa avaliação.
• A avaliação é fechada.
• Os parâmetros globais de Pesos Pesados (thresholds e fatores, em Configurações > Ponderação) são guardados — recalcula todas as avaliações abertas de uma só vez, já que esses parâmetros afetam qualquer ciclo com a ponderação ativa.

Cálculo parcial permitido: em cada recálculo, o sistema considera apenas os alunos com dados completos (professor, auto e hetero correspondente) e simplesmente salta/ignora os restantes, sem bloquear a turma.

O botão "Recalcular agora" na página da avaliação continua disponível para forçar um recálculo imediato (por exemplo, depois de uma correção pontual de dados), mas deixou de ser necessário no uso normal.

Notificações por email

Na página da avaliação, no painel de pesos, existem dois controlos para notificar alunos e professor por email quando a nota final fica disponível:

• "Notificar automaticamente quando todos os alunos tiverem nota final" (toggle) — desativado por defeito em cada avaliação. Quando ativado, o sistema envia automaticamente: um email a cada aluno com a sua nota final, e um email ao(s) professor(es) atribuído(s) a confirmar que a avaliação ficou completa. O envio só acontece uma vez por "conclusão" — se a turma deixar de estar completa (ex: novo aluno inscrito) e voltar a ficar completa, notifica de novo. Se ativar o toggle quando a avaliação já está completa, o envio acontece imediatamente.
• "Notificar alunos com nota atribuída" (botão) — envia o email da nota final apenas aos alunos que já têm FinalResult, mesmo que a turma ainda não esteja 100% completa. Útil para os casos em que algum aluno não vai fazer as suas avaliações: ao fechar a avaliação, esses alunos ficam com a nota do professor como nota final (ver §3.4, nota acima), e o botão envia-lhes o email correspondente. Pode ser usado livremente, quantas vezes for preciso.

Ambas as notificações usam a configuração SMTP do site (a mesma do envio de códigos de primeiro acesso e recuperação de senha).

3.5 Relatórios de turma e aluno

Na página da avaliação:

• "Resumo da turma" — tabela unificada e com design otimizado que apresenta de forma explícita o estado de cada aluno (Calculado, Incompleto, Penalizado ou Com bónus).
  • Alunos incompletos aparecem destacados a amarelo, com indicação clara do motivo de exclusão do cálculo: sem auto-avaliação, sem nota do professor, ou hetero-avaliação incompleta (mostra as recebidas vs esperadas).
  • As médias finais e de desvio nos relatórios ignoram os alunos incompletos para não distorcer as estatísticas da turma.
  • Filtros rápidos: botões "Todos / Calculado / Incompleto / Penalização / Bónus" para mostrar apenas alunos desse estado, com contador de quantos estão visíveis.
  • Ordenação por coluna: clique em qualquer cabeçalho da tabela para ordenar pelos valores dessa coluna (clique novamente para inverter).
• "Detalhe do aluno" — permite visualizar as justificações textuais introduzidas e as grelhas detalhadas de hetero-avaliação dada e recebida.

3.6 Sistema de ponderação da auto-avaliação

O sistema pode aplicar uma ponderação inteligente ("Pesos Pesados") sobre o peso da auto-avaliação, com base no desvio entre a nota do aluno e a nota do professor.

Como funciona

• Quanto maior o desvio entre a auto-nota e a nota do professor, menor o peso efetivo da auto-avaliação no resultado final.
• Se as notas forem exatamente iguais, o aluno recebe um bónus de correspondência adicionado à sua nota de auto-avaliação.
• O professor pode ativar/desativar este sistema por avaliação através do botão liga/desliga "Pesos Pesados".

Lógica de Redistribuição de Pesos

Para garantir a justiça da nota final e evitar distorções induzidas por notas altas do professor, o sistema opera de duas formas distintas:

1. Caso Auto > Professor (Sobreestimação): O peso retirado à auto-avaliação pela penalização é redistribuído proporcionalmente entre a nota do professor e a hetero-avaliação. Desta forma, a soma dos pesos finais mantém-se em 100%.
2. Caso Auto < Professor (Subestimação): O peso da auto-avaliação é penalizado, mas o peso perdido NÃO é redistribuído. Isto evita beneficiar indevidamente o aluno ao transferir peso para a nota do professor (que é mais alta), o que inflacionaria a nota final de forma artificial. Nestes casos, a soma dos pesos efetivos finais será inferior a 100%.

Segurança na escala: Nos casos com bónus de correspondência ou fórmulas cumulativas, a nota final resultante do cálculo é automaticamente limitada ao máximo da escala definida para a avaliação (geralmente 20), impedindo notas transbordantes.

Simulador: Para testar visualmente o efeito de diferentes desvios sem alterar dados reais, o Administrador encontra um simulador interativo em Configurações > Ponderação (secção 5.6).

Exemplo de faixas configuráveis

Nota: Os thresholds e fatores são configurados pelo Administrador em Configurações > Ponderação.

4. Diretor de Turma (DT)

O DT é uma função atribuída a um professor sobre uma turma específica. É configurado pelo Administrador na gestão da turma.

4.1 Visão geral da turma

No painel, a secção "Área de DT" mostra:

• Lista de turmas em que é DT.
• Avaliações em aberto por disciplina.
• Número de alunos submetidos vs. pendentes por avaliação.

Nota: O DT vê o estado das avaliações mas não as gere diretamente — essa tarefa é do professor da disciplina (exceto se o DT também for o professor atribuído).

4.2 Inscrições externas e mobilizações

Quando um aluno da turma A frequenta uma disciplina na turma B (e vice-versa), isso configura-se na página de gestão da turma pelo Administrador/Superadmin ou pelo próprio DT.

O DT pode:

• Adicionar alunos à turma (existentes ou novos).
• Ativar/desativar inscrições de alunos em disciplinas oferecidas.
• Gerir mobilizações individuais ou em massa (enviar vários alunos para uma turma/disciplina de destino).

O sistema impede mobilização duplicada à mesma disciplina em turmas diferentes.

4.3 Atribuições de professores

O DT pode gerir as atribuições de professores da sua turma:

• Associar um professor a uma disciplina da turma.
• O professor atribuído passa a poder criar avaliações para essa turma/disciplina.

5. Administrador

O Administrador gere a estrutura base do sistema: turmas, alunos, disciplinas, utilizadores, anos letivos, configurações de ponderação e atribuições de professores.

5.1 Gestão de utilizadores

Aceda a "Utilizadores" no menu administrativo.

Criar utilizador manualmente

1. Clique em "Novo utilizador".
2. Preencha: Código, Nome, E-mail, Perfil (teacher, admin, superAdmin), Senha.
3. Clique em "Criar".

Editar utilizador

• Clique no utilizador. Pode alterar nome, e-mail, perfil, senha e ativar/desativar a conta.

Filtros disponíveis: Perfil, estado (ativo/inativo), ser DT, turma associada.

5.2 Gestão de turmas e alunos

Turmas

Aceda a "Turmas".

Criar turma

1. Clique em "Nova turma".
2. Introduza o nome (ex: "12 A") e o ano escolar (ex: "2025/2026").
3. A turma é associada automaticamente ao Ano letivo ativo.

Gerir uma turma (DT e alunos)

Clique no nome da turma para aceder à página de gestão.

A página mostra:

• Atribuir DT: selecione um professor ativo como Diretor de Turma.
• Adicionar aluno:
  • Associe um utilizador-aluno já existente (sem turma); ou
  • Crie um novo aluno preenchendo código, nome e e-mail (o sistema cria a conta automaticamente com perfil student).
• Remover aluno: remove da turma. O histórico de inscrições é preservado.
• Inscrições por disciplina: ative/desative a inscrição de cada aluno em cada disciplina oferecida.
• Lista de alunos: apresentada por ordem alfabética do nome, com um filtro para mostrar apenas os alunos inscritos numa disciplina específica.
• Resumo da turma: página de consulta com toda a estrutura (alunos, disciplinas, DT, inscrições externas, mobilizações).
• Imprimir resumo: versão otimizada para impressão.

Importar alunos em massa (para uma turma)

1. Na página de gestão da turma, use o botão "Importar alunos".
2. Faça upload de um ficheiro CSV ou XLSX seguindo o template fornecido.
3. O sistema associa automaticamente os alunos à turma.

Inscrições externas e mobilizações

Na página de gestão da turma:

• Inscrição externa: adiciona um aluno de outra turma para frequentar uma disciplina nesta turma.
• Mobilização: envia um aluno desta turma para frequentar uma disciplina noutra turma (individual ou em massa).

O sistema respeita as disciplinas que cada turma oferece. Não é possível mobilizar a uma disciplina inexistente na turma de destino.

5.3 Gestão de disciplinas

Aceda a "Disciplinas".

• Criar disciplina: introduza o nome. A disciplina fica ativa por defeito.
• Editar disciplina: altere o nome existente.
• Ativar/desativar: desativa uma disciplina para que não apareça em novas atribuições. Disciplinas já usadas em avaliações existentes mantêm-se visíveis.

5.4 Anos letivos

Aceda a "Anos letivos".

• Criar ano letivo: introduza o rótulo (ex: "2025/2026").
• Ativar ano letivo: clique em "Ativar". O sistema desativa automaticamente o anterior.

Apenas um ano letivo pode estar ativo de cada vez. As turmas criadas sem ano letivo definido são associadas ao ativo.

5.5 Importações em massa

O sistema suporta importação via CSV ou XLSX:

Use sempre os templates fornecidos pelo sistema para garantir compatibilidade. O sistema deteta automaticamente se o ficheiro CSV usa vírgula ou ponto e vírgula como separador.

5.6 Configurações de ponderação

Aceda a "Configurações > Ponderação".

O administrador pode definir globalmente:

Regra: Os thresholds devem estar em ordem crescente (Threshold 1 < Threshold 2 < Threshold 3).

Recálculo automático: ao guardar estes parâmetros, o sistema recalcula imediatamente os resultados finais de todas as avaliações abertas (ver secção 3.4) — não é preciso voltar a cada avaliação para atualizar as notas.

Simulador de Pesos Pesados

Na mesma página, um simulador interativo permite testar o efeito de diferentes configurações antes de guardar:

• Um cursor de desvio (%) e um seletor de sobreestimação/subestimação (auto > professor ou auto ≤ professor).
• Campos para simular pesos base diferentes (Professor/Auto/Hetero).
• O simulador lê os valores atuais dos campos do formulário (thresholds, fatores, bónus, escala) em tempo real e mostra os pesos efetivos resultantes num gráfico de barras, sem necessidade de guardar para ver o efeito.

5.7 Atribuições de professores

Aceda a "Atribuições de professores".

• Criar atribuição: selecione professor, turma e disciplina.
• O professor passa a ver essa turma/disciplina no seu painel e pode criar avaliações.
• O DT de uma turma pode também criar atribuições, mas apenas para a sua turma.
• Filtrar e ordenar: a tabela de atribuições atuais pode ser filtrada por Turma e por Disciplina, e ordenada clicando em qualquer cabeçalho (Professor, codUser, Turma, Disciplina).

6. Superadministrador

O Superadministrador tem acesso total a todas as funcionalidades do Administrador, com permissões adicionais.

6.1 Permissões especiais

7. Melhorias Futuras

Esta secção apresenta melhorias identificadas para implementação futura. Não são funcionalidades atuais do sistema.