«سوق» متجر إلكتروني متكامل للأزياء ومستلزمات البيت، بالعربية والإنجليزية، صُمّم للسوق العُماني: الأسعار بالريال، والعنوان بالمحافظة، والدفع نقدًا عند الاستلام أو بالبطاقة عبر «ثواني». يضم مشروع Next.js واحد أربعة أجزاء تتشارك قاعدة بيانات واحدة:
| الجزء | ما يقدمه | العنوان |
|---|---|---|
| واجهة المتجر | الرئيسية، والمتجر بالتصفية والترتيب، والبحث السريع (Ctrl K)، والأقسام، وصفحات المنتجات بخيارات المقاس واللون، والحقيبة وإتمام الطلب، وتتبّع الطلب، وحسابات العملاء مع المفضلة، وصفحات من نحن والأسئلة والتواصل والخصوصية والشروط | /ar و/en |
| لوحة الإدارة | نظرة عامة بالمبيعات والهدف والرسوم، والطلبات بمراحلها، والمنتجات بخياراتها ومخزونها، والأقسام والتشكيلات، والكوبونات، والعملاء ورسائلهم، والمساعد الذكي، والمشرفون وأدوارهم، والإعدادات | /ar/dashboard و/en/dashboard |
| واجهة API | نقاط REST التي يستخدمها الجزءان، وتصلح لتطبيق جوال أو أنظمة أخرى | /api/... |
| التوثيق | هذه الصفحات باللغتين | /ar/docs و/en/docs |
ماذا ستحصل عليه
- العربية أولًا (من اليمين إلى اليسار) مع نسخة إنجليزية كاملة في كل صفحة، واللوحة كذلك.
- منتجات بخيارات: لكل مقاس ولون رمز SKU ومخزون خاص به، وسعر خاص إن أردت.
- الأسعار والخصومات والتوصيل والضريبة تُحسب دائمًا على الخادم من قاعدة البيانات، بأصغر وحدة للعملة (البيسة).
- خصم المخزون واحتساب استخدام الكوبون يتمّان في معاملة قاعدة البيانات نفسها التي يُسجَّل فيها الطلب، فلا يشتري عميلان آخر قطعة معًا.
- إتمام الطلب كضيف بعنوان عُماني (المحافظة والولاية والشارع)، وطرق توصيل حسب المحافظة، وكوبونات، ودفع عند الاستلام أو بالبطاقة عبر «ثواني» مع التحقق من الدفع على الخادم.
- مراحل الطلب: جديد ← مؤكد ← مُجهّز ← تم الشحن ← تم التسليم، مع الإلغاء والاسترداد، وسجلّ لكل تغيير، وإرجاع تلقائي للمخزون.
- ثلاثة أدوار في اللوحة (مالك ومشرف وموظف) وجدول صلاحيات يعدّله المالك.
- ذكاء اصطناعي اختياري مع أي مزود متوافق مع OpenAI: محادثة حول بيانات متجرك، وكتابة أوصاف المنتجات باللغتين.
- تحسين لمحركات البحث: خريطة موقع باللغتين، وملف robots.txt، وروابط أساسية، وبيانات منظمة للمنتجات والأسئلة.
- متجر تجريبي جاهز: 6 أقسام و30 منتجًا بـ179 خيارًا وصورنا الخاصة، و4 تشكيلات، وكوبونان، و25 طلبًا سابقًا لتظهر الرسوم البيانية حيّة من أول دقيقة.
البدء السريع
npm install
cp .env.example .env
npm run setup
npm run dev
افتح http://localhost:3302 للمتجر وhttp://localhost:3302/ar/dashboard للوحة. يُنشأ حساب المالك الأول من OWNER_EMAIL وOWNER_PASSWORD في ملف .env (راجع التثبيت).
أين تجد كل شيء
prisma/schema.prisma جداول قاعدة البيانات
prisma/catalog-data.mjs الكتالوج التجريبي (المنتجات والخيارات والتشكيلات والكوبونات والتوصيل)
prisma/seed.mjs يملأ قاعدة بيانات فارغة وينشئ المالك الأول
messages/ar.json, en.json كل نصوص المتجر واللوحة
src/app/[locale]/(store) صفحات المتجر
src/app/[locale]/dashboard صفحات لوحة الإدارة
src/app/[locale]/docs هذا التوثيق (ملفات Markdown في docs/)
src/app/api واجهة الـ API
src/lib التسعير والتصفية وقواعد الطلبات والصلاحيات والدفع والذكاء الاصطناعي والجلسات
src/components مكونات المتجر واللوحة والتوثيق
src/app/globals.css الألوان والخطوط والأشكال (هويتك)
public/images صور المنتجات والصور التحريرية
tests اختبارات الوحدات (npm test)
scripts اختبار شامل للـ API، وفاحص الصفحات، ومولّد الصور
الخطوات التالية
- ثبّت المشروع وادخل إلى اللوحة.
- أدخل اسم متجرك وبيانات التواصل والتوصيل من اللوحة > الإعدادات.
- استبدل الكتالوج التجريبي من المنتجات والأقسام.
- اضبط ألوانك وشعارك (الهوية والألوان).
- قرّر بشأن الدفع بالبطاقة (الدفع) ثم انشر المتجر (التثبيت اليدوي والنشر).