Quran Plus

Aplikasi Al-Qur'an 30 Juz, Hadist 9 Kitab, Tahsin, Dzikir & Hizib, serta Asisten AI Islami (Tanya AI) berbasis On-Device RAG Offline-First.

Dibuat oleh: Adrian Syah Abidin

---

⚡ Unduh & Pasang Cepat (Direct Install)

Untuk langsung menginstal aplikasi Quran Plus di smartphone atau tablet Android Anda:

1. 📥 Unduh APK Versi Terbaru (v1.0.11) (Direct Mirror: releases/latest/download/app-debug.apk).
2. Setelah unduhan selesai, buka file app-debug.apk melalui notifikasi browser atau aplikasi File Manager / Pengelola File.
3. Jika Android menampilkan peringatan keamanan sumber tidak dikenal, pilih Setelan / Settings lalu aktifkan Izinkan dari sumber ini (Allow from this source).
4. Tekan tombol Pasang / Install, tunggu hingga proses selesai, dan buka Quran Plus.
5. Kunjungi bagian Riwayat Rilis & Arsip Versi di bawah untuk mengunduh versi sebelumnya atau melihat detail changelog.

---

🌟 Fitur Utama

📖 1. Al-Qur'an Al-Karim 30 Juz

• 114 Surah & 6.236 Ayat Lengkap: Disertai penanda Juz, Halaman, dan Makkiyyah/Madaniyyah.
• Tajwid Berwarna Interaktif: Dibuat menggunakan native Compose AnnotatedString dengan pewarnaan standar Kemenag RI (Ikhfa, Idgham, Iqlab, Qalqalah, Mad, Gunnah).
• Word-by-Word (Per Kata): 77.429 unit sumber menyajikan teks Arab, transliterasi Latin presisi, dan terjemahan per kata berbasis standar Islamic.app Word API & Quran.com API v4.
• Pencarian Kilat FTS5: Pencarian teks Arab, transliterasi, maupun terjemahan Indonesia menggunakan full-text search SQLite FTS5.
• Bookmark & Riwayat Baca: Sinkronisasi posisi terakhir dibaca secara otomatis.

📚 2. Ensiklopedia 9 Kitab Hadist

