Об этом проекте
Jolito — это open-source приложение с карточками, предназначенное для изучающих разговорный мексиканский испанский язык. Оно сочетает в себе цикл повторений с интервальным воспроизведением, аудиопогружение и процесс практики, ориентированный на использование клавиатуры. Приложение может работать как устанавливаемое веб-приложение с поддержкой автономного режима (PWA) или как нативное приложение для iOS.
Основные особенности, описанные в README:
- Приоритет клавиатуры при повторении: Enter для раскрытия, клавиши 1-4 для оценки, Пробел для воспроизведения аудио; автоматический фокус ввода позволяет не убирать руки с клавиатуры.
- Акцент на слух: аудиозаписи на мексиканском испанском прикреплены как к вопросам, так и к ответам.
- Активное воспроизведение через ввод: учащиеся печатают ответы, а не просто узнают их; мгновенный визуальный diff подсвечивает орфографические различия, при этом оценка остается субъективной.
- Двойной рабочий стол карточек: связанные взаимные карточки (испанский-английский) создаются вместе с предпросмотром side-by-side и возможностью пакетного авторства.
- Автономный лексический помощник: встроенный словарь мексиканского испанского для переводов, лемм и подсказок по спряжению глаголов.
- Обнаружение дубликатов при создании карточек, управлении колодами и редактировании.
- Импорт из Anki: существующие колоды можно импортировать через пакеты .apkg или текстовый экспорт с сохранением истории обучения и графиков повторений.
- Нативная сборка для iOS через Capacitor с тактильной отдачей при раскрытии и оценке.
- Хранилище с приоритетом автономности (offline-first) с локальным сохранением и кэшированием через service-worker; возможность установки как PWA.
- Персональные колоды с беспарольным входом по email и синхронизацией между устройствами на базе Supabase.
Проект занимает нишу между двумя крайностями: универсальными инструментами интервальных повторений, требующими ручного создания карточек (нарезка аудио, изображения, шаблоны), и геймифицированными приложениями с фиксированной программой. Цель Jolito — создание карточек с нулевым трением и контроль учащегося над тем, какие реальные фразы изучаются.
Для локального запуска требуются Node.js >= 24 и npm. После клонирования `npm ci` устанавливает зависимости, а `npm run dev` запускает сервер разработки по адресу http://localhost:5173. Для проверки устанавливаемой продакшн-сборки используйте `npm run build && npm run preview` (доступно по адресу http://localhost:4173); однократная загрузка при наличии сети позволяет протестировать поведение при автономной перезагрузке. Удаленная разработка задокументирована для SSH с пробросом порта, так как Mosh самостоятельно не может передавать TCP-порт.
Дополнительная документация в репозитории охватывает видение продукта, принципы дизайна, дорожную карту, описание архитектуры с гексагональной структурой домена и локальным хранилищем, руководство по качеству с описанием пирамиды тестирования, инварианты доступности и контракты CI, а также руководство по разработке для конфигурации синхронизации Supabase и развертывания в Cloudflare Workers. Проект распространяется под лицензией Apache License 2.0.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.