TIC (Tecnologia da Informação e Comunicação)¶

Esta seção do FAQ é destinada à equipe de TI, infraestrutura, administradores de sistemas e desenvolvedores responsáveis pela implantação e manutenção da SUAP/AVA Suite.

Quem é o responsável pelo cadastro inicial dos usuários e como os papéis são atribuídos?¶

A origem primária dos dados de quem participa diretamente de um diário (estudantes, docentes, mediadores e tutores) é sempre o SUAP.

Coordenadores: Atualmente, são cadastrados no SUAP. Devido a limitações temporárias de envio no SUAP, eles são cadastrados temporariamente no Integrador AVA, que se encarrega de enviá-los como Coorte para o Moodle. Há um esforço conjunto com a equipe de desenvolvimento do SUAP para que esse envio passe a ocorrer de forma nativa a partir da origem, garantindo que a coordenação também venha diretamente do SUAP.
Outros papéis: São cadastrados diretamente no Integrador AVA e enviados via coorte, cuja distribuição é altamente flexível e controlada por um motor de regras (rule engine).

Após a integração, os dados dos usuários são sincronizados de forma automática ou demandam intervenção manual?¶

Existem dois fluxos de sincronização com comportamentos distintos:

Diários de Classe: A sincronização de usuários e notas é iniciada de forma manual por um professor, coordenador ou secretário acadêmico. Isso garante supervisão humana sobre as alterações. Embora seja tecnicamente possível automatizar a sincronização agendando uma tarefa (task) no Celery do SUAP, recomenda-se não automatizar. Caso ocorra alguma discrepância temporária entre as notas do Moodle e do SUAP antes do momento desejado pelo professor para a consolidação, a responsabilidade poderá ser indevidamente atribuída à equipe de TIC.
Cursos FIC < 10h: Projetados no IFRN para serem simplificados. O envio inicial do curso é manual, mas o retorno das notas para o SUAP ocorre de forma automática.

Como funciona o fluxo técnico de sincronização (SUAP -> Integrador AVA -> Moodle)?¶

A sincronização é sempre iniciada a partir do SUAP. Este aciona o middleware Integrador AVA, que por sua vez se comunica com o Moodle para a criação de ambientes e sincronização de dados (tanto de envio de matrículas quanto de retorno de notas). Detalhes adicionais sobre a arquitetura da solução estão documentados em https://cte-zl-ifrn.github.io/.

Como é tratada a movimentação de estudantes (inclusão, cancelamento ou transferência) no AVA após a matrícula no SUAP?¶

A atualização de movimentações acadêmicas não ocorre em tempo real de forma automática. O Moodle será atualizado com as novas informações somente quando for disparada uma nova sincronização do diário de classe no SUAP (seja pelo professor, coordenação ou secretaria).

É necessário que mediadores e tutores tenham acesso ao SUAP para que consigam lançar notas no AVA?¶

Não. A atividade pedagógica e o lançamento de notas por parte de mediadores e tutores acontecem exclusivamente no Moodle (AVA). O acesso ao SUAP só é necessário para os profissionais responsáveis por disparar a sincronização ou realizar a importação oficial das notas (geralmente o professor responsável pelo diário, a coordenação ou a secretaria).

Quais são as limitações conhecidas e boas práticas de infraestrutura recomendadas?¶

Não cadastre usuários manualmente no Moodle: Adicionar professores, coordenadores ou alunos diretamente no Moodle por fora do fluxo oficial causará problemas. A sincronização subsequente do SUAP pode reverter ou ignorar essas alterações manuais.
Uso de Containers: Recomenda-se implantar os serviços da suite utilizando contêineres para facilitar a manutenção e escalabilidade do ambiente.
Uso de Temas: * O Tema 2023 está obsoleto e deve ser desativado. * O Tema 2025 está estável e serve como boa base (com possibilidade de personalização). * O Tema 2026 está em desenvolvimento e adotará o padrão de identidade visual do Governo Federal (DS GovBR).
Autenticação SUAP: O uso do plugin de autenticação integrada (auth_suap) via OAuth2 não é obrigatório, mas é altamente recomendado para uma melhor experiência de login unificado dos usuários.
Modelagem Lógica (1 Diário = 1 Curso): Mantenha sempre a correspondência direta da integração (1 diário no SUAP = 1 curso no Moodle, 1 matrícula = 1 usuário, 1 inscrição em diário = 1 enrolment em curso). Evite juntar múltiplos diários em um único curso para simplificar a navegação dos docentes, pois isso quebrará a lógica da sincronização de notas.
Colaboração: Se desenvolver melhorias no código ou correções de bugs, faça um fork do repositório oficial e compartilhe suas modificações por meio de um Pull Request.

Como podemos visualizar o funcionamento real e a interface da integração?¶

A integração propriamente dita é um processo de comunicação back-end entre servidores (comunicação server/server/server entre o SUAP, Integrador AVA e Moodle) e não possui uma interface visual complexa dedicada. Capturas de tela e fluxos de funcionamento podem ser consultados no site oficial da suíte (https://suap-ava-suite.github.io/).

Como ficar por dentro de reuniões, novidades ou novos eventos da SUAP/AVA Suite?¶

Todas as comunicações sobre próximos eventos, reuniões e novidades de desenvolvimento são realizadas de forma centralizada através de nosso canal oficial no Telegram: https://t.me/+1hE3euH9Vnw4MmYx.