Документация LIK-Learn

Школьные предметы и подготовка к экзаменам на модульной платформе

Документация LIK-Learn

Модульная образовательная платформа. LEGO, а не IKEA.

Философия

"Разберись в чём угодно, когда угодно, в удобном тебе порядке"

Не «пройди курс до конца», а «пойми тему».

Платформа про школу: биология, история, обществознание, функциональная грамотность. Впереди ВПР, устное собеседование, ОГЭ и ЕГЭ. Из этого следует главное требование ко всему содержимому, планка строгости.

Быстрая навигация

Начало работы

Философия проекта зачем платформа устроена так
Быстрый старт запусти и собери первый концепт
Структура контента концепты, треки, пути

Методология

Обязательна перед созданием любого учебного материала:

Планка строгости тиры ставок, достоверность, семь паттернов халтуры, гейт
Мета-навыки что именно развиваем и чем это подтверждено
Как составлять уроки арка урока, дробление темы
Как формулировать вопросы выбор атома, баланс вариантов

Компоненты

Каталог атомов все механики с привязкой к мета-навыкам
Механики таймер, жизни, прогресс, сюжет
Сценарии ветвящиеся и линейные
API программный интерфейс

Справка

Контракты компонентов обязательные правила
Фронтматтер концепта поля и их смысл
Шорткоды разметка урока
Стилизация переменные и темы

Что такое LIK-Learn

МАТЕРИАЛ (текст и графика) + АТОМЫ (проверка) + МЕХАНИКИ (рамка)
= урок, который чему-то учит

Ключевые принципы

#	Принцип	Реализация
1	Свобода входа	любой концепт доступен сразу, без прелюдий
2	Нет принуждения	треки и пути рекомендуют, а не запирают
3	Интерактив, который учит	атом ставится тогда, когда выполняет учебную работу
4	Достоверность	тиры ставок, метки факт, источник, спорно
5	Модульность	атомы и механики комбинируются свободно
6	Без обязательного бэкенда	статика плюс localStorage
7	Расширяемость	свой концепт добавляется файлом

Структура контента

Три уровня организации

ПУТЬ (Path)
  Большое путешествие. Треки плюс отдельные концепты. 5+ часов.
  Пример: "Сентябрьский старт"

ТРЕК (Track)
  Группа связанных концептов одной темы. 1-3 часа.
  Пример: "Школа наблюдения"

КОНЦЕПТ (Concept)
  Атомарная единица знаний. Одна тема, одна страница. 5-20 минут.
  Пример: "Опричнина"

Музыкальная метафора

Наше	Музыка	Масштаб
Концепт	Песня	5-20 мин
Трек	Альбом	1-3 часа
Путь	Тур	5+ часов

Компоненты

Атомы

Полный список из 46 атомов с колонкой «когда НЕ брать» лежит в каталоге и генерируется из data/atoms.yaml. Прозаические списки атомов в доках заводить запрещено: они разъезжаются с кодом. Несколько для ориентира:

Атом	Shortcode	Что делает
quiz-question	`quiz` + `option`	выбрать верный вариант
flashcard	`flashcard`	карточка вопрос и ответ
fill-blank	`fill-blank`	заполнить пропуск
true-false	`true-false`	верно или неверно
match-pair	`match-pair`	соединить пары
text-select	`text-select`	выделить в тексте нужное

Имя атома и имя шорткода совпадают не всегда: атом quiz-question вставляется шорткодом quiz. Атомы без выделенного шорткода вставляются через {{< atom type="имя" >}}.

Визуальный слой

Типографика и графика урока: dropcap, illustration, claim, marginalia, compare, chronicle, breather. Это не украшение, а структура рассуждения. Метки достоверности ставит claim.

Механики

Механика	Shortcode	Когда использовать
timer	`with-timer`	тренировка скорости
hp-bar	`with-hp`	повышение ставок
progress	`with-progress`	визуализация движения
narrative	`with-narrative`	сюжетное обучение

Принцип LEGO

Атом не знает, что он внутри таймера
Таймер не знает, что внутри него quiz
Связь идёт через события

Технологии

Технология	Назначение
Hugo	статическая генерация
Vanilla JS	интерактивные компоненты
localStorage	локальный прогресс и повторение

Начни сейчас

Прочитай философию Philosophy
Прочитай планку строгости Rigor
Запусти локально Quick Start
Собери первый концепт Структура контента