Обзор проекта
Обзор
- Scope
- Laravel-приложение
- Architecture
- Модульная headless-first CMS с опциональным публичным сайтом и модулями витрины
- Runtime
- PHP 8.3+, Laravel 12, Filament 5, Livewire 4, Vite и Tailwind CSS 4
Ключевые понятия
- Module
- Пакет в файловой системе, зарегистрированный через module.json и опционально установленный/активный в таблице modules.
- Active Module
- Установленный модуль, у которого флаг is_active в БД разрешает runtime-интеграцию.
- Cms Frontend Preset
- Пресет CMS_FRONTEND, определяющий feature flags для режимов full, small или headless.
Структура
- Application
- Codeapp/
- Routesroutes/
- Configurationconfig/
- Databasedatabase/
- Extension Model
- Module Sourcesmodules/
- Module Manifestmodules/<ModuleName>/module.json
- Module Database Recordmodules table
- User Interfaces
- AdministrationПанель Filament
- Public SiteFeature-gated маршруты Laravel и Blade/Livewire-представления
- ApiОсновные и модульные API-маршруты
Факты
- Composer объявляет Laravel 12/13, PHP >=8.3 <9.0, Filament 5, Livewire 4, Sanctum, Reverb, Laratrust и uticms/platform. authoritative
- Vite собирает JavaScript и Tailwind CSS; Alpine.js — runtime-зависимость фронтенда. authoritative
- Файлы маршрутов Laravel разделяют web, API, публичную CMS, админку, console, channels и CDN. authoritative
- Feature flags CMS определяются из пресетов CMS_FRONTEND и опциональных переопределений CMS_FEATURE_*. authoritative
- full включает публичные маршруты, Page CMS и резолвинг сайтов; small включает публичные маршруты, но отключает Page CMS и резолвинг сайтов; headless отключает публичные маршруты и включает public CORS. authoritative
Инструкции
Scoped Change
Правила
Architectural rule
Не предполагайте наличие публичных CMS-маршрутов или рендеринга страниц, если соответствующие feature flags CMS не включены.