~ / проекты / beauty-directories

Beauty Directories_

Одна команда ведёт несколько независимых справочников: клиники красоты, косметологи, косметические средства. Вместо отдельного кода на каждый сайт всех обслуживает одна платформа: администратор открывает новый справочник на своём домене, настраивает поля каталога без разработчика, а посетитель получает мгновенные фильтры.

Laravel 12 PHP 8.4 MoonShine 4.x Vue 3 (Composition) TypeScript 5.8 PostgreSQL 16 Redis 7 & Horizon
1 кодовая база на все сайты
123 теста, 0 отказов
9 уровень Larastan
87 миграций

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

Развязанный монорепозиторий на упрощённом DDD: доменные контексты и слои бизнес-логики разделены, база остаётся гибкой, а код — поддерживаемым.

$ cat architecture.txt
Браузер
│
Caddy / Nginx Reverse Proxy
(HTTP 301 www -> non-www)
│
Laravel 12 Multi-Site Engine
┌───────────────────┴───────────────────┐
Public Web Routing MoonShine 4.x Admin Panel
(Alpine.js & Blade Views) (Site & Language Management)
│ │
Vue 3 Catalog SPA │
(Pinia Filter Store) │
│ │
API endpoints │
(/api/catalog/items) │
└───────────────────┬───────────────────┘
Domain Services
(SiteResolver, SlugResolver, etc.)
│
Eloquent Models & DB Migrations
│
PostgreSQL 16
▲
│
Redis 7 / Horizon
(Asynchronous Jobs)
▲
│
Telegram Logger Bot
(Real-time Error Tracking)
Разделение по DDD

Чёткая граница между Domain (сущности и правила), Application (сервисы и логика) и Infrastructure (обёртки HTTP)

Middleware мультисайта

SiteResolver берёт хост запроса, приводит домен к канону, грузит настройки и кеширует контекст сайта на 4 часа

Единый диспетчер слагов

Полиморфное разрешение адресов без зашитых префиксов: цель находится за O(1)

// динамический каталог

Чтобы база не раздувалась от клиник, врачей и товаров, схема сделана гибридом EAV: индексируемость поиска и свобода структуры вместе.

Нормализованные фильтры

Значения лежат в обычных таблицах — быстрые индексы и join-ы

Колонки JSONB

Текст и медиа-метаданные, по которым не ищут, уходят в JSONB и не раздувают таблицы

Шифрованные настройки

Чувствительные поля вроде ключей API с меткой is_secret шифруются на уровне базы

// реактивные фильтры на клиенте

Рендер сделан гибридом SSR и SPA: страница индексируется поисковиком и при этом листается без перезагрузок.

// Жизненный цикл гибридного каталога
Шаг 1
Первая отрисовка через Blade SSR
Сервер отдаёт готовый HTML, мета-теги, разметку Schema.org и первую страницу выдачи — для индексации
Шаг 2
Гидратация Vue
Компонент монтируется на data-vue="catalog-view" и забирает начальное состояние стора из data-атрибутов
Шаг 3
SPA перехватывает управление
Vue прячет серверную пагинацию и ведёт поиск, фильтры, бесконечную прокрутку и историю переходов
Стор на Pinia

Стор держит параметры поиска, кеширует выдачу и собирает динамические запросы

Отмена через AbortController

Гонок запросов не случается: при быстрой смене фильтров активные вызовы отменяются

Каскадные гео-фильтры

Смена региона сразу пересобирает список городов и пересчитывает число совпадений

Скелетоны под цвет сайта

Анимация свечения подхватывает основной цвет конкретного сайта из настроек

// SEO-движок и локализация

Откат перевода по цепочке

Используется Spatie Translatable и свой трейт HasSiteFallbackTranslations. Если перевода в нужной локали нет, значение берётся по цепочке: язык страницы → локаль сайта по умолчанию → глобальная локаль → первое заполненное поле.

Слеш в конце адреса

Маршруты строятся через localizedRoute(), который всегда ставит слеш в конце. Это убирает дубли страниц и спор о каноническом адресе.

Префикс локали

Язык сайта по умолчанию живёт в чистом пути (/contacts), остальные локали получают свой код (/uk/contacts).

Фиды и IndexNow

Карты сайта, robots.txt и RSS собираются на лету для каждого домена. Об изменениях поисковик узнаёт сразу через IndexNowController.

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

Покрытие тестами

$ php artisan test
✓ Larastan Level 9 .... успешно
✓ Rector PHP 8.4 ..... успешно
✓ PHPUnit 11 tests ..... 123 теста, 0 ошибок

Деплой без простоя через Envoy

$ envoy run deploy
✓ Автокоммит и push в git
✓ Fetch и hard reset на сервере по SSH
✓ Зависимости Composer и NPM
✓ Оптимизация и прогрев кешей
✓ Сборка продакшен-ассетов

Телеметрия и оповещения

  • ▶ Полный сбор исключений в Sentry
  • ▶ Свой Telegram-бот транслирует поток оповещений
  • ▶ Разведение по каналам: ошибки в errors, бэкапы в notifications

Формат кода

  • ▶ Laravel Pint держит форматирование по PSR-12
  • ▶ ESLint и Prettier проверяют Vue 3 и TypeScript
  • ▶ Строгий статический анализ на правилах Larastan v3

// стек

Бэкенд
Laravel 12, PHP 8.4
Админка MoonShine 4.x
Horizon и воркеры очередей
Larastan / Rector / Pint
Фронтенд
Vue 3 (Composition)
TypeScript 5.8
Стор Pinia
Alpine.js, Tailwind v4
Данные и кеш
PostgreSQL 16
SQLite (для разработки)
Redis 7
Гибрид EAV для значений
DevOps и оповещения
Деплой через Laravel Envoy
Оповещения в Telegram
Мониторинг Sentry
Интеграция с IndexNow
$ project-stats --summary
280+ доменных классов
32 контроллера
25 компонентов Vue
87 миграций базы
123 теста PHPUnit