src/Entity/SharedEventCode.php line 21

  1. <?php
  3. declare(strict_types=1);
  5. namespace App\Entity;
  7. use App\Entity\User\EmailB2B;
  8. use App\Repository\SharedEventCodeRepository;
  9. use Doctrine\DBAL\Types\Types;
  10. use Doctrine\ORM\Mapping as ORM;
  11. use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
  12. use Symfony\Component\Validator\Constraints as Assert;
  13. use Symfony\Component\Validator\Context\ExecutionContextInterface;
  15. /**
  16.  * Code événement partagé : même code pour tous les participants, période de validité, tarification paramétrable.
  17.  */
  18. #[ORM\Entity(repositoryClass: SharedEventCodeRepository::class)]
  19. #[ORM\Table(name: 'app_shared_event_code')]
  20. #[UniqueEntity('code')]
  21. class SharedEventCode
  22. {
  23.     /** Fuseau métier pour les bornes début/fin (saisie BO + comparaison API). */
  24.     public const VALIDITY_TIMEZONE = 'Europe/Paris';
  26.     public const PRICING_OFFERED = 'offered';
  28.     public const PRICING_NORMAL = 'normal';
  30.     public const PRICING_SPECIAL = 'special';
  32.     public const FRAME_10X15 = '10x15';
  34.     public const FRAME_15X10 = '15x10';
  36.     #[ORM\Id]
  37.     #[ORM\GeneratedValue]
  38.     #[ORM\Column]
  39.     private ?int $id = null;
  41.     #[ORM\Column(length: 50)]
  42.     #[Assert\NotBlank]
  43.     #[Assert\Length(min: 1, max: 10)]
  44.     #[Assert\Regex(pattern: '/^[A-Za-z0-9]+$/')]
  45.     private ?string $code = null;
  47.     #[ORM\ManyToOne]
  48.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  49.     private ?EmailB2B $emailB2B = null;
  51.     /** Événement B2B « classique » (admin Code événement) — pour rattacher le code partagé au bon client / campagne. */
  52.     #[ORM\ManyToOne]
  53.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  54.     private ?CodeEvent $codeEvent = null;
  56.     #[ORM\Column(length: 255)]
  57.     #[Assert\NotBlank]
  58.     private ?string $name = null;
  60.     #[ORM\Column(length: 255)]
  61.     #[Assert\NotBlank]
  62.     private ?string $nameInApp = null;
  64.     #[ORM\Column(length: 255, nullable: true)]
  65.     private ?string $companyName = null;
  67.     #[ORM\Column(type: Types::DATETIME_MUTABLE)]
  68.     #[Assert\NotNull]
  69.     private ?\DateTimeInterface $startAt = null;
  71.     #[ORM\Column(type: Types::DATETIME_MUTABLE)]
  72.     #[Assert\NotNull]
  73.     private ?\DateTimeInterface $endAt = null;
  75.     #[ORM\Column(length: 8)]
  76.     #[Assert\Choice(choices: [self::FRAME_10X15, self::FRAME_15X10])]
  77.     private string $frameFormat = self::FRAME_10X15;
  79.     public const CAPACITY_FREE = 'free';
  81.     /**
  82.      * Capacité initiale de la pellicule créée pour ce code (nombre de photos). Si [sizeLocked] est faux,
  83.      * le participant peut ensuite l’étendre dans l’app comme une pellicule B2C (12 → 24 → 36).
  84.      */
  85.     #[ORM\Column]
  86.     #[Assert\Choice(choices: [12, 24, 36])]
  87.     private int $size = 12;
  89.     /** Capacité bloquée : l’app n’autorise ni extension ni réduction de la pellicule. */
  90.     #[ORM\Column(options: ['default' => false])]
  91.     private bool $sizeLocked = false;
  93.     #[ORM\Column(length: 255)]
  94.     private string $country = 'FR';
  96.     #[ORM\Column(length: 255)]
  97.     private string $filenameLogo = '';
  99.     #[ORM\Column(length: 255, nullable: true)]
  100.     private ?string $filenameTemplate = null;
  102.     #[ORM\Column(length: 255, nullable: true)]
  103.     private ?string $filenameTemplateVertical = null;
  105.     #[ORM\Column(length: 255, nullable: true)]
  106.     private ?string $filenameAddonPhoto = null;
  108.     #[ORM\Column(length: 20)]
  109.     #[Assert\Choice(choices: [self::PRICING_OFFERED, self::PRICING_NORMAL, self::PRICING_SPECIAL])]
  110.     private string $pricingType = self::PRICING_OFFERED;
  112.     /**
  113.      * @deprecated Préférer specialDiscountPercent. Conservé pour d’anciens codes encore en prix fixe.
  114.      */
  115.     #[ORM\Column(nullable: true)]
  116.     private ?int $specialPriceCents = null;
  118.     /** Réduction en % sur le prix direct produit (1–100) si pricingType = special */
  119.     #[ORM\Column(nullable: true)]
  120.     #[Assert\Range(min: 1, max: 100)]
  121.     private ?int $specialDiscountPercent = null;
  123.     /** Première fois qu’un participant a utilisé le code (rattachement B2B ou commande). */
  124.     #[ORM\Column(type: Types::DATETIME_IMMUTABLE, nullable: true)]
  125.     private ?\DateTimeImmutable $firstUsedAt = null;
  127.     public function getId(): ?int
  128.     {
  129.         return $this->id;
  130.     }
  132.     public function getCode(): ?string
  133.     {
  134.         return $this->code;
  135.     }
  137.     public function setCode(string $code): self
  138.     {
  139.         $this->code = strtoupper(trim($code));
  141.         return $this;
  142.     }
  144.     public function getEmailB2B(): ?EmailB2B
  145.     {
  146.         return $this->emailB2B;
  147.     }
  149.     public function setEmailB2B(?EmailB2B $emailB2B): self
  150.     {
  151.         $this->emailB2B = $emailB2B;
  153.         return $this;
  154.     }
  156.     public function getCodeEvent(): ?CodeEvent
  157.     {
  158.         return $this->codeEvent;
  159.     }
  161.     public function setCodeEvent(?CodeEvent $codeEvent): self
  162.     {
  163.         $this->codeEvent = $codeEvent;
  165.         return $this;
  166.     }
  168.     public function getName(): ?string
  169.     {
  170.         return $this->name;
  171.     }
  173.     public function setName(string $name): self
  174.     {
  175.         $this->name = $name;
  177.         return $this;
  178.     }
  180.     public function getNameInApp(): ?string
  181.     {
  182.         return $this->nameInApp;
  183.     }
  185.     public function setNameInApp(string $nameInApp): self
  186.     {
  187.         $this->nameInApp = $nameInApp;
  189.         return $this;
  190.     }
  192.     public function getCompanyName(): ?string
  193.     {
  194.         return $this->companyName;
  195.     }
  197.     public function setCompanyName(?string $companyName): self
  198.     {
  199.         $this->companyName = $companyName;
  201.         return $this;
  202.     }
  204.     public function getStartAt(): ?\DateTimeInterface
  205.     {
  206.         return $this->startAt;
  207.     }
  209.     public function setStartAt(\DateTimeInterface $startAt): self
  210.     {
  211.         $this->startAt = $startAt;
  213.         return $this;
  214.     }
  216.     public function getEndAt(): ?\DateTimeInterface
  217.     {
  218.         return $this->endAt;
  219.     }
  221.     public function setEndAt(\DateTimeInterface $endAt): self
  222.     {
  223.         $this->endAt = $endAt;
  225.         return $this;
  226.     }
  228.     public function getFrameFormat(): string
  229.     {
  230.         return $this->frameFormat;
  231.     }
  233.     public function setFrameFormat(string $frameFormat): self
  234.     {
  235.         $this->frameFormat = $frameFormat;
  237.         return $this;
  238.     }
  240.     public function getSize(): int
  241.     {
  242.         return $this->size;
  243.     }
  245.     public function setSize(int $size): self
  246.     {
  247.         $this->size = $size;
  249.         return $this;
  250.     }
  252.     public function isSizeLocked(): bool
  253.     {
  254.         return $this->sizeLocked;
  255.     }
  257.     public function setSizeLocked(bool $sizeLocked): self
  258.     {
  259.         $this->sizeLocked = $sizeLocked;
  261.         return $this;
  262.     }
  264.     /**
  265.      * Choix BO unique « 12 / 24 / 36 / Libre » : un nombre = capacité bloquée à ce palier,
  266.      * « libre » = pellicule 12 extensible par le participant.
  267.      */
  268.     public function getCapacityChoice(): string
  269.     {
  270.         return $this->sizeLocked ? (string) $this->size : self::CAPACITY_FREE;
  271.     }
  273.     public function setCapacityChoice(string $choice): self
  274.     {
  275.         if ($choice === self::CAPACITY_FREE) {
  276.             $this->size = 12;
  277.             $this->sizeLocked = false;
  278.         } else {
  279.             $this->size = (int) $choice;
  280.             $this->sizeLocked = true;
  281.         }
  283.         return $this;
  284.     }
  286.     public function getCountry(): string
  287.     {
  288.         return $this->country;
  289.     }
  291.     public function setCountry(string $country): self
  292.     {
  293.         $this->country = $country;
  295.         return $this;
  296.     }
  298.     public function getFilenameLogo(): string
  299.     {
  300.         return $this->filenameLogo;
  301.     }
  303.     public function setFilenameLogo(string $filenameLogo): self
  304.     {
  305.         $this->filenameLogo = $filenameLogo;
  307.         return $this;
  308.     }
  310.     public function getFilenameTemplate(): ?string
  311.     {
  312.         return $this->filenameTemplate;
  313.     }
  315.     public function setFilenameTemplate(?string $filenameTemplate): self
  316.     {
  317.         $this->filenameTemplate = $filenameTemplate;
  319.         return $this;
  320.     }
  322.     public function getFilenameTemplateVertical(): ?string
  323.     {
  324.         return $this->filenameTemplateVertical;
  325.     }
  327.     public function setFilenameTemplateVertical(?string $filenameTemplateVertical): self
  328.     {
  329.         $this->filenameTemplateVertical = $filenameTemplateVertical;
  331.         return $this;
  332.     }
  334.     public function getFilenameAddonPhoto(): ?string
  335.     {
  336.         return $this->filenameAddonPhoto;
  337.     }
  339.     public function setFilenameAddonPhoto(?string $filenameAddonPhoto): self
  340.     {
  341.         $this->filenameAddonPhoto = $filenameAddonPhoto;
  343.         return $this;
  344.     }
  346.     public function getPricingType(): string
  347.     {
  348.         return $this->pricingType;
  349.     }
  351.     public function setPricingType(string $pricingType): self
  352.     {
  353.         $this->pricingType = $pricingType;
  355.         return $this;
  356.     }
  358.     public function getSpecialPriceCents(): ?int
  359.     {
  360.         return $this->specialPriceCents;
  361.     }
  363.     public function setSpecialPriceCents(?int $specialPriceCents): self
  364.     {
  365.         $this->specialPriceCents = $specialPriceCents;
  367.         return $this;
  368.     }
  370.     public function getSpecialDiscountPercent(): ?int
  371.     {
  372.         return $this->specialDiscountPercent;
  373.     }
  375.     public function setSpecialDiscountPercent(?int $specialDiscountPercent): self
  376.     {
  377.         $this->specialDiscountPercent = $specialDiscountPercent;
  379.         return $this;
  380.     }
  382.     /**
  383.      * Les dates en base (DATETIME) et le formulaire admin sont interprétées comme heure locale France.
  384.      * Compare à l’instant courant dans ce même fuseau, pour éviter les décalages si PHP/serveur est en UTC.
  385.      */
  386.     public function isValidAt(?\DateTimeInterface $now = null): bool
  387.     {
  388.         $start = $this->startAt;
  389.         $end = $this->endAt;
  390.         if ($start === null || $end === null) {
  391.             return false;
  392.         }
  394.         $tz = new \DateTimeZone(self::VALIDITY_TIMEZONE);
  395.         $startParis = new \DateTimeImmutable($start->format('Y-m-d H:i:s'), $tz);
  396.         $endParis = new \DateTimeImmutable($end->format('Y-m-d H:i:s'), $tz);
  397.         $nowParis = $now === null
  398.             ? new \DateTimeImmutable('now', $tz)
  399.             : \DateTimeImmutable::createFromInterface($now)->setTimezone($tz);
  401.         return $startParis <= $nowParis && $nowParis <= $endParis;
  402.     }
  404.     public function getFirstUsedAt(): ?\DateTimeImmutable
  405.     {
  406.         return $this->firstUsedAt;
  407.     }
  409.     public function setFirstUsedAt(?\DateTimeImmutable $firstUsedAt): self
  410.     {
  411.         $this->firstUsedAt = $firstUsedAt;
  413.         return $this;
  414.     }
  416.     /** Enregistre la première utilisation (idempotent). */
  417.     public function markFirstUseIfUnset(): void
  418.     {
  419.         if ($this->firstUsedAt !== null) {
  420.             return;
  421.         }
  422.         $this->firstUsedAt = new \DateTimeImmutable();
  423.     }
  425.     public function isUsed(): bool
  426.     {
  427.         return $this->firstUsedAt !== null;
  428.     }
  430.     #[Assert\Callback]
  431.     public function validateSpecialPricing(ExecutionContextInterface $context): void
  432.     {
  433.         if (self::PRICING_SPECIAL !== $this->pricingType) {
  434.             return;
  435.         }
  437.         $okPercent = $this->specialDiscountPercent !== null
  438.             && $this->specialDiscountPercent >= 1
  439.             && $this->specialDiscountPercent <= 100;
  440.         $okLegacy = $this->specialPriceCents !== null && $this->specialPriceCents > 0;
  442.         if (!$okPercent && !$okLegacy) {
  443.             $context->buildViolation('Pour le tarif spécial, renseignez une réduction entre 1 et 100 %.')
  444.                 ->atPath('specialDiscountPercent')
  445.                 ->addViolation();
  446.         }
  447.     }
  448. }