feat: unify wallet with real payment methods, full transaction transparency, pay-session-from-wallet

Address wallet feedback: use the clinic's real payment infrastructure,
redesign the tab to match the admin panel, and make every wallet movement
fully auditable.

Backend:
- WalletTransaction: add createdBy (acting user) + createdByName, payment_method,
  reference, status; toArray exposes them (migration Version20260716083939).
- WalletService (Settlement): balance/charge/withdraw + settleSessionFromWallet,
  records actor/method/reason; insufficient balance throws ERR_WALLET_INSUFFICIENT.
- PatientController: charge/withdraw delegate to WalletService and accept
  payment_method/reference; PATCH /session/{uuid} with payment_method=wallet
  debits the patient's final share from the wallet (reference=session:{uuid}).
- docs/api/patient.md updated.

Frontend:
- Wallet modal redesigned to panel style (no gradient); payment method now uses
  the clinic's real bank accounts + POS devices (usePaymentMethods) plus cash.
- Wallet tab: panel balance card + DataTable ledger with columns مبلغ/نوع/روش/
  دلیل/ثبت‌کننده/تاریخ/ساعت/وضعیت + همه/واریزی/برداشت filters.
- Session card «تکمیل پرداخت» opens a payment-method chooser incl. کیف پول.

Tests: backend transparency + session-from-wallet (success/insufficient/cash);
frontend modal (real methods, toman→rials) + wallet tab + settle chooser.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

src/Settlement/Entity/WalletTransaction.php

@@ -17,6 +17,8 @@ class WalletTransaction
     public const TYPE_CREDIT = 'credit';
     public const TYPE_DEBIT  = 'debit';
 
+    public const STATUS_CONFIRMED = 'confirmed';
+
     #[ORM\Id]
     #[ORM\GeneratedValue]
     #[ORM\Column(type: 'integer')]
@@ -45,6 +47,26 @@ class WalletTransaction
     #[ORM\Column(name: 'balance_after', type: 'integer')]
     private int $balanceAfter;
 
+    /** کاربرِ عاملِ تراکنش (منشی/دکتر که شارژ/برداشت را ثبت کرده) — برای شفافیت. */
+    #[ORM\ManyToOne(targetEntity: User::class)]
+    #[ORM\JoinColumn(name: 'created_by_id', referencedColumnName: 'id', nullable: true, onDelete: 'SET NULL')]
+    private ?User $createdBy = null;
+
+    /** نامِ denormalizedِ کاربرِ عامل، تا خواندنِ دفتر تراکنش join نخواهد. */
+    #[ORM\Column(name: 'created_by_name', type: 'string', length: 120, nullable: true)]
+    private ?string $createdByName = null;
+
+    /** روش پرداخت: card | pos | cash | gateway | wallet. */
+    #[ORM\Column(name: 'payment_method', type: 'string', length: 20, nullable: true)]
+    private ?string $paymentMethod = null;
+
+    /** مرجع/دلیلِ ماشینی تراکنش (مثلاً session:{uuid} برای کسر بابت سرویس). */
+    #[ORM\Column(type: 'string', length: 120, nullable: true)]
+    private ?string $reference = null;
+
+    #[ORM\Column(type: 'string', length: 15)]
+    private string $status = self::STATUS_CONFIRMED;
+
     #[ORM\Column(name: 'created_at', type: 'integer')]
     private int $createdAt;
 
@@ -66,19 +88,33 @@ class WalletTransaction
     public function getType(): string       { return $this->type; }
     public function getDescription(): ?string { return $this->description; }
     public function getBalanceAfter(): int  { return $this->balanceAfter; }
+    public function getCreatedBy(): ?User    { return $this->createdBy; }
+    public function getCreatedByName(): ?string { return $this->createdByName; }
+    public function getPaymentMethod(): ?string { return $this->paymentMethod; }
+    public function getReference(): ?string  { return $this->reference; }
+    public function getStatus(): string      { return $this->status; }
 
     public function setPayment(?Payment $p): self      { $this->payment = $p; return $this; }
     public function setDescription(?string $d): self   { $this->description = $d; return $this; }
+    public function setCreatedBy(?User $u): self        { $this->createdBy = $u; return $this; }
+    public function setCreatedByName(?string $n): self  { $this->createdByName = $n; return $this; }
+    public function setPaymentMethod(?string $m): self  { $this->paymentMethod = $m; return $this; }
+    public function setReference(?string $r): self      { $this->reference = $r; return $this; }
+    public function setStatus(string $s): self          { $this->status = $s; return $this; }
 
     public function toArray(): array
     {
         return [
-            'uuid'          => $this->uuid,
-            'amount_rials'  => $this->amountRials,
-            'type'          => $this->type,
-            'description'   => $this->description,
-            'balance_after' => $this->balanceAfter,
-            'created_at'    => $this->createdAt,
+            'uuid'            => $this->uuid,
+            'amount_rials'    => $this->amountRials,
+            'type'            => $this->type,
+            'description'     => $this->description,
+            'balance_after'   => $this->balanceAfter,
+            'created_by_name' => $this->createdByName,
+            'payment_method'  => $this->paymentMethod,
+            'reference'       => $this->reference,
+            'status'          => $this->status,
+            'created_at'      => $this->createdAt,
         ];
     }
 }