Parvoz Edu — математика, логика и шахматы

Веб-платформа для долгосрочного развития математического, логического, алгоритмического и научного мышления ребёнка. При первом запуске Лаборатория спрашивает имя ребёнка и дальше обращается к нему по имени: имя подставляется и в задачи, где ребёнок — герой. Она построена по мастер-промпту программы: ежедневные занятия на 20–30 минут, 6–10 разных задач, лестница подсказок, ответы для родителя отдельно, еженедельное наблюдение без ярлыков.

Qisqacha (oʻzbekcha). Bu — bolalar uchun matematika, mantiq va algoritmik fikrlashni rivojlantiruvchi veb-platforma. Birinchi kirishda bolaning ismi soʻraladi va masalalar qahramoni shu bola boʻladi. Platforma ikki tilda: rus va oʻzbek tillarida (tilni yuqoridagi RU / UZ tugmasi bilan almashtirish mumkin). Oʻzbekcha matnlar soʻzma-soʻz tarjima emas — bolaga tushunarli, jonli tilda qayta yozilgan. Har kuni 20–30 daqiqalik mashgʻulot: 5 bosqichli maslahat, javobni tekshirish va interaktiv robot. Har bir kunni chop etish mumkin. 6 darajali shaxmat maktabi (piyoda, ot, fil, rux, farzin, shoh), endshpil maktabi, tahlil taxtasi, shaxmat sirlari va afsonalari — ularning bir qismini diktor oʻqib beradi. Ota-ona boʻlimi PIN-kod bilan yopilgan. Natijalar shu brauzerda saqlanadi; xohlasangiz, Google yoki Telegram orqali kirib, natijalarni barcha qurilmalarda sinxronlash mumkin.

Возможности

Для ребёнка

• Три недели по 7 дней, в каждой — 55 задач и мини-исследование. Разминка, логика, закономерности, алгоритмы, пространство, математика вокруг нас, задача со звёздочкой.

  • Неделя 1 «Неделя открытий» — привычки мыслителя: замечать, искать правило, проверять, перебирать по порядку, думать шагами, искать другой способ, исследовать.
  • Неделя 2 «Неделя инструментов» — стратегии для трудных задач: нарисуй, иди с конца, начни с малого, пробуй и улучшай, найди то, что не меняется, вспомни похожую задачу. В седьмой день — выбор инструмента и исследование числовой стенки.
  • Неделя 3 «Неделя логики» — как рассуждать точно: «если…, то…», правда и ложь (рыцари и лжецы), круги Эйлера, взвешивания, доказательства, шифры. В седьмой день — игра с роботом, шахматный конь и исследование «Гири и весы».

• Пять уровней сложности (🟢 🟡 🟠 🔴 ⭐), и сложность растёт к концу недели.

• Подсказки открываются по одной, с паузой на размышление: перечитай условие → что известно → нарисуй или запиши → реши задачу поменьше → идея. Готовый ответ ребёнок не видит.

• Проверка ответа без слова «неправильно»: «Давай проверим твою идею», «Какая часть точно верная?».

• Интерактивные инструменты:

  • робот-программист: составление, чтение и отладка программ, поиск всех кратчайших путей, сбор звёзд;
  • симметрия и разрезание квадрата;
  • карта дорог для поиска самого быстрого пути;
  • волшебный квадрат и волшебный треугольник-лаборатория;
  • сломанный калькулятор;
  • таблицы для логических задач;
  • исполнители с командами (Удвоитель, Кузнечик на числовом луче);
  • ханойская башня с тренировкой на 1–4 кольцах и таблицей рекордов;
  • переправа через реку (волк, коза и капуста);
  • переливания двумя вёдрами;
  • мини-судоку 4 × 4;
  • числовая стенка-лаборатория для исследования;
  • круги Эйлера: разложить числа по областям;
  • весы-детектив: найти фальшивую монету (весы «хитрые» — удача не поможет, нужен план);
  • обмен соседних карточек;
  • игра «Последний камешек» против робота;
  • шифровальная таблица Цезаря;
  • лаборатория гирь: какие грузы можно уравновесить.

