Files
gracesalmoun/docs/admin-dashboard.md
2026-11-13 12:08:12 +03:00

43 lines
7.1 KiB
Markdown

# لوحة إدارة الموقع
افتح `/admin` بعد تشغيل المشروع بواسطة `npm.cmd run dev` على ويندوز (أو `npm run dev` في الأنظمة الأخرى). تسجيل الدخول يستخدم قيمة `ADMIN_PASSWORD` الموجودة في إعدادات الخادم. لا توجد كلمة مرور افتراضية، ولا تُرسل كلمة المرور إلى واجهة الموقع.
## الأقسام
- **نظرة عامة:** إحصائيات المحتوى، وصول سريع، تصدير واستيراد نسخة JSON وتحديث المحتوى من الخادم. الأرقام تعدّ المحتوى وليست إحصائيات زيارات.
- **الهوية والتواصل:** الاسم والمسمّى والمقدمة والنبذة بالعربية والإنجليزية، الشعار والصور، الهاتف والبريد وفيسبوك وواتساب والخريطة. تظهر المعلومات المشتركة في الصفحة الرئيسية والسيرة والتذييل والقائمة.
- **المشاريع:** الإضافة والتعديل والنسخ والحذف والترتيب والإخفاء، البحث والتصفية، صور الغلاف واللوحات واللوحات الإضافية، الاتجاه، النصوص والأوصاف البديلة باللغتين. النسخة الجديدة من مشروع تكون مخفية افتراضياً.
- **محتوى الموقع:** عناوين الواجهة، النبذة، الفلسفة، الخدمات، الجوائز، المهارات والبرامج والأعمال الإضافية والإحصائيات، التذييل وتسميات القائمة والأزرار. اختر العربية أو English قبل التحرير. القوائم تدعم إضافة العناصر وحذفها وإعادة ترتيبها.
- **السيرة الذاتية:** الخبرات والتعليم ونصوص السيرة في كل لغة، رفع PDF وتفعيل أو إيقاف تنزيله. المهارات والبرامج مشتركة مع قسم محتوى الموقع.
- **مكتبة الوسائط:** عرض الملفات الموجودة ورفع الصور أو PDF ونسخ الرابط لاستخدامه في حقول الصور أو ملف السيرة. إزالة ارتباط صورة من حقل لا تحذف الملف من الخادم.
- **المظهر والأقسام:** لون العناصر المميزة والأزرار، إظهار وإخفاء أقسام الصفحة الرئيسية الاثني عشر. روابط القائمة تختفي عندما يكون القسم المرتبط بها مخفياً.
- **محركات البحث:** العنوان والوصف لكل لغة؛ يتحدث عنوان الصفحة وبيانات المشاركة بعد الحفظ. صورة المشاركة هي صورة الواجهة.
## الحفظ والنسخ
التعديلات تبقى مسودة في الجلسة حتى الضغط على **حفظ ونشر** أو `Ctrl+S` / `Cmd+S`. هذا الزر يحفظ المحتوى على الخادم الحالي، ولا يعيد نشر التطبيق في منصة الاستضافة. «عرض المنشور» يفتح المحتوى المحفوظ في نافذة جديدة، وليس معاينة المسودة.
يمكن التراجع عن التعديلات غير المحفوظة. يظهر تنبيه عند محاولة إغلاق الصفحة أو تسجيل الخروج مع وجود مسودة. لا تُستعاد المسودة بعد إغلاق المتصفح؛ صدّر نسخة إذا أردت الاحتفاظ بها دون نشر. إذا انتهت الجلسة أثناء العمل، تحتفظ الواجهة بمسودتها أثناء إعادة تسجيل الدخول.
النسخة JSON تشمل النصوص والإعدادات وروابط الملفات، **ولا تشمل ملفات الصور أو PDF نفسها**. استيراد نسخة لا ينشرها حتى الحفظ. احفظ نسخة مستقلة من الملفات عند نقل الموقع إلى خادم آخر.
يرفض الخادم بيانات غير مطابقة للبنية أو روابط غير آمنة. يسمح بملفات JPG وPNG وWebP وAVIF وPDF حتى 12 ميغابايت ويفحص توقيع الملف. عند الحفظ من جلستين، تُرفض النسخة الأقدم بدلاً من الكتابة فوق تعديلات أحدث؛ صدّر مسودتك أولاً ثم استخدم «تحديث من الخادم» للمراجعة.
## التشغيل والتخزين
المحتوى في `data/cms-content.json`، والملفات المرفوعة في `public/uploads`. المحتوى السابق الذي يحتوي الملف الشخصي والمشاريع فقط يُستكمل بإعدادات الأقسام الافتراضية عند القراءة، مع الحفاظ على القيم الموجودة. الحفظ يستخدم ملفاً مؤقتاً واستبدالاً ذرياً، وطابور كتابة داخل عملية الخادم.
استخدم قرصاً دائماً للمجلدين وعملية خادم واحدة؛ طابور الحفظ لا ينسّق عدة عمليات أو نسخ مستقلة. الاستضافة ذات نظام الملفات المؤقت أو غير القابل للكتابة تحتاج قاعدة بيانات وتخزين ملفات دائم قبل الاعتماد على التعديلات. راجع [إرشادات النشر الحالية](production-deployment.md) لتثبيت مجلدات Docker وضبط `ADMIN_COOKIE_SECURE=true` على HTTPS.
هذه التغييرات تخص المشروع الحالي. لا تغيّر كلمة المرور أو النطاق أو إعدادات الاستضافة من لوحة المحتوى.
## التحقق من التنفيذ — 13 نوفمبر 2026
- نجح بناء الإنتاج بواسطة `npm.cmd run build` في مجلد بناء معزول، وفحص TypeScript.
- نجح 68 فحصاً على نسخة standalone معزولة، بما فيها تسجيل الدخول، الحفظ من الواجهة، ظهور التعديلات في الصفحات الأربع، استكمال بنية المحتوى القديم، تعارض الحفظ، التحقق من الروابط والملفات، الصور وPDF، ومكتبة الوسائط.
- تم فحص الواجهة في متصفح Chromium بعرض 1440 و390 بكسل، وقائمة الموبايل والتنقل بلوحة المفاتيح وإضافة عناصر المحتوى وتبديل اللغة. لم تظهر أخطاء JavaScript أو تمدد أفقي في الصفحات المفحوصة.
- تم التحقق من معالجة النصوص القابلة للتحرير داخل JSON-LD بأمان.
- بيانات المشروع الأصلية لم تتغير أثناء الاختبار. لم يتم نشر التطبيق إلى استضافة خارجية.
أدلة الاختبار المحلية في `.artifacts/dashboard-qa-results.json` ولقطات `.artifacts/dashboard-*.png`، وهي ملفات محلية غير مضافة إلى Git.