Client

Résumé. Le marchand / vendeur — le client principal de NQLA. Il référence des produits, envoie du stock vers le stockage, crée des commandes et gère son portefeuille, le tout strictement limité à ses propres données. L’essentiel de son travail se fait sur l’API client/mobile sous /api/v1/client/....

Ce que vous pouvez faire

Produits (manage products, create products, export products, view products)

CRUD complet sur vos propres produits — GET/POST/PUT/DELETE /api/v1/client/products (et /{product}).

Inventaire (view inventory-requests, create inventory-requests, export inventory-requests)

Soumettre des demandes d’inventaire pour vos produits — POST /api/v1/inventory-requests — et les lister/consulter sur GET /api/v1/inventory-requests.

Commandes (create orders, view orders, export orders)

Créer des commandes — POST /api/v1/client/orders — les consulter/suivre, récupérer le QR et annuler — GET /api/v1/client/orders, /{order}, /{order}/qr, /{order}/cancel, /{order}/tracking.

Formes personnalisées (manage shapes, create shapes, update shapes, delete shapes, export shapes, view shapes)

Gérer vos propres formes personnalisées — /api/v1/.../shapes (le contrôleur délimite les formes par votre user_id, afin que le sélecteur ne divulgue jamais les formes d’un autre marchand).

Portefeuille et retraits (view wallet)

Consulter le solde et les transactions — GET /api/v1/client/wallet, /wallet/transactions.
Demander un retrait — POST /api/v1/client/wallet/withdraw (limité via throttle:withdraw) — et les lister/annuler/obtenir le reçu sous /wallet/withdrawals.

Abonnement (view my-subscription)

Consulter votre abonnement et les forfaits, mettre à niveau, renouveler, annuler, basculer le renouvellement auto et consulter les factures — /api/v1/client/subscription/....

Retours et litiges (view return-requests)

Consulter vos demandes de retour — GET /api/v1/return-requests, /{return_request}, et annuler — /{return_request}/cancel.
Ouvrir des litiges — POST /api/v1/client/disputes — et les consulter.

Ce que vous ne pouvez pas faire

Ne peut voir les produits, commandes, inventaire, formes ni portefeuille d’aucun autre marchand.
Ne peut pas approuver ses propres commandes, affecter des chauffeurs ni confirmer le stockage — cela revient à l’admin/personnel et aux entreprises.
Pas de données de référence admin, pas d’autres utilisateurs, pas de paramètres plateforme.
Ne peut pas débloquer ses propres retraits — il ne fait que demander ; un administrateur détenant approve withdrawal-requests débloque les fonds.

Périmètre des données

Ses propres données uniquement (périmètre propriétaire). Chaque liste est filtrée sur les lignes que le client possède — par ex. /api/v1/client/orders ne renvoie que les commandes qu’il a créées, et les formes sont filtrées par son user_id. Il ne peut jamais voir les données d’un autre marchand.

Autorisations

Liste exacte (synchronisée dans 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.

Comment ce rôle est attribué

Attribué lors de l’auto-inscription — un marchand s’inscrit et est placé dans client. Aucune approbation d’administrateur n’est requise pour le rôle marchand lui-même (contrairement aux rôles d’entreprise).

Pages associées

Voir roles/overview pour la délimitation, et le guide marchand (par ex. merchant-guide/creating-orders) pour les flux détaillés.