feat: Add Laravel tinker examples and update nominal accounts functionality

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

src/Data/NominalAccounts/Beneficiaries/CreateBeneficiaryRequestData.php

@@ -14,6 +14,7 @@ namespace Apoloz\AlfaBank\Data\NominalAccounts\Beneficiaries;
 // <SECTION name="module_imports" intent="Import necessary DTOs and Spatie Laravel Data components for complex nested data structures.">
 // <BELIEF_STATE "This DTO has several nested DTOs and collections (`AddressData`, `DigestSignatureData`, `DocumentData`, `PersonalInformationData`). `DataCollectionOf` and `Data` ensure that these are all correctly typed and mapped.">
 use Apoloz\AlfaBank\Data\NominalAccounts\Payouts\DigestSignatureData;
+use Apoloz\AlfaBank\Traits\SignableData;
 use Spatie\LaravelData\Attributes\DataCollectionOf;
 use Spatie\LaravelData\Attributes\Validation\Email;
 use Spatie\LaravelData\Attributes\Validation\Numeric;
@@ -25,6 +26,8 @@ use Spatie\LaravelData\DataCollection;
 // <BELIEF_STATE "This DTO serves as a robust contract for the complex payload required to create a beneficiary. Type-safety here prevents malformed requests from even being constructed.">
 class CreateBeneficiaryRequestData extends Data
 {
+    use SignableData;
+
     // <SECTION name="constructor_properties" intent="Define all properties for the beneficiary creation request, including nested DTOs and collections.">
     // <BELIEF_STATE "The constructor meticulously lists all possible fields, making it clear what data is expected. Mandatory fields are non-nullable, while optional ones are nullable. Collections like `addresses` and `digestSignatures` are type-hinted with `DataCollection` and use `#[DataCollectionOf]` to ensure each item is itself a DTO.">
     public function __construct(
@@ -33,7 +36,7 @@ class CreateBeneficiaryRequestData extends Data
         #[DataCollectionOf(AddressData::class)]
         public DataCollection $addresses,
         #[DataCollectionOf(DigestSignatureData::class)]
-        public DataCollection $digestSignatures,
+        public ?DataCollection $digestSignatures = null,
         public ?string $accountNumber = null,
         public ?bool $taxResidentUS = null,
         public ?bool $foreignTaxResident = null,