SUAP/AVA Suite

🎯 Ecossistema Open Source de Integração SUAP ↔ Moodle

A SUAP/AVA Suite é um ecossistema open-source de integração entre Sistemas de Gestão Acadêmica (SGA) — como o SUAP, SIGAA e qAcadêmico — e o Moodle LMS. Com ela, instituições de ensino eliminam o trabalho manual de sincronização de turmas, alunos e professores: tudo flui automaticamente do SGA para o AVA, com notas e frequências sincronizadas de volta.

Por que usar?

Problema comum	Como a Suite resolve
Cadastro manual de turmas e usuários no Moodle	Sincronização automática via API a partir do SGA
Login separado para o AVA	Autenticação OAuth2 com as credenciais institucionais
Alunos perdem cursos espalhados em vários Moodles	Painel unificado com todos os cursos em um só lugar

Documentação por perfil

Além do catálogo acima, a documentação tem guias dedicados a cada perfil que interage com o ecossistema:

• Visão Geral para Gestores — apresentação executiva da suíte.

• Guia do Desenvolvedor e Infraestrutura — arquitetura, setup local, variáveis de ambiente e instalação dos plugins no Moodle.

• Guia da Secretaria Acadêmica — como habilitar diários e cursos no SUAP.

• Guia do Professor (Docente) — sincronização de diários e notas.

• Dúvidas Frequentes (FAQ) — por perfil (TIC, Professores, Secretaria).

Repositórios do ecossistema

Todo repositório ativo na organização suap-ava-suite no GitHub — o que cada um faz, sua tecnologia, e onde encontrar seu código e sua documentação própria (quando publicada).

Plugins Moodle

Instalados diretamente em cada instância do Moodle integrada à Suite.

auth_suap

Autenticação OAuth2 via SUAP. Faz o login no Moodle e sincroniza dados do usuário, foto e campos de perfil customizados a cada acesso.

PHP 8.3 OAuth2

GitHub · Documentação

local_suap

Recebe as chamadas do Integrador AVA e aplica no Moodle: criação de categorias e cursos, matrícula de usuários e vínculo de coortes.

PHP 8.3

GitHub · Documentação

tool_sga

API HTTP de integração Moodle ↔ SGA: sincronização de categorias, cursos, usuários, coortes, matrículas e grupos, além do envio de notas de volta ao SGA.

PHP 8.3

GitHub · Documentação

tool_painelava

Integra o Moodle ao Painel AVA: API externa para recuperar os dados de cursos de um usuário organizados por tipo de curso.

PHP 8.3

GitHub · Documentação

Aplicações Django

Os middlewares e dashboards que orquestram a integração entre o SGA e as instâncias do Moodle.

Integrador AVA

Middleware que conecta o SGA ao Moodle. SUAP como padrão principal, mais um padrão genérico para SIGAA, qAcadêmico ou outros. Roteia cada solicitação para o Moodle correto via um motor de regras sobre os Ambientes cadastrados.

Django 6.0

GitHub · Documentação

Painel AVA

Dashboard unificado: cada usuário acessa, em um só lugar, todos os cursos/diários em que está inscrito nas várias instâncias do Moodle integradas à Suite.

Django 6.0

GitHub · Documentação

Bibliotecas Python

Pacotes publicados no PyPI, reutilizados pelas aplicações Django acima.

auth-ava

Modelos concretos e normalizados para autenticação e sincronização de dados do SUAP no ecossistema do AVA — usuário, múltiplos e-mails, vínculos e histórico.

PyPI Django

GitHub · Documentação · PyPI

avaintegration-metapackage

Metapacote Python 3.14 que agrega as dependências dos projetos Django 6.0 do ecossistema AVA do IFRN.

PyPI

GitHub · Documentação · PyPI

Infraestrutura

cdn-suap_ava_suite

Assets estáticos (imagens, diagramas) usados por esta documentação e pelo perfil da organização.

PHP 8.3

GitHub