Skip to content

Produto e Trilha Pedagógica

Especificação técnica — como a oferta comercial se transforma em contrato pedagógico configurável

Produto e Trilha Pedagógica

O domínio product responde a uma pergunta central: como uma oferta comercial da HÉLICO se transforma em estudo organizado, publicável e reutilizável?

A resposta se desdobra em três atos. Primeiro, a oferta comercial ganha identidade pedagógica por meio de um Produto Comercial vinculado a uma Trilha Pedagógica. Depois, o Gestor Pedagógico configura a Trilha em 9 etapas sequenciais, definindo desde os parâmetros gerais até os formatos de execução das atividades. Por fim, a Trilha é validada, publicada e gera um Plano de Estudo — o artefato compilado que será consumido pelo Motor de Execução.

Esses três atos correspondem aos subdomains do product:

Subdomain Slug Escopo
Estrutura do Produto product Produto Comercial, Trilha Pedagógica, Tutoria, Templates
Trilha Pedagógica product.learning_path As 9 etapas de configuração, Blocos de Montagem, regras, validação
Comercialização product.commercial SKU, Modalidades, Ofertas, Campanhas, Pedidos, Políticas de acesso e vigência

O fluxo principal vai de product.commercial (a oferta) para product (a estrutura) e de product para product.learning_path (a configuração). O Plano de Estudo gerado pela publicação pertence ao domínio engine.


Ato 1 — A oferta vira Produto

O Produto na HÉLICO tem duas camadas distintas que convergem no Curso-Produto (Moodle):

Camada Comercial                    Camada Pedagógica
─────────────────                   ──────────────────
Produto Comercial (SKU)             Trilha Pedagógica
  ├── Modalidade                      ├── Template/Preset
  ├── Ofertas (Principal, Complementar)├── 9 etapas de configuração
  ├── Cronograma Comercial            └── Publicação → Plano de Estudo
  ├── Política de Disponibilidade
  └── Modo de Acesso
           │                              │
           └──────── Curso-Produto ────────┘
                      (Moodle)

Camada Comercial

A camada comercial (product.commercial) define o que é vendido e como o acesso é concedido. Ela não conhece pedagogia — apenas identifica a oferta, organiza o catálogo e governa o ciclo de acesso.

Produto Comercial — item comercializável identificado por SKU. Cada Produto Comercial está associado a exatamente um Curso-Produto no Moodle.

Modalidade Comercial — agrupamento de Produtos com proposta pedagógica semelhante (Curso Regular Extensivo, Reta Final, Simulados Avulsos). A Modalidade é um rótulo comercial — ela organiza o catálogo e a comunicação, mas não determina o comportamento pedagógico. Quem determina é a Trilha.

Cronograma Comercial — parâmetros temporais: Data de Início do Produto, Data de Término, Data Âncora e Política de Entrada Tardia. Só se aplica quando a Política de Disponibilidade é baseada em datas.

Política de Disponibilidade — regra que define como Fluxos de Estudo são liberados ao Aluno ao longo do tempo: relativa à Matrícula, relativa ao Início do Produto (Data Âncora) ou liberação imediata.

Modo de Acesso Comercial — define se o Curso-Produto pode ser acessado diretamente (compra do produto principal) ou apenas como complemento de outro acesso (Produto Complementar).

Campanhas de Comunicação — estrutura de comunicação vinculável a Produtos: define quando, onde e como a HÉLICO se comunica com o Aluno (Eventos de Comunicação, canais, Ofertas Complementares). As campanhas são ortogonais à Trilha — operam por Vínculo Produto-Campanha.

Curso-Produto: a ponte

O Curso-Produto é a entidade Moodle que materializa o Produto. É o ponto de convergência:

  • Do lado comercial, o Pedido (via Item do Pedido → Vinculação Item-Curso-Produto) gera a Concessão de Acesso, que cria a Inscrição no Curso-Produto e depois a Matrícula.
  • Do lado pedagógico, a Trilha Pedagógica publica um Plano de Estudo que será consumido pelos Alunos inscritos naquele Curso-Produto.

A relação é 1:1:1 — um Produto Comercial, um Curso-Produto, uma Trilha Pedagógica. Se a HÉLICO precisa de duas propostas pedagógicas distintas para a mesma oferta comercial, precisa de dois Produtos.

Camada Pedagógica

A camada pedagógica (product + product.learning_path) define como o estudo é organizado. Ela parte da Base de Conteúdo e produz um contrato pedagógico configurável.

Trilha Pedagógica — a entidade central. Transforma a Base de Conteúdo em estudo organizado, publicável e reutilizável. Cada Trilha passa por 9 etapas de configuração antes de gerar um Plano de Estudo (detalhadas no Ato 2).

