src/Entity/Driver.php line 19

  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\DriverRepository;
  6. use Doctrine\ORM\Mapping as ORM;
  8. /**
  9.  * A driver's profile. Authentication stays on User (ROLE_DRIVER); this entity
  10.  * only carries the driving-specific data.
  11.  *
  12.  * A driver has no coordinates of their own: their position IS the position of
  13.  * the tuk they drive, so getLatitude()/getLongitude() read through to the Tuk.
  14.  *
  15.  * @ORM\Entity(repositoryClass=DriverRepository::class)
  16.  * @ORM\Table(name="driver")
  17.  * @ORM\HasLifecycleCallbacks()
  18.  */
  19. class Driver
  20. {
  21.     /**
  22.      * @ORM\Id
  23.      * @ORM\GeneratedValue
  24.      * @ORM\Column(type="integer")
  25.      */
  26.     private ?int $id = null;
  28.     /**
  29.      * @ORM\OneToOne(targetEntity=User::class)
  30.      * @ORM\JoinColumn(nullable=false, unique=true)
  31.      */
  32.     private User $user;
  34.     /**
  35.      * The tuk this driver drives. Inverse side — Tuk owns the join column.
  36.      * @ORM\OneToOne(targetEntity=Tuk::class, mappedBy="driver")
  37.      */
  38.     private ?Tuk $tuk = null;
  40.     /**
  41.      * Public-facing photo path, shown to the passenger when choosing a tuk.
  42.      * @ORM\Column(type="string", length=500, nullable=true)
  43.      */
  44.     private ?string $photo = null;
  46.     /**
  47.      * @ORM\Column(type="string", length=50, nullable=true)
  48.      */
  49.     private ?string $licenseNumber = null;
  51.     /**
  52.      * Languages the driver speaks, as ISO 639-1 codes, e.g. ["en", "hy"].
  53.      * @ORM\Column(type="json")
  54.      */
  55.     private array $languages = [];
  57.     /**
  58.      * Average rating, 0.0–5.0.
  59.      * @ORM\Column(type="decimal", precision=2, scale=1, options={"default": "5.0"})
  60.      */
  61.     private string $rating = '5.0';
  63.     /**
  64.      * How many ratings $rating is averaged over.
  65.      * @ORM\Column(type="integer", options={"default": 0})
  66.      */
  67.     private int $ratingCount = 0;
  69.     /**
  70.      * Completed tours, shown as experience on the driver card.
  71.      * @ORM\Column(type="integer", options={"default": 0})
  72.      */
  73.     private int $tripCount = 0;
  75.     /**
  76.      * Running total of the gratuities passengers have added after their tours,
  77.      * in dram. Kept as an aggregate here so the driver's profile can show it
  78.      * without summing the whole booking table on every page view.
  79.      *
  80.      * @ORM\Column(type="integer", options={"default": 0})
  81.      */
  82.     private int $tipsAmd = 0;
  84.     /**
  85.      * @ORM\Column(type="boolean", options={"default": true})
  86.      */
  87.     private bool $isActive = true;
  89.     /**
  90.      * @ORM\Column(type="datetime_immutable")
  91.      */
  92.     private \DateTimeImmutable $createdAt;
  94.     /**
  95.      * @ORM\Column(type="datetime_immutable", nullable=true)
  96.      */
  97.     private ?\DateTimeImmutable $updatedAt = null;
  99.     public function __construct()
  100.     {
  101.         $this->createdAt = new \DateTimeImmutable();
  102.     }
  104.     /**
  105.      * @ORM\PreUpdate()
  106.      */
  107.     public function onPreUpdate(): void
  108.     {
  109.         $this->updatedAt = new \DateTimeImmutable();
  110.     }
  112.     public function getId(): ?int
  113.     {
  114.         return $this->id;
  115.     }
  117.     public function getUser(): User
  118.     {
  119.         return $this->user;
  120.     }
  122.     public function setUser(?User $user): self
  123.     {
  124.         $this->user = $user;
  125.         return $this;
  126.     }
  128.     public function getTuk(): ?Tuk
  129.     {
  130.         return $this->tuk;
  131.     }
  133.     public function setTuk(?Tuk $tuk): self
  134.     {
  135.         $this->tuk = $tuk;
  136.         return $this;
  137.     }
  139.     public function getPhoto(): ?string
  140.     {
  141.         return $this->photo;
  142.     }
  144.     public function setPhoto(?string $photo): self
  145.     {
  146.         $this->photo = $photo;
  147.         return $this;
  148.     }
  150.     public function getLicenseNumber(): ?string
  151.     {
  152.         return $this->licenseNumber;
  153.     }
  155.     public function setLicenseNumber(?string $licenseNumber): self
  156.     {
  157.         $this->licenseNumber = $licenseNumber;
  158.         return $this;
  159.     }
  161.     public function getLanguages(): array
  162.     {
  163.         return $this->languages;
  164.     }
  166.     public function setLanguages(array $languages): self
  167.     {
  168.         $this->languages = array_values(array_unique($languages));
  169.         return $this;
  170.     }
  172.     public function getRating(): float
  173.     {
  174.         return (float) $this->rating;
  175.     }
  177.     public function setRating(float $rating): self
  178.     {
  179.         $this->rating = number_format(max(0.0, min(5.0, $rating)), 1, '.', '');
  180.         return $this;
  181.     }
  183.     public function getRatingCount(): int
  184.     {
  185.         return $this->ratingCount;
  186.     }
  188.     public function setRatingCount(int $ratingCount): self
  189.     {
  190.         $this->ratingCount = $ratingCount;
  191.         return $this;
  192.     }
  194.     /**
  195.      * Fold a new 1–5 star rating into the running average.
  196.      */
  197.     public function addRating(int $stars): self
  198.     {
  199.         $stars = max(1, min(5, $stars));
  200.         $total = $this->getRating() * $this->ratingCount + $stars;
  201.         $this->ratingCount++;
  202.         $this->setRating($total / $this->ratingCount);
  203.         return $this;
  204.     }
  206.     public function getTripCount(): int
  207.     {
  208.         return $this->tripCount;
  209.     }
  211.     public function setTripCount(int $tripCount): self
  212.     {
  213.         $this->tripCount = $tripCount;
  214.         return $this;
  215.     }
  217.     public function getTipsAmd(): int
  218.     {
  219.         return $this->tipsAmd;
  220.     }
  222.     public function setTipsAmd(int $tipsAmd): self
  223.     {
  224.         $this->tipsAmd = max(0, $tipsAmd);
  225.         return $this;
  226.     }
  228.     /**
  229.      * Fold a gratuity into the running total.
  230.      */
  231.     public function addTip(int $amountAmd): self
  232.     {
  233.         $this->tipsAmd += max(0, $amountAmd);
  234.         return $this;
  235.     }
  237.     public function isActive(): bool
  238.     {
  239.         return $this->isActive;
  240.     }
  242.     public function setIsActive(bool $isActive): self
  243.     {
  244.         $this->isActive = $isActive;
  245.         return $this;
  246.     }
  248.     public function getCreatedAt(): \DateTimeImmutable
  249.     {
  250.         return $this->createdAt;
  251.     }
  253.     public function getUpdatedAt(): ?\DateTimeImmutable
  254.     {
  255.         return $this->updatedAt;
  256.     }
  258.     // ── Read-through helpers: a driver is wherever their tuk is ──────────
  260.     public function getName(): string
  261.     {
  262.         return $this->user->getName();
  263.     }
  265.     public function getLatitude(): ?float
  266.     {
  267.         return $this->tuk?->getLatitude();
  268.     }
  270.     public function getLongitude(): ?float
  271.     {
  272.         return $this->tuk?->getLongitude();
  273.     }
  275.     public function isOnline(): bool
  276.     {
  277.         return $this->tuk !== null && $this->tuk->isOnline();
  278.     }
  280.     public function __toString(): string
  281.     {
  282.         return $this->user->getName() ?? '';
  283.     }
  284. }