src/Entity/TaskFulfillmentStage.php line 44

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\TaskFulfillmentStageRepository;
  6. use Doctrine\ORM\Mapping as ORM;
  7. use Symfony\Component\Serializer\Annotation\Groups;
  9. /**
  10.  * Uretim asamasi (Produktionsstatus) — TODO #109.
  11.  *
  12.  * Bir task'in uretim hattindaki yerini anlatan siralı liste (Auftragseingang →
  13.  * ... → Montagebereit). Asamayi SERVIS tarafi (icraci) secer, ERP salt-okur —
  14.  * modulun K5 kuralinin devami.
  15.  *
  16.  * NEDEN ENUM DEGIL TABLO (kullanici karari 2026-08-19): asama bir OZELLIK
  17.  * tasiyor (`is_start_stage` / `is_completion_stage`). ENUM degeri ozellik
  18.  * tasiyamaz. Ayrica liste zamanla degisecek — yeni asama eklenebilir, biri
  19.  * emekli edilebilir; bunun icin kod degisikligi/migration gerekmemeli.
  20.  *
  21.  * ETIKET BURADA TUTULUR, CEVIRI KATALOGUNDA DEGIL — ve bu bir eksiklik degil,
  22.  * kullanicinin karari (2026-08-19): asamalari sisteme koyan kisi KENDI dilinde
  23.  * yazar (Alman firma Almanca, Turk firma Turkce) ve o kurulumu kim acarsa acsin
  24.  * ayni metni gorur. Cok dilli karsilik ARANMIYOR. Teknik olarak da zorunlu:
  25.  * katalog derleme zamanina bagli, bu liste calisma zamanina — yarin eklenen bir
  26.  * asamanin katalogda karsiligi olamaz.
  27.  *
  28.  * 🪤 SILME YASAK — EMEKLILIK VAR (kullanici karari 2026-08-19). Bir asama bir
  29.  * task'a bagliysa SILINMEZ; yalnizca `active = false` yapilir. Boylece listede
  30.  * gorunmez ama gecmisteki task'lar hala ona baglidir ve etiketleri okunur.
  31.  *
  32.  * Bu kural yorumda BIRAKILMADI: `ProjectOrderTasks::$fulfillment_stage` ve
  33.  * gunluk kayitlari bu tabloya FK ile baglanir ve `onDelete` VERILMEZ —
  34.  * Doctrine varsayilani RESTRICT oldugu icin bagli bir satiri DB'nin kendisi
  35.  * sildirmez. Kurali kodu okumayan da ihlal edemez.
  36.  *
  37.  * Onceki tasarimda task kodu STRING olarak tutuyordu (gerekce: "asama silinirse
  38.  * gecmis bozulmasin"). Silme iptal edilince o gerekce dustu, geriye yalnizca
  39.  * kod ile etiketi senkron tutma zorunlulugu — yani tutarsizlik riski — kaldi.
  40.  *
  41.  * @ORM\Entity(repositoryClass=TaskFulfillmentStageRepository::class)
  42.  * @ORM\Table(name="task_fulfillment_stages")
  43.  */
  44. class TaskFulfillmentStage
  45. {
  46.     /**
  47.      * @ORM\Id
  48.      * @ORM\GeneratedValue
  49.      * @ORM\Column(type="integer")
  50.      * @Groups({
  51.      *     "task_fulfillment_stage@ref",
  52.      *     "task_fulfillment_stage@base",
  53.      *     "task_fulfillment_stage@core"
  54.      * })
  55.      */
  56.     private $id;
  58.     /**
  59.      * Dogal anahtar — task'a KOPYALANAN deger budur. Etiket degisse de anlam
  60.      * kaymasin diye sabit; ikinci kez ayni kod acilmasin diye UNIQUE.
  61.      * @ORM\Column(type="string", length=64, unique=true)
  62.      * @Groups({
  63.      *     "task_fulfillment_stage@base",
  64.      *     "task_fulfillment_stage@core"
  65.      * })
  66.      */
  67.     private $code;
  69.     /**
  70.      * Ekranda gorunen ad (ör. "Montagebereit").
  71.      * @ORM\Column(type="string", length=255)
  72.      * @Groups({
  73.      *     "task_fulfillment_stage@base",
  74.      *     "task_fulfillment_stage@core"
  75.      * })
  76.      */
  77.     private $label;
  79.     /**
  80.      * Listedeki sira. Araya yeni asama girebilsin diye 10'ar artan degerlerle
  81.      * seed edilir (10, 20, 30 …) — aradaki bosluk yeniden numaralandirmayi
  82.      * gereksiz kilar.
  83.      * @ORM\Column(type="integer")
  84.      * @Groups({
  85.      *     "task_fulfillment_stage@base",
  86.      *     "task_fulfillment_stage@core"
  87.      * })
  88.      */
  89.     private $sort_index;
  91.     /**
  92.      * Is BASLADIGINDA (execution published) kullanilacak asama.
  93.      * 🪤 EN FAZLA BIR satirda true — guard servis tarafinda (MySQL'de kosullu
  94.      * unique index yok).
  95.      * @ORM\Column(type="boolean", options={"default": false})
  96.      * @Groups({
  97.      *     "task_fulfillment_stage@core"
  98.      * })
  99.      */
  100.     private $is_start_stage = false;
  102.     /**
  103.      * Task %100'e ulastiginda kullanilacak asama. Bayrakli satir yoksa ekranda
  104.      * genel "Completed" gosterilir.
  105.      * 🪤 EN FAZLA BIR satirda true (yukaridaki ile ayni guard).
  106.      * @ORM\Column(type="boolean", options={"default": false})
  107.      * @Groups({
  108.      *     "task_fulfillment_stage@core"
  109.      * })
  110.      */
  111.     private $is_completion_stage = false;
  113.     /**
  114.      * Rozet ARKA PLAN rengi — `#RRGGBB` (kullanici karari 2026-08-19).
  115.      *
  116.      * Her asamanin rengini YONETICI belirler ve o renk her yerde ayni kalir:
  117.      * pano, yeni gelenler, listeler, ERP kolonu, ERP ozeti. Renk kodda degil
  118.      * VERIDE oldugu icin yeni bir asama eklendiginde kod degisikligi gerekmez.
  119.      *
  120.      * 🪤 METIN RENGI AYRI KOLON DEGIL, HESAPLANIR. Iki kolon (bg + text)
  121.      * koysaydik yonetici koyu zemine koyu yazi secebilir ve rozet okunmaz
  122.      * hale gelirdi — kimse de fark etmezdi. Tek renk aliniyor, yazi rengi
  123.      * zeminin parlakligindan turetiliyor (bkz. FE `okunakliMetinRengi`).
  124.      * Boylece "okunmaz rozet" YAPISAL olarak imkansiz.
  125.      *
  126.      * NULL = tema varsayilani kullanilir; renk zorunlu degil.
  127.      *
  128.      * @ORM\Column(type="string", length=9, nullable=true)
  129.      * @Groups({
  130.      *     "task_fulfillment_stage@base",
  131.      *     "task_fulfillment_stage@core"
  132.      * })
  133.      */
  134.     private $bg_color;
  136.     /**
  137.      * Bu asama HANGI NITELIKTEKI ise ait — gruplama icin (kullanici karari
  138.      * 2026-08-19).
  139.      *
  140.      * NULL = HER task icin gecerli (ortak asamalar).
  141.      * 'production' / 'service' = yalniz o nitelikteki isler icin anlamli.
  142.      *
  143.      * NEDEN AYRI LISTE DEGIL: kullanici tek liste istedi, ayrimi GRUPLAMA ile
  144.      * yapiyoruz. Boylece "Warten auf Verzinkerei" bir servis isinde ayri bir
  145.      * baslik altinda durur, ama liste yonetimi tek yerde kalir.
  146.      *
  147.      * 🪤 SUZME DEGIL GRUPLAMA: yanlis nitelikteki asamayi SECILEMEZ yapmiyoruz.
  148.      * Gercek hayatta servis isi de malzeme bekleyebiliyor; sert filtre koymak
  149.      * kullaniciyi cikmaza sokardi. Ekran gruplar, karari insan verir.
  150.      *
  151.      * 🪤 Tip `task_execution_work_nature` — task'in kendi nitelik kolonuyla AYNI
  152.      * enum. Ikinci bir "nitelik" listesi UYDURULMADI; yoksa iki liste zamanla
  153.      * ayrisirdi ('support' degeri yalniz burada olmaz).
  154.      *
  155.      * @ORM\Column(type="task_execution_work_nature", nullable=true)
  156.      * @Groups({
  157.      *     "task_fulfillment_stage@base",
  158.      *     "task_fulfillment_stage@core"
  159.      * })
  160.      */
  161.     private $work_nature;
  163.     /**
  164.      * Emeklilik anahtari. SILMEK YERINE bunu false yap: satir durdugu icin eski
  165.      * task'larin kodu hala okunabilir bir etikete cevrilebilir, ama listede
  166.      * secilemez.
  167.      * @ORM\Column(type="boolean", options={"default": true})
  168.      * @Groups({
  169.      *     "task_fulfillment_stage@core"
  170.      * })
  171.      */
  172.     private $active = true;
  174.     public function getId(): ?int
  175.     {
  176.         return $this->id;
  177.     }
  179.     public function getCode(): ?string
  180.     {
  181.         return $this->code;
  182.     }
  184.     public function setCode(string $code): self
  185.     {
  186.         $this->code = $code;
  188.         return $this;
  189.     }
  191.     public function getLabel(): ?string
  192.     {
  193.         return $this->label;
  194.     }
  196.     public function setLabel(string $label): self
  197.     {
  198.         $this->label = $label;
  200.         return $this;
  201.     }
  203.     public function getSortIndex(): ?int
  204.     {
  205.         return $this->sort_index;
  206.     }
  208.     public function setSortIndex(int $sort_index): self
  209.     {
  210.         $this->sort_index = $sort_index;
  212.         return $this;
  213.     }
  215.     public function isStartStage(): bool
  216.     {
  217.         return (bool) $this->is_start_stage;
  218.     }
  220.     public function setIsStartStage(bool $is_start_stage): self
  221.     {
  222.         $this->is_start_stage = $is_start_stage;
  224.         return $this;
  225.     }
  227.     public function isCompletionStage(): bool
  228.     {
  229.         return (bool) $this->is_completion_stage;
  230.     }
  232.     public function setIsCompletionStage(bool $is_completion_stage): self
  233.     {
  234.         $this->is_completion_stage = $is_completion_stage;
  236.         return $this;
  237.     }
  239.     public function getBgColor(): ?string
  240.     {
  241.         return $this->bg_color;
  242.     }
  244.     public function setBgColor(?string $bg_color): self
  245.     {
  246.         $this->bg_color = $bg_color;
  248.         return $this;
  249.     }
  251.     public function getWorkNature(): ?string
  252.     {
  253.         return $this->work_nature;
  254.     }
  256.     public function setWorkNature(?string $work_nature): self
  257.     {
  258.         $this->work_nature = $work_nature;
  260.         return $this;
  261.     }
  263.     public function isActive(): bool
  264.     {
  265.         return (bool) $this->active;
  266.     }
  268.     public function setActive(bool $active): self
  269.     {
  270.         $this->active = $active;
  272.         return $this;
  273.     }
  274. }