src/Entity/ContratCadre.php line 16

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\ContratCadreRepository;
  6. use Doctrine\Common\Collections\ArrayCollection;
  7. use Doctrine\Common\Collections\Collection;
  8. use Doctrine\ORM\Mapping as ORM;
  9. use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
  10. use Symfony\Component\Validator\Constraints as Assert;
  12. #[ORM\Entity(repositoryClass: ContratCadreRepository::class)]
  13. #[ORM\Table(name: 'contrat_cadre')]
  14. #[ORM\HasLifecycleCallbacks]
  15. #[UniqueEntity(fields: ['reference'], message: 'Cette référence existe déjà.')]
  16. class ContratCadre
  17. {
  18. const STATUT_ACTIF = 'actif';
  19. const STATUT_EXPIRE = 'expire';
  20. const STATUT_EPUISE = 'epuise';
  21. const STATUT_INACTIF = 'inactif';
  23. const SEUIL_ALERTE_PLAFOND = 0.80; // 80% consommé → alerte
  24. const SEUIL_ALERTE_EXPIRATION = 30; // 30 jours avant fin → alerte
  26. #[ORM\Id]
  27. #[ORM\GeneratedValue]
  28. #[ORM\Column]
  29. private ?int $id = null;
  31. #[ORM\Column(length: 50, unique: true)]
  32. #[Assert\NotBlank(message: 'La référence est obligatoire.')]
  33. #[Assert\Regex(pattern: '/^[A-Z0-9\-]+$/', message: 'Lettres majuscules, chiffres et tirets uniquement.')]
  34. private ?string $reference = null;
  36. #[ORM\Column(length: 255)]
  37. #[Assert\NotBlank(message: "L'intitulé est obligatoire.")]
  38. private ?string $intitule = null;
  40. #[ORM\Column(type: 'decimal', precision: 15, scale: 2, options: ['default' => '0.00'])]
  41. private string $montantReserve = '0.00';
  42. /**
  43. * Fournisseur — on filtre statut=actif dans le formulaire.
  44. * Label affiché : getRaisonSociale()
  45. */
  46. #[ORM\ManyToOne(targetEntity: Fournisseur::class)]
  47. #[ORM\JoinColumn(nullable: false)]
  48. #[Assert\NotNull(message: 'Le fournisseur est obligatoire.')]
  49. private ?Fournisseur $fournisseur = null;
  51. /**
  52. * CategorieMarche — votre entité "catégorie" dans cet ERP.
  53. * Label affiché : getLibelle()
  54. */
  55. #[ORM\ManyToOne(targetEntity: CategorieMarche::class)]
  56. #[ORM\JoinColumn(nullable: false)]
  57. #[Assert\NotNull(message: 'La catégorie de marché est obligatoire.')]
  58. private ?CategorieMarche $categorieMarche = null;
  60. #[ORM\Column(type: 'decimal', precision: 15, scale: 2)]
  61. #[Assert\NotBlank]
  62. #[Assert\Positive(message: 'Le montant plafond doit être positif.')]
  63. private ?string $montantPlafond = null;
  65. #[ORM\Column(type: 'decimal', precision: 15, scale: 2, options: ['default' => '0.00'])]
  66. private string $montantConsomme = '0.00';
  68. #[ORM\Column(type: 'date')]
  69. #[Assert\NotNull(message: 'La date de début est obligatoire.')]
  70. private ?\DateTimeInterface $dateDebut = null;
  72. #[ORM\Column(type: 'date')]
  73. #[Assert\NotNull(message: 'La date de fin est obligatoire.')]
  74. private ?\DateTimeInterface $dateFin = null;
  76. #[ORM\Column(type: 'smallint')]
  77. #[Assert\NotNull]
  78. #[Assert\Range(min: 1, max: 10, notInRangeMessage: 'La priorité doit être entre 1 et 10.')]
  79. private ?int $niveauPriorite = 5;
  81. #[ORM\Column(options: ['default' => true])]
  82. private bool $actif = true;
  84. #[ORM\Column(type: 'text', nullable: true)]
  85. private ?string $description = null;
  87. #[ORM\Column(type: 'datetime')]
  88. private ?\DateTimeInterface $createdAt = null;
  90. #[ORM\Column(type: 'datetime')]
  91. private ?\DateTimeInterface $updatedAt = null;
  93. #[ORM\OneToMany(mappedBy: 'contratCadre', targetEntity: CommandeAchat::class)]
  94. private Collection $bonsDeCommande;
  96. public function __construct()
  97. {
  98. $this->bonsDeCommande = new ArrayCollection();
  99. }
  101. // ─── Lifecycle callbacks ──────────────────────────────────────────────────
  103. #[ORM\PrePersist]
  104. public function onPrePersist(): void
  105. {
  106. $this->createdAt = new \DateTime();
  107. $this->updatedAt = new \DateTime();
  108. }
  110. #[ORM\PreUpdate]
  111. public function onPreUpdate(): void
  112. {
  113. $this->updatedAt = new \DateTime();
  114. }
  116. // ─── Propriétés calculées ─────────────────────────────────────────────────
  118. public function getMontantRestant(): float
  119. {
  120. return (float) $this->montantPlafond - (float) $this->montantConsomme;
  121. }
  122. public function getMontantDisponible(): float
  123. {
  124. return
  125. (float)$this->montantPlafond
  126. - (float)$this->montantConsomme
  127. - (float)$this->montantReserve;
  128. }
  129. public function consommerMontant(float $montant): void
  130. {
  131. $this->montantReserve =
  132. max(0, (float)$this->montantReserve - $montant);
  134. $this->montantConsomme =
  135. (float)$this->montantConsomme + $montant;
  136. }
  137. public function reserverMontant(float $montant): void
  138. {
  139. $this->montantReserve =
  140. (float)$this->montantReserve + $montant;
  141. }
  142. public function libererReservation(float $montant): void
  143. {
  144. $this->montantReserve =
  145. max(0, (float)$this->montantReserve - $montant);
  146. }
  148. public function getTauxConsommation(): float
  149. {
  150. if ((float) $this->montantPlafond <= 0) {
  151. return 0;
  152. }
  153. return ((float) $this->montantConsomme / (float) $this->montantPlafond) * 100;
  154. }
  156. public function getJoursRestants(): int
  157. {
  158. if (!$this->dateFin) {
  159. return 0;
  160. }
  161. $diff = (new \DateTime())->diff($this->dateFin);
  162. return $diff->invert ? 0 : (int) $diff->days;
  163. }
  165. public function getStatut(): string
  166. {
  167. if (!$this->actif) {
  168. return self::STATUT_INACTIF;
  169. }
  170. if ($this->dateFin < new \DateTime()) {
  171. return self::STATUT_EXPIRE;
  172. }
  173. if ((float) $this->montantConsomme >= (float) $this->montantPlafond) {
  174. return self::STATUT_EPUISE;
  175. }
  176. return self::STATUT_ACTIF;
  177. }
  179. /*public function isDisponible(float $montantDemande = 0): bool
  180. {
  181. return $this->getStatut() === self::STATUT_ACTIF
  182. && $this->getMontantRestant() >= $montantDemande;
  183. }*/
  184. public function isDisponible(float $montantDemande = 0): bool
  185. {
  186. return $this->getStatut() === self::STATUT_ACTIF
  187. && $this->getMontantDisponible() >= $montantDemande;
  188. }
  190. public function isEnAlerteExpiration(): bool
  191. {
  192. return $this->getStatut() === self::STATUT_ACTIF
  193. && $this->getJoursRestants() <= self::SEUIL_ALERTE_EXPIRATION;
  194. }
  196. public function isEnAlertePlafond(): bool
  197. {
  198. return $this->getTauxConsommation() >= (self::SEUIL_ALERTE_PLAFOND * 100);
  199. }
  201. // ─── Getters / Setters ────────────────────────────────────────────────────
  203. public function getId(): ?int { return $this->id; }
  205. public function getReference(): ?string { return $this->reference; }
  206. public function setReference(string $reference): self
  207. {
  208. $this->reference = strtoupper($reference);
  209. return $this;
  210. }
  212. public function getIntitule(): ?string { return $this->intitule; }
  213. public function setIntitule(string $intitule): self { $this->intitule = $intitule; return $this; }
  215. public function getFournisseur(): ?Fournisseur { return $this->fournisseur; }
  216. public function setFournisseur(?Fournisseur $fournisseur): self { $this->fournisseur = $fournisseur; return $this; }
  218. public function getCategorieMarche(): ?CategorieMarche { return $this->categorieMarche; }
  219. public function setCategorieMarche(?CategorieMarche $categorieMarche): self { $this->categorieMarche = $categorieMarche; return $this; }
  221. public function getMontantPlafond(): ?string { return $this->montantPlafond; }
  222. public function setMontantPlafond(string $montantPlafond): self { $this->montantPlafond = $montantPlafond; return $this; }
  224. public function getMontantConsomme(): string { return $this->montantConsomme; }
  225. public function setMontantConsomme(string $montantConsomme): self { $this->montantConsomme = $montantConsomme; return $this; }
  227. public function getDateDebut(): ?\DateTimeInterface { return $this->dateDebut; }
  228. public function setDateDebut(?\DateTimeInterface $dateDebut): self { $this->dateDebut = $dateDebut; return $this; }
  230. public function getDateFin(): ?\DateTimeInterface { return $this->dateFin; }
  231. public function setDateFin(?\DateTimeInterface $dateFin): self { $this->dateFin = $dateFin; return $this; }
  233. public function getNiveauPriorite(): ?int { return $this->niveauPriorite; }
  234. public function setNiveauPriorite(int $niveauPriorite): self { $this->niveauPriorite = $niveauPriorite; return $this; }
  236. public function isActif(): bool { return $this->actif; }
  237. public function setActif(bool $actif): self { $this->actif = $actif; return $this; }
  239. public function getDescription(): ?string { return $this->description; }
  240. public function setDescription(?string $description): self { $this->description = $description; return $this; }
  242. public function getCreatedAt(): ?\DateTimeInterface { return $this->createdAt; }
  243. public function getUpdatedAt(): ?\DateTimeInterface { return $this->updatedAt; }
  245. public function getBonsDeCommande(): Collection { return $this->bonsDeCommande; }
  246. public function getMontantReserve(): string{ return $this->montantReserve;}
  248. public function setMontantReserve(string $montantReserve): self{$this->montantReserve = $montantReserve;return $this;}
  251. public function __toString(): string
  252. {
  253. return $this->reference . ' – ' . $this->intitule;
  254. }
  255. }