Clienți

Gestionează utilizatorii facturabili ai aplicației tale. Navighează prin clienți în tab-ul Dashboard > Commerce > Customers sau prin SDK.

Un client este entitatea din aplicația ta care va fi facturată — de obicei un utilizator, o organizație sau un proiect. Îl creezi în Proyecta imediat ce entitatea corespunzătoare există în baza ta de date, apoi stochezi id-ul returnat pentru a-l putea referenția ulterior.

Tab-ul Customers

Deschide Dashboard > Commerce și comută pe Customers pentru a vedea toți clienții facturabili ai aplicației curente. Fiecare rând afișează:

• Email
• Numele complet
• Data la care au fost creați

Un câmp de căutare și filtrarea după email sau data creării sunt disponibile prin SDK; controale mai avansate în panou vor urma.

SDK

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

Creare

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',
    },
});

Citire

// 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);
}

Actualizare

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

Tipare frecvente

Creează un client Proyecta la înregistrarea unui utilizator

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.

Construiește un panou de administrare pentru clienți

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.

Întrebări frecvente

Ar trebui să creez un client Proyecta pentru fiecare utilizator sau doar pentru cei care plătesc?

Creează unul pentru fiecare utilizator. Este gratuit, idempotent (apelurile cu același email returnează același client) și înseamnă că ești pregătit în momentul în care un utilizator face upgrade — fără a te grăbi să completezi datele lipsă ulterior.

Poate un client să aibă mai multe abonamente?

Da. Abonamentele aparțin clienților, nu invers. Folosește commerce.checkout() pentru a crea o nouă sesiune de checkout pentru un abonament.

Cum văd la ce este abonat un client?

Momentan: prin dashboard-ul Stripe integrat sau apelând commerce.check() pentru fiecare funcționalitate care te interesează. O vedere a istoricului abonamentelor în panou este planificată pentru viitor.