Integração Revolucionária de API: Transformar a Gestão de Horários Académicos

Introdução

A Faculdade de Engenharia da Universidade do Porto (FEUP), uma das maiores e mais prestigiadas instituições de ensino de Portugal, gere uma vasta e complexa rede de horários para os seus mais de 8.000 estudantes e 700 docentes, distribuídos por inúmeros cursos e edifícios.

Durante anos, a criação de horários na FEUP foi um processo essencialmente manual. Uma equipa dedicada dependia de folhas de cálculo e documentos em papel para construir os horários semestrais. Embora familiar, esta abordagem era extremamente morosa e propensa a erros.

A complexidade de gerir cursos de engenharia — com os seus diversos requisitos de laboratório, necessidades de equipamento especializado e turmas de dimensões variáveis — tornava a criação manual de horários cada vez mais difícil à medida que a instituição crescia. Acima de tudo, os horários não eram sincronizados automaticamente com o SIGARRA, o principal sistema de gestão académica da FEUP, pelo que a informação mais atualizada não estava facilmente acessível à comunidade académica.

O desafio

• Conflitos frequentes: Evitar sobreposições de horários para estudantes, docentes e salas era um grande desafio. Os conflitos eram comuns e exigiam uma intervenção manual extensa para serem resolvidos.
• Gestão de alterações complexa: Qualquer alteração solicitada pelo corpo docente ou pelos estudantes exigia trabalho manual adicional, consumindo tempo e recursos valiosos.
• Ineficiência e custos elevados: O processo manual resultava em desperdício significativo de tempo e custos elevados. As reservas sobrepostas de salas eram frequentes, exigindo resolução constante de conflitos.
• Falta de integração de sistemas: Os horários não eram sincronizados automaticamente com o SIGARRA, pelo que a informação mais atualizada não estava facilmente acessível à comunidade académica.

A solução transformadora: software da Bullet Solutions

Para modernizar e otimizar a sua gestão de horários, a FEUP decidiu implementar o software da Bullet Solutions. Uma pedra angular desta transformação foi a API (Interface de Programação de Aplicações) da Bullet Solutions, que permitiu a automação e a integração de dados com o SIGARRA.

A implementação foi adaptada às necessidades específicas da FEUP, tendo em conta a complexidade dos cursos de engenharia e a gestão de espaços diversos.

• Fase 1 — Análise e personalização: Software adaptado aos requisitos específicos dos cursos de engenharia da FEUP.
• Fase 2 — Geração automatizada de horários: Algoritmos avançados otimizam a utilização de salas e laboratórios.
• Fase 3 — Gestão dinâmica de horários: Sistema centralizado para ajustes e alterações de última hora.
• Fase 4 — Integração de sistemas: Sincronização perfeita em tempo real com o SIGARRA.

A ligação crucial: integração com o SIGARRA

Uma das conquistas mais significativas desta implementação foi a integração perfeita entre a Bullet Solutions e o SIGARRA, o sistema de gestão académica da FEUP, possibilitada através de um endpoint de API dedicado: /api/Events/all/{startDate}/{endDate}.

A integração funciona em três passos:

1. O SIGARRA envia um pedido à API, especificando um intervalo de tempo (data de início e de fim).
2. Após autenticação segura, a API devolve uma lista de todos os eventos — horários de aulas, exames, entre outros — para esse período.
3. O SIGARRA recebe os dados e atualiza automaticamente os horários na sua base de dados, tornando-os instantaneamente visíveis para estudantes, docentes e administração.

Resultados e impacto

A adoção do software da Bullet Solutions, em particular a integração via API, trouxe melhorias substanciais e mensuráveis em múltiplas áreas operacionais.

• Eficiência operacional massiva: O tempo necessário para criar e gerir horários foi reduzido em mais de 80% — de mais de cinco meses para menos de um mês.
• Eliminação de conflitos: A geração automatizada de horários eliminou praticamente todas as sobreposições de salas, estudantes e corpo docente.
• Consistência e fiabilidade dos dados: A integração automática garante que o SIGARRA reflete sempre os dados de horários mais atuais e precisos.
• Melhor experiência do utilizador: Estudantes e docentes beneficiam de um acesso centralizado, fiável e em tempo real aos seus horários.
• Otimização de recursos: A ocupação de salas e laboratórios está agora alinhada com o número de estudantes, garantindo um uso eficiente dos espaços.
• Adaptabilidade e resposta rápida: A FEUP ganhou a capacidade de gerir e responder rapidamente a alterações e atualizações de horários.

A API funciona como uma "ponte" digital, permitindo que os horários — depois de gerados e otimizados na Bullet Solutions — fluam automaticamente e com precisão para o sistema utilizado diariamente pela comunidade académica. Esta iniciativa não só elevou a eficiência operacional a níveis sem precedentes, como também melhorou significativamente a experiência académica de toda a comunidade.

Desafios e considerações para um sucesso continuado

Apesar dos benefícios claros, a manutenção desta integração exige atenção a alguns pontos:

• Segurança da integração: A autenticação segura da API (OAuth2) é essencial para proteger dados sensíveis.
• Volume de dados: Em períodos académicos longos, o volume de dados de horários transferidos pode ser significativo, exigindo capacidade de processamento e armazenamento eficientes do lado do SIGARRA.
• Tratamento de erros: A integração tem de lidar de forma robusta com potenciais erros da API, garantindo que a sincronização se mantém fiável e ininterrupta.
• Mapeamento de dados: Garantir que os dados de horários da Bullet Solutions são corretamente interpretados e adaptados à estrutura do SIGARRA é uma tarefa contínua.

"A implementação da solução da Bullet transformou o nosso processo de criação de horários. Reduziu significativamente o tempo e o esforço necessários para criar e gerir horários, permitindo-nos focar em proporcionar uma melhor experiência académica aos nossos estudantes e a todo o corpo docente."

— Susana Gaio, Gestora de TI, FEUP