• 38.102 Hadist Arab–Indonesia: Mencakup Kutubus Sittah (Bukhari, Muslim, Abu Daud, Tirmidzi, An-Nasa'i, Ibnu Majah) dan Kutubut Tis'ah (Musnad Ahmad, Muwatha' Malik, Sunan Ad-Darimi).
• Penomoran Sesuai Sumber: 28.347 rujukan dipetakan melalui kecocokan isi ke penomoran Sunnah.com. Contoh Abu Dawud 3837 berisi kurma dan mentega (nomor arsip gading 3340). Riwayat yang belum dapat dipetakan memakai label edisi tafsirq/gading; nomor lintas edisi tidak dianggap sama. Identitas arsip untuk bookmark/marker tetap dipertahankan.
• Penyimpanan SAF Mandiri: Arsip hadist diunduh langsung dari gadingnst/hadith-api dan disimpan di folder Storage Access Framework (SAF) milik pengguna, aman dari penghapusan saat aplikasi di-uninstall.
• Integrasi Corpus RAG: Seluruh hadist yang diunduh langsung diindeks ke dalam vector database lokal.

📿 3. Dzikir & Hizib Terlengkap

• Koleksi Dzikir Harian:
  • Al-Ma'tsurat Kubro & Sughro (Pagi & Petang) susunan Imam As-Syahid Hasan Al-Banna.
  • Ratib Al-Haddad karya Al-Imam Al-Habib Abdullah bin Alawi Al-Haddad.
  • Ratib Al-Attas karya Al-Imam Al-Habib Umar bin Abdurrahman Al-Attas.
  • Hizib Bahr & Hizib Nashr karya Syaikh Abu Hasan Asy-Syadzili.
  • Hizib Nawawi karya Al-Imam Yahya bin Syaraf An-Nawawi.
• Tasbih Digital Interaktif: Dilengkapi penghitung target per bacaan (3x, 7x, 10x, 100x), feedback haptik, dan reset otomatis.
• Transliterasi Latin Presisi: Penerapan kaidah fonetik tajwid dan ikhfa' yang rapi dan mudah dibaca pemula.

🎓 4. Belajar Tahsin & Ensiklopedia Gharib

• 54 Materi Tahsin Lengkap: Pembelajaran sistematis meliputi Makharijul Huruf, Sifatul Huruf, Ahkamut Tajwid, Ahkamul Mad, hingga Kaidah Waqaf & Ibtida'.
• Ensiklopedia Ayat Gharib: Penjelasan mendalam beserta cara membaca ayat-ayat unik dalam riwayat Hafsh 'an 'Ashim (Saktah, Imalah, Isymam, Tashil, Naql).
• Contoh Ayat Nyata: Setiap kaidah merujuk langsung pada ayat Al-Qur'an yang ada di dalam database.

🤖 5. Tanya AI (On-Device Islamic RAG Companion)

• Inferensi On-Device: Model Google AI Edge LiteRT-LM berjalan di perangkat. Jika rujukan lokal belum memadai dan pencarian online aktif, hanya teks Quran/Hadist yang dicari melalui provider sumber asli; pertanyaan pencarian dikirim ke provider tersebut.
• Model yang Didukung:
  • Gemma 4 E2B IT (Google LiteRT-LM)
  • Qwen 2.5 1.5B Instruct (LiteRT-LM)
  • Alif Islamic v4 Base (Model khusus fiqih & konsultasi agama)
• Vector Retrieval Lokal (RAG): Menggunakan sqlite-vec dan model embedding all-MiniLM-L6-v2 ONNX untuk mencari ayat dan hadits paling relevan dengan akurasi tinggi (BM25 + Cosine Similarity).
• Batas Waktu Komputasi 5 Menit (Strict Timeout Budget): Menjamin perangkat terhindar dari thermal throttling atau out-of-memory, dengan penanganan status GenerationStatus.TIMEOUT yang menyelamatkan teks parsial yang sudah terbentuk.
• Pemrosesan Tipografi Otomatis (AiResponsePostProcessor):
  • Membersihkan artefak model seperti tanda bintang ganda/tiga (***Heading:*** → **Heading:**).
  • Pemisahan baris otomatis sebelum subheading tebal agar struktur jawaban rapi.
  • Conjunction-aware sentence truncation memotong kata sambung menggantung (dan, atau, karena, dll.) jika generasi terhenti.
  • Penyeimbangan tanda baca dan penutup delimiter (**, (), "").
• Material 3 Rich Markdown: Teks jawaban AI dirender secara visual menggunakan ChatMarkdownText tanpa memunculkan karakter mentah (###, **).
• Quran/Hadist sebagai Sumber Jawaban: Fallback otomatis tanpa dialog mencari Quran/Hadist melalui Al Quran Cloud dan Sunnah.com. Artikel, Wikipedia, tafsir terpisah, dan dokumen pengguna tidak menjadi grounding jawaban. Toggle online tetap tersedia. Tanpa rujukan memadai, chatbot menyatakan keterbatasannya; keluaran model diperiksa sebelum tampil dan diganti kutipan sumber bila marker rujukannya tidak valid.

🎧 6. Audio Murottal Per Ayat

• Qari Ternama: Mishary Rashid Alafasy, Mahmud Khalil Al-Husary, dan Abdurrahman As-Sudais.
• Download Resumable: Menggunakan HTTP Range request, verifikasi MD5 checksum otomatis dari katalog EveryAyah, dan pemutaran offline melalui background service.

📂 7. Penyimpanan SAF (Storage Access Framework)

Penyimpanan model AI, indeks RAG, dan bundle Hadist dialokasikan ke folder pengguna pilihan Anda:

QuranPlus/
├── models/             # File bobot model LLM & ONNX (.litertlm, .onnx)
├── rag/
│   ├── source/hadith/  # Arsip JSON hadist 9 kitab
│   └── index/          # Database vektor sqlite-vec
└── manifests/          # Verifikasi checksum SHA-256

Dengan skema ini, aset berukuran besar tidak akan terhapus secara tidak sengaja saat aplikasi diperbarui atau di-reinstall.

---

🤖 Model AI yang Dapat Diunduh

Semua model diverifikasi dengan checksum SHA-256 sebelum dapat dijalankan:

Nama Model	Runtime / Engine	Ukuran	Sumber / Lisensi	Checksum (SHA-256)
Qwen 2.5 1.5B Instruct	LiteRT-LM	1.56 GB	HuggingFace	98c289e1c43cc592ac535594d5de4bdde449e8dc012ac66909064b6880f8b717
Alif Islamic v4 Base	LiteRT-LM	946 MB	HuggingFace	79deeca9f2120c08454ccb09f0399b42d4b3146e8d3fdc0bde4cfa2787f2bbaa
Gemma 4 E2B IT	LiteRT-LM	2.58 GB	HuggingFace	181938105e0eefd105961417e8da75903eacda102c4fce9ce90f50b97139a63c
all-MiniLM-L6-v2 ONNX	ONNX Runtime	23 MB	HuggingFace	4278337fd0ff3c68bfb6291042cad8ab363e1d9fbc43dcb499fe91c871902474

---

🛠️ Arsitektur & Teknologi

• Bahasa: Kotlin 2.0+ (100% modern Kotlin)
• UI Toolkit: Jetpack Compose + Material Design 3 (M3) dengan dukungan Adaptive Layout (Ponsel, Tablet Portrait, dan Tablet Landscape)
• Arsitektur: Clean Architecture + MVVM + Modular Pattern
• Injeksi Dependensi: Koin DI
• Database Lokal: Room Database 2.7+ dengan SQLite FTS5 Full-Text Search
• Vector Database: sqlite-vec untuk mobile vector embedding retrieval
• Asynchronous: Kotlin Coroutines & Reactive StateFlow
• Jaringan & Latar Belakang: Ktor HTTP Client (HTTP Range) & AndroidX WorkManager

---

💻 Cara Build dari Source Code

Pastikan Anda telah memasang Android Studio Ladybug / Koala atau yang lebih baru dengan JDK 21 dan Android SDK 35. Artefak LiteRT-LM yang dipakai berisi class Java 21; JVM untuk build dan unit test harus mendukungnya:

# 1. Clone repositori
git clone https://github.com/Adrian463588/QuranPlus.git
cd QuranPlus

# 2. Compile modul
.\gradlew.bat :shared:compileDebugKotlinAndroid --no-daemon --console=plain
.\gradlew.bat :app:compileDebugKotlin --no-daemon --console=plain

# 3. Jalankan unit test
.\gradlew.bat :app:testDebugUnitTest --no-daemon --console=plain

# 4. Build APK Debug
.\gradlew.bat :app:assembleDebug --no-daemon --console=plain

# 5. Pasang ke perangkat yang terhubung (ADB)
.\gradlew.bat installDebug

---

📱 Preview Aplikasi di Smartphone & Tablet

Tampilan antarmuka responsif Material 3 yang dioptimalkan untuk perangkat layar compact (smartphone) hingga layar lebar (tablet):

📱 Tampilan Smartphone (Samsung Galaxy S20 Ultra)

Beranda Al-Qur'an	Mushaf & Tajwid Berwarna	Tanya AI (On-Device RAG)

Ensiklopedia 9 Kitab Hadist	Dzikir Pagi-Petang & Counter	Pembelajaran Tahsin & Makharij

Ensiklopedia Bacaan Gharib	Audio Manager Murottal Offline

🖥️ Tampilan Tablet Layar Lebar (Samsung Galaxy Tab S7)

Al-Qur'an Home & Navigasi	Reader Tajwid & Terjemahan	Tanya AI (RAG Terverifikasi)

Ensiklopedia 9 Kitab Hadist	Dzikir, Wirid & Hizib	Menu Tambahan & Pengaturan

---

📦 Riwayat Rilis & Arsip Versi (Download Links)

Tabel berikut menyediakan tautan unduh langsung (direct download) untuk setiap rilis aplikasi Quran Plus:

Versi	Status	Sorotan Perubahan Utama	Tautan Unduh Langsung
v1.0.11	Terbaru (Latest)	Pencarian dan kutipan hadis memakai pemetaan isi lintas edisi; Abu Dawud 3837 sesuai riwayat kurma dan mentega. Koreksi Arab/harakat, kutipan Quran, serta tag tajwid palsu. Fallback otomatis menolak nomor yang berbeda; bookmark dan marker tetap memakai identitas arsip.	📥 Download APK v1.0.11
v1.0.10	Arsip	Perbaikan Arab, mad, waqaf dan fallback Quran/Hadist dari v1.0.8–v1.0.9, ditambah label sumber/status yang sesuai: rujukan tidak memadai tidak lagi disebut sebagai model tidak tersedia.	📥 Download APK v1.0.10
v1.0.9	Arsip	Semua perbaikan v1.0.8, ditambah koreksi tag Mad Tabi'i/Mad Lazim pada huruf muqaththa'ah dan tes warna mad. CI memakai JDK 21 sesuai artefak LiteRT-LM.	📥 Download APK v1.0.9
v1.0.8	Arsip	Koreksi tanda mad huruf muqaththa'ah; kutipan Al-Baqarah 1–5 dan Yasin 1–9 mengikuti Mushaf bawaan beserta harakat/waqaf. Latin dipertahankan. Fallback chatbot otomatis khusus Quran/Hadist; perbaikan pembaca HTTP dan parser Hadist; tes regresi dan CI.	📥 Download APK v1.0.8
v1.0.7	Arsip	• Pemisahan Bookmark Hadist & Al-Qur'an: Tab terpisah khusus bookmark Hadist dan Al-Qur'an di layar Bookmark, lengkap dengan catatan pengguna, edit, swipe-to-delete, dan navigasi langsung ke hadits. • Persistensi Bookmark Hadist ke SAF Folder: Bookmark Hadist otomatis tersimpan dan disinkronkan ke userdata/hadith_bookmarks.json di folder SAF pengguna, aman dari kehilangan data saat reinstall aplikasi. • Pembedaan Konsep Bookmark vs Marker: Bookmark (🔖) untuk menyimpan/memfavoritkan ayat/hadits dengan catatan dan tersimpan permanen; Marker (📌) untuk menandai titik berhenti membaca sementara dengan kode warna dinamis (hingga 15 marker).	📥 Download APK v1.0.7
v1.0.6	Arsip	• Multi-Penanda Berhenti Baca (Hingga 15 Marker): Penanda membaca Al-Qur'an & Hadist fleksibel hingga 15 slot dengan palet warna unik berurutan (#1 Biru Ocean #0284C7, #2 Merah Muda #EC4899, #3 Orange #F97316, dst). • Pembedaan Ikon Marker & Bookmark: Ikon penanda baca dibedakan menggunakan PushPin (📌) dan bookmark menggunakan pita bookmark (🔖). • Persistensi Penuh SAF Folder saat Reinstall: Auto-sync & restore bookmark dan markers dari userdata/ di folder SAF tanpa takut hilang saat reinstall. • Perbaikan History Pencarian: Kata/frasa pencarian hanya tersimpan saat user submit pencarian secara penuh.	📥 Download APK v1.0.6
v1.0.5	Arsip	• Sinkronisasi SAF saat Reinstall: Auto-reload Model AI, Bundle Hadist, Bookmarks & Markers dari folder SAF. • Penanda Berhenti Baca (Marker): Fitur penanda khusus tilawah Al-Qur'an & Hadist warna Ocean Light Blue (#0284C7), auto-sync ke userdata/markers.json. • Perbaikan History Chips: Riwayat pencarian hanya tersimpan saat submit / klik hasil (bukan per karakter ketikan).	📥 Download APK v1.0.5
v1.0.4	Draft	• Tajwid Berwarna Dzikir & Hizib: Pewarnaan tajwid interaktif pada Al-Ma'tsurat, Ratib Al-Haddad, Ratib Al-Attas, Hizib Bahr, Hizib Nashr, & Hizib Nawawi. • Pencarian Riwayat dengan Chips: Filter history interaktif dan multi-reference jump.	APK belum dipublikasikan; gunakan versi terbaru atau arsip publik lainnya.
v1.0.3	Arsip	• Murottal Offline Resumable: Download per-ayat HTTP Range dengan checksum EveryAyah. • Audio Player Background Service: Pemutaran audio di latar belakang dengan kontrol notifikasi.	📥 Download APK v1.0.3
v1.0.2	Arsip	• Ensiklopedia 9 Kitab Hadist Offline: Impor corpus 38.102 hadist dari arsip zip lokal SAF. • Integrasi RAG Hadist: Pengindeksan hadits ke dalam sqlite-vec untuk rujukan AI.	APK belum dipublikasikan
v1.0.1	Arsip	• Tanya AI On-Device RAG Companion: Konsultasi Islam lokal ditenagai Google LiteRT-LM & all-MiniLM-L6-v2 ONNX. • Safe Guard Budgeting: Timeout 5 menit anti-throttling dan pemrosesan tipografi cerdas.	APK belum dipublikasikan
v1.0.0	Arsip	• Rilis Awal Quran Plus: Mushaf 30 Juz, Tajwid Kemenag RI, Word-by-Word, Tahsin & Gharib.	📥 Download APK v1.0.0

---

📜 Lisensi & Sumber Referensi

1. Al-Qur'an & Tajwid: Mengikuti standar mushaf Kementerian Agama Republik Indonesia (Kemenag RI) dan Quran Foundation API.
2. Word-by-Word: Data bersumber dari Islamic.app Word API.
3. Koleksi Hadist: Menggunakan format terstruktur Arab-Indonesia dari gadingnst/hadith-api. Pemetaan nomor berdasarkan kecocokan unik teks Indonesia dari fawazahmed0/hadith-api (Unlicense), dengan revisi dan SHA-256 kedua sumber dipatok. Nomor Muslim memakai penomoran Arab beserta rujukan kitab/hadis untuk membedakan varian.
4. Audio Murottal: Sumber rekaman audio dan checksum MD5 EveryAyah (EveryAyah.com).
5. Model AI: Google Gemma Terms of Use (ai.google.dev/gemma/terms) dan Apache 2.0 untuk Qwen 2.5 & MiniLM.

---

Quran Plus — Membaca, Memahami, dan Mengamalkan Al-Qur'an & Sunnah dengan Bimbingan Teknologi Cerdas.