🎧 Read-Assist

Platform akses belajar berbasis web untuk penyandang tunanetra — katalog buku audio, QR Code, dan asisten baca berbasis AI.

---

📑 Daftar Isi

• Tentang Proyek
• Fitur Utama
• Aksesibilitas
• Teknologi
• Cara Menjalankan
• Konfigurasi Lingkungan
• Struktur Proyek
• Pengembang

---

💡 Tentang Proyek

Read-Assist adalah aplikasi web berbasis Laravel 13 yang dikembangkan untuk membantu penyandang tunanetra mengakses materi pembelajaran secara lebih mandiri melalui audio digital dan QR Code.

Pengguna dapat memindai QR Code pada buku menggunakan smartphone untuk membuka halaman buku beserta pemutaran audionya. Antarmuka dirancang sederhana, responsif, dan berfokus pada kemudahan akses bagi pengguna.

---

✨ Fitur Utama

	Fitur	Keterangan
📚	Upload buku digital	Upload buku dalam format PDF dengan ekstraksi teks otomatis menggunakan poppler-utils
🔊	Audio buku (TTS)	Upload audio secara manual maupun menghasilkan audio dari teks
🧩	QR Code otomatis	Setiap buku mendapatkan QR Code unik untuk akses cepat melalui perangkat seluler
🎧	Pemutar audio terintegrasi	Pemutar audio halaman penuh dan mini player yang tetap tersedia saat berpindah halaman
🗂️	Manajemen katalog	Dashboard admin untuk mengelola buku dan audio
📊	Progres belajar	Pelacakan durasi mendengarkan pengguna

---

♿ Aksesibilitas

Aplikasi dibangun dengan mengacu pada prinsip WCAG 2.2 dan diverifikasi menggunakan axe-core dengan hasil 0 pelanggaran:

• 🔷 Mode kontras tinggi hitam–kuning yang konsisten di seluruh halaman
• 🗣️ Kompatibel dengan TalkBack dan screen reader melalui aria-label, live region, serta struktur heading yang terorganisasi
• ⌨️ Navigasi keyboard penuh dengan indikator fokus yang jelas dan dukungan penutupan modal menggunakan Escape
• 🔈 Suara pendamping (TTS) untuk membantu membacakan konten halaman
• 🎯 Kontras warna yang memenuhi rasio AA pada komponen yang diuji

---

🧰 Teknologi

Lapisan	Teknologi
Backend	Laravel 13, PHP 8.3
Database	SQLite
Frontend	Blade, Tailwind CSS, JavaScript
Build Tool	Vite
Ekstraksi PDF	poppler-utils (pdftotext)
Audio	Text-to-Speech (TTS)
QR Code	QR Code Generator

---

🚀 Cara Menjalankan

Prasyarat

• PHP 8.3+ dan Composer
• Node.js dan npm
• poppler-utils (pdftotext) — opsional, digunakan untuk ekstraksi teks dari PDF

1. Instalasi & Development

git clone https://github.com/Ayries18/Read-Assist.git
cd Read-Assist

composer install
npm install

cp .env.example .env
php artisan key:generate
php artisan migrate

npm run dev          # terminal 1 — hot-reload aset
php artisan serve    # terminal 2 — server aplikasi