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 AcessoEvento 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:
- O sistema vincula a Matrícula à Versão do Plano de Estudo vigente naquele momento.
- O Plano do Aluno é criado — instância individual que herda a Sequência do Plano de Estudo.
- O Plano do Aluno é congelado permanentemente — não recebe mudanças retroativas da Trilha.
- 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
- Como o Plano de Estudo é compilado a partir da Trilha → Compilação e Plano de Estudo (Passo 5)
- Como blocos, fluxos e CDA funcionam em runtime → Motor de Execução (Passo 7)
- Como o NextJS apresenta o Roteiro de Estudos ao Aluno → Entrega ao Aluno (Passo 10)
Referências
- Compilação e Plano de Estudo — como o Plano de Estudo nasce e como snapshots protegem o conteúdo (Passo 5)
- Produto e Trilha Pedagógica — como a Trilha é configurada (Passo 4)
- Execução do Aluno (Metodologia) — fundamentos conceituais do ciclo individual
- Terms: engine — vocabulário canônico (engine.access, engine.onboarding)
- Terms: product.commercial — políticas comerciais de acesso