src/Entity/Cvs/SearchStats.php line 25

Open in your IDE?
  1. <?php
  3. namespace App\Entity\Cvs;
  5. use Doctrine\DBAL\Types\Types;
  6. use Doctrine\ORM\Mapping as ORM;
  8. /**
  9.  * Statistiques de recherche : 1 ligne par combinaison unique
  10.  * (normalizedQuery, cityKeyword, locale) sur une fenêtre glissante de 24h.
  11.  *
  12.  * Lorsqu'une recherche est faite :
  13.  *   - Si une ligne existe pour cette combinaison ET lastSeenAt est dans les 24h
  14.  *     → on incrémente views et on met à jour lastSeenAt
  15.  *   - Sinon (pas de ligne OU dernière > 24h) → nouvelle ligne avec views=1
  16.  *
  17.  * @ORM\Table("cvs_searchstats", indexes={
  18.  *   @ORM\Index(name="idx_searchstats_combo", columns={"normalized_query", "city_keyword", "locale"}),
  19.  *   @ORM\Index(name="idx_searchstats_lastseen", columns={"last_seen_at"}),
  20.  *   @ORM\Index(name="idx_searchstats_views", columns={"views"})
  21.  * })
  22.  * @ORM\Entity(repositoryClass="App\Repository\Cvs\SearchStatsRepository")
  23.  * @ORM\HasLifecycleCallbacks()
  24.  */
  25. class SearchStats
  26. {
  27.     /**
  28.      * @ORM\Column(name="id", type="integer")
  29.      * @ORM\Id
  30.      * @ORM\GeneratedValue(strategy="AUTO")
  31.      */
  32.     protected $id;
  34.     /**
  35.      * Texte de la recherche (tel que tapé/envoyé par l'utilisateur).
  36.      *
  37.      * @ORM\Column(name="query", type="string", length=255, nullable=true)
  38.      */
  39.     protected $query;
  41.     /**
  42.      * Version normalisée de la recherche (lowercase + trim + slugify partiel)
  43.      * utilisée pour le matching (évite les doublons "Paris" / "paris" / " Paris ").
  44.      *
  45.      * @ORM\Column(name="normalized_query", type="string", length=255, nullable=true)
  46.      */
  47.     protected $normalizedQuery;
  49.     /**
  50.      * Si la recherche a été faite depuis une page ville (ex: /jobs/paris),
  51.      * stocke le keyword ville (label de JobsFilters). NULL si pas de contexte ville.
  52.      *
  53.      * @ORM\Column(name="city_keyword", type="string", length=255, nullable=true)
  54.      */
  55.     protected $cityKeyword;
  57.     /**
  58.      * Langue (fr, en).
  59.      *
  60.      * @ORM\Column(name="locale", type="string", length=2, nullable=true)
  61.      */
  62.     protected $locale;
  64.     /**
  65.      * Source de la recherche : 'submit' | 'landing_city' | 'landing_keyword'.
  66.      *
  67.      * @ORM\Column(name="source", type="string", length=32, nullable=true)
  68.      */
  69.     protected $source;
  71.     /**
  72.      * Compteur d'occurrences pour cette combinaison dans la fenêtre 24h.
  73.      *
  74.      * @ORM\Column(name="views", type="integer", options={"default":1})
  75.      */
  76.     protected $views = 1;
  78.     /**
  79.      * Date de la 1ère vue dans la fenêtre courante.
  80.      *
  81.      * @ORM\Column(name="first_seen_at", type="datetime", nullable=true)
  82.      */
  83.     protected $firstSeenAt;
  85.     /**
  86.      * Date de la dernière vue (utilisée pour le check "dans les 24h").
  87.      *
  88.      * @ORM\Column(name="last_seen_at", type="datetime", nullable=true)
  89.      */
  90.     protected $lastSeenAt;
  92.     public function getId(): ?int { return $this->id; }
  94.     public function getQuery(): ?string { return $this->query; }
  95.     public function setQuery(?string $query): self { $this->query = $query; return $this; }
  97.     public function getNormalizedQuery(): ?string { return $this->normalizedQuery; }
  98.     public function setNormalizedQuery(?string $q): self { $this->normalizedQuery = $q; return $this; }
  100.     public function getCityKeyword(): ?string { return $this->cityKeyword; }
  101.     public function setCityKeyword(?string $c): self { $this->cityKeyword = $c; return $this; }
  103.     public function getLocale(): ?string { return $this->locale; }
  104.     public function setLocale(?string $l): self { $this->locale = $l; return $this; }
  106.     public function getSource(): ?string { return $this->source; }
  107.     public function setSource(?string $s): self { $this->source = $s; return $this; }
  109.     public function getViews(): int { return $this->views ?? 0; }
  110.     public function setViews(int $v): self { $this->views = $v; return $this; }
  111.     public function incrementViews(): self { $this->views = ($this->views ?? 0) + 1; return $this; }
  113.     public function getFirstSeenAt(): ?\DateTime { return $this->firstSeenAt; }
  114.     public function setFirstSeenAt(?\DateTime $d): self { $this->firstSeenAt = $d; return $this; }
  116.     public function getLastSeenAt(): ?\DateTime { return $this->lastSeenAt; }
  117.     public function setLastSeenAt(?\DateTime $d): self { $this->lastSeenAt = $d; return $this; }
  118. }