Pré-reserva

Aplicação para gerencimento de pré-reservas de salas informatizadas da SCINFOR-EESC.

Motivação

Na SCINFOR-EESC, existem três salas informatizadas disponíveis para reserva, que também podem ser solicitadas por servidores e docentes de outras unidades do campus. Devido às características específicas de cada uma dessas salas, é necessário que a sala de cada reserva seja definida por um gerente. Por esse motivo, não é possível estender as reservas dessas salas através do sistema de Reserva de Espaços para os interessados.

Este projeto tem como objetivo possibilitar a pré-reserva de uma das três salas para servidores e docentes, além de levantar os softwares necessários a serem instalados nos computadores da sala, e facilitar o gerenciamento das pré-reservas e a definição de salas pelos gerentes, substituindo a comunicação anterior realizada por e-mail.

Funcionalidades

• Receber pré-reservas para as salas
• Envio de e-mails para gerentes e autores das solicitações (configurar e-mail de gerência no .env)
• Visualizar as pré-reservas
• Gerenciar as pré-reservas (aceitar e designar uma sala ou não aceitar)
• Editar e excluir pré-reservas

Requisitos

• PHP 8.2
• Conexão com banco de dados
• Token oauth
• Acesso ao replicado

Em produção

Para receber as últimas atualizações do sistema rode:

git pull
composer install --no-dev
php artisan migrate

Atualização única do schema do uspdev/forms para V2

Antes do primeiro php artisan migrate após atualizar o uspdev/forms para V2, faça backup do banco e coloque a aplicação em manutenção. A migração V2 do pacote cria tabelas do zero; o comando abaixo adapta as tabelas MySQL existentes, preserva os registros e marca essa migração do pacote como executada.

php artisan down
php artisan forms:migrate-to-v2 --dry-run
php artisan forms:migrate-to-v2
php artisan migrate --force
php artisan up

Revise a saída do --dry-run e só prossiga se a validação for aprovada. O comando de transição é específico para MySQL/MariaDB e não deve ser executado novamente após concluir com sucesso. Ele próprio ajusta as tabelas existentes e registra a migration V2 do pacote como executada. Por isso, é normal que php artisan migrate --force não mostre alterações do forms; esse comando aplicará apenas outras migrations pendentes. As migrations antigas que criaram form_definitions, form_submissions e activity_log permanecem registradas como executadas e não devem ser repetidas.

Instalação

git clone git@github.com:uspdev/pre-reserva
composer install
cp .env.example .env
php artisan key:generate

Configure o .env conforme a necessidade

Apache ou nginx

Deve apontar para a /public, assim como qualquer projeto laravel.

No Apache é possivel utilizar a extensão MPM-ITK (http://mpm-itk.sesse.net/) que permite rodar seu Servidor Virtual com usuário próprio. Isso facilita rodar o sistema como um usuário comum e não precisa ajustar as permissões da pasta storage/.

sudo apt install libapache2-mpm-itk
sudo a2enmod mpm_itk
sudo service apache2 restart

Dentro do seu virtualhost coloque

<IfModule mpm_itk_module>
AssignUserId nome_do_usuario nome_do_grupo
</IfModule>

Senha única

Cadastre uma nova URL no configurador de senha única utilizando o caminho https://seu_app/callback. Guarde o callback_id para colocar no arquivo .env.

Banco de dados

• DEV

  php artisan migrate:fresh --seed

• Produção

  php artisan migrate