@appaflytech/zeyrek-ai-mcp 0.0.1

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

@@ -0,0 +1,279 @@
+{
+  "_meta": {
+    "synthetic": false,
+    "note": "Kayıt yönetim sayfası: AYNI sayfa hem create hem edit yapar, ayrım ?id= query parametresidir. İki akış taşır — form/mount (kipi kur, edit ise kaydı yükle) ve form/submit (upsert + geri bildirim + yönlendirme). Adlar jenerikleştirildi.",
+    "harvestedFrom": "qm projesi '[SY] Departman' sayfası (form7f9a-mount + form-submit akışları), 2026-08-17; ayrıntı: zeyrek-mcp/docs/18-sayfa-arketipleri.md §1",
+    "pairsWith": "flow-list-to-form (liste sayfasından buraya geçiş)"
+  },
+  "_rules": {
+    "modeSwitch": "Create ve edit AYRI sayfa değildir. Kip `Page.queryParams.id` ile ayrılır: liste sayfası kaydı '?id=<kayıt>' ile açar, 'Yeni' butonu parametresiz açar. mount akışı buna göre buton metnini, breadcrumb başlığını ve audit kutusunun görünürlüğünü kurar.",
+    "conditionAlways": "Condition adımı `always` dalını kural dallarıyla BİRLİKTE taşır: always her koşumda çalışır (yükleniyor bayrağını kapatmanın yolu budur), kural dalları (branch.name = rule id) eşleşmeye göre. rules: [{id, expression, type:'if'}, {id, expression:'', type:'else'}].",
+    "fillFromStorage": "Alanları doldururken value {type:'storage', ref:'<adım ADI>.data.<alan>'} — stepId değil adım ADI. İlişki alanında dropdown'a etiket değil `.id` yazılır (…data.manager.id). audit-basic tek prop'ta beslenir: …data.meta (uç meta.createdAt/createdUserFullName/… döndürür).",
+    "propertyToBody": "Form alanlarını uca geçirme: parameters[] içinde {name, type, source:'body', value:{type:'property', ref:{source:'component', element:'<elementId>', property:'value'}}}. Kayıt anahtarı ise source:'query-string' + {type:'code', ref:'Page.queryParams.id'}.",
+    "upsert": "Tek POST ucu hem create hem update yapar (id geldiyse günceller). Entity başına iki uç yazmaya gerek yoktur; uç tarafı için platform_guide('microservice').",
+    "errorBranch": "Hata yolunu errorSteps ile kurma: errorSteps doluysa ANA akışın kalan adımları hiç çalışmaz ve yükleniyor bayrağı açık kalır. Doğrusu `condition Steps.<adımAdı>.error`.",
+    "feedback": "Geri bildirim `notification` komponentiyle verilir (kind: 'success' | 'error', header, content, isHidden:false, timeout), `alert` adımıyla değil — kullanıcı sayfada kalır ve kaydı görür.",
+    "validation": "Input'ların `validations` sözlüğü component_get'ten okunur (required/minLength/maxLength/pattern). form.errorElementId sayfadaki 'form-validation-errors' komponentinin elementId'sine bağlanır; hatalar orada listelenir.",
+    "sizes": "blocks[].size katalogdaki maxSize'ı aşamaz (textinput default h:8 iken maxSize.h:5). Gateway aşan değeri kırpar ve gatewayNormalized ile bildirir."
+  },
+  "pageCreateArgs": {
+    "name": "Departman",
+    "slug": "departman",
+    "browserTitle": "Departman",
+    "layoutId": "<layout id>",
+    "middlewareIds": ["<auth middleware id — korumalı kayıtta>"]
+  },
+  "schemaPatchOps": [
+    {
+      "op": "add_component",
+      "parent": "page_container",
+      "component": {
+        "elementId": "record_notification", "kind": "component", "type": "notification", "name": "record_notification",
+        "props": { "isHidden": { "type": "static", "data": true } },
+        "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 4, "w": 12 }, "position": { "x": 0, "y": 0 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "page_container",
+      "component": {
+        "elementId": "record_form", "kind": "component", "type": "form", "name": "record_form",
+        "props": {
+          "title": { "type": "static", "data": "Departman bilgileri" },
+          "errorElementId": { "type": "static", "data": "record_errors" }
+        },
+        "states": { "isSticky": false, "isDroppable": true, "isScrollable": false, "isWrapper": true },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 24, "w": 12 }, "position": { "x": 0, "y": 4 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "record_form",
+      "component": {
+        "elementId": "record_errors", "kind": "component", "type": "form-validation-errors", "name": "record_errors",
+        "props": {},
+        "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 4, "w": 12 }, "position": { "x": 0, "y": 0 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "record_form",
+      "component": {
+        "elementId": "in_name", "kind": "component", "type": "textinput", "name": "in_name",
+        "props": { "label": { "type": "static", "data": "Ad" }, "placeholder": { "type": "static", "data": "Departman adı" } },
+        "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 5, "w": 6 }, "position": { "x": 0, "y": 4 } }],
+        "children": [], "events": [],
+        "validations": [{ "name": "required", "value": true, "message": "Ad zorunludur." }],
+        "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "record_form",
+      "component": {
+        "elementId": "in_manager", "kind": "component", "type": "dropdown", "name": "in_manager",
+        "props": { "label": { "type": "static", "data": "Yönetici" } },
+        "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 5, "w": 6 }, "position": { "x": 6, "y": 4 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "page_container",
+      "component": {
+        "elementId": "btn_save", "kind": "component", "type": "button", "name": "btn_save",
+        "props": { "text": { "type": "static", "data": "Kaydet" } },
+        "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 4, "w": 3 }, "position": { "x": 0, "y": 28 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    { "op": "set_event", "target": "record_form", "event": "mount", "eventValue": "<mount flow id>" },
+    { "op": "set_event", "target": "record_form", "event": "submit", "eventValue": "<submit flow id>" }
+  ],
+  "mountFlowCreateArgs": {
+    "host": "page",
+    "hostId": "<page id>",
+    "name": "record_form - mount",
+    "slug": "record-form-mount",
+    "steps": [
+      {
+        "stepId": "start", "name": "start", "type": "start", "kind": "normal", "args": {},
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "begin_loading" }]
+      },
+      {
+        "stepId": "begin_loading", "name": "begin_loading", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [{
+          "id": "<GUID>", "type": "change", "source": "component",
+          "element": "page_container", "property": "isLoading",
+          "mapping": { "source": "", "mappings": {} },
+          "value": { "type": "static", "ref": true } }] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "is_edit" }]
+      },
+      {
+        "stepId": "is_edit", "name": "is_edit", "type": "condition", "kind": "normal",
+        "args": { "iteratees": [], "parameters": [], "rules": [
+          { "id": "<RULE-EDIT>", "expression": "Page.queryParams.id !== undefined", "type": "if" },
+          { "id": "<RULE-CREATE>", "expression": "", "type": "else" }
+        ] },
+        "branches": [
+          { "id": "<GUID>", "name": "always", "nextStepId": "end_loading" },
+          { "id": "<GUID>", "name": "<RULE-EDIT>", "nextStepId": "edit_labels" },
+          { "id": "<GUID>", "name": "<RULE-CREATE>", "nextStepId": "create_labels" }
+        ]
+      },
+      {
+        "stepId": "edit_labels", "name": "edit_labels", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "btn_save", "property": "text",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": "Değişiklikleri kaydet" } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "audit_box", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": false } }
+        ] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "get_record" }]
+      },
+      {
+        "stepId": "get_record", "name": "get_record", "type": "microservice", "kind": "normal",
+        "args": {
+          "microserviceId": "<tekil kayıt ucu id>", "isRaw": false,
+          "parameters": [{ "id": "<GUID>", "name": "id", "type": "number", "source": "query-string",
+            "value": { "type": "code", "ref": "Page.queryParams.id" } }]
+        },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "fill_form" }]
+      },
+      {
+        "stepId": "fill_form", "name": "fill_form", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "in_name", "property": "value",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "storage", "ref": "get_record.data.name" } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "in_manager", "property": "value",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "storage", "ref": "get_record.data.manager.id" } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "audit_box", "property": "meta",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "storage", "ref": "get_record.data.meta" } }
+        ] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      },
+      {
+        "stepId": "create_labels", "name": "create_labels", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "btn_save", "property": "text",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": "Oluştur" } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "audit_box", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": true } }
+        ] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      },
+      {
+        "stepId": "end_loading", "name": "end_loading", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [{
+          "id": "<GUID>", "type": "change", "source": "component",
+          "element": "page_container", "property": "isLoading",
+          "mapping": { "source": "", "mappings": {} },
+          "value": { "type": "static", "ref": false } }] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      }
+    ]
+  },
+  "submitFlowCreateArgs": {
+    "host": "page",
+    "hostId": "<page id>",
+    "name": "record_form - submit",
+    "slug": "record-form-submit",
+    "steps": [
+      {
+        "stepId": "start", "name": "start", "type": "start", "kind": "normal", "args": {},
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "begin_saving" }]
+      },
+      {
+        "stepId": "begin_saving", "name": "begin_saving", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [{
+          "id": "<GUID>", "type": "change", "source": "component", "element": "btn_save", "property": "isLoading",
+          "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": true } }] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "upsert_record" }]
+      },
+      {
+        "stepId": "upsert_record", "name": "upsert_record", "type": "microservice", "kind": "normal",
+        "args": {
+          "microserviceId": "<upsert ucu id>", "isRaw": false,
+          "parameters": [
+            { "id": "<GUID>", "name": "id", "type": "number", "source": "query-string",
+              "value": { "type": "code", "ref": "Page.queryParams.id" } },
+            { "id": "<GUID>", "name": "name", "type": "string", "source": "body",
+              "value": { "type": "property", "ref": { "source": "component", "element": "in_name", "property": "value" } } },
+            { "id": "<GUID>", "name": "manager", "type": "guid", "source": "body",
+              "value": { "type": "property", "ref": { "source": "component", "element": "in_manager", "property": "value" } } }
+          ]
+        },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "has_error" }]
+      },
+      {
+        "stepId": "has_error", "name": "has_error", "type": "condition", "kind": "normal",
+        "args": { "iteratees": [], "parameters": [], "rules": [
+          { "id": "<RULE-ERROR>", "expression": "Steps.upsert_record.error", "type": "if" },
+          { "id": "<RULE-OK>", "expression": "", "type": "else" }
+        ] },
+        "branches": [
+          { "id": "<GUID>", "name": "always", "nextStepId": "end_saving" },
+          { "id": "<GUID>", "name": "<RULE-ERROR>", "nextStepId": "show_error" },
+          { "id": "<GUID>", "name": "<RULE-OK>", "nextStepId": "was_edit" }
+        ]
+      },
+      {
+        "stepId": "show_error", "name": "show_error", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "record_notification", "property": "kind",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": "error" } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "record_notification", "property": "content",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": "Kayıt sırasında bir hata oluştu. Bilgileri kontrol edip yeniden deneyin." } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "record_notification", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": false } }
+        ] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      },
+      {
+        "stepId": "was_edit", "name": "was_edit", "type": "condition", "kind": "normal",
+        "args": { "iteratees": [], "parameters": [], "rules": [
+          { "id": "<RULE-EDIT>", "expression": "Page.queryParams.id", "type": "if" },
+          { "id": "<RULE-CREATE>", "expression": "", "type": "else" }
+        ] },
+        "branches": [
+          { "id": "<GUID>", "name": "<RULE-EDIT>", "nextStepId": "show_success" },
+          { "id": "<GUID>", "name": "<RULE-CREATE>", "nextStepId": "go_list" }
+        ]
+      },
+      {
+        "stepId": "show_success", "name": "show_success", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "record_notification", "property": "kind",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": "success" } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "record_notification", "property": "content",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": "Kayıt güncellendi." } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "record_notification", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": false } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "record_notification", "property": "timeout",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": 7000 } }
+        ] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      },
+      {
+        "stepId": "go_list", "name": "go_list", "type": "redirect", "kind": "normal",
+        "args": { "pageId": "<liste sayfası id>", "path": "departmanlar", "query": "" },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      },
+      {
+        "stepId": "end_saving", "name": "end_saving", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [{
+          "id": "<GUID>", "type": "change", "source": "component", "element": "btn_save", "property": "isLoading",
+          "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": false } }] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      }
+    ]
+  }
+}

