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 TrilhaEtapa 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
- Como o Plano de Estudo vira Plano do Aluno → Compilação e Plano de Estudo (Passo 5)
- Como Matrícula, Vigência e Onboarding funcionam → Aluno e Matrícula (Passo 6)
- Como os Blocos e Fluxos são executados em runtime → Motor de Execução (Passo 7)
- Detalhes de cada tipo de Atividade → Atividades (Passo 8)
Referências
- Trilha Pedagógica (Metodologia) — fundamentos conceituais
- Produtos e Modalidades (Metodologia) — catálogo de presets e modalidades
- Terms: product — vocabulário canônico do domínio product
- Terms: product.learning_path — vocabulário da Trilha
- Terms: product.commercial — vocabulário comercial
- JSON Schema: config_json — schema de configuração da Trilha