Домен: roadmap / program

Roadmap — это публичная дорожная карта учебных программ. По умолчанию она находится на /program.

Главная задача roadmap: провести пользователя от предмета и уровня сложности к конкретной программе, модулям и темам.

Основные файлы

Зона	Файлы
Route registration	app/Providers/Frontend/ModernRoadmapProvider.php
Controller	app/Http/Controllers/ModernRoadmapController.php
State	app/Domains/ModernRoadmap/State.php
Storage/cache	app/Domains/ModernRoadmap/Storage.php
Defaults	app/Domains/ModernRoadmap/DefaultSlugHelper.php
Step availability	app/Domains/ModernRoadmap/PageAvailableHelper.php
Selectors	app/Domains/ModernRoadmap/SelectorBuilders/*
Module builders	app/Domains/ModernRoadmap/Builders/*
Livewire shell	app/Livewire/ModernRoadmap/UnauthorizedRoadmapSpa.php
Main view	resources/views/pages/modern-roadmap.blade.php
Component views	resources/views/livewire/modern-roadmap/*
Program models	app/Models/Education/Program/*
Roadmap configs	app/Models/Landing/Roadmap/Config/*
Mini-group roadmap	app/Models/Landing/Roadmap/MiniGroup/*

URL-структура

Roadmap routes:

/program
/program/{subject_slug}
/program/{subject_slug}/{level_slug}
/program/{subject_slug}/{level_slug}/{mode}
/program/{subject_slug}/{level_slug}/{mode}/{mode_variant}

Шаги:

1. subject_slug — предмет.
2. level_slug — уровень сложности.
3. mode — режим отображения программы.
4. mode_variant — вариант режима, например трек.

State

State — это расширенная коллекция с фиксированными ключами:

• selectedSubject;
• selectedDifficultyLevel;
• selectedMode;
• selectedModeVariant.

State умеет выбирать каждый следующий уровень. Если передан _, он подставляет дефолтное или первое доступное значение через DefaultSlugHelper.

Пример логики:

• выбрать предмет;
• если level не указан, выбрать дефолтный level;
• если mode не указан, выбрать первый mode;
• если mode variant не указан, выбрать первый variant.

Storage

Storage — локальный cache вокруг selector builders. Он не хранит данные между запросами глобально, но предотвращает повторную сборку одинаковых selector-ов внутри одного state lifecycle.

Storage отдаёт:

• subjects;
• difficulty levels для выбранного subject;
• modes для выбранного subject + level;
• mode variants для выбранного subject + level + mode.

Defaults

DefaultSlugHelper выбирает дефолты:

• subject с roadmapConfig.unauthorized_roadmap_default = true и hidden = false, иначе первый не скрытый subject;
• level с roadmapConfig.unauthorized_roadmap_default = true и hidden = false внутри subject, иначе первый не скрытый level;
• первый доступный mode;
• первый доступный mode variant.

Практический вывод: если /program редиректит не туда, проверяйте roadmap config у subject/level.

Доступность промежуточных страниц

PageAvailableHelper решает, показывать ли страницу выбора subject/level/mode/variant.

Сейчас флаги $enabled в helper-методах выставлены в false. Поэтому логика обычно схлопывает промежуточные страницы и редиректит пользователя на дефолтный путь.

Это важная продуктовая особенность: отсутствие страницы выбора может быть не багом routing, а текущей настройкой helper-а.

Modes и builders

ModulesResolver выбирает стратегию по mode:

Mode	Builder
default	DefaultBuildStrategy
mini-groups	MiniGroupsBuildStrategy
courses	CoursesBuildStrategy

Если subject, level или mode не выбраны, resolver возвращает пустой массив.

Если mode требует variant, но variant отсутствует, resolver тоже возвращает пустой массив.

Предметная модель roadmap

Основные модели:

Модель	Что означает
Subject	Предмет, например математика
Subsubject	Подпредмет
DifficultyLevel	Уровень сложности/класс/уровень программы
TopicModule	Модуль тем
Topic	Тема
MiniGroupProgram	Программа мини-группы для subject + level + track
MiniGroupModule	Модуль внутри программы мини-группы
MiniGroupModuleTopic	Pivot между модулем и темой с позицией
SubjectRoadmapConfig	Настройки subject для roadmap
DifficultyLevelRoadmapConfig	Настройки level для roadmap

Subject

Subject:

• хранит name, cipher, slug, position, label_forms;
• сортируется глобальным scope по position;
• при создании автоматически создаёт roadmapConfig;
• при удалении удаляет roadmapConfig;
• связан с Subsubject, DifficultyLevel, темами через deep relation.

DifficultyLevel

DifficultyLevel:

• принадлежит subject;
• связан с grades;
• связан с products;
• связан с topics и topic modules;
• связан с mini-group programs;
• при создании создаёт roadmap config;
• при сохранении синхронизирует дерево top/sub levels по subject.

Важная логика: syncSubsForSubjectId() и findSubs() строят связи difficulty_levels_tree между top-level и sub-level уровнями по пересечению grades.

MiniGroupProgram

MiniGroupProgram задаёт программу для:

• subject;
• difficulty level;
• track.

Computed name строится как предмет, уровень, N трек.

Через relations можно получить modules, topics и pivot-записи тем.

Как добавить программу в roadmap

Минимальный порядок:

1. Убедиться, что есть Subject со slug.
2. Убедиться, что есть DifficultyLevel для этого subject со slug.
3. Проверить roadmapConfig: не скрыты ли subject/level.
4. Для mini-groups создать MiniGroupProgram с subject, level и track.
5. Добавить modules через relation manager.
6. Добавить topics и позиции.
7. Проверить, что selector builder возвращает нужный mode и variant.
8. Открыть /program/{subject}/{level}/{mode}/{variant}.

Типичные причины пустой roadmap

• Subject скрыт в roadmap config.
• Difficulty level скрыт в roadmap config.
• Для выбранного subject/level нет modes.
• Для mode mini-groups или courses нет variant.
• Для выбранного variant нет modules.
• Темы не связаны с modules.
• URL содержит slug, которого нет в subjects или difficulty_levels.
• Промежуточная страница недоступна и controller редиректит на default path.

Админские точки управления

Что менять	Где
Предметы	SubjectResource
Уровни сложности	DifficultyLevelResource или relation manager subject
Темы	TopicResource
Модули тем	relation managers уровня/программы
Программы мини-групп	MiniGroupProgramResource
Roadmap config subject	SubjectResource
Roadmap config level	DifficultyLevelResource