src/Entity/ProjectOrderTasks.php line 16

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;
  11. use Symfony\Component\Serializer\Annotation\SerializedName;
  13. /**
  14.  * @ORM\Entity(repositoryClass=ProjectOrderTasksRepository::class)
  15.  */
  16. class ProjectOrderTasks
  17. {
  18.     /**
  19.      * @ORM\Id
  20.      * @ORM\GeneratedValue
  21.      * @ORM\Column(type="integer")
  22.      * @Groups({
  23.      *     "project_order_task@base",
  24.      *     "project_order_task@core"
  25.      * })
  26.      */
  27.     private $id;
  29.     /**
  30.      * @ORM\Column(type="integer")
  31.      * @Groups({
  32.      *      "project_order_task@base",
  33.      *      "project_order_task@core"
  34.      *  })
  35.      */
  36.     private $task_index;
  38.     /**
  39.      * @ORM\Column(type="string", length=255)
  40.      * @Groups({
  41.      *      "project_order_task@base",
  42.      *      "project_order_task@core"
  43.      *  })
  44.      */
  45.     private $title;
  47.     /**
  48.      * @ORM\Column(type="text", nullable=true)
  49.      * @Groups({
  50.      *      "project_order_task@base",
  51.      *      "project_order_task@core"
  52.      *  })
  53.      */
  54.     private $description;
  56.     /**
  57.      * @ORM\Column(type="float")
  58.      * @Groups({
  59.      *      "project_order_task@core"
  60.      *  })
  61.      */
  62.     private $progress_weight;
  64.     /**
  65.      * @ORM\Column(type="integer", nullable=true)
  66.      * @Groups({
  67.      *      "project_order_task@core"
  68.      *  })
  69.      */
  70.     private $duration_days;
  72.     /**
  73.      * @deprecated never use this controlling over job
  74.      * @ORM\Column(type="date_immutable", nullable=true, options={"comment": "deprecated -> Redundant field; value is dynamically calculated based on completed job weights."})
  75.      * @Groups({
  76.      *      "project_order_task@core"
  77.      *  })
  78.      */
  79.     private $started_at;
  81.     /**
  82.      * @deprecated never use this controlling over job
  83.      * @ORM\Column(type="date_immutable", nullable=true, options={"comment": "deprecated -> Redundant field; value is dynamically calculated based on completed job weights."})
  84.      * @Groups({
  85.      *      "project_order_task@core"
  86.      *  })
  87.      */
  88.     private $completed_at;
  90.     /**
  91.      * @ORM\ManyToOne(targetEntity=ProjectOrders::class, inversedBy="project_order_tasks")
  92.      * @ORM\JoinColumn(nullable=false, onDelete="CASCADE")
  93.      */
  94.     private $project_order;
  96.     /**
  97.      * @ORM\OneToMany(targetEntity=ProjectOrderTaskJobs::class, mappedBy="order_task", cascade={"persist"}, orphanRemoval=true )
  98.      * @Groups({
  99.      *       "project_order_task@task_jobs"
  100.      *   })
  101.      */
  102.     private $task_jobs;
  104.     /**
  105.      * @ORM\OneToOne(targetEntity=ProjectOrderTaskFulfillment::class, mappedBy="task", cascade={"persist", "remove"})
  106.      * @Groups({
  107.      *     "project_order_task@fulfillment"
  108.      * })
  109.      */
  110.     private $task_fulfillment;
  112.     /**
  113.      * @ORM\ManyToOne(targetEntity=WorkerActivities::class, inversedBy="project_order_tasks")
  114.      * @Groups({
  115.      *         "project_order_task@responsible_person"
  116.      *  })
  117.      */
  118.     private $responsible_person;
  122.     public function __construct()
  123.     {
  124.         $this->task_jobs = new ArrayCollection();
  125.     }
  129.     public function getId(): ?int
  130.     {
  131.         return $this->id;
  132.     }
  134.     public function getTaskIndex(): ?int
  135.     {
  136.         return $this->task_index;
  137.     }
  139.     public function setTaskIndex(int $task_index): self
  140.     {
  141.         $this->task_index = $task_index;
  143.         return $this;
  144.     }
  146.     public function getTitle(): ?string
  147.     {
  148.         return $this->title;
  149.     }
  151.     public function setTitle(string $title): self
  152.     {
  153.         $this->title = $title;
  155.         return $this;
  156.     }
  158.     public function getDescription(): ?string
  159.     {
  160.         return $this->description;
  161.     }
  163.     public function setDescription(?string $description): self
  164.     {
  165.         $this->description = $description;
  167.         return $this;
  168.     }
  170.     public function getProgressWeight(): ?float
  171.     {
  172.         return $this->progress_weight;
  173.     }
  175.     public function setProgressWeight(float $progress_weight): self
  176.     {
  177.         $this->progress_weight = $progress_weight;
  179.         return $this;
  180.     }
  182.     public function getDurationDays(): ?int
  183.     {
  184.         return $this->duration_days;
  185.     }
  187.     public function setDurationDays(?int $duration_days): self
  188.     {
  189.         $this->duration_days = $duration_days;
  191.         return $this;
  192.     }
  194.     public function getStartedAt(): ?\DateTimeImmutable
  195.     {
  196.         return $this->started_at;
  197.     }
  199.     public function setStartedAt(?\DateTimeImmutable $started_at): self
  200.     {
  201.         $this->started_at = $started_at;
  203.         return $this;
  204.     }
  206.     public function getCompletedAt(): ?\DateTimeImmutable
  207.     {
  208.         return $this->completed_at;
  209.     }
  211.     public function setCompletedAt(?\DateTimeImmutable $completed_at): self
  212.     {
  213.         $this->completed_at = $completed_at;
  215.         return $this;
  216.     }
  218.     public function getProjectOrder(): ?ProjectOrders
  219.     {
  220.         return $this->project_order;
  221.     }
  223.     public function setProjectOrder(?ProjectOrders $project_order): self
  224.     {
  225.         $this->project_order = $project_order;
  227.         return $this;
  228.     }
  230.     /**
  231.      * TaskExecution servisi (ağ içi `internal/executions`) + owner FE için sanal alan — task'ın
  232.      * bağlı olduğu siparişin sipariş numarası. DB kolonu DEĞİL, `project_order->order_nr`'dan türer.
  233.      * `project_order` nullable=false olduğu için normalde her zaman dolu döner; savunma amaçlı
  234.      * null-safe. T55: çok-kelimeli sanal getter camelCase serialize olur → `@SerializedName` ZORUNLU.
  235.      *
  236.      * @Groups({
  237.      *     "project_order_task@core"
  238.      * })
  239.      * @SerializedName("order_nr")
  240.      */
  241.     public function getOrderNr(): ?string
  242.     {
  243.         return $this->project_order ? $this->project_order->getOrderNr() : null;
  244.     }
  246.     /**
  247.      * /**
  248.      *  ⚠️ IMPORTANT – Collection index / Serializer issue
  249.      *
  250.      *  Problem:
  251.      *  --------
  252.      *  ProjectOrderTaskJobs koleksiyonu (Doctrine ArrayCollection) üzerinde
  253.      *  BİRDEN FAZLA remove işlemi yapıldığında, Doctrine elemanları silerken
  254.      *  array indexlerini yeniden sıralamaz.
  255.      *
  256.      *  Örnek:
  257.      *    [0 => JobA, 1 => JobB, 2 => JobC]
  258.      *    JobB silinirse →
  259.      *    [0 => JobA, 2 => JobC]   // index boşluğu oluşur ❌
  260.      *
  261.      *  Symfony Serializer bu yapıyı:
  262.      *    - indexler ardışık değilse → associative object `{}` olarak,
  263.      *    - indexler 0..n ise → JSON array `[]` olarak serialize eder.
  264.      *
  265.      *  Bu nedenle çoklu silme sonrası FE tarafında:
  266.      *    task_jobs: { "1": {...} }
  267.      *  gibi HATALI bir çıktı oluşur.
  268.      *
  269.      *  Çözüm:
  270.      *  ------
  271.      *  Serializer'a gönderilmeden önce collection MUTLAKA reindex edilmelidir.
  272.      *  Bu da getter seviyesinde yapılır:
  273.      *
  274.      *    return new ArrayCollection(array_values($this->task_jobs->toArray()));
  275.      *
  276.      *  Böylece:
  277.      *    - Doctrine iç davranışı bozulmaz
  278.      *    - Serializer her zaman `[...]` JSON array üretir
  279.      *    - FE tarafında index problemi yaşanmaz
  280.      *
  281.      *  Not:
  282.      *  ----
  283.      *  Bu problem serializer flag'leri (preserve_empty_objects vb.)
  284.      *  ile çözülemez; sorun serialization değil, collection index yapısıdır.
  285.      * /
  286.      * @return Collection<int, ProjectOrderTaskJobs>&Selectable
  287.      */
  288.     public function getTaskJobs(): Collection
  289.     {
  290.         return new ArrayCollection(array_values($this->task_jobs->toArray()));
  291.     }
  293.     public function addProjectOrderTaskJob(ProjectOrderTaskJobs $projectOrderTaskJob): self
  294.     {
  295.         if (!$this->task_jobs->contains($projectOrderTaskJob)) {
  296.             $this->task_jobs[] = $projectOrderTaskJob;
  297.             $projectOrderTaskJob->setOrderTask($this);
  298.         }
  300.         return $this;
  301.     }
  303.     /**
  304.      * @see ProjectOrderTasks::getTaskJobs()
  305.     */
  306.     public function removeProjectOrderTaskJob(ProjectOrderTaskJobs $projectOrderTaskJob): self
  307.     {
  308.         if ($this->task_jobs->removeElement($projectOrderTaskJob)) {
  309.             // set the owning side to null (unless already changed)
  310.             if ($projectOrderTaskJob->getOrderTask() === $this) {
  311.                 $projectOrderTaskJob->setOrderTask(null);
  312.             }
  313.         }
  315.         return $this;
  316.     }
  318.     public function getTaskFulfillment(): ?ProjectOrderTaskFulfillment
  319.     {
  320.         return $this->task_fulfillment;
  321.     }
  323.     public function setTaskFulfillment(?ProjectOrderTaskFulfillment $task_fulfillment): self
  324.     {
  325.         // set the owning side of the relation if necessary
  326.         if ($task_fulfillment->getTask() !== $this) {
  327.             $task_fulfillment->setTask($this);
  328.         }
  330.         $this->task_fulfillment = $task_fulfillment;
  332.         return $this;
  333.     }
  335.     public function getResponsiblePerson(): ?WorkerActivities
  336.     {
  337.         return $this->responsible_person;
  338.     }
  340.     public function setResponsiblePerson(?WorkerActivities $responsible_person): self
  341.     {
  342.         $this->responsible_person = $responsible_person;
  344.         return $this;
  345.     }
  346. }