Visão Geral da SUAP/AVA Suite

O que é a SUAP/AVA Suite?

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.

Visão arquitetural

Visão do Ecossistema

O Problema Que Resolvemos

Antes da implantação da suíte, a gestão de múltiplos ambientes virtuais gerava diversos gargalos:

  1. Fragmentação de Acesso: Alunos matriculados em cursos diferentes precisavam acessar múltiplos endereços de Moodle, decorando usuários e senhas distintos.

  2. Trabalho Manual Repetitivo: Secretarias acadêmicas e equipes de TI precisavam criar cursos e matricular alunos/professores manualmente no início de cada período letivo.

  3. Inconsistência de Notas: Os professores precisavam digitar notas manualmente em dois sistemas (Moodle e SUAP), aumentando o risco de erros de digitação.

A Solução

A suíte resolve esses problemas por meio de dois pilares principais:

  1. Automação de Fluxos (Integrador AVA + Plugins): O Integrador AVA é um middleware inteligente. Quando uma secretaria autoriza ou um professor solicita a sincronização, o Integrador recebe a requisição do SUAP, identifica automaticamente a qual instância do Moodle aquele diário pertence (com base em regras, ex: sigla do campus) e cria a estrutura no Moodle de forma instantânea.

  2. Centralização de Acesso (Painel AVA): Um portal único onde alunos, professores e tutores visualizam todos os diários e coordenações em que estão inscritos, independentemente de estarem hospedados no Moodle Presencial, Acadêmico, de Projetos ou Aberto.

Componentes da Suíte

A SUAP/AVA Suite é composta pelos seguintes softwares:

  • Integrador AVA: O middleware orquestrador escrito em Python/Django.

  • Painel AVA: O dashboard unificado de acesso rápido para discentes e docentes.

  • auth_suap: Plugin de autenticação para Moodle que permite login via OAuth2 do SUAP e sincroniza perfis e fotos.

  • local_suap: Plugin local para Moodle que executa o cadastro de diários, matrículas, coortes, grupos e viabiliza a extração de notas.

  • tool_painelava: Plugin administrativo para Moodle que fornece APIs de leitura de cursos ao Painel AVA.

  • tool_sga: Plugin administrativo (em desenvolvimento) para estender a integração a outros sistemas acadêmicos genéricos (como SIGAA ou qAcadêmico).

Fluxos de Integração e Status

O ecossistema é estruturado em torno de fluxos de integração específicos:

  • Painel AVA ➔ tool_painelava (Status: Final / Estável): Canal de leitura que possibilita ao Painel AVA listar em tempo real todos os cursos e diários do usuário final.

  • SUAP ➔ Integrador AVA ➔ local_suap (Status: Final / Estável): Fluxo de escrita e sincronização bidirecional que cria diários, inscreve alunos/professores no Moodle e retorna notas/frequências ao SUAP.

  • SUAP ➔ Integrador AVA ➔ tool_sga (Status: Beta / Em desenvolvimento): Canal planejado para compatibilizar a suite com outros SGAs (SIGAA, qAcadêmico, etc.).

  • Painel AVA ➔ local_suap (Status: Descontinuado): Fluxo legado que foi descontinuado e substituído de forma definitiva pelo uso do tool_painelava.

Principais Benefícios

  • Garantia de Sincronia: A lista de alunos matriculados no Moodle reflete sempre a situação real do SUAP.

  • Redução de Suporte: Login unificado via SUAP SSO e portal único (Painel AVA) reduzem drasticamente chamados por perda de senha ou “curso sumido”.

  • Agilidade no Início do Período: Cursos e turmas criados em segundos pela secretaria ou pelo próprio docente.

  • Segurança e Integridade: Notas importadas diretamente do Moodle para o SUAP, sem retrabalho de digitação.

Comunidade, Reporte de Bugs e Contribuições

Para acompanhar o desenvolvimento, discutir melhorias ou tirar dúvidas com outros usuários da suite:

  • Canal Oficial no Telegram: Acesse https://t.me/+1hE3euH9Vnw4MmYx para acompanhar novidades, anúncios de novas versões e discussões sobre bugs da suite.

Se você encontrar algum bug ou quiser solicitar novos recursos, as solicitações devem ser abertas diretamente no repositório do projeto correspondente no GitHub:

Melhor ainda: Faça um fork do repositório correspondente, implemente a correção ou melhoria e abra um Pull Request (PR) solicitando a incorporação do seu código à branch principal. Toda colaboração da comunidade é muito bem-vinda!