رفتن به محتوا
Proyecta Docs

مشتریان

کاربران قابل صورت‌حساب اپ خود را مدیریت کنید. مشتریان را در تب Dashboard > Commerce > Customers یا از طریق SDK مرور کنید.

مشتری موجودیتی در اپ شماست که از آن هزینه دریافت می‌شود — معمولاً یک کاربر، یک سازمان یا یک پروژه. به محض اینکه موجودیت مربوطه در پایگاه داده‌ی خودتان ایجاد شد، یک مشتری در Proyecta می‌سازید و id برگشتی را ذخیره می‌کنید تا بعداً به آن ارجاع دهید.

تب Customers

Section titled “تب Customers”

Dashboard > Commerce را باز کنید و به Customers بروید تا تمام مشتریان قابل صورت‌حساب اپ جاری را ببینید. هر ردیف نشان می‌دهد:

  • ایمیل
  • نام کامل
  • تاریخ ایجاد

جستجو و فیلتر کردن بر اساس ایمیل یا تاریخ ایجاد از طریق SDK در دسترس است؛ کنترل‌های پیشرفته‌تر در پنل به زودی اضافه می‌شوند.

SDK

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

ایجاد

Section titled “ایجاد”
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',
    },
});

خواندن

Section titled “خواندن”
// 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);
}

به‌روزرسانی

Section titled “به‌روزرسانی”
await proyecta.commerce.customers.update({ customerId: 'cus_123', email: 'new@example.com', address: { ... } });

الگوهای رایج

Section titled “الگوهای رایج”

ایجاد مشتری 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.

سؤالات متداول

Section titled “سؤالات متداول”

آیا باید برای هر کاربر یک مشتری Proyecta بسازم، یا فقط برای کاربران پولی؟

برای هر کاربری بسازید. رایگان است، idempotent است (فراخوانی‌ها با همان ایمیل همان مشتری را برمی‌گردانند)، و به این معناست که به محض ارتقای کاربر آماده‌اید — بدون نیاز به backfill اضطراری.

آیا یک مشتری می‌تواند چندین اشتراک داشته باشد؟

بله. اشتراک‌ها به مشتریان تعلق دارند، نه برعکس. از commerce.checkout() برای ایجاد یک session پرداخت اشتراک جدید استفاده کنید.

چطور ببینم یک مشتری به چه چیزی اشتراک دارد؟

در حال حاضر: از طریق داشبورد Stripe تعبیه‌شده یا با فراخوانی commerce.check() برای هر ویژگی‌ای که اهمیت دارد. نمایش تاریخچه‌ی اشتراک در پنل در roadmap قرار دارد.