Templates e Presets — para acelerar a criação da Trilha, cada Modalidade possui Templates de Configuração que pré-preenchem os Parâmetros da Trilha. Um Template opera em dois modos:

  • Preset — campos preenchidos automaticamente e bloqueados, garantindo coerência metodológica. O Gestor não pode alterar campos críticos.
  • Personalizado — campos editáveis, validados por regras de dependência entre parâmetros.

Os Presets conhecidos (13 modalidades):

Preset Modalidade Comercial Módulo CDA Rev. Geral Sim. Objetivo Sim. Escrito Tutoria Disponibilidade
Curso Regular Extensivo com Tutor CRE Dinâmico Sim Sim Fim da Etapa Opcional Sim Sem cronograma
Curso Regular Extensivo sem Tutor CRE Dinâmico Sim Sim Fim da Etapa Opcional Não Sem cronograma
Reta Final 1ª Fase — Intensivo Reta Final Dinâmico Sim Não Fim do Módulo Não Não Sem cronograma
Reta Final 1ª Fase — Express Reta Final Estático Não Não Fim do curso Não Não Por matrícula
Reta Final 2ª Fase com Tutor Reta Final Dinâmico Sim Não Não Todos os tipos Sim Sem cronograma
Reta Final 2ª Fase sem Tutor Reta Final Dinâmico Sim Não Não Todos os tipos Não Sem cronograma
Reta Final 2ª Fase Peças com Tutor Reta Final Estático Não Não Não Peça Prática Sim Por Data Âncora
Reta Final 2ª Fase Peças sem Tutor Reta Final Estático Não Não Não Peça Prática Não Por Data Âncora
Curso Regular de Peças Práticas Curso Regular Estático Não Não Não Peça Prática Não Por matrícula
Curso Regular de 2ª Fase Curso Regular Estático Não Não Não Todos os tipos Não Por matrícula
Simulados VF (avulso) Simulados Avulsos Estático Não Não Não Não Não Por matrícula
Simulados Objetivos (avulso) Simulados Avulsos Estático Não Não Não Não Não Por matrícula
Simulados Flashcards (avulso) Simulados Avulsos Estático Não Não Não Não Não Por matrícula

Regras de Disponibilidade por preset

Os presets definem implicitamente a Política de Disponibilidade — como os Módulos são liberados no tempo:

Política Comportamento Presets que usam
Sem cronograma Sem trava temporal — Aluno avança por conclusão CRE, Reta Final Intensivo, Reta Final 2ª Fase (Dinâmico)
Por matrícula Módulos liberados semanalmente a partir da data de inscrição do Aluno. Mesmo concluindo, aguarda a semana seguinte Express, Curso Regular Peças, Curso Regular 2ª Fase, Avulsos
Por Data Âncora (Início do Produto) Módulos liberados semanalmente a partir da Data de Início do Produto, independente da data de inscrição do Aluno. Se Matrícula Tardia, Módulos já liberados ficam acumulados Reta Final 2ª Fase Peças, Cursos vinculados a edital

Presets e locked_fields

Quando o Gestor seleciona um Preset, os campos que definem a identidade da modalidade ficam bloqueados (locked_fields). O Gestor não pode, por exemplo, habilitar Revisão Geral em um preset de Reta Final.

No modo Personalizado, todos os campos ficam editáveis e passam por validações de dependência — ex: regra_janela_deslizante só faz sentido se revisao_geral_habilitada = true (decisão B-02).

As seções editáveis em todos os presets (inclusive não-Personalizado): parametros_comerciais, disciplinas_unidades, montagem_fluxo, configuracao_unidades e validacao.

Tutoria — Recurso Opcional habilitado por Produto. Quando ativa, pode incluir acompanhamento de progresso, análise de métricas, correção de Simulados Escritos e devolutivas pedagógicas. O desempenho do Tutor é acompanhado por Avaliação do Tutor com periodicidade configurável (ver Métricas e Classificação).

Entidades envolvidas

Entidade Tipo Subdomain Camada Papel
commercial_product entity_root product.commercial Comercial Item comercializável — SKU, Modalidade, Ofertas
order entity_root product.commercial Comercial Registro de compra — origina concessão de acesso
order_item entity_child product.commercial Comercial Linha do Pedido — vincula SKU a Curso-Produto
learning_path entity_root product Pedagógica Contrato pedagógico — a Trilha
configuration_template entity_child product Pedagógica Template/Preset que pré-preenche a Trilha

Ato 2 — A Trilha é configurada

Sequência canônica

A criação da Trilha segue 9 etapas sequenciais. Cada etapa depende das definições feitas antes dela e não pode reabrir o que já foi fechado pela etapa anterior.