• Шахматная школа — шесть уровней-званий: Пешка → Конь → Слон → Ладья → Ферзь → Король (по-узбекски piyoda, ot, fil, rux, farzin, shoh). На каждом уровне — урок с интерактивной доской, правила, словарик, интересные факты и упражнения: найти клетку, отметить все ходы фигуры, собрать звёздочки за наименьшее число ходов, найти вилку и мат в один ход, расставить ферзей. Все упражнения решены — звание получено, и открывается следующий уровень. Каждый уровень ведёт дальше: к игре, задачам, дебютам и знаменитым партиям своей сложности.

  • Играть: робот пяти уровней (от «Пешки», которая ходит почти наугад, до «Ферзя», считающего на четыре хода), партия вдвоём на одном экране, пешечный бой, тренировка мата ферзём, ладьёй и двумя ладьями. Подсказка, отмена хода, список ходов в русской записи, определение мата, пата, ничьей.
  • Задачи: 19 тем — мат в 1, 2 и 3 хода, мат по последней линии, спёртый мат, бесплатная фигура, вилка, связка, сквозной удар, открытый и двойной шах, превращение, пешечный эндшпиль, пойманная фигура, убери защитника, отвлечение, завлечение, защита, «мат, а не пат». В каждой теме сначала задачи школы с объяснениями (их 33), потом — задачи из открытой базы Lichess (CC0): 4 950 популярных задач рейтинга 400–1900, не длиннее трёх своих ходов. В задаче из базы сначала ходит соперник, решение может быть в несколько ходов, любой мат засчитывается.
  • Задачи по силам: скрытый рейтинг по формулам Глико — начинается по возрасту, растёт за задачи, решённые с первой попытки. Ребёнку до 10 лет показываются только звёзды, число видят старшие и родители. Сложность можно выбрать: полегче, по силам, потруднее. Панель «получается лучше всего / над чем поработать» по темам и кнопка «исправить ошибки».
  • Дебюты: пять правил дебюта и 18 дебютов с идеями, историей и тренажёром: ребёнок повторяет ходы за белых или чёрных, компьютер отвечает по книге.
  • Знаменитые партии: 8 партий от дурацкого мата до «Партии века» Фишера — разбор ход за ходом с комментариями для ребёнка, автопросмотр, диаграммы главных моментов, портреты игроков и фотографии мест, где играли.
  • Энциклопедия: путь шахмат от Индии через Персию, Самарканд и Багдад в Европу, фигурки с Афрасиаба, Беруни и Тимур, чемпионы мира и чемпионки, шахматы в Узбекистане, имена фигур на трёх языках, рекорды, шахматы и математика. Полсотни картин и фотографий: фигурки с Афрасиаба, персидские миниатюры, портреты всех чемпионов мира — со свободными лицензиями и указанием авторов.
  • Разбор партий: после каждой партии с роботом или вдвоём робот-тренер оценивает каждую позицию, считает точность в процентах, находит лучшие ходы, неточности, ошибки и зевки и объясняет их простыми словами («фигура встала под удар: соперник возьмёт ферзя ходом Кxh4»). График «кто был ближе к победе», стрелка лучшего хода, главные моменты.

• Задание дня, опыт и серия — на главной и в шахматной школе: три дела на сегодня (задачи тренажёра, задача по математике, партия или упражнение) и «звезда дня», когда всё сделано; уровень по опыту (опыт считается из уже решённого, поэтому одинаков на всех устройствах; он не зависит от подсказок). Детям до 10 лет вместо номера уровня и XP показываем имя уровня (Росточек, Фонарик, Компас… Корона), с 10 лет — число и «+10 XP ⭐»; серия дней подряд, где один пропуск в неделю прощается, и цель недели — 5 дней с занятиями.

• После решения — вопросы «А ещё подумай» и отметки «объяснил», «нашёл другой способ», «понравилась», «было трудно».

• Итоги дня: самая интересная задача, самая трудная задача, настроение, новая «привычка мыслителя».

• «Мои задачи» — задачник, куда ребёнок записывает задачи, которые придумал сам.

• Возраст ребёнка — при первом запуске ребёнок выбирает возраст (6–15), изменить его можно в настройках родителя. Младшим (6–8) всё по порядку; средним (9–10) открыты три уровня шахмат, робот «Конь», задача дня от двух звёзд, лёгкие задания дня помечены как разминка; старшим (11+) открыты все уровни, робот «Слон», задача дня от трёх звёзд, разделы «для тех, кто постарше» раскрыты сразу.

