tool_sga

tool_sga (Integrador SGA) é um plugin de administração (admin/tool) para o Moodle que expõe uma API HTTP usada pelo SGA (Sistema de Gestão Acadêmica) para manter o Moodle sincronizado: cria e atualiza categorias, cursos, turmas, usuários, coortes, métodos de inscrição e matrículas a partir de um payload JSON enviado pelo SGA, e devolve notas lançadas no Moodle para o SGA sob demanda. O plugin também cria dezenas de campos de perfil customizados (curso e usuário) usados por outros componentes da suíte AVA/SUAP do IFRN.

Conteúdo

• Visão geral
  • O que o plugin faz
  • Autenticação da API
  • Requisitos
  • Estrutura do repositório
  • Organização
• Instalação
  • 1. Configuração no Moodle
  • 2. Testando o token
  • 3. Enviando uma sincronização
• Sincronização de envio (SGA → Moodle)
  • Visão geral do fluxo
  • Possível problema de inicialização do endpoint
  • Dois pontos de entrada distintos
  • Formato do payload
  • Validação do JSON
  • Restrições e tratamento de erro por item
  • Restauração de modelo de curso (template_path)
  • Registro para suporte/auditoria
• Sincronização de notas (Moodle → SGA)
  • Endpoint
  • Consulta
  • Resposta
  • Tratamento de erro
• Campos customizados
  • Campos de curso
  • Campos de usuário
  • Tabelas de dados
• Painel administrativo
  • Acesso
  • Listagem (index.php)
  • Detalhe (view.php)
  • Templates
• Desenvolvimento
  • Versionamento
  • Tipos de commit
  • CI/CD
  • Documentação
  • Observações consolidadas para quem for mexer no código