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)