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: 24 horas.

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: 24 horas.

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 e total de avaliações ativas/a concluir.
• Avaliações — cartões individuais para cada disciplina 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.

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.

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

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.

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".

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.

Reabrir um aluno individual

• Na tabela de alunos, clique em "Reabrir" ao lado do aluno pretendido.
• O sistema ativa a reabertura para esta avaliação específica. No painel do aluno, o botão muda para "Reavaliar" e permite editar as respostas anteriores que já se encontram carregadas.

Reabrir todos os alunos

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

Calcular resultados finais (Cálculo parcial flexível)

• Clique em "Calcular resultados finais".
• Cálculo parcial permitido: O cálculo de notas já não bloqueia se existirem alunos com dados incompletos. O sistema calcula a nota de todos os alunos que tenham os dados completos (professor, auto e hetero correspondente) e simplesmente salta/ignora os restantes sem bloquear a turma.
• As notas calculadas e os resultados das penalizações/bónus são gravados e atualizados na tabela.

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.
• "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.

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.
• 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.

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).

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.

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.