<?php

namespace App\ClinicService\Entity;

use App\ClinicService\Repository\CatalogCategoryRepository;
use App\Shared\Tenant\TenantOwnedTrait;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Uid\Uuid;

/**
 * دسته‌بندی درختی کاتالوگ خدمات — «لیزر ← نواحی بدن»، «تزریقات ← ژل».
 *
 * نامش عمداً `ServiceCategory` نیست: آن نام از قبل گرفته شده و یک **enum بیمه‌ای**
 * است ({@see \App\Insurance\Enum\ServiceCategory} با مقادیر outpatient/inpatient) که
 * روی خودِ ServiceItem هم نشسته. هم‌نام کردنشان یعنی دو `use` متضاد در یک فایل.
 *
 * با {@see ServiceSection} هم فرق دارد: آن «بخش کلینیک» است (واحد سازمانی)، این
 * تاکسونومی کاتالوگ.
 */
#[ORM\Entity(repositoryClass: CatalogCategoryRepository::class)]
#[ORM\Table(name: 'service_catalog_categories')]
#[ORM\Index(columns: ['entity_type', 'entity_id', 'active'], name: 'idx_catalog_cat_tenant')]
#[ORM\Index(columns: ['parent_id'], name: 'idx_catalog_cat_parent')]
class CatalogCategory
{
    use TenantOwnedTrait;

    /** سقف عمق درخت — بدون آن یک اشتباه در UI می‌تواند زنجیرهٔ بی‌پایان بسازد. */
    public const MAX_DEPTH = 4;

    #[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: self::class)]
    #[ORM\JoinColumn(name: 'parent_id', referencedColumnName: 'id', nullable: true, onDelete: 'CASCADE')]
    private ?self $parent = null;

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

    #[ORM\Column(name: 'sort_order', type: 'smallint', options: ['default' => 0])]
    private int $sortOrder = 0;

    #[ORM\Column(type: 'boolean', options: ['default' => true])]
    private bool $active = true;

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

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

    public function __construct(string $entityType, int $entityId, string $name, ?self $parent = null)
    {
        $this->uuid      = Uuid::v4()->toRfc4122();
        $this->name      = $name;
        $this->parent    = $parent;
        $this->createdAt = time();
        $this->updatedAt = time();

        $this->assignTenantPair($entityType, $entityId);
    }

    public function getId(): ?int       { return $this->id; }
    public function getUuid(): string   { return $this->uuid; }
    public function getParent(): ?self  { return $this->parent; }
    public function getName(): string   { return $this->name; }
    public function getSortOrder(): int { return $this->sortOrder; }
    public function isActive(): bool    { return $this->active; }

    public function setName(string $v): self     { $this->name = $v; $this->touch(); return $this; }
    public function setSortOrder(int $v): self   { $this->sortOrder = $v; $this->touch(); return $this; }
    public function setActive(bool $v): self     { $this->active = $v; $this->touch(); return $this; }
    public function setParent(?self $v): self    { $this->parent = $v; $this->touch(); return $this; }

    /** عمق از ریشه؛ ریشه صفر است. */
    public function depth(): int
    {
        $depth  = 0;
        $node   = $this->parent;

        while ($node !== null && $depth <= self::MAX_DEPTH + 1) {
            $depth++;
            $node = $node->getParent();
        }

        return $depth;
    }

    private function touch(): void { $this->updatedAt = time(); }

    public function toArray(array $children = []): array
    {
        return [
            'uuid'        => $this->uuid,
            'parent_uuid' => $this->parent?->getUuid(),
            'name'        => $this->name,
            'sort_order'  => $this->sortOrder,
            'active'      => $this->active,
            'children'    => $children,
        ];
    }
}
