Sistema em Laravel para o gerenciamento dos eventos de uma unidade de acordo com as salas e horários disponíveis.
- Visualização do calendário de reservas de cada sala (semanal, diário e mensal)
- Busca pelas reservas filtrando por categoria, finalidade, data e título
- Administração dos usuários permitidos para reservar dentro de uma Categoria
- Configurar se a sala precisa ou não de aprovação
- Administração dos usuários responsáveis por cada sala, que gerenciarão os pedidos de reservas para as salas que precisam de aprovação
- Envio de e-mail aos solicitantes e responsáveis
- Administração das finalidades para as reservas
- Administração dos Perídos letivos e suas respectivas janelas de reservas
- Criação e edição de reservas em massa caso haja repetição do evento
- Validação para que reservas não sejam cadastradas caso haja sobreposição de data, horário e sala
- Configuração por sala de bloqueio informando o motivo
- Configuração por sala de antecedência mínima em dias para uma reserva
- Configuração por sala da duração mínima e máxima em minutos de uma reserva
- Configuração por sala dos limites de datas para as reservas:
- Data limite fixa (data máxima para uma reserva)
- Data limite dinâmica (máximo de dias a partir da solicitação para uma reserva)
- Datas limites definidas pelo Período Letivo (janelas de reserva por período letivo)
- Consumo de dados via API, recuperando informações acerca das salas, categorias e reservas do dia
As pessoas cadastradas nas categorias são aquelas que poderão realizar reservas na categoria em questão. Para cada categoria é possível gerenciar as pessoas cadastradas de duas formas: pelo número USP ou pelo vínculo com a unidade em questão.
Pelo número USP é necessário inserir manualmente o número USP da pessoa desejada na aba de edição categoria, e ela será cadastrada na categoria possibilitando realizar reservas.
O gerenciamento pelo vínculo é referente somente aos vínculos de Docente, Servidor e Estagiário, e possui três opções:
- USP: todos os docentes, servidores e estagiários que entrarem com a senha única no sistema poderão realizar reservas na categoria.
- Unidade: todos os docentes, servidores e estagiários que entrarem com a senha única e pertecerem à unidade que o sistema estiver configurado poderão realizar reservas na categoria.
(A unidade é mostrada com base na variável de ambiente
REPLICADO_CODUNDCLG
do.env
) - Setor: somente os docentes, servidores e estagiários que pertencem ao(s) setor(es) poderão realizar reservas na categoria. (O código da unidade para identificar os logins próprios ou de outras unidades é baseado na variável de ambiente SENHAUNICA_CODIGO_UNIDADE do .env)
- Nenhum: somente as pessoas cadastradas manualmente poderão realizar reservas na categoria.
As salas podem conter algumas restrições de datas para as reservas. A ativação de qualquer uma dessas opções altera o funcionamento do sistema, especialmente nas novas solicitações:
- Bloqueio: Impede novas reservas na sala. Essa condição pode ser útil em caso de manutenção ou qualquer outra situação em que a sala não pode ser reservada.
- Antecedência mínima: Quantidade de dias de antecedência mínima para reservar a sala.
- Duração das reservas: As reservas para a sala podem ser limitadas a uma duração mínima e a uma duração máxima em minutos.
- Limites de datas para as reservas: Podem ser por Data limite fixa, Data limite dinâmica ou Data limite por Período Letivo (janela de reserva).
Por padrão o sistema é instalado com as seguintes finalidades para as reservas:
- Graduação
- Pós-Graduação
- Especialização
- Extensão
- Defesa
- Qualificação
- Reunião
- Evento
Mas todo gerenciamento de finalidades como adicionar, editar ou excluir, pode ser feito na aba de configurações. Permitindo a customização das finalidades para que melhor se adéque à unidade que for utilizar o sistema.
Na aba de edição da sala é possível gerenciar os responsáveis pela sala através do número USP, bem como configurar se a sala necessita de aprovação ou não para a reserva. No caso de precisar de aprovação, quando uma pessoa autorizada tentar realizar uma reserva na sala, a reserva será feita com um status de pendente, um e-mail será enviado para os responsáveis da sala e estes devem analisar o pedido de reserva no sistema, aprovando ou recusando.
Através da API, é possível consultar as informações básicas sobre as salas, as categorias, as finalidades de reserva e as reservas do dia, sendo possível filtrar as reservas do dia por sala ou finalidade. Todas as infomações são retornadas em formato JSON.
Os endpoints disponíveis e seus respectivos retornos estão listados aqui.
Ao utilizar o sistema de gerenciamento de conteúdo Drupal, é possível fazer uso da API utilizando o módulo Views Json Source, que pode ser instalado via composer com o comando composer require drupal/views_json_source
.
Com este módulo unido ao Drupal, é possível consumir os dados da API e apresentá-los em componentes da página, como views e blocos. Desta forma, os dados apresentados sempre estarão em sincronia com o sistema de reservas, visto que ao modificar as reservas no sistema de reservas, estas modificações também serão apresentadas via API.
Envio de e-mails:
Para que o envio de e-mails funcione deve-se configurar as variáveis MAIL... no .env.
composer install
cp .env.example .env
php artisan key:generate
Para ambiente de produção:
php artisan migrate
Para ambiente de desenvolvimento:
php artisan migrate:fresh --seed
Para acessar a aplicação:
php artisan serve
Este sistema foi transferido da FFLCH para o USPDev.
- 15/09/2023: Permitindo selecionar qual o nível de vínculo que poderá realizar reserva na categoria.
- 27/09/2023: Permitindo configurar necessidade de aprovação da sala e administração dos responsáveis.
- 10/10/2023: Removendo coluna
cor
da tabelareservas
e implementando a opção de finalidades. - 17/10/2023: Arrumando envio de e-mail no momento de solicitar e aprovar/recusar reservas.
- 18/10/2023: Implementando legenda de finalidades no calendário da sala.
- 18/10/2023: Arrumando seeders.
- 26/10/2023: Atualizando biblioteca do calendário.
- 26/10/2023: Permitindo realizar reservas ao clicar no calendário.
- 01/11/2023: Adicionado filtro por finalidade.
- 14/11/2023: Não permitindo realizar reservas no passado.
- 16/11/2023: Adicionada interface de restrições por sala.
- 24/11/2023: Cadastro de períodos letivos e cadastro de solicitantes por setor na categora.
- 14/08/2024: Possibilitando consumo de dados via API.