العملاء

إدارة المستخدمين القابلين للفوترة في تطبيقك. تصفح العملاء من تبويب Dashboard > Commerce > Customers أو عبر SDK.

العميل هو الكيان في تطبيقك الذي يتم محاسبته — عادةً مستخدم أو مؤسسة أو مشروع. تقوم بإنشائه في Proyecta فور وجود الكيان المقابل في قاعدة بياناتك الخاصة، ثم تحتفظ بالـ id المُعاد لتتمكن من الرجوع إليه لاحقاً.

تبويب Customers

افتح Dashboard > Commerce وانتقل إلى Customers لرؤية كل عميل قابل للفوترة في التطبيق الحالي. يعرض كل صف:

• البريد الإلكتروني
• الاسم الكامل
• تاريخ الإنشاء

يتوفر مربع بحث والتصفية حسب البريد الإلكتروني أو تاريخ الإنشاء عبر SDK؛ وستتوفر عناصر تحكم أكثر ثراءً في اللوحة قريباً.

SDK

import Proyecta from '@proyecta-ai/sdk';
const proyecta = new Proyecta({ apiKey: process.env.PROYECTA_API_KEY });

إنشاء

const customer = await proyecta.commerce.customers.create({
    email: 'alice@example.com',
    name: 'Alice Liddell',
    phone: '+14155551234', // E.164 format
    address: {
        line1: '123 Wonderland Ave',
        city: 'San Francisco',
        state: 'CA',
        postal_code: '94110',
        country: 'US',
    },
});

قراءة

// Single customer
const customer = await proyecta.commerce.customers.get({ customerId: 'cus_123' });

// Paginate
const result = await proyecta.commerce.customers.list({ limit: '20' });
for (const customer of result.data) {
    console.log(customer.name, customer.email);
}

تحديث

await proyecta.commerce.customers.update({ customerId: 'cus_123', email: 'new@example.com', address: { ... } });

أنماط شائعة

إنشاء عميل في Proyecta عند تسجيل مستخدم جديد

When a new user finishes signup, call proyecta.commerce.customers.create
with their email and name. Store the returned id on the user record as
proyecta_customer_id.

بناء صفحة إدارة لتصفح العملاء

Build an admin page at /admin/customers that lists every Proyecta customer
with their email, name, created date, and a link to view their detail page.
Use proyecta.commerce.customers.list to paginate through all customers.

الأسئلة الشائعة

هل يجب أن أنشئ عميلاً في Proyecta لكل مستخدم، أم للمدفوعين فقط؟

أنشئ واحداً لكل مستخدم. إنه مجاني، وغير قابل للتكرار (الاستدعاءات بنفس البريد الإلكتروني تُعيد نفس العميل)، وهذا يعني أنك ستكون جاهزاً في اللحظة التي يرتقي فيها المستخدم — دون الحاجة إلى التسرع في ملء البيانات الناقصة لاحقاً.

هل يمكن أن يمتلك العميل اشتراكات متعددة؟

نعم. الاشتراكات تتبع العملاء، وليس العكس. استخدم commerce.checkout() لإنشاء جلسة checkout لاشتراك جديد.

كيف أرى ما اشترك فيه العميل؟

حالياً: عبر لوحة Stripe المدمجة أو باستدعاء commerce.check() لكل ميزة تهمك. وعرض سجل الاشتراكات في اللوحة موجود ضمن خارطة الطريق.