src/Entity/Chapter.php line 24

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\ChapterRepository;
  6. use Doctrine\Common\Collections\ArrayCollection;
  7. use Doctrine\Common\Collections\Collection;
  8. use Doctrine\ORM\Mapping as ORM;
  9. use App\Entity\Traits\Timestampable;
  11. /**
  12.  * Chapitre du programme national (créé par le superadmin).
  13.  *
  14.  * Rattaché à un SubjectReference (= matière + ClassOption).
  15.  * `position` définit l'ordre d'apparition dans le programme.
  16.  * `deadlineQuarter` indique la séquence avant la fin de laquelle le
  17.  * chapitre doit être terminé (ex : "avant la fin de la Séquence 2").
  18.  *
  19.  * La date réelle de la deadline se calcule via deadlineQuarter->getEndDate()
  20.  * si ce champ existe sur Quarter, sinon on affiche juste le nom de la séquence.
  21.  */
  22. #[ORM\HasLifecycleCallbacks]
  23. #[ORM\Entity(repositoryClass: ChapterRepository::class)]
  24. class Chapter
  25. {
  26.     use Timestampable;
  28.     #[ORM\Id]
  29.     #[ORM\GeneratedValue]
  30.     #[ORM\Column]
  31.     private ?int $id = null;
  33.     #[ORM\Column(length: 255)]
  34.     private ?string $title = null;
  36.     #[ORM\Column(length: 255, nullable: true)]
  37.     private ?string $titleEn = null;
  39.     #[ORM\Column(type: 'text', nullable: true)]
  40.     private ?string $description = null;
  42.     /**
  43.      * Ordre du chapitre dans le programme (1, 2, 3...).
  44.      */
  45.     #[ORM\Column]
  46.     private ?int $position = null;
  48.     #[ORM\ManyToOne(inversedBy: 'chapters')]
  49.     #[ORM\JoinColumn(nullable: false)]
  50.     private ?SubjectReference $subjectReference = null;
  52.     /**
  53.      * Séquence avant la fin de laquelle ce chapitre doit être terminé.
  54.      * Nullable : un chapitre peut ne pas avoir de deadline imposée.
  55.      */
  56.     #[ORM\ManyToOne]
  57.     private ?Quarter $deadlineQuarter = null;
  59.     /**
  60.      * Date calendaire optionnelle, en complément ou alternative à deadlineQuarter.
  61.      * Permet une deadline fixe (ex: 15/11/2025) si le superadmin préfère.
  62.      */
  63.     #[ORM\Column(type: 'date', nullable: true)]
  64.     private ?\DateTimeInterface $deadlineDate = null;
  66.     #[ORM\OneToMany(mappedBy: 'chapter', targetEntity: ChapterProgress::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  67.     private Collection $progresses;
  69.     #[ORM\ManyToOne]
  70.     private ?User $author = null;
  72.     public function __construct()
  73.     {
  74.         $this->progresses = new ArrayCollection();
  75.     }
  77.     public function __toString(): string
  78.     {
  79.         return $this->title;
  80.     }
  82.     public function getId(): ?int
  83.     {
  84.         return $this->id;
  85.     }
  87.     public function getTitle(): ?string
  88.     {
  89.         return $this->title;
  90.     }
  92.     public function setTitle(string $title): static
  93.     {
  94.         $this->title = $title;
  96.         return $this;
  97.     }
  99.     public function getTitleEn(): ?string
  100.     {
  101.         return $this->titleEn;
  102.     }
  104.     public function setTitleEn(?string $titleEn): static
  105.     {
  106.         $this->titleEn = $titleEn;
  108.         return $this;
  109.     }
  111.     public function getDescription(): ?string
  112.     {
  113.         return $this->description;
  114.     }
  116.     public function setDescription(?string $description): static
  117.     {
  118.         $this->description = $description;
  120.         return $this;
  121.     }
  123.     public function getPosition(): ?int
  124.     {
  125.         return $this->position;
  126.     }
  128.     public function setPosition(int $position): static
  129.     {
  130.         $this->position = $position;
  132.         return $this;
  133.     }
  135.     public function getSubjectReference(): ?SubjectReference
  136.     {
  137.         return $this->subjectReference;
  138.     }
  140.     public function setSubjectReference(?SubjectReference $subjectReference): static
  141.     {
  142.         $this->subjectReference = $subjectReference;
  144.         return $this;
  145.     }
  147.     public function getDeadlineQuarter(): ?Quarter
  148.     {
  149.         return $this->deadlineQuarter;
  150.     }
  152.     public function setDeadlineQuarter(?Quarter $deadlineQuarter): static
  153.     {
  154.         $this->deadlineQuarter = $deadlineQuarter;
  156.         return $this;
  157.     }
  159.     public function getDeadlineDate(): ?\DateTimeInterface
  160.     {
  161.         return $this->deadlineDate;
  162.     }
  164.     public function setDeadlineDate(?\DateTimeInterface $deadlineDate): static
  165.     {
  166.         $this->deadlineDate = $deadlineDate;
  168.         return $this;
  169.     }
  171.     /**
  172.      * @return Collection<int, ChapterProgress>
  173.      */
  174.     public function getProgresses(): Collection
  175.     {
  176.         return $this->progresses;
  177.     }
  179.     public function addProgress(ChapterProgress $progress): static
  180.     {
  181.         if (!$this->progresses->contains($progress)) {
  182.             $this->progresses->add($progress);
  183.             $progress->setChapter($this);
  184.         }
  186.         return $this;
  187.     }
  189.     public function removeProgress(ChapterProgress $progress): static
  190.     {
  191.         if ($this->progresses->removeElement($progress)) {
  192.             if ($progress->getChapter() === $this) {
  193.                 $progress->setChapter(null);
  194.             }
  195.         }
  197.         return $this;
  198.     }
  200.     public function getAuthor(): ?User
  201.     {
  202.         return $this->author;
  203.     }
  205.     public function setAuthor(?User $author): static
  206.     {
  207.         $this->author = $author;
  209.         return $this;
  210.     }
  211. }