#README

---

###git:

• клонируем репозиторий командой:

  git clone [email protected]:evgeny89/stupenki.git
  

  либо для https

  git clone https://github.com/evgeny89/stupenki.git
  

• ответвляемся от ветки master (ветку именуем как task-*, где * - номер таска):

  git checkout -b task-01
  

• выполняем таск (ниже опишу команды для работы с проектом)

• добавляем файлы в индекс и коммитим
  (самый быстый способ - запихать все в один коммит):

  • git add .
    

  • git commit -m "текст коммита"
    

• когда таск готов и все закоммичено ОБЯЗАТЕЛЬНО! подтянуть изменения
  с удаленного репозитория:

  • переключаемся на master:

    git checkout master
    

  • тянем изменения:

    git fetch --all
    

  • скачиваем изменения:

    git pull
    

  • возвращаемся на свою ветку (task-01 - имя ветки):

    git checkout task-01
    

  • мержим обновленный мастер к себе:

    git merge master
    

  • если вы могли работать с одними и теми же файлами, что и другой участник процесса разработки,
    то вполне возможны конфликты при мерже мастера (на это оно и делается,
    чтобы не получить конфликты на сервере...). Их необходимо разрешить самим
    (процесс зависит от того каким редактором вы пользуетесь)

• после мержа мастера в текущий таск, необходимо отправить изменения на github

  git push origin task-01
  

• для завершения процесса - необходимо зайти на github
  (некоторые программы, а так же phpStorm так же предоставляю.т такую возможность)
  и создать pull request своей ветки на ветку мастер моего репозитория.

• дальше я все сделаю сам.

• некоторые полезные команды:

  • git stash - кладет в специальный буфер все несохраненные изменения
    
    (полезно если нужно переключиться на другую ветку)
  • git stash pop - извлеч из буфера лежащие там изменения.
  • git status - покажет состояние текущей ветки.
  • git reset - может быть опасной командой, имеет 3 флага.
    Может сбросить соммиты, индексы или целиком все изменения.
    Подробнее habr.com.

---

###composer: Перечислю некоторые команды, которые могут понадобиться в процессе разработки.

• для установки самого компосера существует много способов, от скачивания архива,
  до установки через терминал (иногда вместо команды composer необходимо вводить php composer)
• для установки всех зависимостей, необходимых для работы Laravel используем команду:

  composer install

---

###artisan: Основной инструмент для работы с Laravel
Список необходимых команд:

• установка миграций (скриптов для создания, редактирования, удаления столбцов и таблиц в базе данных)

  php artisan migrate

• список команд для сброса кеша
  (многие данные кешируются и, возможно, возникнет необходимость очистить их)

  # команды сброса кеша
  php artisan cache:clear
  php artisan route:clear
  php artisan config:clear
  php artisan view:clear
  
  # так же команды для перекеширования
  php artisan route:cache
  php artisan config:cache
  php artisan view:cache

---

###npm Не забываем про npm install вдруг ваш напарник что-то добавил в файл /package.json

---

###Frontend:

• Файлы проекта лежат в /resourses
• Файлы Vue лежат в /resourses/js
• Точка входа /resourses/views/home.blade.php
• Конфигурационный файл вебпака /webpack.mix.js
• При изменении /resourses/views/home.blade.php необходимо сбросить кеш,
  иначе эти изменения не отобразятся.

---

###backend При первом скачивании проекта с гита необходимо скопировать .env.example файл как .env
Затем необходимо отредактировать его.

• APP_KEY= заполняется командой

  php artisan key:generate

  Эту команду необходимо ввести единожды, чтобы получить уникальный ключ для вашей локальной копии
  Laravel на сервере этот файл уже сконфигурирован.
• APP_URL=http://localhost локальный домен для разработки,
  
  многие функции используют для генерации url
• Блок DB необходим для поключения к базе данных:

    DB_CONNECTION=mysql
    DB_HOST=127.0.0.1
    DB_PORT=3306
    DB_DATABASE=stupenki
    DB_USERNAME=root
    DB_PASSWORD=root
  

  пример заполнения.

Остальные блоки вроде пока нам не нужны.

---

При первой установке необходимо:
сначала заполнить корректными данными .env,
затем сбросить кеш (инструкции выше)
и только потом проводить миграции.