Portal Acadêmico do CED Stella dos Cherubins

1. O problema hoje

Boa parte dos portais escolares públicos foi pensada para a secretaria, não para a família. O resultado é conhecido por qualquer pai ou aluno: telas confusas, muitos cliques para achar uma nota, boletim que só aparece no fim do bimestre, senha esquecida sem caminho de recuperação, instabilidade em época de fechamento e nenhum aviso quando algo importante acontece.

O prejuízo não é estético. Quando a informação chega tarde, a escola perde a chance de agir: o aluno já reprovou por falta, a média já caiu, a família só descobre na reunião final.

• Informação fragmentada: notas em um lugar, faltas em outro, comunicação por papel.
• Nenhuma leitura de tendência — só o número cru do passado.
• Linguagem técnica e siglas que a família não entende.
• Sem canal de resposta: a dúvida vira ligação ou visita presencial.

2. O que este portal faz

É um sistema completo de acompanhamento acadêmico do CED Stella dos Cherubins, com quatro perfis de acesso e uma única base de dados. Cada pessoa entra com a sua conta e vê apenas o que lhe diz respeito.

• Coordenação: monta o ano letivo e os bimestres, define média mínima, recuperação e limite de faltas, cria turmas e disciplinas, cadastra alunos e responsáveis, vincula professores, aplica e acompanha medidas disciplinares, gerencia contas e lê relatórios e projeções.
• Professor: vê só as suas turmas, cria avaliações com pesos, lança notas, faz chamada, registra observações para a família e acompanha o desempenho projetado da turma.
• Aluno: notas por bimestre, média, situação, faltas, observações dos professores, registro disciplinar e desempenho projetado.
• Responsável: tudo o que o aluno vê, em versão ampliada — comparação com a turma, histórico de cada avaliação, faltas por data, cenários de aprovação, gravidade e medida de cada ocorrência.
• Atendimento e chamados: dúvidas respondidas no próprio portal e, se necessário, encaminhadas à direção com histórico anexado.

3. Como funciona por dentro

A regra de cálculo não está escrita no código: ela vem dos parâmetros do ano letivo. A escola define média mínima, média de recuperação, limite de faltas e nota máxima; o portal aplica isso em cada tela.

A média bimestral é ponderada pelos pesos das avaliações. A média anual combina os bimestres e, quando há recuperação, o portal recalcula a situação segundo a regra da escola. A frequência é apurada por aula registrada na chamada.

As estatísticas projetivas usam regressão linear sobre as médias já lançadas para estimar a média final, a nota necessária no bimestre seguinte e a frequência projetada, classificando cada aluno em seguro, atenção ou risco alto. Com um único bimestre lançado, a tela avisa que a projeção é preliminar.

4. Tecnologia e linguagem

O sistema foi escrito em TypeScript, do navegador ao servidor — a mesma linguagem nas duas pontas, com tipos verificados antes de publicar, o que elimina uma classe inteira de erros em produção.

• Interface: React com renderização no servidor, o que dá abertura rápida mesmo em conexão ruim ou celular modesto.
• Servidor: funções sob demanda, sem máquina ligada à espera — escala nos picos de fechamento de bimestre e não custa nada nos períodos calmos.
• Banco de dados: PostgreSQL, com as médias e a situação de cada aluno calculadas por visões do próprio banco (fonte única de verdade, sem número divergente entre telas).
• Segurança de dados: cada linha da tabela tem regra de acesso no banco. Um responsável não consegue ler o filho de outro nem alterando a requisição, porque a permissão é verificada pelo banco, não pela tela.
• Autenticação: senha com confirmação de e-mail, primeiro acesso por RA mais código de acesso entregue pela secretaria, limites de tentativa contra ataque de força bruta e trilha de auditoria em toda alteração de nota.

5. Vantagens sobre os portais atuais

6. Roteiro da demonstração

Sugestão de percurso de cinco minutos, na ordem que costuma convencer a plateia:

1. 1Entrar como responsável: boletim, faltas, observações do professor e registro disciplinar do filho.
2. 2Abrir Desempenho no mesmo acesso: média projetada, comparação com a turma e a nota necessária para aprovação.
3. 3Entrar como professor: lançar uma nota e fazer a chamada, mostrando que o dado aparece na hora para a família.
4. 4Entrar como coordenação: projeções por turma, onde estão os alunos em risco e o registro de uma medida disciplinar.
5. 5Encerrar no Atendimento e nos Chamados: a dúvida da família resolvida sem telefone, com histórico.