Skip to content

Repository files navigation

🌸 Kana Master (仮名マスター)

Интеллектуальная система освоения японской каны, каллиграфии и лексики JLPT N5

Version React TypeScript TailwindCSS Capacitor Vite License


Kana Master — это высокотехнологичное, автономное кроссплатформенное приложение (Web / Android APK) для быстрого и долговременного освоения японской слоговой азбуки (Хирагана и Катакана), каллиграфического письма и базового словарного запаса японского языка (JLPT N5).

Приложение объединяет в себе доказанные методы когнитивной психологии: алгоритм интервальных повторений (SRS), мнемонические ассоциации, активное вспоминание (Active Recall), кинестетическое распознавание порядка черт и динамический дзен-интерфейс с поддержкой циркадных ритмов (день / закат / ночь).


✨ Ключевые возможности

🧠 1. Интеллектуальные интервальные повторения (SRS 2.0)

  • Адаптивный алгоритм расчёта интервалов: система запоминает кривую забывания каждого знака и слова, автоматически подбирая оптимальный день и час для повторения.
  • 4 уровня оценки качества ответа: Снова (1), Трудно (2), Хорошо (3), Легко (4).
  • Leech Protection: выявление трудных знаков с частыми ошибками и назначение персональных круговых тренировок.
  • Прогноз повторений на 7 дней: наглядный график учебной нагрузки на неделю вперёд.

✍️ 2. Каллиграфические интерактивные прописи (Stroke Canvas)

  • Векторная точность KanjiVG: эталонные направляющие и порядок черт для всех 214 знаков каны.
  • Кривые Катмулла-Рома: реалистичная симуляция японской кисти и туши со сглаживанием линий в реальном времени на HTML5 Canvas.
  • 3 режима тренировки письма:
    • 🟢 Трафарет (Guided): полупрозрачный силуэт знака и анимированные подсказки направления.
    • 🟡 Сетка (Practice): классическая каллиграфическая разметка (田) без подсказок.
    • 🔴 Память (Blind): воспроизведение символа исключительно по звуку и значению из головы.

⚡ 3. Свободный квиз и экспресс-тренировки

  • Полная свобода выбора: тренировка Хираганы или Катаканы по отдельным рядам (гласные, K-, S-, T-, N-ряды, звонкие Дакутэн, составные дифтонги Ёон).
  • 2 режима тестирования:
    • Ввод ромадзи: клавиатурный скоростной ввод с мгновенной валидацией.
    • Выбор из 4: быстрый тест на реакцию и визуальное распознавание.
  • Инлайн-мнемоники: качественные карточки с ассоциативными иллюстрациями и историями для мгновенного запоминания формы знаков.

📚 4. Тренажёр лексики JLPT N5

  • Поэтапное 3-шаговое обучение:
    1. Чтение: декодирование каны в ромадзи.
    2. Смысл и контекст: перевод на русский язык и примеры живого вежливого общения (Тэйнэйго).
    3. Активное воспоминание: воспроизведение слова по памяти.
  • Режим письма слов: практика живого экранного IME-ввода на японском или посимвольное каллиграфическое написание пальцем.

🔥 5. Банк ошибок (Mistake Bank)

  • Все символы и слова, в которых были допущены ошибки, автоматически сохраняются в единый реестр.
  • Круговой тренажёр: бесконечный цикл отработки проблемных знаков до 100% закрепления.

🌸 6. Дзен-эстетика и японский дизайн

  • Циркадный суточный цикл: мягкая смена палитры (Утренний чайный дом, Закатные клёны, Звёздная ночь с луной).
  • Лепестки сакуры: процедурная анимация падающих лепестков на Canvas.
  • Печати Ханко (Hanko): традиционные японские каллиграфические штампы вердикта (大変良く出来ました, 正解, 不正解).
  • Офлайн-озвучка: чистое студийное звучание всех звуков каны без необходимости подключения к интернету.

🛠️ Технологический стек

