План развития связанных курсов Codex и Laravel

Проверено: 23 июля 2026 года.

Цель

Превратить курс Codex и курс Laravel в связанную образовательную систему для читателя без опыта программирования.

Ученик должен пройти путь от понимания терминов и безопасной работы с файлами до небольшого приложения на Laravel, уметь поставить задачу Codex, проверить изменения и сохранить результат в Git.

Принципы

1. Материал идёт от простого к сложному.
2. В начале каждой страницы объясняется её польза.
3. После короткого объяснения следует безопасная практика.
4. Технические термины имеют подсказку и ссылку на словарь.
5. Обычные слова вроде Windows, браузер и веб-интерфейс не размечаются.
6. Английское написание сохраняется только для точного имени команды, настройки, программы или общепринятого термина.
7. Внутренние учебные ссылки находятся в основном тексте, внешние источники — после навигации «Назад / Дальше».
8. Codex объясняет управление помощником, Git и безопасность; Laravel объясняет создание веб-приложения.
9. Каждый законченный этап имеет наблюдаемый результат и критерий проверки.
10. Сгенерированные файлы не редактируются вместо их настоящих источников.

Приоритет 1. Единый маршрут обучения

• [x] Создать в курсе Codex страницу перехода к Laravel.
• [x] Создать в Laravel раздел «С нуля».
• [x] Обновить главные страницы обоих сайтов.
• [x] Добавить переключатель между курсами в верхнюю навигацию.
• [x] Добавить двусторонние ссылки между конкретными уроками.
• [x] Сохранить сложные спецификации Laravel как отдельный справочный уровень.

Маршрут ученика

1. Что такое Codex и чем он может помочь.
2. Первый безопасный сеанс без изменения файлов.
3. Зачем нужен Git и как увидеть правки.
4. Как работает веб-сайт.
5. Что такое PHP, Laravel и фреймворк.
6. Подготовка учебного проекта.
7. Первая страница и маршрут.
8. Первая модель, миграция и данные.
9. Проверка изменений и тест.
10. Итоговый проект и самостоятельное объяснение результата.

Приоритет 2. Laravel для начинающих

Создать последовательные страницы:

• [x] /start/ — карта курса;
• [x] /start/why-laravel — зачем нужны PHP, Laravel и фреймворк;
• [x] /start/how-web-works — запрос, сервер, маршрут и ответ;
• [x] /start/environment — терминал, Composer, Artisan, .env и секреты;
• [x] /start/first-project — открытие проекта и первая точка Git;
• [x] /start/project-structure — главные папки без лишних деталей;
• [x] /start/first-page — маршрут, контроллер и шаблон;
• [x] /start/data — база, модель и миграция;
• [x] /start/codex-practice — безопасные промпты для каждого этапа;
• [x] /start/final-project — приложение «Мои задачи»;
• [x] /start/assessment — вопросы для самопроверки.

Для каждой страницы:

• [x] указать пользу, уровень, время и необходимые знания;
• [x] дать действие на 5–15 минут;
• [x] объяснить ожидаемый результат;
• [x] добавить критерий завершения;
• [x] связать предыдущий и следующий урок;
• [x] дать точечную ссылку в курс Codex.

Приоритет 3. Термины и простой язык

• [x] Создать общий словарь Laravel.
• [x] Перенести механизм автоматических подсказок с Codex-сайта.
• [x] Поднять словарь в результатах локального поиска.
• [x] Поддержать подсказки при наведении и фокусе с клавиатуры.
• [x] Проверять неизвестные и сломанные конструкции терминов при сборке.
• [x] Добавить русские варианты поиска и распространённые синонимы.
• [x] Не размечать текст внутри команд, кода, ссылок и технических имён.

Ответственность словарей

Словарь Codex:

• промпт;
• CLI и терминал;
• Git, ветка, коммит и сравнение;
• песочница и подтверждение;
• облачный Codex;
• автоматизация, навык, плагин и MCP.

Словарь Laravel:

• PHP и фреймворк;
• Composer и Artisan;
• маршрут и контроллер;
• шаблон Blade;
• база данных, модель и Eloquent;
• миграция и сидер;
• middleware;
• очередь и задача;
• пакет и зависимость;
• тест, публикация и рабочая среда.

Приоритет 4. Двусторонние связи

Тема	Страница Codex	Страница Laravel
Общий маршрут	/courses/laravel.html	/start/
Первый запуск	/start/first-session.html	/start/first-project
Git	/workflows/git-basics.html	/start/first-project
Промпты	/workflows/prompting.html	/start/codex-practice
Секреты и права	/cli/security.html	/start/environment
Проверка	/workflows/code-review.html	/start/final-project
Термины	/reference/glossary.html	/reference/glossary
Laravel-справочник	/practices/laravel.html	/specs/README

Дополнительно:

• [x] показывать «Что изучить перед этим»;
• [x] показывать «Где это понадобится дальше»;
• [x] не вести новичка на главную другого сайта вместо нужного абзаца;
• [x] отличать переход в другой курс значком и понятным текстом.

Приоритет 5. Единая учебная подача

• [x] Добавить общий компонент «Зачем эта страница».
• [x] Использовать точные описания из метаданных для ключевых уроков.
• [x] Для справочных страниц формировать уместное объяснение по разделу.
• [x] Добавить уровни: «Основа», «Первая практика», «Продолжение», «Углубление», «Справочник».
• [x] Добавить примерное время чтения или выполнения.
• [x] Добавить короткие задания и критерии завершения.
• [x] Сделать таблицы читаемыми на узких экранах.
• [x] Не перегружать страницу декоративными блоками.

Приоритет 6. Поиск и навигация

• [x] Добавить «С нуля», «Словарь» и «Codex» в главное меню Laravel.
• [x] Сделать маршрут новичка первым пунктом боковой навигации.
• [x] Повысить вес страницы словаря в поиске Laravel.
• [x] Добавить в переходные страницы ключевые слова соседнего курса.
• [x] Добавить подсказку, где искать термин другого курса.
• [x] Удалить или исправить ссылки на отсутствующие разделы.

Будущее улучшение после основной публикации:

• [ ] единый поисковый индекс двух сайтов;
• [ ] предложения с другого курса при отсутствии локальных результатов;
• [ ] обезличенный отчёт о запросах без результатов.

Приоритет 7. Внешние источники

• [x] Перенести блок внешних источников Laravel после навигации.
• [x] Не смешивать внешние источники с учебными переходами.
• [x] Добавить значок внешней ссылки.
• [x] Сохранять даты проверки изменяемых фактов.
• [x] Для Codex использовать официальную документацию OpenAI.
• [x] Для Laravel учитывать версию фреймворка и официальный источник этой версии.

Приоритет 8. Автоматические проверки

Codex:

• [x] Проверка неизвестных идентификаторов терминов.
• [x] Проверка сломанного старого разделителя |.
• [x] Проверка наличия блока пользы на учебных страницах.
• [x] Проверка внутренних и межкурсовых ссылок.

Laravel:

• [x] Проверка неизвестных терминов.
• [x] Проверка внутренних ссылок по всем разделам.
• [x] Проверка существования ключевых межкурсовых маршрутов.
• [x] Проверка обязательных учебных метаданных страниц /start/.
• [x] Проверка сырой разметки [[term:....
• [x] VitePress-сборка без мёртвых ссылок.

Оба сайта:

• [x] проверить итоговый список изменённых файлов;
• [x] убедиться в отсутствии секретов, журналов и временных копий;
• [x] визуально проверить главную, словарь, учебный маршрут и таблицы;
• [x] проверить клавиатурный фокус и мобильную ширину.

Приоритет 9. Сборка и публикация

• [x] Выполнить штатную сборку Codex.
• [x] Выполнить штатную сборку Laravel через pnpm.
• [x] Исправить противоречивые команды npm/pnpm в Laravel README.
• [x] Опубликовать собранный Codex-сайт.
• [x] Опубликовать собранный Laravel-сайт.
• [x] Проверить главные страницы и новые маршруты по публичным адресам.
• [x] Проверить двусторонние ссылки после публикации.

Приоритет 10. Завершение и история

• [x] Просмотреть итоговые изменения Codex.
• [x] Просмотреть итоговые изменения Laravel.
• [x] Создать отдельный коммит Codex.
• [x] Создать отдельный коммит Laravel.
• [x] Записать фактически выполненные проверки.
• [x] Отдельно перечислить то, что осталось непроверенным.

История Git

По явному разрешению пользователя для Codex и Laravel созданы два независимых Git-репозитория с основной веткой main. Начальные снимки записаны от технического автора Codex <codex@localhost>. Удалённые репозитории не подключались, отправка изменений на внешний сервер не выполнялась.

Что осталось для следующего цикла

• единый поисковый индекс двух доменов вместо переходных поисковых страниц;
• решение о допустимости обезличенной статистики запросов без результатов;
• редакторский проход по углублённым справочникам из отчёта англицизмов;
• уменьшение крупного клиентского файла словаря, если его размер станет заметен на медленных устройствах.

Критерий готовности первой версии

Работа завершена, когда:

1. новичок может начать с главной страницы любого сайта и найти первый урок;
2. все страницы Laravel получают понятное объяснение пользы;
3. основные технические слова Laravel имеют подсказки и страницу словаря;
4. два курса связаны точечными двусторонними ссылками;
5. ученик может пройти сквозной проект «Мои задачи»;
6. сырая разметка терминов и мёртвые обязательные ссылки блокируют сборку;
7. обе сборки проходят;
8. опубликованные маршруты открываются;
9. итоговые изменения зафиксированы в истории Git либо документирована объективная причина, почему коммит в текущем каталоге невозможен.