@appaflytech/zeyrek-ai-mcp 0.0.48 → 0.0.50

package/dist/resources/examples/mobile-reorder-persist.json

@@ -0,0 +1,491 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Sırası kalıcı kaydedilen mobil liste: repeater tutamaçtan sürüklenir, reorder akışı event.data.patches'ı bulk-update ucuna TEK istekte kök dizi olarak yazar, ardından listeyi sıra alanına göre yeniden okur. mobiltest › siralama-kalici'de (lokal, 2026-10-27) uçta ölçülen sayfanın kimliksiz hâli: sürükleme → tek PUT 200, yeniden okunan satırlar yeni sırada. Sayfa mizanpaj sözleşmesine ve MOB-035'e uyar, akışlar mobil profilden ve kendi lint kurallarından bulgusuz geçer (test/mobile-rules.test.ts, test/mobile-layout-lint.test.ts).",
+    "pairsWith": "mobile-offline-list (aynı listenin okuma deseni), mobile-list-detail-form (satıra dokunma), mobile-app-shell-stack ya da mobile-app-shell-tab (kabuk)",
+    "sourceRef": "platform_guide('page') §Kural 1g-5; platform_guide('microservice') §Toplu yazma; MOB-035; zeyrek-frontend docs/adr/0029-akis-adiminda-kok-dizi-govde.md"
+  },
+  "_rules": {
+    "list": "repeater'a reorderable: true + orderField: '<sayı alanı>' yazılır; tutamaç her satırın sonunda çizilir. Yalnız dikey ve tek sütunlu listede çalışır — direction: 'horizontal' ya da columnCount > 1 MOB-035 uyarısıdır ve tutamaç çizilmez. Satırlar orderField'a göre çizilir; okuma ucunun sıralı dönmesi yine de yenilemede aynı sırayı garanti eder.",
+    "payload": "Bırakınca reorder yayılır: event.data = { fromIndex, toIndex, row, patches: [{ id, value }] }. patches yalnız sırası değişen satırlardır; id satırın _id'si (yoksa id), value orderField'a yazılacak 1 tabanlı yeni adım. Yerinde bırakılan sürükleme olay yaymaz; orderField yoksa ya da bir satırda anahtar yoksa patches BOŞ dizidir.",
+    "endpoint": "Yazma ucu tablo kaynaklı operation: 'bulk-update'; fields = birincil anahtar + sıra alanı, başka alan yok (tanımdaki alan gövdede yoksa NULL yazılır). Gövdede birincil anahtar zorunludur, WHERE'e taşınır. Tek istekte en fazla 1000 satır, parti hep-ya-hiç.",
+    "bodyKeys": "Gövde anahtarları alan slug'larıdır; fields[].name ile yeniden adlandırma yoktur. { id, value } yaması uca olduğu gibi gitmez: map ile { id, <orderField>: value }'ya eşlenir.",
+    "rootArray": "Satır listesi ucun gövde parametrelerinden YALNIZ BİRİNE (birincil anahtarınkine) code ile verilir, öbürleri hiç yazılmaz. Servis şeması isParameterArray dediği için değeri olan tek gövde parametresinin dizisi gövdenin KENDİSİ olur — parametre adı anlamını yitirir. İkinci bir gövde parametresine değer verilirse gövde nesneye döner ve platform tek satır okur: 422 'Please provide the primary key value'. ADR 0029'dan eski platformda bu akış da 422 ile düşer.",
+    "onError": "Servis hata dönerse liste kendiliğinden eski sıraya DÖNMEZ: yeniden okuma sürüklemeden önceki satırların aynısını getirir, liste aynı satırlarda tuttuğu sırayı korur ve ekran kaydedilmemiş sırada kalır. Hatayı Steps.<yazma adımı>.error ile kullanıcıya gösterin; eski sıraya döndürmenin doğrulanmış bir yolu yoktur.",
+    "verify": "page_screenshot({ applicationSlug: '<uygulama>', pageSlug: 'siralama', actions: [{ action: 'swipe', target: 'lst_gorev__row-2__handle', to: 'lst_gorev__row-0' }] }) üçüncü satırı başa taşır; txt_sonuc 'kaydedildi 3 satır' yazar ve row_list (order sira) aynı sırayı verir. Tutamaç kimliği yalnız çalışma anında basılır. Her denemeden sonra satırları bulk-update ile ilk sıralarına geri yazın."
+  },
+  "microservices": [
+    {
+      "role": "okuma",
+      "definition": {
+        "name": "gorev-sirali",
+        "slug": "gorev-sirali",
+        "url": "gorev-sirali",
+        "description": "Görevleri (id, ad, sira) liste olarak döner; sıralamayı çağıran sortField/sortType ile verir.",
+        "type": "rest-api",
+        "httpMethod": "get",
+        "source": "table",
+        "returnType": "flat",
+        "entityId": "<gorev entity id>",
+        "sourceParameters": {
+          "operation": "get",
+          "entityId": "<gorev entity id>",
+          "alias": "gorev",
+          "isSingle": false,
+          "joins": [],
+          "filters": [],
+          "selectFields": [
+            {
+              "alias": "gorev",
+              "fieldSlug": "id"
+            },
+            {
+              "alias": "gorev",
+              "fieldSlug": "ad"
+            },
+            {
+              "alias": "gorev",
+              "fieldSlug": "sira"
+            }
+          ],
+          "sort": {
+            "name": "sortField",
+            "type": "sortType",
+            "source": "query-string"
+          },
+          "limit": {
+            "name": "limit",
+            "offset": "offset",
+            "source": "query-string"
+          }
+        }
+      }
+    },
+    {
+      "role": "yazma",
+      "definition": {
+        "name": "gorev-sira-yaz",
+        "slug": "gorev-sira-yaz",
+        "url": "gorev-sira-yaz",
+        "description": "Görevlerin sıra alanını tek istekte toplu yazar; gövde [{ id, sira }] dizisidir.",
+        "type": "rest-api",
+        "httpMethod": "put",
+        "source": "table",
+        "returnType": "flat",
+        "entityId": "<gorev entity id>",
+        "sourceParameters": {
+          "operation": "bulk-update",
+          "entityId": "<gorev entity id>",
+          "alias": "gorev",
+          "isSingle": true,
+          "joins": [],
+          "filters": [],
+          "selectFields": [],
+          "fields": [
+            {
+              "fieldSlug": "id",
+              "source": "body",
+              "value": "id"
+            },
+            {
+              "fieldSlug": "sira",
+              "source": "body",
+              "value": "sira"
+            }
+          ],
+          "returnFields": [],
+          "sort": {
+            "name": "sortField",
+            "type": "sortType",
+            "source": "query-string"
+          },
+          "limit": {
+            "name": "limit",
+            "offset": "offset",
+            "source": "query-string"
+          }
+        }
+      }
+    }
+  ],
+  "pages": [
+    {
+      "pageCreateArgs": {
+        "name": "Sıralama",
+        "slug": "siralama"
+      },
+      "schemaPatchOps": [
+        {
+          "op": "add_component",
+          "parent": "page_container",
+          "component": {
+            "elementId": "txt_sonuc",
+            "name": "txt_sonuc",
+            "type": "text",
+            "kind": "component",
+            "props": {
+              "content": {
+                "type": "static",
+                "ref": null,
+                "data": "Bir satırı tutamacından sürükleyin"
+              }
+            },
+            "appearance": {
+              "marginType": "none",
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          }
+        },
+        {
+          "op": "add_component",
+          "parent": "page_container",
+          "component": {
+            "elementId": "lst_gorev",
+            "name": "lst_gorev",
+            "type": "repeater",
+            "kind": "component",
+            "props": {
+              "rows": {
+                "type": "static",
+                "ref": null,
+                "data": []
+              },
+              "reorderable": {
+                "type": "static",
+                "ref": null,
+                "data": true
+              },
+              "orderField": {
+                "type": "static",
+                "ref": null,
+                "data": "sira"
+              },
+              "verticalSpacing": {
+                "type": "static",
+                "ref": null,
+                "data": 8
+              }
+            },
+            "appearance": {
+              "marginType": "none",
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": [
+              {
+                "elementId": "lst_gorev_satir",
+                "name": "lst_gorev_satir",
+                "type": "view",
+                "kind": "component",
+                "props": {},
+                "blocks": [],
+                "children": [
+                  {
+                    "elementId": "kart_gorev",
+                    "name": "kart_gorev",
+                    "type": "card",
+                    "kind": "component",
+                    "props": {
+                      "title": {
+                        "type": "code",
+                        "ref": "{{ item.ad }}"
+                      },
+                      "description": {
+                        "type": "code",
+                        "ref": "{{ 'Sıra ' + item.sira }}"
+                      }
+                    },
+                    "appearance": {
+                      "marginType": "none",
+                      "widthType": "fill"
+                    },
+                    "blocks": [],
+                    "events": [],
+                    "validations": [],
+                    "stateBindings": [],
+                    "children": []
+                  }
+                ]
+              },
+              {
+                "elementId": "lst_gorev_bos_gorunum",
+                "name": "lst_gorev_bos_gorunum",
+                "type": "view",
+                "kind": "component",
+                "props": {},
+                "blocks": [],
+                "children": [
+                  {
+                    "elementId": "lst_gorev_bos",
+                    "name": "lst_gorev_bos",
+                    "type": "emptystate",
+                    "kind": "component",
+                    "props": {
+                      "title": {
+                        "type": "static",
+                        "data": "Görev yok"
+                      }
+                    },
+                    "blocks": [],
+                    "children": []
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      "flows": [
+        {
+          "name": "siralama yukle",
+          "slug": "siralama-yukle",
+          "steps": [
+            {
+              "stepId": "start",
+              "name": "start",
+              "type": "start",
+              "kind": "normal",
+              "args": {},
+              "branches": [
+                {
+                  "id": "<GUID>",
+                  "name": "always",
+                  "nextStepId": "oku"
+                }
+              ]
+            },
+            {
+              "stepId": "oku",
+              "name": "oku",
+              "type": "microservice",
+              "kind": "normal",
+              "args": {
+                "microserviceId": "<gorev-sirali microservice id>",
+                "slug": "gorev-sirali",
+                "httpMethod": "get",
+                "isRaw": false,
+                "parameters": [
+                  {
+                    "name": "sortField",
+                    "type": "text",
+                    "source": "query-string",
+                    "value": {
+                      "type": "static",
+                      "ref": "sira"
+                    }
+                  },
+                  {
+                    "name": "sortType",
+                    "type": "text",
+                    "source": "query-string",
+                    "value": {
+                      "type": "static",
+                      "ref": "asc"
+                    }
+                  }
+                ]
+              },
+              "branches": [
+                {
+                  "id": "<GUID>",
+                  "name": "always",
+                  "nextStepId": "yaz"
+                }
+              ]
+            },
+            {
+              "stepId": "yaz",
+              "name": "yaz",
+              "type": "setter",
+              "kind": "normal",
+              "args": {
+                "iteratees": [
+                  {
+                    "id": "<GUID>",
+                    "type": "change",
+                    "source": "component",
+                    "element": "lst_gorev",
+                    "property": "rows",
+                    "mapping": {
+                      "source": "",
+                      "mappings": {}
+                    },
+                    "value": {
+                      "type": "code",
+                      "ref": "Steps.oku?.data ?? []"
+                    }
+                  }
+                ]
+              },
+              "branches": [
+                {
+                  "id": "<GUID>",
+                  "name": "always",
+                  "nextStepId": null
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "siralama kaydet",
+          "slug": "siralama-kaydet",
+          "steps": [
+            {
+              "stepId": "start",
+              "name": "start",
+              "type": "start",
+              "kind": "normal",
+              "args": {},
+              "branches": [
+                {
+                  "id": "<GUID>",
+                  "name": "always",
+                  "nextStepId": "kaydet"
+                }
+              ]
+            },
+            {
+              "stepId": "kaydet",
+              "name": "kaydet",
+              "type": "microservice",
+              "kind": "normal",
+              "args": {
+                "microserviceId": "<gorev-sira-yaz microservice id>",
+                "slug": "gorev-sira-yaz",
+                "httpMethod": "put",
+                "isRaw": false,
+                "parameters": [
+                  {
+                    "name": "id",
+                    "type": "guid",
+                    "source": "body",
+                    "value": {
+                      "type": "code",
+                      "ref": "event.data.patches.map(p => ({ id: p.id, sira: p.value }))"
+                    }
+                  }
+                ]
+              },
+              "branches": [
+                {
+                  "id": "<GUID>",
+                  "name": "always",
+                  "nextStepId": "oku"
+                }
+              ]
+            },
+            {
+              "stepId": "oku",
+              "name": "oku",
+              "type": "microservice",
+              "kind": "normal",
+              "args": {
+                "microserviceId": "<gorev-sirali microservice id>",
+                "slug": "gorev-sirali",
+                "httpMethod": "get",
+                "isRaw": false,
+                "parameters": [
+                  {
+                    "name": "sortField",
+                    "type": "text",
+                    "source": "query-string",
+                    "value": {
+                      "type": "static",
+                      "ref": "sira"
+                    }
+                  },
+                  {
+                    "name": "sortType",
+                    "type": "text",
+                    "source": "query-string",
+                    "value": {
+                      "type": "static",
+                      "ref": "asc"
+                    }
+                  }
+                ]
+              },
+              "branches": [
+                {
+                  "id": "<GUID>",
+                  "name": "always",
+                  "nextStepId": "yaz"
+                }
+              ]
+            },
+            {
+              "stepId": "yaz",
+              "name": "yaz",
+              "type": "setter",
+              "kind": "normal",
+              "args": {
+                "iteratees": [
+                  {
+                    "id": "<GUID>",
+                    "type": "change",
+                    "source": "component",
+                    "element": "lst_gorev",
+                    "property": "rows",
+                    "mapping": {
+                      "source": "",
+                      "mappings": {}
+                    },
+                    "value": {
+                      "type": "code",
+                      "ref": "Steps.oku?.data ?? []"
+                    }
+                  },
+                  {
+                    "id": "<GUID>",
+                    "type": "change",
+                    "source": "component",
+                    "element": "txt_sonuc",
+                    "property": "content",
+                    "mapping": {
+                      "source": "",
+                      "mappings": {}
+                    },
+                    "value": {
+                      "type": "code",
+                      "ref": "Steps.kaydet?.error ? 'Sıra kaydedilemedi: ' + Steps.kaydet.error.message : 'kaydedildi ' + event.data.patches.length + ' satır'"
+                    }
+                  }
+                ]
+              },
+              "branches": [
+                {
+                  "id": "<GUID>",
+                  "name": "always",
+                  "nextStepId": null
+                }
+              ]
+            }
+          ]
+        }
+      ],
+      "bindOps": [
+        {
+          "op": "set_event",
+          "target": "page_container",
+          "event": "mount",
+          "eventValue": "<siralama-yukle akış id>"
+        },
+        {
+          "op": "set_event",
+          "target": "lst_gorev",
+          "event": "reorder",
+          "eventValue": "<siralama-kaydet akış id>"
+        }
+      ]
+    }
+  ]
+}