Skip to content

Aluno e Matrícula

Especificação técnica — como o acesso é concedido, o Aluno faz Onboarding e o Plano do Aluno nasce

Aluno e Matrícula

Esta página responde a uma pergunta central: como um Pedido comercial se transforma em acesso pedagógico efetivo — e como o Aluno passa de “comprou” para “está estudando”?

A resposta se desdobra em três atos. Primeiro, o Ciclo de Acesso transforma eventos comerciais (Pedidos) em artefatos operacionais no Moodle (Inscrição, Matrícula). Depois, o Aluno passa pelo Onboarding, informa sua disponibilidade e, no Primeiro Acesso, recebe seu Plano do Aluno — a instância individual e congelada do estudo. Por fim, a Vigência de Acesso governa por quanto tempo o Aluno pode estudar, e as políticas de renovação e revogação definem o que acontece quando o acesso precisa mudar.

Os processos descritos aqui pertencem aos subdomains engine.access (Ciclo de Acesso, Matrícula, Vigência) e engine.onboarding (Onboarding, Primeiro Acesso, Aluno).


Ato 1 — Do Pedido ao acesso

Ciclo de Acesso

O Ciclo de Acesso é o pipeline que transforma sinais comerciais em acesso utilizável no Moodle. Ele não é execução pedagógica — é provisionamento de sistema.

O fluxo completo:

Pedido (WooCommerce)
  └── Item do Pedido (SKU)
        └── Vinculação Item-Curso-Produto
              └── Evento de Sincronização Comercial
                    └── Concessão de Acesso
                          └── Provisionamento de Acesso
                                ├── Inscrição no Curso-Produto (Moodle)
                                └── Matrícula (pedagógica)
                                      └── Vigência de Acesso

Evento de Sincronização Comercial

O gateway de pagamento (WooCommerce) comunica mudanças de status do Pedido ao sistema. O Evento de Sincronização Comercial é a tradução desses status nativos em efeitos operacionais de acesso. Nem todo status do WooCommerce gera efeito — o sistema interpreta apenas os que impactam concessão, renovação ou revogação.

Concessão e Provisionamento

A Concessão de Acesso é o ato operacional que converte um item comercial elegível em acesso técnico a um ou mais Curso-Produto no Moodle. É a ponte entre o Pedido e os artefatos operacionais.

O Provisionamento de Acesso materializa os artefatos: cria a Inscrição no Curso-Produto (vínculo técnico Moodle), gera a Matrícula (vínculo pedagógico) e define a Vigência de Acesso.

Inscrição vs. Matrícula

Esses dois conceitos são distintos e não devem ser confundidos:

Conceito Natureza Onde vive O que controla
Inscrição no Curso-Produto Técnica (Moodle) enrol do Moodle Vínculo do usuário ao curso no LMS
Matrícula Pedagógica (HÉLICO) EAV do plugin Autorização pedagógica, vigência, Plano do Aluno

A Inscrição é pré-requisito da Matrícula, mas não a substitui. O Aluno pode estar inscrito no Moodle sem ter Matrícula HÉLICO ativa.

Matrícula

A Matrícula é o vínculo operacional-pedagógico que habilita o Aluno ao respectivo Plano de Estudo. Seus atributos principais:

  • Status da Matrícula — Ativa, Suspensa ou Inativa
  • Vigência de Acesso — janela temporal (Data de Início e Data de Término da Matrícula)
  • Carga Horária de Referência — parâmetro que dimensiona Módulos Dinâmicos
  • Matrícula Tardia — quando o Aluno se matricula após a Data Âncora do Produto

Matrícula Tardia: acesso acumulado

Na opção “manter cronograma”, o Aluno recém-matriculado recebe acesso imediato e acumulado a todos os módulos passados desde a Data Âncora. O estudo começa do ponto atual, não do início.

Entidades envolvidas

Entidade Tipo Subdomain Papel
enrolment entity_root engine.access Matrícula — vínculo pedagógico
access_validity entity_child engine.access Vigência de Acesso — janela temporal
access_grant process_domain engine.access Concessão — converte item comercial em acesso
access_provisioning process_domain engine.access Provisionamento — materializa Inscrição + Matrícula
course_product_enrolment process_domain engine.access Inscrição no Curso-Produto — vínculo técnico Moodle

Signals emitidos neste ato

Signal Payload Emitido por
commercial_sync_received order_id, order_status, items[] Gateway (WooCommerce)
access_granted enrolment_id, product_id, course_product_id, validity access_grant
enrolment_created enrolment_id, student_id, study_plan_id, validity access_provisioning

Ato 2 — Onboarding e Primeiro Acesso

Onboarding

Após a Matrícula, o Aluno precisa passar pelo Onboarding antes de acessar o estudo. O Onboarding tem duas camadas:

Onboarding Geral — compartilhado entre todos os Curso-Produto de um mesmo item comercial. Inclui:

  • Questionário de Perfil — perguntas iniciais sobre carreira pretendida, histórico de preparação e dificuldades percebidas
  • Disponibilidade Semanal de Estudo — horas semanais declaradas pelo Aluno, usada como entrada para a Carga Horária de Referência em Módulos Dinâmicos

Complemento de Onboarding do Curso-Produto — etapa adicional quando o Curso-Produto exige informações ou validações próprias. Nem todo Produto exige esse complemento — depende do Modo de Acesso Comercial.

Primeiro Acesso

O Primeiro Acesso é o evento que marca o início efetivo do estudo. Ocorre quando o Aluno conclui o Onboarding aplicável e acessa o ambiente de estudos pela primeira vez.

