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
- Alterar apenas o valor de
TYPEna classe PHP — não renomear arquivo nem classe - Migração de dados:
UPDATE helico_items SET type = 'trail' WHERE type = 'helico_learning_path'(e análogos) - Migração de revisões:
UPDATE helico_item_revision SET type = 'trail' WHERE type = 'helico_learning_path' - Referências via
::TYPEnos services e contracts não precisam de alteração manual — acompanham a constante - 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) |