Skip to content

Motor de Execução

Especificação técnica — como blocos, fluxos, CDA e revisões funcionam em runtime

Motor de Execução

Esta página responde a uma pergunta central: como o Plano do Aluno — congelado no Primeiro Acesso — se transforma em estudo executável passo a passo?

A resposta se desdobra em três atos. Primeiro, o Motor de Execução do Estudo assume a condução do percurso individual, gerenciando qual fluxo e bloco o Aluno deve executar a cada momento. Depois, o Ciclo Diagnóstico Adaptativo (CDA) avalia o Aluno e libera atividades conforme o nível classificado. Por fim, a cada 4 módulos, o Fluxo Revisional com Revisão Geral, Janela de Revisão e Simulado Objetivo consolida o aprendizado acumulado.

O Motor de Execução pertence ao subdomain engine.algorithm e opera sobre as entidades de engine.plan.


Ato 1 — O Motor assume o percurso

Motor de Execução do Estudo

O Motor de Execução do Estudo é a camada interna que conduz o percurso individual do Aluno após o Primeiro Acesso. Diferente do Motor de Compilação (que gera o Plano de Estudo), o Motor de Execução opera em runtime — a cada interação do Aluno, ele decide:

  • qual é o Fluxo Atual (o fluxo vigente na sequência do Aluno);
  • qual é o Bloco Atual (o passo imediato elegível para execução);
  • quais Atividades estão disponíveis naquele bloco;
  • quando o Aluno pode avançar (Regra de Progressão + Regra de Disponibilidade).

Fluxo Atual e Bloco Atual

O Aluno não navega livremente pela Sequência do Plano. O Motor de Execução mantém dois ponteiros:

  • Fluxo Atual — indica qual Fluxo de Estudo está vigente. No CRE, cada Módulo é um Fluxo de Estudo; a cada 4 módulos, entra um Fluxo Revisional.
  • Bloco Atual — indica o passo imediato dentro do Fluxo Atual. Ao concluir o Bloco Atual, o Motor consulta o Fluxo Atual para identificar o próximo bloco elegível.

Esses estados não criam estrutura paralela — são ponteiros de execução sobre a Sequência já compilada.

Regras que governam o avanço

Regra O que controla Exemplo
Regra de Progressão Quando o Aluno pode avançar de bloco/fluxo Conclusão do bloco atual, conclusão de pré-requisitos
Regra de Disponibilidade Quando um fluxo/bloco fica acessível no tempo Liberação semanal, liberação imediata
Regra de Conclusão Quando um bloco ou atividade é considerado concluído Todas as atividades obrigatórias realizadas

Em Módulos Dinâmicos, a progressão é por conclusão (sem régua temporal). Em Módulos Estáticos, o Aluno precisa respeitar tanto a Regra de Disponibilidade quanto a Regra de Progressão.

Entidades envolvidas

Entidade Tipo Subdomain Papel
execution_engine process_domain engine.algorithm O motor que conduz o percurso individual
study_flow execution_component engine.plan Fluxo de Estudo — contêiner de blocos
study_block execution_component engine.plan Bloco de Estudo — passo executável
activity entity engine.plan Atividade — menor unidade executável
stage entity_child engine.plan Etapa — agrupamento de 4 módulos (no CRE)

Ato 2 — O CDA avalia e adapta

Ciclo Diagnóstico Adaptativo (CDA)

O CDA é o mecanismo central de adaptação da HÉLICO. Ele abre cada Módulo nos presets que o habilitam (CRE, Reta Final Intensivo, Reta Final 2ª Fase) e funciona em dois segmentos sequenciais:

Bloco CDA
  ├── Segmento DI (Diagnóstico Inicial)
  │     ├── Questionário VF (5 questões/Unidade, questões pares primeiro)
  │     ├── Classificação de Nível por Unidade
  │     └── Atividades Adaptativas (conforme nível)
  └── Segmento SVD (Simulado de Verificação de Desempenho)
        ├── Questionário VF (5 questões/Unidade, questões ímpares)
        ├── Reclassificação de Nível
        └── Leitura de Reforço (se nível caiu para Básico)

Segmento DI — Diagnóstico Inicial

O DI é a avaliação de entrada. O sistema monta um Questionário VF com 5 questões por Unidade do Módulo, priorizando questões pares. O resultado classifica o Aluno em três níveis por Unidade:

Nível Faixa de acertos (default) Atividade liberada
Básico abaixo de 50% Resumo — estudo regular completo, Aluno produz conteúdo próprio
Intermediário 50% a 79% Leitura — estudo otimizado, Aluno recebe conteúdo da plataforma
Avançado 80% ou mais Dispensa — Aluno pula direto para o SVD

