@appaflytech/zeyrek-ai-mcp 0.0.1

package/dist/resources/examples/middleware-authenticate.json

@@ -0,0 +1,194 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "qm projesindeki gerçek 'Authenticate' middleware'inden damıtılmış iskelet (22 step'ten çekirdek akış). Kurallar: type='middleware'; returnDtoId GEREKMEZ ve state=unready normaldir; middleware'ler ada göre ALFABETİK koşar; non-2xx response hedefi hiç çalıştırmaz; set-user değişken adı sabit 'user', variable step'i rule.name ile keyfî ad kurar; girdi HTTP bağlamından okunur (cookie/header/queryString/body), 'input' YOKTUR. system.validateToken dönüşü { isValid, claims } — claim anahtarları system.generateToken'a verilen sözlüğün anahtarlarıdır (bu örnekte userId), token.data.id diye bir alan YOKTUR. Bağlama: microservice definition.middlewareIds / page_create middlewareIds. Ayrıntı: platform_guide('middleware'). Rol kapısı AYRI bir middleware'e ayrılmaz — kapı bu akışın içinde, setUser'dan sonra durur (roleGateVariant); rol slug'ları user_roles.role_id DÜZ FK olduğu için ayrı bir roles okumasıyla eşleştirilir.",
+    "harvestedFrom": "qm Authenticate (0198c959-eb84-7d2b-88be-9cd46bd39318), 2026-08-16"
+  },
+  "definition": {
+    "name": "Authenticate",
+    "slug": "authenticate",
+    "type": "middleware",
+    "steps": [
+      {
+        "id": "<GUID-1 üret: crypto.randomUUID()>",
+        "name": "start",
+        "type": "start",
+        "branches": [
+          { "id": "<GUID-2>", "name": "start", "type": "success", "nextStepId": "<GUID-3>" }
+        ]
+      },
+      {
+        "id": "<GUID-3>",
+        "name": "token",
+        "type": "code",
+        "rule": {
+          "stepType": "code",
+          "expression": "return system.validateToken(cookie.APP_Token)"
+        },
+        "branches": [
+          { "id": "<GUID-4>", "name": "success", "type": "success", "nextStepId": "<GUID-5>" }
+        ]
+      },
+      {
+        "id": "<GUID-5>",
+        "name": "token_check",
+        "type": "condition",
+        "rule": {
+          "stepType": "condition",
+          "items": [
+            { "expression": "token.data.isValid && token.data.claims.userId", "branchId": "<GUID-6>" }
+          ]
+        },
+        "branches": [
+          { "id": "<GUID-6>", "name": "<GUID-6>", "type": "success", "nextStepId": "<GUID-8>" },
+          { "id": "<GUID-7>", "name": "else", "type": "success", "nextStepId": "<GUID-14>" }
+        ]
+      },
+      {
+        "id": "<GUID-8>",
+        "name": "userTable",
+        "type": "table",
+        "rule": {
+          "stepType": "table",
+          "datasourceId": "<datasource id>",
+          "entityId": "<users entity id>",
+          "operation": "get",
+          "isSingle": true,
+          "selectFields": [
+            { "alias": "users", "fieldId": "<id alanı id>", "fieldSlug": "id" },
+            { "alias": "users", "fieldId": "<email alanı id>", "fieldSlug": "email" },
+            { "alias": "users", "fieldId": "<first_name alanı id>", "fieldSlug": "first_name" }
+          ],
+          "filters": [
+            { "alias": "users", "fieldId": "<id alanı id>", "fieldSlug": "id", "operator": "eq", "source": "expression", "value": "token.data.claims.userId", "filterType": "single", "conditionType": "and", "isRequired": true, "children": [], "order": 0 }
+          ],
+          "joins": [],
+          "sort": { "name": "sortField", "type": "sortType", "source": "query-string" },
+          "limit": { "name": "limit", "offset": "offset", "source": "query-string" }
+        },
+        "branches": [
+          { "id": "<GUID-9>", "name": "success", "type": "success", "nextStepId": "<GUID-10>" }
+        ]
+      },
+      {
+        "id": "<GUID-10>",
+        "name": "setUser",
+        "type": "set-user",
+        "rule": {
+          "stepType": "set-user",
+          "expression": "{\n  ...userTable.data\n}",
+          "dataTransferObjectId": "<user DTO id — opsiyonel; verilirse workflow_middleware_variables şemayı listeler>"
+        },
+        "branches": [
+          { "id": "<GUID-11>", "name": "success", "type": "success", "nextStepId": "<GUID-12>" }
+        ]
+      },
+      {
+        "id": "<GUID-12>",
+        "name": "successResponse",
+        "type": "response",
+        "rule": {
+          "stepType": "response",
+          "bodyExpression": "{ success: true }",
+          "httpStatusCode": 200,
+          "headerExpression": "{  }"
+        },
+        "branches": []
+      },
+      {
+        "id": "<GUID-14>",
+        "name": "unauthorizedResponse",
+        "type": "response",
+        "rule": {
+          "stepType": "response",
+          "bodyExpression": "{ success: false, message: 'Oturum geçersiz.' }",
+          "httpStatusCode": 401,
+          "headerExpression": "{  }"
+        },
+        "branches": []
+      }
+    ]
+  },
+  "settingsSetterVariant": {
+    "note": "Genel amaçlı setter (qm '[SY] Settings Setter', 3 step): start -> settings [table get, ayarlar tablosu] -> setVar [type:'variable', rule.name:'settings', rule.expression:'{ ...settings.data }', rule.dataTransferObjectId:<ayarlar DTO>]. Response YOK — sadece değişken kurar; bağlandığı her uçta settings.<alan> okunur. Ad öneki ([A]/[SY]) alfabetik koşum sırasını kurmak içindir."
+  },
+  "roleGateVariant": {
+    "note": "Rol kapısını AYRI bir middleware'e ayırma: kimlik middleware'i set-user'a ULAŞMADAN biterse (çerez yok, koşul else dalı) 'user' hiç tanımlanmaz ve rolü okuyan middleware ham 'user is not defined' ile 500 verir — kullanıcı 401 yerine 500 görür (crm koşumu B-3). Kapıyı bu akışın İÇİNE, setUser'dan SONRA koy. Authorized hedefin rolleri BOŞSA true döndüğü için tek middleware her uca bağlanabilir; kapı yalnız roleIds dolu uçlarda kapanır.",
+    "relationFieldTrap": "user_roles.role_id bir table adımında NESNE DEĞİL düz FK'dır (row_list her ilişki için join'i kendisi üretir, table adımı yalnız joins'te bildirileni çevirir). 'p.role_id.slug' undefined döner, roller sessizce boşalır ve Authorized her zaman false olur. Aşağıdaki ifade iki şekle de dayanır.",
+    "steps": [
+      {
+        "id": "<GUID-R1>", "name": "rolesTable", "type": "table",
+        "rule": {
+          "stepType": "table", "datasourceId": "<datasource id>", "entityId": "<user_roles entity id>",
+          "operation": "get", "alias": "user_roles", "isSingle": false,
+          "selectFields": [
+            { "alias": "user_roles", "fieldId": "<user_roles.id>", "fieldSlug": "id" },
+            { "alias": "user_roles", "fieldId": "<user_roles.role_id>", "fieldSlug": "role_id" }
+          ],
+          "filters": [
+            { "alias": "user_roles", "fieldId": "<user_roles.user_id>", "operator": "eq", "source": "expression",
+              "value": "userTable.data.id", "filterType": "single", "conditionType": "and",
+              "isRequired": true, "children": [], "order": 0 }
+          ],
+          "joins": [], "fields": [], "returnFields": [],
+          "sort": { "name": "sortField", "type": "sortType", "source": "query-string" },
+          "limit": { "name": "limit", "offset": "offset", "source": "query-string" }
+        },
+        "branches": [
+          { "id": "<GUID-R2>", "name": "success", "type": "success", "nextStepId": "<GUID-R3>" },
+          { "id": "<GUID-R2b>", "name": "fail", "type": "fail", "nextStepId": "<GUID-14>" }
+        ]
+      },
+      {
+        "id": "<GUID-R3>", "name": "allRoles", "type": "table",
+        "rule": {
+          "stepType": "table", "datasourceId": "<datasource id>", "entityId": "<roles entity id>",
+          "operation": "get", "alias": "roles", "isSingle": false,
+          "selectFields": [
+            { "alias": "roles", "fieldId": "<roles.id>", "fieldSlug": "id" },
+            { "alias": "roles", "fieldId": "<roles.slug>", "fieldSlug": "slug" }
+          ],
+          "filters": [], "joins": [], "fields": [], "returnFields": [],
+          "sort": { "name": "sortField", "type": "sortType", "source": "query-string" },
+          "limit": { "name": "limit", "offset": "offset", "source": "query-string" }
+        },
+        "branches": [
+          { "id": "<GUID-R4>", "name": "success", "type": "success", "nextStepId": "<GUID-R5>" },
+          { "id": "<GUID-R4b>", "name": "fail", "type": "fail", "nextStepId": "<GUID-14>" }
+        ]
+      },
+      {
+        "id": "<GUID-R5>", "name": "setUser", "type": "set-user",
+        "rule": {
+          "stepType": "set-user",
+          "expression": "(function () {\n  var link = rolesTable.data || [];\n  var all  = allRoles.data || [];\n  var slugs = link.map(function (ur) {\n    var rid = ur.role_id && ur.role_id.id ? ur.role_id.id : ur.role_id;\n    var match = all.filter(function (r) { return r.id === rid; })[0];\n    return match && match.slug;\n  }).filter(function (s) { return !!s; });\n  return Object.assign({}, userTable.data, { roles: slugs, roles_csv: ',' + slugs.join(',') + ',' });\n})()",
+          "dataTransferObjectId": "<user DTO id — opsiyonel>"
+        },
+        "branches": [{ "id": "<GUID-R6>", "name": "success", "type": "success", "nextStepId": "<GUID-R7>" }]
+      },
+      {
+        "id": "<GUID-R7>", "name": "roleGate", "type": "condition",
+        "rule": { "stepType": "condition", "items": [{ "expression": "Authorized(user.roles)", "branchId": "<GUID-R8>" }] },
+        "branches": [
+          { "id": "<GUID-R8>", "name": "<GUID-R8>", "type": "success", "nextStepId": null },
+          { "id": "<GUID-R9>", "name": "else", "type": "fail", "nextStepId": "<GUID-F>" }
+        ]
+      },
+      {
+        "id": "<GUID-F>", "name": "forbiddenResponse", "type": "response",
+        "rule": {
+          "stepType": "response",
+          "bodyExpression": "{ success: false, message: 'Bu işlem için yetkiniz yok.' }",
+          "httpStatusCode": 403, "headerExpression": "{  }"
+        },
+        "branches": []
+      }
+    ],
+    "acceptance": "Dört testle kabul edilir: (1) rolü olan kullanıcı korumalı ucu çağırır → 200; (2) rolü olmayan kullanıcı → 403; (3) kimliksiz çağrı (microservice_execute anonymous:true) → 401; (4) roleIds boş bir uç aynı middleware'e bağlıyken kimliği doğrulanmış herkese açık kalır (Authorized boş rol listesinde true döner)."
+  },
+  "consumptionExample": {
+    "note": "Kimlik kapsaması: uca middleware'i bağla (definition.middlewareIds) + owner filtresi expression yap. qm kanıtı: sy-users-get-my-profile.",
+    "middlewareIds": ["<authenticate workflow id>"],
+    "filter": { "fieldId": "<owner alanı id>", "operator": "eq", "source": "expression", "value": "user.id", "filterType": "single", "conditionType": "and", "isRequired": false, "children": [], "order": 0 }
+  }
+}

