Pular para o conteúdo principal

Feature - Inscricao e Matricula

Objetivo​

Registrar participante, validar elegibilidade e efetivar matricula em turma/ciclo disponivel.

Endpoints principais​

  • Cadastro:
    • /api/dhedalos/v1/registration/people (POST)
    • /api/dhedalos/v1/registration/people/{cpf} (GET)
    • /api/dhedalos/v1/registration/people/phone/{phone} (GET)
    • /api/dhedalos/v1/registration/people/{id} (PUT/PATCH)
  • Inscricao:
    • /api/dhedalos/v1/enroll/{slug}/status (GET)
    • /api/dhedalos/v1/enroll/{slug}/meta (POST)
    • /api/dhedalos/v1/enroll/{slug} (POST)
    • /api/dhedalos/v1/course/enrolled/{slug}/{user_id} (GET)
  • Grupo e cancelamento:
    • /api/dhedalos/v1/group/{uid} (GET)
    • /api/dhedalos/v1/group/recall_group_link (GET)
    • /api/dhedalos/v1/enroll/cancel/{enrollment_id} (POST)
    • /api/dhedalos/v1/enroll/{enroll_id} (DELETE condicional por ambiente)

Entidades envolvidas​

  • wp_users/wp_usermeta (dados pessoais/empresa)
  • students (matricula)
  • classes, ciclo, curso
  • partners (codigo ALI)

Regras de negocio observadas​

  • validacao de CPF/telefone duplicado no cadastro,
  • identificacao de ciclo/turma disponivel por curso e turno,
  • lock de inscricao por usuario via transient,
  • suporte a realocacao e rematricula,
  • atualizacao de contador de matriculas da turma,
  • marca de acesso ao grupo e trilha de cancelamento.

Integracoes relacionadas​

  • Novu (onboarding, cancelamento, notificacoes PCD)
  • API de submissions (limpeza de arquivos por ciclo em automacao)

Logs associados​

  • user_patch_log em updates de cadastro
  • user_log_action para acoes no grupo
  • cancellation_logs para cancelamentos

Pendencias​

  • Consolidar contrato de erros de negocio em um schema versionado (mensagens variam por fluxo).