1. Parâmetros da Trilha
2. Montagem dos Fluxos
3. Configuração das Disciplinas
4. Montagem dos Módulos
5. Configuração das Unidades
6. Configuração das Atividades
7. Validação da Trilha
8. Pré-visualização da Trilha
9. Publicação da Trilha

Etapa 1 — Parâmetros da Trilha

O Gestor Pedagógico define os parâmetros gerais: Tipo de Módulo (Dinâmico/Estático), habilitação do CDA, Classificação de Nível, regras de revisão, tipos de simulado, Política de Disponibilidade, regras de progressão, Recursos Opcionais (Tutoria, Biblioteca Online) e critérios de seleção de questões.

Se o Gestor partiu de um Preset, vários campos já estão preenchidos e bloqueados. No modo Personalizado, o sistema valida regras de dependência (ex: SEQUENCIA_SEM_CDA força cda_habilitado = false, di_habilitado = false, svd_habilitado = false, dispensa_habilitada = false).

Etapa 2 — Montagem dos Fluxos

A Montagem dos Fluxos define a arquitetura macro do estudo: quais Fluxos de Estudo existirão, em que ordem os Blocos de Estudo aparecerão e quais Atividades-base serão admissíveis em cada bloco.

Nesta etapa, o conteúdo concreto (Disciplinas, Unidades) ainda não entrou. A decisão é puramente estrutural.

Exemplo no CRE: fluxo principal com Bloco CDA, Bloco de Simulado Escrito e Bloco de Revisão do Módulo; ao final de cada Etapa (4 módulos), Fluxo Revisional com Bloco de Revisão Geral e Bloco de Simulado Objetivo.

Etapa 3 — Configuração das Disciplinas

O Gestor seleciona as Disciplinas da Base de Conteúdo que farão parte do Produto e as Unidades de cada Disciplina que entrarão no escopo da Trilha.

Etapa 4 — Montagem dos Módulos

A Montagem dos Módulos distribui o conteúdo selecionado na estrutura já definida pela Montagem dos Fluxos. O Gestor usa Blocos de Montagem — agrupamentos fixos de Disciplinas e quantidades de Unidades, geralmente correspondendo a uma semana de estudo. Ao montar cada Bloco, somente Disciplinas com Unidades ainda disponíveis (não atribuídas em outros Blocos) podem ser selecionadas, e a quantidade de Unidades por Disciplina é limitada ao saldo restante.

Repetição = clonagem estrutural

Quando o Gestor configura repetição na montagem, o sistema clona apenas o esqueleto estrutural (quantidade de blocos e disciplinas) para ser preenchido. Não duplica as Unidades em si.

Quando o Produto usa Módulo Dinâmico, o Bloco de Montagem continua sendo a referência estrutural, mas a entrega ao Aluno varia conforme a Disponibilidade Semanal de Estudo e a Carga Horária de Referência da Matrícula.

Etapa 5 — Configuração das Unidades

As Unidades já distribuídas são configuradas para uso pedagógico: seleção de Materiais Didáticos (Tópicos, questões VF, Objetivas, Escritas), definição de Importância e Incidência (Critério de Unidade) e Pré-requisitos de Unidade (Obrigatório ou Recomendado).

Etapa 6 — Configuração das Atividades

A última etapa de definição pedagógica. Fecha o contrato das Atividades e Avaliações admitidas pela Montagem dos Fluxos: quais estão habilitadas, com quais condições, efeitos e Formatos de Execução da Atividade.

Etapa 7 — Validação da Trilha

Verifica a consistência final entre Materiais Didáticos, Fluxos, Blocos, Módulos e Atividades. O resultado é apresentado em três categorias: erros (bloqueantes), alertas (recomendações) e checks de sucesso (confirmações). Entre os alertas padrão: Disciplinas com menos de 10 itens por tipo de questão (VF, Objetiva, Flashcard) geram aviso de quantidade mínima — Simulados Escritos são isentos dessa regra.

Etapa 8 — Pré-visualização da Trilha

Revisão final sem edição direta. O Gestor vê uma lista única e sequencial de Unidades na ordem em que serão aplicadas pelo Plano de Estudo — sem agrupamentos por Disciplina, repetição ou Bloco de Montagem. Inclui resumo das configurações, métricas de distribuição e alertas de desequilíbrio. Se algo estiver errado, retorna à etapa adequada.

Etapa 9 — Publicação da Trilha

Publica a Trilha e gera um novo Plano de Estudo. O Motor de Compilação Pedagógica consolida a estrutura vigente e produz o artefato compilado — a Sequência do Plano de Estudo.

Processos da Trilha

