Klienci

Klient to członek witryny widziany z panelu: rekord modelu z włączonymi kontami, identyfikowany przez tożsamość (zwykle e-mail). Nie ma osobnej tabeli klientów. Jeśli workspace ma dwa modele kont - np. members i wholesale - obszar Klienci pokazuje oba, z zakładką na model.

Obszar siedzi obok Commerce i Zespołu w nawigacji panelu. Pojawia się, gdy choć jeden model ma włączone konta; wcześniej odsyła do Modeli.

Lista

Szukaj po tożsamości, filtruj po statusie i po firmie, gdy model ją deklaruje. Wiersz pokazuje pole wyświetlane rekordu (albo tożsamość, gdy jest puste), model, status, ostatnie logowanie, datę dołączenia, a z orders:view także liczbę żywych zamówień i wydatki klienta w rozbiciu na waluty. Wydatki nigdy nie są sumowane między walutami.

• active - może się logować.
• pending - zarejestrowany, e-mail jeszcze niezweryfikowany. Istnieje tylko, gdy model wymaga weryfikacji.
• suspended - logowanie odrzucane, wszystkie sesje zakończone.

Blokada po zbyt wielu nieudanych próbach to nie status: wiersz pokazuje zablokowany do i wygasa sama.

Kliknij nagłówek kolumny, żeby sortować: tożsamość, status, ostatnie logowanie, dołączenie, zamówienia. Sortowanie siedzi w pasku adresu, więc posortowany widok da się zapisać w zakładkach albo podesłać. Sortowanie po zamówieniach wymaga orders:view.

Dodaj klienta tworzy rekord konta z panelu, na modelu bieżącej zakładki albo wybranym, więc możesz założyć komuś konto, zanim odwiedzi witrynę. Eksport CSV zapisuje każdego klienta pasującego do bieżącego wyszukiwania, filtrów i sortowania - nie tylko stronę - z kolumnami zamówień, gdy wolno Ci je oglądać. Komórki zaczynające się od znaku formuły są escapowane, żeby plik bezpiecznie otworzył się w arkuszu.

Zaznacz wiersze, żeby zawiesić lub przywrócić hurtem, do 100 naraz. Klienci, u których zmiana się nie da zrobić - jeszcze niezweryfikowani, już w docelowym stanie - są pomijani i policzeni, reszta przechodzi.

Strona szczegółów

Karta konta, karta Historia zamówień (żywe zamówienia, wydatki per waluta, ostatnie zamówienie; wymaga orders:view), potem trzy zakładki: Profil (pola rekordu, tylko do odczytu, relacje pokazane jako etykieta powiązanego rekordu; Edytuj otwiera ten sam dialog rekordu co Modele), Zamówienia i Koszyki tego klienta. Profil to rekord, więc edycja wymaga uprawnienia models:edit; dwie zakładki wymagają orders:view i carts:view.

Zawieszanie i przywracanie

Zawieś blokuje logowanie i unieważnia każdy token dostępu i odświeżania klienta - kolejne żądanie ze starym tokenem jest odrzucane. Zamówienia, koszyki i sam rekord zostają. Konta pending nie da się zawiesić: jego weryfikacja stałaby się inaczej drogą do aktywacji.

Przywróć pozwala klientowi znowu się logować i czyści blokadę. Obie akcje odmawiają, gdy konto już jest w docelowym stanie, więc agent ponawiający wywołanie nie przestawi go dwa razy.

Reset hasła, weryfikacja i odblokowanie

Karta konta oferuje akcję pasującą do statusu. Wyślij reset hasła mailuje aktywnemu klientowi link do ustawienia nowego hasła; działa godzinę. Wyślij ponownie weryfikację daje klientowi pending świeży link i unieważnia poprzedni. Odblokuj pojawia się tylko, gdy trwa blokada: czyści licznik nieudanych prób i limit logowań, więc klient może spróbować od razu. Zawieszony klient nie dostaje żadnej z nich; najpierw przywróć.

Oba maile wychodzą przez ustawienia poczty workspace'u i wymagają publicznego adresu witryny, bo link prowadzi na Twoją stronę. Gdy link został wystawiony, ale mailer odrzucił wiadomość, panel mówi to wprost, zamiast udawać. Każdy klient może dostać najwyżej pięć takich maili na godzinę, więc zacięty formularz nie zaleje skrzynki. Reset hasła jest odrzucany na modelu bez logowania hasłem.

Zamówienia i goście

Zamówienie zalogowanego członka jest przypięte do niego. Zamówienie gościa przypina się później, gdy gość zarejestruje i zweryfikuje ten sam e-mail - "moje zamówienia" wypełniają się wstecz. Ze szczegółów zamówienia możesz też przypiąć lub odpiąć klienta ręcznie. Lista Zamówień szuka po tożsamości klienta i po nazwie firmy zamrożonej na zamówieniu, a da się ją zawęzić do jednej firmy.

Firmy (B2B)

W zakładce Możliwości modelu kont wskazujesz pole firmy (relację do modelu firm) i pole roli w firmie (select, np. buyer / approver). Lista Klientów dostaje wtedy kolumnę i filtr Firma, zamówienia i koszyki da się listować po firmie, a zamówienie zamraża nazwę firmy przy checkoucie, żeby późniejsza zmiana nazwy nie przepisała historii. Nic o firmie nie wychodzi na publiczne API. Gość nie wybierze też firmy przy rejestracji: register odrzuca payload ustawiający pole firmy lub roli w firmie, więc klienta do firmy przypisuje wyłącznie admin (albo agent przez update_record).

Uprawnienia

• customers:view - obszar, lista, szczegóły i eksport CSV. Domyślnie w roli Viewer.
• customers:manage - zawieszanie i przywracanie (pojedynczo lub hurtem), dodawanie klienta, reset hasła, ponowna weryfikacja, odblokowanie. Domyślnie w roli Editor.
• orders:view - kolumny zamówień, sortowanie po zamówieniach i karta historii zamówień.

Przypięcie klienta do zamówienia to zmiana zamówienia, więc wymaga orders:manage.

Z MCP i Spotlight

Ta sama powierzchnia jest dostępna dla agentów: list_customers (model, status, wyszukiwanie, firma, stronicowanie), get_customer (podsumowanie plus dane rekordu), suspend_customer i unsuspend_customer, send_customer_password_reset, resend_customer_verification i unlock_customer. Każdy klient, którego agent czyta, niesie orderStats - żywe zamówienia, wydatki per waluta, ostatnie zamówienie - albo null, gdy token nie może oglądać zamówień. Narzędzia hurtowego nie ma celowo: agent potwierdza jednego klienta naraz. get_model zwraca konfigurację auth modelu, a update_model ustawia pola firmy. list_orders i get_order zwracają customerId, companyId i companyName (null przy zamówieniu gościa), a list_orders przyjmuje filtr companyId i wyszukiwanie po zamrożonej nazwie firmy, więc zamówienia firmy trafiają do agenta tą samą drogą. Zobacz katalog narzędzi.

Następne kroki

• Uwierzytelnianie członków - rejestracja i logowanie, które implementuje Twoja witryna.
• Commerce - zamówienia, koszyki i checkout.
• Członkowie i role - kto w zespole dostaje które uprawnienie.