src/Entity/CompetenceReference.php line 25

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Entity\Traits\Timestampable;
  6. use App\Repository\CompetenceReferenceRepository;
  7. use Doctrine\Common\Collections\ArrayCollection;
  8. use Doctrine\Common\Collections\Collection;
  9. use Doctrine\ORM\Mapping as ORM;
  11. /**
  12.  * Compétence du programme national (créée par le super-admin), rattachée à un
  13.  * SubjectReference. `quarterNumber` (1, 2 ou 3) situe la compétence dans
  14.  * l'année scolaire de façon abstraite — un SubjectReference n'est pas
  15.  * rattaché à une école donc pas à un Quarter concret ; la conversion
  16.  * "trimestre N → Quarter réel d'une école" se fait au moment de la copie
  17.  * (voir CompetenceCopier), en ordonnant les Quarter de l'année par id ASC.
  18.  *
  19.  * Copiée vers Competence (locale, par école) à la création d'un Subject issu
  20.  * de ce SubjectReference, uniquement pour les classes en système d'évaluation
  21.  * "par compétence" — cf. CompetenceCopier, calqué sur SubjectLessonCopier.
  22.  */
  23. #[ORM\HasLifecycleCallbacks]
  24. #[ORM\Entity(repositoryClass: CompetenceReferenceRepository::class)]
  25. class CompetenceReference
  26. {
  27.     use Timestampable;
  29.     #[ORM\Id]
  30.     #[ORM\GeneratedValue]
  31.     #[ORM\Column]
  32.     private ?int $id = null;
  34.     #[ORM\ManyToOne(inversedBy: 'competenceReferences')]
  35.     #[ORM\JoinColumn(nullable: false)]
  36.     private ?SubjectReference $subjectReference = null;
  38.     #[ORM\Column]
  39.     private ?int $quarterNumber = null;
  41.     // Nullable : null pour une évaluation supplémentaire (evaluationOf non
  42.     // null) — son libellé est alors hérité du leader, voir getDisplayContent().
  43.     #[ORM\Column(type: 'text', nullable: true)]
  44.     private ?string $content = null;
  46.     /**
  47.      * Ordre d'affichage parmi les compétences du même trimestre.
  48.      */
  49.     #[ORM\Column]
  50.     private ?int $position = null;
  52.     #[ORM\ManyToOne]
  53.     private ?User $author = null;
  55.     // Une même compétence évaluée plusieurs fois dans le trimestre, définie une
  56.     // fois pour toutes par le super-admin au niveau national : les écoles qui
  57.     // copient ce SubjectReference héritent directement du regroupement (voir
  58.     // CompetenceCopier), sans avoir à recréer l'évaluation supplémentaire
  59.     // elles-mêmes. Mirroir de Competence::evaluationOf (voir ce fichier pour le
  60.     // détail du principe : un seul niveau de rattachement, jamais de chaîne).
  61.     #[ORM\ManyToOne(targetEntity: self::class, inversedBy: 'additionalEvaluations')]
  62.     #[ORM\JoinColumn(name: 'evaluation_of_id', nullable: true, onDelete: 'RESTRICT')]
  63.     private ?CompetenceReference $evaluationOf = null;
  65.     /** @var Collection<int, CompetenceReference> */
  66.     #[ORM\OneToMany(mappedBy: 'evaluationOf', targetEntity: self::class)]
  67.     private Collection $additionalEvaluations;
  69.     public function __construct()
  70.     {
  71.         $this->additionalEvaluations = new ArrayCollection();
  72.     }
  74.     public function __toString(): string
  75.     {
  76.         return $this->getDisplayContent() ?? '';
  77.     }
  79.     public function getId(): ?int
  80.     {
  81.         return $this->id;
  82.     }
  84.     public function getSubjectReference(): ?SubjectReference
  85.     {
  86.         return $this->subjectReference;
  87.     }
  89.     public function setSubjectReference(?SubjectReference $subjectReference): static
  90.     {
  91.         $this->subjectReference = $subjectReference;
  93.         return $this;
  94.     }
  96.     public function getQuarterNumber(): ?int
  97.     {
  98.         return $this->quarterNumber;
  99.     }
  101.     public function setQuarterNumber(int $quarterNumber): static
  102.     {
  103.         $this->quarterNumber = $quarterNumber;
  105.         return $this;
  106.     }
  108.     public function getContent(): ?string
  109.     {
  110.         return $this->content;
  111.     }
  113.     public function setContent(?string $content): static
  114.     {
  115.         $this->content = $content;
  117.         return $this;
  118.     }
  120.     public function getPosition(): ?int
  121.     {
  122.         return $this->position;
  123.     }
  125.     public function setPosition(int $position): static
  126.     {
  127.         $this->position = $position;
  129.         return $this;
  130.     }
  132.     public function getAuthor(): ?User
  133.     {
  134.         return $this->author;
  135.     }
  137.     public function setAuthor(?User $author): static
  138.     {
  139.         $this->author = $author;
  141.         return $this;
  142.     }
  144.     public function getEvaluationOf(): ?self
  145.     {
  146.         return $this->evaluationOf;
  147.     }
  149.     public function setEvaluationOf(?self $evaluationOf): static
  150.     {
  151.         $this->evaluationOf = $evaluationOf;
  153.         return $this;
  154.     }
  156.     /** @return Collection<int, CompetenceReference> */
  157.     public function getAdditionalEvaluations(): Collection
  158.     {
  159.         return $this->additionalEvaluations;
  160.     }
  162.     public function isAdditionalEvaluation(): bool
  163.     {
  164.         return $this->evaluationOf !== null;
  165.     }
  167.     /**
  168.      * La CompetenceReference "leader" du groupe (elle-même si autonome ou déjà
  169.      * leader). Sert de clé de regroupement à l'affichage (programme national,
  170.      * et bulletin une fois copiée en Competence — voir CompetenceCopier).
  171.      */
  172.     public function getGroupLeader(): self
  173.     {
  174.         return $this->evaluationOf ?? $this;
  175.     }
  177.     public function getDisplayContent(): ?string
  178.     {
  179.         return $this->content ?? $this->evaluationOf?->getContent();
  180.     }
  181. }