{"id":41328542,"url":"https://github.com/rn0x/IslamicQuizAPI","last_synced_at":"2026-02-24T23:00:38.967Z","repository":{"id":216893996,"uuid":"742501082","full_name":"rn0x/IslamicQuizAPI","owner":"rn0x","description":"قاعدة بيانات وواجهة برمجة تطبيقات API لتقديم أسئلة لتقيم مستواك في العلوم الشرعية وتطوير حصيلتك العلمية في مجالات متنوعة، جميع الإجابات مصدرها موقع الدرر السنية. ","archived":false,"fork":false,"pushed_at":"2024-10-16T23:21:00.000Z","size":3203,"stargazers_count":18,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-13T10:42:22.634Z","etag":null,"topics":["database","database-islam","dorar","figh","islam","islamic","json","questions","quiz","quran","tafseer"],"latest_commit_sha":null,"homepage":"https://islamicquiz.i8x.net/api/questions/random?count=5","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rn0x.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-01-12T16:09:40.000Z","updated_at":"2025-12-15T08:29:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"d854395b-65b0-4631-a541-d3fccc6a7971","html_url":"https://github.com/rn0x/IslamicQuizAPI","commit_stats":null,"previous_names":["rn0x/muealimat-al-darar-islamic-knowledge-quiz-hub"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/rn0x/IslamicQuizAPI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rn0x%2FIslamicQuizAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rn0x%2FIslamicQuizAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rn0x%2FIslamicQuizAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rn0x%2FIslamicQuizAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rn0x","download_url":"https://codeload.github.com/rn0x/IslamicQuizAPI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rn0x%2FIslamicQuizAPI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29804138,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T22:43:48.403Z","status":"ssl_error","status_checked_at":"2026-02-24T22:43:18.536Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","database-islam","dorar","figh","islam","islamic","json","questions","quiz","quran","tafseer"],"created_at":"2026-01-23T06:11:49.933Z","updated_at":"2026-02-24T23:00:38.960Z","avatar_url":"https://github.com/rn0x.png","language":"JavaScript","funding_links":[],"categories":["Hadith Search and API (20 projects)"],"sub_categories":["JavaScript"],"readme":"### **IslamicQuizAPI**\n\nمشروع مفتوح المصدر يوفر **قاعدة بيانات متعددة التنسيقات** تشمل **JSON، SQLite، وCSV**، إضافةً إلى **واجهة برمجة تطبيقات (API)** مخصصة لتسهيل استخدام الأسئلة الشرعية في التطبيقات والمشاريع المختلفة.\n\n#### **الأهداف**\n\n- **تقييم مستوى المعرفة بالعلوم الشرعية** وتطوير الحصيلة العلمية.\n- **تقديم الأسئلة في مجالات مختلفة** مع دعم الفئات والمواضيع المتنوعة.\n- **مرونة الاستخدام** حيث يمكن للمطورين اختيار التنسيق الأنسب لمشاريعهم.\n- **الاستناد إلى إجابات موثوقة** مقتبسة من **موقع الدرر السنية**.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"unused/IslamicQuizAPI.png\" alt=\"قاعدة بيانات أسئلة دينية\"\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"unused/owners-logo.png\" alt=\"قاعدة بيانات أسئلة دينية\"\u003e\n\u003c/div\u003e\n\n---\n\n## الفئات\n\n- [التفسير](#التفسير)\n- [العقيدة](#العقيدة)\n- [الحديث](#الحديث)\n- [الفقه](#الفقه)\n- [التاريخ](#التاريخ)\n- [اللغة العربية](#اللغة-العربية)\n\n---\n\n## **المزايا الرئيسية**\n\n- **واجهة API** سهلة الاستخدام لعرض الأسئلة، الفئات، والمواضيع.\n- **تنسيقات متعددة للبيانات** (JSON، SQLite، وCSV) لسهولة التوافق مع التطبيقات المختلفة.\n- **تحكم في التصفح والبحث** داخل الأسئلة.\n- **إمكانية تحديد عدد معين من الأسئلة العشوائية** لمزيد من المرونة.\n- **حماية وأمان** باستخدام Helmet وRate Limiting لتقليل المخاطر.\n\n---\n\n## **المتطلبات**\n\n- **Node.js** (إصدار 18 أو أحدث)\n- **Git** (في حال التنزيل من المستودع)\n- **إدارة الحزم** باستخدام npm أو yarn\n\n---\n\n## **التهيئة والتثبيت**\n\n1. **استنساخ المستودع**\n\n   ```bash\n   git clone https://github.com/rn0x/IslamicQuizAPI.git\n   cd IslamicQuizAPI\n   ```\n\n2. **تثبيت التبعات**\n\n   ```bash\n   npm install\n   ```\n\n3. **إنشاء ملف البيئة (.env)**  \n   أنشئ ملف `.env` في جذر المشروع وأضف المتغيرات التالية:\n\n   ```bash\n   PORT=3000\n   BODY_SIZE_LIMIT=10mb\n   RATE_LIMIT_WINDOW_MS=3600000  # 1 ساعة\n   RATE_LIMIT_MAX=500  # 500 طلب في الساعة\n   ```\n\n4. **تشغيل المشروع في وضع التطوير**\n\n   ```bash\n   npm run dev\n   ```\n\n5. **تشغيل المشروع في الوضع الإنتاجي**\n\n   ```bash\n   npm start\n   ```\n\n6. **اختياري: تحويل البيانات**  \n   لتحويل بيانات JSON إلى SQLite وCSV:\n\n   ```bash\n   npm run db\n   ```\n\n---\n\n## **تشغيل المشروع باستخدام Docker**\n\nيمكنك تشغيل مشروع **IslamicQuizAPI** داخل حاوية Docker لتبسيط عملية النشر والتوزيع. إليك الخطوات اللازمة لذلك:\n\n### **المتطلبات المسبقة**\n\nقبل البدء، تأكد من أنك قد قمت بتثبيت:\n\n- **Docker** على نظامك. يمكنك تحميله من [الموقع الرسمي لـ Docker](https://www.docker.com/get-started).\n\n### **الخطوات لتشغيل المشروع**\n\n1. **استنساخ المستودع**\n\n   إذا لم تكن قد قمت بذلك بعد، استنساخ المستودع إلى جهازك:\n\n   ```bash\n   git clone https://github.com/rn0x/IslamicQuizAPI.git\n   cd IslamicQuizAPI\n   ```\n\n2. **بناء صورة Docker**\n\n   قم بإنشاء صورة Docker من ملف `Dockerfile` الموجود في المشروع:\n\n   ```bash\n   docker build -t islamic-quiz-api .\n   ```\n\n   - `-t islamic-quiz-api`: هذا هو اسم الصورة التي ستقوم بإنشائها.\n\n3. **تشغيل حاوية Docker**\n\n   بعد إنشاء الصورة، قم بتشغيلها باستخدام الأمر التالي:\n\n   ```bash\n   docker run -p 3000:5000 islamic-quiz-api\n   ```\n\n   - `-p 3000:5000`: يربط المنفذ 3000 على جهازك بالمنفذ 5000 داخل الحاوية.\n\n     `الجزء الأول` (3000): هذا هو المنفذ على جهازك المضيف (host).\n\n     `الجزء الثاني` (5000): هذا هو المنفذ الذي يستمع عليه التطبيق داخل الحاوية (container).\n\n   - `--env-file .env`: يقوم بتحميل المتغيرات البيئية من ملف `.env` ليتم استخدامها داخل الحاوية.\n\n4. **الوصول إلى واجهة API**\n\n   بعد تشغيل الحاوية، يمكنك الوصول إلى واجهة API من خلال المتصفح أو باستخدام أدوات مثل Postman عبر الرابط التالي:\n\n   ```\n   http://localhost:3000/api\n   ```\n\n### **ملاحظات**\n\n- تأكد من أن لديك Docker يعمل بشكل صحيح على نظامك قبل اتباع الخطوات.\n- يمكنك التحقق من حالة الحاويات قيد التشغيل باستخدام الأمر:\n\n  ```bash\n  docker ps\n  ```\n\n- إذا كنت ترغب في إيقاف الحاوية، يمكنك استخدام:\n\n  ```bash\n  docker stop \u003ccontainer_id\u003e\n  ```\n\n  حيث `\u003ccontainer_id\u003e` هو المعرف الخاص بالحاوية التي ترغب في إيقافها.\n\n---\n\n## **أمثلة لاستخدام API**\n\n1. **عرض جميع الفئات والمواضيع**\n\n   ```http\n   GET /api/categories\n   ```\n\n   الإستجابة:\n\n   ```\n   [\n    {\n        \"id\": 1,\n        \"arabicName\": \"التفسير\",\n        \"englishName\": \"tafseer\",\n        \"description\": \"فهم القرآن الكريم ومعرفة مقصوده من أسمى المقاصد, يقول الله تعالى {كِتَابٌ أَنزَلْنَاهُ إِلَيْكَ مُبَارَكٌ لِّيَدَّبَّرُوا آيَاتِهِ وَلِيَتَذَكَّرَ أُولُو الْأَلْبَابِ} ص:29\",\n        \"topics\": []\n    },\n    {\n        \"id\": 2,\n        \"arabicName\": \"العقيدة\",\n        \"englishName\": \"aqeedah\",\n        \"description\": \"الإيمان بالله وملائكته وكتبه ورسله واليوم الآخر والقدر خيره وشره.\",\n        \"topics\": []\n    },\n    {\n        \"id\": 3,\n        \"arabicName\": \"السيرة النبوية\",\n        \"englishName\": \"sira\",\n        \"description\": \"دراسة حياة الرسول محمد صلى الله عليه وسلم وأحداث حياته.\",\n        \"topics\": []\n    }\n   ]\n   ```\n\n   - id: معرف الفئة.\n   - arabicName: الاسم باللغة العربية.\n   - englishName: الاسم باللغة الإنجليزية.\n   - description: وصف مختصر للفئة.\n   - topics: قائمة المواضيع المرتبطة بهذه الفئة []\n\n2. **عرض جميع الأسئلة بصفحات محددة**\n\n   ```http\n   GET /api/questions?page=1\u0026limit=10\n   ```\n\n   الإستجابة:\n\n   ```json\n   {\n     \"page\": 1,\n     \"limit\": 10,\n     \"totalQuestions\": 5820,\n     \"totalPages\": 582,\n     \"questions\": [\n       {\n         \"id\": 1,\n         \"q\": \"من أسْماءِ سورةِ الفاتحةِ:\",\n         \"link\": \"https://dorar.net/tafseer/1#tt1\",\n         \"answers\": [\n           {\n             \"answer\": \"فاتحةُ الكِتابِ\",\n             \"t\": 1\n           },\n           {\n             \"answer\": \"أمُّ السوَرِ\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"نورُ الهدايةِ\",\n             \"t\": 0\n           }\n         ],\n         \"category\": \"التفسير\",\n         \"topic\": \"الفاتحة\"\n       },\n       {\n         \"id\": 2,\n         \"q\": \"ما هي أول سورة نزلت في القرآن؟\",\n         \"link\": \"https://dorar.net/tafseer/2#tt1\",\n         \"answers\": [\n           {\n             \"answer\": \"العلق\",\n             \"t\": 1\n           },\n           {\n             \"answer\": \"الفاتحة\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"البقرة\",\n             \"t\": 0\n           }\n         ],\n         \"category\": \"التفسير\",\n         \"topic\": \"النزول\"\n       }\n       // يمكن إضافة المزيد من الأسئلة هنا\n     ]\n   }\n   ```\n\n   - page: رقم الصفحة الحالية.\n   - limit: عدد الأسئلة في الصفحة.\n   - totalQuestions: إجمالي عدد الأسئلة في قاعدة البيانات.\n   - totalPages: إجمالي عدد الصفحات المتاحة.\n   - questions: مصفوفة تحتوي على الأسئلة في الصفحة الحالية:\n   - id: معرف السؤال.\n   - q: نص السؤال.\n   - link: رابط للمزيد من التفاصيل حول السؤال.\n   - answers: مصفوفة تحتوي على الإجابات المحتملة:\n   - answer: نص الإجابة.\n   - t: قيمة تشير إلى ما إذا كانت الإجابة صحيحة (1) أو خاطئة (0).\n   - category: الفئة التي ينتمي إليها السؤال.\n   - topic: الموضوع المرتبط بالسؤال.\n\n3. **عرض مواضيع فئة معينة**\n\n   ```http\n   GET /api/categories/1/topics\n   ```\n\n   الإستجابة:\n\n   ```json\n   [\n     {\n       \"slug\": \"tahara\",\n       \"name\": \"الطهارة\"\n     },\n     {\n       \"slug\": \"salah\",\n       \"name\": \"الصلاة\"\n     },\n     {\n       \"slug\": \"zakah\",\n       \"name\": \"الزكاة\"\n     },\n     {\n       \"slug\": \"siam\",\n       \"name\": \"الصيام\"\n     },\n     {\n       \"slug\": \"hajj\",\n       \"name\": \"الحج\"\n     },\n     {\n       \"slug\": \"figh-zina\",\n       \"name\": \"اللباس والزينة\"\n     },\n     {\n       \"slug\": \"figh-atema\",\n       \"name\": \"الأطعمة والأشربة\"\n     },\n     {\n       \"slug\": \"figh-said\",\n       \"name\": \"التذكية والعقيقة والصيد\"\n     },\n     {\n       \"slug\": \"figh-nikah\",\n       \"name\": \"النكاح\"\n     },\n     {\n       \"slug\": \"figh-talag\",\n       \"name\": \"الطلاق\"\n     },\n     {\n       \"slug\": \"figh-iela\",\n       \"name\": \"الخلع والإيلاء\"\n     },\n     {\n       \"slug\": \"ridaa\",\n       \"name\": \"الرضاع والحضانة والنفقات\"\n     },\n     {\n       \"slug\": \"idah\",\n       \"name\": \"اللعان والعدة\"\n     },\n     {\n       \"slug\": \"e-nozor\",\n       \"name\": \"الأيمان والنذور\"\n     },\n     {\n       \"slug\": \"wagf\",\n       \"name\": \"الوقف\"\n     },\n     {\n       \"slug\": \"wasaya\",\n       \"name\": \"الوصايا\"\n     },\n     {\n       \"slug\": \"hibat\",\n       \"name\": \"الهبات\"\n     }\n   ]\n   ```\n\n   - slug: معرف الموضوع باللغة الإنجليزية، يُستخدم غالبًا في الروابط.\n   - name: اسم الموضوع باللغة العربية.\n\n4. **جلب أسئلة عشوائية**\n\n   ```http\n   GET /api/questions/random?count=5\n   ```\n\n   الإستجابة:\n\n   ```json\n   [\n     {\n       \"id\": 1,\n       \"q\": \"هِبةُ الوَديعةِ لِمَن هي عِندَه\",\n       \"link\": \"https://www.dorar.net/feqhia/6634\",\n       \"answers\": [\n         {\n           \"answer\": \"لا تَجوزُ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"تُكرَهُ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"تَجوزُ\",\n           \"t\": 1\n         }\n       ],\n       \"category\": \"الفقه\",\n       \"topic\": \"الهبات\"\n     },\n     {\n       \"id\": 17,\n       \"q\": \"قُرِئَ \\\"لِلْعَالِمِينَ\\\" بكسر اللَّامِ في قَولِه تَعالَى: {إِنَّ فِي ذَلِكَ لَآيَاتٍ لِلْعَالِمِينَ} أي:\",\n       \"link\": \"https://www.dorar.net/tafseer/30/4#tt4\",\n       \"answers\": [\n         {\n           \"answer\": \"عَالمُ الأَرضِ وعَالَمُ السَّماءِ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"أَحبارُ اليَهُودِ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"جَمع عالِمٍ\",\n           \"t\": 1\n         }\n       ],\n       \"category\": \"التفسير\",\n       \"topic\": \"الروم\"\n     },\n     {\n       \"id\": 10,\n       \"q\": \"معنى قولِه: {نَادِيكُمُ}:\",\n       \"link\": \"https://dorar.net/tafseer/29/9\",\n       \"answers\": [\n         {\n           \"answer\": \"قَريَتُكم\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"بُستَانُكم\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"مَجلِسُكُم\",\n           \"t\": 1\n         }\n       ],\n       \"category\": \"التفسير\",\n       \"topic\": \"العنكبوت\"\n     },\n     {\n       \"id\": 18,\n       \"q\": \"مَن كَذَب على رَسولِ اللهِ ﷺ في تَحليلِ حَرامٍ أو عَكسِه، فهو:\",\n       \"link\": \"https://www.dorar.net/aqeeda/2939\",\n       \"answers\": [\n         {\n           \"answer\": \"مُنافِقٌ مَعلومُ النِّفاِق\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"مُسلِمٌ مُرتكِبٌ لكَبيرةٍ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"كافِرٌ خارِجٌ منَ المِلَّةِ\",\n           \"t\": 1\n         }\n       ],\n       \"category\": \"العقيدة\",\n       \"topic\": \"نواقض الإيمان\"\n     },\n     {\n       \"id\": 6,\n       \"q\": \"مَعنَى \\\"زَاغَتْ\\\" في قَولِه تعالى: {أَمْ زَاغَتْ عَنْهُمُ الْأَبْصَارُ}: \",\n       \"link\": \"https://dorar.net/tafseer/38/11\",\n       \"answers\": [\n         {\n           \"answer\": \"عَمِيَت\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"تَعالَت وتَكبَّرَت\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"عدَلتْ ومالَتْ\",\n           \"t\": 1\n         }\n       ],\n       \"category\": \"التفسير\",\n       \"topic\": \"ص\"\n     }\n   ]\n   ```\n\n   - id: معرف السؤال.\n   - q: نص السؤال.\n   - link: رابط إلى مزيد من المعلومات حول السؤال.\n   - answers: قائمة بالإجابات المحتملة:\n   - answer: نص الإجابة.\n   - t: تشير إلى ما إذا كانت الإجابة صحيحة (1) أم لا (0).\n   - category: الفئة التي ينتمي إليها السؤال.\n   - topic: الموضوع المحدد للسؤال.\n\n5. **البحث في الأسئلة عبر النص**\n\n   ```http\n   GET /api/search?q=الصلاة\n   ```\n\n   الإستجابة:\n\n   ```json\n   [\n     {\n       \"id\": 5,\n       \"q\": \"قُدِّمت الصلاةُ على الزكاةِ في قولِه تَعالَى: {الَّذِينَ يُقِيمُونَ الصَّلَاةَ وَيُؤْتُونَ الزَّكَاةَ}:\",\n       \"link\": \"https://www.dorar.net/tafseer/31/1\",\n       \"answers\": [\n         {\n           \"answer\": \"لأنَّها أوَّلُ ما فُرِضَ مِن فَرائضِ الإسلامِ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"لأنَّ الصَّلاةَ نَفعُها لازِمٌ، والزَّكاةَ نفعُها مُتعَدٍّ للغيرِ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"لأنَّها أحبُّ الأعْمالِ إلى اللهِ تَعالَى \",\n           \"t\": 1\n         }\n       ],\n       \"category\": \"التفسير\",\n       \"topic\": \"لقمان\"\n     },\n     {\n       \"id\": 20,\n       \"q\": \"قال اللهُ تعالَى: {إِنَّمَا تُنْذِرُ الَّذِينَ يَخْشَوْنَ رَبَّهُمْ بِالْغَيْبِ وَأَقَامُوا الصَّلَاةَ} فيه فَضيلةُ الصلاةِ؛ وأنَّها سببٌ لـ:\",\n       \"link\": \"https://dorar.net/tafseer/35/5\",\n       \"answers\": [\n         {\n           \"answer\": \"مُضاعفَةِ الأَجرِ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"الكَفِّ عن الشَّهَواتِ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"الانتفاعِ بإنذارِ النَّبِيِّ صلَّى الله عليه وسلَّم\",\n           \"t\": 1\n         }\n       ],\n       \"category\": \"التفسير\",\n       \"topic\": \"فاطر\"\n     },\n     {\n       \"id\": 19,\n       \"q\": \"القَهْقَهةُ (الضَّحِكُ) في الصلاةِ\",\n       \"link\": \"https://www.dorar.net/feqhia/443\",\n       \"answers\": [\n         {\n           \"answer\": \"لا تَنقُضُ الوُضوءَ، وإنْ كانت تُفسِدُ الصلاةَ\",\n           \"t\": 1\n         },\n         {\n           \"answer\": \"تَنقُضُ الوُضوءَ ولا تَنقُضُ الصلاةَ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"تَنقُضُ الوُضوءَ والصلاةَ\",\n           \"t\": 0\n         }\n       ],\n       \"category\": \"الفقه\",\n       \"topic\": \"الطهارة\"\n     },\n     {\n       \"id\": 8,\n       \"q\": \"أصدرَتِ الحكومةُ التركيةُ برئاسةِ مصطفى كمال أتاتورك قرارًا حكوميًّا سنةَ 1353هـ 1934م بتوقُّفِ الصلاةِ في:\",\n       \"link\": \"https://www.dorar.net/history/?page=255\",\n       \"answers\": [\n         {\n           \"answer\": \"جامعِ الفاتِحِ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"جامعِ أيوب سُلطان\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"جامِعِ آيا صُوفْيا\",\n           \"t\": 1\n         }\n       ],\n       \"category\": \"التاريخ\",\n       \"topic\": \"التاريخ المعاصر\"\n     }\n   ]\n   ```\n\n   - id: معرف السؤال.\n   - q: نص السؤال.\n   - link: رابط إلى مزيد من المعلومات حول السؤال.\n   - answers: قائمة بالإجابات المحتملة:\n   - answer: نص الإجابة.\n   - t: تشير إلى ما إذا كانت الإجابة صحيحة (1) أم لا (0).\n   - category: الفئة التي ينتمي إليها السؤال.\n   - topic: الموضوع المحدد للسؤال.\n\n6. **عرض جميع الأسئلة لفئة معينة**\n\n   ```http\n   GET /api/categories/1/questions?page=1\u0026limit=10\n   ```\n\n   الإستجابة:\n\n   ```json\n   {\n     \"page\": 1,\n     \"limit\": 10,\n     \"totalQuestions\": 2400,\n     \"totalPages\": 240,\n     \"questions\": [\n       {\n         \"id\": 1,\n         \"q\": \"من أسْماءِ سورةِ الفاتحةِ:\",\n         \"link\": \"https://dorar.net/tafseer/1#tt1\",\n         \"answers\": [\n           {\n             \"answer\": \"فاتحةُ الكِتابِ\",\n             \"t\": 1\n           },\n           {\n             \"answer\": \"أمُّ السوَرِ\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"نورُ الهدايةِ\",\n             \"t\": 0\n           }\n         ],\n         \"category\": \"التفسير\",\n         \"topic\": \"الفاتحة\"\n       },\n       {\n         \"id\": 2,\n         \"q\": \"من فَضائلِها\",\n         \"link\": \"https://dorar.net/tafseer/1#tt1\",\n         \"answers\": [\n           {\n             \"answer\": \"حُصولُ السَّعةُ في الرِّزقِ\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"حُصولُ المناجاةِ في الصَّلاةِ بينَ العَبدِ وربِّه\",\n             \"t\": 1\n           },\n           {\n             \"answer\": \"النَّجاةُ من عَذابِ القَبرِ\",\n             \"t\": 0\n           }\n         ],\n         \"category\": \"التفسير\",\n         \"topic\": \"الفاتحة\"\n       },\n       {\n         \"id\": 3,\n         \"q\": \"من خَصائصِ سورةِ الفاتحةِ\",\n         \"link\": \"https://dorar.net/tafseer/1#tt1\",\n         \"answers\": [\n           {\n             \"answer\": \"أنَّه لا صَلاةَ لِمَن لم يَقْرأْ بها\",\n             \"t\": 1\n           },\n           {\n             \"answer\": \"أنَّها تعصِمُ من فِتنةِ الدجَّالِ\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"أنَّ قِراءَتَها تَفتحُ أَبوابَ الخيرِ\",\n             \"t\": 0\n           }\n         ],\n         \"category\": \"التفسير\",\n         \"topic\": \"الفاتحة\"\n       },\n       {\n         \"id\": 4,\n         \"q\": \"من فَضائلِ سورةِ الفاتحةِ\",\n         \"link\": \"https://dorar.net/tafseer/1#tt2\",\n         \"answers\": [\n           {\n             \"answer\": \"أنَّها تُعينُ على قيامِ الليلِ\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"أنَّها رُقْيةٌ شافيةٌ\",\n             \"t\": 1\n           },\n           {\n             \"answer\": \"أنَّها تَزيدُ في الرِّزقِ\",\n             \"t\": 0\n           }\n         ],\n         \"category\": \"التفسير\",\n         \"topic\": \"الفاتحة\"\n       },\n       {\n         \"id\": 5,\n         \"q\": \"معنى الربِّ هو:\",\n         \"link\": \"https://www.dorar.net/tafseer/1/1#tt7\",\n         \"answers\": [\n           {\n             \"answer\": \"المُستحِقُّ للحَمدِ\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"الذي لا يُعبَدُ سِواهُ\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"السيِّدُ، والمالِكُ، والمصلِحُ، والصَّاحبُ، والمُرَبِّي، والخالِقُ\",\n             \"t\": 1\n           }\n         ],\n         \"category\": \"التفسير\",\n         \"topic\": \"الفاتحة\"\n       },\n       {\n         \"id\": 6,\n         \"q\": \"المقصودُ بالضَّالِّينَ في قولِه تعالى: {غَيْرِ الْمَغْضُوبِ عَلَيْهِمْ وَلَا الضَّالِّينَ} هُم:\",\n         \"link\": \"https://www.dorar.net/tafseer/1/1#tt4\",\n         \"answers\": [\n           {\n             \"answer\": \"المرتَدُّونَ الذين آمنُوا ثم كَفرُوا فطَبعَ اللهُ على قُلوبِهم\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"النَّصارى ومَن سلَك طريقتَهم ممَّن جهِلوا الحقَّ، فعبَدوا اللهَ تعالى بغَيرِ عِلمٍ\",\n             \"t\": 1\n           },\n           {\n             \"answer\": \"الذين قال الله فيهم: {الَّذِينَ ضَلَّ سَعْيُهُمْ فِي الْحَيَاةِ الدُّنْيَا وَهُمْ يَحْسَبُونَ أَنَّهُمْ يُحْسِنُونَ صُنْعًا}\",\n             \"t\": 0\n           }\n         ],\n         \"category\": \"التفسير\",\n         \"topic\": \"الفاتحة\"\n       },\n       {\n         \"id\": 7,\n         \"q\": \"مِن صِفاتِ الذينَ أنعَمَ اللهُ تعالى عليهمُ المذكورةِ في سورةِ الفاتحةِ:\",\n         \"link\": \"https://dorar.net/tafseer/1/1#tt7\",\n         \"answers\": [\n           {\n             \"answer\": \"أنَّهم لَيسوا كاليَهودِ\",\n             \"t\": 1\n           },\n           {\n             \"answer\": \"أنَّهم منَ الصَّابِرينَ\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"أنَّهم لَيسوا منَ المنافِقينَ\",\n             \"t\": 0\n           }\n         ],\n         \"category\": \"التفسير\",\n         \"topic\": \"الفاتحة\"\n       },\n       {\n         \"id\": 8,\n         \"q\": \"الرَّحْمَنِ الرَّحِيمِ:\",\n         \"link\": \"https://www.dorar.net/tafseer/1/1#tt4\",\n         \"answers\": [\n           {\n             \"answer\": \"اسْمانِ مُشتَقَّانِ منَ الرَّحمةِ على وَجهِ المُبالَغةِ، والرَحيمٌ أشَدُّ مُبالَغةً من الرَحمنَ\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"اسْمانِ مُشتَقَّانِ منَ الرَّحمةِ على وَجهِ المُبالَغةِ، والرَحمنُ تدُلُّ على الرَحيمٍ، دونَ فَرقٍ بَينَهما\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"اسْمانِ مُشتَقَّانِ منَ الرَّحمةِ على وَجهِ المُبالَغةِ، والرَحمنُ أشدُّ مُبالَغةً من الرَحيمٍ\",\n             \"t\": 1\n           }\n         ],\n         \"category\": \"التفسير\",\n         \"topic\": \"الفاتحة\"\n       },\n       {\n         \"id\": 9,\n         \"q\": \"معنى: {مَالِكِ يَوْمِ الدِّينِ}\",\n         \"link\": \"https://dorar.net/tafseer/1/1#tt4\",\n         \"answers\": [\n           {\n             \"answer\": \"المتصرِّفُ في جميعِ خلْقِه بالفِعلِ فقطْ\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"المتصرِّفُ في جميعِ خلْقِه بالقَولِ فقطْ\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"المتصرِّفُ في جميعِ خلْقِه بالقَولِ والفِعلِ\",\n             \"t\": 1\n           }\n         ],\n         \"category\": \"التفسير\",\n         \"topic\": \"الفاتحة\"\n       },\n       {\n         \"id\": 10,\n         \"q\": \"في قولُه صلَّى اللهُ عليه وسلَّمَ: \\\"وما يُدْريكَ أنَّها رُقْيةٌ؟\\\" يُقصَدُ بها:\",\n         \"link\": \"https://dorar.net/tafseer/1#tt1\",\n         \"answers\": [\n           {\n             \"answer\": \"المعوِّذتان\",\n             \"t\": 0\n           },\n           {\n             \"answer\": \"سورةُ الفاتحة\",\n             \"t\": 1\n           },\n           {\n             \"answer\": \"سورةُ الإخْلاص\",\n             \"t\": 0\n           }\n         ],\n         \"category\": \"التفسير\",\n         \"topic\": \"الفاتحة\"\n       }\n     ]\n   }\n   ```\n\n   - page: رقم الصفحة الحالية.\n   - limit: عدد الأسئلة في الصفحة.\n   - totalQuestions: إجمالي عدد الأسئلة.\n   - totalPages: إجمالي عدد الصفحات.\n   - questions: قائمة الأسئلة:\n   - id: معرف السؤال.\n   - q: نص السؤال.\n   - link: رابط لمزيد من المعلومات حول السؤال.\n   - answers: قائمة بالإجابات المحتملة:\n   - answer: نص الإجابة.\n   - t: تشير إلى ما إذا كانت الإجابة صحيحة (1) أم لا (0).\n   - category: الفئة التي ينتمي إليها السؤال.\n   - topic: الموضوع المحدد للسؤال.\n\n7. **عرض جميع الأسئلة لموضوع معين**\n\n   ```http\n   GET /api/categories/1/topics/some-topic/questions\n   ```\n\n   الإستجابة:\n\n   ```json\n   [\n     {\n       \"id\": 1,\n       \"q\": \"من أسْماءِ سورةِ الفاتحةِ:\",\n       \"link\": \"https://dorar.net/tafseer/1#tt1\",\n       \"answers\": [\n         {\n           \"answer\": \"فاتحةُ الكِتابِ\",\n           \"t\": 1\n         },\n         {\n           \"answer\": \"أمُّ السوَرِ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"نورُ الهدايةِ\",\n           \"t\": 0\n         }\n       ],\n       \"category\": \"التفسير\",\n       \"topic\": \"الفاتحة\"\n     },\n     {\n       \"id\": 2,\n       \"q\": \"من فَضائلِها\",\n       \"link\": \"https://dorar.net/tafseer/1#tt1\",\n       \"answers\": [\n         {\n           \"answer\": \"حُصولُ السَّعةُ في الرِّزقِ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"حُصولُ المناجاةِ في الصَّلاةِ بينَ العَبدِ وربِّه\",\n           \"t\": 1\n         },\n         {\n           \"answer\": \"النَّجاةُ من عَذابِ القَبرِ\",\n           \"t\": 0\n         }\n       ],\n       \"category\": \"التفسير\",\n       \"topic\": \"الفاتحة\"\n     },\n     {\n       \"id\": 3,\n       \"q\": \"من خَصائصِ سورةِ الفاتحةِ\",\n       \"link\": \"https://dorar.net/tafseer/1#tt1\",\n       \"answers\": [\n         {\n           \"answer\": \"أنَّه لا صَلاةَ لِمَن لم يَقْرأْ بها\",\n           \"t\": 1\n         },\n         {\n           \"answer\": \"أنَّها تعصِمُ من فِتنةِ الدجَّالِ\",\n           \"t\": 0\n         },\n         {\n           \"answer\": \"أنَّ قِراءَتَها تَفتحُ أَبوابَ الخيرِ\",\n           \"t\": 0\n         }\n       ],\n       \"category\": \"التفسير\",\n       \"topic\": \"الفاتحة\"\n     }\n   ]\n   ```\n\n   - id: معرف السؤال.\n   - q: نص السؤال.\n   - link: رابط لمزيد من المعلومات حول السؤال.\n   - answers: قائمة بالإجابات المحتملة:\n   - answer: نص الإجابة.\n   - t: تشير إلى ما إذا كانت الإجابة صحيحة (1) أم لا (0).\n   - category: الفئة التي ينتمي إليها السؤال.\n   - topic: الموضوع المحدد للسؤال.\n\n---\n\n## **هيكلية الملفات والمجلدات**\n\n```\nIslamicQuizAPI/\n│\n├── database/               # يحتوي على ملفات JSON SQLITE C\n│\n├── src/                    # مجلد المصدر الرئيسي\n│   ├── routes/             # يحتوي على تعريف المسارات والوظائف\n│   │   └── quizRoutes.mjs\n│   ├── logger.mjs          # ملف تسجيل الأخطاء والعمليات\n│   └── index.mjs           # ملف الدخول الرئيسي للتطبيق\n│\n├── unused/                 # يحتوي على سكربتات وملفات غير مستخدمة\n│\n├── .env                    # ملف إعداد المتغيرات البيئية\n├── package.json            # تعريف المشروع والتبعيات\n└── README.md               # التوثيق\n```\n\n---\n\n## **التبعيات**\n\n- **Express**: لإنشاء السيرفر.\n- **Helmet**: لتعزيز أمان التطبيق.\n- **Rate Limiting**: لتحديد عدد الطلبات لكل IP.\n- **CORS**: للسماح بالوصول عبر مصادر متعددة.\n- **fs-extra**: للتعامل مع ملفات JSON.\n- **dotenv**: لتحميل المتغيرات البيئية.\n- **better-sqlite3**: لتحويل البيانات إلى SQLite.\n- **json2csv**: لتحويل البيانات إلى CSV.\n\n---\n\n## **المساهمة في المشروع**\n\n1. قم بعمل **Fork** من المشروع.\n2. أنشئ فرعًا جديدًا باستخدام:\n   ```bash\n   git checkout -b feature/new-feature\n   ```\n3. أضف تعديلاتك وقدم طلب سحب (**Pull Request**).\n\n---\n\n## **رخصة الاستخدام**\n\nهذا المشروع مرخص تحت **رخصة MIT**، مما يسمح بالاستخدام المفتوح والتعديل بحرية.\n\n---\n\n## **المستودع**\n\nرابط المشروع على GitHub:  \n[IslamicQuizAPI - GitHub](https://github.com/rn0x/IslamicQuizAPI)\n\n---\n\n\n## تحميل القاعدة\n\n\u003cdiv align=\"center\"\u003e\n\n![quran-data](https://img.shields.io/github/downloads/rn0x/IslamicQuizAPI/total?color=blue\u0026label=Total%20Downloads)\n\n[json](https://github.com/rn0x/IslamicQuizAPI/releases/download/database/database.json)\n\n[sqlite](https://github.com/rn0x/IslamicQuizAPI/releases/download/database/database.sqlite)\n\n[csv](https://github.com/rn0x/IslamicQuizAPI/releases/download/database/database.csv)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[dorar.net](https://dorar.net/m3lama) | جميع البيانات ماخوذه من موقع معلمة الدرر\n\n**لا تنسنا من دعوة صالحة بظهر الغيب 🤲**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frn0x%2FIslamicQuizAPI","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frn0x%2FIslamicQuizAPI","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frn0x%2FIslamicQuizAPI/lists"}