Funções Principais por Arquivo

Este documento lista as funções-chave para manutenção. Não substitui leitura do código, mas acelera onboarding.

`Untitled-1.js` (núcleo de negócio)

• **Modelos**
• `class Estudante`
• `class Docente`
• `class Instituicao`
• **Notas/indicadores**
• `calcularNotaDisciplina`
• `obterNotaEfetivaEstudante`
• `obterNotaEfetivaEstudantePorSemestre`
• `estudanteTemTodasNotasPreenchidas*`
• **Regras contextuais**
• `resolverRegrasContextoEstudante`
• `classificarFaixaRiscoScore`
• **Agente principal**
• `class LearningAnalyticsAgente`
• `indicadoresPredicaoEstudante(...)`
• `gerarAlertasComNivel(...)`
• métodos de análise agregada e risco.

`index.html` (app principal)

• **Estado e critérios**
• `restaurarEstado`
• `carregarCriterios`
• **KPIs e analytics**
• `atualizarKPIs`
• `atualizarAnalytics`
• `renderizarGraficoCursos`
• **Mapa/geografia**
• `inicializarMapa`
• `atualizarMarcadoresMapa`
• `reverseGeocodeCidadeUF`
• **Importação**
• `importarEstudantesDoArquivo`
• `parseEstudantesCsvTexto`
• `mesclarBaseEstudantes`
• `downloadModeloExcel`

`centro-alertas.html` + `centro-alertas-app.js` (operação)

Lógica da página vive em centro-alertas-app.js (CSS em assets/centro-alertas.css).

• **Carga de dados**
• `restaurarEstado`
• `lerCriterios`
• `lerRegrasContextoLista`
• **Alertas**
• `preencherLista`
• `preencherResumoGlobal`
• `atualizarOpcoesCursoDisciplina`
• **Intervenções**
• `atualizarBlocoIntervencoes`
• `alterarResultadoIntervencao`
• **Saídas**
• `exportarAlertasCSV`
• `gerarResumoRiscoHTML`
• **Recomendação**
• `gerarRecomendacoesLocais`
• `carregarRecomendacoesParaEstudante`

`trajetoria-estudante.html`

• `carregarEstudanteJson`
• `gerarRegrasContextoReal`
• render de score/faixa, histórico, explicabilidade e eventos.
• edição de `pesaRegrasContexto`.

`predicao-risco*.html`

• `predicao-risco.html`
• `nivelRisco`, `carregarEstudantes`, `renderLista`.
• `predicao-risco-perfil.html`
• `montarAlertaParaApi`, `carregarRecomendacoesLLM`, `renderPerfil`.

Demais páginas analíticas

• `benchmarking.html`: métricas comparativas, ranking, coordenadores/docentes.
• `dashboard-executivo.html`: KPIs e relatório executivo.
• `correlacoes.html`: cálculo de correlações (inclui `pearson`).
• `efetividade.html`: fechamento de ciclo e indicadores de efetividade.
• `intervencoes.html`: carga, filtro e exportação do log.
• `heatmap.html` / `temporal-heatmap.html`: mapas e evolução temporal.

Convenções e pontos de atenção

• Muitas funções vivem em `<script>` dentro de cada página (escopo local).
• Persistência principal no `localStorage`; sempre validar parse JSON com `try/catch`.
• Para parâmetros numéricos de API, enviar apenas valores válidos (evitar string vazia).
• Em mudanças de regra de risco, alinhar:
• `Untitled-1.js`
• `centro-alertas.html`
• documentação em `docs/modelos-e-score.md`