البدء
إنشاء حساب
يسجّل المستخدمون الجدد عبر /register. تنقسم الشاشة إلى لوحة تسويقية على اليسار (تضم عنوانًا متحركًا «مرحبًا بك في Apps Kit SDK»، ووصفًا للمنتج في سطر واحد، وثلاث بطاقات إحصائية متحركة — إيرادات أعلى، ومعدلات المطابقة، والأعطال وعدم استجابة التطبيق (ANR) — وهي محتوى تسويقي للتزيين، وليست بيانات عن حسابك) ونموذج تسجيل على اليمين.
يجمع نموذج التسجيل البيانات التالية:
- الاسم الكامل — مطلوب.
- البريد الإلكتروني — مطلوب، ويجب أن يكون عنوان بريد إلكتروني صالحًا.
- كلمة المرور — مطلوبة، ويجب ألا تقل عن 8 أحرف، وأن تحتوي على حرف لاتيني كبير واحد وحرف لاتيني صغير واحد ورمز خاص واحد على الأقل (مثل
!@#$%^&*).
يؤدي النقر على إنشاء حساب إلى إنشاء حساب في Firebase باستخدام البريد الإلكتروني وكلمة المرور، وإرسال رسالة تحقق من البريد الإلكتروني عبر Firebase فورًا، ثم تسجيل المستخدم في الواجهة الخلفية لـ Apps Kit SDK (POST /oauth/login مع oauthProvider: "email"). بعد ذلك، يُعاد توجيهك إلى /login — إنشاء الحساب لا يسجّل دخولك تلقائيًا، ولا يمكنك تسجيل الدخول حتى تتحقق من بريدك الإلكتروني (راجع قسم تسجيل الدخول أدناه).
بدلًا من ذلك، يستخدم خيار التسجيل باستخدام Google نافذة Google المنبثقة عبر Firebase (signInWithPopup) ويسجّل الحساب باستخدام oauthProvider: "gmail". لا يتطلب التسجيل باستخدام Google تحققًا منفصلًا من البريد الإلكتروني، وينقلك مباشرةً إلى / (تطبيقاتي) أو /users بحسب نوع الحساب.
يعيدك رابط «لديك حساب بالفعل؟ سجّل الدخول هنا» إلى /login.
تسجيل الدخول
تستخدم شاشة تسجيل الدخول (/login) تخطيط اللوحتين نفسه المستخدم في شاشة التسجيل: لوحة تسويقية على اليسار وبطاقة تسجيل الدخول الفعلية على اليمين.
LOGIN_SCREEN_IMAGE
يتضمن نموذج تسجيل الدخول ما يلي:
- البريد الإلكتروني — مطلوب، ويجب أن يكون بصيغة بريد إلكتروني صالحة.
- كلمة المرور — مطلوبة.
- زر تبديل لإظهار كلمة المرور أو إخفائها (أيقونة عين) في حقل كلمة المرور.
- متابعة — زر الإرسال، ويظل معطّلًا حتى تستوفي بيانات النموذج شروط التحقق.
- تذكّرني — مربع اختيار يحفظ، عند تحديده، عنوان بريدك الإلكتروني (وليس كلمة المرور) في المتصفح، ليُملأ تلقائيًا في زيارتك التالية.
- هل نسيت كلمة المرور؟ — رابط إلى
/forget-password. - زر «تسجيل الدخول باستخدام Google» — يستخدم مسار نافذة Firebase المنبثقة نفسه المستخدم عند التسجيل باستخدام Google، ولكن للحسابات الحالية.
- «مستخدم جديد؟ سجّل هنا» — رابط إلى
/register.
يتحقق تسجيل الدخول باستخدام البريد الإلكتروني وكلمة المرور أيضًا من تأكيد عنوان البريد الإلكتروني لحسابك في Firebase؛ وإذا لم يكن مؤكدًا، فستظهر لك رسالة «يُرجى التحقق من بريدك الإلكتروني أولًا.» ولن يُسجَّل دخولك. بعد نجاح تسجيل الدخول (بأي من الطريقتين)، تُوجَّه إلى / (تطبيقاتي) إذا كان حسابك حساب مستخدم عادي، أو إلى /users إذا كان حسابًا داخليًا أو حساب مسؤول.
نسيت كلمة المرور
تحتوي صفحة /forget-password على نموذج بحقل واحد (عنوان بريدك الإلكتروني فقط). يؤدي إرساله إلى استدعاء sendPasswordResetEmail في Firebase — لا توجد خطوات لإعادة تعيين كلمة المرور داخل البوابة؛ بل تتلقى رابط إعادة التعيين عبر البريد الإلكتروني، وتظهر رسالة عابرة تؤكد «تم إرسال رسالة إعادة تعيين كلمة المرور. يُرجى التحقق من بريدك الوارد»، ثم تُعاد إلى /login. يتوفر أيضًا رابط «العودة إلى تسجيل الدخول؟» مباشرةً في الصفحة.
شريط التنقل العلوي
بعد تسجيل الدخول، تعرض كل صفحة (باستثناء شاشات المصادقة) شريط تنقل علويًا يتضمن قائمة حسابك على اليمين، وبجوارها جرس إشعارات يظهر في صفحة «تطبيقاتي» فقط.
قائمة الحساب. يؤدي النقر على صورتك الرمزية أو اسمك أو بريدك الإلكتروني في أعلى اليمين إلى فتح قائمة منسدلة تتضمن:
- صف «حسابي» الذي يمثل حسابك الشخصي (تشير نقطة زرقاء إلى أنه السياق النشط عند اختياره).
- قسم «تمت مشاركته معي» — لا يظهر إلا إذا كنت قد قبلت دعوة مشاركة واحدة على الأقل من فريق آخر. ويعرض اسم كل مُرسِل دعوة وبريده الإلكتروني وصورته الرمزية. يؤدي النقر على أحدهم إلى تبديل سياق البوابة بالكامل إلى حسابه (تقنيًا: يُرسَل الإجراء
switchAccount())، بحيث يعكس كل ما تراه بعد ذلك — تطبيقاتي، والعلامات التجارية، والحملات، وغيرها — موارد ذلك الحساب، مع تصفيتها وفقًا للصلاحيات الممنوحة لك. - تذييل يتغير بحسب السياق: إذا كنت تستعرض حسابك الشخصي، فسيظهر رابط «الملف الشخصي». أما إذا كنت تستعرض حاليًا حسابًا مشتركًا انتقلت إليه، فسيظهر بدلًا منه زر أحمر بعنوان «خروج → تمت مشاركته معي» يعيدك إلى حسابك الشخصي وينقلك إلى صفحة «تمت مشاركته معي».
عند استعراض حساب انتقلت إليه، يعرض شريط التنقل أيضًا شارة صغيرة بعنوان «مشترك» بجوار الاسم المعروض، لتظل هوية صاحب البيانات التي تستعرضها واضحة دائمًا.
جرس الإشعارات. لا يظهر إلا في المسارين / و/apps (أي لوحة معلومات «تطبيقاتي») — ولا يظهر في أي موضع آخر بالبوابة. يمثّل العدد الظاهر على شارته إجمالي الإشعارات في جميع مجموعات الإشعارات. يؤدي النقر عليه إلى فتح قائمة منسدلة بعنوان «الإشعارات»، تعرض العناصر مجمّعة حسب النوع، مع رسالة قصيرة لكل عنصر.
يختلف سلوك النقر على إشعار بعينه بحسب نوعه:
- إذا كان نوع الإشعار
upatedSdkVersion(تنبيه «تم تحديث إصدار SDK»)، فإن النقر عليه ينقلك مباشرةً إلى صفحة تفاصيل التطبيق المعني (/app/:id)، ولا يضع علامة «مقروء» على الإشعار. - في جميع أنواع الإشعارات الأخرى، يؤدي النقر إلى الانتقال إلى صفحة تنزيل SDK، ويضع علامة «مقروء» على الإشعار (يستدعي نقطة النهاية الخاصة بوضع علامة «مقروء»، ويعرض رسالة عابرة تقول «تم وضع علامة مقروء على الإشعار بنجاح»).
هذا الجرس مخصص فقط لعرض قائمة منسدلة للاطلاع السريع — وهو واجهة مختلفة وأبسط من صفحة إشعاراتي المخصصة والموضحة لاحقًا في هذا الدليل، كما أن كليهما منفصل عن قائمة الدعوات في تمت مشاركته معي. توجد بالفعل ثلاث واجهات مختلفة للدعوات والإشعارات في البوابة؛ راجع قسم الحساب لمعرفة الفروق بينها.