التوثيق

للمستخدمين

• راجع صفحة التطبيق للتأكد من حالة الإصدار ومتطلبات التشغيل.
• نزّل البرامج من الروابط الرسمية فقط، وستجدها في لوحة «التنزيل والروابط».
• تحقق من أذونات التطبيق وسياسة الخصوصية قبل الاستخدام.
• استخدم صفحة التطبيقات للبحث الفوري والتصفية حسب الفئة والحالة.

للمطورين والمساهمين

• يُدار كتالوج التطبيقات من الملف content/apps.json داخل مستودع GitHub.
• لا تضف رابط تنزيل إلا بعد التحقق من ملكيته وصحة الملف.
• استخدم سجل التغييرات لتوثيق الإصدار والتعديلات.
• كل تعديل في الكتالوج يمر بمراجعة عبر طلبات السحب قبل النشر.

المستودعات المفتوحة

• التطبيقات المفتوحة المصدر تحمل شارة «مفتوح المصدر» في المتجر وبطاقة مستودع في صفحتها.
• إحصاءات المستودع (النجوم، النسخ، لغة البرمجة، آخر تطوير) تُجلب مباشرة من GitHub وتُحدّث كل ساعة.
• لتعديل رابط مستودع تطبيق، حدّث حقل repository في ملف الكتالوج بطلب سحب.

واجهة برمجية عامة (API)

يوفر الموقع واجهة قراءة عامة مجانية لبيانات الكتالوج — تعرض نفس بيانات الملف الرسمي دون تعديل:

• GET /api/apps — قائمة التطبيقات كاملة مع الحالة والفئة وروابط المستودعات.
• GET /api/apps/drs-wallet — بيانات تطبيق محدد بالمعرّف slug.
• الاستجابة JSON مع ترويسات CORS مفتوحة، وصالحة للاستخدام المباشر في تطبيقاتك.

ستجد مثالًا مباشرًا على /api/apps — وتُحدّث البيانات تلقائيًا مع كل تعديل في الكتالوج.

التحقق من الملفات

يمكن نشر قيمة SHA-256 لكل ملف إصدار للتحقق من سلامة التنزيل. يجب حسابها من الملف الفعلي وعدم تخمينها.