Skip to content

MrMaxB/Greek

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

89 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ελληνικά A1 — интерактивный тренажёр греческого

Тренажёр-симулятор для изучения греческого с нуля до уровня A1 — как фундамент для экзамена A2 (требование для гражданства Кипра, проводит Минобразования Кипра раз в год, обычно в мае; проверяются 4 навыка: аудирование, чтение, письмо, говорение).

Интерфейс на русском. Полностью офлайн, без установки и без зависимостей — один HTML-файл и немного JS. Прогресс хранится в браузере.

Как запустить

Просто открой index.html в браузере (двойной клик). Работает и на телефоне, и на компьютере. Ничего ставить не нужно.

Открыть с телефона (без установки)

Репозиторий приватный, поэтому есть два способа:

  1. Один файл (проще всего, офлайн). Возьми dist/greek-a1.html — это вся программа в одном файле. Сохрани его на телефон (через Files / «Скачать» / отправь себе в мессенджер) и открой в браузере. Работает без интернета. Пересобрать файл: python3 build.py.
  2. Публичный URL. Если сделать репозиторий публичным и включить GitHub Pages (Settings → Pages → ветка claude/greek-a1-trainer-EQevi), тренажёр откроется по ссылке https://mrmaxb.github.io/Greek/.

Чтобы пользоваться как приложением — в браузере телефона нажми «Поделиться» → «На экран Домой». Иконка появится как у обычного приложения, откроется на весь экран. Прогресс хранится прямо на телефоне.

Для озвучки греческого используется встроенный в браузер синтез речи (Web Speech API). Лучше всего работает в Chrome / Edge. Если греческого голоса нет — приложение об этом скажет; весь остальной функционал работает.

Методология (на основе ресёрча)

  1. Алфавит в первую очередь. Греческое письмо — главный барьер. Учим узнавание букв и буквосочетаний (ου, μπ, ντ, αυ, ευ…) визуально + на слух.
  2. Интервальные повторения (SRS). Ядро словаря по упрощённому алгоритму SM‑2: слова возвращаются ровно тогда, когда начинаешь забывать. 10–15 минут в день эффективнее редких марафонов.
  3. Понятный ввод + активный отзыв через все навыки: слушать (озвучка), читать, выбирать перевод, печатать по‑гречески.
  4. Тематические модули по бытовым темам экзамена A2.

Что внутри

  • 🗺️ Путь — пошаговый маршрут на ~103 дня: тема дня + грамматика с тренировкой + чтение/диктант/письмо по теме дня, дни закрепления, экзамены-чекпоинты.
  • 🔤 Алфавит — 24 буквы с произношением и примерами + буквосочетания; тренажёр «буква → звук».
  • 🧠 Повторение (SRS) — умные карточки по всему словарю (~1310 слов, 77 тем), лимит 15 новых/день, стрик с «заморозкой».
  • 📚 Темы — каждая со списком и 6 режимами: карточки, выбор, аудирование, набор, 🎧 диктант, голос. Экранная греческая клавиатура.
  • 📖 Грамматика A1 — 22 урока с таблицами и тренировкой порциями по 12; при ошибке — объяснение «почему», озвучка целой фразой (артикль+слово).
  • ✍️ Письмо — собери предложение по темам (порциями), вставь слово, текст из слов, о себе, свободное письмо с чек-листом, анкета αίτηση, 🎧 диктант на слух по любой теме.
  • 🗣️ Говорение — фразы вслух, вопрос-ответ, соотнеси реплики (matching), аудирование диалогов, описание картинки (формат A2).
  • 📕 Чтение — 140 graded-текстов с тап-переводом + вопросы на понимание.
  • 📝 Экзамены — 25 пробных в формате ΚΕΓ с хронометражем.
  • 📊 Прогресс — стрик, освоено/закреплено, достижения, календарь активности, синхронизация через облако.

Структура

index.html               — оболочка, подключает скрипты по порядку
css/styles.css            — стили (мобайл-фёрст, греческая бело-синяя тема)
js/data-alphabet.js       — алфавит + буквосочетания
js/data-decks-core.js     — словарь, базовые темы
js/data-decks-extra.js    — словарь, расширение
js/data.js                — сборка DECKS + инициализация id/ALL_WORDS
js/grammar.js             — 22 урока грамматики (+ «зачем»), склонения, спряжения
js/writing.js             — ДАННЫЕ письма/говорения (предложения по темам, анкеты, диалоги, картинки)
js/reading.js             — ДАННЫЕ чтения: 140 graded-текстов + словарь тап-перевода
js/exams.js               — тексты пробных экзаменов
js/official_a1.js         — официальный глоссарий ΚΕΓ A1 (для покрытия)
js/rare.js                — пометка «редких» слов A1
js/srs.js                 — движок интервальных повторений + статистика
js/speech.js              — озвучка и распознавание (Web Speech API)
js/exercises.js           — генераторы грамм-упражнений (+ say/why)
js/app.js                 — ядро: роутер, утилиты, главная, темы, грамматика, упражнения, прогресс
js/feat-track.js          — «Путь» (учебный маршрут по дням)
js/feat-speaking.js       — говорение + аудирование + matching + описание картинки
js/feat-writing.js        — письмо: собери (по темам)/пропуски/о-себе/анкета/диктант
js/feat-reading.js        — чтение: graded readers, тап-перевод, проверка понимания
js/feat-exams.js          — экзамены (сборка, таймер, проверка)
js/cloud.js               — синхронизация прогресса (Firebase, только онлайн)
sw.js                     — service worker (офлайн, network-first)
tools/                    — coverage.py, glosscheck.js (аудит контента)
tests/                    — автотесты (node:test, без зависимостей)
build.py                  — сборка автономного dist/greek-a1.html

Разработка

npm test            # автотесты (node:test, нужен Node 22+)
npm run build       # собрать офлайн dist/greek-a1.html
npm run coverage    # отчёт о покрытии официального A1

CI (.github/workflows/ci.yml) на каждый push гоняет тесты, сборку и аудит покрытия.

Дальше (до полного MVP / A2)

  • PWA-манифест + иконки (установка на домашний экран).
  • Онбординг первого запуска.
  • Выбор темпа в «Пути» (лёгкий/обычный/интенсив), значки-награды.
  • Вопросы на понимание к текстам чтения.
  • Уровень A2: расширенный словарь и грамматика.

Транскрипция русскими буквами — упрощённая, для старта. Опирайся на озвучку и ударения.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors