SUAP/AVA Suite documentation

🎯 **Projetada pela tradição inovadora do IFRN, pronta para qualquer instituição** que use o SUAP e o Moodle.

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.

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

Estrutura da Documentação

Este repositório contém a documentação centralizada da SUAP/AVA Suite, um conjunto de plugins Moodle e middlewares para integração com Sistemas de Gestão Acadêmica (SGA), como o SUAP do IFRN.

A documentação foi organizada em seções direcionadas para cada perfil de usuário e técnico que interage com o ecossistema:

  1. Visão Geral para Gestores: Apresentação de alto nível da suíte, contextualizando a integração entre as múltiplas instâncias do Moodle e o SUAP. Explica de forma executiva os benefícios da centralização (Painel AVA) e da automação (Integrador AVA).

  2. Guia do Desenvolvedor e Infraestrutura: Explicação da arquitetura de microsserviços, guia de setup local com Docker Compose, mapeamento das variáveis de ambiente críticas, instalação de gates de qualidade (pre-commit e limites de cobertura de testes unitários) e instalação dos plugins no Moodle.

  3. Guia da Secretaria Acadêmica: Instruções para a equipe de registro escolar sobre como habilitar diários e cursos no SUAP para que a sincronização ocorra, além de guias de resolução para problemas comuns de acesso.

  4. Guia do Professor (Docente): Manual prático explicando como solicitar a sincronização de diários, como puxar notas do Moodle para o SUAP e a configuração crítica e obrigatória do livro de notas do Moodle.

  5. Dúvidas Frequentes (FAQ): Respostas para dúvidas comuns sobre o funcionamento e boas práticas de integração da suite, divididas pelos perfis de TIC, Professores e Secretaria Acadêmica.

Sumário: