Sistema que gerencia o fluxo de chamados técnicos ou solicitações de atendimento. Foi idealizado para chamados de informática e de zeladoria (manutenção predial) mas pode ser estendido a quaisquer outros serviços.
- Filas de atendimento
- múltiplas filas de atendimentos
- organizado por setores
- cadastro de gerentes e atendentes
- com ou sem triagem
- controle de visibilidade por categoria de pessoas
- formulário de chamado personalizado (para usuários e atendentes)
- estados adicionais do chamado
- Chamado
- anexar arquivos
- vincular chamados
- cadastrar observadores
- referenciar patrimônios USP
- Painel do atendente
- campo para anotações exclusivo
- campos de formulário exclusivo (por fila)
- Usuário
- Autenticação por senha única
- Configuração do recebimento de notificações
- Envio de emails
- Gerencimento de setores
Veja o histórico de atualizações.
Esse sistema foi projetado para rodar em servidores linux (Ubuntu e Debian).
- PHP 8.1
- Apache ou Nginx
- Banco de dados local (MariaDB mas pode ser qualquer um suportado pelo Laravel)
- Git
- Composer
- Credenciais para senha única
- Acesso ao replicado (visão Pessoa - VUps, Estrutura - VUes e Financeiro - VUfi)
Bibliotecas necessárias do php:
apt install php-sybase php-mysql php-xml php-intl php-mbstring php-gd php-curl php-zip
Caso você já tenha instalado o sistema e aplique uma nova atualização, sempre deve rodar:
composer install --no-dev
php artisan migrate
Também deve observar no changelog se tem alguma outra coisa a ser ajustada, por exemplo o arquivo .env
cd /var/www/html
git clone [email protected]:uspdev/chamados
cd chamados
composer install
cp .env.example .env
php artisan key:generate
Criar user e banco de dados (em mysql):
sudo mysql
create database chamados;
create user 'chamados'@'%' identified by '<<password here>>';
grant all privileges on chamados.* to 'chamados'@'%';
flush privileges;
A biblioteca (https://github.com/uspdev/cache) usada no replicado utiliza o servidor memcached. Se você pretende utilizá-lo instale e configure ele:
sudo apt install memcached
sudo vim /etc/memcached.conf
I = 5M
-m 128
/etc/init.d/memcached restart
Configurar a conta de email para acesso menos seguro pois a conexão é via smtp.
Criar novo arquivo chamados.conf em /etc/apache2/sites-available; nele, dentro da tag VirtualHost, o DocumentRoot deve apontar para /var/www/html/chamados/public. E para que as rotas funcionem, adicionar, ainda dentro dessa tag, a seguinte configuração:
<Directory /var/www/html/chamados/public>
AllowOverride All
</Directory>
E, em seguida, executar:
sudo a2enmod rewrite
sudo service apache2 restart
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 # habilita o módulo
sudo service apache2 restart
Dentro do chamados.conf, dentro da tag VirtualHost coloque:
<IfModule mpm_itk_module>
AssignUserId nome_do_usuario nome_do_grupo
</IfModule>
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.
Há várias opções que precisam ser ajustadas nesse arquivo. Faça com atenção para não deixar passar nada. O arquivo está todo documentado.
php artisan migrate
Os setores e respectivos designados podem ser importados do Replicado. Para isso rode:
php artisan db:seed --class=SetorReplicadoSeeder
Depois de importado faça uma conferência para não haver inconsistências.
Para as filas de envio de email o sistema precisa de um gerenciador que mantenha rodando o processo que monitora as filas. O recomendado é o Supervisor. No Ubuntu ou Debian instale com:
sudo apt install supervisor
Modelo de arquivo de configuração. Como root, crie o arquivo /etc/supervisor/conf.d/chamados_queue_worker_default.conf com o conteúdo abaixo:
[program:chamados_queue_worker_default]
command=/usr/bin/php /var/www/html/chamados/artisan queue:listen --queue=default --tries=3 --timeout=60
process_num=1
username=www-data
numprocs=1
process_name=%(process_num)s
priority=999
autostart=true
autorestart=unexpected
startretries=3
stopsignal=QUIT
stderr_logfile=/var/www/html/chamados/storage/logs/chamados_queue_worker_default.log
Ajustes necessários:
command=<ajuste o caminho da aplicação>
username=<nome do usuário do processo do chamados>
stderr_logfile = <aplicacao>/storage/logs/<seu arquivo de log>
Reinicie o Supervisor
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl restart all
É necessária essa permissão, pois o site utiliza sessões, que são gravadas em storage/framework/sessions. E se ligarmos o modo debug, o site também quer gravar em storage/logs.
sudo chown -R www-data:www-data /var/www/html/chamados/storage
sudo chmod -R 755 /var/www/html/chamados/storage
sudo service apache2 restart
Para receber as últimas atualizações do sistema rode:
cd /var/www/html/chamados
git pull
composer install --no-dev
php artisan migrate
Para atualizar os pacotes utilizados pelo sistema (por exemplo, o laravel-usp-theme), rode:
composer update
Caso tenha alguma atualização, não deixe de conferir o readme.md quanto a outras providências que podem ser necessárias.
Ainda é preciso descrever melhor mas pode seguir as instruções para ambiente de produção com os ajustes necessários.
php artisan migrate:fresh --seed
O senhaunica-fake pode não ser adequado pois o sistema coloca as pessoas nos respectivos setores com as informações da senha única.
Para subir o servidor
php artisan serve
CUIDADO: você pode enviar emails indesejados para as pessoas.
Para enviar emails é necessário executar as tarefas na fila. Para isso, em outro terminal rode
php artisan queue:listen
Ao rodar pela primeira vez com apache, as variáveis de ambiente relacionadas ao replicado não ficam disponíveis. Nesse caso é necessário restartar o apache.
https://www.php.net/manual/pt_BR/function.getenv.php#117301
Para limpar e recriar todo o DB, rode sempre que necessário:
php artisan migrate:fresh --seed
- O sistema de chamados foi transferido da FFLCH para o USPDev.
- Adaptar para o uso por várias unidades
- Expandir para o uso por outros setores como por exemplo o serviço de manutenção
- Implementado conceito de filas
Foram utilizados vários recursos do laravel que podem não ser muito trivial para todos.
- O monitoramento de novos chamados ou novas mensagens nos chamados é feito usando observers (https://laravel.com/docs/8.x/eloquent#observers)
- Os emails enviados são colocados em filas (jobs) para liberar a execução do php (https://laravel.com/docs/8.x/mail#queueing-mail)
- Monitorar jobs com falhas
- Monitorar arquivos de log (implementado v 1.5)