• Тайны шахмат — 32 истории с вопросом-крючком: учёные Хорезма и Бухары (аль-Хорезми, Беруни, Ибн Сина), «Шахнаме», халифы Багдада, задача Дилярам, «Турок», путешествие коня, «бешеная королева» — с играми внутри (зёрна на доске, загадка посла, тур коня) и загадками про фигуры.

  • Вторая книга «Тайн и легенд» (17 историй): Каисса, «Мораль шахмат» Франклина, большие шахматы Тимура, Абдусатторов, Самарканд-2026, эксперимент Полгаров, клуб Веры Менчик, Капабланка, Таль, Ласкер, Каспаров и Deep Blue, AlphaZero, «Каспаров против мира», шахматы в космосе, фигуры с острова Льюис, «шахматы Карла Великого» (легенда, не выдержавшая проверки), шахматы вслепую. Факты проверены по источникам (docs/chess-stories-sources.md).
  • Мысли великих (19 цитат с источником и пометкой надёжности: из книги автора / по цитате в другом источнике / «приписывают, источника не нашли»), 8 разговоров (придуманных, но на настоящих фактах и цитатах) и «Новый взгляд»: 10 «многие думают — а на самом деле», включая честную карточку «шахматы делают умнее?» (доказательств пока нет). Всё на русском и узбекском. У каждого шахматного уровня — легенда и «тайна уровня», на главной странице школы — «Знаешь ли ты?».

• Живая птица Парвоз и награды. Птица реагирует на ответы (верно — радуется, «подумаем ещё» — мягко наклоняет голову, без тряски и грусти), «+N XP ⭐» взлетает, за новый уровень и хороший итог дня или «Быстрых примеров» — салют. Пока нет файлов Rive/Lottie, рисуется запасной вариант из логотипа и CSS; когда файлы появятся, их включает один флаг (src/lib/anim/assets.ts, правила — docs/animations.md). Уважает «уменьшить движение» в системе и настройку родителя «Анимации»; WASM-движки отдаются с нашего домена, не с CDN.

• Тактика (/chess/tactics): восемь тем — вилка, связка, сквозной удар, открытый шах, мат разными фигурами (слон, пешка, ферзь с опорой, превращение) быстрые маты в дебюте (детский мат, мат дурака), защита от шаха (взять, закрыться, уйти) и особые правила (взятие на проходе, пат, ничьи). В каждой короткий урок (3–4 шага с доской и стрелками), упражнения «найди ход» на настоящей доске и вопросы с выбором ответа; RU и UZ. Позиции придуманы для школы и проверены движком: src/lib/tactics.ts независимо находит все ходы, подходящие под приём, а tests/tactics.test.ts сверяет с ними ответы упражнений.

• Контрольные тесты (/chess/tests): три теста по двенадцать вопросов без подсказок — фигуры и ходы, шах/мат/пат, тактика. Балл даётся за ответ с первой попытки (ошибаться можно, правильный ответ всё равно нужно найти), итог — баллы и до трёх звёзд (10+ из 12 — три). Позиции тестов 2 и 3 — зеркальные отражения позиций из школы и тактики, все ответы проверены движком (tests/chess.test.ts).

• Два языка: русский и узбекский. Переключатель RU / UZ — в шапке сайта и в приветственном окне; выбор хранится на устройстве. Узбекский текст — не подстрочник: задачи, уроки, истории и подсказки написаны заново живым языком (правила — docs/uzbek-style.md). Задачи, завязанные на русский алфавит (шифры, «буква — номер», карты с буквами), пересобраны на узбекском алфавите с теми же числовыми ответами. Шахматные ходы по-узбекски записываются фигурками: ♘f3, ♕xf7#.

