سياسة ملفات تعريف الارتباط (Cookies) والتخزين المحلي للمتصفح
تشرح هذه الوثيقة العملية كافة تقنيات التخزين التي يستخدمها تطبيق SOUQ TURQUIE في متصفحك، والغرض الهندسي والتشغيلي من كل مفتاح تخزين أو ملف تعريف ارتباط، وكيفية إدارتها.
1. الفرق بين ملفات تعريف الارتباط (Cookies)، التخزين المحلي، والجلسات
لتوضيح كيفية عمل المنصة بشفافية، نفرق بين أربع تقنيات قياسية في تطبيقات الويب الحديثة:
- ملفات تعريف الارتباط (HTTP Cookies): ملفات نصية صغيرة يرسلها الخادم ليحفظها المتصفح ويرفقها تلقائياً مع الطلبات اللاحقة إلى الخادم. تُستخدم أساساً للحفاظ على جلسة تسجيل الدخول الآمنة وحماية النماذج.
- التخزين المحلي للمتصفح (
localStorage): مساحة تخزين داخل متصفح جهازك تتيح لحفظ بيانات واجهة المستخدم (مثل عناصر سلة التسوق أو المفضلة) محلياً دون إرسالها تلقائياً مع كل طلب شبكة، وتبقى محفوظة على نفس الجهاز والمتصفح حتى يقوم المستخدم بمسحها أو يُفرغها التطبيق. - تخزين الجلسة المؤقت (
sessionStorage): مساحة تخزين مؤقتة داخل علامة التبويب تُمسح فور إغلاق نافذة المتصفح. (لا تعتمد المنصة حالياً علىsessionStorageلحفظ بيانات العميل). - جلسات التحقق الخادمية (Server-Side / JWT Sessions): آلية يتحقق عبرها الخادم من هوية المستخدم وصلاحياته (مثل دور
CUSTOMERأوADMIN) عند طلب الصفحات المحمية أو تنفيذ إجراءات الطلب.
2. التقنيات التي يستخدمها تطبيق SOUQ TURQUIE فعلياً
بناءً على الفحص الفعلي للكود المصدري للمنصة، يستخدم التطبيق حصرياً التقنيات الضرورية التالية:
- ملفات تعريف ارتباط المصادقة والحماية الأساسية الصادرة عن مكتبة Auth.js / NextAuth.
- مفتاحي تخزين محلي (
localStorage) مخصصين لسلة التسوق (tm_cart) وقائمة المفضلة (souq_turquie_wishlist_v1). - توجيه اللغة عبر بادئة مسار الرابط (URL Path Prefix:
/arأو/fr).
3. ملفات تعريف الارتباط الأساسية للمصادقة والجلسة
عند تسجيل الدخول إلى حسابك في المنصة (سواء كعميل لإتمام طلب أو كمسؤول إدارة)، يعتمد النظام على استراتيجية الجلسات الموقعة (session: { strategy: "jwt" }) عبر NextAuth، ويقوم بإنشاء ملفات تعريف الارتباط الأساسية التالية:
authjs.session-token(أو__Secure-authjs.session-tokenعبر اتصال HTTPS الآمن): يحفظ رمز الجلسة المشفر والموقع الذي يحتوي على معرف المستخدم (id)، البريد الإلكتروني، الاسم، والدور الصلاحي (role) لمنع مطالبتك بإعادة إدخال كلمة المرور في كل صفحة.authjs.callback-url(أو__Secure-authjs.callback-url): يحفظ المسار الذي كان المستخدم يحاول الوصول إليه لإعادته إليه تلقائياً بعد نجاح تسجيل الدخول.
4. آلية حفظ تفضيل اللغة (العربية / الفرنسية)
تُدار لغة العرض واتجاه الصفحة (العربية RTL أو الفرنسية LTR) بشكل مباشر عبر بنية الرابط في المتصفح (/ar/... و/fr/...) من خلال موجه المنصة (src/proxy.ts) ومكون مبدل اللغة (LanguageSwitcher). لا تقوم المنصة حالياً بزرع ملف تعريف ارتباط تتبعي خاص باللغة على جهازك.
5. تخزين سلة التسوق وقائمة المفضلة (localStorage)
لتوفير تجربة تسوق سريعة تتيح لك إضافة المنتجات وتصفح الأقسام قبل تسجيل الدخول، تستخدم المنصة مفتاحين محددين في window.localStorage:
- مفتاح سلة التسوق (
tm_cart): يحفظ مصفوفة JSON تحتوي على المنتجات المضافة للسلة (معرف المنتج، معرف الخيارvariantId، رمزvariantSku، الاسم بالعربية والفرنسية، الصورة، المواصفات، سعر العرض بالدرهم، والكمية). يتم تفريغ هذا المفتاح تلقائياً عبر دالةclearCart()فور نجاح إرسال الطلب في صفحة الدفع. - مفتاح قائمة المفضلة (
souq_turquie_wishlist_v1): يحفظ المنتجات التي يضغط المستخدم على أيقونة القلب لحفظها للرجوع إليها لاحقاً.
ماذا يحدث عند تغيير الجهاز أو مسح بيانات المتصفح؟ نظراً لأن tm_cart وsouq_turquie_wishlist_v1 يُحفظان محلياً داخل متصفح الجهاز الحالي فقط، فإن فتح الموقع من هاتف آخر أو متصفح مختلف أو استخدام وضع التصفح الخفي (Incognito) أو مسح بيانات الموقع سيؤدي إلى ظهور سلة تسوق ومفضلة فارغتين على ذلك المتصفح، دون أن يؤثر ذلك على الطلبات التي سبق إرسالها وحفظها في قاعدة بيانات الخادم.
6. تقنيات الأمان والحماية من تزوير الطلبات
تستخدم المنصة ملف تعريف الارتباط الأمني authjs.csrf-token (أو __Host-authjs.csrf-token عبر HTTPS) للتحقق من أن طلبات تسجيل الدخول وتغييرات الجلسة صادرة فعلياً من واجهة موقع SOUQ TURQUIE وليست ناتجة عن هجمات تزوير الطلبات عبر المواقع (CSRF). هذا الملف ضروري أمنياً ولا يمكن تعطيله دون إيقاف وظيفة تسجيل الدخول.
7. ملفات التحليلات والإعلانات والجهات الخارجية
تأكيد صريح: لا يتضمن الكود الحالي لمنصة SOUQ TURQUIE أي برمجيات تتبع إعلانية أو تحليلية خارجية (مثل Google Analytics أو Meta Pixel أو TikTok Pixel أو شبكات الإعلانات السلوكية)، ولا يتم مشاركة سجل تصفحك مع أي شبكات إعلانية خارجية.
8. جدول المواصفات التقنية للتخزين المعتمد في المنصة
| الاسم / المفتاح التقني | نوع ومكان التخزين | الغرض الفعلي في التطبيق | التصنيف |
|---|---|---|---|
| authjs.session-token / __Secure-authjs.session-token | ملف ارتباط HTTP-Only Cookie | حفظ جلسة المستخدم المسجل وصلاحياته (JWT Session). | أساسي / ضروري |
| authjs.csrf-token / __Host-authjs.csrf-token | ملف ارتباط HTTP Cookie | الحماية الأمنية ضد تزوير طلبات المصادقة (CSRF Protection). | أساسي / أمني |
| authjs.callback-url / __Secure-authjs.callback-url | ملف ارتباط HTTP Cookie | إعادة توجيه المستخدم للصفحة المطلوبة بعد تسجيل الدخول. | أساسي / وظيفي |
| tm_cart | متصفح العميل (localStorage) | حفظ عناصر سلة التسوق والكميات المختارة قبل إتمام الطلب. | وظيفي بطلب المستخدم |
| souq_turquie_wishlist_v1 | متصفح العميل (localStorage) | حفظ قائمة المنتجات المفضلة (Favorites) على جهاز المستخدم. | وظيفي بطلب المستخدم |
| /ar/* , /fr/* | مسار الرابط (URL Path) | تحديد لغة الواجهة واتجاه النص (RTL / LTR) دون ملفات تتبع. | أساسي / توجيه |
9. كيفية فحص أو حظر أو مسح التخزين من خلال إعدادات المتصفح
يمكنك في أي وقت التحكم في ملفات تعريف الارتباط والتخزين المحلي عبر إعدادات متصفحك:
- Google Chrome / Microsoft Edge: الإعدادات (Settings) ← الخصوصية والأمان (Privacy and security) ← حذف بيانات التصفح أو إعدادات المواقع (Site settings). كما يمكنك فحص المفاتيح مباشرة عبر أدوات المطورين (F12 ← Application ← Storage).
- Mozilla Firefox: الإعدادات ← الخصوصية والأمان ← ملفات تعريف الارتباط وبيانات المواقع (Cookies and Site Data) ← إدارة البيانات أو مسح البيانات.
- Apple Safari: التفضيلات / الإعدادات ← الخصوصية (Privacy) ← إدارة بيانات موقع الويب (Manage Website Data).
10. آثار حظر أو مسح التخزين الأساسي
إذا قمت بحظر ملفات تعريف الارتباط الأساسية أو مسح بيانات الموقع من متصفحك، فستترتب النتائج التقنية التالية:
- تسجيل الخروج الفوري: سيؤدي حذف أو حظر
authjs.session-tokenإلى إنهاء جلستك الحالية وعدم قدرتك على تسجيل الدخول لإتمام الطلبات (حيث يتطلب Checkout جلسة مصادقة نشطة). - فقدان السلة والمفضلة المحلية: سيؤدي مسح
localStorageإلى إفراغ سلة التسوق الحالية (tm_cart) وقائمة المفضلة (souq_turquie_wishlist_v1) المحفوظتين على ذلك المتصفح.
11. متطلبات الموافقة والإطار القانوني
نظراً لأن منصة SOUQ TURQUIE تقتصر في بنيتها الحالية على ملفات تعريف الارتباط الضرورية تقنياً لتشغيل جلسة المصادقة وحماية الأمان، بالإضافة إلى التخزين المحلي الذي ينشط فقط استجابةً لفعل مباشر من المستخدم (مثل الضغط على زر "أضف إلى السلة" أو "إضافة إلى المفضلة")، ولا تستخدم أي ملفات تعريف ارتباط إعلانية أو تحليلية اختيارية، فلا يتم حالياً عرض شريط موافقة إعلاني صوري. وفي حال إضافة أي أدوات تحليلية أو تسويقية غير أساسية مستقبلاً، سيتم تفعيل آلية أخذ موافقة مسبقة واضحة قبل تشغيلها.
12. كيفية الإبلاغ عن التعديلات الجوهرية في هذه السياسة
في حال إدخال أي تقنيات تخزين جديدة أو ملفات تعريف ارتباط إضافية على المنصة، سيتم تحديث هذه الوثيقة وتحديث جدول المواصفات التقنية أعلاه قبل أو بالتزامن مع نشر الميزة الجديدة. للاستفسار، يرجى التواصل معنا عبر صفحة اتصل بنا.