# خارطة طريق GT-SIRM

> آخر تحديث: 2026-06-06 — بدء البنية الأساسيّة (v0.1.0)
> هذا الملف مشترك بين نسختَي سطح المكتب والويب.

---

## 🌙 إعلان النيّة

بُنِيَ هذا المشروع ابتغاءَ وجه الله الكريم، خِدمةً للإسلام والمسلمين. كلّ ميزة تُضاف تخدم هذا الغرض، ولا تُقبل ميزة تخالف الشرع أو تفتح باباً لمعصية.

---

## 🎯 المبادئ الموجِّهة

1. **تماثل المزايا بين النسختَين** — كلّ ميزة تُطبَّق في `GT-SIRM-DESKTOP/` و `GT-SIRM-WEB/` في نفس Commit
2. **توارُث ذكيّ** — البناء على ميزات GT-SQRM v3.0 المُختبَرة، لا إعادة كتابة
3. **العمل دون اتصال** — كلّ المحتوى الإسلاميّ متاح offline (قرآن، حديث، أذكار، أدعية)
4. **مرونة الاستيراد** — المستخدم يُحضِر نصّه أو صوته أو فيديوه بأبسط طريقة
5. **توگل الوحدات** — كلّ وحدة محتوى قابلة للإلغاء، لا فرض على المستخدم
6. **التزام شرعيّ** — التحقّق من تصحيح الأحاديث، توثيق مصادر الأقوال

---

## 📦 المراحل

### v0.1.0 — البنية الأساسيّة ✅ (2026-06-06)
- إنشاء هيكل المستودع
- الملفات التعريفيّة المشتركة
- صفحة الموقع الرسميّ
- ملفّات تقنيّة Skeleton

### v0.2.0 — Fork من GT-SQRM v3.0
- نسخ `GT-SQRM-main/` إلى `GT-SIRM-DESKTOP/` و `GT-SQR-main/` إلى `GT-SIRM-WEB/`
- توحيد البادئات: `gt_sqrm_` و `gt_sqr_` → `gt_sirm_` (نفس البادئة للنسختَين لأنّ المستودع موحَّد)
- تحديث أسماء التطبيق والأيقونات
- التحقّق من بناء الحزم الثلاث (AppImage/DEB/RPM)

### v0.3.0 — Module Manager
- إضافة `data-module="..."` لكلّ قسم
- تبويب الإعدادات الجديد بـ توگل لكلّ وحدة
- وحدات: `quran` · `hadith` · `azkar` · `asma` · `duas` · `hikam` · `free`
- حفظ تفضيلات المستخدم في localStorage

### v0.4.0 — محرّر النصّ الحرّ
- استبدال "اختيار آية" بـ محرّر متعدّد الأسطر
- توقيت لكلّ شريحة (يدويّ أو موزَّع تلقائياً)
- استخدام نفس قسم التنسيق والتأثيرات
- قوالب نصّيّة قابلة للحفظ

### v0.5.0 — مرونة الاستيراد
- drag-drop شامل لكلّ المصادر (صوت/فيديو/صورة)
- خيار **تجريد صوت فيديو الخلفية** + ربط صوت منفصل
- استيراد ألوان خلفية (مفرد · تدرّج · شعاعيّ)
- معاينة وتقطيع زمنيّ

### v0.6.0 — أداة Chromakey
- WebGL fragment shader للمعاينة في الوقت الحقيقيّ
- ffmpeg `colorkey`/`chromakey` filter للتصدير (سطح المكتب)
- نفس shader في WebCodecs (الويب)
- UI: color picker + similarity + blend + edge softening

### v0.7.0 — وحدة الحديث الشريف
- متصفّح بشجرة: الكتاب → الباب → الحديث
- مصدر: Sunnah.com API أو حزمة JSON محليّة (يُحسَم وقت التطبيق)
- شارة درجة التصحيح: 🟢 صحيح / 🟡 حسن / 🔴 ضعيف
- بحث في النصّ بـ تطبيع التشكيل (مُورَث من GT-SQRM)

