[10.x] update docs

Author: rez1dent3

docs/_sidebar.md

@@ -35,6 +35,7 @@
 - Purchases
 
     - [Payment](payment)
+    - [Payment to a custom wallet](payment-custom-wallet)
     - [Payment Free](pay-free)
     - [Refund](refund)
     - [Gift](gift)

docs/batch-transactions.md

@@ -90,6 +90,18 @@ app(AtomicServiceInterface::class)->blocks($wallets, function () use ($wallets,
 });
 ```
 
+---
+
+In version 10.x, it became possible to create transactions with a given uuid (generate on the client side).
+The main thing is to keep uniqueness.
+
+```php
+use Bavix\Wallet\External\Api\TransactionQuery;
+
+TransactionQuery::createDeposit($wallet, $amount, null, uuid: '5f7820d1-1e82-4d03-9414-05d0c44da9a1')
+TransactionQuery::createWithdraw($wallet, $amount, null, uuid: '6e87dbf2-7be7-48c2-b688-f46ba4e25786')
+```
+
 ---
 It worked! 
 

docs/batch-transfers.md

@@ -30,6 +30,27 @@ app(TransferQueryHandlerInterface::class)->apply(
 
 The package will optimize queries and execute them in a single transaction. I strongly advise against creating large packs, because. this can lead to a large increase in request queuing.
 
+---
+
+In version 10.x, it became possible to create transactions&transfers with a given uuid (generate on the client side).
+The main thing is to keep uniqueness.
+
+```php
+use Bavix\Wallet\External\Api\TransferQuery;
+
+new TransferQuery($from, $wallet, $amount, new \Bavix\Wallet\External\Dto\Extra(
+    deposit: new \Bavix\Wallet\External\Dto\Option(
+        null,
+        uuid: '71cecafe-da10-464f-9e00-c80437bb4c3e', // deposit transaction
+    ),
+    withdraw: new \Bavix\Wallet\External\Dto\Option(
+        null,
+        uuid: '3805730b-39a1-419d-8715-0b7cc3f1ffc2', // withdraw transaction
+    ),
+    uuid: 'f8becf81-3993-43d7-81f1-7a725c72e976', // transfer uuid
+))
+```
+
 ---
 It worked! 
 

docs/payment-custom-wallet.md

@@ -0,0 +1,123 @@
+## User Model
+
+Add the `CanPay` trait and `Customer` interface to your User model.
+
+> The trait `CanPay` already inherits `HasWallet`, reuse will cause an error.
+
+```php
+use Bavix\Wallet\Traits\CanPay;
+use Bavix\Wallet\Interfaces\Customer;
+
+class User extends Model implements Customer
+{
+    use CanPay;
+}
+```
+
+## Item Model
+
+Add the `HasWallet` trait and interface to `Item` model.
+If we want to achieve multi wallets for a product, then we need to add `HasWallets`.
+
+Starting from version 9.x there are two product interfaces:
+- For an unlimited number of products (`ProductInterface`);
+- For a limited number of products (`ProductLimitedInterface`);
+
+An example with an unlimited number of products:
+```php
+use Bavix\Wallet\Traits\HasWallet;
+use Bavix\Wallet\Traits\HasWallets;
+use Bavix\Wallet\Interfaces\Customer;
+use Bavix\Wallet\Interfaces\ProductInterface;
+
+class Item extends Model implements ProductInterface
+{
+    use HasWallet, HasWallets;
+
+    public function getAmountProduct(Customer $customer): int|string
+    {
+        return 100;
+    }
+
+    public function getMetaProduct(): ?array
+    {
+        return [
+            'title' => $this->title, 
+            'description' => 'Purchase of Product #' . $this->id,
+        ];
+    }
+}
+```
+
+Example with a limited number of products:
+```php
+use Bavix\Wallet\Traits\HasWallet;
+use Bavix\Wallet\Traits\HasWallets;
+use Bavix\Wallet\Interfaces\Customer;
+use Bavix\Wallet\Interfaces\ProductLimitedInterface;
+
+class Item extends Model implements ProductLimitedInterface
+{
+    use HasWallet, HasWallets;
+
+    public function canBuy(Customer $customer, int $quantity = 1, bool $force = false): bool
+    {
+        return true; 
+    }
+    
+    public function getAmountProduct(Customer $customer): int|string
+    {
+        return 100;
+    }
+
+    public function getMetaProduct(): ?array
+    {
+        return [
+            'title' => $this->title, 
+            'description' => 'Purchase of Product #' . $this->id,
+        ];
+    }
+}
+```
+
+I do not recommend using the limited interface when working with a shopping cart.
+If you are working with a shopping cart, then you should override the `PurchaseServiceInterface` interface.
+With it, you can check the availability of all products with one request, there will be no N-queries in the database.
+
+## Proceed to purchase
+
+Find the user and check the balance.
+
+```php
+$user = User::first();
+$user->balance; // 100
+```
+
+Find the goods and check the cost.
+
+```php
+$item = Item::first();
+$item->getAmountProduct($user); // 100
+
+$receiving = $item->createWallet([
+    'name' => 'Dollar',
+    'meta' => [
+        'currency' => 'USD',
+    ],
+]);
+```
+
+The user can buy a product, buy...
+
+```php
+$cart = app(Cart::class)
+    ->withItem($item, receiving: $receiving)
+;
+
+$user->payCart($cart);
+$user->balance; // 0
+
+$receiving->balanceInt; // $100
+```
+
+It worked! 

docs/upgrade-guide.md

@@ -248,3 +248,10 @@ The product has been divided into two interfaces:
 The old Product interface should be replaced with one of these.
 
 Replace `Bavix\Wallet\Interfaces\Product` to `Bavix\Wallet\Interfaces\ProductLimitedInterface`. 
+
+## 9.x.x  → 10.0.x
+
+1. If you have a custom BookkeeperServiceInterface, then you need to update the contract.
+2. If you catch a LockProviderNotFoundException, then you need to remove the check. This exception no longer exists.
+3. If you have specific requests for transfers using the MorphMany relation, then you need to rewrite it to the HasMany relation.
+