Документация systematika-laravel-site

Это документация для человека, который впервые открывает проект и должен понять, как он реально работает.

Что это за проект

systematika-laravel-site — Laravel 12 приложение для сайта Systematika, публичного каталога, дорожной карты программ, прокси-страниц поверх старого WordPress/v1 сайта и Filament-админки.

Главная особенность: проект гибридный. Не все страницы создаются обычными Laravel routes. Часть routes регистрируется провайдерами, часть создаётся из БД, часть UI вставляется в HTML старого сайта.

Быстрый путь чтения

1. Документация проекта
2. Обзор архитектуры
3. Потоки запросов и границы системы
4. Полное покрытие кода
5. Домен: современный каталог
6. Домен: roadmap / program
7. Filament-админка
8. Models reference
9. Filament reference
10. Livewire reference
11. Database reference
12. Карта рисков и неочевидных мест

Главные выводы аудита

• Базовая БД создаётся через database/initial_schema.mysql, а не только миграциями.
• Routes проекта распределены между routes/*, providers и таблицей landing_proxy_pages.
• Публичный frontend — это Blade + Livewire + JS history API + legacy WordPress/v1 layout.
• Каталог строится из URL-slug state, CatalogFilter, Product, ProductOffering, ProductCard, ProductPage и SEO-фраз.
• Roadmap строится через subject/level/mode/variant, selector builders и default slug helpers.
• Админка управляется Filament resources и содержит важную бизнес-логику на уровне форм.
• Queue worker и Laravel scheduler обязательны для page cache, статусов и тарифов.
• Есть места повышенного внимания: глобальный gk_uhash auto-login, DB redirects, debug endpoints, дефолтные API secrets.

Что добавлено для полного покрытия

• Полный справочник моделей.
• Полный справочник Filament resources/pages/relation managers по группам.
• Полный справочник Livewire components/views.
• Полный справочник helpers, casts, traits, types.
• Полный справочник config/env.
• Полный справочник commands.
• Полный справочник views/assets.
• Полный database reference.
• Полный domains reference.
• Полный индекс файлов по группам.
• How-to сценарии для добавления данных.

Где что лежит

Раздел	Для чего
Архитектура	Понять систему целиком
Домены	Понять каталог, roadmap, proxy pages и баннеры
Backend и API	Понять Laravel routes, providers, models, jobs, security config
Frontend и админка	Понять Livewire, public UI и Filament
How-to сценарии	Пошагово менять данные и контент
Эксплуатация	Запуск, поддержка, queue, cron, troubleshooting
Справочная база	Полное reference-покрытие кода
Риски и безопасность	Ловушки, production checklist, audit notes