No Primeiro Acesso:

  1. O sistema vincula a Matrícula à Versão do Plano de Estudo vigente naquele momento.
  2. O Plano do Aluno é criado — instância individual que herda a Sequência do Plano de Estudo.
  3. O Plano do Aluno é congelado permanentemente — não recebe mudanças retroativas da Trilha.
  4. O Motor de Execução do Estudo assume a condução do percurso individual.

Janela de vinculação

Antes do Primeiro Acesso, a Matrícula ainda pode receber a versão mais recente do Plano de Estudo (caso a Trilha seja republicada). Depois do Primeiro Acesso, o Aluno fica vinculado à versão que existia naquele momento, mesmo que novas publicações aconteçam.

Ciclo do Aluno

O Ciclo do Aluno organiza a progressão lógica do percurso individual:

Matrícula → Onboarding → Primeiro Acesso → Plano do Aluno → Conclusão
Etapa O que acontece Marco
Matrícula Vínculo pedagógico criado enrolment_created
Onboarding Perfil + disponibilidade + validações Conclusão do onboarding
Primeiro Acesso Plano do Aluno nasce, congelado student_plan_created
Execução Blocos, Atividades, progresso Motor de Execução (Passo 7)
Conclusão Critério pedagógico satisfeito student_plan_concluded

O ciclo tem duas medidas em dias: a Duração do Ciclo do Aluno (Vigência de Acesso da Matrícula) e os Dias de Preparação (do Primeiro Acesso à Conclusão do Plano do Aluno). A regra de contagem está em Retrospectiva — dias do ciclo.

Entidades envolvidas

Entidade Tipo Subdomain Papel
student role engine.onboarding O Aluno — usuário que consome o Plano
general_onboarding process engine.onboarding Onboarding compartilhado
course_product_onboarding_complement process engine.onboarding Complemento específico por Curso-Produto
profile_questionnaire entity engine.onboarding Questionário de Perfil
weekly_availability rule engine.onboarding Disponibilidade Semanal de Estudo
workload_reference rule engine.access Carga Horária de Referência
first_access event engine.onboarding Trigger do Plano do Aluno
student_plan process engine.plan Instância individual do estudo
student_cycle process engine.onboarding Ciclo completo: Matrícula → Conclusão

Signals emitidos neste ato

Signal Payload Emitido por
onboarding_completed student_id, enrolment_id, weekly_hours, profile_data general_onboarding
student_plan_created student_plan_id, study_plan_id, version, enrolment_id first_access

Ato 3 — Vigência, renovação e revogação

Vigência de Acesso

A Vigência de Acesso é a janela temporal em que a Matrícula permanece utilizável. Ela é controlada por:

  • Data de Início da Matrícula — pode coincidir ou não com a Data de Início do Produto
  • Data de Término da Matrícula — delimita o fim do período de acesso
  • Política de Disponibilidade — define como Fluxos de Estudo são liberados ao longo do tempo (imediata, relativa à Matrícula, relativa à Data Âncora)

Quando a vigência se encerra naturalmente, ocorre a Expiração de Acesso — distinta da Conclusão do Plano do Aluno (que é pedagógica, não temporal).

Renovação de Acesso

Quando o Aluno precisa continuar, a Renovação de Acesso é governada pela Política de Renovação de Acesso do Produto. Três estratégias reconhecidas:

Estratégia Efeito
Extensão da Matrícula e do Plano Prolonga vigência, mantém mesma Matrícula e Plano do Aluno
Nova Matrícula e Novo Plano Gera nova Matrícula e novo Plano do Aluno (ciclo completo)
Estratégia Configurável O Produto escolhe formalmente entre os modelos acima

Revogação de Acesso

Quando o acesso precisa ser encerrado fora da expiração natural (decisão comercial, operacional ou administrativa), a Política de Revogação de Acesso define o comportamento:

Estratégia Efeito
Consulta Preservada Uso bloqueado, mas consulta e histórico acessíveis (Modo Somente Leitura)
Histórico Interno Uso e consulta bloqueados; histórico preservado internamente
Total sem Reativação Tudo encerrado, sem possibilidade de reativação

Status da Matrícula

Status Significado
Ativa Aluno pode acessar e executar o estudo
Suspensa Acesso temporariamente bloqueado (pode ser reativado)
Inativa Acesso encerrado por expiração, revogação ou outro motivo

Entidades envolvidas

Entidade Tipo Subdomain Papel
access_validity entity_child engine.access Vigência — janela temporal
access_renewal process_domain engine.access Renovação conforme política
access_revocation event engine.access Revogação por decisão não-temporal
access_expiration state engine.access Expiração natural da vigência

Signals emitidos neste ato

Signal Payload Emitido por
access_renewed enrolment_id, strategy, new_validity access_renewal
access_revoked enrolment_id, reason, policy, effects access_revocation
access_expired enrolment_id, expiration_date Sistema (scheduler)
student_plan_concluded student_plan_id, enrolment_id, conclusion_type Motor de Execução

Modelo de dados

Entities (EAV)

# Identifier Tipo Subdomain Gera
1 enrolment entity_root engine.access model + service + DTO + repository
2 access_validity entity_child engine.access model + DTO
3 profile_questionnaire entity engine.onboarding model + DTO

Processos e eventos

# Identifier Tipo Subdomain
4 access_grant process_domain engine.access
5 access_provisioning process_domain engine.access
6 course_product_enrolment process_domain engine.access
7 general_onboarding process engine.onboarding
8 course_product_onboarding_complement process engine.onboarding
9 first_access event engine.onboarding
10 access_renewal process_domain engine.access
11 access_revocation event engine.access
12 access_expiration state engine.access
13 student_cycle process engine.onboarding

O que esta página não define


Referências

Navigation

Type to search…

↑↓ navigate↵ selectEsc close