Skip to content

Quality Review — Terms Catalog (2026-04-07)

Quality Review — Terms Catalog (2026-04-07)

Resumo

358 termos analisados, 81 issues identificadas. 4 bloqueantes para geracao PHP.

Status por arquivo

Arquivo Termos Materializaveis Issues
terms.yaml (sem dominio) 148 45 58
terms-conteudo.yaml 22 5 0
terms-atividades.yaml 34 11 8
terms-metricas.yaml 26 2 0
terms-motor-pedagogico.yaml 46 16 13
terms-produto-comercial.yaml 56 10 1
terms-produto-trilha.yaml 10 1 10

Dominios limpos: conteudo, metricas.

BLOQUEANTE: 4 identifiers ausentes

Termo Dominio Identifier sugerido
Conclusao do Plano do Aluno motor-pedagogico student_plan_conclusion
Expiracao de Acesso motor-pedagogico access_expiration
Modo de Edicao da Configuracao produto.trilha configuration_edit_mode
Status do Pedido produto.comercial order_status

BLOQUEANTE: Trilha Pedagogica sem dominio

“Trilha Pedagogica” (entity_root, identifier: learning_path) esta em terms.yaml sem dominio. 10 termos de produto.trilha a referenciam como parent. Acao: mover para terms-produto.yaml (novo arquivo) ou terms.yaml com domain: produto.

ALTO: 28 referencias parent cross-domain

Termos cujo parent esta em outro arquivo/dominio. Exemplos:

atividades → produto.trilha: Criterio de Feedback do Questionario, Criterio de Selecao de Questoes, Formato de Execucao da Atividade, Regra de Conclusao, Regra de Opcionalidade da Atividade (parent: Configuracao das Atividades)

atividades → motor-pedagogico: Diagnostico Inicial (DI), Simulado de Verificacao de Desempenho (parent: Ciclo Diagnostico Adaptativo)

motor-pedagogico → produto.trilha: Bloco de Montagem (parent: Montagem dos Modulos), Regra de Disponibilidade, Regra de Progressao, Tipo de Modulo (parent: Configuracao das Atividades/Montagem dos Modulos)

motor-pedagogico → produto: Concessao de Acesso, Evento de Sincronizacao Comercial, Inscricao no Curso-Produto, Provisionamento de Acesso (parent: Ciclo de Acesso)

Decisao necessaria: referencias cross-domain sao validas (representam dependencias reais entre bounded contexts) ou indicam termos no dominio errado?

ALTO: 45 materializaveis sem dominio

Em terms.yaml, 45 termos materializaveis precisam de dominio:

  • 4 roles (Aluno, Conteudista, Gestor Pedagogico, Tutor)
  • 9 screens (Area do Aluno, Biblioteca Online, Caderno Online, Comunidade, etc.)
  • 11 execution_components (Bloco CDA, Fluxo Completo, Segmento, etc.)
  • 19 entities (Atividade, Avaliacao do Tutor, Criterio de Unidade, Doutrina, etc.)
  • 2 concept+execution_component (Pratica com Flashcards)

Sugestoes de dominio:

  • Roles → motor-pedagogico (Aluno, Tutor, Gestor) ou conteudo (Conteudista)
  • Screens → api (sao interfaces da plataforma NextJS)
  • Execution components → motor-pedagogico (componentes do motor de execucao)
  • Entities → varios (ver detalhes na revisao completa)

MEDIO: 14 states/attributes orfaos

States cujo parent nao e entity (sao filhos de process ou execution_component):

  • Conclusao do Plano do Aluno → parent: Plano do Aluno (nao e entity no terms.yaml)
  • Status do Plano do Aluno → parent: Plano do Aluno
  • Status da Sessao de Flashcards → parent: Sessao de Flashcards (process)
  • Status da Submissao do Simulado Escrito → parent: Submissao de Simulado Escrito (process)
  • Status do Questionario → parent: Sessao de Questionario (process)
  • Status do Bloco de Estudo → parent: Bloco de Estudo (execution_component)
  • Status do Fluxo de Estudo → parent: Fluxo de Estudo (execution_component)

Acao: reclassificar parents como entity ou criar state_groups intermediarios.

Checklist para equipe

Antes de habilitar geracao:

  • Adicionar 4 identifiers ausentes
  • Decidir dominio de Trilha Pedagogica (produto ou produto.trilha)
  • Classificar 45 materializaveis sem dominio
  • Resolver 14 states/attributes orfaos
  • Documentar quais refs cross-domain sao intencionais

Dominios prontos para geracao (0 issues):

  • metricas (testado end-to-end)
  • conteudo

Dominios que precisam de trabalho:

  • atividades (8 issues — cross-domain refs)
  • motor-pedagogico (13 issues — cross-domain refs, orphaned states)
  • produto.comercial (1 issue — identifier ausente)
  • produto.trilha (10 issues — parent Trilha Pedagogica sem dominio)
Navigation

Type to search…

↑↓ navigate↵ selectEsc close