Pular para o conteúdo principal

Feature: Atividades Estrategicas

Visao geral

Feature de curso (enable_strategic_activities) que habilita configuracao de quantidade de atividades estrategicas por ciclo (strategic_activities_num) e publica esse dado nos endpoints de turmas.

Atores

  • Administrador/supervisor (configura curso e ciclo).
  • Facilitador/participante (consomem dado da turma).

Pre-condicoes

  • Curso com enable_strategic_activities ligado (we-dhedalos/functions/acfs/group_663b721c7c208.php:125-144).
  • Ciclo vinculado ao curso (fk_courses_cycles) para liberar o campo de numero. Fonte: we-dhedalos/functions/utils/prepare_field_atividades_estategicas.php:10-20.

Fluxo principal

  1. Admin ativa enable_strategic_activities no curso.
  2. No ciclo, o campo strategic_activities_num fica disponivel (prepare_field do ACF).
  3. Endpoints de turmas retornam:
    • enable_strategic_activities
    • strategic_activities_number (numero do ciclo quando habilitado) Fonte: we-dhedalos/functions/rest/classes.php:1391-1395 e we-dhedalos/functions/rest/classes.php:1523-1527.

Fluxos alternativos

  • Se o post nao for ciclo, o campo e ocultado (prepare_field retorna false). Fonte: we-dhedalos/functions/utils/prepare_field_atividades_estategicas.php:6-8.
  • Se o curso nao estiver habilitado, o campo do ciclo nao aparece. Fonte: we-dhedalos/functions/utils/prepare_field_atividades_estategicas.php:16-21.

Regras de negocio

  • strategic_activities_num possui min=0 e max=20. Fonte: we-dhedalos/functions/acfs/group_65d89840aae50.php:163-180.
  • Valor de saida strategic_activities_number so e preenchido quando a feature esta ativa no curso e ha valor no ciclo. Fonte: we-dhedalos/functions/rest/classes.php:1391-1395 e we-dhedalos/functions/rest/classes.php:1524-1527.

Estados possiveis

  • enable_strategic_activities: 0|1 no curso.
  • strategic_activities_num: inteiro 0..20 no ciclo.
  • strategic_activities_number no payload: 0 quando inativo/ausente.

Endpoints envolvidos

  • OpenAPI GET /dhedalos/v1/classes/supervisor
  • OpenAPI GET /dhedalos/v1/classes/facilitator
  • OpenAPI GET /dhedalos/v1/classes/subscriber

Tabelas/CPTs afetados

  • model.md curso (meta enable_strategic_activities)
  • model.md ciclo (meta strategic_activities_num)
  • model.md classes (consumo indireto via payload consolidado)

Pendencias/duvidas

  • Nao foi identificado endpoint dedicado para registrar/avaliar atividades estrategicas; o backend exposto aqui foca em configuracao e distribuicao de metadados.