Thresholds configuráveis

Os limiares 50% e 80% são defaults globais. A Trilha Pedagógica pode definir valores diferentes via limiares nos Parâmetros da Trilha (decisão A-10).

A opção “Não Sei” no Questionário VF é tratada como erro — conta contra o Aluno na classificação.

Atividades Adaptativas por nível

Nível Básico → Resumo (estudo regular completo):

  1. O Aluno recebe os tópicos da Unidade e produz seu próprio resumo na plataforma (campo em branco por Unidade, agrupado por Disciplina em abas).
  2. Se algum título ficar em branco, a plataforma pergunta se deseja preenchê-lo com o resumo da HÉLICO. Na situação híbrida (parte do Aluno, parte da HÉLICO), o material é considerado como produzido pelo Aluno no Caderno Online.
  3. O Aluno pode optar por não fazer o resumo — nesse caso, o sistema exibe um alerta de confirmação dupla: “Recomendamos que você faça o RESUMO. Essa é uma das formas mais eficientes de aprendizagem.” Somente após dupla manifestação de vontade, a plataforma considera a Disciplina daquele Módulo como cumprida.
  4. Se o Aluno recusa o Resumo, o Caderno Online é preenchido automaticamente com o conteúdo HÉLICO (como se fosse Intermediário).
  5. O conteúdo produzido (ou recebido) vai para o Caderno Online.

Nível Intermediário → Leitura (estudo otimizado):

  1. O Aluno recebe o conteúdo já produzido pela plataforma (resumo HÉLICO) pré-preenchido.
  2. Pode grifar, anotar e interagir — interações salvas no Caderno Online.

Nível Avançado → Dispensa:

O Aluno é dispensado das atividades formativas do Segmento DI e avança direto para o SVD.

Segmento SVD — Verificação de Desempenho

Após as atividades do DI (ou direto, se Avançado), o Aluno faz o SVD: outro Questionário VF com 5 questões por Unidade (agora questões ímpares). O SVD reclassifica o nível. A classificação considera a nota média entre DI e SVD, o que significa que o Aluno pode ser rebaixado de nível (ex: Avançado no DI → Básico no SVD se zerar a avaliação).

Resultado SVD Efeito
Básico Leitura de Reforço — releitura do material (detalhes abaixo)
Intermediário Avança para o próximo bloco
Avançado Avança para o próximo bloco

Leitura de Reforço — regras detalhadas por cenário DI

O conteúdo da Leitura de Reforço depende do que aconteceu no Segmento DI:

Cenário 1: DI Básico → SVD Básico

O Aluno já produziu Resumo (ou recebeu conteúdo HÉLICO). Na Leitura de Reforço:

  1. Se o Aluno fez o Resumo próprio, a plataforma oferece duas opções: “Ler seu próprio material” ou “Ler resumo HÉLICO”.
  2. Se o Aluno não fez o Resumo (recusou na etapa anterior), a plataforma apresenta diretamente o material HÉLICO para releitura.
  3. Se o Aluno fez Resumo próprio e escolhe ler o resumo HÉLICO, ao final a plataforma pergunta se deseja substituir o material próprio pelo da HÉLICO no Caderno Online (ponto de atenção: o artefato do Aluno é descartado).

Cenário 2: DI Intermediário → SVD Básico

O Aluno já fez Leitura do material HÉLICO. A Leitura de Reforço é uma releitura completa do mesmo material já fornecido.

Cenário 3: DI Avançado → SVD Básico

O Aluno obteve Dispensa no DI e não consumiu material. A Leitura de Reforço exibe o conteúdo de forma inédita — o mesmo conteúdo que seria apresentado como Leitura (nível Intermediário), que o Aluno ainda não viu (decisão A-11). Ao concluir, o conteúdo fica disponível no Caderno Online.

Conteúdo padrão e personalizado

O conteúdo dos tópicos elaborados pelos professores HÉLICO é padrão para todos os Alunos. Torna-se personalizado à medida que o Aluno interage (grifos, anotações, edições). As interações ficam no Caderno Online.

Após o SVD (e eventual Leitura de Reforço), o Aluno avança para o próximo Bloco de Estudo do Módulo (Simulado Escrito, se houver, ou Revisão do Módulo).

Simulados Escritos no fluxo do Módulo

Nos presets que os habilitam, os Simulados Escritos são aplicados após o CDA (após DI+SVD e eventuais atividades adaptativas). Os tipos possíveis são:

  • Questões Discursivas — respostas dissertativas sobre temas jurídicos
  • Dissertações — textos argumentativos mais longos
  • Peças Práticas — redação de peças processuais jurídicas