• Несколько детей на одном устройстве — родитель в настройках («Дети на этом устройстве») заводит профили: у каждого своё имя, возраст, аватарка (🐣🦊🐼…), прогресс, медали и серия. Когда профилей больше одного, в шапке появляется кнопка с картинкой — ребёнок выбирает себя сам. У первого профиля запись прежняя (davlatjon-lab:v1), у остальных — davlatjon-lab:v1:<id>; список — davlatjon-lab:profiles (src/lib/profiles.ts). При входе в аккаунт прогресс каждого профиля сохраняется отдельно (/api/progress?profile=<id>, запись «аккаунт#профиль»); итоги недели в Telegram приходят по каждому профилю с его аватаркой. Список профилей на другом устройстве нужно завести заново.

• Птичка Парвоз и вводный тест. Талисман (птичка с логотипа) встречает в приветствии, хвалит в итогах дня и зовёт отдохнуть. Кнопка «Показать родителям» открывает системное окно «Поделиться» (без имени ребёнка). Ребёнку от 8 лет, который ещё ничего не решал, на главной предлагается короткий вводный тест из шести задач (src/lib/placement.ts): начать стоит с недели, где что-то оказалось новым. Все недели остаются открытыми.

• Быстрые примеры (/quick) — десять вопросов подряд, ответ нажатием на крупный вариант; вопросы собираются на лету (src/lib/quick.ts, чистый генератор с seed, проверяется тестами). Две колоды: «числа» (сложение, вычитание, пропущенное число, знаки сравнения, ряды, таблица умножения и деление; три уровня по возрасту) и «картинки» для 4–5 лет (сосчитай, где больше, продолжи узор, найди лишнее) — вопросы без слов. Серия с 7 верными из 10 даёт 5 XP, раз в день на колоду; дни серий идут в календарь занятий и в серию дней. Возраст в настройках теперь от 4 лет; для 4–5 лет вместо занятий по неделям на главной — «Играть». Озвучки для малышей пока нет (записи диктора нужно заказать отдельно).

• Коллекция героев (/chess/collection) — 23 карточки: мудрецы Востока и 18 чемпионов мира с портретами и подписями; открываются сами, по одной за каждые 30 XP (src/lib/collection.ts); новая карточка — плашка со ссылкой.

• Рейтинг (/leaderboard) — общая таблица для вошедших в аккаунт: очки за неделю (с понедельника по Ташкенту) и за всё время, по направлениям (всего, математика, шахматы, шахматные задачи, быстрый счёт) и возрастным группам (4–6, 7–9, 10+), плюс «кто в чём силён» — тройка лучших в каждом направлении. Участие — только с разрешения родителя (выключатель в «Для взрослых» → Настройки, для каждого ребёнка отдельно; нужны вход и имя в игре). Видны лишь имя в игре, аватарка, уровень и очки: настоящего имени и возраста нет. Очки считает сервер по сохранённому прогрессу (xpBreakdown в src/lib/xp.ts), а не по числам от клиента; таблица lab_scores, API GET /api/play/leaderboard. Выключили участие или удалили аккаунт — запись исчезает сразу.

• Шахматы по сети с друзьями (/chess/online) — после входа в аккаунт ребёнок выбирает придуманное имя в игре (не настоящее), ищет друзей по имени, дружит и играет партии на расстоянии: часы (без часов, 5, 10, 15+10 минут), сдача, ничья, отмена в начале, «сыграть ещё»; рядом — переписка с другом; в списке друзей видна серия дней с занятиями 🔥 (одно число, POST /api/play/streak). Каждый ход проверяет сервер (src/lib/online.ts, chess.js), время у ушедшего игрока выходит само. Безопасность: играть и писать можно только с друзьями; в сообщениях нет ссылок, телефонов, почты и грубых слов; у родителя в настройках три выключателя — игра по сети, переписка и «меня можно найти по имени»; можно заблокировать. Нужны вход (Google или Telegram) и база Neon — см. docs/online-play.md.

• Вид доски и звук ходов — ребёнок (в «🎨 Моя доска и звук» на странице «Играть») или родитель (настройки) выбирает цвета доски (дерево, зелёная, морская, фиалка, ягодная; src/lib/boardLook.ts) и набор звуков: «Деревянные» — записанные звуки хода, взятия, рокировки, превращения, шаха и неверного хода (public/audio/sfx, сделаны ElevenLabs Sound Effects, играют через Web Audio с лёгкой вариацией высоты) или «Мягкие» — синтезированные. Выбор хранится на устройстве и не синхронизируется.

• Озвучка — только записи диктора ElevenLabs (все записи — модель Eleven v4, язык задаётся явно): условия всех задач по математике, карточки уроков шахматной школы, вопросы и ответы «Знаешь ли ты?», приветствие, легенды шести уровней, 32 истории «Тайн и легенд» и похвала — на обоих языках (по-русски — один голос «Anna Zub – Warm Multilingual Voice» во всех записях, public/audio; по-узбекски — голос «Uzbekcha», public/audio/uz). Кнопка «🔊 Прочитать» есть только там, где есть запись на языке интерфейса; голос браузера не используется. Оглавление записей src/content/voice-clips.json хранит отпечаток озвученного текста: изменился текст задачи или урока — тест voice.test.ts напомнит перезаписать клип; после записи оглавление обновляется командой WRITE_VOICE_MANIFEST=1 npx vitest run tests/voice.test.ts. Озвучку можно выключить в настройках родителя.

• Голос после ответа зависит от ситуации (src/lib/voice.ts — CUES, src/lib/feedback.ts — retryCue/praiseCue): в задачах по математике и логике после неверной проверки диктор говорит ту же мысль, что написана на экране («проверь на маленьком примере», «перечитай условие», «часть ответа сходится», «почти — проверь вычисления» для числа рядом с верным), на третьей, шестой… попытке предлагает подсказку или взрослого; похвала — за усилие, а не «ты умный» («с первого раза — внимательность», «получилось — упорство», «помогла подсказка — тоже сила»). Шахматные реплики («посмотри, кто кого атакует», «поищи шах, взятие или угрозу», «король под шахом», «фигура связана») звучат только в шахматах, в том числе при невозможном ходе. Звонкие реплики записаны моделью v4 (ru — Anna Zub, uz — «Uzbekcha»). Короткие записи есть и для вопросов «быстрых примеров» (малышам 4–5 лет вопрос читается сам), шагов знакомства, итога дня и «передохнём?»; условия всех шахматных упражнений озвучены кнопкой «Послушать» (public/audio/exercises, отпечатки текстов в voice-clips.json).

• Звуки доски — ход, взятие, рокировка, превращение, шах и «так нельзя» синтезируются прямо в браузере (Web Audio, без файлов), работают без интернета и выключаются отдельно от озвучки.

• Школа эндшпиля (/chess/endgames): король и пешка против короля — правило квадрата, оппозиция, ключевые поля, задачи на единственный ход и игра с роботом, который знает эти позиции наизусть (точная таблица всех 200 тысяч позиций строится в браузере за доли секунды).

• Доска анализа (/chess/analysis): ходи за обе стороны, возвращайся и пробуй другие ходы, вставь FEN или PGN; робот-подсказчик показывает оценку, шкалу преимущества и стрелку лучшего хода. Из разбора партии любую позицию можно открыть на доске анализа.

• Аккаунт (по желанию): вход через Google или Telegram, чтобы прогресс был на всех устройствах. Без входа всё работает, как раньше. Прогресс двух устройств сливается без потерь: решённое остаётся решённым, рекорды — наибольшие.

• Без интернета — открытые хотя бы раз страницы, картинки и файлы сборки сохраняются, и платформа работает офлайн (service worker public/sw.js).

Печать

• Каждый день печатается на A4:
  • лист заданий для ребёнка без ответов, с клетчатым местом для решения;
  • отдельный лист «Ответы для родителя» с объяснениями и подсказками по порядку;
  • вариант «Всё вместе»: сначала задания, потом ответы на новых страницах.
• Можно напечатать всю неделю сразу. В окне печати можно выбрать «Сохранить как PDF».

Для родителя (раздел закрыт PIN-кодом)

• Ответы, объяснения, темы для обсуждения и все пять подсказок к каждой задаче.
• Как решал ребёнок: сколько подсказок открыл, сколько раз проверял, сколько времени ушло, какие отметки поставил.
• Отметки наблюдений («решил сам», «объяснил вслух», «проверил себя»…) и заметки к задачам и дням.
• Недельный обзор из 10 вопросов. Платформа сама собирает по ним факты, а родитель дописывает наблюдения.
• Шахматы: звание ребёнка, партии с роботом по уровням, задачи по темам, выученные дебюты, разобранные партии, дневник и ответы к каждому упражнению и задаче (ходы — в русской записи: Лa8#, Кf6+).
• Итоги недели (/parent/report): дни с занятиями, активные минуты по дням (считаются по тому, что ребёнок реально делает на сайте, а не по открытой вкладке), решённое по математике и шахматам, медиана времени на задачу, подсказки как хорошая привычка. Без процентов и рейтингов; тихая неделя описана спокойно. Отчёт можно распечатать.
• Время и приглашения: родитель выбирает, сколько активных минут в день достаточно (20–90). Ребёнок не видит таймера: доделав начатое, он видит спокойную карточку «На сегодня хватит!» (сразу при открытии сайта, при переходе на другую страницу или после завершённого дела). Продлить можно PIN-кодом на самой карточке или в разделе родителя. «Приглашение на неделю» (3–7 дней) ребёнок видит как заполняющиеся точки, без сроков и «пропущено».
• Итоги в Telegram (по желанию): раз в неделю бот присылает короткие итоги без имени ребёнка; нужен вход через Telegram и переменная CRON_SECRET (docs/login-setup.md).
• Методичка: принципы, система подсказок, фразы вместо «неправильно», долгосрочный путь, как помогать в шахматной школе.
• Настройки: язык, аккаунт (Google или Telegram), возраст ребёнка, пауза между подсказками, крупный текст, открыть все уровни шахматной школы, сохранение и загрузка прогресса файлом, смена PIN-кода, сброс прогресса.

Приватность

• По умолчанию прогресс хранится только в localStorage браузера. Перенести его на другое устройство можно через «Настройки → Сохранить в файл».
• Аккаунт необязателен. Если родитель вошёл через Google или Telegram, прогресс дополнительно хранится в таблице lab_progress в базе Postgres на Neon; строка подключения есть только у сервера сайта, таблицу он создаёт сам. Как подключить вход — docs/login-setup.md. Пока переменные окружения не заданы, кнопок входа нет.
• Сайт закрыт от поисковиков (robots.txt, X-Robots-Tag: noindex), кроме двух страниц для родителей: /about («О платформе») и /privacy (какие данные где хранятся). Контакт для вопросов о данных — переменная NEXT_PUBLIC_CONTACT (необязательно), адрес сайта — APP_URL.
• Родитель может удалить данные аккаунта (прогресс всех профилей, имя в игре, друзья, партии, переписка) кнопкой в «Настройки → Аккаунт»: DELETE /api/account.
• Ограничение времени — тоже мягкая защита: тот, кто умеет очищать данные сайта, её обойдёт.
• PIN-код — мягкая защита, чтобы ребёнок случайно не увидел ответы. Это не система безопасности, но подбор замедлен (три неверных попытки подряд — пауза), меню родителя скрыто до ввода PIN-кода, а сброс забытого PIN-кода открывается только через сутки после запроса.
• Русский текст для ребёнка не определяет его пол (tests/ru-gender.test.ts), а младшему возрасту уровни и опыт показываются без чисел. Разбор интерфейса и план улучшений — docs/ui-ux-audit.md.

Разработка

Стек: Next.js 16 (App Router, статическая генерация), React 19, TypeScript, Tailwind CSS 4, Vitest, Playwright. Шахматы: chess.js (правила на доске, BSD-2-Clause), react-chessboard (доска, MIT) и собственный движок в src/lib/engine (генератор ходов 0x88, альфа-бета с перебором взятий, решатель «мат в N ходов») — он играет за робота и проверяет задачи.

npm install
npm run dev          # http://localhost:3000
npm run check        # ESLint + TypeScript + тесты + Prettier
npm run test         # проверка контента и ответов
npm run test:e2e     # сквозные тесты в браузере (собирает и запускает сайт)
npm run build        # production-сборка

Для test:e2e без установленных браузеров Playwright укажите свой Chromium: PLAYWRIGHT_CHROMIUM_PATH=/путь/к/chrome. Чтобы проверить уже запущенный сайт, задайте E2E_BASE_URL=http://localhost:3000.

Структура

src/
  content/           контент программы (данные, без кода отображения)
    types.ts         схема: день, задача, иллюстрации, способы ответа
    meta.ts          разделы дня, уровни, лестница подсказок
    week1/ … week3/  задачи недель 1–3 (day1..7.ts и index.ts)
    chess/           шахматная школа: 6 уровней (pawn.ts … king.ts), задачи (puzzles.ts), дебюты
                     (openings.ts), знаменитые партии (games.ts), энциклопедия (encyclopedia.ts),
                     картинки: подписи (images.ts) и манифест с авторами и лицензиями (images.json)
    review.ts        10 вопросов недельного обзора
    guide.ts         методичка для родителя
    program.ts       список недель и вспомогательные функции
    *.uz.ts, chess/uz/  узбекская версия: накладки на русский контент (только тексты; ответы, позиции
                     и id берутся из оригинала — см. localize.ts и docs/uzbek-style.md)
    uz.ts            сборка узбекских дней и недель на сервере
    chess/endgames.ts  школа эндшпиля: уроки и задания (позиции проверяет таблица KPK)
  lib/               логика: робот (BFS), фигуры, развёртки куба, кратчайший путь,
                     калькулятор, волшебный треугольник, исполнитель, ханойская башня,
                     переправа, переливания, судоку, числовая стенка, круги Эйлера, весы,
                     игра с камешками, шифр Цезаря, гири, росчерк, шахматы (chess.ts, play.ts),
                     шахматный движок (engine/), проверка ответов, прогресс
  lib/lang.ts, i18n.ts  языки: пары t("…", "…"), запись ходов фигурками, выбор языка
  lib/engine/kpk.ts  точная таблица «король и пешка против короля» (ретроградный анализ)
  lib/sync.ts, server/  аккаунт: слияние прогресса двух устройств, вход через Google и Telegram, хранилище
  lib/leaderboard.ts                  рейтинг: недели, возрастные группы, направления (чистая логика)
  lib/online.ts, server/playStore.ts  игра по сети: правила партии и часов, имена, друзья, переписка
  components/        интерфейс: занятие, иллюстрации, задачи-инструменты, шахматы, печать, раздел родителя
  app/               страницы (Next.js App Router); app/api — вход в аккаунт, прогресс, игра по сети (/api/play)
docs/                uzbek-style.md — как писать по-узбекски; login-setup.md — как подключить вход; online-play.md — игра по сети
public/images/chess/ уменьшенные картинки энциклопедии (webp) — см. «Картинки и лицензии»
scripts/             fetch-chess-images.mjs — загрузка картинок с Wikimedia Commons;
                     build-puzzles.mjs — банк задач из базы Lichess (public/puzzles, src/content/chess/puzzle-bank.json)
tests/               Vitest: структура контента, правила инструментов и перебором — правильность
                     каждого ответа (answers.test.ts — неделя 1, answers-week2.test.ts, answers-week3.test.ts,
                     chess.test.ts — шахматная школа, chess-content.test.ts — задачи, дебюты, партии,
                     engine.test.ts — движок: perft и сверка с chess.js,
                     analysis.test.ts — разбор партии, фора, часы, тренажёр координат,
                     bundle2.test.ts — повторение, шторм, награды, календарь, PGN, voice.test.ts — озвучка,
                     chess-images.test.ts — картинки: файлы, лицензии, подписи, ссылки из контента,
                     puzzle-bank.test.ts — банк задач Lichess: законность каждой задачи, маты — своим движком,
                     скрытый рейтинг, подбор задач, «Дятел»; gamification.test.ts — опыт, задание дня, мягкая серия,
                     сертификат, короны, тренажёры; activity.test.ts, report.test.ts, weekly-reports.test.ts — активное время и ограничение, итоги недели, рассылка в Telegram)
e2e/                 Playwright: главные сценарии на компьютере и телефоне; puzzles.spec.ts — задачи из базы,
                     уровень и сложность, «Дятел»; uzbek.spec.ts — все страницы
                     на узбекском без единой русской буквы, переключение языка, эндшпиль, доска анализа;
                     gamification.spec.ts — задание дня, сертификат, короны, тренажёры;
                     parent-time.spec.ts — итоги недели, дневное ограничение и карточка отдыха, приглашение на неделю;
                     ux.spec.ts — замок родителя, выход из партии, режим «Сам», мягкая проверка;
                     no-hscroll.spec.ts — на телефоне нет горизонтальной прокрутки

Как добавить новую неделю

1. Создайте src/content/week4/day1.ts … day7.ts по образцу недель 1–3 (типы подскажет TypeScript).
2. Соберите неделю в src/content/week4/index.ts и добавьте её в массив WEEKS в src/content/program.ts.
3. Добавьте проверку ответов новых задач в tests/answers-week4.test.ts и запустите npm run check.

Страницы, печать и раздел родителя для новой недели появятся автоматически.

Картинки и лицензии

Все фотографии и картины шахматной энциклопедии берутся с Wikimedia Commons и только с лицензиями, которые не требуют разрешения: общественное достояние, CC0, CC BY, CC BY-SA. Под каждой картинкой и в разделе «Откуда картинки» показаны автор, лицензия и ссылка на источник — так требуют лицензии CC BY и CC BY-SA.

• scripts/fetch-chess-images.mjs — список нужных статей Википедии (или конкретных файлов Commons). Скрипт запрашивает свободную заглавную картинку каждой статьи, у Commons — лицензию и автора файла, отбрасывает всё несвободное, скачивает, уменьшает (sharp, не больше 960 px, плюс квадратная миниатюра 240 px) и записывает src/content/chess/images.json. Исходники кэшируются в node_modules/.cache/chess-images.
• src/content/chess/images.ts — подписи и описания по-русски для каждой картинки; контент ссылается на картинки по id (pictures у партий, image у событий, чемпионов, рекордов и дебютов).
• Чтобы добавить картинку: допишите запись в ENTRIES скрипта, запустите node scripts/fetch-chess-images.mjs --only id, добавьте подпись в images.ts и ссылку из контента. tests/chess-images.test.ts проверит, что файл на месте, лицензия свободная, подпись есть, а каждая картинка где-то используется.

Задачи из базы Lichess

Банк задач собирается из открытой базы Lichess (https://database.lichess.org/#puzzles, лицензия CC0) и лежит в репозитории: public/puzzles/<тема>.json (задачи одной темы по возрастанию рейтинга), public/puzzles/mix.json (понемногу из каждой темы и ступеньки сложности — для «Задач по силам», «Шторма», «Серии» и «Дятла») и src/content/chess/puzzle-bank.json (оглавление и версия для кэша). Страница загружает только нужную тему; офлайн-кэш подгружает остальные, пока есть интернет.

Пересобрать банк (например, раз в полгода, когда база пополнится):

curl -O https://database.lichess.org/lichess_db_puzzle.csv.zst   # ~300 МБ
node scripts/build-puzzles.mjs lichess_db_puzzle.csv.zst          # Node 22.15+, ~30 секунд

Скрипт берёт популярные задачи (popularity ≥ 85, решали ≥ 500 раз, рейтинг устоялся) с рейтингом 400–1900 и решением не длиннее трёх своих ходов, раскладывает их по нашим темам (порядок и соответствие меткам Lichess — в THEMES скрипта), поровну по ступенькам сложности, и проверяет каждую через chess.js. tests/puzzle-bank.test.ts ещё раз проверяет каждую задачу: ходы законны, мат — это мат, а часть матов перепроверяет своим движком.

Как проверяется контент

Тесты tests/answers*.test.ts независимо пересчитывают каждый ответ:

• кратчайшие программы робота и исполнителей, ханойская башня, переправа и переливания — поиском в ширину;
• единственность решений логических задач — перебором;
• повороты фигур и развёртки куба — моделированием;
• кратчайший путь — алгоритмом Дейкстры;
• все разрезы квадрата 4 × 4, суммы волшебного треугольника, верхушки числовой стенки, укладки фигур и доминошек, единственность судоку — полным перебором;
• рыцари и лжецы, «если…, то…», позывные и кодовый замок — перебором всех возможных «миров» (и проверкой, что каждая подсказка нужна);
• фальшивые монеты — поиском стратегии, которая работает при любом ответе весов; «одним росчерком» — перебором всех обходов линий; шифры — кодированием и раскодированием;
• шахматы — библиотекой chess.js и собственным движком: каждая позиция возможна в настоящей партии, ходы фигур совпадают с независимым подсчётом, мат в один ход и «вилка» — единственные, звёздочки собираются за указанное наименьшее число ходов (поиск в ширину); задачи на мат в N ходов проверяются перебором (мат есть, а быстрее — нет), задачи на выигрыш материала — поиском лучшего хода с заметным отрывом; знаменитые партии и дебютные линии разыгрываются по правилам и заканчиваются тем, чем должны; генератор ходов сверяется с эталонными числами perft и с chess.js в случайных партиях.

tests/uz-content.test.ts проверяет узбекскую версию: в ней не осталось ни одной кириллической буквы, накладки не ссылаются на несуществующие id и не трогают позиции и ходы, переведено всё, клетки карт и шифры согласованы с ответами (шифр пересчитывается заново), в загадках ответ — один из вариантов. tests/endgame.test.ts сверяет задания эндшпиля с точной таблицей: правильные ответы, единственный верный ход, робот честно защищается и выигрывает. tests/account.test.ts — подпись сессии, проверка подписи Telegram, разбор id_token Google, слияние прогресса.

tests/content.test.ts следит за правилами программы в каждой неделе: 6–10 задач в дне, 5 подсказок, баланс разделов, не больше 4 задач уровня 🔴 и ⭐, сложность растёт к концу недели и от недели к неделе, привычки и названия не повторяются, ключ ответа согласован с вариантами. Он же проверяет качество текста: нет латинских букв в русских словах, в формулах стоит настоящий минус «−», нет слова «неправильно».

Деплой

Проект разворачивается на Vercel как обычное Next.js-приложение (npm run build). Переменные окружения нужны только для необязательного входа в аккаунт — см. docs/login-setup.md; без них сайт работает как раньше, с прогрессом в браузере.