المنتجات والميزات

حدِّد ما تبيعه. أنشئ منتجات بـمتغيرات واحدة أو أكثر، وأرفق ميزات قابلة لإعادة الاستخدام للتحكم في الوصول المستند إلى الصلاحيات.

يعتمد Proyecta Commerce على ثلاثة مفاهيم: المنتجات، والمتغيرات، والميزات.

• المنتج — الشيء الذي تبيعه (مثل: “الخطة الاحترافية”، “قميص تي-شيرت”، “استشارة استراتيجية”)
• المتغير — مستوى تسعير أو إعداد معين للمنتج (مثل: “احترافي شهري بـ 29$”، “احترافي سنوي بـ 290$”، “تي-شيرت – مقاس كبير”)
• الميزة — مفتاح صلاحية قابل لإعادة الاستخدام يتحقق منه تطبيقك أثناء التشغيل (مثل: pro_features، وunlimited_projects، وapi_access)

يمكن أن يحتوي المنتج على متغيرات متعددة. كما يمتلك المنتج موارد واحدة أو أكثر مرفقة به — عادةً ما تكون ميزات — تمنح الوصول عند اشتراك العميل.

طريقتان لتحديد ما تبيعه

يتكامل Commerce مع بقية المنصة، لذا يوجد شكلان لـ“الشيء الذي تبيعه” — ويختار Proyecta الشكل المناسب تلقائيًا:

• منتجات Commerce الأصيلة — الاشتراكات والخطط والترقيات لمرة واحدة والميزات/الصلاحيات. تُعرَّف مباشرةً في Admin > Commerce > Products. هذا هو النموذج الذي تصفه بقية هذه الصفحة.
• كتالوج متجر مدعوم بالمحتوى — سلع بصور وأسعار وأوصاف يعدّلها صاحب المتجر يوميًا. تعيش هذه السلع في نظام إدارة المحتوى كـمجموعة قابلة للبيع: كل إدخال يمثّل المنتج. عند نشر إدخال، يقوم Proyecta تلقائيًا بدمجه في Commerce كمنتج حقيقي قابل للشراء — منشئًا المنتج ومتغيره المسعَّر، وناسخًا السعر مباشرةً من حقل المحتوى. يعرض المتجر سعر المحتوى، ويُحاسَب الدفع على المتغير المرتبط، وبما أنهما يشتركان في مصدر واحد فلا يمكن أن يتباينا أبدًا. تدير هذه العناصر كمحتوى (في Admin بتطبيقك، في Builder أو على موقعك المنشور)، لا تحت Commerce > Products. انظر إدارة المحتوى.

الكتالوج البسيط الذي لا يقبل مدفوعات بالبطاقة — قائمة للتصفح فقط، أو متجر تفتح زر “اشتر” فيه رابط طلب عبر WhatsApp — هو مجرد محتوى عادي — مجموعة كتالوج عادية، دون أي دمج مع Commerce. الدفع بالبطاقة هو ما يجعل المجموعة قابلة للبيع.

إنشاء منتج

في Admin > Commerce > Products، انقر على Create product (أو اطلب من الذكاء الاصطناعي: "Create a Pro plan at $29/month and a Business plan at $99/month."). يحتاج كل منتج إلى:

• اسم عرض (مثل: “Pro”)
• متغير واحد على الأقل

المتغيرات

يحمل كل متغير تسعيره الخاص:

الحقل	ملاحظات
name	التسمية التوضيحية للمتغير (“Monthly”، “Annual”، “Large”)
currency	رمز ISO المكوّن من ثلاثة أحرف — USD، EUR، GBP، JPY، BRL، MXN، INR… (أكثر من 130 عملة مدعومة)
unit_amount	السعر بأصغر وحدة نقدية (سنتات). 2900 = $29.00
recurring	اختياري — { interval: 'week' | 'month' | 'year' }. احذفه للأسعار لمرة واحدة. الفوترة اليومية غير مدعومة حاليًا.
is_default	مقبول لكن غير مُطبَّق بعد — اختيار المتغير الافتراضي غير مُنفَّذ حاليًا.
media	أرفق صورًا أو مقاطع فيديو عبر معرّف ملف CDN (انظر الملفات)

التسعير غير قابل للتغيير. بمجرد إنشاء متغير، لا يمكن تغيير سعره — أنشئ متغيرًا جديدًا بدلًا من ذلك. هذا يحمي المشتركين الحاليين من تغييرات الأسعار غير المقصودة.

الميزات (الصلاحيات)

الميزات هي العنصر الأساسي للتحكم في الوصول. أنشئ ميزة مرة واحدة في Admin > Commerce > Products، ثم أرفقها بمنتج واحد أو أكثر. لكل ميزة اسم، ووصف اختياري، ومفتاح — يتكون من أحرف صغيرة وأرقام وشرطات سفلية (مثل: pro_features) — وهو ما يتحقق منه تطبيقك.

عند إنشاء منتج، ترفق الميزات به عبر “الموارد”. يحصل العملاء الذين يشتركون في منتج على صلاحية الوصول إلى كل ميزة مرفقة به.

بعد ذلك، في تطبيقك، ابنِ بوابة الوصول على هذا المفتاح:

const { hasAccess, isLoading } = useEntitlement('pro_features');

if (isLoading) return <Spinner />;
if (!hasAccess) return <UpgradePrompt />;
return <ProOnlyThing />;

يعمل التحقق على جانب الخادم مقابل الجلسة المسجّل دخولها، لذا لا يمكن تزويره من المتصفح. انظر دمج Commerce في تطبيقي للاطلاع على النمط الكامل.

ملاحظة: ابنِ بوابة الوصول دائمًا على مفتاح الميزة — الـ slug المشتق من اسم الميزة (مثل: pro_features) — وليس على المعرّف الداخلي للميزة.

هكذا تحمي الصفحات والـ API endpoints والميزات المخصصة للمشتركين المدفوعين في كود تطبيقك.

أشكال المنتجات الشائعة

اشتراكات SaaS

Create products: Free ($0/month), Pro ($29/month, $290/year), Business ($99/month, $990/year).
Attach a 'pro_features' feature to Pro and Business so I can gate access in my code.

منتجات مادية

Create a T-shirt product with three variants: Small, Medium, Large at $25 each.

منتجات رقمية

Create a course product with a single one-time variant at $149.

التبرعات

Create a donation product with three variants: $25, $50, $100 — all one-time.

المخزون

لا يتتبع Proyecta Commerce المخزون للمنتجات المادية حاليًا. إذا كنت تبيع عناصر مخزّنة، أدِر أعداد المخزون في قاعدة بيانات تطبيقك وتحقق منها في تدفق الدفع الخاص بك.

قريبًا

• تخصيص حقول الدفع — جمع معلومات إضافية من المشترين
• التسعير حسب رغبة المستخدم
• تتبع المخزون المدمج للمنتجات المادية