Descrição - edu-almeidaf/reservas-academicas GitHub Wiki

Visão Geral do Projeto

O Reservas Acadêmicas é um sistema para gerenciamento e reserva de ambientes e recursos acadêmicos, como salas, laboratórios, auditórios, bancadas, computadores e equipamentos.

A plataforma permite consultar a disponibilidade dos recursos, solicitar e cancelar reservas, acompanhar aprovações e gerenciar ambientes de acordo com o perfil do usuário. Também oferece controle de acesso, prevenção de conflitos de agenda e suporte à reserva de ambientes completos ou de suas subdivisões.

Perfis de Usuário

  • Discentes: alunos que podem consultar, solicitar e cancelar reservas.
  • Docentes: professores que podem solicitar, cancelar, analisar e aprovar reservas.
  • Técnicos: servidores com acesso administrativo para aprovação de solicitações e gerenciamento dos ambientes e recursos.

Requisitos Funcionais

Identificador RF01
Nome Fazer Login
Descrição Permite que o usuário acesse o sistema utilizando seu e-mail acadêmico e senha, disponibilizando as funcionalidades correspondentes ao seu perfil.
Atores Discentes, Docentes e Técnicos.
Identificador RF02
Nome Solicitar Nova Reserva
Descrição Permite solicitar a utilização de um ambiente, subdivisão ou equipamento para uma determinada data, horário e atividade.

A reserva poderá contemplar o ambiente completo ou apenas uma de suas subdivisões, conforme a configuração do recurso.
Atores Discentes, Docentes e Técnicos.
Identificador RF03
Nome Assinar Termo de Uso
Descrição Permite que o usuário registre sua concordância com as regras institucionais e assuma responsabilidade pelo uso do recurso solicitado.
Atores Discentes, Docentes e Técnicos.
Identificador RF04
Nome Analisar Solicitações
Descrição Permite visualizar os detalhes de uma solicitação pendente e registrar sua aprovação ou rejeição.
Atores Docentes e Técnicos.
Identificador RF05
Nome Cancelar Reserva
Descrição Permite cancelar uma reserva pendente ou confirmada, liberando o período reservado para novas solicitações.
Atores Discentes, Docentes e Técnicos.
Identificador RF06
Nome Cadastrar Item
Descrição Permite cadastrar novos ambientes, equipamentos ou subdivisões para utilização no sistema.
Atores Técnicos.
Identificador RF07
Nome Editar Item
Descrição Permite atualizar informações, regras, disponibilidade e demais características de um ambiente ou recurso existente.
Atores Técnicos.
Identificador RF08
Nome Alterar Status do Recurso (Ativar/Inativar)
Descrição Permite ao técnico suspender ou reativar a disponibilidade de um ambiente ou equipamento para novas reservas, preservando o histórico de uso.
Atores Técnicos.
Identificador RF09
Nome Excluir Recurso
Descrição Permite ao técnico remover permanentemente do sistema um ambiente ou equipamento que nunca tenha sido utilizado em uma reserva.
Atores Técnicos.
Identificador RF10
Nome Consultar Disponibilidade e Agenda de Reservas
Descrição O sistema deve permitir que discentes, docentes e técnicos consultem a disponibilidade de ambientes, subdivisões e equipamentos através de uma grade de horários, exibindo períodos livres e ocupados em tempo real.
Atores Discentes, Docentes e Técnicos.

Regras de Negócio (RN)

Identificador Detalhes da Regra
RN01 Antecedência para solicitação de reserva: As solicitações de reserva devem respeitar os prazos mínimos e máximos de antecedência definidos no regulamento institucional.
RN02 Prioridade entre solicitantes: Em caso de conflito entre solicitações de reserva para o mesmo ambiente e período, o sistema deve aplicar a ordem de prioridade entre os perfis de usuários definida no regulamento institucional.
RN03 Permissões de utilização dos ambientes: O sistema deve restringir a solicitação de determinados ambientes aos perfis autorizados conforme as regras estabelecidas no regulamento institucional.

Requisitos Não Funcionais

Desempenho e Disponibilidade

Identificador RNF01
Nome Tempo de Resposta
Descrição As consultas de disponibilidade e as operações de confirmação de reserva devem apresentar tempo de resposta inferior a 3 segundos em condições normais de conexão.
Identificador RNF02
Nome Suporte à Carga Concorrente
Descrição O sistema deve suportar no mínimo 200 requisições simultâneas de consulta e solicitação de reserva mantendo o tempo de resposta estabelecido no RNF01.
Identificador RNF03
Nome Disponibilidade
Descrição O sistema deve apresentar disponibilidade mínima de 99%, exceto durante períodos de manutenção programada.

Segurança

Identificador RNF04
Nome Autenticação Institucional
Descrição O sistema deve, preferencialmente, permitir integração com serviços institucionais de autenticação, como LDAP ou Active Directory, utilizando as credenciais acadêmicas já existentes.
Identificador RNF05
Nome Controle de Acesso
Descrição O sistema deve implementar controle de acesso baseado em perfis de usuário, garantindo que funcionalidades administrativas sejam acessíveis apenas por usuários autorizados.
Identificador RNF06
Nome Auditoria
Descrição Ações críticas, como aprovação, rejeição, cancelamento e exclusão de recursos, devem gerar registros de auditoria contendo o usuário responsável, data, horário e ação realizada.

