Учебный проект - аренда жилья (Fullstack - Laravel & Vue3).

SPA приложение "Аренда жилья" с возможностью регистрации пользователя и верификации аккаунта через email сообщение.

Управление аккаунтом пользователя - смена email адреса, имени, смена пароля, сброс и смена забытого пароля, ссылка подтверждения email адреса.

Фильтарция предложений и пагинация (постраничный вывод) на странице просмотра предложений аренды.

Для сделанных бронирований пользоватля или анонимного пользователя предустмотерна возжноноть оставить отзыв с выставлнием рейтинга адрендуемого жилья.

Оповещение на email о возможности оставить отзыв о бронированиии арендуемого жилья.

Стек:

• 🐘 Php 8.2 + Laravel 9 (пакет Fortify для авторизации и регистрации пользователя)
• 🥉 Vue 3 by composition api + TypeScript + Pug + Pinia
• 🧶 Boostrap css 5
• 🦖 MariaDb
• 📗 Swagger php, Swagger UI - документация к API
• ⛑ Phpunit - тестирование.
• 🐋 Docker, Docker compose, Laravel Sail - для локальной разработки.

---

Установка проекта

Для развертывания проекта потребуется установленный 🐳 docker или же 🐋 docker desktop проект будет работать как на Windows с поддержкой WSL2 так и на Linux машине.

Локальная разработка и тестирование проекта использует легковесный Laravel Sail для работы с docker контейнерами.

Настроить переменные окружения (если требуется изменить их):

cp .env.example .env

Установить зависимости проекта:

docker run --rm -u "$(id -u):$(id -g)" \
    -v $(pwd):/var/www/html \
    -w /var/www/html \
    laravelsail/php82-composer:latest \
    composer install --ignore-platform-reqs

на этом подготовка к работе с Laravel Sail закончена.

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

Поднять docker контейнеры с помощью Laravel Sail

./vendor/bin/sail up -d

доступные команды по остановке или пересборке контейнеров можно узнать на странице Laravel Sail или выполните команду ./vendor/bin/sail для получения краткой справки о доступных командах.

1. Сгенерировать application key

   ./vendor/bin/sail artisan key:generate

2. Выполинть миграции и заполинть таблицы тестовыми данными

   ./vendor/bin/sail artisan migrate --seed

3. Собрать фронт

   ./vendor/bin/sail npm install

   ./vendor/bin/sail npm run build

Выполенние тестов

Обычный режим выполнения тестов:

./vendor/bin/sail test

Выполннение тестов в параллельном режиме

./vendor/bin/sail test --parallel

Доступные сайты в dev окружении

Host	Назначение
http://localhost	сайт приложения
http://localhost/api/documentation	Документация на API - swagger-php, swagger UI
http://localhost:8080	Adminer - вэб интерфейс к базе. Логин, пароль и имя базы взять из .env файла
http://localhost:8025	Mailpit - вэб интерфейс для отладки отправки email сообщения