Skip to content

Backlog — Frontend Completo: Atividades + Métricas

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 — implementar activity_handler_service_interface
  • Persistir result via result_service
  • Emit signal cda_classification_done segment=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_service com is_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étodos attach_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_controller linha 148 e study_api_controller linha 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 locked por lock_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 action por action_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 context por meta_keys discriminados — todos prefixados ctx_*
  • 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 data por 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 por result AR de F1-PR1)
  • Refactor controllers — 'result' => $result_service->find_by_slot($slot->id)?->get_score_breakdown()->to_metadata()
  • Migration: para cada slot com result JSON, criar activity_result item + breakdown VO
  • Drop slot.result meta
  • tests

F1.5-PR7 — guard tests + audit

  • grep no codebase confirma zero json_decode/encode em 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.md com 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() aceita response_kind param
  • 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_done segment=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_detail para 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..PR4

Marcos 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
Navigation

Type to search…

↑↓ navigate↵ selectEsc close