src/Entity/Reservation.php line 19

  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\ReservationRepository;
  6. use App\Traits\TimeStampTrait;
  7. use Doctrine\Common\Collections\ArrayCollection;
  8. use Doctrine\Common\Collections\Collection;
  9. use Doctrine\DBAL\Types\Types;
  10. use Doctrine\ORM\Mapping as ORM;
  11. use Symfony\Component\Validator\Constraints as Assert;
  13. #[ORM\Entity(repositoryClass: ReservationRepository::class)]
  14. #[ORM\Table(name: 'reservation')]
  15. #[ORM\Index(columns: ['status'], name: 'idx_res_status')]
  16. #[ORM\Index(columns: ['check_in_date', 'check_out_date'], name: 'idx_res_dates')]
  17. #[ORM\UniqueConstraint(name: 'ux_res_code', columns: ['code'])]
  18. #[ORM\HasLifecycleCallbacks]
  19. class Reservation
  20. {
  21.     use TimeStampTrait; // createdAt, updatedAt si ton trait les gère
  23.     // ---- Status constants ---------------------------------------------------
  24.     public const STATUS_TENTATIVE = 'tentative';
  25.     public const STATUS_CONFIRMED = 'confirmed';
  26.     public const STATUS_ARRIVED   = 'arrived';
  27.     public const STATUS_DEPARTED  = 'departed';
  28.     public const STATUS_CANCELED  = 'canceled';
  30.     /**
  31.      * Mapping for display (FR labels)
  32.      */
  33.     public const STATUS_LABELS = [
  34.         self::STATUS_TENTATIVE => 'Tentative',
  35.         self::STATUS_CONFIRMED => 'Confirmée',
  36.         self::STATUS_ARRIVED   => 'Arrivée',
  37.         self::STATUS_DEPARTED  => 'Parti',
  38.         self::STATUS_CANCELED  => 'Annulée',
  39.     ];
  41.     public const STATUS_BADGES = [
  42.         'tentative' => 'bg-warning text-dark',
  43.         'confirmed' => 'bg-success',
  44.         'arrived'   => 'bg-info',
  45.         'departed'  => 'bg-secondary',
  46.         'canceled'  => 'bg-danger',
  47.     ];
  49.     // ---- Identity -----------------------------------------------------------
  50.     #[ORM\Id]
  51.     #[ORM\GeneratedValue]
  52.     #[ORM\Column(type: Types::INTEGER)]
  53.     private ?int $id = null;
  55.     /** Human-friendly ref (e.g. RES-2025-000123) */
  56.     #[ORM\Column(length: 40, nullable: true)]
  57.     private ?string $code = null;
  59.     // ---- Relations ----------------------------------------------------------
  60.     #[ORM\ManyToOne(inversedBy: 'reservations')]
  61.     #[ORM\JoinColumn(nullable: false, onDelete: 'RESTRICT')]
  62.     #[Assert\NotNull(message: 'L’unité (habitat) est requise.')]
  63.     private ?Habitat $habitat = null; // unité actuelle
  65.     /**
  66.      * Unité d’origine (mise à la création, non modifiée ensuite).
  67.      * Permet de savoir d’où vient la réservation même après des transferts d’unité.
  68.      */
  69.     #[ORM\ManyToOne]
  70.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  71.     private ?Habitat $originalHabitat = null;
  73.     /** The guest/customer making the stay */
  74.     #[ORM\ManyToOne]
  75.     #[ORM\JoinColumn(nullable: false, onDelete: 'RESTRICT')]
  76.     #[Assert\NotNull(message: 'Le client (locataire) est requis.')]
  77.     private ?Locataire $locataire = null;
  79.     /** Detailed charges (nights, cleaning, extras…) */
  80.     #[ORM\OneToMany(mappedBy: 'reservation', targetEntity: ReservationCharge::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  81.     private Collection $charges;
  83.     // ---- Dates & people -----------------------------------------------------
  84.     #[ORM\Column(type: Types::DATE_MUTABLE)]
  85.     #[Assert\NotNull]
  86.     private ?\DateTimeInterface $checkInDate = null;
  88.     #[ORM\Column(type: Types::DATE_MUTABLE)]
  89.     #[Assert\NotNull]
  90.     private ?\DateTimeInterface $checkOutDate = null; // exclusive
  92.     /** Derived (checkOut - checkIn); kept for reporting/perf */
  93.     #[ORM\Column(type: Types::INTEGER)]
  94.     #[Assert\Positive(message: 'Le nombre de nuits doit être > 0.')]
  95.     private int $nights = 1;
  97.     #[ORM\Column(type: Types::INTEGER, options: ['default' => 1])]
  98.     #[Assert\Positive]
  99.     private int $adults = 1;
  101.     #[ORM\Column(type: Types::INTEGER, options: ['default' => 0])]
  102.     #[Assert\GreaterThanOrEqual(0)]
  103.     private int $children = 0;
  105.     #[ORM\Column(length: 50, nullable: true)]
  106.     private ?string $source = null; // walk-in, WhatsApp, Booking, Airbnb…
  108.     // ---- Financials ---------------------------------------------------------
  109.     #[ORM\Column(type: Types::STRING, length: 10, options: ['default' => 'USD'])]
  110.     private string $currency = 'USD';
  112.     /** Total (in cents) for the stay (sum of charges) */
  113.     #[ORM\Column(type: Types::DECIMAL, precision: 10, scale: 2)]
  114.     private string $totalAmount;
  116.     /** Remaining balance (in cents), if you track it here */
  117.     #[ORM\Column(type: Types::DECIMAL, precision: 10, scale: 2)]
  118.     private string $balanceDue;
  120.     // ---- Status & notes -----------------------------------------------------
  121.     #[ORM\Column(length: 12, options: ['default' => self::STATUS_CONFIRMED])]
  122.     #[Assert\Choice([
  123.         self::STATUS_TENTATIVE,
  124.         self::STATUS_CONFIRMED,
  125.         self::STATUS_ARRIVED,
  126.         self::STATUS_DEPARTED,
  127.         self::STATUS_CANCELED
  128.     ])]
  129.     private string $status = self::STATUS_CONFIRMED;
  131.     #[ORM\Column(type: Types::TEXT, nullable: true)]
  132.     private ?string $notes = null;
  134.     #[ORM\ManyToOne(inversedBy: 'reservations')]
  135.     private ?Entreprise $marchand = null;
  137.     #[ORM\Column]
  138.     private ?bool $isBooked = null;
  140.     #[ORM\Column(length: 25, nullable: true)]
  141.     private ?string $term = null; // night|week|month (ou variante)
  143.     #[ORM\ManyToOne(inversedBy: 'reservations')]
  144.     private ?User $createdBy = null;
  146.     // ---- Unit move history --------------------------------------------------
  147.     /**
  148.      * Historique des mouvements d’unité (JSON array)
  149.      * Chaque entrée :
  150.      * {fromId,toId,fromName,toName,movedAt(ISO8601),movedBy,reason,priceDelta}
  151.      */
  152.     #[ORM\Column(type: Types::JSON, nullable: true)]
  153.     private ?array $unitHistory = [];
  155.     #[ORM\Column(type: Types::DATETIME_IMMUTABLE, nullable: true)]
  156.     private ?\DateTimeImmutable $lastMoveAt = null;
  158.     #[ORM\Column(type: Types::DECIMAL, precision: 10, scale: 2, nullable: true)]
  159.     private ?string $unitPrice = null;
  161.     #[ORM\Column(nullable: true)]
  162.     private ?int $quantity = null;
  164.     #[ORM\Column(nullable: true)]
  165.     private ?int $subtotal = null;
  167.     #[ORM\Column(type: Types::DECIMAL, precision: 10, scale: 2, nullable: true)]
  168.     private ?string $fees = null;
  170.     #[ORM\Column(type: Types::DECIMAL, precision: 10, scale: 2, nullable: true)]
  171.     private ?string $total = null;
  173.     // ---- Constructor --------------------------------------------------------
  174.     public function __construct()
  175.     {
  176.         $this->charges = new ArrayCollection();
  177.     }
  179.     // ---- Domain validations -------------------------------------------------
  180.     /** Ensures check-in < check-out. */
  181.     #[Assert\IsTrue(message: 'La date de départ doit être strictement postérieure à la date d’arrivée.')]
  182.     public function isValidPeriod(): bool
  183.     {
  184.         if (!$this->checkInDate || !$this->checkOutDate) {
  185.             return true; // autres contraintes valideront les nulls
  186.         }
  187.         return $this->checkOutDate > $this->checkInDate;
  188.     }
  190.     // ---- Lifecycle: compute nights & totals --------------------------------
  191.     #[ORM\PrePersist]
  192.     #[ORM\PreUpdate]
  193.     public function computeDerivedFields(): void
  194.     {
  195.         if ($this->checkInDate && $this->checkOutDate) {
  196.             $this->nights = (int) $this->checkInDate->diff($this->checkOutDate)->days;
  197.         }
  199.         // Si originalHabitat non défini à la création, l’initialiser
  200.         if (($this->originalHabitat === null) && $this->habitat !== null && $this->id === null) {
  201.             $this->originalHabitat = $this->habitat;
  202.         }
  204.         $this->recalculateTotals();
  205.     }
  207.     // ---- Helpers ------------------------------------------------------------
  208.     /** Recalculate totalAmount from charges; balanceDue untouched here. */
  209.     // In Reservation entity:
  210.     public function recalculateTotals(): void
  211.     {
  212.         $total = 0.0;
  213.         $paid  = 0.0;
  215.         foreach ($this->charges as $c) {
  216.             $total += $c->getTotalAmount();
  217.             $paid  += $c->getPaidAmount();
  218.         }
  220.         $this->totalAmount = $total;
  221.         $this->balanceDue  = (max(0, $total - $paid));
  222.     }
  226.     public function addCharge(ReservationCharge $charge): self
  227.     {
  228.         if (!$this->charges->contains($charge)) {
  229.             $this->charges->add($charge);
  230.             $charge->setReservation($this);
  231.             $this->recalculateTotals();
  232.         }
  233.         return $this;
  234.     }
  236.     public function removeCharge(ReservationCharge $charge): self
  237.     {
  238.         if ($this->charges->removeElement($charge)) {
  239.             if ($charge->getReservation() === $this) {
  240.                 $charge->setReservation(null);
  241.             }
  242.             $this->recalculateTotals();
  243.         }
  244.         return $this;
  245.     }
  247.     /** Convenience: set both dates at once. */
  248.     public function setPeriod(\DateTimeInterface $checkIn, \DateTimeInterface $checkOut): self
  249.     {
  250.         $this->checkInDate = $checkIn;
  251.         $this->checkOutDate = $checkOut;
  252.         return $this;
  253.     }
  255.     /** Overlap helper (repository/service devrait faire le contrôle centralisé). */
  256.     public function overlapsWith(\DateTimeInterface $from, \DateTimeInterface $to): bool
  257.     {
  258.         if (!$this->checkInDate || !$this->checkOutDate) {
  259.             return false;
  260.         }
  261.         // [checkIn, checkOut) overlaps [from, to)
  262.         return $this->checkInDate < $to && $this->checkOutDate > $from && $this->status !== self::STATUS_CANCELED;
  263.     }
  265.     // ---- Unit move history helpers -----------------------------------------
  266.     // --- in Reservation.php ---
  268.     public function getUnitHistory(): array
  269.     {
  270.         return is_array($this->unitHistory) ? $this->unitHistory : [];
  271.     }
  273.     public function setUnitHistory(?array $history): self
  274.     {
  275.         $this->unitHistory = $history ?? [];
  276.         return $this;
  277.     }
  279.     /**
  280.      * Append one movement entry to unitHistory JSON.
  281.      * $priceDelta = in your money unit (e.g. cents if you use integers; adapt if you use floats)
  282.      */
  283.     public function addUnitHistoryEntry(
  284.         ?int    $fromId,
  285.         ?string $fromName,
  286.         ?int    $toId,
  287.         ?string $toName,
  288.         ?string $movedBy = null,
  289.         ?string $reason  = null,
  290.         int|float $priceDelta = 0,
  291.         ?\DateTimeInterface $movedAt = null
  292.     ): self {
  293.         $h = $this->getUnitHistory();
  294.         $h[] = [
  295.             'fromId'     => $fromId,
  296.             'fromName'   => $fromName,
  297.             'toId'       => $toId,
  298.             'toName'     => $toName,
  299.             'movedAt'    => ($movedAt ?? new \DateTimeImmutable())->format(\DateTimeInterface::ATOM), // ISO8601
  300.             'movedBy'    => $movedBy,     // e.g. user email/name
  301.             'reason'     => $reason,
  302.             'priceDelta' => $priceDelta,
  303.         ];
  304.         $this->unitHistory = $h;
  305.         return $this;
  306.     }
  309.     // ---- Getters / Setters --------------------------------------------------
  310.     public function getId(): ?int { return $this->id; }
  312.     public function getCode(): ?string { return $this->code; }
  313.     public function setCode(?string $code): self { $this->code = $code; return $this; }
  315.     public function getHabitat(): ?Habitat { return $this->habitat; }
  316.     public function setHabitat(?Habitat $habitat): self { $this->habitat = $habitat; return $this; }
  318.     public function getOriginalHabitat(): ?Habitat { return $this->originalHabitat; }
  319.     public function setOriginalHabitat(?Habitat $h): self { $this->originalHabitat = $h; return $this; }
  321.     /** @return Collection<int, ReservationCharge> */
  322.     public function getCharges(): Collection { return $this->charges; }
  324.     public function getLocataire(): ?Locataire { return $this->locataire; }
  325.     public function setLocataire(?Locataire $locataire): self { $this->locataire = $locataire; return $this; }
  327.     public function getCheckInDate(): ?\DateTimeInterface { return $this->checkInDate; }
  328.     public function setCheckInDate(?\DateTimeInterface $d): self { $this->checkInDate = $d; return $this; }
  330.     public function getCheckOutDate(): ?\DateTimeInterface { return $this->checkOutDate; }
  331.     public function setCheckOutDate(?\DateTimeInterface $d): self { $this->checkOutDate = $d; return $this; }
  333.     public function getNights(): int { return $this->nights; }
  334.     public function setNights(int $n): self { $this->nights = $n; return $this; } // généralement calculé
  336.     public function getAdults(): int { return $this->adults; }
  337.     public function setAdults(int $a): self { $this->adults = $a; return $this; }
  339.     public function getChildren(): int { return $this->children; }
  340.     public function setChildren(int $c): self { $this->children = $c; return $this; }
  342.     public function getSource(): ?string { return $this->source; }
  343.     public function setSource(?string $s): self { $this->source = $s; return $this; }
  345.     public function getCurrency(): string { return $this->currency; }
  346.     public function setCurrency(string $cur): self { $this->currency = $cur; return $this; }
  348.     public function getTotalAmount(): int { return $this->totalAmount; }
  349.     public function setTotalAmount(int $amt): self { $this->totalAmount = $amt; return $this; }
  351.     public function getBalanceDue(): int { return $this->balanceDue; }
  352.     public function setBalanceDue(int $amt): self { $this->balanceDue = $amt; return $this; }
  354.     public function getStatus(): string { return $this->status; }
  355.     public function setStatus(string $status): self { $this->status = $status; return $this; }
  357.     public function getNotes(): ?string { return $this->notes; }
  358.     public function setNotes(?string $n): self { $this->notes = $n; return $this; }
  360.     public function getMarchand(): ?Entreprise { return $this->marchand; }
  361.     public function setMarchand(?Entreprise $marchand): static { $this->marchand = $marchand; return $this; }
  363.     public function isIsBooked(): ?bool { return $this->isBooked; }
  364.     public function setIsBooked(bool $isBooked): static { $this->isBooked = $isBooked; return $this; }
  366.     public function getTerm(): ?string { return $this->term; }
  367.     public function setTerm(?string $term): static { $this->term = $term; return $this; }
  369.     public function getCreatedBy(): ?User { return $this->createdBy; }
  370.     public function setCreatedBy(?User $createdBy): static { $this->createdBy = $createdBy; return $this; }
  372.     public function getLastMoveAt(): ?\DateTimeImmutable { return $this->lastMoveAt; }
  373.     public function setLastMoveAt(?\DateTimeImmutable $d): self { $this->lastMoveAt = $d; return $this; }
  375.     public function __toString(): string
  376.     {
  377.         $ref = $this->code ?? ('RES#'.$this->id);
  378.         $h   = $this->habitat?->getLibelle() ?? $this->habitat?->getCode() ?? 'Habitat';
  379.         $in  = $this->checkInDate?->format('Y-m-d') ?? '?';
  380.         $out = $this->checkOutDate?->format('Y-m-d') ?? '?';
  381.         return sprintf('%s – %s (%s → %s)', $ref, $h, $in, $out);
  382.     }
  384.     public function getUnitPrice(): ?string
  385.     {
  386.         return $this->unitPrice;
  387.     }
  389.     public function setUnitPrice(?string $unitPrice): static
  390.     {
  391.         $this->unitPrice = $unitPrice;
  393.         return $this;
  394.     }
  396.     public function getQuantity(): ?int
  397.     {
  398.         return $this->quantity;
  399.     }
  401.     public function setQuantity(?int $quantity): static
  402.     {
  403.         $this->quantity = $quantity;
  405.         return $this;
  406.     }
  408.     public function getSubtotal(): ?int
  409.     {
  410.         return $this->subtotal;
  411.     }
  413.     public function setSubtotal(?int $subtotal): static
  414.     {
  415.         $this->subtotal = $subtotal;
  417.         return $this;
  418.     }
  420.     public function getFees(): ?string
  421.     {
  422.         return $this->fees;
  423.     }
  425.     public function setFees(?string $fees): static
  426.     {
  427.         $this->fees = $fees;
  429.         return $this;
  430.     }
  432.     public function getTotal(): ?string
  433.     {
  434.         return $this->total;
  435.     }
  437.     public function setTotal(?string $total): static
  438.     {
  439.         $this->total = $total;
  441.         return $this;
  442.     }
  443. }