Filament reference

Panel

AppPanelProvider описывает единственную основную Filament panel.

Ключевые настройки:

path: config('systematika.admin_panel');
login/password reset;
SPA mode;
Vite themes;
discovered resources/pages;
auth middleware;
render hooks для timezone и common JS;
navigation groups;
ReorderableColumns plugin.

Pages

Page	Назначение
`EditProfile`	Профиль пользователя через Jetstream/Fortify forms
`ManageSaleState`	Управление настройкой распродажи через Spatie settings

Admin resources

Resource	Pages	Назначение
`Admin/UserResource`	create, edit, list	Пользователи, роли, permissions, ограничения self-actions
`Admin/RoleResource`	create, edit, list	Роли и набор permissions

Catalog resources

Resource	Pages	Relation managers	Назначение
`Catalog/ProductResource`	create, edit, list	`ProductOfferings`, `SeriesElements`	Главный CRUD продуктов, классификатор, представление, карточка
`Catalog/ProductOfferingResource`	edit, list	`Lessons`, `StatusSections`	Сезоны/offers продукта, actual, dates, status, tariff
`Catalog/TariffResource`	create, edit, list	`Products`, `TariffMovements`	Тарифы, скидки, special/free logic
`Catalog/SeriesResource`	create, edit, list	`SeriesElements`	Серии продуктов
`Catalog/OfferingResource`	create, edit, list	`Elements`	Составные коммерческие предложения

Content catalog resources

Resource	Page	Назначение
`ContentCatalog/CatalogFilterResource`	manage	Настройки фильтров каталога
`ContentCatalog/CatalogSeoPhraseResource`	manage	SEO-фразы для комбинаций фильтров

Content page resources

Resource	Page	Назначение
`ContentPage/BannerResource`	manage	Баннеры, HTML/data modes
`ContentPage/ProductAboutSectionResource`	manage	About-секции страниц продуктов

Dictionary resources

Resource	Pages/relations	Назначение
`Dictionary/BannerTypeResource`	manage	Типы баннеров
`Dictionary/LessonTypeResource`	manage	Типы уроков
`Dictionary/ProductFormatResource`	manage	Форматы продуктов
`Dictionary/ProductGoalResource`	manage	Цели продуктов
`Dictionary/ProductOfferingStatusResource`	create, edit, list, `Movements`	Статусы offering и правила переходов
`Dictionary/ProductPageStatusResource`	manage	Статусы публичных страниц/карточек
`Dictionary/ProductPriceStatusResource`	manage	Статусы цены для фильтра каталога
`Dictionary/ProductTypeResource`	create, edit, list, `ProductSubtypes`	Типы и подтипы продуктов
`Dictionary/TariffTypeResource`	manage	Типы тарифов

Learning resources

Resource	Pages/relations	Назначение
`Learning/GroupDisciplineGkDtoResource`	export-like resource	DTO/export представление для GK catalog
`Learning/GroupDisciplineManySchedulesResource`	create, edit, list, `Schedule`	Group discipline с несколькими расписаниями
`Learning/GroupDisciplineSingleScheduleResource`	create, edit, list	Group discipline с одним расписанием
`Learning/GroupDisciplineResource`	manage, `GroupLesson`	Общая база group disciplines и lessons

Parameters resources

Resource	Pages/relations	Назначение
`Parameters/AcademicYearResource`	create, edit, list, `Weeks`	Академические годы и недели
`Parameters/GradeResource`	manage	Классы/grades
`Parameters/RoomResource`	manage	Кабинеты
`Parameters/TeacherResource`	manage	Преподаватели

Program resources

Resource	Pages/relations	Назначение
`Program/SubjectResource`	create, edit, list, `DifficultyLevels`, `Subsubjects`	Предметы и связанные уровни/подпредметы
`Program/DifficultyLevelResource`	manage levels/topics, `Topics`, `Tmodules`	Уровни сложности, темы и модули
`Program/TopicResource`	manage	Темы программы
`Program/MiniGroupProgramResource`	create, edit, list, `Topics`, `Modules`	Roadmap-программы мини-групп

Site resources

Resource	Page	Назначение
`Site/LandingLayoutResource`	manage	Layout types для proxy pages
`Site/LandingNullPrefixPageResource`	manage	Null-prefix pages
`Site/LandingPageCacheEntryResource`	manage	Cache entries proxy/grabbed pages
`Site/LandingProxyPageResource`	manage	Dynamic routes из БД
`Site/LandingRedirectResource`	manage	Redirect rules

SystemCore resources

Resource	Page	Назначение
`SystemCore/CustomFieldDefinitionResource`	manage	Определения пользовательских полей
`SystemCore/CustomFieldTypeResource`	list	Типы пользовательских полей

Custom Filament components/views

Файл	Назначение
`CustomCheckboxList`	Кастомный список checkbox-ов для permissions/roles
`resources/views/filament/edit-page-only-relation-managers.blade.php`	Edit page только с relation managers
`resources/views/filament/export-modal.blade.php`	Modal export UI
`resources/views/filament/pages/*`	Custom page views/profile/team/api tokens
`resources/views/filament/resources/*`	Custom resource/relation manager views

Как документировать новый resource

При добавлении Filament resource обновить:

Эту страницу.
Filament-админка при изменении ключевых пользовательских сценариев.
Models reference, если появился новый model/resource pair.
Migrations and datamodel, если появилась таблица.

Deep audit summary

Аудит Filament-зоны нашёл:

38 resources;
19 relation managers;
66 page-классов;
основная логика находится в Resource и RelationManager, а большинство Pages являются стандартными List, Create, Edit, Manage wrappers.

Нетривиальная логика по зонам

Администрирование

UserResource:

