refactor(core): enhance SDK structure and documentation

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

src/Data/Statement/RurTransferData.php

@@ -0,0 +1,44 @@
+<?php
+/*
+// MODULE_CONTRACT: Defines the data structure for detailed Russian Ruble (RUR) transfer information within a transaction.
+// RESPONSIBILITY: To hold and type-safely represent comprehensive details about the payer and payee in an RUR transfer.
+// INPUTS: Raw JSON object from the API response.
+// OUTPUTS: A structured object containing RUR transfer details.
+// LINKS: TransactionData.php
+*/
+
+namespace Apoloz\AlfaBank\Data\Statement;
+
+// <SECTION name="module_imports" intent="Import the base Spatie Laravel Data class.">
+// <BELIEF_STATE "Extending `Spatie\LaravelData\Data` enables automatic casting from JSON and provides other DTO benefits.">
+use Spatie\LaravelData\Data;
+// </SECTION>
+
+// <SECTION name="class_definition" intent="Define a DTO for Russian Ruble transfer details.">
+// <BELIEF_STATE "This DTO provides a clear, type-safe contract for highly detailed RUR transfer information, which is critical for financial reconciliation and compliance with Russian banking standards.">
+class RurTransferData extends Data
+{
+    // <SECTION name="constructor_properties" intent="Define the comprehensive properties of an RUR transfer.">
+    // <BELIEF_STATE "The constructor includes a wide array of optional fields covering full payee and payer details (account, bank BIC, correspondent account, INN, KPP, name), as well as specific payment attributes like `paymentKind110`, `priority`, `receiptDate`, and `valueDate`. All are optional as not all fields may be present or relevant in every transaction record.">
+    public function __construct(
+        public ?string $payeeAccount = null,
+        public ?string $payeeBankBic = null,
+        public ?string $payeeBankCorrAccount = null,
+        public ?string $payeeBankName = null,
+        public ?string $payeeInn = null,
+        public ?string $payeeKpp = null,
+        public ?string $payeeName = null,
+        public ?string $payerAccount = null,
+        public ?string $payerBankBic = null,
+        public ?string $payerBankCorrAccount = null,
+        public ?string $payerBankName = null,
+        public ?string $payerInn = null,
+        public ?string $payerKpp = null,
+        public ?string $payerName = null,
+        public ?string $paymentKind110 = null,
+        public ?string $priority = null,
+        public ?string $receiptDate = null,
+        public ?string $valueDate = null,
+    ) {}
+    // </SECTION>
+}