AlMahir: AI-Powered Qur'an Recitation

الماهر بالقرآن (AlMahir)

تطبيق iOS لتلاوة وحفظ القرآن الكريم بمساعدة الذكاء الاصطناعي

● نبذة عن المشروع

الماهر بالقرآن تطبيق iOS متكامل بيساعد المستخدم يتلو ويحفظ القرآن الكريم، وبيعتمد على الذكاء الاصطناعي في متابعة التلاوة. التطبيق مبني بالكامل بـ SwiftUI، ومقسّم لـ Modules مستقلة بحيث يسهل تطويره وصيانته.

● المميزات الرئيسية

- المصحف (Mushaf): عرض المصحف داخل التطبيق.

- التلاوة والحفظ بالذكاء الاصطناعي: متابعة تلاوة المستخدم ومساعدته في الحفظ.

- تسجيل الدخول وإدارة الحسابات (Authentication): نظام Auth كامل.

- حلقات التحفيظ (Circles): إنشاء الحلقات والانضمام لها.

- المشايخ (Sheikhs): التواصل مع المشايخ والمحفّظين.

- مكالمات مباشرة (Live Calls): تكامل مع Agora للصوت والفيديو.

- تواصل لحظي (Real-time): باستخدام WebSockets.

● شغلي في المشروع

اشتغلت على تطوير الـ Modules دي من الصفر:

- Auth Module: تسجيل الدخول وإدارة الجلسات.

- NetworkKit : Swift Package مستقلة لطبقة الـ Networking، مبنية بـ:

Clean Architecture

Alamofire مع async/await

دعم Multiple Environments (Dev / Staging / Production)

نظام Error Handling متوافق مع الـ Backend Contract

الـ Feature Modules بتعتمد على APIClientProtocol مش على Alamofire مباشرة، وده بيخلي الكود قابل للاختبار وسهل تغيير المكتبة بعدين.

- Agora Kit: تغليف تكامل Agora في Package مستقلة قابلة لإعادة الاستخدام.

- Socket Module: إدارة الاتصال اللحظي.

- Circle Module: حلقات التحفيظ.

- Sheikh Module: شاشات وخدمات المشايخ.

● التكنولوجيز المستخدمة

Swift & SwiftUI

Swift Package Manager (SPM) مع Local Packages

Clean Architecture (+ MVVM)

Alamofire

Swift Concurrency (async/await)

Agora SDK

WebSockets

Protocol-Oriented Programming & Dependency Injection

● اللي بيميّز الشغل ده

- معمارية Modular نضيفة وقابلة للتوسع.

- فصل واضح بين الـ Layers.

- كود قابل للاختبار وإعادة الاستخدام.

- تعامل احترافي مع الأخطاء والبيئات المختلفة.