### v0.9.0 — وحدة الأذكار ✅ (2026-06-09)
- استيراد كامل (132 فئة، 267 ذكراً) من مشروع [GT-HISNMUSLIM](https://github.com/SalehGNUTUX/GT_HISNMUSLIM) بإذن المؤلِّف نفسه
- متصفّح: أذكار الصباح / المساء / النوم / الاستيقاظ / بعد الصلاة
- عدّاد التكرار (مثل: 33 مرّة)

### v0.10.0 — أسماء الله الحسنى + الأدعية + الحِكَم ✅ (2026-06-09)
- **أسماء الله الحسنى**: 99+1 اسماً مع المعاني والشواهد القرآنيّة
- **الأدعية المأثورة**: 32 دعاءً مصنّفاً في 5 فئات (من القرآن، الكرب، الصباح/المساء، يوميّة، استخارة/استغفار)
- **الحِكَم**: 32 قولاً للسلف بإسناد لقائله في 4 فئات (الصحابة، التابعون، الأئمّة الأربعة، ابن القيّم وابن تيمية)

### v0.10.0 — مصادر الصوت
- **(أ)** تسجيل ميكروفون عبر `getUserMedia` + `MediaRecorder`
- **(ب)** TTS عربيّ — يُحسَم بين Edge TTS (سحابيّ) و Coqui (محليّ)
- **(ج)** الوضع الصامت مع أصوات خلفيّة فقط (للأناشيد الإيقاعيّة بدون مؤثرات صوتية)

### v1.0.0 — تحزيم ونشر
- بناء حزم سطح المكتب: AppImage + DEB + RPM
- تحضير ZIP لنسخة الويب (استضافة ذاتيّة)
- نشر على GitHub Releases (release واحد يحوي الأربعة)
- نشر نسخة الويب على GitHub Pages
- 8 قوالب موضوعيّة جاهزة (صباح/مساء/حديث/دعاء/حكمة/سيرة/قصة/اسم)

---

## 🔮 ما بعد v1.0

| الفكرة | الوصف |
|---|---|
| **مكتبة قوالب من المجتمع** | استيراد/تصدير JSON + معرض على فرع `templates/` |
| **مولّد بطاقات اقتباس** | إخراج صورة ثابتة (PNG) من نفس المحرّك |
| **قصص الأنبياء + السيرة النبويّة** | مقاطع قصيرة مع تواريخ |
| **بصمة المنشئ** | حقل اختياريّ للداعية: "بقلم: فلان" بـ badge |
| **محرّر طبقات (Layers)** | بنمط CapCut لمحتوى متقدّم |
| **GPU shaders للأداء** | تسريع تصدير 5× للويب |
| **تطبيق Android (Capacitor)** | تشغيل نسخة الويب كتطبيق أصليّ |
| **نسخ macOS / Windows** | DMG و EXE من نفس قاعدة Electron |

---

## 🔗 العلاقة مع GT-SQRM

GT-SIRM **يَرِث** كلّ ميزات GT-SQRM v3.0 — لا يُلغيها. النسختان تتعايشان:
- **GT-SQRM** = صانع ريلز مُكرَّس للقرآن — بسيط ومركَّز
- **GT-SIRM** = صانع ريلز إسلاميّ شامل — مرن وموسَّع
- **معالج "🔄 استيراد إعدادات GT-SQRM"** داخل GT-SIRM لنقل: القوالب · القرّاء · الخطوط

---

## 📝 ملاحظات للمساهمين

- اقرأ [`CLAUDE.md`](./CLAUDE.md) قبل المساهمة
- كلّ تغيير قابل للحمل يُطبَّق في النسختَين معاً
- الأحاديث: لا تُضاف بدون مصدر ودرجة تصحيح
- الأقوال: لا تُضاف بدون توثيق قائلها
- لا تُكسر مزامنة النسختَين — راجع جداول `diff` في `CLAUDE.md`