<?php

namespace App\Settlement\Entity;

use App\Auth\Entity\User;
use App\Payment\Entity\Payment;
use Doctrine\ORM\Mapping as ORM;
use App\Settlement\Repository\WalletTransactionRepository;
use Symfony\Component\Uid\Uuid;

#[ORM\Entity(repositoryClass: WalletTransactionRepository::class)]
#[ORM\Table(name: 'wallet_transactions')]
#[ORM\Index(columns: ['user_id', 'created_at'], name: 'idx_wallet_user_date')]
#[ORM\Index(columns: ['user_id', 'type'], name: 'idx_wallet_user_type')]
// دفترِ per-محیطِ یک شخص: WalletTransactionRepository::findByUserForEnvironment()
#[ORM\Index(columns: ['user_id', 'recorded_entity_type', 'recorded_entity_id'], name: 'idx_wallet_user_recorded_entity')]
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')]
    private ?int $id = null;

    #[ORM\Column(type: 'string', length: 36, unique: true)]
    private string $uuid;

    #[ORM\ManyToOne(targetEntity: User::class)]
    #[ORM\JoinColumn(name: 'user_id', referencedColumnName: 'id', nullable: false, onDelete: 'RESTRICT')]
    private User $user;

    #[ORM\ManyToOne(targetEntity: Payment::class)]
    #[ORM\JoinColumn(name: 'payment_id', referencedColumnName: 'id', nullable: true, onDelete: 'SET NULL')]
    private ?Payment $payment = null;

    #[ORM\Column(name: 'amount_rials', type: 'integer')]
    private int $amountRials;

    #[ORM\Column(type: 'string', length: 10)]
    private string $type;

    #[ORM\Column(type: 'string', length: 255, nullable: true)]
    private ?string $description = null;

    #[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, options: ['default' => self::STATUS_CONFIRMED])]
    private string $status = self::STATUS_CONFIRMED;

    /**
     * محیطی که این تراکنش **در آن ثبت شده** — نه مالکِ تراکنش.
     *
     * کیف پول مالِ شخص است و موجودی از مجموع credit−debitِ همهٔ ردیف‌های او مشتق
     * می‌شود؛ ولی دفترِ تراکنش را کلینیک هم می‌بیند و بدون این ستون، کلینیک A
     * می‌دید بیمار در کلینیک B چه پرداختی کرده و چه کسی ثبتش کرده.
     *
     * ⚠️ نام ستون عمداً `entity_type/entity_id` **نیست**: آن نام را TenantFilter
     * می‌شناسد و خودکار روی هر کوئری می‌نشیند — از جمله روی محاسبهٔ موجودی، که
     * آن‌وقت per-محیط می‌شد و پول بیمار را نصف نشان می‌داد. اینجا انتساب است، نه
     * مالکیت؛ فیلتر نباید ببیندش. {@see docs/architecture/tenancy.md}
     *
     * تهی یعنی «ثبت‌شده پیش از این تفکیک، یا بیرون از هر محیط» (مثل سهم نماینده)؛
     * چنین ردیفی در همهٔ محیط‌ها دیده می‌شود تا تاریخچهٔ کسی ناپدید نشود.
     */
    #[ORM\Column(name: 'recorded_entity_type', type: 'string', length: 10, nullable: true)]
    private ?string $recordedEntityType = null;

    #[ORM\Column(name: 'recorded_entity_id', type: 'integer', nullable: true)]
    private ?int $recordedEntityId = null;

    #[ORM\Column(name: 'created_at', type: 'integer')]
    private int $createdAt;

    public function __construct(User $user, int $amountRials, string $type, int $balanceAfter)
    {
        $this->uuid         = Uuid::v4()->toRfc4122();
        $this->user         = $user;
        $this->amountRials  = $amountRials;
        $this->type         = $type;
        $this->balanceAfter = $balanceAfter;
        $this->createdAt    = time();
    }

    public function getId(): ?int           { return $this->id; }
    public function getUuid(): string       { return $this->uuid; }
    public function getUser(): User         { return $this->user; }
    public function getPayment(): ?Payment  { return $this->payment; }
    public function getAmountRials(): int   { return $this->amountRials; }
    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 getRecordedEntityType(): ?string { return $this->recordedEntityType; }
    public function getRecordedEntityId(): ?int      { return $this->recordedEntityId; }

    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 setRecordedEnvironment(?string $entityType, ?int $entityId): self
    {
        $this->recordedEntityType = $entityType;
        $this->recordedEntityId   = $entityId;

        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_by_name' => $this->createdByName,
            'payment_method'  => $this->paymentMethod,
            'reference'       => $this->reference,
            'status'          => $this->status,
            'created_at'      => $this->createdAt,
        ];
    }
}