As notas atribuídas pelo Tutor na correção dos Simulados Escritos são utilizadas na composição da Nota Bruta (NB) da Unidade (ver Métricas e Classificação). Essas notas também orientam a seleção de conteúdos nas Revisões Gerais.

Após os Simulados Escritos (ou direto após o CDA, se não habilitados), o fluxo avança para o Bloco de Revisão do Módulo.

Regra de questões pares e ímpares

No CDA, o DI usa questões pares e o SVD usa questões ímpares da mesma Unidade. Essa separação garante que a verificação (SVD) não repita as mesmas questões do diagnóstico (DI).

Regra exclusiva do CDA

A regra pares/ímpares se aplica apenas ao CDA (DI e SVD). Em Simulados Avulsos e outros contextos fora do CDA, a seleção de questões segue critérios próprios definidos na Configuração das Atividades.

Status do Ciclo CDA

Status Significado
Ciclo CDA em DI Aluno está no Segmento DI
Ciclo CDA em SVD Aluno está no Segmento SVD
Ciclo CDA Concluído DI e SVD finalizados, classificação registrada

Entidades envolvidas

Entidade Tipo Subdomain Papel
cda_block execution_component engine.plan Bloco CDA — contêiner dos segmentos
cda_cycle process engine.plan Ciclo DI → SVD com classificação
adaptive_activities concept engine.algorithm Atividades liberadas por nível
exemption rule engine.plan Dispensa de atividades por desempenho

Ato 3 — Revisões e Etapas consolidam o aprendizado

Revisão do Módulo

Ao final de cada Módulo (nos presets que a habilitam), o Bloco de Revisão do Módulo oferece a Prática com Flashcards — flashcards agregados das Unidades do Módulo que acabou de ser concluído.

Etapa e Fluxo Revisional

No CRE, a cada 4 Módulos completa-se uma Etapa. Ao final da Etapa, o Motor de Execução insere um Fluxo Revisional com:

  1. Bloco de Revisão Geral — retomada ampla do conteúdo previsto pela Janela de Revisão
  2. Bloco de Simulado Objetivo — avaliação com questões objetivas selecionadas pelo Critério de Priorização

Se o número total de Módulos não é múltiplo de 4, a última Etapa pode ter menos módulos, seguida igualmente de Fluxo Revisional.

Janela de Revisão

A Janela de Revisão define quais Módulos entram no escopo de cada Revisão Geral. Ela opera em três períodos (formalizados em Classificação de Nível):

Período de Crescimento (RG1–RG3): a janela acumula todos os Módulos desde o início.

Revisão Módulos
RG1 M1–M4
RG2 M1–M8
RG3 M1–M12

Período de Deslizamento (RG4–RG5): mantém 12 Módulos, avança 4, retira os 4 mais antigos.

Revisão Módulos
RG4 M5–M16
RG5 M9–M20

Período Cumulativo (RG6+): combina janela deslizante de 12 Módulos novos e repetição cíclica de uma RG anterior.

Revisão Faixa cumulativa Faixa deslizante
RG6 RG1 → M1–M4 M13–M24
RG7 RG2 → M5–M8 M17–M28

O efeito é espaçamento crescente de revisão: ~1 mês, ~2 meses, ~3 meses e ~6 meses.

Simulado Objetivo na Revisão Geral

O Simulado Objetivo aplicado na Revisão Geral é exatamente o mesmo evento configurado como “final da Etapa” no parâmetro Momento do Simulado Objetivo (decisão A-12). Não é uma instância separada — é o mesmo Simulado Objetivo previsto na Etapa, posicionado após a Revisão Geral.

A montagem usa a Janela de Revisão como escopo e o Critério de Priorização do Simulado Objetivo:

  1. Priorizar Unidades classificadas como Básico
  2. Completar com Intermediário, depois Avançado
  3. Priorizar as mais antigas quando há excesso de Básico
  4. Distribuir 1 questão por Unidade antes de repetir
  5. Priorizar questões ainda não utilizadas
  6. Reutilizar quando o estoque se esgotar

Entidades envolvidas

Entidade Tipo Subdomain Papel
review_window rule engine.plan Janela de Revisão — 3 fases
general_review_block execution_component engine.plan Bloco de Revisão Geral
objective_exam_block execution_component engine.plan Bloco de Simulado Objetivo
module_review_block execution_component engine.plan Bloco de Revisão do Módulo (Flashcards)
review_cycle concept engine.plan Ciclo de 4 Módulos que forma uma Etapa
stage entity_child engine.plan Etapa — marco que aciona Fluxo Revisional

