src/Entity/SubjectLesson.php line 26

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\SubjectLessonRepository;
  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.  * Leçon LOCAL d'une matière dans un établissement.
  13.  *
  14.  * Créé automatiquement par copie du programme national (Lesson) 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. `sourceLesson` garde la traçabilité de l'origine
  20.  * nationale (nullable : null si leçon 100 % personnalisé).
  21.  *
  22.  * LessonProgress pointe désormais ici (et non plus sur Lesson).
  23.  */
  24. #[ORM\HasLifecycleCallbacks]
  25. #[ORM\Entity(repositoryClass: SubjectLessonRepository::class)]
  26. class SubjectLesson
  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 de la leçon 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 cette leçon appartient.
  53.      */
  54.     #[ORM\ManyToOne(inversedBy: 'subjectLessons')]
  55.     #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
  56.     private ?Subject $subject = null;
  58.     /**
  59.      * Leçon national d'origine.
  60.      * NULL si la leçon a été créée 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 ?Lesson $sourceLesson = null;
  67.     /**
  68.      * Séquence avant la fin de laquelle cette leçon doit être terminée.
  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.      * Nature de la leçon : Théorique (LT), Digitalisée (LD) ou Pratique (LP).
  82.      * Copiée depuis sourceLesson::nature comme valeur par défaut à la
  83.      * création (voir SubjectLessonCopier) — c'est ce champ que le prof
  84.      * coche/décoche dans le cahier de texte, modifiable indépendamment
  85.      * du national ensuite.
  86.      */
  87.     #[ORM\Column(length: 2, nullable: true)]
  88.     private ?string $nature = null;
  90.     /**
  91.      * Durée de référence en heures, copiée depuis sourceLesson::duration
  92.      * à la création puis modifiable indépendamment par l'école.
  93.      */
  94.     #[ORM\Column(nullable: true)]
  95.     private ?float $duration = null;
  97.     /**
  98.      * 1 SubjectLesson → au plus 1 LessonProgress (même Subject fixé).
  99.      */
  100.     #[ORM\OneToMany(
  101.         mappedBy: 'subjectLesson',
  102.         targetEntity: LessonProgress::class,
  103.         cascade: ['persist', 'remove'],
  104.         orphanRemoval: true
  105.     )]
  106.     private Collection $progresses;
  108.     #[ORM\ManyToOne]
  109.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  110.     private ?User $author = null;
  112.     public function __construct()
  113.     {
  114.         $this->progresses = new ArrayCollection();
  115.     }
  117.     public function __toString(): string
  118.     {
  119.         return $this->title ?? '';
  120.     }
  122.     public function getId(): ?int
  123.     {
  124.         return $this->id;
  125.     }
  127.     public function getTitle(): ?string
  128.     {
  129.         return $this->title;
  130.     }
  132.     public function setTitle(string $title): static
  133.     {
  134.         $this->title = $title;
  135.         return $this;
  136.     }
  138.     public function getTitleEn(): ?string
  139.     {
  140.         return $this->titleEn;
  141.     }
  143.     public function setTitleEn(?string $titleEn): static
  144.     {
  145.         $this->titleEn = $titleEn;
  146.         return $this;
  147.     }
  149.     public function getDescription(): ?string
  150.     {
  151.         return $this->description;
  152.     }
  154.     public function setDescription(?string $description): static
  155.     {
  156.         $this->description = $description;
  157.         return $this;
  158.     }
  160.     public function getPosition(): ?int
  161.     {
  162.         return $this->position;
  163.     }
  165.     public function setPosition(int $position): static
  166.     {
  167.         $this->position = $position;
  168.         return $this;
  169.     }
  171.     public function getSubject(): ?Subject
  172.     {
  173.         return $this->subject;
  174.     }
  176.     public function setSubject(?Subject $subject): static
  177.     {
  178.         $this->subject = $subject;
  179.         return $this;
  180.     }
  182.     public function getSourceLesson(): ?Lesson
  183.     {
  184.         return $this->sourceLesson;
  185.     }
  187.     public function setSourceLesson(?Lesson $sourceLesson): static
  188.     {
  189.         $this->sourceLesson = $sourceLesson;
  190.         return $this;
  191.     }
  193.     public function getDeadlineQuarter(): ?Quarter
  194.     {
  195.         return $this->deadlineQuarter;
  196.     }
  198.     public function setDeadlineQuarter(?Quarter $deadlineQuarter): static
  199.     {
  200.         $this->deadlineQuarter = $deadlineQuarter;
  201.         return $this;
  202.     }
  204.     public function getDeadlineDate(): ?\DateTimeInterface
  205.     {
  206.         return $this->deadlineDate;
  207.     }
  209.     public function setDeadlineDate(?\DateTimeInterface $deadlineDate): static
  210.     {
  211.         $this->deadlineDate = $deadlineDate;
  212.         return $this;
  213.     }
  215.     /** @return Collection<int, LessonProgress> */
  216.     public function getProgresses(): Collection
  217.     {
  218.         return $this->progresses;
  219.     }
  221.     public function addProgress(LessonProgress $progress): static
  222.     {
  223.         if (!$this->progresses->contains($progress)) {
  224.             $this->progresses->add($progress);
  225.             $progress->setSubjectLesson($this);
  226.         }
  227.         return $this;
  228.     }
  230.     public function removeProgress(LessonProgress $progress): static
  231.     {
  232.         if ($this->progresses->removeElement($progress)) {
  233.             if ($progress->getSubjectLesson() === $this) {
  234.                 $progress->setSubjectLesson(null);
  235.             }
  236.         }
  237.         return $this;
  238.     }
  240.     public function getAuthor(): ?User
  241.     {
  242.         return $this->author;
  243.     }
  245.     public function setAuthor(?User $author): static
  246.     {
  247.         $this->author = $author;
  248.         return $this;
  249.     }
  251.     /**
  252.      * true = leçon 100 % custom (hors programme national).
  253.      * false = leçon copiée depuis le programme national.
  254.      */
  255.     public function isCustom(): bool
  256.     {
  257.         return $this->sourceLesson === null;
  258.     }
  260.     public function getNature(): ?string
  261.     {
  262.         return $this->nature;
  263.     }
  265.     public function setNature(?string $nature): static
  266.     {
  267.         $this->nature = $nature;
  268.         return $this;
  269.     }
  271.     public function getDuration(): ?float
  272.     {
  273.         return $this->duration;
  274.     }
  276.     public function setDuration(?float $duration): static
  277.     {
  278.         $this->duration = $duration;
  279.         return $this;
  280.     }
  282.     /**
  283.      * Module/UA affichés en lecture seule pour le contrôle admin, lus via
  284.      * sourceLesson (pas de copie locale — un SubjectLesson 100% custom
  285.      * n'a simplement pas de Module/UA).
  286.      */
  287.     public function getModule(): ?Module
  288.     {
  289.         return $this->sourceLesson?->getModule();
  290.     }
  292.     public function getLearningUnit(): ?LearningUnit
  293.     {
  294.         return $this->sourceLesson?->getLearningUnit();
  295.     }
  297.     public function getCompetenceStatement(): ?string
  298.     {
  299.         return $this->sourceLesson?->getCompetenceStatement();
  300.     }
  302.     public function getWeek(): ?ExamWeek
  303.     {
  304.         return $this->sourceLesson?->getWeek();
  305.     }
  306. }