متنافسونMutanafisoon

«وَفِى ذَٰلِكَ فَلْيَتَنَافَسِ ٱلْمُتَنَـٰفِسُونَ»

المطففين 26

طبقة تحفيز لتطبيقات القرآن، يتنافس فيها المرء مع نفسهA motivation layer for Quran apps, where each learner competes only with themselves

نقاط على الوفاء بالورد الذي يختاره المتعلّم، ومداومة رحيمة لا تنكسر بيوم فائت، وأوسمة لا تُسحب، وبشارات من أحاديث مخرّجة تظهر في وقتها.Points for keeping the wird each learner chooses, a merciful streak that a missed day does not break, medals that are never taken back, and authenticated hadith that appear at the right moment.

واجهة مستضافة (API) في فترة تجريبية مع أول التطبيقات، وسيُفتح مصدر الحزمة بعدها. لا لوحة صدارة، ولا رقم يُنسب إلى الأجر.A hosted API, in beta with our first apps; the package goes open source after the beta. No leaderboard, and no number is ever attached to reward.

جرّب المحرّك الحقيقيTry the real engine

النقاطPoints
0
الوردWird
5
المداومة الحاليةCurrent run
0
أيام محفوظةKept days
0

    ما يراه المتعلّمWhat the learner sees

      ماذا يقدّمWhat you get

      أربع قطع تعمل معًا أو كلٌّ على حدة، فاختر ما يناسب تطبيقك.Four pieces that work together or on their own. Use the ones your app needs.

      محرّك يعمل داخل تطبيقكAn engine inside your app
      حزمة @tajweedoo/mutanafisoon بلا اعتمادات تشغيل. ترسل لها أحداثًا مثل «قرأ 2:1-20» فتعيد لك ما يُعرض للمتعلّم: نقاط، ووفاء بالورد، واستدراك، وأوسمة، وبشارات. البيانات تبقى عندك.The @tajweedoo/mutanafisoon package has no runtime dependencies. Send it events such as “read 2:1-20” and it returns what to show the learner: points, wird kept, make-ups, medals and bisharat. Data stays with you.
      واجهة مستضافةA hosted API
      إن كان تطبيقك على أكثر من جهاز، أرسل الأحداث من خادمك إلى الواجهة بمفتاح خاص، واقرأ التقدّم من أي مكان. تحفظ مراجع الآيات فقط، ولا تستقبل نص القرآن أبدًا.If your learners use several devices, send events from your server with a private key and read progress anywhere. It stores ayah references only, never Quran text.
      بطاقة جاهزةA ready-made card
      عنصر <mutanafisoon-card> يعرض حلقة الورد والنقاط والمداومة والأوسمة، من اليمين إلى اليسار، وتغيّر ألوانه بمتغيرات --mtn-*.The <mutanafisoon-card> element shows the wird ring, points, constancy and medals, right-to-left by default, themed with --mtn-* variables.
      سبع عشرة بشارة مخرّجةSeventeen authenticated bisharat
      لكل بشارة نص الحديث وتخريجه ورابط مصدره، وتظهر عند مناسبتها: الكهف يوم الجمعة، وخواتيم البقرة ليلًا، والملك قبل النوم. ولك أن تعطّل أيًّا منها.Each comes with its hadith text, takhrij and a source link, and appears when it fits: al-Kahf on Friday, the last ayat of al-Baqarah at night, al-Mulk at bedtime. You can switch any of them off.

      الميثاقThe charter

      هذه ليست وعودًا في صفحة؛ هي قيود في الكود. الإعداد الذي يخالفها يُرفض عند التشغيل.These are not promises on a page; they are constraints in the code. A configuration that breaks them is rejected at start-up.

      لاNo

      • لا رقم يُنسب إلى الأجر. أي عنوان أو وسام فيه «حسنات» أو «أجر» أو «ثواب» يُرفض.No number attached to reward. Any label or medal mentioning hasanat, ajr or thawab is rejected.
      • لا لوحة صدارة ولا مقارنة بين المتعلّمين، لا في الحزمة ولا في الواجهة.No leaderboard and no comparison between learners, in the package or the API.
      • لا خصم نقاط ولا سحب أوسمة ولا رسائل تخويف.No deductions, no medals taken away, no fear messages.
      • لا صناديق عشوائية ولا مكافآت متغيرة ولا مراهنة.No loot boxes, variable rewards or wagers.

      نعمYes

      • النقاط على الوفاء بالورد الذي يحدده المتعلّم لنفسه، لا على الكمية.Points for keeping the wird the learner sets for themselves, not for volume.
      • رحمة في المداومة: لا تنكسر إلا بعد فجوة أطول من يومين على الأقل، ويمكن استدراك ما فات.Merciful constancy: a run survives gaps of at least two days, and missed days can be made up.
      • ترحيب بعد الغياب، لا عتاب.A welcome after absence, never a reproach.
      • خصوصية: معرّفات مستعارة فقط، ومراجع الآيات دون نصها، وحق المحو. ووضعا قبل النوم والقيام يفعّلهما المتعلّم بنفسه.Privacy: pseudonymous ids only, ayah references without text, and the right to erasure. Bedtime and qiyam modes are opt-in by the learner.

      البشارات السبع عشرةThe seventeen bisharat

      راجعها مختص، وكلها من أحاديث صحيحة أو حسنة. افتح أيًّا منها لترى نص الحديث وتخريجه ومصدره. تبقى بالعربية في كل اللغات.Reviewed by a specialist; every one is from a sahih or hasan hadith. Open one to see its text, takhrij and source. They stay in Arabic in every language.

        البشارة 17 (الحلقة) نصّها «في بيت من بيوت الله»، فالحلقات عن بُعد محل نظر شرعي. يمكنك تعطيلها بـ bisharat: { disabled: ['halaqa'] }.Bishara 17 (halaqa) says “in one of the houses of Allah”, so remote circles are a matter of scholarly consideration. You can switch it off with bisharat: { disabled: ['halaqa'] }.

        التضمينIntegration

        ثلاث خطوات، ثم تعرض للمتعلّم ما يعيده المحرّك.Three steps, then show the learner whatever the engine returns.

        1. اطلب مفتاحًاRequest a keyفي الفترة التجريبية يكون الاستعمال عبر الواجهة المستضافة بمفتاح نراجعه يدويًا.During the beta, everything goes through the hosted API with a hand-reviewed key.
        2. أرسل الأحداثSend eventsعند فتح المصحف، وإتمام القراءة أو المراجعة أو الدرس، وتحديد الورد.When the mushaf opens, when reading, review or a lesson completes, and when the wird is set.
        3. اعرض الاعترافاتShow recognitionsكل حدث يعيد قائمة رسائل جاهزة للعرض، ومعها التقدّم متى طلبته.Each event returns ready-to-show messages, and progress whenever you ask.
        MTN_API=https://mutanafisoon-api.tajweedoo.com
        
        curl -X POST "$MTN_API/v1/events" \
          -H "Authorization: Bearer $MTN_KEY" \
          -H "Content-Type: application/json" \
          -d '{"timeZone":"Africa/Cairo","events":[
                {"learnerId":"u_7f3a","type":"reading.completed","ref":"2:1-5","id":"evt-1"}
              ]}'
        
        curl "$MTN_API/v1/learners/u_7f3a/progress?tz=Africa/Cairo" \
          -H "Authorization: Bearer $MTN_KEY"

        أبقِ المفتاح في خادمك؛ لا تضعه في صفحة ويب عامة ولا في حزمة تطبيق الجوال.Keep the key on your server; never put it in a public web page or a mobile app bundle.

        أنواع الأحداثEvent types
        الحدثEvent الحقولFields الأثرEffect
        mushaf.opened—+1 مرة يوميًا+1 once a day
        reading.completedref? pages? minutes? mode?يحتسب الورد والختمة وإتمام السور، ويطلق بشارات الأوقاتCounts toward the wird, the khatma and surah completion; triggers time-based bisharat
        wird.setwird: {amount, unit}يحفظ ورد المتعلّم (آيات أو صفحات أو دقائق)Saves the learner's wird (ayat, pages or minutes)
        review.completedref?مثل القراءة، و+2 مرة يوميًا، وبشارة التعاهدLike reading, plus +2 once a day and its bishara
        lesson.completed—+2 مرة يوميًا، وبشارة التعلّم+2 once a day and its bishara
        practice.completedstruggled? corrections?بشارة المشقة عند التعثّر أو 3 تصحيحات فأكثرThe struggle bishara when struggling or with 3+ corrections
        memorization.verifiedrefبشارة حفظ العشر الأوائل أو الأواخر من الكهفThe bishara for memorising the first or last ten ayat of al-Kahf
        halaqa.attendedgroupId?بشارة الحلقة (يمكن تعطيلها)The halaqa bishara (can be switched off)

        تطبيقات تستخدم متنافسونApps using Mutanafisoon

        بموافقة أصحابها، ومرتبة أبجديًا. لا أرقام ولا ترتيب، فالتنافس هنا بين المرء ونفسه.With their owners' consent, listed alphabetically. No numbers and no ranking.

          نبدأ الآن مع أول التطبيقات. اطلب مفتاحًا وكن منها.We are starting with our first apps. Request a key and be one of them.

          اطلب مفتاح APIRequest an API key

          نحن في فترة تجريبية مع عدد محدود من التطبيقات. نراجع كل طلب يدويًا ونردّ على بريدك.We are in a beta with a small number of apps. We review each request by hand and reply by email.

          من 20 إلى 2000 حرف. صف تطبيقك والأحداث التي سترسلها.20 to 2000 characters. Describe your app and the events you will send.
          اختياري. لا يظهر إلا بعد مراجعتنا ومع استعمال فعلي، ويمكنك سحب الموافقة في أي وقت.Optional. Shown only after our review and with real usage; you can withdraw at any time.