Signals emitidos neste ato

Signal Payload Emitido por
block_completed block_id, block_type, student_plan_id Motor de Execução
flow_completed flow_id, flow_type, student_plan_id Motor de Execução
stage_completed stage_id, stage_number, student_plan_id Motor de Execução
cda_classification_done student_id, unit_id, level, segment (DI/SVD) cda_cycle
review_window_computed review_number, module_ranges[], phase Motor de Execução

Ato 4 — Regras de execução por Modalidade de Produto

Os três atos anteriores descrevem o fluxo completo do Curso Regular Extensivo (CRE) — a modalidade mais complexa. As demais modalidades operam com subconjuntos dessas mesmas regras, governadas pelos Parâmetros da Trilha (Configuração Pedagógica).

O Motor de Execução não tem código separado por modalidade — ele consulta as Configurações do Plano de Estudo e decide quais blocos, atividades e regras estão habilitados. A modalidade é apenas o preset que definiu esses parâmetros.

Curso Regular Extensivo (CRE)

Fluxo completo e obrigatório — descrito nos Atos 1, 2 e 3 acima. Características exclusivas:

  • Módulos Dinâmicos — gerados a partir das horas semanais do Aluno
  • CDA completo (DI + SVD + Atividades Adaptativas)
  • Revisão do Módulo (Flashcards)
  • Revisão Geral + Simulado Objetivo a cada 4 Módulos (Etapa)
  • Janela de Revisão com as 3 fases (Crescimento, Deslizamento, Cumulativa)
  • Simulados Escritos (quando habilitados)
  • Tutoria (quando habilitada)
  • Único fluxo que contempla Revisão Geral

Sequência por Módulo no CRE:

Módulo (CRE)
  ├── Bloco CDA
  │     ├── Segmento DI (Questionário VF → Classificação → Atividades)
  │     └── Segmento SVD (Questionário VF → Reclassificação → Leitura de Reforço se Básico)
  ├── Bloco de Simulado Escrito (se habilitado)
  └── Bloco de Revisão do Módulo (Flashcards)
  
  A cada 4 Módulos:
  └── Fluxo Revisional
        ├── Bloco de Revisão Geral
        └── Bloco de Simulado Objetivo

Reta Final — Modalidades de 1ª Fase

As modalidades de Reta Final de 1ª Fase preparam para a fase objetiva de concursos. Duas variantes:

Reta Final 1ª Fase — Intensivo:

  • Módulos Dinâmicos (Aluno define horas)
  • CDA completo (DI + SVD + Atividades Adaptativas)
  • Caderno Online habilitado
  • Revisão do Módulo (Flashcards)
  • Sem Revisão Geral
  • Simulado Objetivo aplicado ao final de cada Módulo (não ao final da Etapa)
  • Sem Simulado Escrito
Módulo (Reta Final Intensivo)
  ├── Bloco CDA (DI + SVD + Atividades)
  ├── Bloco de Revisão do Módulo (Flashcards)
  └── Bloco de Simulado Objetivo (final do Módulo)

Reta Final 1ª Fase — Express:

  • Módulos Estáticos (1 semana por Módulo)
  • Sem CDA — sem DI, sem SVD, sem atividades adaptativas
  • Caderno Online habilitado — atividades exclusivamente de Leitura
  • Ao finalizar todas as Disciplinas, avança para Simulado Objetivo
Módulo (Reta Final Express)
  └── Bloco de Leitura (todas as Disciplinas do Módulo)

Após todos os Módulos:
  └── Bloco de Simulado Objetivo (final do curso)

Reta Final — Modalidades de 2ª Fase

As modalidades de 2ª Fase preparam para a fase discursiva/escrita de concursos.

Reta Final 2ª Fase (com/sem Tutor):

  • Módulos Dinâmicos (Aluno define horas)
  • CDA completo (DI + SVD + Atividades Adaptativas)
  • Caderno Online habilitado
  • Revisão do Módulo (Flashcards)
  • Simulados Escritos (todos os tipos)
  • Sem Revisão Geral
  • Sem Simulado Objetivo
Módulo (Reta Final 2ª Fase)
  ├── Bloco CDA (DI + SVD + Atividades)
  ├── Bloco de Simulado Escrito
  └── Bloco de Revisão do Módulo (Flashcards)

Reta Final 2ª Fase — Peças (com/sem Tutor):

  • Módulos Estáticos (1 semana por Módulo)
  • Sem CDA
  • Somente Simulados Escritos do tipo Peça Prática
  • Regra de disponibilidade por Data de Início do Produto (Data Âncora)
