feat: Add Laravel tinker examples and update nominal accounts functionality

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>

src/Data/NominalAccounts/Payouts/PayoffRequestData.php

@@ -13,7 +13,12 @@ namespace Apoloz\AlfaBank\Data\NominalAccounts\Payouts;
 
 // <SECTION name="module_imports" intent="Import necessary DTOs and Spatie Laravel Data components for complex nested data structures.">
 // <BELIEF_STATE "This DTO orchestrates several other DTOs and collections (`RecipientData`, `PayoutRequisiteData`, `DigestSignatureData`), requiring `DataCollectionOf` for typed arrays.">
+use Apoloz\AlfaBank\Data\Common\PayoutRequisiteData;
+use Apoloz\AlfaBank\Data\Common\RecipientData;
+use Apoloz\AlfaBank\Data\Common\TaxData;
+use Apoloz\AlfaBank\Traits\SignableData;
 use Spatie\LaravelData\Attributes\DataCollectionOf;
+use Spatie\LaravelData\Attributes\Validation\Numeric;
 use Spatie\LaravelData\Data;
 use Spatie\LaravelData\DataCollection;
 // </SECTION>
@@ -22,6 +27,8 @@ use Spatie\LaravelData\DataCollection;
 // <BELIEF_STATE "This DTO provides a robust contract for the complex payload required to initiate a payment. It ensures that all financial and security-critical data is strictly typed and correctly structured.">
 class PayoffRequestData extends Data
 {
+    use SignableData;
+
     // <SECTION name="constructor_properties" intent="Define all properties for the payoff request.">
     // <BELIEF_STATE "The constructor includes mandatory fields like `type`, `accountNumber`, `recipient`, `payoutRequisite`, `amount`, `purpose`, and `digestSignatures`. Nested DTOs (`RecipientData`, `PayoutRequisiteData`) ensure detailed sub-structures are also type-safe. Optional fields like `deponent`, `requisites`, and `tax` provide flexibility for different payment scenarios.">
     public function __construct(
@@ -29,13 +36,15 @@ class PayoffRequestData extends Data
         public string $accountNumber,
         public RecipientData $recipient,
         public PayoutRequisiteData $payoutRequisite,
+        #[Numeric]
         public string $amount,
         public string $purpose,
         #[DataCollectionOf(DigestSignatureData::class)]
-        public DataCollection $digestSignatures,
+        public ?DataCollection $digestSignatures = null,
         public ?string $deponent = null,
-        public ?array $requisites = null, // Can be nested DTOs if defined
-        public ?array $tax = null, // Can be nested DTOs if defined
+        #[DataCollectionOf(PayoutRequisiteData::class)]
+        public ?DataCollection $requisites = null,
+        public ?TaxData $tax = null,
     ) {}
     // </SECTION>
 }