# ورقة تجهيز Google Play — سجلات الطلاب

> هذه ورقة عمل للنشر، وليست إفصاحاً قانونياً نهائياً. يجب على مالك التطبيق مراجعة كل إجابة داخل Play Console مقابل النسخة الفعلية من التطبيق والخادم قبل الإرسال.

## هوية الإصدار

| البند | القيمة المجهزة |
|---|---|
| اسم التطبيق | سجلات الطلاب |
| اسم الناشر | saraelhaj |
| بريد الدعم والخصوصية | info@saraelhaj.net |
| معرّف الحزمة | `com.saraelhaj.studentrecords` |
| الإصدار الأول | `versionCode: 1` و`versionName: 1.0` |
| نوع الملف | Android App Bundle (`.aab`) |
| رابط سياسة الخصوصية | `https://studentrecor-cabhzy6z.manus.space/privacy` |
| نمط التشغيل | غلاف Capacitor يتصل بالنظام المنشور عبر HTTPS؛ لا يحتفظ بقاعدة MySQL داخل الهاتف |

لا تغيّري معرّف الحزمة بعد إنشاء التطبيق في Play Console. أي تغيير للاسم أو المعرّف قبل النشر الأول يجب أن يُراجع في `capacitor.config.ts` و`android/app/build.gradle` معاً، ثم يعاد بناء AAB.

## نص مقترح لصفحة المتجر

**الاسم:** سجلات الطلاب

**الوصف المختصر:** إدارة آمنة لأرقام الجلوس والاستمارات البنكية مع صلاحيات مستقلة للمدير والمحرر.

**الوصف الكامل:**

> سجلات الطلاب تساعد المؤسسة على تنظيم رقم الجلوس ورقم الاستمارة البنكية في واجهة عربية واضحة. يتيح حساب المدير إنشاء حسابات المدير والمحرر، وإدارة سجلاته، وتنزيل تقرير PDF مفلتر بتاريخ الإدخال. أما حساب المحرر فيدير سجلاته الخاصة فقط ولا يستطيع فتح التقارير. يحفظ النظام أرقام السجلات بصورة منظمة ويمنع تكرار رقم الجلوس أو رقم الاستمارة البنكية على مستوى قاعدة البيانات.

## أصول صفحة المتجر المطلوبة

| الأصل | الحالة | ما يجب عمله قبل الرفع |
|---|---|---|
| رمز التطبيق | جُهّز رمز نهائي نظيف للمراجعة | يوجد في حزمة `saraelhaj-google-play-assets.zip` باسم `app-icon-final.png`؛ يلزم اعتماد الناشر قبل الرفع. |
| لقطات شاشة الهاتف | غير نهائية | التقطي على هاتف فعلي: الدخول، سجل المدير، إنشاء مستخدم محرر، صفحة التقرير، وسجل محرر بلا تقارير. لا تعرضي أرقاماً حقيقية أو بيانات طلاب في اللقطات. |
| بريد دعم واسم المطوّر | معتمدان | الناشر: `saraelhaj`، البريد: `info@saraelhaj.net`. |
| سياسة الخصوصية | متاحة داخل التطبيق وعلى رابط عام | تحتوي على الناشر والبريد ومسار حذف الحساب؛ راجعي النص النهائي داخل Play Console. |

## مسودة مراجعة Data safety

التطبيق يتعامل مع بيانات حسابات محلية وسجلات طلاب تتضمن رقم جلوس ورقم استمارة بنكية. لذلك لا يجوز اختيار إجابة «لا تُجمع بيانات» دون تدقيق. يجب على المالك التحقق من التخزين والخادم وأي خدمات خارجية متصلة قبل الإرسال. تُلزم سياسة Google Play بالإفصاح الدقيق والمحدّث عن جمع البيانات واستخدامها ومشاركتها، وباتساق الإفصاح مع سياسة الخصوصية.[1]

| فئة للمراجعة | الاستخدام المتوقع في هذا التطبيق | الإجراء قبل الإقرار |
|---|---|---|
| اسم الحساب واسم المستخدم | تسجيل الدخول وإدارة الحسابات | أكدي هل يُحفظ الاسم كما هو في قاعدة البيانات المنشورة. |
| كلمة المرور | تحفظ على شكل تجزئة في الخادم، ولا يجب تضمين كلمة السر كنص في أي سجل أو لقطة | راجعي مسار التخزين الآمن والإفصاح المناسب. |
| رقم الجلوس ورقم الاستمارة البنكية | تشغيل سجل الطالب والبحث وإعداد التقارير | اعتبريها بيانات تشغيلية حساسة حتى تؤكدي التصنيف القانوني المحلي وسياسة المؤسسة. |
| ملفات الاستيراد | قراءة CSV/XLSX عند اختيار المدير أو المحرر للملف | صرحي بقراءة الملف لغرض الاستيراد فقط، وراجعي هل يبقى الملف محفوظاً بعد المعالجة. |

> **مسار حذف الحساب:** أصبح مسار الحذف العام متاحاً على `https://studentrecor-cabhzy6z.manus.space/delete-account`، ويطلب من المحرر تسجيل الدخول ثم تأكيد كلمة المرور قبل حذف الحساب وسجلاته. راجعي المسار في النسخة المنشورة قبل إدخاله في حقل الحذف داخل Play Console. تشير سياسة Google Play إلى وجوب إتاحة حذف الحساب من داخل التطبيق ومن مورد ويب خارجي عندما يسمح التطبيق بإنشاء الحسابات.[1]

## التوقيع ورفع الإصدار

تتطلب حزم Android المرفوعة إلى Google Play مفتاح رفع محلي، بينما تدير خدمة Play App Signing مفتاح توقيع التطبيق الذي يستخدم لتوزيع APKs على المستخدمين.[2] احتفظي بمفتاح الرفع وكلمة مروره في مكان مشفّر يملكه صاحب التطبيق؛ لا يُرفَع ملف المفتاح ولا `keystore.properties` إلى المستودع.

1. أنشئي مفتاح رفع RSA لا يقل عن 2048 بت؛ تكوين 4096 بت الموجود في الدليل مناسب.[2]
2. انسخي `android/keystore.properties.example` إلى `android/keystore.properties` واملئي المسارات محلياً فقط.
3. نفذي `pnpm android:sync` ثم `cd android && ./gradlew bundleRelease`.
4. افحصي أن AAB الناتجة موقعة، ثم ارفعيها أولاً إلى مسار اختبار داخلي.
5. عند رفع أول إصدار، فعّلي Play App Signing داخل Play Console. يظل مفتاح الرفع معك ويستخدم للتحقق من كل تحديث لاحق.[2]

## مراجعة أخيرة قبل الإرسال

| بند | مسؤول عنه |
|---|---|
| فتح حساب Play Console وتفعيل التحقق بخطوتين | مالك حساب الناشر |
| اختيار اسم المطوّر وبريد الدعم | مالك التطبيق |
| إنشاء المفتاح وتخزينه خارج المشروع | مالك التطبيق |
| مراجعة Data safety وسياسة الخصوصية والحذف | مالك التطبيق أو المستشار القانوني/الخصوصية |
| اعتماد رابط حذف الحساب وبريد/جهة اتصال الخصوصية | تم تجهيز الرابط والبريد؛ يراجع المالك النص في Play Console |
| رفع AAB الموقعة واختبار مسار Internal testing | مالك حساب Play Console |

## المراجع

[1]: https://support.google.com/googleplay/android-developer/answer/10144311?hl=en "Google Play — User Data policy"
[2]: https://support.google.com/googleplay/android-developer/answer/9842756?hl=en "Google Play — Use Play App Signing"