Product Catalog - Laravel + Vue.js

Веб-приложение каталога товаров с административной панелью для управления товарами.

Технологический стек

• Backend: Laravel 10+ (RESTful API)
• Frontend: Vue.js 3 (Composition API) + InertiaJS + Tailwind CSS
• Database: PostgreSQL
• Infrastructure: Docker Compose

Функциональность

Публичная часть

• Просмотр списка товаров с пагинацией
• Фильтрация товаров по категориям
• Просмотр детальной информации о товаре

Административная часть

• Аутентификация через Laravel Sanctum
• CRUD операции для товаров
• Управление товарами через веб-интерфейс

Установка и запуск

Требования

• Docker и Docker Compose
• Git

Шаги установки

1. Клонируйте репозиторий:

git clone <repository-url>
cd catalog-products

2. Запустите Docker контейнеры:

docker-compose up -d

3. Установите зависимости Laravel:

docker-compose exec app composer install

4. Установите зависимости фронтенда:

docker-compose exec app npm install

5. Скопируйте файл окружения:

docker-compose exec app cp .env.example .env

6. Сгенерируйте ключ приложения:

docker-compose exec app php artisan key:generate

7. Запустите миграции и сидеры:

docker-compose exec app php artisan migrate --seed

8. Соберите фронтенд:

docker-compose exec app npm run build

9. Приложение будет доступно по адресу: http://localhost:8000

Учетные данные администратора

• Email: admin@example.com
• Пароль: password

API Endpoints

Публичные (без аутентификации)

• GET /api/products - Список товаров с пагинацией
• GET /api/products/{id} - Просмотр товара
• GET /api/categories - Список категорий

Защищенные (требуется аутентификация)

• POST /api/login - Вход в систему
• POST /api/products - Создание товара
• PUT /api/products/{id} - Обновление товара
• DELETE /api/products/{id} - Удаление товара

Структура проекта

catalog-products/
├── backend/              # Laravel приложение
│   ├── app/
│   │   ├── Http/
│   │   │   ├── Controllers/Api/
│   │   │   ├── Requests/
│   │   │   └── Resources/
│   │   └── Models/
│   ├── database/
│   │   ├── migrations/
│   │   └── seeders/
│   └── resources/
│       ├── js/
│       │   ├── Pages/
│       │   ├── Components/
│       │   └── Composables/
│       └── css/
├── docker-compose.yml
├── Dockerfile
└── nginx.conf

Разработка

Запуск в режиме разработки

1. Запустите сборку фронтенда в режиме watch:

docker-compose exec app npm run dev

2. Для работы с базой данных используйте:

docker-compose exec app php artisan migrate
docker-compose exec app php artisan db:seed

Тестирование

Запуск тестов:

docker-compose exec app php artisan test