cqrs docs

Author: rez1dent3

docs/_sidebar.md

@@ -47,6 +47,10 @@
     - [TransactionCreatedEvent](transaction-created-event)
     - [Event Customize](event-customize)
 
+- CQRS
+
+    - [Create Wallet](command-create-wallet)
+
 - Additions
 
     - [Wallet Swap](laravel-wallet-swap)

docs/command-create-wallet.md

@@ -0,0 +1,59 @@
+# Asynchronous wallet creation
+
+The idea is based on the division into teams for creating wallets, transactions, etc. The creation of a wallet can be accelerated if the client "generates a wallet himself".
+
+---
+
+## User Model
+
+Add the `HasWallet`, `HasWallets` trait's and `Wallet` interface to model.
+
+```php
+use Bavix\Wallet\Traits\HasWallet;
+use Bavix\Wallet\Traits\HasWallets;
+use Bavix\Wallet\Interfaces\Wallet;
+
+class User extends Model implements Wallet
+{
+    use HasWallet, HasWallets;
+}
+```
+
+## Action Handler
+
+```php
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\Support\Facades\Response as ResponseFactory;
+...
+
+public function __invoke(User $user, Request $request): Response
+{
+    $name = $request->get('wallet_name');
+    $uuid = $request->get('wallet_uuid');
+
+    $message = new CreateWalletCommandMessage($user, $name, $uuid);
+    dispatch($message);
+
+    return ResponseFactory::json([], 202);
+}
+```
+
+## Command Handler
+
+```php
+public function __invoke(CreateWalletCommandMessage $message): void
+{
+    $user = $message->getUser();
+    $user->createWallet([
+        'uuid' => $message->getWalletUuid(),
+        'name' => $message->getWalletName(),
+    ]);
+}
+```
+
+You receive requests to create a wallet on the backend, and you create them asynchronously. UUID4 is generated on the client side and the client already knows it. You will not be able to create two wallets with one uuid, because the column in the database is unique.
+
+The user no longer needs to wait for the creation of a wallet, it is enough to know the uuid. You get the most stable application.
+
+It worked!