src/Entity/SubjectLearningUnit.php line 26

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\SubjectLearningUnitRepository;
  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.  * Unité d'Apprentissage (UA) LOCALE d'une matière dans un établissement.
  13.  *
  14.  * Pendant de LearningUnit (programme national) pour la partie du cahier de
  15.  * texte "hors programme national" — voir SubjectModule pour le même
  16.  * principe côté Thème. Scopée au Subject réel (matière + classe + année +
  17.  * école), comme SubjectLesson.
  18.  *
  19.  * `subjectModule` (local) est indépendant de `module` national :
  20.  * SubjectLesson peut être rattachée à une UA locale sans passer par un
  21.  * thème local (subjectModule null), exactement comme LearningUnit peut
  22.  * exister sans Module parent côté programme national.
  23.  */
  24. #[ORM\HasLifecycleCallbacks]
  25. #[ORM\Entity(repositoryClass: SubjectLearningUnitRepository::class)]
  26. class SubjectLearningUnit
  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]
  42.     private ?int $position = null;
  44.     #[ORM\ManyToOne(inversedBy: 'subjectLearningUnits')]
  45.     #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
  46.     private ?Subject $subject = null;
  48.     #[ORM\ManyToOne(inversedBy: 'subjectLearningUnits')]
  49.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  50.     private ?SubjectModule $subjectModule = null;
  52.     /**
  53.      * Thème national (Module) rattaché DIRECTEMENT, sans passer par une
  54.      * copie locale — même principe que SubjectLesson::$module : permet à
  55.      * l'école de classer une UA locale sous un thème du programme national
  56.      * existant plutôt que de forcément créer un SubjectModule pour ça.
  57.      * Indépendant de $subjectModule (l'un OU l'autre, jamais les deux —
  58.      * voir normalizeTheme()).
  59.      */
  60.     #[ORM\ManyToOne]
  61.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  62.     private ?Module $module = null;
  64.     #[ORM\OneToMany(mappedBy: 'subjectLearningUnit', targetEntity: SubjectLesson::class)]
  65.     private Collection $subjectLessons;
  67.     #[ORM\ManyToOne]
  68.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  69.     private ?User $author = null;
  71.     public function __construct()
  72.     {
  73.         $this->subjectLessons = new ArrayCollection();
  74.     }
  76.     public function __toString(): string
  77.     {
  78.         return $this->title ?? '';
  79.     }
  81.     public function getId(): ?int
  82.     {
  83.         return $this->id;
  84.     }
  86.     public function getTitle(): ?string
  87.     {
  88.         return $this->title;
  89.     }
  91.     public function setTitle(string $title): static
  92.     {
  93.         $this->title = $title;
  94.         return $this;
  95.     }
  97.     public function getTitleEn(): ?string
  98.     {
  99.         return $this->titleEn;
  100.     }
  102.     public function setTitleEn(?string $titleEn): static
  103.     {
  104.         $this->titleEn = $titleEn;
  105.         return $this;
  106.     }
  108.     public function getPosition(): ?int
  109.     {
  110.         return $this->position;
  111.     }
  113.     public function setPosition(int $position): static
  114.     {
  115.         $this->position = $position;
  116.         return $this;
  117.     }
  119.     public function getSubject(): ?Subject
  120.     {
  121.         return $this->subject;
  122.     }
  124.     public function setSubject(?Subject $subject): static
  125.     {
  126.         $this->subject = $subject;
  127.         return $this;
  128.     }
  130.     public function getSubjectModule(): ?SubjectModule
  131.     {
  132.         return $this->subjectModule;
  133.     }
  135.     public function setSubjectModule(?SubjectModule $subjectModule): static
  136.     {
  137.         $this->subjectModule = $subjectModule;
  138.         return $this;
  139.     }
  141.     public function getModule(): ?Module
  142.     {
  143.         return $this->module;
  144.     }
  146.     public function setModule(?Module $module): static
  147.     {
  148.         $this->module = $module;
  149.         return $this;
  150.     }
  152.     /**
  153.      * Libellé du thème effectif (local OU national), pour affichage uniforme
  154.      * dans les templates — voir SubjectLesson::getEffectiveThemeLabel()
  155.      * pour le même principe.
  156.      */
  157.     public function getEffectiveThemeLabel(): ?string
  158.     {
  159.         return $this->subjectModule?->getTitle() ?? $this->module?->getTitle();
  160.     }
  162.     /**
  163.      * Empêche l'état incohérent "thème local ET thème national tous les
  164.      * deux renseignés" — voir SubjectLesson::normalizeTheme() pour le même
  165.      * principe (le formulaire propose les deux comme deux champs
  166.      * indépendants, voir SubjectLearningUnitType).
  167.      */
  168.     public function normalizeTheme(): void
  169.     {
  170.         if ($this->subjectModule !== null) {
  171.             $this->module = null;
  172.         }
  173.     }
  175.     /** @return Collection<int, SubjectLesson> */
  176.     public function getSubjectLessons(): Collection
  177.     {
  178.         return $this->subjectLessons;
  179.     }
  181.     public function getAuthor(): ?User
  182.     {
  183.         return $this->author;
  184.     }
  186.     public function setAuthor(?User $author): static
  187.     {
  188.         $this->author = $author;
  189.         return $this;
  190.     }
  191. }