/astu-service-desk

Application processing system for ASTU technical support department.

Primary LanguagePHP

astu-service-desk

Application processing system for ASTU technical support department.

Предварительные требования

  1. Установить git sudo apt install git.
  2. Установить PHP и его расширения 
    sudo add-apt-repository ppa:ondrej/php
sudo apt-get update
sudo apt-get install php7.2
sudo apt-get install php-pear php7.2-curl php7.2-dev php7.2-gd php7.2-mbstring php7.2-zip php7.2-mysql php7.2-xml php7.2-pgsql
  3. Проверить установку php через терминал php -v. Должно выдать версию.
  4. Установить PostgreSQL sudo apt install postgresql postgresql-contrib.
  5. Сконфигурировать базу данных (https://eax.me/postgresql-install/). В руководстве пропустить часть про установку. Нужно выполнить следующее
sudo -u postgres psql
CREATE DATABASE astu_service_desk;
CREATE USER astu_service_desk WITH password 'astu_service_desk';
GRANT ALL ON DATABASE astu_service_desk TO astu_service_desk;
  1. Проверить подключение к БД через консоль psql -h localhost astu_service_desk astu_service_desk.
  2. Установить composer по руководству + sudo mv composer.phar /usr/local/bin/composer.
  3. Установить npm и yarn (https://medium.com/@shivraj.jadhav82/nodejs-and-npm-setup-on-linux-mint-19-696023d50247)
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt-get install -y nodejs

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update && sudo apt install yarn

Клонирование и запуск проекта

  1. Клонировать репозиторий git clone https://github.com/ralymov/astu-service-desk.git.
  2. Перейти в созданную директорию cd astu-service-desk.
  3. Установить зависимости PHP composer install.
  4. Установить зависимости JS yarn install.
  5. Собрать фронтенд yarn run dev (в продакшн - yarn run prod).
  6. Скопировать файл-пример настроек окружения с правильным именем (cp .env.example .env).
  7. Сгенерировать ключ приложения php artisan key:generate.
  8. Заполнить данными настройек окружения .env файл (созданные доступы к БД).
  9. Запустить миграции (создает таблицы в БД) php artisan migrate.
  10. Запустить заполнение БД начальными данными php artisan db:seed.
  11. Сгенерировать ключ jwt php artisan jwt:secret.
  12. Запустить сервер разработки по пути http://localhost:8000 php artisan serve. Альтернатива.
  13. Тестовые пользователи - admin@admin и contractor@contractor.

.env переменные

  • DB_CONNECTION - Название соединения (pgsql).
  • DB_HOST - Адрес соединения (127.0.0.1).
  • DB_PORT - Порт соединения (5432 по умолчанию для postgre).
  • DB_DATABASE - Название БД (astu_service_desk).
  • DB_USERNAME - Имя пользователя БД (astu_service_desk).
  • DB_PASSWORD - Пароль пользователя БД (astu_service_desk).