Категория Технологии
Frontend Framework React 19, TypeScript (Strict Mode)
Styling & UI Tailwind CSS 4, Lucide Icons, Motion (Framer Motion)
Mobile Core Capacitor 8, Android SDK, Native WebView Optimization
Graphics & Audio HTML5 Canvas API, Web Audio API, Catmull-Rom Spline Engine
Build & Tooling Vite 6 (Singlefile Inliner), Capgo Live Updater (OTA)

📱 Установка на Android

Способ 1: Установка готового APK

  1. Перейдите во вкладку Releases.
  2. Скачайте файл KanaMaster.apk (актуальная версия v1.0.3).
  3. Установите на телефон (разрешите установку из надёжных источников).

Способ 2: Live-обновления по воздуху (OTA)

Приложение оснащено встроенной системой бесшовного обновления. При выходе новой версии в репозитории приложение автоматически скачает обновлённый бандл при нажатии кнопки в центре обновлений.


💻 Локальная разработка и сборка

Предварительные требования

1. Клонирование и установка зависимостей

git clone https://github.com/eonesets/kana-master.git
cd kana-master
npm install

2. Запуск локального dev-сервера

npm run dev

Приложение откроется по адресу http://localhost:3000.

3. Продакшен-сборка Web-версии

npm run build

4. Сборка подписанного Android APK

npm run build:apk

Скомпилированный и подписанный файл KanaMaster.apk появится в корне проекта.

5. Сборка OTA-пакета обновлений

npm run release:ota

Скрипт автоматически повысит версию package.json, скомпилирует дистрибутив и сгенерирует манифест release/update-manifest.json.


📂 Структура проекта

kana-master/
├── android/                   # Нативный проект Capacitor для Android
├── release/                   # Бандлы Live-обновлений (dist.zip, update-manifest.json)
├── scripts/                   # Скрипты автоматизации сборки APK и OTA
│   ├── build-apk.js
│   └── build-ota.js
├── src/
│   ├── components/            # UI-компоненты (HankoStamp, ZenBackground, SakuraCanvas, Canvas)
│   │   ├── common/            # Модальные окна, центр обновлений
│   │   └── writing/           # Холст каллиграфии DrawingCanvas
│   ├── data/                  # Базы данных каны, мнемоник и лексики JLPT N5
│   ├── hooks/                 # Кастомные хуки (useSRSSession, useAppUpdater)
│   ├── screens/               # Экраны приложения
│   │   ├── HomeScreen.tsx         # Главная панель и прогноз повторений
│   │   ├── SetupScreen.tsx        # Настройка свободного квиза
│   │   ├── TestScreen.tsx         # Сессия квиза
│   │   ├── ResultScreen.tsx       # Результаты и статистика ошибок
│   │   ├── SRSSessionScreen.tsx   # Карточки интервальных повторений
│   │   ├── WritingScreen.tsx      # Каллиграфические прописи
│   │   ├── VocabScreen.tsx        # Каталог словаря N5
│   │   ├── VocabSessionScreen.tsx # Тренировки чтения и письма слов
│   │   ├── MistakesScreen.tsx     # Банк ошибок и круговой тренажёр
│   │   ├── ReferenceScreen.tsx    # Интерактивный справочник каны (107 знаков)
│   │   └── StatsScreen.tsx        # Детальная аналитика прогресса
│   ├── services/              # Сервисы SRS, валидации каллиграфии и OTA
│   ├── utils/                 # Аудиодвижок, IME-транслитерация, локальное хранилище
│   └── App.tsx                # Корневой компонент и маршрутизация
├── package.json
└── vite.config.ts

📜 Лицензия

Проект распространяется под свободной лицензией MIT. Подробности в файле LICENSE.

Создано с любовью к японскому языку и культуре 🌸 • 2026

About

Modern Japanese Kana (Hiragana & Katakana), Stroke Calligraphy, and JLPT N5 Vocabulary trainer with Spaced Repetition (SRS 2.0), Live OTA updates & Zen aesthetics.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages