العميل

العميل

ملخّص. التاجر / البائع — العميل الأساسي لـ NQLA. يدرج المنتجات، ويرسل المخزون إلى التخزين، وينشئ الطلبات، ويدير محفظته، وكل ذلك محدّد النطاق بسجلّاته الخاصة فقط. معظم عمله على واجهة العميل/الجوال تحت /api/v1/client/....

ما يمكنك فعله

المنتجات (manage products، create products، export products، view products)

• إدارة كاملة لمنتجاتك — GET/POST/PUT/DELETE /api/v1/client/products (و/{product}).

المخزون (view inventory-requests، create inventory-requests، export inventory-requests)

• تقديم طلبات مخزون لمنتجاتك — POST /api/v1/inventory-requests — وسردها/عرضها على GET /api/v1/inventory-requests.

الطلبات (create orders، view orders، export orders)

• إنشاء الطلبات — POST /api/v1/client/orders — وعرضها/تتبّعها، وجلب رمز QR، والإلغاء — GET /api/v1/client/orders، /{order}، /{order}/qr، /{order}/cancel، /{order}/tracking.

الأشكال المخصّصة (manage shapes، create shapes، update shapes، delete shapes، export shapes، view shapes)

• إدارة أشكالك المخصّصة — /api/v1/.../shapes (يحدّد المتحكّم نطاق الأشكال بـ user_id الخاص بك حتى لا يكشف المنتقي أشكال تاجر آخر).

المحفظة والسحوبات (view wallet)

• عرض رصيد المحفظة وحركاتها — GET /api/v1/client/wallet، /wallet/transactions.
• طلب سحب — POST /api/v1/client/wallet/withdraw (محدود المعدّل عبر throttle:withdraw) — وسردها/إلغائها/إيصالها تحت /wallet/withdrawals.

الاشتراك (view my-subscription)

• عرض اشتراكك والخطط، والترقية، والتجديد، والإلغاء، وتبديل التجديد التلقائي، وعرض الفواتير — /api/v1/client/subscription/....

الإرجاع والنزاعات (view return-requests)

• عرض طلبات الإرجاع — GET /api/v1/return-requests، /{return_request}، والإلغاء — /{return_request}/cancel.
• رفع نزاعات — POST /api/v1/client/disputes — وعرضها.

ما لا يمكنك فعله

• لا يمكنه رؤية منتجات أو طلبات أو مخزون أو أشكال أو محفظة أي تاجر آخر.
• لا يمكنه الموافقة على طلباته أو إسناد السائقين أو تأكيد التخزين — تلك تخصّ المدير/الموظف والشركات.
• لا بيانات أساسية إدارية، ولا مستخدمين آخرين، ولا إعدادات منصة.
• لا يمكنه صرف سحوباته — فقط يطلب؛ ويصرف الأموال مديرٌ يملك approve withdrawal-requests.

نطاق البيانات

سجلّاته الخاصة فقط (نطاق المالك). تُرشَّح كل قائمة للصفوف التي يملكها العميل — مثلًا يُرجع /api/v1/client/orders فقط الطلبات التي أنشأها، وتُرشَّح الأشكال بـ user_id. لا يمكنه رؤية بيانات تاجر آخر أبدًا.

الصلاحيات

القائمة الدقيقة (المُزامَنة في SaasRoleSeeder): view my-subscription، view products، create products، manage products، export products، view inventory-requests، create inventory-requests، export inventory-requests، view orders، create orders، export orders، view wallet، view shapes، create shapes، update shapes، delete shapes، manage shapes، export shapes، view return-requests.

كيف يُسنَد هذا الدور

يُسنَد عند التسجيل الذاتي — يسجّل التاجر ويُوضَع في client. لا تلزم موافقة مدير لدور التاجر نفسه (خلافًا لأدوار الشركة).

صفحات ذات صلة

راجع roles/overview لتحديد النطاق، ودليل التاجر (مثل merchant-guide/creating-orders) للتدفقات خطوة بخطوة.