Identifier Tipo Subdomain Papel
trail_parameters rule product.learning_path Parâmetros gerais — regras e comportamentos
flow_assembly process_domain product.learning_path Arquitetura macro dos Fluxos e Blocos
discipline_configuration process_domain product.learning_path Seleção de Disciplinas e Unidades
module_assembly process_domain product.learning_path Distribuição de conteúdo nos Módulos
unit_configuration process_domain product.learning_path Configuração pedagógica por Unidade
activity_configuration process_domain product.learning_path Contrato final de Atividades e Formatos
trail_validation process_domain product.learning_path Verificação de consistência
trail_preview process_domain product.learning_path Revisão final sem edição
trail_publication process_domain product.learning_path Publicação e geração do Plano de Estudo

Ato 3 — O Plano de Estudo nasce e a Trilha trava

Publicação e Plano de Estudo

Quando a Trilha é publicada, o Motor de Compilação Pedagógica consolida toda a configuração e gera um Plano de Estudo. Esse artefato compilado contém:

  • Configurações do Plano de Estudo — parâmetros herdados da Trilha
  • Sequência do Plano de Estudo — a ordem resolvida de Fluxos, Blocos, Módulos e Atividades

Antes da primeira Matrícula, a Trilha pode ser republicada livremente — cada publicação substitui o Plano de Estudo anterior.

Travamento Estrutural

Após a primeira Matrícula vinculada ao Produto, entra em vigor o Travamento Estrutural da Trilha:

Etapa da Trilha Antes da 1ª Matrícula Depois da 1ª Matrícula
Montagem dos Fluxos Livre Bloqueada
Configuração das Disciplinas Livre Bloqueada
Montagem dos Módulos Livre Permitida
Configuração das Unidades Livre Permitida
Configuração das Atividades Livre Permitida

Ajustes permitidos exigem nova Publicação da Trilha e afetam apenas:

  • novas Matrículas;
  • Matrículas já existentes que ainda não tiveram Primeiro Acesso.

Planos do Aluno já criados permanecem estáveis.

Mudança estrutural profunda exige novo Produto

Se a necessidade for redefinir a Montagem dos Fluxos ou trocar o escopo de Disciplinas, o caminho correto é criar um novo Produto e iniciar nova configuração pedagógica.

Status da Trilha Pedagógica

Status Gatilho Permissões
Rascunho Criação Toda configuração editável
Publicada Publicação da Trilha Editável até a 1ª Matrícula
Travada 1ª Matrícula Só ajustes permitidos (Módulos, Unidades, Atividades)
Descontinuada Descontinuação do Produto Nenhuma edição; Planos existentes seguem em execução

Ciclo de vida completo

Produto Comercial (SKU + Modalidade)
  └── Trilha Pedagógica (Template/Preset ou Personalizado)
        ├── Parâmetros da Trilha
        ├── Montagem dos Fluxos (arquitetura)
        ├── Config. das Disciplinas (escopo)
        ├── Montagem dos Módulos (distribuição)
        ├── Config. das Unidades (materiais + critérios)
        ├── Config. das Atividades (contrato final)
        ├── Validação → Pré-visualização → Publicação
        │     └── → Plano de Estudo (compilado)
        └── Travamento Estrutural (após 1ª Matrícula)

Modelo de dados

Entities (EAV)

# Identifier Tipo Subdomain Gera
1 commercial_product entity_root product.commercial model + service + DTO + repository
2 learning_path entity_root product model + service + DTO + repository
3 order entity_root product.commercial model + service + DTO + repository
4 configuration_template entity_child product model + DTO
5 order_item entity_child product.commercial model + DTO
6 sku entity_child product.commercial model + DTO

Conceitos e regras

# Identifier Tipo Subdomain
7 pedagogical_config concept product
8 trail_parameters rule product.learning_path
9 flow_assembly process_domain product.learning_path
10 discipline_configuration process_domain product.learning_path
11 module_assembly process_domain product.learning_path
12 unit_configuration process_domain product.learning_path
13 activity_configuration process_domain product.learning_path
14 trail_validation process_domain product.learning_path
15 trail_preview process_domain product.learning_path
16 trail_publication process_domain product.learning_path
17 trail_structural_lock rule product.learning_path
18 product_preset rule product
19 module_type rule product.learning_path
20 assembly_block concept product.learning_path
21 unit_criterion entity/rule product.learning_path
22 unit_prerequisite rule product.learning_path
23 availability_policy rule product.commercial
24 commercial_modality concept product.commercial

Signals emitidos

Signal Payload Emitido por Listeners
learning_path_published learning_path_id, product_id, study_plan_id, version trail_publication Motor de Compilação, Notificação
learning_path_locked learning_path_id, product_id, enrolment_id enrolment (1ª) Travamento Estrutural
learning_path_discontinued learning_path_id, product_id Gestão do Produto Catálogo, Matrículas

O que esta página não define


Referências

Navigation

Type to search…

↑↓ navigate↵ selectEsc close