src/Entity/Cvs/JobPublication.php line 51

Open in your IDE?
  1. <?php
  3. namespace App\Entity\Cvs;
  5. use Doctrine\ORM\Mapping as ORM;
  7. /**
  8. * =============================================================================
  9. * JobPublication — le cycle de vie d'une offre
  10. * =============================================================================
  11. *
  12. * ⚠️ UNE TABLE À PART, ET C'EST DÉLIBÉRÉ.
  13. *
  14. * On aurait pu ajouter une colonne `expires_at` à `cvs_jobs`. Techniquement,
  15. * une colonne NULLABLE est additive : rien n'aurait cassé, ni l'app mobile,
  16. * ni Grapajobs.
  17. *
  18. * Mais tu as demandé « sans modifier », et je le prends au mot : `Jobs.php`
  19. * n'est pas touché. Zéro ligne. Ce qui rend impossible, par construction, de
  20. * casser ce qui marche.
  21. *
  22. * ⚠️ ET CETTE TABLE APPORTE CE QUE `Jobs` N'A PAS.
  23. *
  24. * `Jobs` a `createdAt` et `updatedAt`. Il n'a PAS de date de PUBLICATION.
  25. *
  26. * Ce n'est pas la même chose : une offre peut être créée en brouillon le 3
  27. * janvier, publiée le 12, modifiée le 20. `updatedAt` dit « le 20 », et
  28. * compter 90 jours à partir de là ferait vivre l'offre plus longtemps à
  29. * chaque correction de faute de frappe.
  30. *
  31. * Google, lui, veut `datePosted` — la vraie. Et `validThrough` — la vraie.
  32. *
  33. * · published_at → `datePosted`
  34. * · expires_at → `validThrough`
  35. * · renewed_at → un renouvellement est une décision, pas un effet de bord
  36. *
  37. * ⚠️ L'INDEX LE PLUS RENTABLE DE TOUT LE SCHÉMA.
  38. *
  39. * `excludeExpired` ajoute « il n'existe pas de publication expirée pour
  40. * cette offre » à CHAQUE requête publique — liste, recherche, landing,
  41. * accueil. Sans index sur (job_id, expires_at), cette sous-requête
  42. * relit la table pour chaque offre examinée.
  43. *
  44. * @ORM\Table(name="cvs_job_publication", indexes={
  45. * @ORM\Index(name="idx_pub_job_expires", columns={"job_id", "expires_at"}),
  46. * @ORM\Index(name="idx_pub_closed", columns={"closed_reason"})
  47. * })
  48. * @ORM\Entity(repositoryClass="App\Repository\Cvs\JobPublicationRepository")
  49. * =============================================================================
  50. */
  51. class JobPublication
  52. {
  53. /**
  54. * @ORM\Column(name="id", type="integer")
  55. * @ORM\Id
  56. * @ORM\GeneratedValue(strategy="IDENTITY")
  57. */
  58. private $id;
  60. /**
  61. * ⚠️ OneToOne : une offre, une publication.
  62. *
  63. * `onDelete="CASCADE"` : si l'offre disparaît, sa publication n'a plus de
  64. * sens. Une ligne orpheline ici, c'est un `validThrough` qui pointe vers
  65. * une annonce qui n'existe plus.
  66. *
  67. * @ORM\OneToOne(targetEntity="App\Entity\Cvs\Jobs")
  68. * @ORM\JoinColumn(name="job_id", referencedColumnName="id", nullable=false, onDelete="CASCADE", unique=true)
  69. */
  70. private $job;
  72. /**
  73. * La date de PUBLICATION. Pas de création, pas de modification.
  74. *
  75. * C'est `datePosted` dans le JSON-LD que lit Google.
  76. *
  77. * @ORM\Column(name="published_at", type="datetime")
  78. */
  79. private $publishedAt;
  81. /**
  82. * La date d'expiration. `validThrough` pour Google.
  83. *
  84. * ⚠️ SANS ELLE, GOOGLE FOR JOBS DÉCLASSE OU RETIRE L'ANNONCE.
  85. *
  86. * C'est le champ que Google utilise pour savoir si une offre est encore
  87. * valide. Une annonce sans `validThrough` est traitée comme suspecte —
  88. * et pour un site d'emploi, Google Jobs représente couramment un tiers à
  89. * la moitié du trafic.
  90. *
  91. * @ORM\Column(name="expires_at", type="datetime")
  92. */
  93. private $expiresAt;
  95. /**
  96. * Le dernier renouvellement. `null` si jamais renouvelée.
  97. *
  98. * @ORM\Column(name="renewed_at", type="datetime", nullable=true)
  99. */
  100. private $renewedAt;
  102. /**
  103. * Combien de fois. Un compteur, pas une opinion : il dira un jour si les
  104. * offres qu'on renouvelle sans arrêt sont celles qui ne recrutent jamais.
  105. *
  106. * @ORM\Column(name="renew_count", type="integer", options={"default": 0})
  107. */
  108. private $renewCount = 0;
  110. /**
  111. * Pourquoi elle n'est plus en ligne, si elle ne l'est plus.
  112. *
  113. * 'expired' → les 90 jours sont passés
  114. * 'filled' → le poste est pourvu (le recruteur l'a dit)
  115. * 'closed' → le recruteur l'a retirée
  116. *
  117. * ⚠️ Un poste POURVU et un poste EXPIRÉ ne se disent pas pareil au
  118. * candidat. « Cette offre a expiré » et « Ce poste a été pourvu » ne
  119. * produisent pas la même émotion — ni la même action.
  120. *
  121. * @ORM\Column(name="closed_reason", type="string", length=16, nullable=true)
  122. */
  123. private $closedReason;
  125. /**
  126. * @ORM\Column(name="created_at", type="datetime")
  127. */
  128. private $createdAt;
  130. /**
  131. * @ORM\Column(name="updated_at", type="datetime")
  132. */
  133. private $updatedAt;
  135. // =========================================================================
  137. public function getId(): ?int
  138. {
  139. return $this->id;
  140. }
  142. public function getJob(): ?Jobs
  143. {
  144. return $this->job;
  145. }
  147. public function setJob(Jobs $job): self
  148. {
  149. $this->job = $job;
  150. return $this;
  151. }
  153. public function getPublishedAt(): ?\DateTimeInterface
  154. {
  155. return $this->publishedAt;
  156. }
  158. public function setPublishedAt(\DateTimeInterface $publishedAt): self
  159. {
  160. $this->publishedAt = $publishedAt;
  161. return $this;
  162. }
  164. public function getExpiresAt(): ?\DateTimeInterface
  165. {
  166. return $this->expiresAt;
  167. }
  169. public function setExpiresAt(\DateTimeInterface $expiresAt): self
  170. {
  171. $this->expiresAt = $expiresAt;
  172. return $this;
  173. }
  175. public function getRenewedAt(): ?\DateTimeInterface
  176. {
  177. return $this->renewedAt;
  178. }
  180. public function setRenewedAt(?\DateTimeInterface $renewedAt): self
  181. {
  182. $this->renewedAt = $renewedAt;
  183. return $this;
  184. }
  186. public function getRenewCount(): int
  187. {
  188. return (int) $this->renewCount;
  189. }
  191. public function setRenewCount(int $renewCount): self
  192. {
  193. $this->renewCount = $renewCount;
  194. return $this;
  195. }
  197. public function getClosedReason(): ?string
  198. {
  199. return $this->closedReason;
  200. }
  202. public function setClosedReason(?string $closedReason): self
  203. {
  204. $this->closedReason = $closedReason;
  205. return $this;
  206. }
  208. public function getCreatedAt(): ?\DateTimeInterface
  209. {
  210. return $this->createdAt;
  211. }
  213. public function setCreatedAt(\DateTimeInterface $createdAt): self
  214. {
  215. $this->createdAt = $createdAt;
  216. return $this;
  217. }
  219. public function getUpdatedAt(): ?\DateTimeInterface
  220. {
  221. return $this->updatedAt;
  222. }
  224. public function setUpdatedAt(\DateTimeInterface $updatedAt): self
  225. {
  226. $this->updatedAt = $updatedAt;
  227. return $this;
  228. }
  230. // =========================================================================
  232. /** L'offre a-t-elle dépassé sa date ? */
  233. public function isExpired(): bool
  234. {
  235. return $this->expiresAt < new \DateTime();
  236. }
  238. /**
  239. * Combien de jours reste-t-il ?
  240. *
  241. * Négatif si l'offre est expirée — on ne renvoie pas 0. La différence
  242. * compte : « expirée depuis 40 jours » et « expirée hier » n'appellent pas
  243. * la même décision.
  244. */
  245. public function daysLeft(): int
  246. {
  247. $diff = (new \DateTime())->diff($this->expiresAt);
  248. $days = (int) $diff->days;
  250. return $diff->invert ? -$days : $days;
  251. }
  252. }