пароль при создании генерируется автоматически;
пароль кладётся во flash-session для показа после create;
пользователю назначается роль user;
при смене direct permissions сбрасывается Spatie permission cache;
нельзя редактировать себя и пользователей via_gk.

RoleResource:

permissions выбираются карточками через CustomCheckboxList;
при изменении permissions сбрасывается Spatie permission cache;
системные роли super_admin и user защищены от edit/delete.

Параметры

AcademicYearResource:

WeeksRelationManager умеет генерировать недели;
после правки/удаления недели перенумеровываются по датам.

TeacherResource:

преподаватель связан many-to-many с DifficultyLevel;
таблица выводит связки предмет-уровень.

RoomResource:

хранит Zoom email;
хранит mk_id для внешней системы.

Справочники

ProductTypeResource:

поддерживает parent-child типы;
генерирует slug/id;
имеет ProductSubtypesRelationManager.

ProductOfferingStatusResource:

связывает статус сезона с format и page status;
MovementsRelationManager задаёт приоритетные переходы статусов.

BannerTypeResource:

id генерируется из name;
есть close_timeout;
есть url_patterns repeater с regex/disabled флагами.

Программа

SubjectResource:

управляет roadmapConfig;
хранит падежные формы названия;
action fixTree запускает DifficultyLevel::syncSubsForSubjectId.

DifficultyLevelResource:

скрыт из навигации;
отдельная страница ManageTopics показывает темы и модули;
есть фильтры по наличию продуктов и тем.

MiniGroupProgramResource:

уровень сложности зависит от выбранного предмета;
темы можно автозаполнить из учебного TopicModule.

Каталог

ProductResource:

вкладки Основное и Представление;
зависимые селекты: тип-продукта -> подтип, предмет -> подпредмет -> уровень;
цели через relation;
live preview карточки;
FileUpload изображения;
custom fields;
после save dispatch-ит reload-page.

ProductOfferingResource:

скрыт из навигации;
ListProductOfferings::canAccess() возвращает false;
редактирует статус, тариф, академический год, расписание;
уроки и status/about sections редактируются relation managers.

TariffResource:

режим special скрывает обычные ценовые поля;
цены read-only;
скидки и сезонные скидки вынесены отдельным блоком.

SeriesResource:

классификатор по типу, предмету и уровню;
relation manager подбирает продукты по параметрам серии.

OfferingResource:

оффер может включать продукты, серии или виртуальные элементы;
элементы фильтруются через классификатор.

Контент

CatalogSeoPhraseResource:

зависимые селекты subject -> subsubject;
зависимые селекты product_type -> product_subtype;
поддерживает статусы страницы и цены.

BannerResource:

работает либо с raw content, либо с constructor data.*;
набор полей зависит от type_id и via_data;
list page имеет custom view с фильтрацией и export JS для GkBanner.

ProductAboutSectionResource:

классификация по предмету, уровню, типу и статусу сезона;
поддерживает raw HTML и structured builder из трёх секций;
поддерживает placeholder-переменные.

Сайт

LandingNullPrefixPageResource:

to_path автозаполняется как v2/...;
action sync пишет активные маршруты в .htaccess через HTAccessHelper.

LandingProxyPageResource:

выбирает route-layout;
to_path автозаполняется URL старого v1/WordPress;
таблица показывает cache-состояние.

LandingPageCacheEntryResource:

preview cache по route;
удаление cache по записи;
bulk-action dropAllCache чистит resources/views/cache.

Обучение

GroupDisciplineSingleScheduleResource:

фильтрация по текущему учебному году;
track зависит от продукта;
teacher фильтруется по difficultyLevel;
end_date считается от start_date;
embedded schedule генерирует cipher и end_time.

GroupDisciplineManySchedulesResource:

похож на single schedule, но расписания вынесены в ScheduleRelationManager.

GroupDisciplineGkDtoResource:

read-only список активных групп курсов за последние 7 дней;
export action собирает window.COURSES_CATALOG JSON.

Relation managers with side effects

Relation manager	Side effect / важная логика
`WeeksRelationManager`	Авторасчёт `end_date`, генерация недель, перенумерация после edit/delete
`MovementsRelationManager`	Приоритетные rule-based переходы статусов
`TariffMovementsRelationManager`	Приоритетные rule-based переходы тарифов
`DifficultyLevelsRelationManager`	Top/sub levels, roadmap flags, переход в `ManageTopics`
`TmodulesRelationManager`	Массово обновляет `topic_module_id` у тем
`TopicsRelationManager`	Фильтр по модулю или “без модуля”, reorder внутри модуля
`ModulesRelationManager`	Связь roadmap-модулей с учебными модулями
`ProductOfferingsRelationManager`	Создаёт сезон и редиректит в `EditProductOffering`
`LessonsRelationManager`	Треки, недели, типы занятий, темы, цели, custom fields
`StatusSectionsRelationManager`	Подбирает секции “О продукте” по каскаду точности
`SeriesElementsRelationManager`	Собирает серии из продуктов с классификацией и reorder
`ElementsRelationManager`	Собирает офферы из продуктов, серий и виртуальных элементов
`GroupLessonRelationManager`	Генерирует занятия группы через helper-функции
`ScheduleRelationManager`	Фильтрует teacher по уровню продукта, `end_time` ставит плюс 1 час

Panel​

Pages​

Admin resources​

Catalog resources​

Content catalog resources​

Content page resources​

Dictionary resources​

Learning resources​

Parameters resources​

Program resources​

Site resources​

SystemCore resources​

Custom Filament components/views​

Как документировать новый resource​

Deep audit summary​

Нетривиальная логика по зонам​

Администрирование​

Параметры​

Справочники​

Программа​

Каталог​

Контент​

Сайт​

Обучение​

Relation managers with side effects​