Download the PHP package 3dmaksik/chel-region-helpdesk without Composer

Chel-region-helpdesk

О проекте

Система является простым хелпдеском для органов местного самоуправления. Основная цель — организация заявок от пользователей к службе айти, но может также использоваться для внутренней работы. Возможности проекта (раздел будет дополняться по мере разработки функционала):

• Подача заявок как с регистрацией в системе, так и без неё с возможностью прикрепления скриншотов;
• Установка четырёх статусов обработки заявок;
• Возможность установки приоритета администратором для разделения заявок от более значимых к менее значимым;
• Создание категорий заявок, определение кабинетов сотрудников с целью указания точного местоположения;
• Push уведомления о новых заявках, о подходящих сроках предупреждения и просрочки заявок;
• Простая новостная лента для уведомлений пользователей.

Требования

• Astra Linux 1.8+ или другая российская ОС, либо любая акутальная операционная система семейства Linux;
• PHP 8.1-8.3 c расширением fileinfo, а также со всеми стандартными расширениями, которые по умолчанию обычно включены: [pgsql, sqlite3, gd, imagick, curl, imap, mysql, mbstring, xml, zip, bcmath, soap, intl, readline, ldap, msgpack, igbinary, redis, pcov]
• СУБД на выбор MYSQL 8.0+/MariaDB 10.8+, PostgreSQL 14+;
• Сервер Ngnix 1.23+, Apache не рекомендуется;
• Кеш на выбор Memcashed 1.6+, Redis 7.0 или без него;
• Composer, Node, NPM, git.

Подготовка к установке

Создать папку для работы, например/var/www/html и направить используемый сервер на поддиректориюpublic Примерные настройки перенаправления для сервера ngnix. Изменяются в файле/etc/nginx/nginx.conf Если используется Apache (не рекомендуется) создаётся в корне/var/www/html/chel-region-helpdesk/файл.htaccessс примерно следующим содержанием. Если позволяет сервер, то безопаснее настроить черезVirtualHost

$ sudo nano /etc/apache2/sites-available/helpdesk.conf Дальнейший запуск: $ sudo a2enmod rewrite $ sudo a2ensite helpdesk.conf`

После чего любой сервер необходимо перезапустить.

Установка

1. Скопировать проект к себе на сервер в созданную ранее папку:

$ cd /var/www/html $ git clone https://github.com/3dmaksik/chel-region-helpdesk.git

2. Установить проект и библиотеки $ composer install --no-dev && npm install && npm run prod

3. Установить права доступа на папки с тем же пользователем, что и у сервера:

$ sudo chgrp -R www-data ./storage ./bootstrap/cache

$ sudo chmod -R ug+rwx ./storage ./bootstrap/cache

4. Создать папки и символьные ссылки для загрузки файлов:

$ mkdir storage/images && mkdir storage/avatar && mkdir storage/sound && mkdir storage/files $ sudo ln -s ./app/public ./storage && sudo ln -s ./app/public/images ./storage/images && sudo ln -s ./app/public/avatar ./storage/avatar && sudo ln -s ./app/public/files ./storage/files && sudo ln -s ./app/public/sound ./storage/sound

$ sudo php artisan storage:link

5. Скопировать файлы настроек

$ cp .env.example .env && cp config/settings.php.example config/settings.php

6. Сгенерировать ключ проекта $ php artisan key:generate
7. В файле .env заполнить все незаполненные поля.
8. Установить базу данных $ php artisan migrate:fresh --seed
9. В файле config/settings.php по желанию отредактировать настройки.
10. Настроить сокеты, планировщик, задачи, с помощью демона:

$ sudo apt install supervisor
$ sudo npm install -g @soketi/soketi
$ sudo systemctl enable supervisor
$ sudo nano /etc/supervisor/conf.d/soketi.conf
$ sudo nano /etc/supervisor/conf.d/schedule.conf $ sudo nano /etc/supervisor/conf.d/queue.conf
$ sudo supervisorctl update`

После чего проект готов к работе. Логин и пароль по умолчанию admin/password. По желанию его возможно изменить.

Обновления

1. Обновления проекта $ git pull origin master && sudo supervisorctl update.
2. Обновления рабочих библиотек $ composer update && npm update && npm run prod.
3. В случае каких либо изменений файла settings.php необходимо из файла settings.php.example скопировать или изменить недостающие переменные, о чём будет сообщено в релизе.
4. В случае каких либо изменений в базе необходимо выполнить $ php artisan migrate .

Запуск проекта в Docker

1. Установить докер, если ещё не установлен (инструкция по установке) (в таблице необходимо нажать на вашу систему)
2. Для установки проекта необходимо запустить скрипт без root (требуется wget и пользователь с id, gid 1000, обычно это созданный пользователь при установке операционной системы) $ wget https://raw.githubusercontent.com/3dmaksik/chel-region-helpdesk/master/build/project/install.sh && sudo chmod +x install.sh && ./install.sh.
3. В файле .env укажите используемый айпи адрес или домен в строке APP_URL.
4. Для обновления проекта необходимо запустить скрипт, удалив прошлый файл, если ранее скачивался $ wget https://raw.githubusercontent.com/3dmaksik/chel-region-helpdesk/master/build/project/update.sh && sudo chmod +x update.sh && ./update.sh.
5. Вы также можете сохранить данные скрипты отдельно и запускать не скачивая.
6. В случае появления ошибок во время первой установки или обновления необходимо в первую очередь запустить последний выбранный скрипт повторно. Работа продолжится с места ошибки.

Вопросы и предложения

По всем найденным багам, предложениям пишите сюда

Лицензии используемых библиотек, связных библиотек, шрифта.

1. Laravel- MIT
2. Permission- MIT
3. Pusher- MIT
4. Websockets- GNU
5. Boostrap- MIT
6. JQuery- MIT
7. RuangAdmin- MIT
8. eStartup- CC
9. Fancybox- GPLv3
10. FontAwesome- CC BY 4.0, SIL OFL 1.1, MIT
11. Select2- MIT
12. Nunito Font- OFL

Конец