التحقق من بريدك الإلكتروني ورقم الهاتف — بطاقات التحقق

أين تجدها

كلاهما على المركز الرئيسي (/dashboard/) و إعدادات الحساب → نظرة عامة (/user/account/) سترى بطاقتين — البريد الإلكتروني و الهاتف. اللون يخبرك بكل شيء في لمحة:

• بطاقة خضراء — تم التحقق منها. لا يوجد شيء يجب القيام به.
• بطاقة حمراء — تحتاج إلى إجراء، وكل أداة تحتاجها موجودة داخل البطاقة نفسها.
• بطاقة متقطعة — الهاتف لم يضاف بعد (اختياري؛ يضيف ميزات إضافية).

داخل بطاقة البريد الإلكتروني الحمراء

1. أرسل لي الرمز عبر البريد الإلكتروني — يرسل رمزًا جديدًا مكونًا من 6 أحرف إلى عنوانك (تحقق من مجلد الرسائل المزعجة إذا لم يصل خلال دقيقة).
2. مربع الرمز — اكتب الرمز هناك واضغط على تحقق. لا حاجة للبحث عن صفحة منفصلة. الأحرف أو الأرقام، أي حالة تعمل.
3. تغيير البريد الإلكتروني — إذا كان العنوان خاطئًا، قم بتصحيحه أولاً؛ يجب التحقق من عنوان جديد مرة أخرى، والعنوان الذي تم استخدامه بالفعل بواسطة حساب آخر سيتم رفضه.

بعد التحقق (أو إعادة الإرسال)، تعود مباشرة إلى الصفحة التي كنت عليها.

مفتاح النظام الهاتفي الرئيسي (المسؤول)

النظام الهاتفي بالكامل محمي خلف مفتاح مسؤول واحد في /adminapp/communication-settings/sms/ (“مفتاح النظام الهاتفي الرئيسي”). بينما هو OFF (الإعداد الافتراضي)، لا يرى المستخدمون أي بطاقة هاتف، لا صفحات إضافة الهاتف أو تحقق الهاتف — فقط تحقق البريد الإلكتروني. قم بتشغيله بعد اختيار موفر SMS وإعداده؛ تعرض الصفحة مقارنات أسعار الموفرين وتحذر من أن الهيكل المدمج يطبع الرموز فقط إلى سجلات الخادم. الأرقام المحفوظة تبقى موجودة عند التبديل.

بطاقة الهاتف

نفس الفكرة لأرقام الولايات المتحدة: أرسل لي رمزًا عبر الرسائل النصية، ثم مربع الرمز مباشرةً في البطاقة. إضافة رقم تدعم أي دولة (الولايات المتحدة مدرجة أولاً) — ولكن تحديثات التحقق يمكن أن تصل حاليًا إلى أرقام الولايات المتحدة فقط، لذلك تظل الأرقام من دول أخرى محفوظة في الملف الشخصي وتظهر في بطاقة هادئة “محفوظة” حتى يمتد تغطية الرسائل النصية. بمجرد عدم احتياج أي شيء لإجراء المستخدم، يدمج المركز الرئيسي البطاقات في شريط أخضر نحيف بحيث يبقى مساحة العمل نظيفة — تحتفظ صفحة الحساب بالبطاقات الكاملة.

للمطورين

• جزء مشترك: userapp/templates/userapp/_verification_cards.html (تضمين مع card_next = "hub"/"account"، اختياري compact_verified).
• النماذج المدمجة تحمل حقل next; _verification_next() في userapp/views.py تحدده فقط إلى طرق مسماة (لا إعادة توجيه مفتوحة).
• اختبارات: userapp.tests.VerificationCardsTests (10).

تسليم الرسائل النصية الفعلي (2026-08)

رموز تحقق الهاتف لم تعد تقتصر على الطباعة فقط. userapp/sms.py::send_sms تنشر إلى واجهة برمجة تطبيقات Twilio REST من خلال requests العادية (بدون SDK) عندما توجد ثلاثة أشياء: المتغيرات البيئية TWILIO_ACCOUNT_SID و TWILIO_AUTH_TOKEN على Render، ورقم From المحفوظ على /adminapp/communication-settings/sms/. مع فقدان أي منها، لا يتغير السلوك — تُطبع الرموز إلى وحدة التحكم الخاصة بالخادم ولا يتم احتساب أي شيء (آمن في dev/CI).

حراس التكلفة (تكون نشطة فقط بينما تكون Twilio حية — وضع الهيكل يحتفظ بالسلوك غير المحدود القديم): add_phone يرفض طلب الرمز الرابع ضمن ساعة واحدة، يُحسَب لكل مستخدم وأيضًا لكل رقم هاتف تحت قفل صفوف لكل مستخدم، ويفرض سعة يومية شاملة(userapp/sms.py::GLOBAL_DAILY_CAP) ضد ضخ الرسائل النصية. تستثنى المناطق الممتازة في الكاريبي +1 (جامايكا، جمهورية الدومينيكان، …) من تدفق رموز الولايات المتحدة في userapp/phones.py::phone_is_us. حذف إرسال Twilio الفاشل صفاحته غير المستخدمة (لا حرق للحصة) ويظهر رسالة إعادة المحاولة بطريقة ودية. يجب على المسؤولين تمكين أيضًا حماية ضخ رسائل Twilio + الأذونات الجغرافية الخاصة بالولايات المتحدة فقط — خطوات على صفحة إعدادات SMS.

إعداد المسؤول: خطوات نقرة بنقرة مباشرة على صفحة إعدادات SMS و كمهمة في قائمة التحقق للإعداد SMS-1 (المفتاح المدقق sms_delivery يتحول إلى الأخضر تلقائيًا عند اكتشاف بيانات الاعتماد + رقم From). الاختبارات: userapp/test_sms.py.