Pular para o conteúdo principal

Feature - Live, Export e Observabilidade Funcional

Objetivo

Disponibilizar visao operacional em tempo quase real, exportacoes e auditoria de uso.

Endpoints principais

  • Live:
    • /api/dhedalos/v1/live/cycles
    • /api/dhedalos/v1/live/enrollments
    • /api/dhedalos/v1/live/enrollments-stats
    • /api/dhedalos/v1/live/enrolls_by_cycle
  • Export:
    • /api/dhedalos/v1/export/users
    • /api/dhedalos/v1/export/classes
    • /api/dhedalos/v1/export/courses
    • /api/dhedalos/v1/export/enrollments
    • /api/dhedalos/v1/export/activities
    • /api/dhedalos/v1/export/enrollment-stats
    • /api/dhedalos/v1/export/cycles-stats
  • Logs:
    • /api/dhedalos/v1/logs
    • /api/dhedalos/v1/participant-mode-log
    • /api/dhedalos/v1/system-logs
    • /api/dhedalos/v1/system-logs/stats

Entidades e tabelas

  • dynamic_logs, user_log_action, sub_log_action, pt_mode_logs, cancellation_logs, ciclos_logs.
  • tabelas customizadas: wp_simplybook_api_requests_log, wp_user_patch_log, wp_user_logs.

Regras de acesso

  • Live e parte de export: token de servico.
  • Export administrativo: current_user_can('manage_options').
  • Logs de acao: sessao WordPress.

Comportamentos relevantes

  • endpoints live usam cache curto para aliviar carga.
  • system-logs suporta filtros, busca, ordenacao e paginacao.
  • export de classes/usuarios/matriculas usa consultas extensas de dominio.

Retencao de dados

  • logs de acao/cancelamento/presenca: ~90 dias.
  • dynamic_logs: remove anteriores ao ano corrente.

Pendencias

  • Definir limites formais de pagina/carga para endpoints de export e live.