Лексика и грамматика ЕГЭ — китайский язык

Сайт: https://bronik04.github.io/ege-lg-trainer/

Тренажёр заданий 15–27 ЕГЭ по китайскому языку. Ученик читает правило, проверяет себя коротким вопросом, решает задания из открытого банка ФИПИ и собирает полный вариант раздела 3 — по одному заданию на каждую позицию 15–27. После ошибки он видит, почему не подходит именно выбранный вариант, верный ответ, правило и контрастный пример.

Страница самодостаточна: dist/index.html работает без сервера. Шрифты (Cormorant Garamond, Onest, Noto Serif SC, в клетках — кайшу LXGW WenKai) подгружаются из сети; без неё страница работает на системных шрифтах. Опубликованный сайт работает и без сети: после первого открытия страница и шрифты лежат в кэше браузера, а на телефоне сайт ставится на экран «Домой» как приложение (Safari: «Поделиться» → «На экран „Домой“»; Chrome: «Установить приложение»). Адрес — со слэшем на конце (…/ege-lg-trainer/). У приложения на экране «Домой» своё хранилище: прогресс из браузера переносится файлом («Банк и ошибки» → «Сохранить в файл», затем «Загрузить из файла»). Прогресс хранится в браузере ученика; перенести его на другое устройство можно файлом (вкладка «Банк» → «Сохранить в файл»). Исправленная ошибка возвращается на повтор через 1, 3 и 7 дней, а банк показывает слабые темы и правила к ним. В полном варианте идут часы: 40 минут на раздел 3, как рекомендует спецификация ЕГЭ.

Для учителя

Задание классу — ссылкой, без аккаунтов:

• Подборка — вкладка «Практика» → отметить номера и размер раунда → «Ссылка на подборку». Внутри номера можно взять одну грамматику: под оглавлением — «Грамматика», правила отмеченных номеров (у №22 — 就/才, 又/再/还 и т. д.). То же делает кнопка «Задания ЕГЭ по правилу» на карточке правила. Каждому ученику задания выпадут свои. Вид ссылки: …/#/practice?tasks=22&rules=jiu-cai&size=10.

• Одни и те же задания — пройти раунд и на его итоге взять «Ссылку на эти задания» (…/#/practice?ids=…).

• Один вариант на весь класс — завершить полный вариант (вкладка «Вариант») и взять «Ссылку на этот вариант» (…/#/variant?ids=…). Если у ученика начат свой вариант, страница спросит, заменить ли его.

• Результаты класса — ученик на итоге раунда или варианта нажимает «Отчёт учителю», вписывает имя и отправляет текст в мессенджере. Учитель вставляет сообщения (можно все сразу) на странице «Учителю» (ссылка в справке — кнопка «?» в шапке, …/#/teacher) и получает таблицу: кто, сколько, за какое время, какие номера и темы проседают. Сервера нет: отчёты читаются из вставленного текста и никуда не уходят.

Как устроены данные

sources/bank/               снимок выгрузки единого банка заданий ЕГЭ (не редактируется)
data/raw/bank.json          импорт без правки текста
data/authored/task-NN.json  разборы, темы и правила заданий (черновик → принято)
data/topics.json            темы; номер задания и тема — разные признаки
data/rules.json             карточки правил
data/rule-checks.json       вопросы на понимание правил
data/questions.json         канонический банк со статусом каждого задания
data/review/                отчёты: импорт, дубликаты, покрытие, очередь проверки

Статусы задания: imported — разбора нет; draft — разбор написан, не принят; ready — принят и попадает к ученику; conflict — спорный ключ; excluded — повтор или задание HSK, подсказывающее ключ заданию ФИПИ.

Как добавить и проверить задания

1. Задания живут в едином банке заданий ЕГЭ (ege-task-bank, данные на Яндекс.Диске): новые и исправленные — там. Затем выгрузка npm --prefix ~/Documents/Projects/ege-task-bank run -s bank -- export-sites lg <файл> и python3 scripts/snapshot_bank.py <файл>. ID заданий не меняются; новые ID из data/review/new-links.json записать в банк (link lg --file).
2. Пересобрать банк: npm run data (импорт → сборка банка → проверка).
3. Написать разборы волной: python3 scripts/add_explanations.py wave.json. Поправить уже принятое — сначала python3 scripts/reopen.py ID …. Если задание поправили в банке, его разбор попадает в data/review/recheck.md: задание остаётся на сайте, разбор перепроверяет ревьюер.
4. Принять: разборы принимает ревьюер-агент (решение автора 24.10.2026), по его вердикту — python3 scripts/accept.py ID …. Автор может принять и сам: двойной клик по Проверка.command в корне проекта. В Терминале по страницам идут разборы заданий, правила и вопросы к ним, спорные ключи ФИПИ и сообщения учеников; «в» — все верны, номера — какие не так. Верное принимается сразу, «не так» уходит в data/review/fixes.md для Claude, банк пересобирается сам. Для сообщений учеников нужен GitHub CLI: brew install gh, затем gh auth login. Без кнопки — прочитать data/review/queue.md или страницу python3 scripts/build_site.py --drafts → review-build/review.html и принять python3 scripts/accept.py ID … (или --task 20), затем npm run data.
5. Сколько готово по позициям и темам — data/review/coverage.md; повторы и подсказки между заданиями и правилами — data/review/duplicates.md.

Под каждым разбором есть ссылка «Сообщить на GitHub»: она открывает новый issue в этом репозитории с ID задания, условием, выбранным ответом и ключом. Сообщения учеников — в issues; спорный ключ отмечается keyConflict, как и при чтении банка.

Сборка и тесты

npm ci                                    # playwright-core для браузерного теста
npm run data                              # банк и проверка данных
npm test                                  # тесты Python и Node (браузерный — если есть Chrome)
python3 scripts/build_site.py             # dist/index.html

Публикация

.github/workflows/pages.yml при каждом push в main пересобирает банк, прогоняет проверку и тесты и только после этого публикует dist/ на GitHub Pages: https://bronik04.github.io/ege-lg-trainer/. Если закоммиченные данные разошлись с пересборкой, публикация останавливается — запустите npm run data и закоммитьте.

Если у учеников сломалась работа без сети — Actions → Deploy to GitHub Pages → Run workflow со снятой галочкой «offline»: выйдет выключатель, он удалит кэши и снимет service worker. Следующий push публикует обычную сборку; чтобы выключатель держался до исправления, задайте переменную репозитория OFFLINE = false (Settings → Secrets and variables → Actions → Variables) и удалите её, когда всё починено.