Usabilidade

Identificador RNF07
Nome Responsividade
Descrição A interface deve se adaptar a diferentes tamanhos de tela, permitindo o uso do sistema em computadores, tablets e smartphones sem perda significativa de funcionalidade.
Identificador RNF08
Nome Identidade Visual
Descrição A interface deve seguir o manual de identidade visual da instituição, incluindo padrões de cores, tipografia, logotipos e demais elementos definidos pela UTFPR.
Identificador RNF09
Nome Feedback do Sistema
Descrição O sistema deve apresentar mensagens claras e imediatas para informar o resultado das ações realizadas pelo usuário.

Exemplos:
  • Reserva solicitada com sucesso.
  • Reserva cancelada com sucesso.
  • Horário indisponível para reserva.
  • Antecedência mínima não respeitada.
Identificador RNF10
Nome Acessibilidade
Descrição O sistema deve seguir, sempre que possível, as diretrizes de acessibilidade da WCAG e oferecer compatibilidade com tecnologias assistivas. Também poderá integrar ferramentas de acessibilidade, como o VLibras.

Requisitos Externos

Identificador RNF11
Nome Conformidade com a LGPD
Descrição O tratamento de dados pessoais deve estar em conformidade com a Lei Geral de Proteção de Dados (LGPD), garantindo segurança, privacidade e utilização adequada das informações dos usuários.
Identificador RNF12
Nome Conformidade com o Regulamento Institucional
Descrição O sistema deve estar em conformidade com as regras estabelecidas no regulamento institucional, especialmente quanto à utilização e à reserva dos ambientes institucionais.
Identificador RNF13
Nome Compatibilidade
Descrição O sistema deve ser compatível com versões atuais dos principais navegadores:
  • Google Chrome
  • Mozilla Firefox
  • Microsoft Edge
  • Safari

Requisitos Técnicos e Processo

Categoria Detalhes
Front-end HTML5, CSS3 e Bootstrap 5 para o desenvolvimento da interface de usuário responsiva.
Back-end e Regras de Negócio PHP utilizado no desenvolvimento da aplicação de servidor.
Banco de Dados MySQL como sistema gerenciador de banco de dados relacional para armazenar e organizar os dados.
Infraestrutura e Implantação Docker para a padronização dos ambientes de desenvolvimento e implantação através de conteinerização.
Metodologia de Processo O sistema será desenvolvido utilizando uma abordagem ágil e iterativa, permitindo a evolução gradual das funcionalidades e ajustes baseados no feedback contínuo.

Impacto Esperado

A implementação do sistema Reservas Acadêmicas visa modernizar o fluxo de gerenciamento de espaços físicos e equipamentos da instituição, substituindo processos manuais por uma plataforma centralizada. Os principais impactos esperados dividem-se em três pilares:

1. Otimização Administrativa e Prevenção de Conflitos

  • Fim dos Choques de Horário: A validação automática de disponibilidade do sistema impede que um mesmo laboratório, computador ou auditório seja reservado por pessoas diferentes no mesmo momento.
  • Auditoria e Rastreabilidade: Com o registro das ações e o aceite obrigatório do Termo de Uso (RF03), a equipe técnica ganha controle total sobre quem utilizou o recurso e o status de conservação pós-uso.
  • Centralização de Dados: Substituição de controle por planilhas ou papel por um painel digital unificado para aprovação e gestão rápida.

2. Autonomia para a Comunidade Acadêmica

  • Consultas em Tempo Real: Discentes e docentes ganham a capacidade de verificar a disponibilidade de um ambiente e solicitar reservas de qualquer dispositivo, reduzindo a necessidade de deslocamento físico até os técnicos responsáveis.
  • Transparência no Processo: Os solicitantes podem acompanhar o status da sua reserva (pendente, aprovada ou rejeitada) e recebem feedback claro do sistema.

3. Sustentabilidade e Segurança

  • Digitalização: Redução drástica do uso de papel para formulação de requerimentos e assinaturas de responsabilidade.
  • Privacidade (LGPD): Autenticação segura atrelada aos perfis da instituição, garantindo que os dados dos usuários sejam mantidos sob sigilo e acessados apenas conforme a hierarquia de permissões.

Uso de Inteligência Artificial (Entrega 1)

Durante o planejamento e estruturação da primeira entrega do projeto, a utilização de Inteligência Artificial foi restrita ao apoio na configuração do ambiente de versionamento (GitHub) e na padronização visual da documentação na Wiki, não havendo geração de código-fonte de software nesta etapa.

Ferramenta Finalidade Exemplo de Prompt Utilizado Resultado Obtido
Gemini Formatação da documentação em Markdown para a Wiki do GitHub e geração de menus de navegação (Sidebar). "Modifique essa estrutura de página para que o markdown contenha uma tabela para cada requisito, organizando melhor o texto" Documentação dos Requisitos Funcionais e Não Funcionais padronizada em tabelas, e criação de uma barra de navegação lateral customizada e funcional para a Wiki.
⚠️ **GitHub.com Fallback** ⚠️