يخص: الحزمة الكاملة · واجهة المتجر

واجهة المتجر

كل صفحات المتجر، وكيف يعمل التسوق وإتمام الطلب والحسابات، وما الذي يُتحقق منه على الخادم.

الصفحات

الصفحة العنوان ملاحظات
الرئيسية / الواجهة، والتشكيلات، ووصل حديثًا، والأقسام، والتخفيضات، والأكثر طلبًا، والحرفيون
المتجر /shop كل المنتجات بالتصفية والترتيب؛ و/shop?new=1 و/shop?sale=1 هما صفحتا «وصل حديثًا» و«التخفيضات»
الأقسام /categories كل قسم بوصفه، مع التشكيلات المختارة
القسم /category/{slug} قسم واحد مع التصفية
التشكيلات /collections و/collections/{slug} مجموعات مختارة من أقسام مختلفة
البحث /search?q= النتائج كاملة مع التصفية؛ ونافذة البحث السريع تُفتح من أي صفحة بـCtrl K
المنتج /product/{slug} معرض الصور، والمقاس واللون، والمخزون لكل خيار، والإضافة إلى الحقيبة، والمفضلة، ومنتجات مشابهة
الحقيبة /cart والحقيبة الجانبية الكميات، مع التحقق من الأسعار على الخادم
إتمام الطلب /checkout كضيف أو بحساب؛ التواصل والعنوان والتوصيل والكوبون والدفع
الطلب /order/{code} التأكيد والحالة الحية، وتتحدث الصفحة وحدها
تتبّع الطلب /track البحث عن طلب برمزه ورقم الهاتف
حسابي /account الدخول أو التسجيل؛ الطلبات والمفضلة والبيانات
المفضلة /wishlist المنتجات المحفوظة
من نحن والأسئلة والتواصل والخصوصية والشروط /about و/faq و/contact و/privacy و/terms نصوصها في messages/*.json، ونموذج التواصل يحفظ الرسائل للوحة

التصفية والترتيب

لصفحات القوائم لوحة تصفية واحدة، وكل اختيار يُكتب في الرابط فيمكن مشاركة الصفحة المصفّاة أو حفظها:

المعامل مثال المعنى
q q=كتان كلمات في الاسم أو الوصف أو القسم أو اللون، بالعربية أو الإنجليزية
cat cat=women,shoes الأقسام (في صفحتي المتجر والبحث)
new وsale وfeatured sale=1 وصل حديثًا (آخر 30 يومًا)، أو عليه تخفيض، أو من اختيارات الفريق
size size=M,L أي من هذه المقاسات
color color=sand أي من هذه الألوان
min وmax min=5&max=20 نطاق السعر بالريال
stock stock=1 المتوفر فقط
sort featured أو newest أو best أو price-asc أو price-desc الترتيب، والمنتجات النافدة في الآخر دائمًا

منطق التصفية دالة خالصة في src/lib/filters.ts تغطيها اختبارات الوحدات.

الخيارات والمخزون

للمنتج خيار واحد أو أكثر، لكل تركيبة من المقاس واللون. ولكل خيار رمز SKU ومخزون، وسعر خاص إن لزم (فالمزهرية الكبيرة أغلى من الصغيرة مثلًا). في صفحة المنتج:

  • تظهر المقاسات النافدة في اللون المختار مشطوبة؛
  • ويخفت اللون الذي نفد في كل مقاساته؛
  • وتظهر عبارة «بقي 2 فقط» عند حد المخزون المنخفض المحدد في الإعدادات أو دونه؛
  • ويتغير السعر إن كان للخيار سعر خاص.

الحقيبة وإتمام الطلب

تُحفظ الحقيبة في المتصفح (localStorage) فتبقى بعد إعادة التحميل وتعمل دون حساب. أسعارها للعرض فقط: صفحة الحقيبة وصفحة إتمام الطلب تطلبان من الخادم تسعيرًا (POST /api/cart/quote) يعيد حساب كل سطر من قاعدة البيانات ويُبلغ عن أي مشكلة (نفد، أو بقي أقل، أو لم يعد معروضًا).

يطلب إتمام الطلب:

  1. التواصل: الاسم ورقم الهاتف (مع التحقق منه) والبريد اختياريًا.
  2. العنوان: المحافظة (محافظات عُمان الإحدى عشرة)، والولاية أو المنطقة، والشارع والمبنى، وملاحظات للمندوب.
  3. التوصيل: طرق التوصيل من الإعدادات التي تصل إلى تلك المحافظة، برسومها وحد التوصيل المجاني.
  4. الكوبون: يُتحقق منه على الخادم (مفعّل، وصالح، ولم يبلغ حد الاستخدام، والطلب فوق الحد الأدنى).
  5. الدفع: نقدًا عند الاستلام أو بالبطاقة عبر «ثواني» أو كلاهما (الدفع).

عند إرسال الطلب يقوم الخادم، في معاملة واحدة على قاعدة البيانات، بإعادة تسعير كل شيء، وبخصم مخزون كل خيار بشرط أن تكفي الكمية، وباحتساب استخدام الكوبون بشرط ألا يتجاوز حده، ثم يحفظ الطلب مع أول قيد في سجله. فإن اشترى شخصان آخر قطعة في اللحظة نفسها، يتلقى أحدهما رسالة «بقي القليل فقط» بدل أن يُباع ما ليس موجودًا.

الحسابات والمفضلة

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

تتبّع الطلب

لكل طلب رمز يصعب تخمينه مثل SQ-7KQ2-M9XD. صفحة الطلب وواجهة التتبع تخفيان رقم الهاتف إلا آخر ثلاثة أرقام، وصفحة تتبّع الطلب تطلب الرمز ورقم الهاتف المستخدم عند الطلب.

محركات البحث

  • يضم /sitemap.xml كل الصفحات العامة باللغتين مع روابط hreflang البديلة، ويُبعد /robots.txt اللوحة وإتمام الطلب والحقيبة والحساب ونتائج البحث عن محركات البحث.
  • لكل صفحة منتج رابط أساسي وبيانات Product منظمة (JSON-LD) فيها عرض لكل خيار بسعره وتوفره، ولصفحة الأسئلة بيانات FAQPage.
  • العناوين والأوصاف مأخوذة من نصوص المنتج والقسم بلغة الصفحة.