package/dist/resources/examples/page-html-embed.json

@@ -0,0 +1,106 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "HTML kaçış kapısı örneği: hazır komponentlerin karşılamadığı özel bir gösterim (durum panosu) html komponentiyle kurulur. Üç köprü birden görünür: Mustache + context ile veri basma (flow'dan HTML'e), actions + fireEvent ile flow tetikleme (HTML'den flow'a), loadScript/onCleanup ile harici kütüphane ve temizlik.",
+    "pairsWith": "flow-load-table (veri çekme deseni), page-detail-profile (sayfa iskeleti)",
+    "sourceRef": "NgApps.UI/packages/ng-apps-ui/src/components/html/* ; rehber: platform_guide('html')"
+  },
+  "_rules": {
+    "mustacheContext": "content '{{' içeriyorsa context prop'uyla Mustache olarak render edilir; setter adımı context'e yazınca içerik otomatik yeniden render olur. Veriyi script'te fetch'leme — akışta topla, context'e yaz.",
+    "actionsNotSetEvent": "Aksiyonlar set_event ile BAĞLANMAZ: her actions satırı akışını kendi flow prop'unda taşır (type:'flow', ref:<flowId>). Şema olayı yalnız mount'tur.",
+    "fireEventContract": "HTML içinden fireEvent('<key>', data) çağrısı key'i eşleşen aksiyonun akışını çalıştırır; akışta event.name = key, event.data = data.",
+    "scriptRules": "Satır içi script çalışır ve içerik değiştikçe yeniden çalışır; <script src> yüklenmez — harici kütüphane loadScript(url) ile, temizlik onCleanup(fn) ile. Script'ler Page/Steps bağlamına erişemez.",
+    "styleScope": "style prop'u emotion css() bloğudur: iç seçiciler çalışır, sınıf komponente scope'ludur."
+  },
+  "schemaPatchOps": [
+    {
+      "op": "add_component",
+      "parent": "page_container",
+      "component": {
+        "elementId": "durum_panosu",
+        "kind": "component",
+        "type": "html",
+        "name": "durum_panosu",
+        "props": {
+          "content": {
+            "type": "static",
+            "data": "<div class=\"pano\">{{#kuyruklar}}<div class=\"pano__kart\" onclick=\"fireEvent('kuyruk_ac', { slug: '{{slug}}' })\"><b>{{ad}}</b><span>{{bekleyen}} bekleyen</span></div>{{/kuyruklar}}<button onclick=\"fireEvent('yenile')\">Yenile</button></div><script>const zamanlayici = setInterval(() => fireEvent('yenile'), 60000); onCleanup(() => clearInterval(zamanlayici));</script>"
+          },
+          "context": { "type": "static", "data": { "kuyruklar": { "type": "static", "data": [] } } },
+          "style": {
+            "type": "static",
+            "data": ".pano { display: flex; gap: 12px; } .pano__kart { cursor: pointer; padding: 12px; border-radius: 8px; background: #f4f4f4; } .pano__kart:hover { background: #e8e8e8; }"
+          },
+          "actions": {
+            "type": "static",
+            "data": [
+              {
+                "key": { "type": "static", "data": "yenile" },
+                "text": { "type": "static", "data": "Yenile" },
+                "flow": { "type": "flow", "ref": "<panoyu dolduran flow id>" }
+              },
+              {
+                "key": { "type": "static", "data": "kuyruk_ac" },
+                "text": { "type": "static", "data": "Kuyruk aç" },
+                "flow": { "type": "flow", "ref": "<detaya giden flow id>" }
+              }
+            ]
+          }
+        },
+        "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 12, "w": 12 }, "position": { "x": 0, "y": 0 } }],
+        "children": [],
+        "events": [],
+        "validations": [],
+        "stateBindings": []
+      }
+    }
+  ],
+  "flows": [
+    {
+      "name": "Panoyu doldur",
+      "slug": "panoyu-doldur",
+      "note": "actions[0].flow buna işaret eder; ayrıca page_container.mount'a set_event ile bağlanır (ilk yükleme).",
+      "steps": [
+        {
+          "stepId": "start", "name": "Start", "type": "start", "kind": "normal", "args": {},
+          "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "kuyruklari_getir" }]
+        },
+        {
+          "stepId": "kuyruklari_getir", "name": "kuyruklari_getir", "type": "microservice", "kind": "normal",
+          "args": { "microserviceId": "<kuyruk özet ucu>", "isRaw": false, "parameters": [] },
+          "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "panoya_yaz" }]
+        },
+        {
+          "stepId": "panoya_yaz", "name": "panoya_yaz", "type": "setter", "kind": "normal",
+          "args": { "iteratees": [{
+            "id": "<GUID>",
+            "type": "change",
+            "element": "durum_panosu",
+            "property": "context",
+            "source": "component",
+            "mapping": { "source": "", "mappings": {} },
+            "value": { "type": "code", "ref": "({ kuyruklar: Array.isArray(Steps.kuyruklari_getir?.data) ? Steps.kuyruklari_getir.data : [] })" }
+          }] },
+          "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+        }
+      ]
+    },
+    {
+      "name": "Kuyruk detayına git",
+      "slug": "kuyruk-detayina-git",
+      "note": "actions[1].flow buna işaret eder; fireEvent yükü event.data'dan okunur.",
+      "steps": [
+        {
+          "stepId": "start", "name": "Start", "type": "start", "kind": "normal", "args": {},
+          "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "detaya_git" }]
+        },
+        {
+          "stepId": "detaya_git", "name": "detaya_git", "type": "redirect", "kind": "normal",
+          "args": { "pageId": "<kuyruk detay sayfası id>", "path": "kuyruk", "query": "`slug=${event.data.slug}`" },
+          "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+        }
+      ]
+    }
+  ]
+}

package/dist/resources/examples/page-sign-in.json

@@ -0,0 +1,194 @@
+{
+  "_meta": {
+    "synthetic": false,
+    "note": "Giriş sayfası: auth-layout + form(email/password/beni hatırla) → sign-in ucu → token cookie → yönlendirme. Kimlik middleware'i kuran her projede bu sayfa ZORUNLUDUR; yoksa sistem kullanılamaz (uçlar 401 döner, kullanıcı token üretemez).",
+    "harvestedFrom": "qm projesi 'Giriş Yap' sayfası (form-submit akışı), 2026-08-17; ayrıntı: zeyrek-mcp/docs/18-sayfa-arketipleri.md §3",
+    "pairsWith": "middleware-authenticate (token'ı okuyan guard)"
+  },
+  "_rules": {
+    "cookieNameContract": "setcookie'deki ad ile auth middleware'inin okuduğu ad BİREBİR aynı olmalı (burada APP_Token → middleware'de cookie.APP_Token). Uyuşmazlık 'her istek 401' olarak görünür ve teşhisi zordur.",
+    "signInEndpoint": "Sign-in ucu bir workflow'dur: kullanıcıyı e-postayla bulur, şifreyi karşılaştırır, system.generateToken({...claims}) ile token üretir. Claim anahtarları neyse middleware onları okur (claims.userId gibi) — token.data.id diye evrensel bir alan YOKTUR. Bkz. platform_guide('expressions') ve platform_guide('middleware') Tarif 1.",
+    "conditionAlways": "Token kontrolü condition ile yapılır; `always` dalı buton durumunu her koşumda sıfırlar, kural dalları başarı/hata yolunu ayırır.",
+    "rawRedirect": "redirect isRaw:true iken path ÇOK SATIRLI JS bloğudur ve son ifadenin değeri hedef adrestir. 'Korunan sayfaya gitmek isterken login'e düşen kullanıcıyı geri gönderme' deseni budur; yoksa sabit bir sayfaya gidilir (pageId + path).",
+    "objectProp": "Prop değeri nesne olabilir: icon → { type:'static', ref:{ name:'progress_activity' } }.",
+    "pageIsPublic": "Giriş sayfasına middlewareIds BAĞLANMAZ (guard'lı olsaydı kullanıcı giriş yapamazdı). Buna karşılık diğer sayfalar ve korunan uçlar middlewareIds ile bağlanır.",
+    "notificationIsHidden": "notification KATALOĞUNDA isHidden YOKTUR: şemaya props.isHidden yazmak 'unknown-prop' ile reddedilir (bu örneğin eski hâli öyleydi — crm koşumu B-10). Runtime'da gizleme her komponentte çalışır ama prop'u SETTER yazar. Başlangıçta gizli göstermek için komponenti isHidden'ı OLAN bir container'a (box_message) sar ve koşulu sarmalayıcıya bağla; appearance.isHidden bir çözüm DEĞİLDİR — runtime onu hiç okumaz.",
+    "validationShape": "Validation gövdesi DÖRT alan taşır: { type, message, value, isActive }. 'name' anahtarı JsonIgnore'dur — {name, value, message} yazarsan tip enum varsayılanına düşer ve alan sessizce REGEX doğrulamasına döner. Tip adları TİRELİDİR (max-length / min-length / max-value / min-value); 'maxLength' backend'e yazılır ama runtime doğrulayıcı onu tanımaz ve doğrulama hiç koşmaz. Gateway düzeltebildiğini düzeltir, kalanını PAGE-016 ile reddeder."
+  },
+  "pageCreateArgs": {
+    "name": "Giriş Yap",
+    "slug": "giris-yap",
+    "browserTitle": "Giriş Yap",
+    "middlewareIds": []
+  },
+  "schemaPatchOps": [
+    {
+      "op": "add_component",
+      "parent": "page_container",
+      "component": {
+        "elementId": "auth_layout", "kind": "component", "type": "auth-layout", "name": "auth_layout",
+        "props": {},
+        "states": { "isSticky": false, "isDroppable": true, "isScrollable": false, "isWrapper": true },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 80, "w": 12 }, "position": { "x": 0, "y": 0 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "auth_layout",
+      "component": {
+        "elementId": "box_message", "kind": "component", "type": "container", "name": "box_message",
+        "props": { "isHidden": { "type": "static", "data": true }, "layout": { "type": "static", "data": "flex" },
+                   "direction": { "type": "static", "data": "column" }, "size": { "type": "static", "data": "shrink" },
+                   "style": { "type": "static", "data": { "background": { "type": "static", "data": "transparent" },
+                                                          "border": { "type": "static", "data": "none" } } } },
+        "states": { "isSticky": false, "isDroppable": true, "isScrollable": false, "isWrapper": false },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 4, "w": 12 }, "position": { "x": 0, "y": 0 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "box_message",
+      "component": {
+        "elementId": "sign_in_message", "kind": "component", "type": "notification", "name": "sign_in_message",
+        "props": { "kind": { "type": "static", "data": "error" } },
+        "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 4, "w": 12 }, "position": { "x": 0, "y": 0 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "auth_layout",
+      "component": {
+        "elementId": "sign_in_form", "kind": "component", "type": "form", "name": "sign_in_form",
+        "props": { "title": { "type": "static", "data": "Giriş" }, "hideBorders": { "type": "static", "data": true } },
+        "states": { "isSticky": false, "isDroppable": true, "isScrollable": false, "isWrapper": true },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 24, "w": 12 }, "position": { "x": 0, "y": 4 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "sign_in_form",
+      "component": {
+        "elementId": "in_email", "kind": "component", "type": "textinput", "name": "in_email",
+        "props": { "label": { "type": "static", "data": "E-posta" } },
+        "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 5, "w": 12 }, "position": { "x": 0, "y": 0 } }],
+        "children": [], "events": [],
+        "validations": [{ "type": "required", "message": "E-posta zorunludur.", "value": true, "isActive": true },
+                        { "type": "email", "message": "Geçerli bir e-posta girin.", "value": true, "isActive": true },
+                        { "type": "max-length", "message": "En fazla 120 karakter.", "value": 120, "isActive": true }],
+        "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "sign_in_form",
+      "component": {
+        "elementId": "in_password", "kind": "component", "type": "password", "name": "in_password",
+        "props": { "label": { "type": "static", "data": "Şifre" } },
+        "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 5, "w": 12 }, "position": { "x": 0, "y": 5 } }],
+        "children": [], "events": [],
+        "validations": [{ "type": "required", "message": "Şifre zorunludur.", "value": true, "isActive": true },
+                        { "type": "min-length", "message": "En az 6 karakter.", "value": 6, "isActive": true }],
+        "stateBindings": []
+      }
+    },
+    {
+      "op": "add_component",
+      "parent": "sign_in_form",
+      "component": {
+        "elementId": "btn_sign_in", "kind": "component", "type": "button", "name": "btn_sign_in",
+        "props": { "text": { "type": "static", "data": "Giriş yap" } },
+        "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
+        "blocks": [{ "breakpoint": 1024, "size": { "h": 4, "w": 12 }, "position": { "x": 0, "y": 10 } }],
+        "children": [], "events": [], "validations": [], "stateBindings": []
+      }
+    },
+    { "op": "set_event", "target": "sign_in_form", "event": "submit", "eventValue": "<sign-in flow id>" }
+  ],
+  "submitFlowCreateArgs": {
+    "host": "page",
+    "hostId": "<giriş sayfası id>",
+    "name": "sign_in_form - submit",
+    "slug": "sign-in-form-submit",
+    "steps": [
+      {
+        "stepId": "start", "name": "start", "type": "start", "kind": "normal", "args": {},
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "begin" }]
+      },
+      {
+        "stepId": "begin", "name": "begin", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "btn_sign_in", "property": "isLoading",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": true } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "btn_sign_in", "property": "isDisabled",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": true } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "box_message", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": true } }
+        ] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "sign_in" }]
+      },
+      {
+        "stepId": "sign_in", "name": "sign_in", "type": "microservice", "kind": "normal",
+        "args": {
+          "microserviceId": "<sign-in ucu id>", "isRaw": false,
+          "parameters": [
+            { "id": "<GUID>", "name": "email", "type": "string", "source": "body",
+              "value": { "type": "property", "ref": { "source": "component", "element": "in_email", "property": "value" } } },
+            { "id": "<GUID>", "name": "password", "type": "string", "source": "body",
+              "value": { "type": "property", "ref": { "source": "component", "element": "in_password", "property": "value" } } }
+          ]
+        },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "has_token" }]
+      },
+      {
+        "stepId": "has_token", "name": "has_token", "type": "condition", "kind": "normal",
+        "args": { "iteratees": [], "parameters": [], "rules": [
+          { "id": "<RULE-OK>", "expression": "!!Steps.sign_in.data.token", "type": "if" },
+          { "id": "<RULE-FAIL>", "expression": "", "type": "else" }
+        ] },
+        "branches": [
+          { "id": "<GUID>", "name": "always", "nextStepId": "reset_button" },
+          { "id": "<GUID>", "name": "<RULE-OK>", "nextStepId": "store_token" },
+          { "id": "<GUID>", "name": "<RULE-FAIL>", "nextStepId": "show_error" }
+        ]
+      },
+      {
+        "stepId": "store_token", "name": "store_token", "type": "setcookie", "kind": "normal",
+        "args": { "name": "APP_Token", "value": "Steps.sign_in.data.token", "expiresInHours": 240 },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "go_home" }]
+      },
+      {
+        "stepId": "go_home", "name": "go_home", "type": "redirect", "kind": "normal",
+        "args": { "pageId": "<ana sayfa id>", "path": "anasayfa", "query": "" },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      },
+      {
+        "stepId": "show_error", "name": "show_error", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "sign_in_message", "property": "content",
+            "mapping": { "source": "", "mappings": {} },
+            "value": { "type": "code", "ref": "Steps.sign_in.data.message || 'E-posta veya şifre hatalı.'" } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "box_message", "property": "isHidden",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": false } }
+        ] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      },
+      {
+        "stepId": "reset_button", "name": "reset_button", "type": "setter", "kind": "normal",
+        "args": { "iteratees": [
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "btn_sign_in", "property": "isLoading",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": false } },
+          { "id": "<GUID>", "type": "change", "source": "component", "element": "btn_sign_in", "property": "isDisabled",
+            "mapping": { "source": "", "mappings": {} }, "value": { "type": "static", "ref": false } }
+        ] },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      }
+    ]
+  }
+}