Backlog — Frontend Completo: Atividades + Métricas
Data: 2026-05-01
Plan source: 2026-05-01-frontend-completo-atividades-metricas.md
Branch base: feature/new-contracts
Cada item = 1 PR atomico. Tasks marcadas com [ ] pending, [x] done, [~] in progress.
Convenção storage: EAV-only (helico_items + helico_itemmeta). Zero tabela dedicada nova. JSONs decompostos em VOs (flat meta_keys ou child items). Cache opaco aceitável em item.description.
FASE 0 — Cleanup
F0-PR1 — remove dead tables ✅
-
db/install.xml— remover<TABLE NAME="helico_responses"> -
db/install.xml— remover<TABLE NAME="helico_classifications"> -
db/install.xml— remover<TABLE NAME="helico_slots"> -
db/install.xml— remover<TABLE NAME="helico_sessions"> -
db/upgrade.php— adicionar drop_table_if_exists steps idempotentes -
version.php— bump (4.0.21 / 2026050100) - Smoke test: fresh install + upgrade existing (pending — needs running env)
F0-PR2 — VO convention (no formal interface)
- Decisão: zero interface formal. Convenção idiomatic — VO concreto com
to_metadata()+from_metadata(). - Documentado em plan principal seção “VO convention”.
FASE 1 — Slot handlers + result EAV
F1-PR1 — score_breakdown VO + result entity
-
classes/extensions/activity/result/vo/score_breakdown.php -
classes/extensions/activity/result/entity/result.php(EAV TYPE=‘activity_result’) -
classes/extensions/activity/result/dto/result_dto.php -
classes/extensions/activity/result/dto/activity_submit_result_dto.php -
classes/extensions/activity/result/contract/result_service_interface.php -
classes/extensions/activity/result/service/result_service.php -
classes/extensions/activity/activity_extension.php(DI registration) -
tests/activity/result/score_breakdown_test.php(VO roundtrip) -
tests/activity/result/result_service_test.php
F1-PR2 — activity_handler contract + registry + dispatcher
-
classes/extensions/engine/algorithm/contract/activity_handler_service_interface.php -
classes/extensions/engine/algorithm/service/activity_handler_registry.php - Modificar
classes/extensions/platform/controller/slot_api_controller.php— substituir if/elseif por dispatcher -
tests/engine/algorithm/activity_handler_registry_test.php
F1-PR3 — signals
-
classes/extensions/engine/algorithm/signal/activity_completed_signal.php -
classes/extensions/engine/algorithm/signal/cda_classification_done_signal.php -
classes/extensions/engine/algorithm/signal/exam_submission_pending_signal.php - Registrar em
db/events.php
F1-PR4 — diagnostic_initial refactor
- Refactor
diagnostic_initial_handler_service— implementaractivity_handler_service_interface - Persistir result via result_service
- Emit signal
cda_classification_donesegment=DI - Atualizar tests
F1-PR5 — diagnostic_verify_handler_service
-
classes/extensions/engine/algorithm/service/diagnostic_verify_handler_service.php -
classes/extensions/engine/algorithm/contract/diagnostic_verify_handler_service_interface.php - Reuse
vf_question_pool_servicecomis_di=false - Emit signal segment=SVD
-
tests/engine/algorithm/diagnostic_verify_handler_service_test.php
F1-PR6 — exam_objective_handler_service
-
classes/extensions/engine/algorithm/service/exam_objective_handler_service.php -
classes/extensions/engine/algorithm/contract/exam_objective_handler_service_interface.php - Iter responses → NR = corretas/total
-
tests/engine/algorithm/exam_objective_handler_service_test.php
F1-PR7 — exam_truefalse_handler_service
-
classes/extensions/engine/algorithm/service/exam_truefalse_handler_service.php - Similar exam_objective (avulso, sem CDA semantics)
- tests
F1-PR8 — exam_written_handler_service
-
classes/extensions/engine/algorithm/service/exam_written_handler_service.php - Persiste exam_submission EAV (Fase 2 dep — temporário usar item_service direto)
- status=
pending_correction - Sem result até correção
- tests
F1-PR9 — flashcard_practice_handler_service
-
classes/extensions/engine/algorithm/service/flashcard_practice_handler_service.php - Itera cards, persiste flashcard_response children EAV
- Sem nota
- tests
F1-PR10 — guided_study_handler_service
-
classes/extensions/engine/algorithm/service/guided_study_handler_service.php - Recebe content_html
- Stub null-safe para notebook_artifact_service (Fase 3 dep)
- tests
F1-PR11 — general_review_handler_service
-
classes/extensions/engine/algorithm/service/general_review_handler_service.php - Similar exam_objective sob escopo Janela Revisão (escopo já vem compiled)
- tests
F1-PR12 — E2E integration
-
tests/integration/slot_api_dispatcher_e2e_test.php— 7 types completos - Postman collection update — testar cada type
- Smoke test manual via curl
FASE 1.5 — Slot/Session JSON soltos → VOs tipados
Objetivo: zerar json_decode/encode solto em entities. Cada blob virá VO concreto. slot_context + session_data ficam sealed (1 VO por slot_type).
F1.5-PR1 — slot_scope_ref VO collection
-
classes/extensions/engine/algorithm/vo/slot_scope_ref.php(VO simples) -
classes/extensions/engine/algorithm/entity/slot_scope_ref.php(EAV TYPE=‘slot_scope_ref’ parent=slot) - Refactor
slot_service— métodosattach_scope_refs(slot_id, slot_scope_ref[]),find_scope_refs(slot_id) - Migration: backfill child items dos slots existentes (parse JSON antigo, criar children)
- Refactor
slot_api_controllerlinha 148 estudy_api_controllerlinha 824 — não chama mais json_decode - tests
F1.5-PR2 — slot_lock VO + lock_dependency collection
-
classes/extensions/engine/algorithm/vo/slot_lock.php(flat) -
classes/extensions/engine/algorithm/entity/lock_dependency.php(collection child) - Slot METADATA_FIELDS atualizado: substitui
lockedporlock_reason,lock_message,lock_unlock_rule,lock_unlock_at - Migration: backfill
- Refactor controllers —
'locked' => $slot->get_lock()?->to_array() - tests
F1.5-PR3 — slot_action VO
-
classes/extensions/engine/algorithm/vo/slot_action.php(flat) - Slot METADATA_FIELDS: substitui
actionporaction_type,action_label,action_route,action_params_json(último é blob curto, aceitável) - Migration backfill
- Refactor controllers
- tests
F1.5-PR4 — slot_context sealed VOs (7 subtypes)
-
vo/slot_context_diagnostic.php(DI + SVD compartilham) -
vo/slot_context_flashcard.php -
vo/slot_context_guided_study.php -
vo/slot_context_exam_objective.php -
vo/slot_context_exam_written.php -
vo/slot_context_general_review.php -
vo/slot_context_factory.php—from_slot(slot $s): slot_context_* - Slot METADATA_FIELDS: substitui
contextpor meta_keys discriminados — todos prefixadosctx_* - Migration backfill por slot_type
- Refactor controllers — todos os
json_decode($slot->get_context()) - tests cada VO
F1.5-PR5 — session_data sealed VOs
-
engine/session/vo/session_data_diagnostic.php(questionário em progresso) -
engine/session/vo/session_data_flashcard.php(deck em progresso) -
engine/session/vo/session_data_guided_study.php(rascunho de resumo) -
engine/session/vo/session_data_exam_written.php -
engine/session/vo/session_data_factory.php— discriminator por slot_type via session→slot - Session METADATA_FIELDS: substitui
datapor meta_keys discriminados - Migration backfill
- Refactor controllers — todos os
json_decode($session->get_data()) - tests
F1.5-PR6 — slot result migration → result AR
- Slot METADATA_FIELDS: remove
result(substituído porresultAR de F1-PR1) - Refactor controllers —
'result' => $result_service->find_by_slot($slot->id)?->get_score_breakdown()->to_metadata() - Migration: para cada slot com
resultJSON, criaractivity_resultitem + breakdown VO - Drop slot.result meta
- tests
F1.5-PR7 — guard tests + audit
- grep no codebase confirma zero
json_decode/encodeem entities/services (só em controllers ainda OK pra request bodies) - PR-level test: assert que slot e session entities não têm campos serializados
- Update
extensions-audit.mdcom resumo F1.5
FASE 2 — response/result AR move
F2-PR1 — move response namespace
- PHPStorm refactor:
engine\session\response*→activity\response\response* - Atualizar imports em handlers (Fase 1)
- tests passing pós-move
F2-PR2 — disambiguate response TYPEs
-
response_service::bulk_create()aceitaresponse_kindparam - TYPE=‘question_response’ (CDA, simulados objective/truefalse/written)
- TYPE=‘flashcard_response’ (flashcard_practice)
- tests
F2-PR3 — exam_submission EAV
-
classes/extensions/activity/assessment/exam_submission/entity/exam_submission.php -
classes/extensions/activity/assessment/exam_submission/service/exam_submission_service.php -
exam_written_handler(Fase 1 PR8) refactor para usar service - tests
FASE 3 — notebook_artifact + reforço
F3-PR1 — notebook_artifact entity + service
-
classes/extensions/activity/productive/notebook_artifact/entity/notebook_artifact.php -
classes/extensions/activity/productive/notebook_artifact/dto/notebook_artifact_dto.php -
classes/extensions/activity/productive/notebook_artifact/contract/notebook_artifact_service_interface.php -
classes/extensions/activity/productive/notebook_artifact/service/notebook_artifact_service.php - tests
F3-PR2 — artifact_versioning EAV
-
classes/extensions/activity/productive/artifact_versioning/entity/artifact_version.php(parent=artifact) -
classes/extensions/activity/productive/artifact_versioning/service/artifact_versioning_service.php - ADR-11 imutabilidade testada
- tests
F3-PR3 — guided_study + reforço cenários
- Refactor
guided_study_handler_service(Fase 1 PR10) — chama notebook_artifact_service - Cenário 1 DI Básico: substitution opt-in
- Cenário 2 DI Inter: no-op
- Cenário 3 DI Avançado: cria artifact source=leitura primeira exibição
- tests integration 3 cenários
F3-PR4 — notebook_api real
- Modificar
classes/extensions/platform/controller/notebook_api_controller.php -
notebook()→ service real -
notebook_detail()→ service real - Regra A-09 (excluir bloco atual) implementada + testada
- tests integration
FASE 4 — metrics fundação
F4-PR1 — move classification engine→metrics
- Mover
engine/algorithm/{entity,service,contract}/classification*→metrics/classification/ - PHPStorm rename namespace
- Atualizar consumidores
- tests passing pós-move
F4-PR2 — metrics_extension
-
classes/extensions/metrics/metrics_extension.php - DI registration
F4-PR3 — report EAV
-
classes/extensions/metrics/report/entity/report.php(TYPE=‘metrics_report’) -
classes/extensions/metrics/report/contract/report_service_interface.php -
classes/extensions/metrics/report/service/report_service.php - idnumber idempotency:
report:{enrolment_id}:{scope}:{target_id} - tests
F4-PR4 — process services
-
classes/extensions/metrics/level_classification/service/level_classification_service.php -
classes/extensions/metrics/level_reclassification/service/level_reclassification_service.php -
classes/extensions/metrics/relevance_bonus/service/relevance_bonus_calculator.php -
classes/extensions/metrics/progress_rebalancing/service/progress_rebalancing_service.php - tests cada um
F4-PR5 — SVD reclass listener
-
classes/extensions/metrics/level_reclassification/listener/cda_classification_listener.php - Subscribe
cda_classification_donesegment=SVD - Calcula média DI+SVD → cria classification combined
- tests integration
FASE 5 — consolidação real
F5-PR1 — calculators
-
classes/extensions/metrics/consolidation/contract/dimension_calculator_interface.php -
classes/extensions/metrics/consolidation/service/unit_performance_calculator.php -
classes/extensions/metrics/consolidation/service/discipline_performance_calculator.php -
classes/extensions/metrics/consolidation/service/module_performance_calculator.php -
classes/extensions/metrics/consolidation/service/overall_performance_calculator.php - tests cada um
F5-PR2 — consolidation_engine_service + DTOs
-
classes/extensions/metrics/consolidation/contract/consolidation_engine_service_interface.php -
classes/extensions/metrics/consolidation/service/consolidation_engine_service.php -
classes/extensions/metrics/consolidation/dto/consolidated_dashboard_dto.php -
classes/extensions/metrics/consolidation/dto/trend_dto.php - Lazy + invalidation strategy
- tests
F5-PR3 — invalidation listener
-
classes/extensions/metrics/consolidation/listener/activity_completed_listener.php - Marca affected reports invalidated_at
- tests integration
F5-PR4 — performance_api real
- Modificar
performance_api_controller::performance()— substituir mock - tests E2E
- Validar dashboard reflete responses (DI submit → /performance score atualizado)
FASE 6 — review_window + objective_priority
F6-PR1 — review_window EAV
-
classes/extensions/engine/plan/review_window/entity/review_window.php -
classes/extensions/engine/plan/review_window/entity/review_window_module.php(child VO) -
classes/extensions/engine/plan/review_window/enums/review_window_phase.php -
classes/extensions/engine/plan/review_window/service/review_window_service.php - tests 15 cases (RG1..RG10)
F6-PR2 — objective_priority service
-
classes/extensions/engine/algorithm/objective_priority/service/objective_priority_service.php - 6 regras (Critério Priorização ADR-60/70)
- tests
F6-PR3 — compilation usa priority
- Modificar
compilation_engine_service— usa review_window + objective_priority ao gerar slots RG - tests integration CDA→RG full cycle
FASE 7 — tutor correction loop
F7-PR1 — exam_correction + criterion_score VO collection
-
classes/extensions/activity/assessment/exam_correction/entity/exam_correction.php -
classes/extensions/activity/assessment/exam_correction/entity/criterion_score.php(child) -
classes/extensions/activity/assessment/exam_correction/service/exam_correction_service.php - tests
F7-PR2 — admin endpoint
-
classes/extensions/admin/controller/exam_correction_admin_controller.php - POST /admin/corrections/{submission_id}
- GET /admin/corrections/pending
- tests
F7-PR3 — exam_corrected listener
-
classes/extensions/activity/assessment/exam_correction/listener/exam_corrected_to_result_listener.php - Cria result retroativo + emit activity_completed
- tests integration
F7-PR4 — exam_feedback service + api update
-
classes/extensions/activity/assessment/exam_feedback/service/exam_feedback_service.php - Modificar
exam_api_controller::exam_detailpara incluir feedback - tests
FASE 8 — platform orchestration services
F8-PR1..PR10 — 10 view services (1 PR cada)
- student_area_service
- study_roadmap_service (extrair lógica de study_api_controller::study_guide)
- flashcard_view_service
- review_view_service
- diagnostic_view_service
- performance_view_service (wrapper consolidation_engine)
- exam_view_service
- library_view_service
- notebook_view_service
- profile_view_service
Cada PR: service + interface + dto + tests + refactor controller correspondente.
FASE 9 — activity FLAT_LEGACY → DDD
F9-PR1 — exam_objective entity
- Migrar
activity/objective_questionnaire/objective_questionnaire.php→activity/assessment/exam_objective/ - entity + dto + service + contract
- PHPStorm refactor consumers
- Deletar arquivo legacy
- tests
F9-PR2 — exam_truefalse entity
- Migrar
activity/vf_questionnaire/vf_questionnaire.php→activity/assessment/exam_truefalse/ - Idem PR1
F9-PR3 — exam_written entity
- Migrar
activity/written_questionnaire/written_questionnaire.php→activity/assessment/exam_written/ - Idem PR1
F9-PR4 — exam_template (gabarito)
- Migrar
activity/mock_assessment/mock_assessment_config.php→activity/assessment/exam_template/ - Idem PR1
F9-PR5 — ddd-config + LinkML materialize
- Atualizar
.vigim/ddd/ddd-config.yaml(remover prefixo_, adicionar activity.practice) - Run
composer build:extensions(MIDDAG CLI) - Materializar 16 LinkML stubs faltantes (12 assessment + 1 formative + 2 productive + 1 activity)
- tests build_extensions sem warnings
F9-PR6 — extensions-audit rerun
- Rerun audit script
- Verificar P0-1 = ✅
- FLAT_LEGACY count = 0
- Atualizar
.vigim/ddd/reports/extensions-audit.md
Métricas de progresso
Total PRs: ~50 (F1=12, F2=3, F3=4, F4=5, F5=4, F6=3, F7=4, F8=10, F9=6 + F0=2 + ajustes)
Caminho crítico: F0 → F1-PR1..PR12 → F2-PR1..PR3 → F4-PR1..PR5 → F5-PR1..PR4Marcos visíveis:
- ✅ F1 done → qualquer atividade submete
- ✅ F3 done → Caderno Online operacional
- ✅ F5 done → métricas reais sem mock
- ✅ F6 done → CDA fechado
- ✅ F7 done → escrita corrigida visível
- ✅ F9 done → zero código PT-BR