src/Entity/Lesson.php line 24

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\LessonRepository;
  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 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.  * leçon 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: LessonRepository::class)]
  24. class Lesson
  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 de la leçon dans le programme (1, 2, 3...).
  44.      */
  45.     #[ORM\Column]
  46.     private ?int $position = null;
  48.     #[ORM\ManyToOne(inversedBy: 'lessons')]
  49.     #[ORM\JoinColumn(nullable: false)]
  50.     private ?SubjectReference $subjectReference = null;
  52.     /**
  53.      * Séquence avant la fin de laquelle cette leçon doit être terminée.
  54.      * Nullable : une leçon 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.     public const NATURE_THEORIQUE   = 'LT';
  67.     public const NATURE_DIGITALISEE = 'LD';
  68.     public const NATURE_PRATIQUE    = 'LP';
  70.     /**
  71.      * Module/Thème parent (nullable — certaines matières n'ont pas de Module).
  72.      */
  73.     #[ORM\ManyToOne(inversedBy: 'lessons')]
  74.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  75.     private ?Module $module = null;
  77.     /**
  78.      * Unité d'Apprentissage parente (nullable — certaines matières n'ont pas d'UA).
  79.      */
  80.     #[ORM\ManyToOne(inversedBy: 'lessons')]
  81.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  82.     private ?LearningUnit $learningUnit = null;
  84.     /**
  85.      * Énoncé de compétence associé (nullable). Au niveau Leçon et non UA :
  86.      * certaines fiches de progression (ex: histoire-géo) n'ont ni Module ni
  87.      * UA mais la compétence y change quand même leçon par leçon.
  88.      */
  89.     #[ORM\Column(type: 'text', nullable: true)]
  90.     private ?string $competenceStatement = null;
  92.     /**
  93.      * Semaine du programme à laquelle cette leçon est prévue (nullable).
  94.      */
  95.     #[ORM\ManyToOne]
  96.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  97.     private ?ExamWeek $week = null;
  99.     /**
  100.      * Nature par défaut définie par le national : Leçon Théorique (LT),
  101.      * Leçon Digitalisée (LD) ou Leçon Pratique (LP). Copiée comme valeur
  102.      * par défaut sur SubjectLesson::nature à la création, modifiable
  103.      * ensuite indépendamment par chaque école/prof.
  104.      */
  105.     #[ORM\Column(length: 2, nullable: true)]
  106.     private ?string $nature = null;
  108.     /**
  109.      * Durée de référence en heures (ex: 2, 4).
  110.      */
  111.     #[ORM\Column(nullable: true)]
  112.     private ?float $duration = null;
  114.     #[ORM\OneToMany(mappedBy: 'lesson', targetEntity: LessonProgress::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  115.     private Collection $progresses;
  117.     #[ORM\ManyToOne]
  118.     private ?User $author = null;
  120.     public function __construct()
  121.     {
  122.         $this->progresses = new ArrayCollection();
  123.     }
  125.     public function __toString(): string
  126.     {
  127.         return $this->title;
  128.     }
  130.     public function getId(): ?int
  131.     {
  132.         return $this->id;
  133.     }
  135.     public function getTitle(): ?string
  136.     {
  137.         return $this->title;
  138.     }
  140.     public function setTitle(string $title): static
  141.     {
  142.         $this->title = $title;
  144.         return $this;
  145.     }
  147.     public function getTitleEn(): ?string
  148.     {
  149.         return $this->titleEn;
  150.     }
  152.     public function setTitleEn(?string $titleEn): static
  153.     {
  154.         $this->titleEn = $titleEn;
  156.         return $this;
  157.     }
  159.     public function getDescription(): ?string
  160.     {
  161.         return $this->description;
  162.     }
  164.     public function setDescription(?string $description): static
  165.     {
  166.         $this->description = $description;
  168.         return $this;
  169.     }
  171.     public function getPosition(): ?int
  172.     {
  173.         return $this->position;
  174.     }
  176.     public function setPosition(int $position): static
  177.     {
  178.         $this->position = $position;
  180.         return $this;
  181.     }
  183.     public function getSubjectReference(): ?SubjectReference
  184.     {
  185.         return $this->subjectReference;
  186.     }
  188.     public function setSubjectReference(?SubjectReference $subjectReference): static
  189.     {
  190.         $this->subjectReference = $subjectReference;
  192.         return $this;
  193.     }
  195.     public function getDeadlineQuarter(): ?Quarter
  196.     {
  197.         return $this->deadlineQuarter;
  198.     }
  200.     public function setDeadlineQuarter(?Quarter $deadlineQuarter): static
  201.     {
  202.         $this->deadlineQuarter = $deadlineQuarter;
  204.         return $this;
  205.     }
  207.     public function getDeadlineDate(): ?\DateTimeInterface
  208.     {
  209.         return $this->deadlineDate;
  210.     }
  212.     public function setDeadlineDate(?\DateTimeInterface $deadlineDate): static
  213.     {
  214.         $this->deadlineDate = $deadlineDate;
  216.         return $this;
  217.     }
  219.     public function getModule(): ?Module
  220.     {
  221.         return $this->module;
  222.     }
  224.     public function setModule(?Module $module): static
  225.     {
  226.         $this->module = $module;
  228.         return $this;
  229.     }
  231.     public function getLearningUnit(): ?LearningUnit
  232.     {
  233.         return $this->learningUnit;
  234.     }
  236.     public function setLearningUnit(?LearningUnit $learningUnit): static
  237.     {
  238.         $this->learningUnit = $learningUnit;
  240.         return $this;
  241.     }
  243.     public function getCompetenceStatement(): ?string
  244.     {
  245.         return $this->competenceStatement;
  246.     }
  248.     public function setCompetenceStatement(?string $competenceStatement): static
  249.     {
  250.         $this->competenceStatement = $competenceStatement;
  252.         return $this;
  253.     }
  255.     public function getWeek(): ?ExamWeek
  256.     {
  257.         return $this->week;
  258.     }
  260.     public function setWeek(?ExamWeek $week): static
  261.     {
  262.         $this->week = $week;
  264.         return $this;
  265.     }
  267.     public function getNature(): ?string
  268.     {
  269.         return $this->nature;
  270.     }
  272.     public function setNature(?string $nature): static
  273.     {
  274.         $this->nature = $nature;
  276.         return $this;
  277.     }
  279.     public function getDuration(): ?float
  280.     {
  281.         return $this->duration;
  282.     }
  284.     public function setDuration(?float $duration): static
  285.     {
  286.         $this->duration = $duration;
  288.         return $this;
  289.     }
  291.     /**
  292.      * @return Collection<int, LessonProgress>
  293.      */
  294.     public function getProgresses(): Collection
  295.     {
  296.         return $this->progresses;
  297.     }
  299.     public function addProgress(LessonProgress $progress): static
  300.     {
  301.         if (!$this->progresses->contains($progress)) {
  302.             $this->progresses->add($progress);
  303.             $progress->setLesson($this);
  304.         }
  306.         return $this;
  307.     }
  309.     public function removeProgress(LessonProgress $progress): static
  310.     {
  311.         if ($this->progresses->removeElement($progress)) {
  312.             if ($progress->getLesson() === $this) {
  313.                 $progress->setLesson(null);
  314.             }
  315.         }
  317.         return $this;
  318.     }
  320.     public function getAuthor(): ?User
  321.     {
  322.         return $this->author;
  323.     }
  325.     public function setAuthor(?User $author): static
  326.     {
  327.         $this->author = $author;
  329.         return $this;
  330.     }
  331. }