@appaflytech/zeyrek-ai-mcp 0.0.36 → 0.0.40

package/dist/resources/examples/bpm-gorev-kontrol.json

@@ -0,0 +1,294 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "S-1: satır olayıyla başlar, yöneticiye bildirim, atanan görevi completeOn ile bitirir, kontrol bölgesinde birim yöneticisi onaylar; ret back-to:iade ile görevi geri açar (writeBack durum=acik). process_definition_create(definition) ile yazılır; zeyrek-backend ProcessRunnerTests.S1 ile birebir."
+  },
+  "definition": {
+    "slug": "gorev-kontrol",
+    "name": "Görev kontrol",
+    "description": "Atanan görevi yapar, birim yöneticisi kontrol edip onaylar; ret görevi atanana geri döndürür.",
+    "analysis": {
+      "purpose": {
+        "en": "Work assigned to a person should not be closed without a check; a manager confirms that it was done properly.",
+        "tr": "Bir kişiye atanan iş kontrol edilmeden kapanmasın; yönetici işin doğru yapıldığını onaylar."
+      },
+      "summary": {
+        "en": "When a task is created with an assignee, their manager is told and the assignee does the work. The manager then checks it: an approval closes the task, a rejection sends it back to the assignee with the reason.",
+        "tr": "Atanan kişisi olan bir görev oluşunca yöneticisine haber verilir ve atanan kişi işi yapar. Ardından yönetici kontrol eder: onay görevi kapatır, ret gerekçesiyle birlikte görevi atanana geri gönderir."
+      }
+    },
+    "subject": {
+      "entity": "gorevler"
+    },
+    "singleton": "per-subject",
+    "withdrawPolicy": "before-first-decision",
+    "onSubjectDeleted": "block",
+    "history": "full",
+    "sod": [
+      "not-initiator"
+    ],
+    "nodes": [
+      {
+        "id": "baslangic",
+        "type": "start",
+        "name": "Görev oluşturuldu",
+        "description": "Görevler tablosunda satır oluşunca süreç başlar.",
+        "analysis": {
+          "what": {
+            "en": "The process starts by itself when a new task is saved.",
+            "tr": "Yeni bir görev kaydedildiğinde süreç kendiliğinden başlar."
+          },
+          "data": {
+            "en": "Reads the new task record; it starts only when the task has an assignee.",
+            "tr": "Yeni görev kaydını okur; yalnız görevin atanan kişisi varsa başlar."
+          },
+          "why": {
+            "en": "Every assigned task should be followed from the moment it exists.",
+            "tr": "Atanan her görev var olduğu andan itibaren takip edilsin diye."
+          },
+          "example": {
+            "en": "The task \"Prepare the Q3 customer report\" is saved with Selin as the assignee, so the process starts.",
+            "tr": "\"3. çeyrek müşteri raporunu hazırla\" görevi Selin'e atanmış olarak kaydedilir ve süreç başlar."
+          }
+        },
+        "trigger": "row-event",
+        "entity": "gorevler",
+        "operation": "create",
+        "condition": "row.atanan_id != null"
+      },
+      {
+        "id": "bildir",
+        "type": "notify",
+        "name": "Yöneticiye bildir",
+        "description": "Atananın birim yöneticisine yeni görev bildirimi gider.",
+        "analysis": {
+          "what": {
+            "en": "The assignee's unit manager gets an inbox message about the new task.",
+            "tr": "Atanan kişinin birim yöneticisine yeni görev için kutu mesajı gider."
+          },
+          "data": {
+            "en": "Uses the assignee of the task to find the manager and the task title for the message.",
+            "tr": "Yöneticiyi bulmak için görevin atanan kişisini, mesaj için görevin başlığını kullanır."
+          },
+          "why": {
+            "en": "The manager will approve the work later, so they should know about it from the start.",
+            "tr": "İşi sonunda yönetici onaylayacak; baştan haberi olsun diye."
+          },
+          "example": {
+            "en": "Burak, Selin's manager, sees \"New task: Prepare the Q3 customer report\" in his inbox.",
+            "tr": "Selin'in yöneticisi Burak, kutusunda \"Yeni görev: 3. çeyrek müşteri raporunu hazırla\" mesajını görür."
+          }
+        },
+        "to": "unit-manager of subject-field:atanan_id",
+        "channels": [
+          "inbox"
+        ],
+        "template": {
+          "subject": {
+            "tr": "Yeni görev"
+          },
+          "body": {
+            "tr": "{{row.baslik}} görevi atandı."
+          }
+        }
+      },
+      {
+        "id": "gorevi-yap",
+        "type": "user-task",
+        "resultKey": "gorevi_yap",
+        "name": "Görevi yap",
+        "description": "Atanan görevi yapar; satırı tamamlandı yapınca görev biter.",
+        "analysis": {
+          "what": {
+            "en": "The assignee does the work and marks the task as done.",
+            "tr": "Atanan kişi işi yapar ve görevi tamamlandı olarak işaretler."
+          },
+          "data": {
+            "en": "Waits until the status of the task becomes \"done\"; the assignee has three days.",
+            "tr": "Görevin durumu \"tamamlandı\" olana kadar bekler; atanan kişinin üç günü vardır."
+          },
+          "why": {
+            "en": "This is the actual work; everything after it is the check.",
+            "tr": "Asıl iş budur; sonrasındaki her şey kontrol içindir."
+          },
+          "example": {
+            "en": "Selin prepares the report within three days and sets the task to done.",
+            "tr": "Selin raporu üç gün içinde hazırlar ve görevi tamamlandı yapar."
+          }
+        },
+        "assignee": "subject-field:atanan_id",
+        "sla": "P3D",
+        "completeOn": {
+          "trigger": "row-event",
+          "operation": "update",
+          "condition": "row.durum === 'tamamlandi'"
+        }
+      },
+      {
+        "id": "kontrol-bolgesi",
+        "type": "region",
+        "name": "Kontrol zinciri",
+        "description": "Uygulama yöneticisinin uyarlayabildiği onay zinciri.",
+        "analysis": {
+          "what": {
+            "en": "A group of approval steps that the application manager can adjust, for example by adding a second approver.",
+            "tr": "Uygulama yöneticisinin uyarlayabildiği onay adımları grubu; örneğin ikinci bir onaycı eklenebilir."
+          },
+          "data": {
+            "en": "Allows at most three steps, only approvals and notifications, assigned to managers, roles or positions.",
+            "tr": "En çok üç adıma izin verir; yalnız onay ve bildirim, yalnız yöneticiye, role ya da pozisyona atanır."
+          },
+          "why": {
+            "en": "Each unit checks work differently; the chain can change without redrawing the process.",
+            "tr": "Her birim işi farklı kontrol eder; zincir süreci baştan çizmeden değişebilsin diye."
+          },
+          "example": {
+            "en": "For the sales unit the chain has one step: Burak's check. Another unit could add a second approver here.",
+            "tr": "Satış birimi için zincirde tek adım var: Burak'ın kontrolü. Başka bir birim buraya ikinci bir onaycı ekleyebilir."
+          }
+        },
+        "editable": "open",
+        "limits": {
+          "maxSteps": 3,
+          "nodeTypes": [
+            "approval",
+            "notify"
+          ],
+          "assigneeRules": [
+            "unit-manager",
+            "parent-unit-manager",
+            "role",
+            "position"
+          ]
+        },
+        "nodes": [
+          {
+            "id": "kontrol-onay",
+            "type": "approval",
+            "resultKey": "kontrol_onay",
+            "name": "Kontrol ve onay",
+            "description": "Birim yöneticisi görevi kontrol eder.",
+            "analysis": {
+              "what": {
+                "en": "The assignee's unit manager checks the work and approves or rejects it.",
+                "tr": "Atanan kişinin birim yöneticisi işi kontrol eder; onaylar ya da reddeder."
+              },
+              "data": {
+                "en": "Looks at the completed task. A rejection needs a comment and sends the task back; the manager has two days.",
+                "tr": "Tamamlanan göreve bakar. Ret için yorum zorunludur ve görev geri gönderilir; yöneticinin iki günü vardır."
+              },
+              "why": {
+                "en": "A second person confirms the quality of the work before it is closed.",
+                "tr": "İş kapanmadan önce kalitesini ikinci bir kişi onaylasın diye."
+              },
+              "example": {
+                "en": "Burak opens the report, notices the missing chart and rejects it with \"Add the regional chart\"; the second time he approves it.",
+                "tr": "Burak raporu açar, eksik grafiği fark eder ve \"Bölge grafiğini ekle\" yorumuyla reddeder; ikinci seferde onaylar."
+              }
+            },
+            "editable": "params",
+            "editableParams": [
+              "assignee",
+              "sla"
+            ],
+            "assignee": "unit-manager of subject-field:atanan_id",
+            "policy": "any",
+            "commentRequired": "outcome === 'rejected'",
+            "onReject": "back-to:iade",
+            "sla": "P2D"
+          }
+        ],
+        "edges": []
+      },
+      {
+        "id": "iade",
+        "type": "notify",
+        "name": "Göreve iade",
+        "description": "Ret gerekçesi atanana bildirilir, satır yeniden açılır.",
+        "analysis": {
+          "what": {
+            "en": "The assignee is told that the task came back, and the task is opened again.",
+            "tr": "Atanan kişiye görevin geri döndüğü bildirilir ve görev yeniden açılır."
+          },
+          "data": {
+            "en": "Uses the task title for the message and sets the status of the task back to \"open\".",
+            "tr": "Mesaj için görevin başlığını kullanır, görevin durumunu yeniden \"açık\" yapar."
+          },
+          "why": {
+            "en": "The assignee has to know what to fix, and the task must be workable again.",
+            "tr": "Atanan kişi neyi düzelteceğini bilmeli, görev yeniden üzerinde çalışılabilir olmalı."
+          },
+          "example": {
+            "en": "Selin gets \"The task was returned for correction\" with Burak's comment, and the task is open again.",
+            "tr": "Selin'e Burak'ın yorumuyla \"Görev düzeltme için iade edildi\" mesajı gelir ve görev yeniden açılır."
+          }
+        },
+        "to": "subject-field:atanan_id",
+        "channels": [
+          "inbox"
+        ],
+        "template": {
+          "subject": {
+            "tr": "Görev iade edildi"
+          },
+          "body": {
+            "tr": "{{row.baslik}} görevi düzeltme için iade edildi."
+          }
+        },
+        "writeBack": {
+          "durum": "'acik'"
+        }
+      },
+      {
+        "id": "onaylandi",
+        "type": "end",
+        "name": "Onaylandı",
+        "description": "Görev onaylandı, satır kapatılır.",
+        "analysis": {
+          "what": {
+            "en": "The process ends with the task approved.",
+            "tr": "Süreç görev onaylanmış olarak biter."
+          },
+          "data": {
+            "en": "Sets the status of the task to \"approved\".",
+            "tr": "Görevin durumunu \"onaylandı\" yapar."
+          },
+          "why": {
+            "en": "The task record shows that the work is finished and checked.",
+            "tr": "Görev kaydı işin bittiğini ve kontrol edildiğini göstersin diye."
+          },
+          "example": {
+            "en": "After Burak's approval the Q3 report task shows \"approved\".",
+            "tr": "Burak onaylayınca 3. çeyrek rapor görevi \"onaylandı\" olarak görünür."
+          }
+        },
+        "outcome": "approved",
+        "writeBack": {
+          "durum": "'onaylandi'"
+        }
+      }
+    ],
+    "edges": [
+      [
+        "baslangic",
+        "bildir"
+      ],
+      [
+        "bildir",
+        "gorevi-yap"
+      ],
+      [
+        "gorevi-yap",
+        "kontrol-bolgesi"
+      ],
+      [
+        "kontrol-bolgesi",
+        "onaylandi"
+      ],
+      [
+        "iade",
+        "gorevi-yap"
+      ]
+    ]
+  }
+}

