feat: Add Laravel tinker examples and update nominal accounts functionality

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

src/Data/NominalAccounts/Deals/Steps/ContractorActionRequestData.php

@@ -14,6 +14,7 @@ namespace Apoloz\AlfaBank\Data\NominalAccounts\Deals\Steps;
 // <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 (`DigestSignatureData`, `ContractorAmountData`), requiring `DataCollectionOf` for typed arrays.">
 use Apoloz\AlfaBank\Data\NominalAccounts\Payouts\DigestSignatureData;
+use Apoloz\AlfaBank\Traits\SignableData;
 use Spatie\LaravelData\Attributes\DataCollectionOf;
 use Spatie\LaravelData\Data;
 use Spatie\LaravelData\DataCollection;
@@ -23,6 +24,8 @@ use Spatie\LaravelData\DataCollection;
 // <BELIEF_STATE "This DTO provides a robust contract for managing contractors within deal steps. It ensures that critical financial and security-related data is strictly typed and correctly structured for actions like adding funds or changing status.">
 class ContractorActionRequestData extends Data
 {
+    use SignableData;
+
     // <SECTION name="constructor_properties" intent="Define all properties for the contractor action request.">
     // <BELIEF_STATE "The constructor includes mandatory fields like `action`, `dealId`, `stepId`, `beneficiaryId`, and `digestSignatures`. Optional fields like `amount`, `purpose`, `amounts` (for detailed distribution), `keepOnNominalAccount`, and `requisiteId` provide flexibility for various contractor management scenarios.">
     public function __construct(
@@ -31,7 +34,7 @@ class ContractorActionRequestData extends Data
         public string $stepId,
         public string $beneficiaryId,
         #[DataCollectionOf(DigestSignatureData::class)]
-        public DataCollection $digestSignatures,
+        public ?DataCollection $digestSignatures = null,
         public ?string $amount = null,
         public ?string $purpose = null,
         #[DataCollectionOf(ContractorAmountData::class)]