Перейти к основному содержимому

Онбординг и процесс разработки

Что нужно понять в первый день​

  1. Routes живут не только в routes/web.php.
  2. Часть routes создаётся из БД.
  3. База стартует из SQL dump.
  4. Публичный frontend гибридный: Laravel + Livewire + old WordPress/v1 HTML.
  5. Админка — Filament, а не отдельный custom backend UI.
  6. Очереди и cron обязательны для нормальной работы.

Локальный запуск проекта​

Обычно нужны:

composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate
npm run dev
php artisan serve
php artisan queue:listen --tries=1

В проекте есть shortcut:

composer dev

Он параллельно запускает server, queue, logs и Vite.

База данных​

Для полноценного локального окружения нужен MySQL. Хотя Laravel config может иметь sqlite default, предметная схема проекта рассчитана на MySQL и SQL dump.

Порядок:

  1. Настроить MySQL env.
  2. Проверить LOCAL_COMPUTER, если используете local host/port overrides.
  3. Запустить migrations.
  4. Убедиться, что dump применился.
  5. При необходимости выполнить seeders для product pages/cards.

Создание пользователя​

Команда:

php artisan make:user email@example.com password

Назначить admin role:

php artisan permission:make-admin email@example.com

Сменить пароль:

php artisan app:set-password email@example.com new-password

Важно: роль admin может быть недостаточна для входа в Filament, если User::canAccessPanel() проверяет конкретный permission.

Как подходить к задаче​

Если меняете каталог​

  1. Прочитать документацию Домен: современный каталог.
  2. Найти, меняется state, query или UI.
  3. Проверить CatalogFilter и CatalogSeoPhrase.
  4. Проверить Product, ProductOffering, ProductCard, ProductPage.
  5. Проверить прямой URL и Livewire filter flow.

Если меняете roadmap​

  1. Прочитать Домен: roadmap / program.
  2. Проверить subject/level config.
  3. Проверить selector builders.
  4. Проверить нужный mode builder.
  5. Проверить redirect/default slug behavior.

Если меняете proxy pages​

  1. Проверить LandingProxyPage.
  2. Проверить layout type.
  3. Проверить source to_path.
  4. Проверить page cache.
  5. Проверить queue worker.
  6. Проверить redirects.

Если меняете админку​

  1. Найти Resource.
  2. Проверить form schema.
  3. Проверить table schema.
  4. Проверить relation managers.
  5. Проверить model events.
  6. Проверить policies/permissions.

Команды качества​

Типичный набор:

composer test
npm run build
npm audit

Для документации:

cd apps/docs
npm run build
npm run start -- --host 127.0.0.1 --port 3103 --no-open

Что не делать вслепую​

  • Не менять actual у product offerings массовым SQL без понимания side effects.
  • Не удалять записи landing_proxy_pages, не проверив публичные routes.
  • Не менять catalog_filters, не проверив URL/SEO каталога.
  • Не отключать queue/cron в production.
  • Не оставлять дефолтные API_KEY/WP_HOOK_KEY.
  • Не считать database/old_migrations текущим источником схемы.