REF-40-B: Invariantes operacionais do CRE
Status: Aceito Data: 2026-04-23 ADR: ADR-40 — Configuração por Preset e invariantes do Produto Autor: Michael Meneses (Arquiteto) Fonte: Gestor Pedagógico (confirmado em 2026-03-05)
Propósito
Contrato testável das regras operacionais do Curso Regular Extensivo (CRE) — a modalidade principal da HÉLICO. Cada invariante é uma asserção verificável em testes automatizados.
Escopo
Estas invariantes se aplicam exclusivamente ao preset CRE (com ou sem Tutor). Outros presets podem ter subconjuntos dessas regras, mas somente o CRE garante todas.
Invariantes estruturais
INV-01. Revisão Geral obrigatória
No CRE, a Revisão Geral é sempre habilitada. Não pode ser desabilitada via Parâmetros da Trilha.
assert config.revisao_geral_habilitada == trueINV-02. Fluxo fixo: Revisão Geral → Simulado Objetivo
No CRE, o fluxo pós-Etapa é fixo: Bloco de Revisão Geral seguido de Bloco de Simulado Objetivo. A ordem não é configurável.
assert fluxo_revisional.blocos == [REVISAO_GERAL, SIMULADO_OBJETIVO]INV-03. Simulado Objetivo obrigatório após Revisão Geral
O Simulado Objetivo não pode ser pulado após a Revisão Geral no CRE.
assert config.simulado_objetivo_habilitado == true
assert config.momento_simulado_objetivo == MOMENTO_FIM_ETAPAINV-04. Progressão bloqueada sem conclusão da Revisão Geral
O Aluno não avança para o próximo Módulo sem concluir Revisão Geral + Simulado Objetivo.
assert proximo_modulo.disponivel == false
when bloco_revisao_geral.status != CONCLUIDO
or bloco_simulado_objetivo.status != CONCLUIDOInvariantes do CDA
INV-05. Ordem global por lote
No CDA, a ordem é: todos DI de todas Disciplinas → todas Atividades DI → todos SVD de todas Disciplinas → todas Atividades SVD. Não é por Disciplina individual.
assert segmento_di.todas_disciplinas.concluido == true
before segmento_svd.inicioINV-06. Dispensa não altera sequência macro
A Dispensa remove a Atividade local (Resumo, Leitura), mas não antecipa o Segmento SVD. O Aluno dispensado no DI avança direto para o SVD, mas na mesma posição sequencial.
assert dispensa.nao_altera_ordem_segmentos == trueINV-07. DI pares / SVD ímpares
No CDA, o DI usa questões VF pares e o SVD usa questões VF ímpares da mesma Unidade. Essa separação garante que a verificação não repita questões do diagnóstico.
assert di.questoes_vf.filtro == PARES
assert svd.questoes_vf.filtro == IMPARESINV-08. 5 questões VF por Unidade no DI/SVD
Cada Unidade contribui com 5 questões para o DI e 5 para o SVD. A quantidade total por Módulo = 5 × número de Unidades no Módulo.
assert di.questoes_por_unidade == 5
assert svd.questoes_por_unidade == 5Invariantes do Simulado Objetivo
INV-09. Limite de 100 questões
O Simulado Objetivo no CRE tem limite máximo de 100 questões.
assert simulado_objetivo.max_questoes <= 100INV-10. Seleção em fases por nível, round-robin de 3 rodadas
A seleção de questões do Simulado Objetivo ocorre em fases por nível de classificação: primeiro as Unidades Básicas, depois as Intermediárias e por fim as Avançadas (Unidades mais antigas primeiro dentro de cada fase). Cada fase é um round-robin de até 3 rodadas — 1 questão por Unidade por rodada, no máximo 3 questões por Unidade na fase. Só passa para a próxima fase após esgotar as rodadas da atual; o cap de 100 questões interrompe a qualquer momento.
assert simulado_objetivo.criterio_selecao == FASES_POR_NIVEL
assert fase.ordem == [BASICO, INTERMEDIARIO, AVANCADO]
assert fase.max_rodadas == 3
assert questoes_por_unidade_por_fase <= 3INV-11. Simulado único e adaptativo por Revisão Geral
Cada Revisão Geral gera um Simulado Objetivo personalizado e diferente para o Aluno. Não reutiliza composição de revisões anteriores.
assert simulado_objetivo.composicao.unica_por_revisao == trueINV-12. Reclassificação com 3 fatores
A reclassificação pós-Simulado Objetivo usa: desempenho (Nota), Importância e Incidência da Unidade.
assert reclassificacao.fatores == [DESEMPENHO, IMPORTANCIA, INCIDENCIA]INV-13. Reclassificação pode subir, manter ou cair
Os três desfechos são explicitamente permitidos. A classificação usa nota média DI+SVD, portanto um Aluno Avançado no DI que zerar o SVD pode ser rebaixado.
assert reclassificacao.desfechos_possiveis == [SUBIR, MANTER, CAIR]Invariantes de questões
INV-14. Preferência por questões inéditas; sem reciclagem na seleção
Dentro de cada Simulado Objetivo a seleção prefere questões ainda não utilizadas e não recicla: questão já respondida em Revisão Geral anterior (slots exam_objective/general_review) é pulada via dedup por chave composta unit_id:question_id. O reforço do ponto fraco vem das 3 rodadas por fase sobre a Unidade de menor classificação (INV-10), não da repetição da mesma questão.
assert questoes.prefere_ineditas == true
assert questoes.recicla_quando_esgota == falseNota: a repetição como reforço só ocorre naturalmente quando uma Unidade de baixo desempenho permanece na Janela de Revisão de RGs seguintes e novas questões inéditas dela são selecionadas.
Invariantes de Atividades
INV-15. Simulado Escrito: critérios gerais + específicos
A correção do Simulado Escrito segue critérios gerais por tipo de simulado (Discursiva, Dissertação, Peça Prática) e critérios específicos por cada questão (Parâmetros Específicos de Correção).
assert simulado_escrito.criterios == [GERAIS_POR_TIPO, ESPECIFICOS_POR_QUESTAO]INV-16. Caderno Online: ferramenta global com visibilidade restrita
O Caderno Online é acessível globalmente, mas o conteúdo das Atividades do Bloco Atual fica limitado à visualização no Roteiro de Estudos. Somente conteúdo de Atividades concluídas aparece na visão global do Caderno.
assert caderno_online.visibilidade_global == ATIVIDADES_CONCLUIDAS
assert caderno_online.visibilidade_bloco_atual == ROTEIRO_DE_ESTUDOSInvariantes comerciais
INV-17. Simulados Avulsos sempre sem CDA
Produtos de Simulados Avulsos operam sem CDA, sem Revisão Geral e com Módulo Estático.
assert simulados_avulsos.cda_habilitado == false
assert simulados_avulsos.revisao_geral_habilitada == false
assert simulados_avulsos.tipo_modulo == MODULO_ESTATICOINV-18. Reta Final sem Revisão Geral
Nenhuma modalidade de Reta Final possui Revisão Geral.
assert reta_final.revisao_geral_habilitada == falseCritérios de aceitação
- Cada invariante deve ter pelo menos 1 teste automatizado
- Violação de INV-01 a INV-04 é bloqueante na Validação da Trilha (Etapa 7)
- INV-05 a INV-08 são validados em runtime pelo Motor de Execução
- INV-09 a INV-14 são validados pelo algoritmo de seleção de questões
- INV-17 e INV-18 são garantidos pelo
locked_fieldsdos presets