Skip to content

REF-10-B: Mapeamento de TYPE Constants — EAV

REF-10-B: Mapeamento de TYPE Constants — EAV

ADR: ADR-10 (Persistência EAV) Status: Aceito Data: 2026-04-24

Contexto

Os TYPE constants das classes PHP definem o valor armazenado na coluna helico_items.type. Os nomes atuais usam prefixo helico_ e nomes longos. Os ADRs 50, 60, 70 e 80 estabeleceram nomes simplificados (palavra única ou AR + sufixo). Este REF especifica o mapeamento de renames a ser aplicado no código.


Renames de item_type

Aggregate Roots (palavra única)

TYPE atual (código) TYPE novo (ADR) AR Domínio Classe PHP (não renomear)
helico_learning_path trail sim product helico_learning_path
helico_study_plan plan sim product helico_study_plan
helico_enrolment enrolment sim engine helico_enrolment

Entities filhas (AR + sufixo)

TYPE atual (código) TYPE novo (ADR) Domínio Classe PHP (não renomear)
helico_learning_path_publication trail_publication product helico_learning_path_publication
helico_learning_path_validation trail_validation product helico_learning_path_validation
helico_learning_path_preview trail_preview product helico_learning_path_preview
helico_study_plan_sequence plan_sequence product helico_study_plan_sequence
helico_study_plan_version plan_version product helico_study_plan_version

Entities já alinhadas (sem mudança)

TYPE (código = ADR) Domínio Classe PHP
discipline content discipline
unit content unit
unit_content content unit_content
unit_snapshot content unit_snapshot
file_word content file_word
file_word_validation content file_word_validation
flashcards content flashcards
question_history content question_history
change_record content change_record
report_change content report_change
sync_job content sync_job
process_job content process_job
flashcard_job content flashcard_job
onboarding engine onboarding

Entities a criar (ainda sem classe PHP)

TYPE (ADR) Domínio Descrição
product product Produto Comercial
roadmap engine Plano do Aluno
study_flow engine Fluxo de Estudo
study_block engine Bloco de Estudo
stage engine Etapa
cda_cycle engine Ciclo CDA
segment engine Segmento (DI/SVD)
execution_session engine Sessão de Execução
profile_questionnaire engine Questionário de Perfil
habit_tracker engine Rastreador de Hábitos

Regras de aplicação

  1. Alterar apenas o valor de TYPE na classe PHP — não renomear arquivo nem classe
  2. Migração de dados: UPDATE helico_items SET type = 'trail' WHERE type = 'helico_learning_path' (e análogos)
  3. Migração de revisões: UPDATE helico_item_revision SET type = 'trail' WHERE type = 'helico_learning_path'
  4. Referências via ::TYPE nos services e contracts não precisam de alteração manual — acompanham a constante
  5. Aplicar em bloco junto com a migração de dados no banco

Rename de extensão

Diretório atual Novo diretório Namespace antigo Namespace novo
extensions/api/ extensions/platform/ local_helico\extensions\api local_helico\extensions\platform

Arquivos afetados: api_extension.php → platform_extension.php, controllers em controller/. Atualizar namespace e use statements em todos os arquivos do diretório.

Legacy

TYPE legado Substituído por Nota
helico_sync_disciplina_job sync_job Classe discipline_sync_job (base)
Navigation

Type to search…

↑↓ navigate↵ selectEsc close