~ / проекты / game-marketplace

Game Services Marketplace_

Магазин, который продаёт сразу четыре вида цифровых товаров: игровые ключи, аккаунты, валюту и услуги прокачки, и у каждого своя логика выдачи. Витрина на Next.js и API на Laravel с админкой живут в одном репозитории, но выкатываются отдельно; оплата, выдача и оповещения идут через очереди.

Next.js 16.1 React 19 Laravel 12 API Filament Admin 5.2 Elasticsearch 9.3 PostgreSQL 16 Redis 7 & Horizon
4 вида цифровых товаров
98 тестов, 0 отказов
16 слушателей очереди
3 шага догоняющих оповещений

// архитектура

Развязанный монорепозиторий: витрина и бэкенд (API и админка) лежат в одном репозитории, но живут отдельными кодовыми базами и деплоятся независимо. Общаются строгим REST API, делят одну базу PostgreSQL 16 и поисковый индекс Elasticsearch 9.3.

$ cat architecture.txt
Браузер покупателя
│
Caddy Reverse Proxy
┌──────────────┴──────────────┐
Next.js Frontend Laravel 12 API / Admin
(App Router, SSR/ISR) (Filament, Queues, Jobs)
│ │
│ ├─ Redis 7 (Cache, Queues)
│ ├─ Elasticsearch 9.3 (Search)
└──────────────┬──────────────┘
▼
PostgreSQL 16
Развязанный монорепозиторий

Жёсткое разделение ролей: Next.js отвечает за представление и SEO, Laravel и Filament — за базу, очереди и администрирование

Событийные сценарии

Критичные сценарии — платежи, выдача аккаунтов, оповещения — идут асинхронно на событиях Laravel и очередях Horizon: 8 событий и 16 слушателей

Полнотекстовый Elasticsearch

Быстрый поиск по каталогу: ReindexProductJob индексирует на лету, индексы подменяются пакетно без простоя

Раздельные гарды входа

Сессии покупателя (вход по одноразовому коду, гард web) отделены от сессий администратора (Filament, гард admin)

Динамические поля заказа

Конструктор форм: товар сам запрашивает нужные поля покупателя — сервер, ник, — набор настраивается в админке

Мультивалютность

Несколько валют покупателя, курсы обновляются задачей по расписанию

// ключевые возможности

01. Каталог и настройка товара

  • ▶ Иерархия категорий, группы товаров, атрибуты и опции
  • ▶ Дополнения к товару: трансляция процесса, срочная выдача
  • ▶ Полиморфные SEO-таблицы: теги, мета-поля и описания цепляются к любой сущности

02. Оформление и оплата

  • ▶ Корзина живёт в базе, мультивалютная, синхронизируется с клиентом
  • ▶ Промокоды с проверкой категорий, срока и лимита на покупателя
  • ▶ Единая модель транзакций: создана → завершена или отклонена
  • ▶ Проверка подписи входящих вебхуков платёжного шлюза

03. Автоматика брошенных корзин

  • ▶ Напоминания шлёт команда по расписанию под распределённой блокировкой Cache::lock
  • ▶ Три ступени напоминаний с паузой в сутки между ними
  • ▶ Постоянный расход памяти на больших таблицах за счёт курсоров базы

04. Маркетинг и аналитика маржи

  • ▶ Учёт источников переходов и опрос при оформлении
  • ▶ Асинхронные слушатели шлют события в GA, PostHog и Метрику
  • ▶ Учёт себестоимости и маржи: чистая отдача считается против затрат
// app/Console/Commands/SendAbandonedCartEmailsCommand.php
$lock = Cache::lock('carts:send-abandoned-emails', 300);
try {
$lock->block(0);
// разбираем брошенные корзины...
} finally {
$lock->release();
}

// качество и devops

Контроль качества в CI/CD

$ npm run test:run && composer test
✓ ESLint & Prettier ........ успешно
✓ Vitest (Front) ........... 53 теста, 0 ошибок
✓ PHPUnit (Back) ........... 45 тестов, 0 ошибок

Инфраструктура и деплой

  • ▶ Плейбуки Ansible поднимают серверы: Node, PHP, PostgreSQL, Redis, Caddy
  • ▶ Обратный прокси Caddy сам выпускает wildcard-сертификаты
  • ▶ Релиз собирается рядом и подключается атомарной подменой симлинка
  • ▶ Фоновые очереди Horizon работают под systemd

// стек

Бэкенд
Laravel 12 (PHP 8.4)
Админка Filament 5.2
Horizon и воркеры очередей
Laravel Pint / PHPUnit
Фронтенд
Next.js 16.1 (App Router)
React 19
TypeScript 5.9
Bootstrap 5.3 (Sass)
Данные и поиск
Elasticsearch 9.3
PostgreSQL 16
Redis 7
Динамические мета-поля
DevOps и логи
Настройка серверов Ansible
Прокси Caddy (авто-TLS)
GitHub Actions CI/CD
Аналитика PostHog и GA
$ project-stats --summary
50+ компонентов Next.js
37 моделей Eloquent
24 контроллера API
82 миграции базы
16 слушателей очереди