Skip to content

REF-40-B: Invariantes operacionais do CRE

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 == true

INV-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_ETAPA

INV-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 != CONCLUIDO

Invariantes 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.inicio

INV-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 == true

INV-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 == IMPARES

INV-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 == 5

Invariantes 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 <= 100

INV-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 <= 3

INV-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 == true

INV-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 == false

Nota: 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_ESTUDOS

Invariantes 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_ESTATICO

INV-18. Reta Final sem Revisão Geral

Nenhuma modalidade de Reta Final possui Revisão Geral.

assert reta_final.revisao_geral_habilitada == false

Critérios de aceitação

  1. Cada invariante deve ter pelo menos 1 teste automatizado
  2. Violação de INV-01 a INV-04 é bloqueante na Validação da Trilha (Etapa 7)
  3. INV-05 a INV-08 são validados em runtime pelo Motor de Execução
  4. INV-09 a INV-14 são validados pelo algoritmo de seleção de questões
  5. INV-17 e INV-18 são garantidos pelo locked_fields dos presets
Navigation

Type to search…

↑↓ navigate↵ selectEsc close