@appaflytech/zeyrek-ai-mcp 0.0.12 → 0.0.13

package/dist/resources/guides/getting-started.md

@@ -56,6 +56,10 @@ Bağımlılıklar bu sırayı zorunlu kılar; atlama:
                           ifadelerde Functions.<ad>(…) ile, akışlar 'function' adımıyla çağırır;
                           sayfaya özgü fonksiyon (scope:'page') sayfa açıldıktan sonra gelir.
                           Kurallar platform_guide('functions'))
+      function_update    (GÖVDE DEĞİŞİNCE: function_update { id, body } — patch aracı YOKTUR,
+                          fonksiyonun tek büyük alanı gövdedir ve gateway vermediğin alanları
+                          mevcut kayıttan doldurur. Adı değiştirirsen platform çağıranları AYNI
+                          işlemde yeni ada taşır (renamedReferences))
 11. layout_create        (header/sidebar + MUTLAKA bir 'slot' — slot'suz layout'a bağlı sayfa
                           boş görünür; bkz. platform_guide('page') Kural 5)
 12. page_create + …      (İŞ BURADA BİTMEZ: her kaydın yönetim ekranı, kimlik varsa giriş

package/dist/resources/guides/microservice.md

@@ -620,6 +620,45 @@ gerekmese bile** ona bir middleware bağla. Tek `variable` adımlı, hiçbir şe
 Zayıf alternatif: bütün doğrulamaları ilk yazmadan **önce** bitirip yazma bölümünde hiç
 `response`/hata üretmemek — beklenmedik istisnaya karşı korumasızdır.
 
+## Patch belgesi OKUMA şeklidir — rol listesi `/roles` yolundadır (MS-022)
+
+`microservice_patch` yamayı **`microservice_get`'in döndürdüğü gövdeye** uygular; platform da onu
+kendi tarafında `MicroserviceDto` olarak okuyup `UpdateMicroserviceCommand`'a çevirir
+(`PatchMicroserviceCommand.cs:36-55`). Yani yamalanan belge **yazma komutu değildir** ve iki
+belgenin alan adları her yerde aynı değildir:
+
+| Ne | Create/update GÖVDESİ | Patch YOLU (okuma şekli) |
+|---|---|---|
+| Rol listesi | `roleIds: [<guid>]` | **`/roles`** → `[{ id, name }]` |
+| Middleware listesi | `middlewareIds: [<guid>]` | `/middlewareIds` (aynı) |
+| Alan listesi | `sourceParameters.selectFields` | `/sourceParameters/selectFields` (aynı) |
+
+**Ucun rolünü değiştirmek için tanımı yeniden göndermek gerekmez** — tek op yeter:
+
+```jsonc
+// tüm listeyi yaz (tercih edilen): name isteğe bağlıdır, platform yalnız id okur
+{ "op": "replace", "path": "/roles", "value": [{ "id": "<role_list id>" }] }
+
+// listeye ekle
+{ "op": "add", "path": "/roles/-", "value": { "id": "<role_list id>" } }
+
+// tek rolü çıkar
+{ "op": "remove", "path": "/roles[id=<role_list id>]" }
+```
+
+- **`roleIds` yolu patch belgesinde YOKTUR.** Verirsen gateway `/roles`'a çevirir, çıplak guid'leri
+  `{ id }` nesnesine sarar ve çeviriyi `gatewayNormalized` ile söyler — istek düşmez. Çevrilmeseydi
+  `replace /roleIds` gateway'de `OPERATION_PATH_UNRESOLVABLE` verirdi, `add /roleIds` ise platformda
+  **sessizce yutulurdu** (bilinmeyen üye atılır, 200 döner, rol değişmez).
+- **Tam dizi `replace`'i tercih et.** Rolü olmayan uçta alan `null` serileşebilir ve `/roles/-`
+  çözülemez; gateway bunu tek öğelik tam diziye katlar ve notu yanıta yazar.
+- Rol id'leri `role_list`ten gelir. `role_list` **slug döndürmez** ve iki anahtar farklıdır:
+  buradaki `id` ile yetkilendirmenin karşılaştırdığı `slug` aynı şey değildir
+  (`platform_guide('entity')` §"Hazır entity'ler").
+- Yazmanın kanıtı yanıttadır: outline `roleIds` taşır, ikinci bir `microservice_get` gerekmez.
+- **Rol tek başına kapı değildir** — §"Uçlar varsayılan olarak ANONİMDİR": koruma `middlewareIds`
+  ile gelir.
+
 ## Uçlar varsayılan olarak ANONİMDİR
 
 Çalıştırma rotası `[AllowAnonymous]`'tur (`MicroservicesController.cs:90`): `middlewareIds` boş
@@ -629,6 +668,7 @@ Anonim veri toplama (anket, başvuru, geri bildirim) bu sayede kurulabilir — a
 
 `roles` bir kapı değildir: `roleIds` dolu + `middlewareIds` boş bir uç tokensız POST'u 200 ile
 kabul etti. Ayrıntı ve doğru rol kapısı tarifi: `platform_guide('middleware')` Tarif 3b.
+Rol listesini **değiştirmek** için yukarıdaki §"Patch belgesi OKUMA şeklidir".
 
 > **Anonimlik/erişim testi `microservice_execute` + `anonymous: true` ile yapılır.** Bayrak
 > verildiğinde gateway isteğe HİÇBİR `Authorization` header'ı koymaz (varsayılan davranışta

package/dist/resources/guides/modify-existing.md

@@ -12,6 +12,10 @@ Gerçek projelerde tek tanım 20-100 bin satır JSON olabilir. **Tam gövdeyi ba
                                                belleğinde çeker, patch'i uygular, politika
                                                kontrolünden geçirir, geri yazar
 5. *_get view:'outline'                      → değişikliği teyit et
+
+function_update {id, body}                   → FONKSİYONDA *_patch YOKTUR: tek büyük alan
+                                               gövdedir, yalnız onu gönder (gateway kalan
+                                               alanları mevcut kayıttan doldurur)
 ```
 
 `view:'full'` **son çaredir** — yalnız küçük kayıtlarda ya da patch'in kurulamadığı köklü
@@ -23,12 +27,19 @@ yeniden yazımlarda.
   ekleme), `/fields/5/nullable`.
 - Dizin indekslerini tahmin etme — `view:'outline'` çıktısındaki sıradan ya da
   `view:'part'` ile doğrulayarak yaz.
+- **Bir listeye tek öğe eklemek listeyi yeniden göndermek değildir:** `add` + `/-`
+  (`/fields[slug=status]/valueOptions/-`, `/sourceParameters/selectFields/-`); tek öğeyi silmek
+  ya da değiştirmek için seçici (`[value=…]`, `[slug=…]`). Enum örnekleri:
+  `platform_guide('entity')` §"Tek bir enum değerini ekle / sil / yeniden adlandır".
 - Silme yerine `replace` tercih et; `remove` kullanacaksan önce o path'i `part` ile görüntüle.
 - Yanıttaki outline özeti değişikliğin uygulandığı hâli gösterir — teyit için oku.
 - **Kullanıcı fonksiyonunda patch aracı yok:** `function_update` tam gövde yazar ama vermediğin
   alanları mevcut kayıttan doldurur — yalnız `body` göndermen yeter (fonksiyonun tek büyük alanı
-  gövdedir). Adı değiştirmeden önce `dependency_graph` (`module:'ui-function'`) ile çağıranları
-  bul: `{{ }}`/`code` ifadelerindeki `Functions.<eskiAd>(` çağrıları metinseldir ve kırılır.
+  gövdedir). `function_get` çıktısı `function_update`'in şablonudur; örnek:
+  `ngapps://examples/function-total` `functionUpdateArgs`. Adı değiştirmeden önce
+  `dependency_graph` (`module:'ui-function'`) ile çağıranları bul: `{{ }}`/`code` ifadelerindeki
+  `Functions.<eskiAd>(` çağrıları metinseldir — platform onları aynı işlemde taşır, ayrıntı
+  `platform_guide('functions')` §Güncelleme ve silme.
 
 ## Değiştirmeden önce geçmişe bak
 

package/dist/resources/guides/workflow.md

@@ -401,6 +401,41 @@ gidilir, hiçbiri tutmazsa `else` dalı yürür:
 > `rule.isExpression` bayrağı bu iki alan için **okunmaz**.
 
 
+## HTTP adımı: gövde ayrı alan değil, `payloadExpression` üç anahtarı birden taşır (WF-033)
+
+Dört alan: `rule.urlExpression` · `httpMethod` · `contentType` · `payloadExpression`.
+**Gövdenin kendi alanı yoktur** — `payloadExpression` tek bir ifadeyle `{ header, body,
+queryString }` **üçünü birden** üretmek zorundadır; yürütücü üçüne de `dynamic` üye erişimiyle
+bakar (`HttpStep.cs:32,42,59`).
+
+```jsonc
+"rule": {
+  "stepType": "http",
+  "urlExpression": "'https://api.example.com/orders'",
+  "httpMethod": "POST",
+  "contentType": "application/json",
+  "payloadExpression": "({ body: { orderId: input.orderId }, header: { Authorization: 'Bearer ' + system.token }, queryString: {} })"
+}
+```
+
+| Tuzak | Ne olur |
+|---|---|
+| Bir anahtar eksik (`queryString` yok) | Adım **düşer**: `RuntimeBinderException` — ölçülen mesaj birebir `'System.Dynamic.ExpandoObject' does not contain a definition for 'queryString'`. Boş da olsa `{}` yazın |
+| `urlExpression` tırnaksız | İfadedir, düz metin değil: `https://…` yazarsan JS onu değişken sanır ve adım `x is not defined` der |
+| `contentType` boş | Gövde `body.ToString()` ile gider (`HttpStep.cs:63-85`); nesne gövdesi tip adına dönüşür. POST/PUT'ta açıkça yazın |
+| Yanıt JSON değil | Gövde **sessizce** boş nesne olur (`:92`) — XML dönen uçtan veri de hata da alamazsınız |
+| Adım adında boşluk | Çıktıya adım adıyla erişilir; ad geçerli JS tanımlayıcısı olmalı (`call_roles`, `Call Roles` değil) |
+
+**Çıktıyı okurken şemaya değil ölçüme güvenin (2026-09-16).** `workflow_step_schema('http')`
+`returnScheme`'i kök seviyede `{ httpStatusCode, data }` ilan eder, ama koşumda ifade bağlamındaki
+adım `{ data, meta: { elapsedTime, httpStatusCode, totalCount }, error }` şeklindedir:
+
+- gövde → **`<adım>.data`**
+- durum kodu → **`<adım>.meta.httpStatusCode`**
+- `<adım>.httpStatusCode` → **undefined** (şemanın vaat ettiği ad çalışmaz)
+
+Tam örnek ve POST varyantı: `ngapps://examples/workflow-http-step`.
+
 ## Workflow adımı: başka bir akışı parametreyle çağırmak (WF-032)
 
 Ortak mantığı (kayıt açma, bildirim, numaralandırma) **bir kez** `type:'workflow'` akışı olarak
@@ -458,6 +493,8 @@ yazıp diğer akışlardan çağırmanın yolu budur — 30 adımı kopyalamak d
 - Aynı alt akışı birden çok adımdan çağırmak serbesttir; özyineleme runner'ın koşum sayacına
   takılır (kural envanteri WF-028 — gateway kuralı değil, backend davranışı).
 
+Tam örnek (çağıran + çağrılan akış, canlı ölçümle yazıldı): `ngapps://examples/workflow-call-workflow`.
+
 ## Loop step — dizinin her öğesi için bir adım koştur
 
 Tek uçta "başlık + N alt kayıt" yazmanın yolu budur (anket + sorular + seçenekler tek çağrıda;
@@ -478,9 +515,19 @@ Tek uçta "başlık + N alt kayıt" yazmanın yolu budur (anket + sorular + seç
   (`StepRuleDto StepRule`); `children` gönderirsen `rule.Children` boş kalır ve loop
   **`NullReferenceException`** ile patlar — hata mesajı `arrayExpression`'ı işaret ettiği için
   seni ifadeyi suçlamaya iter, oysa sorun anahtar adıdır.
-- **Geçerli öğe `loopItem`'dır.** Çocuğun `fields[].value` / `filters[].value` ifadelerinde
-  `loopItem.<alan>` yazılır; `input` ve önceki adımlar (`createSurvey.data.id`) da görünmeye
-  devam eder.
+- **Geçerli öğe `loopItem`'dır — ama YALNIZ loop'un kendi değerlendirdiği ifadelerde.** Çocuğun
+  `fields[].value` / `filters[].value` ifadelerinde `loopItem.<alan>` yazılır (ölçüldü 2026-09-16:
+  `table` çocuğunun filtresinde `loopItem.slug` → `'super-admin'`); `input` ve önceki adımlar
+  (`createSurvey.data.id`) da görünmeye devam eder.
+- **`code` çocuğunda `loopItem` YOKTUR (ölçüm 2026-09-16).** `code` adımı kendi JS motorunu kurar
+  ve `LoopStep`'in `loopItem` ataması oraya ulaşmaz: adım **`Error: loopItem is not defined`** ile
+  düşer, o yinelemenin çıktısında `result` hiç oluşmaz. Motorda görünenler `input` · `system` ·
+  `file` · `crypto` · `convert` ve ifade fonksiyonlarıdır. **Her öğe için hesap yapman gerekiyorsa
+  hesabı `arrayExpression`'da önden yap** — orası JS'tir ve diziyi istediğin şekle sokabilirsin:
+  `(input.kalemler || []).map(k => ({ ...k, tutar: k.fiyat * k.adet }))`; çocuk sonra
+  `loopItem.tutar`'a bakar.
+- **İndeks değişkeni yoktur.** Sıra numarası gerekiyorsa diziyi `arrayExpression`'da üret:
+  `input.kalemler.map((k, i) => ({ ...k, sira: i }))`.
 - **Çıktı `[{ item, result }]` dizisidir.** `result` çocuk adımın çıktısıdır; `table create`
   için `{ id }`. Sonraki adımda `loopQuestions.data` ile okunur — **yazılan kayıtların id'sini
   girdideki öğeyle eşleştirmenin yolu budur.**
@@ -496,6 +543,9 @@ Tek uçta "başlık + N alt kayıt" yazmanın yolu budur (anket + sorular + seç
   İstemci alt kayıtları **düz** gönderir ve satırları `key`/`qkey` ile eşler — iç içe dizi
   göndermek gerekmez (iç içe loop denenmedi; `loopItem` iç loop'ta gölgeleneceği için önerilmez).
 
+Tam örnek, ölçülen çıktı şekli ve `code` çocuğu tuzağının çıkış yolu:
+`ngapps://examples/workflow-loop-step`.
+
 > **Table step'te `create`/`update` satır değerleri `fields[]`'tedir ve JS İFADESİDİR.**
 > `{ "fieldId": "<alan id>", "source": "expression", "value": "input.title", "order": 0 }` —
 > `PrepareParameters` her `fields[].value`'yu `EvaluateExpression` ile koşturur

package/dist/resources/schema-fingerprint.json

@@ -1,8 +1,10 @@
 {
-  "hash": "54430a8d4050fd201aaee88608a5d06b947edf6d561ad31354914422df4e94ce",
-  "generatedAt": "2026-09-16T11:17:11.569Z",
-  "types": 185,
-  "files": 107,
+  "hash": "05c7864d58e308973805f7becee1578ce9eddad196abcdf7eebb43b1e7677549",
+  "generatedAt": "2026-09-16T15:53:10.903Z",
+  "types": 186,
+  "files": 108,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",
-  "missing": []
+  "missing": [
+    "NgApps.Infrastructure.Models.IdNamePair`1[[System.Guid, System.Private.CoreLib, Version=10.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]"
+  ]
 }