package/dist/resources/examples/page-detail-profile.json

@@ -0,0 +1,95 @@
+{
+  "_meta": {
+    "synthetic": false,
+    "note": "Detay / profil sayfası: form arketipinin salt-okuma akrabası. Kimliği query parametresinden DEĞİL middleware'den alır, ilişkili kayıtları alt tabloda gösterir, ikincil işlemleri (şifre değiştirme) modal içinde kendi formuyla yapar.",
+    "harvestedFrom": "qm projesi '[SY] Profil bilgilerim' sayfası, 2026-08-17; ayrıntı: zeyrek-mcp/docs/18-sayfa-arketipleri.md §4",
+    "pairsWith": "page-form-upsert (düzenlenebilir kardeşi), middleware-authenticate (kimliği kuran guard)"
+  },
+  "_rules": {
+    "rootLayers": "modal ve drawer page_container'ın İÇİNDE değil, şemanın KÖKÜNDE onun kardeşi olarak durur. Kapsayıcıya konursa sayfa akışının içine girer ve katman olarak açılmaz. Gateway kök eklemeleri kapsayıcıya yönlendirir ama bu iki tipi istisna tutar.",
+    "identityFromMiddleware": "Profil/‘benim kayıtlarım’ sayfalarında kimlik istemciden gelmez: sayfaya ve uca auth middleware'i bağlanır, ucun filtresi source:'expression' + value:'user.id' olur. Sabit id ya da query parametresi kullanmak sahtelenebilir. Bkz. platform_guide('middleware') Tarif 3.",
+    "viewMode": "Salt okuma için input'ların isViewmode prop'u kullanılır — ayrı bir 'detay' komponent ailesi yoktur, aynı form komponentleri görüntüleme kipine alınır.",
+    "secondaryForm": "Sayfa içi ikinci iş (şifre güncelleme) modalın children'ındaki kendi form'u ve kendi submit akışıyla yaşar; ana formun akışına karıştırılmaz.",
+    "relatedList": "İlişkili kayıtlar alt tabloda listelenir ve kendi mount akışıyla dolar; satıra tıklama ilgili detay sayfasına/drawer'a gider (flow-list-to-form deseni)."
+  },
+  "pageCreateArgs": {
+    "name": "Profil bilgilerim",
+    "slug": "profil-bilgilerim",
+    "browserTitle": "Profil bilgilerim",
+    "layoutId": "<layout id>",
+    "middlewareIds": ["<auth middleware id>"]
+  },
+  "schemaPatchOps": [
+    {
+      "op": "add_component",
+      "parent": "page_container",
+      "component": {
+        "elementId": "profile_form", "kind": "component", "type": "form", "name": "profile_form",
+        "props": { "title": { "type": "static", "data": "Bilgilerim" } },
+        "states": { "isSticky": false, "isDroppable": true, "isScrollable": false, "isWrapper": true },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 24, "w": 12 }, "position": { "x": 0, "y": 0 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "profile_form",
+      "component": {
+        "elementId": "in_full_name", "kind": "component", "type": "textinput", "name": "in_full_name",
+        "props": { "label": { "type": "static", "data": "Ad Soyad" }, "isViewmode": { "type": "static", "data": true } },
+        "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 5, "w": 6 }, "position": { "x": 0, "y": 0 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "root",
+      "component": {
+        "elementId": "password_modal", "kind": "component", "type": "modal", "name": "password_modal",
+        "props": { "title": { "type": "static", "data": "Şifre güncelle" } },
+        "states": { "isSticky": false, "isDroppable": true, "isScrollable": true, "isWrapper": true },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 24, "w": 6 }, "position": { "x": 0, "y": 0 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "password_modal",
+      "component": {
+        "elementId": "password_form", "kind": "component", "type": "form", "name": "password_form",
+        "props": {},
+        "states": { "isSticky": false, "isDroppable": true, "isScrollable": false, "isWrapper": true },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 20, "w": 12 }, "position": { "x": 0, "y": 0 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    { "op": "set_event", "target": "page_container", "event": "mount", "eventValue": "<profil yükleme flow id>" },
+    { "op": "set_event", "target": "password_form", "event": "submit", "eventValue": "<şifre güncelleme flow id>" }
+  ],
+  "mountFlowCreateArgs": {
+    "host": "page",
+    "hostId": "<sayfa id>",
+    "name": "Page - mount",
+    "slug": "page-mount",
+    "steps": [
+      {
+        "stepId": "start", "name": "start", "type": "start", "kind": "normal", "args": {},
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "get_profile" }]
+      },
+      {
+        "stepId": "get_profile", "name": "get_profile", "type": "microservice", "kind": "normal",
+        "args": { "microserviceId": "<user.id filtreli profil ucu id>", "isRaw": false, "parameters": [] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "fill_profile" }]
+      },
+      {
+        "stepId": "fill_profile", "name": "fill_profile", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [{
+          "id": "<GUID>", "type": "change", "source": "component", "element": "in_full_name", "property": "value",
+          "mapping": { "source": "", "mappings": {} },
+          "value": { "type": "storage", "ref": "get_profile.data.full_name" } }] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      }
+    ]
+  }
+}

package/dist/resources/examples/page-dynamic-form.json

@@ -0,0 +1,221 @@
+{
+  "_meta": {
+    "synthetic": false,
+    "note": "Dinamik form sayfası: alan SAYISI ve her alanın TİPİ çalışma anında veriden gelir (anket, kural tabanlı başvuru formu, denetim listesi). html kaçış kapısı KULLANILMAZ — repeater + `item` iki yönlü bağı bunu hazır komponentlerle yapar. Bu dosya asıl olarak İKİ AKIŞIN tam gövdesini taşır; şema/stil tarafı platform_guide('page') Kural 1g + 1h'te (hazır stil blokları 1h-3'te).",
+    "harvestedFrom": "anket projesi 'Anket Doldur' sayfası (anket-public/anket-doldur), 2026-08-19; 4 soru tipi (single_choice / multi_choice / yes_no / free_text) tek gönderimde uçtan uca doğrulandı",
+    "pairsWith": "page-form-upsert (alanları tasarım anında bilinen klasik form)"
+  },
+  "_rules": {
+    "order": "Kuruluş sırası bağlayıcı: page_create → page_schema_patch (tüm add_component) → page_schema_patch (tüm set_binding) → TÜM flow_create'ler → TEK page_schema_patch (bütün set_event'ler). Sayfada bağlı akış varken yeni akış eklenemez.",
+    "template": "Repeater'ın children ağacı ŞABLONDUR; rows dizisindeki her satır için yinelenir. Satır bağlamı çocuklara item (eşanlamlısı Row, sırası RowIndex) olarak iner ve iç içe HER seviyeye taşınır.",
+    "twoWayBinding": "Çocuk komponentin prop'u {type:'code', ref:'{{ item.<alan> }}'} kalıbına TAM uyuyorsa kullanıcı değiştirdiğinde runtime değeri rows.data[<index>].<alan>'a geri yazar (repeater.handler.ts → handleRepeaterItemPropertySet). Flow gerekmez. Kalıp bozulursa ('{{ item.answer || \"\" }}') okur ama YAZMAZ.",
+    "rowId": "Satırlara kalıcı bir id ver: getRepeaterRowId sırayla row._id / row.id / index'e bakar; id yoksa index'e düşer ve liste değişince girilen değerler kayar.",
+    "variantsSameCell": "Satır tipine göre farklı alan göstermek için TÜM varyantları AYNI blocks[].position'a koy ve isHidden ile ayır — alt alta dizersen gizli olanların ızgara satırları boş kalır. Bu yalnız page_schema_patch yolunda güvenlidir (micro-op hattı çakışma normalizasyonu uygulamaz).",
+    "isHiddenGap": "isHidden her komponentte YOK (radio/textarea/container/form/button var; text ve multi-select yok). Gizlenecek komponenti isHidden'ı olan bir container'a sar ve koşulu SARMALAYICIYA bağla. Sarmalayıcı states.isWrapper:false olmalı (isWrapper → min-height:80vh).",
+    "readBack": "Toplu okuma flow'da <repeaterAdı>.rows'tur; microservice parametresinin value.type:'code' ifadesinde ve condition expression'ında komponentlere ADIYLA erişilir. Kod bağlamında satırlar HAM gelir; machine.getNode ile bakarsan {data,type} sarılı görünür.",
+    "perRowValidation": "Satır BAŞINA validation kurulamaz — validations komponentin kendisindedir ve tüm satırlar paylaşır. Zorunluluğu satır verisinde taşı (required) ve gönderim akışının ilk condition adımında denetle (guard adımı).",
+    "flowGuids": "branches[].id ve iteratees[].id GUID'leri TÜM projede tekildir. Başka bir akıştan kopyaladığın gövdeyi aynı GUID'lerle gönderirsen platform RowAlreadyExists döner ve hata slug çakışması gibi okunur — bütün id alanlarını yenile.",
+    "rebuildBreaksFlows": "Bir düğümü remove_component + add_component ile (aynı elementId ile bile) yeniden kurarsan DesignComponentId değişir ve o düğümü hedefleyen setter'lar sessizce ölür. Etkilenen her akışı flow_update ile yeniden kaydet.",
+    "submitTrigger": "Gönderimi ya btn_submit.click'e ya q_form.submit'e bağla — İKİSİNİ BİRDEN kurma (buton type:'submit' + formId iken click akışı da varsa gönderim iki kez tetiklenir).",
+    "storage": "Gönderimi tek TEXT kolonda anlık görüntü olarak sakla: yazarken JSON.stringify, okurken platform JSON'a benzeyen TEXT'i kendisi nesneye çevirir. Studio tablosunda [object Object] görünmesi NORMALDİR, veri sağlamdır (platform_guide('entity') → 'TEXT kolonunda JSON')."
+  },
+  "schemaShape": {
+    "_note": "Ağaç. Komponent gövdelerinin tam şekli Kural 1'de, style blokları Kural 1h-3'te. Üç varyantın da position'ı y:2 — aynı hücre.",
+    "tree": [
+      "page_container (container, isWrapper:true — tema değişkenleri ve ortalanmış sütun BURADA)",
+      "├─ t_title (text, h1)",
+      "├─ t_desc  (text, p)",
+      "├─ q_form (form, isWrapper:false, hideBorders+hidePadding)",
+      "│  └─ q_list (repeater, isWrapper:false, rows:[], autoRowSize:true, verticalSpacing:14)",
+      "│     └─ q_card (container, isWrapper:false)            ← ŞABLONUN KÖKÜ",
+      "│        ├─ q_head (text)      y:0   content: {{ item.no + '. ' + item.text + (item.required ? ' *' : '') }}",
+      "│        ├─ q_help (text)      y:1   content: {{ item.help || '' }}",
+      "│        ├─ a_choice (radio)   y:2   isHidden: {{ !(item.is_single || item.is_yesno) }}",
+      "│        ├─ a_text (textarea)  y:2   isHidden: {{ !item.is_text }}",
+      "│        └─ box_multi (container) y:2  isHidden: {{ !item.is_multi }}",
+      "│           └─ a_multi (multi-select)  ← kendi isHidden'ı yok, o yüzden sarmalı",
+      "├─ box_state (container, isHidden:true) → t_state (text)   ← hata şeridi",
+      "└─ btn_submit (button, type:'button')"
+    ]
+  },
+  "bindingPatchOps": [
+    { "op": "set_binding", "target": "q_head", "prop": "content", "expression": "{{ item.no + '. ' + item.text + (item.required ? ' *' : '') }}" },
+    { "op": "set_binding", "target": "q_help", "prop": "content", "expression": "{{ item.help || '' }}" },
+    { "op": "set_binding", "target": "a_choice", "prop": "options", "expression": "{{ item.options }}" },
+    { "op": "set_binding", "target": "a_choice", "prop": "value", "expression": "{{ item.answer }}", "_note": "GERİ YAZAN bağ — kalıp tam olarak {{ item.<alan> }} olmalı" },
+    { "op": "set_binding", "target": "a_choice", "prop": "isHidden", "expression": "{{ !(item.is_single || item.is_yesno) }}" },
+    { "op": "set_binding", "target": "a_text", "prop": "value", "expression": "{{ item.answer }}" },
+    { "op": "set_binding", "target": "a_text", "prop": "isHidden", "expression": "{{ !item.is_text }}" },
+    { "op": "set_binding", "target": "box_multi", "prop": "isHidden", "expression": "{{ !item.is_multi }}", "_note": "koşul SARMALAYICIDA — multi-select'te isHidden prop'u yok" },
+    { "op": "set_binding", "target": "a_multi", "prop": "options", "expression": "{{ item.options }}" },
+    { "op": "set_binding", "target": "a_multi", "prop": "value", "expression": "{{ item.answer }}" }
+  ],
+  "rowShape": {
+    "_note": "Yükleme akışının repeater'a yazdığı satır şekli. is_* bayrakları isHidden ifadelerini kısa tutar; answer iki yönlü bağın hedefidir ve tipe göre '' ya da [] başlar. options {label,value} olarak ÖNCEDEN hazırlanır — radio da multi-select de bu iki alanı okur.",
+    "id": "<soru id — kalıcı>",
+    "no": 1,
+    "text": "Hizmetimizden genel memnuniyetiniz nedir?",
+    "help": "Son 3 aydaki deneyiminizi düşünün",
+    "required": true,
+    "kind": "single_choice",
+    "is_single": true,
+    "is_multi": false,
+    "is_text": false,
+    "is_yesno": false,
+    "options": [{ "label": "Çok memnunum", "value": "<seçenek id>" }],
+    "answer": ""
+  },
+  "loadFlowCreateArgs": {
+    "host": "page",
+    "hostId": "<page id>",
+    "name": "Formu yukle",
+    "slug": "formu-yukle",
+    "_note": "page_container.mount'a bağlanır. condition adımı `always` dalını kural dallarıyla BİRLİKTE taşır: always yükleniyor bayrağını her koşumda kapatır, kural dalları içeriği kurar.",
+    "steps": [
+      {
+        "stepId": "start", "name": "start", "type": "start", "kind": "normal",
+        "args": { "iteratees": [], "rules": [], "parameters": [] },
+        "branches": [{ "id": "<GUID-1>", "name": "always", "nextStepId": "begin_loading" }]
+      },
+      {
+        "stepId": "begin_loading", "name": "begin_loading", "type": "setter", "kind": "normal",
+        "args": { "rules": [], "parameters": [], "iteratees": [
+          { "id": "<GUID-2>", "type": "change", "source": "component", "element": "page_container", "property": "isLoading",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": true } } ] },
+        "branches": [{ "id": "<GUID-3>", "name": "always", "nextStepId": "load" }]
+      },
+      {
+        "stepId": "load", "name": "load", "type": "microservice", "kind": "normal",
+        "args": { "microserviceId": "<tanım ucu id>", "slug": "<uç slug>", "httpMethod": "post", "isRaw": false, "iteratees": [], "rules": [],
+          "parameters": [ { "id": "<GUID-4>", "name": "slug", "type": "string", "source": "body",
+            "value": { "type": "code", "ref": "Page.queryParams.s || '<varsayılan>'" } } ] },
+        "branches": [{ "id": "<GUID-5>", "name": "always", "nextStepId": "check" }]
+      },
+      {
+        "stepId": "check", "name": "check", "type": "condition", "kind": "normal",
+        "args": { "iteratees": [], "parameters": [], "rules": [
+          { "id": "<RULE-OK>", "expression": "!!(Steps.load && Steps.load.data && Steps.load.data.ok)", "type": "if" },
+          { "id": "<RULE-NO>", "expression": "", "type": "else" } ] },
+        "branches": [
+          { "id": "<GUID-6>", "name": "always", "nextStepId": "end_loading" },
+          { "id": "<GUID-7>", "name": "<RULE-OK>", "nextStepId": "apply" },
+          { "id": "<GUID-8>", "name": "<RULE-NO>", "nextStepId": "not_found" } ]
+      },
+      {
+        "stepId": "apply", "name": "apply", "type": "setter", "kind": "normal",
+        "_note": "Deseni taşıyan adım: uç yanıtını rowShape'e çevirip repeater'a yazar. yes/no seçenekleri burada enjekte edilir — o soru tipinin veritabanında seçeneği yoktur.",
+        "args": { "rules": [], "parameters": [], "iteratees": [
+          { "id": "<GUID-9>", "type": "change", "source": "component", "element": "t_title", "property": "content",
+            "mapping": { "source": "", "mappings": {} },
+            "value": { "type": "code", "ref": "(Steps.load && Steps.load.data && Steps.load.data.title) || ''" } },
+          { "id": "<GUID-10>", "type": "change", "source": "component", "element": "t_desc", "property": "content",
+            "mapping": { "source": "", "mappings": {} },
+            "value": { "type": "code", "ref": "(Steps.load && Steps.load.data && Steps.load.data.description) || ''" } },
+          { "id": "<GUID-11>", "type": "change", "source": "component", "element": "q_list", "property": "rows",
+            "mapping": { "source": "", "mappings": {} },
+            "value": { "type": "code", "ref": "(function(){ var d = (Steps.load && Steps.load.data) || {}; var qs = d.questions || []; var os = d.options || []; return qs.map(function(q, i){ var t = q.question_type; var opts = os.filter(function(o){ var oq = (o.survey_question_id && o.survey_question_id.id) ? o.survey_question_id.id : o.survey_question_id; return oq === q.id; }).map(function(o){ return { label: o.label, value: o.id }; }); if (t === 'yes_no') { opts = [{ label: 'Evet', value: 'yes' }, { label: 'Hayır', value: 'no' }]; } return { id: q.id, no: i + 1, text: q.text, help: q.help_text || '', required: !!q.is_required, kind: t, is_single: t === 'single_choice', is_multi: t === 'multi_choice', is_text: t === 'free_text', is_yesno: t === 'yes_no', options: opts, answer: (t === 'multi_choice' ? [] : '') }; }); })()" } } ] },
+        "branches": [{ "id": "<GUID-12>", "name": "always", "nextStepId": null }]
+      },
+      {
+        "stepId": "not_found", "name": "not_found", "type": "setter", "kind": "normal",
+        "args": { "rules": [], "parameters": [], "iteratees": [
+          { "id": "<GUID-13>", "type": "change", "source": "component", "element": "t_title", "property": "content",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": "Bulunamadı" } },
+          { "id": "<GUID-14>", "type": "change", "source": "component", "element": "t_state", "property": "content",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": "Bu bağlantıya ait yayında bir kayıt yok." } },
+          { "id": "<GUID-15>", "type": "change", "source": "component", "element": "box_state", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": false } },
+          { "id": "<GUID-16>", "type": "change", "source": "component", "element": "q_form", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": true } },
+          { "id": "<GUID-17>", "type": "change", "source": "component", "element": "btn_submit", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": true } } ] },
+        "branches": [{ "id": "<GUID-18>", "name": "always", "nextStepId": null }]
+      },
+      {
+        "stepId": "end_loading", "name": "end_loading", "type": "setter", "kind": "normal",
+        "args": { "rules": [], "parameters": [], "iteratees": [
+          { "id": "<GUID-19>", "type": "change", "source": "component", "element": "page_container", "property": "isLoading",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": false } } ] },
+        "branches": [{ "id": "<GUID-20>", "name": "always", "nextStepId": null }]
+      }
+    ]
+  },
+  "submitFlowCreateArgs": {
+    "host": "page",
+    "hostId": "<page id>",
+    "name": "Formu gonder",
+    "slug": "formu-gonder",
+    "_note": "btn_submit.click'e bağlanır. guard adımında `always` dalı YOKTUR — uyarı dalıyla gönderim dalı birbirini dışlar; always olsaydı eksik formda da gönderim koşardı.",
+    "steps": [
+      {
+        "stepId": "start", "name": "start", "type": "start", "kind": "normal",
+        "args": { "iteratees": [], "rules": [], "parameters": [] },
+        "branches": [{ "id": "<GUID-1>", "name": "always", "nextStepId": "guard" }]
+      },
+      {
+        "stepId": "guard", "name": "guard", "type": "condition", "kind": "normal",
+        "_note": "Satır başına validation kurulamadığı için zorunluluk BURADA denetlenir. Boşluk tanımı tipe göre değişir: metin '' , çoklu seçim [].",
+        "args": { "iteratees": [], "parameters": [], "rules": [
+          { "id": "<RULE-MISSING>", "expression": "((q_list.rows || []).filter(function(r){ var v = r.answer; return r.required && (v === undefined || v === null || v === '' || (Array.isArray(v) && v.length === 0)); }).length > 0)", "type": "if" },
+          { "id": "<RULE-OK>", "expression": "", "type": "else" } ] },
+        "branches": [
+          { "id": "<GUID-2>", "name": "<RULE-MISSING>", "nextStepId": "warn" },
+          { "id": "<GUID-3>", "name": "<RULE-OK>", "nextStepId": "busy" } ]
+      },
+      {
+        "stepId": "warn", "name": "warn", "type": "setter", "kind": "normal",
+        "args": { "rules": [], "parameters": [], "iteratees": [
+          { "id": "<GUID-4>", "type": "change", "source": "component", "element": "t_state", "property": "content",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": "Lütfen yıldızlı (*) soruların hepsini yanıtlayın." } },
+          { "id": "<GUID-5>", "type": "change", "source": "component", "element": "box_state", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": false } } ] },
+        "branches": [{ "id": "<GUID-6>", "name": "always", "nextStepId": null }]
+      },
+      {
+        "stepId": "busy", "name": "busy", "type": "setter", "kind": "normal",
+        "args": { "rules": [], "parameters": [], "iteratees": [
+          { "id": "<GUID-7>", "type": "change", "source": "component", "element": "box_state", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": true } },
+          { "id": "<GUID-8>", "type": "change", "source": "component", "element": "btn_submit", "property": "isLoading",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": true } } ] },
+        "branches": [{ "id": "<GUID-9>", "name": "always", "nextStepId": "post" }]
+      },
+      {
+        "stepId": "post", "name": "post", "type": "microservice", "kind": "normal",
+        "_note": "answers_json TEXT alandır: JSON.stringify ile STRING gönder. option_ids + value_text birlikte tutulur — id'ler raporlamayı, etiketler insan okumasını taşır; etiketler satırdaki options'tan çözülür, ikinci bir uç çağrısı gerekmez.",
+        "args": { "microserviceId": "<yazma ucu id>", "slug": "<uç slug>", "httpMethod": "post", "isRaw": false, "iteratees": [], "rules": [],
+          "parameters": [
+            { "id": "<GUID-10>", "name": "submitted_at", "type": "string", "source": "body",
+              "value": { "type": "code", "ref": "new Date().toISOString()" } },
+            { "id": "<GUID-11>", "name": "answers_json", "type": "string", "source": "body",
+              "value": { "type": "code", "ref": "JSON.stringify((q_list.rows || []).map(function(r){ var v = r.answer; var vals = Array.isArray(v) ? v.map(function(x){ return (x && x.value !== undefined) ? x.value : x; }) : ((v === '' || v === undefined || v === null) ? [] : [v]); var labels = (r.options || []).filter(function(o){ return vals.indexOf(o.value) >= 0; }).map(function(o){ return o.label; }); return { question_id: r.id, question_text: r.text, type: r.kind, value_text: r.is_text ? (v || '') : labels.join(', '), option_ids: r.is_text ? [] : vals }; }))" } } ] },
+        "branches": [{ "id": "<GUID-12>", "name": "always", "nextStepId": "done" }]
+      },
+      {
+        "stepId": "done", "name": "done", "type": "setter", "kind": "normal",
+        "args": { "rules": [], "parameters": [], "iteratees": [
+          { "id": "<GUID-13>", "type": "change", "source": "component", "element": "t_title", "property": "content",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": "Teşekkürler!" } },
+          { "id": "<GUID-14>", "type": "change", "source": "component", "element": "t_desc", "property": "content",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": "Yanıtınız kaydedildi." } },
+          { "id": "<GUID-15>", "type": "change", "source": "component", "element": "q_form", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": true } },
+          { "id": "<GUID-16>", "type": "change", "source": "component", "element": "btn_submit", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": true } },
+          { "id": "<GUID-17>", "type": "change", "source": "component", "element": "btn_submit", "property": "isLoading",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": false } } ] },
+        "branches": [{ "id": "<GUID-18>", "name": "always", "nextStepId": null }]
+      }
+    ]
+  },
+  "eventPatchOps": [
+    { "op": "set_event", "target": "page_container", "event": "mount", "eventValue": "<load flow id>" },
+    { "op": "set_event", "target": "btn_submit", "event": "click", "eventValue": "<submit flow id>" }
+  ],
+  "verification": {
+    "render": "page_runtime_get ile paketi doğrula. Tarayıcı ölçümü (1280×720): gövde 1292px, kartlar 680px genişlik / 14px ara, seçenek satırları 46px, buton 48px, boşluk-çakışma yok; 375px'te yatay taşma yok.",
+    "binding": "Bir girdiyi değiştir, sonra machine.getNode('q_list').props.rows.data[i].answer'a bak — dolmuyorsa kod prop'unun ref'i {{ item.<alan> }} kalıbından sapmıştır.",
+    "guard": "Zorunlu alanlar boşken butona bas: kırmızı şerit çıkmalı ve HİÇBİR uç çağrılmamalı.",
+    "submit": "Gönderim sonrası satırı row_list ile oku (grid'de [object Object] görünmesi beklenen davranıştır)."
+  }
+}