Módulo (Reta Final Peças)
  └── Bloco de Simulado Escrito (Peça Prática)

Simulados Avulsos

Modalidades onde o Produto é composto exclusivamente por Simulados. Operam com Módulos Estáticos (1 semana por Módulo) e sem CDA.

Regras comuns a todos os Simulados Avulsos:

  • Módulos Estáticos — trava semanal impede avanço antes de completar a semana
  • Sem CDA — sem DI, sem SVD, sem atividades adaptativas
  • Sem Revisão Geral — sem Etapas
  • Sem Caderno Online (em geral)
  • A quantidade de atividades depende do que for cadastrado no Produto

Simulados VF (avulso):

  • Somente Questionário VF — funciona como DI e SVD mas sem separação entre os dois
  • Sem botão “Não Sei” — diferença do VF no CDA, onde “Não Sei” existe e conta como erro
  • Se houver VF ou Objetivo obrigatório, o Aluno não pode avançar sem resolvê-los

Simulados Objetivos (avulso):

  • Somente questões de múltipla escolha
  • Módulos Estáticos semanais

Simulados de Flashcards (avulso):

  • Equivalente à “Revisão do Módulo” do CRE, funcionando de forma isolada

Simulados Escritos (avulso) — Curso Regular de Peças / Curso Regular de 2ª Fase:

  • Módulos Estáticos semanais
  • Somente Simulados Escritos (todos os tipos ou apenas Peça Prática)
  • Regra de disponibilidade: por data de inscrição do Aluno (Curso Regular) ou por Data Âncora (vinculado a edital)

Produtos vinculados a Edital

Quando o Produto é vinculado a um edital específico (data certa de início e término):

  • A liberação de Módulos segue o cronograma do Produto, não a data de inscrição do Aluno
  • Se o Aluno compra o acesso após a Data de Início, recebe acesso imediato e acumulado a todos os Módulos já liberados (Matrícula Tardia com cronograma mantido)
  • Exemplo: curso de 1 mês com 4 Módulos semanais — Aluno que entra na 2ª semana recebe 2 Módulos liberados

Resumo comparativo

Modalidade Módulo CDA Rev. Módulo Rev. Geral Sim. Objetivo Sim. Escrito Tutoria
CRE (com/sem Tutor) Dinâmico ✅ ✅ ✅ Fim da Etapa Opcional Opcional
Reta Final 1ª Intensivo Dinâmico ✅ ✅ ❌ Fim do Módulo ❌ ❌
Reta Final 1ª Express Estático ❌ ❌ ❌ Fim do curso ❌ ❌
Reta Final 2ª (com/sem Tutor) Dinâmico ✅ ✅ ❌ ❌ ✅ Opcional
Reta Final 2ª Peças Estático ❌ ❌ ❌ ❌ Peça Prática Opcional
Curso Regular Peças Estático ❌ ❌ ❌ ❌ Peça Prática ❌
Curso Regular 2ª Fase Estático ❌ ❌ ❌ ❌ ✅ ❌
Simulados VF (avulso) Estático ❌ ❌ ❌ ❌ ❌ ❌
Simulados Objetivos (avulso) Estático ❌ ❌ ❌ ❌ ❌ ❌
Simulados Flashcards (avulso) Estático ❌ ❌ ❌ ❌ ❌ ❌

Modelo de dados

Entidades de execução

# Identifier Tipo Subdomain Papel
1 study_flow execution_component engine.plan Fluxo de Estudo (Módulo, Revisional)
2 study_block execution_component engine.plan Bloco de Estudo (passo executável)
3 cda_block execution_component engine.plan Bloco CDA (DI + SVD)
4 general_review_block execution_component engine.plan Bloco de Revisão Geral
5 objective_exam_block execution_component engine.plan Bloco de Simulado Objetivo
6 module_review_block execution_component engine.plan Bloco de Revisão do Módulo
7 stage entity_child engine.plan Etapa (ciclo de 4 módulos)

Processos e regras

# Identifier Tipo Subdomain
8 execution_engine process_domain engine.algorithm
9 cda_cycle process engine.plan
10 adaptive_activities concept engine.algorithm
11 exemption rule engine.plan
12 review_window rule engine.plan
13 review_cycle concept engine.plan

O que esta página não define

  • Detalhes de cada tipo de Atividade e Formato de Execução → Atividades (Passo 8)
  • Fórmulas de NB, NA e algoritmo de classificação → Métricas e Classificação (Passo 9)
  • Como o Roteiro de Estudos é apresentado ao Aluno no frontend → Entrega ao Aluno (Passo 10)

Referências

Navigation

Type to search…

↑↓ navigate↵ selectEsc close