package/dist/resources/examples/bpm-iso-dokuman.json

@@ -0,0 +1,228 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "S-8: onay birimi quorum(2), okuma turu bölgesi bireysel görev + read-proof kanıtı; duzenle eylemi signal:duzenleme-istegi yayar, bölge işleyicisi dokuman-duzenleme alt sürecini açar, onaylanırsa tur tek sefer yeniden başlar (restartWhen no-open-handlers). vars.onayBirimi ve vars.okuyucular user:<id> listeleridir."
+  },
+  "definition": {
+    "slug": "iso-dokuman-kontrol",
+    "name": "ISO doküman kontrolü",
+    "description": "Doküman onay biriminden geçer, okuma turuna dağıtılır; okuma sırasında gelen düzenleme istekleri alt süreçle ele alınır ve onaylanırsa tur yeniden başlar.",
+    "analysis": {
+      "purpose": {
+        "en": "ISO rules require that a controlled document is approved before use and that everyone concerned has read it; this process keeps that proof.",
+        "tr": "ISO kuralları kontrollü bir dokümanın kullanılmadan önce onaylanmasını ve ilgili herkesin onu okumasını ister; bu süreç o kanıtı tutar."
+      },
+      "summary": {
+        "en": "The author sends the document for approval and an approval group decides. The readers then read and confirm it; if someone asks for a change during reading, the change is handled and reading starts again. When everyone has read it, the document is in force.",
+        "tr": "Hazırlayan dokümanı onaya gönderir, bir onay grubu karar verir. Ardından okuyucular dokümanı okuyup onaylar; okuma sırasında biri değişiklik isterse değişiklik ele alınır ve okuma yeniden başlar. Herkes okuyunca doküman yürürlüğe girer."
+      }
+    },
+    "subject": {
+      "entity": "dokumanlar"
+    },
+    "singleton": "per-subject",
+    "history": "full",
+    "nodes": [
+      {
+        "id": "baslangic",
+        "type": "start",
+        "name": "Onaya gönderildi",
+        "description": "Hazırlayan dokümanı onaya gönderir.",
+        "analysis": {
+          "what": {
+            "en": "The author starts the process by sending the document for approval.",
+            "tr": "Hazırlayan dokümanı onaya göndererek süreci başlatır."
+          },
+          "data": {
+            "en": "Reads the document record the author chose.",
+            "tr": "Hazırlayanın seçtiği doküman kaydını okur."
+          },
+          "why": {
+            "en": "Only a finished draft should go into approval, and the author decides when it is finished.",
+            "tr": "Onaya yalnız bitmiş taslak girsin; ne zaman bittiğine hazırlayan karar versin diye."
+          },
+          "example": {
+            "en": "Deniz sends the new \"Supplier evaluation procedure\" for approval.",
+            "tr": "Deniz yeni \"Tedarikçi değerlendirme prosedürü\"nü onaya gönderir."
+          }
+        },
+        "trigger": "manual"
+      },
+      {
+        "id": "onay-birimi",
+        "type": "approval",
+        "resultKey": "onay_birimi",
+        "name": "Onay birimi",
+        "description": "Dört kişilik onay biriminden iki onay yeterli, tek ret dokümanı iade eder.",
+        "analysis": {
+          "what": {
+            "en": "Each member of the approval group gets their own task; two approvals are enough, a single rejection sends the document back.",
+            "tr": "Onay grubunun her üyesine ayrı görev düşer; iki onay yeter, tek bir ret dokümanı geri gönderir."
+          },
+          "data": {
+            "en": "Uses the list of approvers given when the process starts.",
+            "tr": "Süreç başlarken verilen onaycı listesini kullanır."
+          },
+          "why": {
+            "en": "A controlled document needs a formal approval before anyone relies on it.",
+            "tr": "Kontrollü bir dokümana kimse güvenmeden önce resmi onay gerekir."
+          },
+          "example": {
+            "en": "Of the four approvers, the quality manager and the purchasing manager approve first; two approvals are enough.",
+            "tr": "Dört onaycıdan önce kalite müdürü ve satın alma müdürü onaylar; iki onay yeterlidir."
+          }
+        },
+        "assignee": {
+          "rule": "list",
+          "of": "vars.onayBirimi",
+          "expand": "members",
+          "dedupe": true
+        },
+        "mode": "individual",
+        "policy": "quorum(2)",
+        "rejectPolicy": "any-reject",
+        "onReject": "end"
+      },
+      {
+        "id": "okuma-turu",
+        "type": "region",
+        "name": "Okuma turu",
+        "description": "Okuyucular dokümanı okur ve onaylar; düzenleme isteği bölge olayıdır.",
+        "analysis": {
+          "what": {
+            "en": "The reading round: readers read the document, and change requests are handled inside it.",
+            "tr": "Okuma turu: okuyucular dokümanı okur, değişiklik istekleri bu turun içinde ele alınır."
+          },
+          "data": {
+            "en": "Listens for a \"change request\"; the request is handled by a separate change process, and when it is approved the reading round starts again.",
+            "tr": "\"Değişiklik isteği\"ni dinler; istek ayrı bir değişiklik süreciyle ele alınır, onaylanırsa okuma turu yeniden başlar."
+          },
+          "why": {
+            "en": "Readers must always confirm the latest version, not an outdated one.",
+            "tr": "Okuyucular eski bir sürümü değil, her zaman son sürümü onaylasın diye."
+          },
+          "example": {
+            "en": "Can asks to correct form number F-12 to F-21; the change is approved and all twelve readers get a new task.",
+            "tr": "Can F-12 form numarasının F-21 olarak düzeltilmesini ister; değişiklik onaylanır ve on iki okuyucunun hepsine yeni görev düşer."
+          }
+        },
+        "editable": "locked",
+        "on": [
+          {
+            "event": "signal:duzenleme-istegi",
+            "interrupt": false,
+            "handler": {
+              "type": "sub-process",
+              "processSlug": "dokuman-duzenleme",
+              "input": {
+                "istek": "event.form"
+              }
+            },
+            "afterHandlers": "restart-region",
+            "restartWhen": "no-open-handlers",
+            "restartIf": "handler.outcome === 'approved'",
+            "restartScope": "all",
+            "cancelStale": "superseded"
+          }
+        ],
+        "nodes": [
+          {
+            "id": "oku-onayla",
+            "type": "user-task",
+            "resultKey": "oku_onayla",
+            "name": "Oku ve onayla",
+            "description": "Her okuyucuya ayrı görev; okuma kanıtı defterde kalır.",
+            "analysis": {
+              "what": {
+                "en": "Every reader gets their own task to read the document and confirm \"I have read and understood it\".",
+                "tr": "Her okuyucuya dokümanı okuyup \"Okudum, anladım\" demesi için ayrı görev düşer."
+              },
+              "data": {
+                "en": "Uses the list of readers; all of them must confirm, and each confirmation is kept as proof of reading.",
+                "tr": "Okuyucu listesini kullanır; hepsi onaylamalıdır, her onay okuma kanıtı olarak saklanır."
+              },
+              "why": {
+                "en": "Audits ask for proof that each person concerned read the current version.",
+                "tr": "Denetimler ilgili her kişinin güncel sürümü okuduğunun kanıtını ister."
+              },
+              "example": {
+                "en": "Each of the twelve employees opens the procedure and clicks \"I have read and understood it\".",
+                "tr": "On iki çalışanın her biri prosedürü açar ve \"Okudum, anladım\" düğmesine basar."
+              }
+            },
+            "assignee": {
+              "rule": "list",
+              "of": "vars.okuyucular",
+              "expand": "members",
+              "dedupe": true
+            },
+            "mode": "individual",
+            "join": "all",
+            "revisionBound": true,
+            "actions": [
+              {
+                "id": "okudum",
+                "label": {
+                  "tr": "Okudum, anladım"
+                },
+                "completes": true,
+                "evidence": "read-proof"
+              },
+              {
+                "id": "duzenle",
+                "label": {
+                  "tr": "Düzenleme iste"
+                },
+                "completes": false,
+                "emits": "signal:duzenleme-istegi"
+              }
+            ]
+          }
+        ],
+        "edges": []
+      },
+      {
+        "id": "yayinlandi",
+        "type": "end",
+        "name": "Yürürlükte",
+        "description": "Okuma turu tamamlandı.",
+        "analysis": {
+          "what": {
+            "en": "The process ends and the document is in force.",
+            "tr": "Süreç biter ve doküman yürürlüğe girer."
+          },
+          "data": {
+            "en": "Sets the status of the document to \"in force\".",
+            "tr": "Dokümanın durumunu \"yürürlükte\" yapar."
+          },
+          "why": {
+            "en": "Everyone can see which version is valid from now on.",
+            "tr": "Bundan sonra hangi sürümün geçerli olduğunu herkes görsün diye."
+          },
+          "example": {
+            "en": "The corrected procedure shows \"in force\" and is the version everyone uses.",
+            "tr": "Düzeltilmiş prosedür \"yürürlükte\" görünür ve herkesin kullandığı sürüm olur."
+          }
+        },
+        "outcome": "effective",
+        "writeBack": {
+          "durum": "'yururlukte'"
+        }
+      }
+    ],
+    "edges": [
+      [
+        "baslangic",
+        "onay-birimi"
+      ],
+      [
+        "onay-birimi",
+        "okuma-turu"
+      ],
+      [
+        "okuma-turu",
+        "yayinlandi"
+      ]
+    ]
+  }
+}