src/Entity/ProjectOrderTasks.php line 15

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\ProjectOrderTasksRepository;
  6. use Doctrine\Common\Collections\ArrayCollection;
  7. use Doctrine\Common\Collections\Collection;
  8. use Doctrine\Common\Collections\Selectable;
  9. use Doctrine\ORM\Mapping as ORM;
  10. use Symfony\Component\Serializer\Annotation\Groups;
  12. /**
  13.  * @ORM\Entity(repositoryClass=ProjectOrderTasksRepository::class)
  14.  */
  15. class ProjectOrderTasks
  16. {
  17.     /**
  18.      * @ORM\Id
  19.      * @ORM\GeneratedValue
  20.      * @ORM\Column(type="integer")
  21.      * @Groups({
  22.      *     "project_order_task@base",
  23.      *     "project_order_task@core"
  24.      * })
  25.      */
  26.     private $id;
  28.     /**
  29.      * @ORM\Column(type="integer")
  30.      * @Groups({
  31.      *      "project_order_task@base",
  32.      *      "project_order_task@core"
  33.      *  })
  34.      */
  35.     private $task_index;
  37.     /**
  38.      * @ORM\Column(type="string", length=255)
  39.      * @Groups({
  40.      *      "project_order_task@base",
  41.      *      "project_order_task@core"
  42.      *  })
  43.      */
  44.     private $title;
  46.     /**
  47.      * @ORM\Column(type="text", nullable=true)
  48.      * @Groups({
  49.      *      "project_order_task@base",
  50.      *      "project_order_task@core"
  51.      *  })
  52.      */
  53.     private $description;
  55.     /**
  56.      * @ORM\Column(type="float")
  57.      * @Groups({
  58.      *      "project_order_task@core"
  59.      *  })
  60.      */
  61.     private $progress_weight;
  63.     /**
  64.      * @ORM\Column(type="integer", nullable=true)
  65.      * @Groups({
  66.      *      "project_order_task@core"
  67.      *  })
  68.      */
  69.     private $duration_days;
  71.     /**
  72.      * @deprecated never use this controlling over job
  73.      * @ORM\Column(type="date_immutable", nullable=true, options={"comment": "deprecated -> Redundant field; value is dynamically calculated based on completed job weights."})
  74.      * @Groups({
  75.      *      "project_order_task@core"
  76.      *  })
  77.      */
  78.     private $started_at;
  80.     /**
  81.      * @deprecated never use this controlling over job
  82.      * @ORM\Column(type="date_immutable", nullable=true, options={"comment": "deprecated -> Redundant field; value is dynamically calculated based on completed job weights."})
  83.      * @Groups({
  84.      *      "project_order_task@core"
  85.      *  })
  86.      */
  87.     private $completed_at;
  89.     /**
  90.      * @ORM\ManyToOne(targetEntity=ProjectOrders::class, inversedBy="project_order_tasks")
  91.      * @ORM\JoinColumn(nullable=false, onDelete="CASCADE")
  92.      */
  93.     private $project_order;
  95.     /**
  96.      * @ORM\OneToMany(targetEntity=ProjectOrderTaskJobs::class, mappedBy="order_task", cascade={"persist"}, orphanRemoval=true )
  97.      * @Groups({
  98.      *       "project_order_task@task_jobs"
  99.      *   })
  100.      */
  101.     private $task_jobs;
  103.     /**
  104.      * @ORM\OneToOne(targetEntity=ProjectOrderTaskFulfillment::class, mappedBy="task", cascade={"persist", "remove"})
  105.      * @Groups({
  106.      *     "project_order_task@fulfillment"
  107.      * })
  108.      */
  109.     private $task_fulfillment;
  111.     /**
  112.      * @ORM\ManyToOne(targetEntity=WorkerActivities::class, inversedBy="project_order_tasks")
  113.      * @Groups({
  114.      *         "project_order_task@responsible_person"
  115.      *  })
  116.      */
  117.     private $responsible_person;
  121.     public function __construct()
  122.     {
  123.         $this->task_jobs = new ArrayCollection();
  124.     }
  128.     public function getId(): ?int
  129.     {
  130.         return $this->id;
  131.     }
  133.     public function getTaskIndex(): ?int
  134.     {
  135.         return $this->task_index;
  136.     }
  138.     public function setTaskIndex(int $task_index): self
  139.     {
  140.         $this->task_index = $task_index;
  142.         return $this;
  143.     }
  145.     public function getTitle(): ?string
  146.     {
  147.         return $this->title;
  148.     }
  150.     public function setTitle(string $title): self
  151.     {
  152.         $this->title = $title;
  154.         return $this;
  155.     }
  157.     public function getDescription(): ?string
  158.     {
  159.         return $this->description;
  160.     }
  162.     public function setDescription(?string $description): self
  163.     {
  164.         $this->description = $description;
  166.         return $this;
  167.     }
  169.     public function getProgressWeight(): ?float
  170.     {
  171.         return $this->progress_weight;
  172.     }
  174.     public function setProgressWeight(float $progress_weight): self
  175.     {
  176.         $this->progress_weight = $progress_weight;
  178.         return $this;
  179.     }
  181.     public function getDurationDays(): ?int
  182.     {
  183.         return $this->duration_days;
  184.     }
  186.     public function setDurationDays(?int $duration_days): self
  187.     {
  188.         $this->duration_days = $duration_days;
  190.         return $this;
  191.     }
  193.     public function getStartedAt(): ?\DateTimeImmutable
  194.     {
  195.         return $this->started_at;
  196.     }
  198.     public function setStartedAt(?\DateTimeImmutable $started_at): self
  199.     {
  200.         $this->started_at = $started_at;
  202.         return $this;
  203.     }
  205.     public function getCompletedAt(): ?\DateTimeImmutable
  206.     {
  207.         return $this->completed_at;
  208.     }
  210.     public function setCompletedAt(?\DateTimeImmutable $completed_at): self
  211.     {
  212.         $this->completed_at = $completed_at;
  214.         return $this;
  215.     }
  217.     public function getProjectOrder(): ?ProjectOrders
  218.     {
  219.         return $this->project_order;
  220.     }
  222.     public function setProjectOrder(?ProjectOrders $project_order): self
  223.     {
  224.         $this->project_order = $project_order;
  226.         return $this;
  227.     }
  229.     /**
  230.      * /**
  231.      *  ⚠️ IMPORTANT – Collection index / Serializer issue
  232.      *
  233.      *  Problem:
  234.      *  --------
  235.      *  ProjectOrderTaskJobs koleksiyonu (Doctrine ArrayCollection) üzerinde
  236.      *  BİRDEN FAZLA remove işlemi yapıldığında, Doctrine elemanları silerken
  237.      *  array indexlerini yeniden sıralamaz.
  238.      *
  239.      *  Örnek:
  240.      *    [0 => JobA, 1 => JobB, 2 => JobC]
  241.      *    JobB silinirse →
  242.      *    [0 => JobA, 2 => JobC]   // index boşluğu oluşur ❌
  243.      *
  244.      *  Symfony Serializer bu yapıyı:
  245.      *    - indexler ardışık değilse → associative object `{}` olarak,
  246.      *    - indexler 0..n ise → JSON array `[]` olarak serialize eder.
  247.      *
  248.      *  Bu nedenle çoklu silme sonrası FE tarafında:
  249.      *    task_jobs: { "1": {...} }
  250.      *  gibi HATALI bir çıktı oluşur.
  251.      *
  252.      *  Çözüm:
  253.      *  ------
  254.      *  Serializer'a gönderilmeden önce collection MUTLAKA reindex edilmelidir.
  255.      *  Bu da getter seviyesinde yapılır:
  256.      *
  257.      *    return new ArrayCollection(array_values($this->task_jobs->toArray()));
  258.      *
  259.      *  Böylece:
  260.      *    - Doctrine iç davranışı bozulmaz
  261.      *    - Serializer her zaman `[...]` JSON array üretir
  262.      *    - FE tarafında index problemi yaşanmaz
  263.      *
  264.      *  Not:
  265.      *  ----
  266.      *  Bu problem serializer flag'leri (preserve_empty_objects vb.)
  267.      *  ile çözülemez; sorun serialization değil, collection index yapısıdır.
  268.      * /
  269.      * @return Collection<int, ProjectOrderTaskJobs>&Selectable
  270.      */
  271.     public function getTaskJobs(): Collection
  272.     {
  273.         return new ArrayCollection(array_values($this->task_jobs->toArray()));
  274.     }
  276.     public function addProjectOrderTaskJob(ProjectOrderTaskJobs $projectOrderTaskJob): self
  277.     {
  278.         if (!$this->task_jobs->contains($projectOrderTaskJob)) {
  279.             $this->task_jobs[] = $projectOrderTaskJob;
  280.             $projectOrderTaskJob->setOrderTask($this);
  281.         }
  283.         return $this;
  284.     }
  286.     /**
  287.      * @see ProjectOrderTasks::getTaskJobs()
  288.     */
  289.     public function removeProjectOrderTaskJob(ProjectOrderTaskJobs $projectOrderTaskJob): self
  290.     {
  291.         if ($this->task_jobs->removeElement($projectOrderTaskJob)) {
  292.             // set the owning side to null (unless already changed)
  293.             if ($projectOrderTaskJob->getOrderTask() === $this) {
  294.                 $projectOrderTaskJob->setOrderTask(null);
  295.             }
  296.         }
  298.         return $this;
  299.     }
  301.     public function getTaskFulfillment(): ?ProjectOrderTaskFulfillment
  302.     {
  303.         return $this->task_fulfillment;
  304.     }
  306.     public function setTaskFulfillment(?ProjectOrderTaskFulfillment $task_fulfillment): self
  307.     {
  308.         // set the owning side of the relation if necessary
  309.         if ($task_fulfillment->getTask() !== $this) {
  310.             $task_fulfillment->setTask($this);
  311.         }
  313.         $this->task_fulfillment = $task_fulfillment;
  315.         return $this;
  316.     }
  318.     public function getResponsiblePerson(): ?WorkerActivities
  319.     {
  320.         return $this->responsible_person;
  321.     }
  323.     public function setResponsiblePerson(?WorkerActivities $responsible_person): self
  324.     {
  325.         $this->responsible_person = $responsible_person;
  327.         return $this;
  328.     }
  329. }