Об этом проекте

Приложение «Священный Коран» — это арабский проект с открытым исходным кодом под лиценцей MIT, позволяющий читать, слушать, искать по тексту и изучать толкования Корана. Оно работает в веб-браузере и на устройствах Android. Текущая версия 3.1.20 распространяется в виде APK-файла с подписью Debug для тестирования, а веб-версия опубликована на GitHub Pages. Проект поддерживает восемь языков интерфейса, включая русский, и RTL-направление для арабского языка. В режиме чтения приложение отображает 114 сур османским шрифтом (источник AlQuran.cloud) с навигацией, сохранением позиции, выделением текущего аята, отметками суджуда и разделителями джузов. Пользователи могут настраивать размер шрифта (16–45 px), тип шрифта (Amiri, Scheherazade New, Reem Kufi) и межстрочный интервал. Доступны пять переводов смыслов, 18 правил таджвида с цветовой маркировкой, дневной и ночной режимы, а также режим заучивания с функцией «комнаты для запоминания». Для режима сур доступен официальный шрифт Хафса от комплекса короля Фахда, а постраничный режим использует QCF4. Офлайн-данные для раскладки 604 страниц загружаются опционально после проверки SHA-256. Функции прослушивания включают более 30 чтецов и два источника аудио: поаятно через API и полные MP3-файлы сур с mp3quran.net. Реализовано пословное выделение текста через quran.com, непрерывное воспроизведение между сурами, режимы повтора, таймер сна (1–180 мин), управление скоростью и интеграция с MediaSession для экрана блокировки. Офлайн-пакет позволяет хранить текст, переводы, данные таджвида, шрифты QCF4 и аудио выбранного чтеца в IndexedDB (лимит 200 МБ с очисткой LRU). Поиск охватывает 6 236 аятов с поддержкой огласовок, подсказками и голосовым вводом через Web Speech API. Раздел тафсира включает шесть версий (Al-Muyassar, Ibn Kathir, Al-Tabari, Al-Saadi, Al-Baghawi, Al-Qurtubi) с многоуровневой загрузкой. Функция «Размышление над аятом» предлагает три вопроса для личного раздумья, работая локально без использования ИИ. «Режим Мусхафа» отображает шрифты QCF V4 на Canvas (604 страницы) с цветовым таджвидом. «Режим презентации» предлагает полноэкранный просмотр с однотонными, природными или динамическими фонами Canvas (звезды, волны, дождь), а также поддержку локальных HD-видео с аудио Mishary Al-Afasy. Дополнительно интегрированы расписание молитв через Aladhan (с календарем Умм аль-Кура и компасом Киблы), утренние и вечерние азкары со счетчиком, избранное, экспорт в JSON и четыре темы оформления, включая глубокий ночной режим. Обеспечена доступность (ARIA, контрастность, сокращение анимации) и нативная отправка через Capacitor Share или Web Share API. Технически проект базируется на TypeScript 6.0 (strict mode), Vite 8 с LightningCSS, vite-plugin-pwa (Workbox) и Capacitor 8 для Android. Управление состоянием реализовано на Proxy без внешних фреймворков; хранение данных осуществляется в localStorage и трех базах IndexedDB (QuranAppDB, QuranAudioCacheDB, QuranTafsirDB). Внешние API: AlQuran.cloud, Aladhan, jsDelivr, mp3quran.net и quran.com. CI/CD конвейер включает lint, проверку типов, юнит-тесты (покрытие >80%), Playwright (Chromium, Firefox, WebKit, Mobile Chrome), CodeQL, OWASP ZAP, Lighthouse CI и проверку axe-core на соответствие WCAG. В репозитории указано наличие 3 812 юнит-тестов и 284 тест-кейсов интерфейса. Результаты Lighthouse для продакшн-сборки: производительность — 93, доступность — 100, лучшие практики — 96, SEO — 91. Для локального запуска требуется Node.js 22 или новее. Репозиторий также содержит руководство по технической оценке, описывающее офлайн-возможности и известные ограничения.