src/Entity/Competence.php line 12

Open in your IDE?
  1. <?php
  2. namespace App\Entity;
  3. use App\Repository\CompetenceRepository;
  4. use Doctrine\Common\Collections\ArrayCollection;
  5. use Doctrine\Common\Collections\Collection;
  6. use Doctrine\ORM\Mapping as ORM;
  7. use JMS\Serializer\Annotation\Groups;
  8. #[ORM\Entity(repositoryClassCompetenceRepository::class)]
  9. class Competence
  10. {
  11.     #[ORM\Id]
  12.     #[ORM\GeneratedValue]
  13.     #[ORM\Column]
  14.     #[Groups(['note'])]
  15.     private ?int $id null;
  16.     // Nullable : une Competence du système "par compétence" est rattachée à un
  17.     // Quarter (trimestre), pas à un Exams (séquence) — exam et quarter sont
  18.     // mutuellement exclusifs selon le système d'évaluation de la classe.
  19.     #[ORM\ManyToOne(inversedBy'competences')]
  20.     private ?Exams $exam null;
  21.     // Exposé côté API notes (groupe 'note') : l'app mobile affiche le
  22.     // trimestre à côté de la matière pour une note de compétence — sans
  23.     // séquence (Exams) pour s'y raccrocher visuellement comme en système
  24.     // séquentiel, le trimestre est la seule référence temporelle utile ici.
  25.     #[ORM\ManyToOne]
  26.     #[Groups(['note'])]
  27.     private ?Quarter $quarter null;
  28.     // Trace la CompetenceReference nationale (super-admin) dont cette Competence
  29.     // a été copiée, pour permettre une synchronisation ultérieure (nouvelles
  30.     // compétences ajoutées côté référentiel) sans écraser les personnalisations
  31.     // locales déjà faites par l'école — cf. SubjectLessonCopier pour le patron.
  32.     #[ORM\ManyToOne]
  33.     private ?CompetenceReference $sourceCompetence null;
  34.     #[ORM\ManyToOne(inversedBy'competences')]
  35.     #[ORM\JoinColumn(nullablefalse)]
  36.     private ?Subject $subject null;
  37.     #[ORM\Column(type'string'length255nullabletrue)]
  38.     #[Groups(['note'])]
  39.     private ?string $content null;
  40.     #[ORM\ManyToOne(inversedBy'competences')]
  41.     #[ORM\JoinColumn(nullablefalse)]
  42.     private ?School $school null;
  43.     #[ORM\ManyToOne(inversedBy'competences')]
  44.     #[ORM\JoinColumn(nullablefalse)]
  45.     private ?TheClass $classe null;
  46.     #[ORM\ManyToOne(inversedBy'competences')]
  47.     #[ORM\JoinColumn(nullablefalse)]
  48.     private ?SchoolYear $year null;
  49.     #[ORM\ManyToOne(inversedBy'competences')]
  50.     #[ORM\JoinColumn(nullablefalse)]
  51.     private ?User $author null;
  52.     // Une même compétence évaluée plusieurs fois dans le trimestre : au lieu de
  53.     // dupliquer le libellé (fragile — texte ressaisi à l'identique), l'école
  54.     // crée une "évaluation supplémentaire" qui pointe vers la Competence
  55.     // d'origine (le "leader" du groupe, avec evaluationOf = null). Un seul
  56.     // niveau de rattachement (pas de chaîne : voir getGroupLeader()) — chaque
  57.     // évaluation reste un Note/ParentNote indépendant, seul l'affichage
  58.     // (bulletin, écran de saisie) regroupe les évaluations d'un même leader.
  59.     #[ORM\ManyToOne(targetEntityself::class, inversedBy'additionalEvaluations')]
  60.     #[ORM\JoinColumn(name'evaluation_of_id'nullabletrueonDelete'RESTRICT')]
  61.     private ?Competence $evaluationOf null;
  62.     /** @var Collection<int, Competence> */
  63.     #[ORM\OneToMany(mappedBy'evaluationOf'targetEntityself::class)]
  64.     private Collection $additionalEvaluations;
  65.     public function __construct()
  66.     {
  67.         $this->additionalEvaluations = new ArrayCollection();
  68.     }
  69.     public function getId(): ?int
  70.     {
  71.         return $this->id;
  72.     }
  73.     public function getExam(): ?Exams
  74.     {
  75.         return $this->exam;
  76.     }
  77.     public function setExam(?Exams $exam): static
  78.     {
  79.         $this->exam $exam;
  80.         return $this;
  81.     }
  82.     public function getQuarter(): ?Quarter
  83.     {
  84.         return $this->quarter;
  85.     }
  86.     public function setQuarter(?Quarter $quarter): static
  87.     {
  88.         $this->quarter $quarter;
  89.         return $this;
  90.     }
  91.     public function getSourceCompetence(): ?CompetenceReference
  92.     {
  93.         return $this->sourceCompetence;
  94.     }
  95.     public function setSourceCompetence(?CompetenceReference $sourceCompetence): static
  96.     {
  97.         $this->sourceCompetence $sourceCompetence;
  98.         return $this;
  99.     }
  100.     public function getSubject(): ?Subject
  101.     {
  102.         return $this->subject;
  103.     }
  104.     public function setSubject(?Subject $subject): static
  105.     {
  106.         $this->subject $subject;
  107.         return $this;
  108.     }
  109.     public function getContent(): ?string
  110.     {
  111.         return $this->content;
  112.     }
  113.     public function setContent(?string $content): static
  114.     {
  115.         $this->content $content;
  116.         return $this;
  117.     }
  118.     public function getSchool(): ?School
  119.     {
  120.         return $this->school;
  121.     }
  122.     public function setSchool(?School $school): static
  123.     {
  124.         $this->school $school;
  125.         return $this;
  126.     }
  127.     public function getClasse(): ?TheClass
  128.     {
  129.         return $this->classe;
  130.     }
  131.     public function setClasse(?TheClass $classe): static
  132.     {
  133.         $this->classe $classe;
  134.         return $this;
  135.     }
  136.     public function getYear(): ?SchoolYear
  137.     {
  138.         return $this->year;
  139.     }
  140.     public function setYear(?SchoolYear $year): static
  141.     {
  142.         $this->year $year;
  143.         return $this;
  144.     }
  145.     public function getAuthor(): ?User
  146.     {
  147.         return $this->author;
  148.     }
  149.     public function setAuthor(?User $author): static
  150.     {
  151.         $this->author $author;
  152.         return $this;
  153.     }
  154.     public function getEvaluationOf(): ?self
  155.     {
  156.         return $this->evaluationOf;
  157.     }
  158.     public function setEvaluationOf(?self $evaluationOf): static
  159.     {
  160.         $this->evaluationOf $evaluationOf;
  161.         return $this;
  162.     }
  163.     /** @return Collection<int, Competence> */
  164.     public function getAdditionalEvaluations(): Collection
  165.     {
  166.         return $this->additionalEvaluations;
  167.     }
  168.     /**
  169.      * true si cette Competence est une évaluation supplémentaire d'une autre
  170.      * (son libellé n'est pas le sien propre — voir getDisplayContent()).
  171.      */
  172.     public function isAdditionalEvaluation(): bool
  173.     {
  174.         return $this->evaluationOf !== null;
  175.     }
  176.     /**
  177.      * La Competence "leader" du groupe (elle-même si elle est autonome ou
  178.      * déjà le leader). Sert de clé de regroupement à l'affichage (bulletin,
  179.      * écran de saisie) — un seul niveau, jamais de chaîne d'evaluationOf.
  180.      */
  181.     public function getGroupLeader(): self
  182.     {
  183.         return $this->evaluationOf ?? $this;
  184.     }
  185.     /**
  186.      * Libellé à afficher : le sien propre, ou celui du leader si cette
  187.      * Competence est une évaluation supplémentaire (son content est null).
  188.      */
  189.     public function getDisplayContent(): ?string
  190.     {
  191.         return $this->content ?? $this->evaluationOf?->getContent();
  192.     }
  193. }