~ / проекты / histogames

HistoGames_

Одна и та же игра в каждом магазине стоит по-своему, и скидки не совпадают никогда. Агрегатор следит за ценами в Steam, PlayStation Store, Epic Games Store и GOG, сопоставляет одну игру между витринами, сообщает о падении цены и сам публикует скидки в соцсетях.

Golang Next.js 15 React 19 Laravel 12 PostgreSQL Elasticsearch Prisma 6 OpenAI
5 микросервисов на Go
4 магазина игр
7 юнитов systemd
3 конвейера CI/CD

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

Полиглотная микросервисная связка: монорепозиторий на Go для бэкенда (парсинг, API, поиск, уведомления), Next.js для фронтенда с SSR, Laravel для админки. Каждая технология стоит там, где она сильнее.

$ cat services.yml
Next.js 15 (SSR)
│ REST
┌─────┴─────────────────────┐
API Parser Elastic
(Gin) (Asynq) (Sync)
│ │
Notify Poster
(Email/Push) (Telegram)
└─────┬─────────────────────┘
PostgreSQL · Redis · Elasticsearch
Сервис API

REST-сервер на Gin с кешем в Redis, ограничением частоты и слоями Handler → Service → Repository

Демон-парсер

Четыре скрапера магазинов, очереди Asynq с пятью приоритетами, chromedp для SPA-страниц

Синхронизация Elastic

Мультиязычные индексы и региональные цены, переиндексация по расписанию

Сервис уведомлений

Оповещения о падении цены письмом через Mailgun и веб-пушами

Сервис публикаций

Автопостинг скидок в Telegram-каналы и соцсети

Общие пакеты

Модели GORM, конфиг, логгер, клиенты базы и Elasticsearch — общие для всех сервисов

// парсинг и сопоставление через ИИ

Цены собираются из четырёх магазинов задачами с приоритетами. Сопоставление через ИИ связывает одну и ту же игру в разных витринах.

Steam
REST API
PlayStation
chromedp (SPA)
Epic Games
GraphQL API
GOG
REST API
$ asynq stats --queues
critical
P1
default
P2
parsing
P3
ratings
P4
low
P5
// internal/matcher/ai.go
type Matcher struct {
openai *openai.Client
repo CandidateRepository
}
func (m *Matcher) Match(ctx context.Context, game *Game) ([]Candidate, error) {
// сопоставление игр между платформами через ИИ
// возвращает кандидатов на ручную проверку
}

// фронтенд и UX

01. Next.js 15 + React 19

  • ▶ App Router с SSR и SSG ради индексации
  • ▶ ORM Prisma 6 поверх PostgreSQL
  • ▶ Turbopack для быстрой сборки в разработке
  • ▶ Валидация всех входов через Zod v4

02. Аккаунты и личные функции

  • ▶ NextAuth.js v5 (JWT и вход через Google, Facebook, Apple)
  • ▶ Список желаемого с оповещением по порогу цены
  • ▶ Ограничение частоты в Redis по скользящему окну

03. Визуализация цен

  • ▶ Графики истории цен (Chart.js)
  • ▶ Анимации на Framer Motion
  • ▶ Доступные компоненты Headless UI

04. Локализация и региональные цены

  • ▶ Локали приходят из API
  • ▶ Региональные цены с привязкой к валюте
  • ▶ Язык в адресе (/[locale]/...)

// качество и инфраструктура

Тесты

$ make test-all
✓ go test ......... сервисы, репозитории
✓ vitest .......... юниты фронтенда
✓ playwright ...... сценарии E2E
✓ lighthouse CI ... 80/80/75/80
✓ PHPUnit 11 ..... админка

CI/CD (3 конвейера)

$ gh workflow list
● deploy-backend .. 5 бинарников Go и проверки здоровья
● deploy-front .... сборка Next.js и симлинк
● deploy-console .. админка на Laravel
Автооткат при провале проверки здоровья (бинарник .prev)

Безопасность

  • ▶ Ограничение частоты: скользящее окно в Redis
  • ▶ bcrypt (12 раундов), вход через OAuth
  • ▶ Файрвол UFW: открыты только 22, 80, 443
  • ▶ fail2ban, автоматический SSL через Caddy

Инфраструктура

  • ▶ 7 юнитов systemd под управлением Makefile
  • ▶ Плейбуки Ansible для развёртывания
  • ▶ Автобэкапы PostgreSQL по cron
  • ▶ Метрики Prometheus, логи slog и pino

// стек

Бэкенд (Go)
Golang 1.24, Gin
GORM, Asynq, gocron
chromedp, GoQuery
Prometheus, slog
Фронтенд
Next.js 15, React 19
TypeScript, Prisma 6
Tailwind CSS 4
Chart.js, Framer Motion
Админка
Laravel 12, PHP 8.2+
Filament 3.3
spatie/translatable
Laravel Pint
Интеграции
OpenAI API
RAWG API
Telegram-бот
Mailgun, PostHog
$ tree --depth 1
├── backend/ # Монорепозиторий на Go — 5 микросервисов
├── front/ # Next.js 15 (App Router, Prisma, SSR)
├── console/ # Laravel 12 (админка на Filament)
├── deploy/ # Ansible, скрипты, конфиги systemd
├── .github/ # 3 воркфлоу CI/CD
└── Makefile # Команды управления проектом