src/Entity/SubjectChapter.php line 26

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\SubjectChapterRepository;
  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 LOCAL d'une matière dans un établissement.
  13.  *
  14.  * Créé automatiquement par copie du programme national (Chapter) lors
  15.  * de l'affectation d'un Subject à un SubjectReference, ou manuellement
  16.  * par l'admin/éditeur de l'école.
  17.  *
  18.  * Chaque école possède sa propre copie, modifiable indépendamment du
  19.  * programme national. `sourceChapter` garde la traçabilité de l'origine
  20.  * nationale (nullable : null si chapitre 100 % personnalisé).
  21.  *
  22.  * ChapterProgress pointe désormais ici (et non plus sur Chapter).
  23.  */
  24. #[ORM\HasLifecycleCallbacks]
  25. #[ORM\Entity(repositoryClass: SubjectChapterRepository::class)]
  26. class SubjectChapter
  27. {
  28.     use Timestampable;
  30.     #[ORM\Id]
  31.     #[ORM\GeneratedValue]
  32.     #[ORM\Column]
  33.     private ?int $id = null;
  35.     #[ORM\Column(length: 255)]
  36.     private ?string $title = null;
  38.     #[ORM\Column(length: 255, nullable: true)]
  39.     private ?string $titleEn = null;
  41.     #[ORM\Column(type: 'text', nullable: true)]
  42.     private ?string $description = null;
  44.     /**
  45.      * Ordre du chapitre dans la progression locale (1, 2, 3...).
  46.      * L'admin peut réordonner librement via drag & drop.
  47.      */
  48.     #[ORM\Column]
  49.     private ?int $position = null;
  51.     /**
  52.      * La matière réelle (école + classe + année) à laquelle ce chapitre appartient.
  53.      */
  54.     #[ORM\ManyToOne(inversedBy: 'subjectChapters')]
  55.     #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
  56.     private ?Subject $subject = null;
  58.     /**
  59.      * Chapitre national d'origine.
  60.      * NULL si le chapitre a été créé manuellement par l'admin (hors programme national).
  61.      * Permet au superadmin de tracer la couverture nationale via cette FK.
  62.      */
  63.     #[ORM\ManyToOne]
  64.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  65.     private ?Chapter $sourceChapter = null;
  67.     /**
  68.      * Séquence avant la fin de laquelle ce chapitre doit être terminé.
  69.      */
  70.     #[ORM\ManyToOne]
  71.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  72.     private ?Quarter $deadlineQuarter = null;
  74.     /**
  75.      * Date calendaire optionnelle de deadline (alternative à deadlineQuarter).
  76.      */
  77.     #[ORM\Column(type: 'date', nullable: true)]
  78.     private ?\DateTimeInterface $deadlineDate = null;
  80.     /**
  81.      * 1 SubjectChapter → au plus 1 ChapterProgress (même Subject fixé).
  82.      */
  83.     #[ORM\OneToMany(
  84.         mappedBy: 'subjectChapter',
  85.         targetEntity: ChapterProgress::class,
  86.         cascade: ['persist', 'remove'],
  87.         orphanRemoval: true
  88.     )]
  89.     private Collection $progresses;
  91.     #[ORM\ManyToOne]
  92.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  93.     private ?User $author = null;
  95.     public function __construct()
  96.     {
  97.         $this->progresses = new ArrayCollection();
  98.     }
  100.     public function __toString(): string
  101.     {
  102.         return $this->title ?? '';
  103.     }
  105.     public function getId(): ?int
  106.     {
  107.         return $this->id;
  108.     }
  110.     public function getTitle(): ?string
  111.     {
  112.         return $this->title;
  113.     }
  115.     public function setTitle(string $title): static
  116.     {
  117.         $this->title = $title;
  118.         return $this;
  119.     }
  121.     public function getTitleEn(): ?string
  122.     {
  123.         return $this->titleEn;
  124.     }
  126.     public function setTitleEn(?string $titleEn): static
  127.     {
  128.         $this->titleEn = $titleEn;
  129.         return $this;
  130.     }
  132.     public function getDescription(): ?string
  133.     {
  134.         return $this->description;
  135.     }
  137.     public function setDescription(?string $description): static
  138.     {
  139.         $this->description = $description;
  140.         return $this;
  141.     }
  143.     public function getPosition(): ?int
  144.     {
  145.         return $this->position;
  146.     }
  148.     public function setPosition(int $position): static
  149.     {
  150.         $this->position = $position;
  151.         return $this;
  152.     }
  154.     public function getSubject(): ?Subject
  155.     {
  156.         return $this->subject;
  157.     }
  159.     public function setSubject(?Subject $subject): static
  160.     {
  161.         $this->subject = $subject;
  162.         return $this;
  163.     }
  165.     public function getSourceChapter(): ?Chapter
  166.     {
  167.         return $this->sourceChapter;
  168.     }
  170.     public function setSourceChapter(?Chapter $sourceChapter): static
  171.     {
  172.         $this->sourceChapter = $sourceChapter;
  173.         return $this;
  174.     }
  176.     public function getDeadlineQuarter(): ?Quarter
  177.     {
  178.         return $this->deadlineQuarter;
  179.     }
  181.     public function setDeadlineQuarter(?Quarter $deadlineQuarter): static
  182.     {
  183.         $this->deadlineQuarter = $deadlineQuarter;
  184.         return $this;
  185.     }
  187.     public function getDeadlineDate(): ?\DateTimeInterface
  188.     {
  189.         return $this->deadlineDate;
  190.     }
  192.     public function setDeadlineDate(?\DateTimeInterface $deadlineDate): static
  193.     {
  194.         $this->deadlineDate = $deadlineDate;
  195.         return $this;
  196.     }
  198.     /** @return Collection<int, ChapterProgress> */
  199.     public function getProgresses(): Collection
  200.     {
  201.         return $this->progresses;
  202.     }
  204.     public function addProgress(ChapterProgress $progress): static
  205.     {
  206.         if (!$this->progresses->contains($progress)) {
  207.             $this->progresses->add($progress);
  208.             $progress->setSubjectChapter($this);
  209.         }
  210.         return $this;
  211.     }
  213.     public function removeProgress(ChapterProgress $progress): static
  214.     {
  215.         if ($this->progresses->removeElement($progress)) {
  216.             if ($progress->getSubjectChapter() === $this) {
  217.                 $progress->setSubjectChapter(null);
  218.             }
  219.         }
  220.         return $this;
  221.     }
  223.     public function getAuthor(): ?User
  224.     {
  225.         return $this->author;
  226.     }
  228.     public function setAuthor(?User $author): static
  229.     {
  230.         $this->author = $author;
  231.         return $this;
  232.     }
  234.     /**
  235.      * true = chapitre 100 % custom (hors programme national).
  236.      * false = chapitre copié depuis le programme national.
  237.      */
  238.     public function isCustom(): bool
  239.     {
  240.         return $this->sourceChapter === null;
  241.     }
  242. }