Persistence & Database
Pengelolaan data Al-Qur'an dan Tafsir berpusat pada QuranDataManager.
QuranDataManager (Class)
Sebuah singleton beranotasi @MainActor final class yang mengelola koneksi basis data khusus (special.sqlite) dan mengoordinasikan pembacaan teks ayat Al-Qur'an serta kitab-kitab tafsir. Isolasi @MainActor menjamin seluruh manipulasi state pencarian, seleksi surah, dan navigasi ayat terikat aman pada antarmuka pengguna tanpa risiko data race.
Tanggung Jawab Utama
- Memuat Surah & Ayat: Mengambil data dari tabel
QrdanSoradi basis dataspecial.sqlite. - Memuat Kitab Tafsir: Memfilter daftar kitab di
LibraryDataManageryang memiliki kategori Tafsir (ID 127 atau 70) dan memiliki nama tafsir (tafseerNam). - Membaca Konten: Menggunakan
BookConnectionuntuk menghubungkan arsip SQLite dan mengambil konten dari kitab tafsir pada surah dan ayat spesifik melaluiloadTafseer(for:in:). - Navigasi Halaman: Menyediakan fungsi
nextPage()danprevPage()untuk membaca halaman tafsir berikutnya atau sebelumnya. - Pencarian: Mendukung pencarian nama surah (
searchSurah) dan pencarian kitab tafsir (searchTafseerBooks).
Skema Tabel di special.sqlite
Qr: Menyimpan teks ayat Al-Qur'an (nass), nomor surah (sora), nomor ayat (aya), dan nomor halaman mushaf (Page).Sora: Menyimpan metadata surah, termasuk nama surah dalam bahasa Arab (sora).