@appaflytech/zeyrek-ai-mcp 0.0.35 → 0.0.37

package/dist/resources/guides/page.md

@@ -4,6 +4,10 @@ Studio'nun tuval tarafı. Buradaki kurallar controller + komut kodundan doğrula
 (`zeyrek-mcp/docs/13-faz2-envanter.md` §4); veri/mantık tarafı için
 `platform_guide('entity')`, `('microservice')`, `('workflow')`.
 
+> **Mobil uygulamada** (`type: 'mobile'`) şema ve micro-op'lar aynıdır ama yerleşim yalnız flex'tir
+> (blocks çizilmez), görünüm tipli gruplarla yazılır ve `page_create` kökü flex sütun kurar —
+> `platform_guide('mobile')`. Bu rehberdeki "dar ekran" notları WEB uygulamasının telefon kırılımıdır.
+
 **Asgari komponent gövdesi** — her yazma yolunda, her düğümde (çocuklar dahil); ayrıntı Kural 1:
 
 ```jsonc
@@ -38,8 +42,14 @@ blokları 1h-3'te).
 
 ## Kural 1 — Komponent gövdesinin şekli (`DesignComponentManagementSchema`)
 
-Sayfa şeması **micro-op hattından** kurulur; `page_create`'e satır içi `schema` vermek de
-mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`'te çalışır.
+Sayfa şeması **micro-op hattından** kurulur; `page_create`/`page_update`'e satır içi `schema`
+vermek de mümkündür ve 2026-09-20'den beri o yol da **katalog doğrulamasından geçer** (TB-123):
+gateway geçersiz enum değerini `invalid-enum-value`, olmayan prop'u `unknown-prop`, geçersiz
+`appearance` jetonunu `invalid-appearance` ile **istek gitmeden** reddeder — platformun micro-op
+ucundaki duvarıyla aynı kural kimlikleri. Micro-op hattının hâlâ iki üstünlüğü var: **canlı
+canvas** (SignalR) ve ATOMİK op listesi. Gateway'in tam şema denetimi ÜST DÜZEY prop'lara ve
+`appearance` jetonlarına bakar (platformun duvarı da öyle: `surfaceStyle.contentOverflow` gibi iç
+alanlar denetlenmez); katalog okunamazsa denetim susar ve yazma eskisi gibi geçer.
 
 ```jsonc
 { "elementId": "page_header_1", "kind": "component", "type": "<component_list slug'ı>",
@@ -249,7 +259,7 @@ döndürür; hata yok, sayfalama yok. (Bağımsız `pagination` komponenti bu tu
 | `dropdown.search` · `multi-select.search` | `{ searchText }` | `self.searchText` |
 | `tabs.tab` | `{ selected }` | `self.selected` ya da `event.data.selected` |
 | `chart.dataPointClick` | `{ name, seriesName, value, dataIndex, row }` | `self.row` (kaynak satırın tamamı) |
-| `repeater.change` · `repeater.select` | `{ selectedIndex }` | `self.selectedIndex` · `self.selectedItem` (akış satır bağlamında koşmaz, `item`/`Row` boş) |
+| `repeater.change` · `repeater.select` | `{ selectedIndex }` | `self.selectedIndex` · `self.selectedItem` (akış satır bağlamında koşmaz, `item`/`Row` boş); satırdaki bir düğmenin akışında setter'ın yazım kapsamı OLAYIN kaynağı değil HEDEFİN ağaçtaki yeriyle belirlenir — satırın şablonu içindeki bir hedefe satır bazlı (`_repeaterValues`), dışındaki bir hedefe (modal, sayfa düzeyi metin) sayfa kapsamında yazılır (ZM-08, 2026-09-26); iç içe repeater zaten `PAGE-013` ile reddedilir, ama bir DIŞ repeater'ın şablonuna İÇ satırdan yazan bir akış varsa yazım dış satırın değil İÇ satırın kimliğiyle anahtarlanır — bilinen açık, PAGE-013 riski düşük tutar |
 | `html` aksiyonu (`fireEvent`) | ikinci argüman | **`event.data`** |
 | `kanban.cardMove` | `{ id, row, from, to }` | **`event.data`** (self'e yazılmaz) |
 | `kanban.cardAdd` · `kanban.cardRemove` | `{ column }` · `{ id, row, column }` | **`event.data`** (self'e yazılmaz; kart eklenmez/gizlenmez, akış yazıp `rows`'u tazeler) |
@@ -272,7 +282,8 @@ dalı bulamaz ve akışı **sessizce durdurur** (`flow-engine.ts:79`); Studio da
 `sourceBranch === 'always'` ile çizdiği için panelde **Start kartından sonrası boş görünür**.
 İstisnalar: `condition` → dal adı rule id'sidir (ve o id bir **GUID**'dir — aşağıdaki tuzak 6),
 `confirm` → `yes|no|always`, `microservice` →
-`always` (eski akışlarda `success` de çalışır).
+`always` (eski akışlarda `success` de çalışır) **+ `error`** — bağlarsan hata anında `always`
+yerine ondan sürer (2026-09-26, ADR 0004; ayrıntı aşağıdaki §"4xx de hatadır").
 
 **2. `iteratees[].type` yalnız `change` | `fill`.** `setter.ts` başka değerde hiçbir dala
 girmez — adım çalışır, hiçbir şey yapmaz. `change` tek prop'a değer yazar, `fill` diziyi
@@ -398,36 +409,42 @@ Satır eşlemeli tablo yüklemesinin tam şekli (yükleniyor bayrağı → uç
 göstermek error flow'un işidir.
 
 > **4xx de hatadır ve `always` dalı seni KURTARMAZ.** `microservice.ts` `.catch` bloğu
-> reddedilen her istekte koşar — 401/403/404/422 dâhil. Sonrası iki yoldan biridir ve ikisi de
-> "ekranda hiçbir şey olmadı" ile biter:
+> reddedilen her istekte koşar — 401/403/404/422 dâhil — ve storage'a HER ZAMAN
+> `{ data: null, headers: null, error: { status, message, body } }` yazar (ADR 0004,
+> 2026-09-26 — eskiden hata gövdesi `data`'ya yazılıyordu). `.finally` sonra ÜÇ yoldan birini
+> dener, SIRAYLA:
 >
-> 1. **Hata yolu VARSA** `engine.onError` true döner ve `.finally` `return` eder —
->    `engine.next('always')` **hiç çağrılmaz**. Yani `always` ile `errorSteps` birbirini dışlar;
->    ikisini birden kuramazsın, hata yolu ana akışın devamını devralır.
-> 2. **Hata yolu YOKSA** `always` koşar, ama storage artık `{ error, data }`'dır ve
->    `Steps.<ad>.data` başarı gövdesi değil **hata gövdesidir**. Sıradaki `condition`
->    `!!Steps.signIn.data.token` gibi bir ifadeyi `undefined` üzerinden değerlendirir, sessizce
->    diğer dala düşer ve `else` dalı bağlı değilse akış orada biter.
+> 1. **Adımın kendi `error` dalı BAĞLIYSA** akış oradan sürer — `always` **hiç koşmaz**
+>    (`hasBranch('error')`). Bu dal `Steps.<ad>.error` okuyabilir; ana akışın kalanı hiç çalışmaz.
+> 2. **`error` dalı yoksa, `errorSteps` VARSA** `engine.onError` true döner ve `.finally` `return`
+>    eder — yine `always` koşmaz, flow'un hata akışı devralır (aşağıdaki karşılaştırma tablosu).
+> 3. **İkisi de yoksa** `always` koşar, ama `Steps.<ad>.data` artık **NULL**dır — başarı gövdesi
+>    değil, hiç gövde değil. Sıradaki bir `condition` `!!Steps.signIn.data.token` gibi bir
+>    ifadeyi `null.token` üzerinden dener; `runCode` hatayı yutar (K2), ifade `undefined` döner ve
+>    akış sessizce diğer dala düşer — `else` dalı bağlı değilse akış orada biter. `data`yı bir
+>    liste prop'una yazan bir setter artık patlayan bir nesne değil `null` görür (repeater/table
+>    `null`'ı boş liste sayar), ama hata OLDUĞUNU fark etmeden geçer — gateway bunu **FLOW-038**
+>    ile uyarır.
 >
 > **`errorSteps` yalnız `start` taşıyorsa hata yolu YOKTUR:** `hasErrorFlow`
 > `errorTasks.some(t => t.type !== 'start')` arar. Start'ın ardına en az bir adım bağla —
 > gateway `FLOW-021` ile uyarır.
 >
-> **Mobilde `errorSteps` diye bir şey YOK.** `ScreenRuntime.tsx` `mapFlowsToMachine` yalnız
-> `tasks` üretir (web `Runtime.svelte` ayrıca `errorTasks` verir), yani mobil uygulamada
-> `hasErrorFlow` her zaman false: hata yolu hiç koşmaz ve akış yukarıdaki 2. yoldan —
-> `always` + hata gövdeli storage — devam eder. Mobil sayfada hata yolunu `condition
-> Steps.<adımAdı>.error` ile kur.
+> **Mobil uygulama:** mobil runtime (`@ng-apps/ui-native` `NativeRuntime`) `errorSteps`'i web gibi
+> `errorTasks`'a eşler — hata yolu iki platformda aynı koşar.
 
-> **Hata metni ÜÇ ayrı yerde durur ve ikisi kullanıcıya gösterilecek metin DEĞİLDİR.**
+> **Hata metni birden çok yerde durur, hepsi aynı şey değildir (2026-09-26 itibarıyla, ADR 0004).**
 > `onError` hata akışını koşturmadan önce `machine.setStorage('error', errorInfo)` yapar
-> (`flow-engine.ts`), yani hata akışının adımları `Steps.error`'ı okuyabilir:
+> (`flow-engine.ts`), yani hata akışının adımları `Steps.error`'ı okuyabilir; patlayan adımın
+> KENDİ storage'ı ise (bağlı `error` dalı da `always` da) `Steps.<adımAdı>.error` nesnesini taşır:
 >
 > | İfade | Ne taşır | Kaynak |
 > |---|---|---|
-> | **`Steps.error.message`** | **Ucun kendi mesajı** — `err.response.data.message`; boşsa HTTP durum metnine düşer. **Kullanıcıya gösterilecek metin budur.** Yanında `Steps.error.code` · `Steps.error.step.name` (patlayan adım) · `Steps.error.step.data` (ucun gövdesi) gelir | `microservice.ts` `err.reason \|\| HttpStatusText[err.code]` → `flow-engine.ts` `onError` |
-> | `Steps.<adımAdı>.error` | Yalnız HTTP **durum metni** — 401 için `'Unauthorized'`. Hata OLDUĞUNU anlamaya yarar, göstermeye değil | `microservice.ts` `.catch` `HttpStatusText[err.code]` |
-> | `Steps.<adımAdı>.data` | Ucun **hata gövdesi** (`err.response.data`) — başarı gövdesi değil. `.message` alanı burada da vardır | `microservice.ts` `.catch` |
+> | **`Steps.error.message`** | **Yalnız `errorSteps` içinde** — ucun kendi mesajı, `err.reason` → HTTP durum metni → `'Service request failed'`. Yanında `Steps.error.code` · `Steps.error.step.name` (patlayan adım) · `Steps.error.step.data` (ucun hata gövdesi; parametre ifadesi patladıysa `null`) gelir | `microservice.ts` `err.reason \|\| HttpStatusText[err.code]` → `flow-engine.ts` `onError` |
+> | `Steps.<adımAdı>.error.message` | Patlayan adımın KENDİ storage'ında ucun mesajı — `error` dalında da `always`'te de okunur, sıra aynı: `err.reason` → HTTP durum metni → `'Service request failed'` | `microservice.ts` `.catch` |
+> | `Steps.<adımAdı>.error.status` | HTTP durum KODU (sayı) — parametre ifadesi patladıysa `null` | `microservice.ts` `.catch` |
+> | `Steps.<adımAdı>.error.body` | Ucun hata gövdesi — eski `Steps.<adımAdı>.data`'nın taşındığı yer | `microservice.ts` `.catch` |
+> | `Steps.<adımAdı>.data` | **HER ZAMAN `null`**'dır — başarı gövdesi değil, hiçbir gövde değil (eskiden hata gövdesiydi) | `microservice.ts` `.catch` |
 >
 > **`alert` adımının `message`'ı DÜZ METİNDİR — ifade yazarsan ekranda o ifade görünür.**
 > `alert.ts` `task.argument.message`'ı doğrudan `toast.error()`'a geçirir ve `args` hiçbir yerde
@@ -455,15 +472,24 @@ göstermek error flow'un işidir.
 > `{ "type": "confirm", "args": { "message": "Bu risk ve 4 aksiyonu silinecek.", "title": "Riski sil",
 > "confirmText": "Sil", "cancelText": "Vazgeç" } }`.
 
-> **Hangi yolu seçeceksin — `errorSteps` mi, ana akışta `condition` mı?** İkisi birden
-> kurulamaz (yukarıdaki 1. madde), yani bu bir tercih değil bir karar:
+> **Hangi yolu seçeceksin — adımın kendi `error` dalı mı, `errorSteps` mi, ana akışta
+> `condition` mı?** Bir hatada sırayla denenir (yukarıdaki 4xx bölümü) — üçü birden TANIMLI
+> olabilir ama aynı anda yalnız biri koşar: **`error` dalı bağlıysa o kazanır**, yoksa
+> `errorSteps`, ikisi de yoksa `always` + `condition`:
 >
-> | | `errorSteps` | ana akışta `condition Steps.<adımAdı>.error` |
-> |---|---|---|
-> | Ana akışın kalanı | **koşmaz** — hata akışı devralır | koşar, dalı sen seçersin |
-> | Yükleniyor bayrağı · modal kapatma · tablo tazeleme | hata akışında **yeniden kurmak zorundasın**; kurmazsan bayrak açık kalır | zaten ana akışta duruyor |
-> | Hata metni | `Steps.error.message` (yukarıdaki tablo) | `Steps.<adımAdı>.data.message`, hata olduğunu `Steps.<adımAdı>.error` söyler |
-> | Ne zaman doğru | hata anında akış **tamamen başka bir yola** sapacaksa (başarısız giriş, yetkisiz sayfa) | kalan adımların çoğu hata hâlinde de koşacaksa — **form gönderimlerinin varsayılanı budur** (Kural 7) |
+> | | adımın kendi `error` dalı (g-02) | `errorSteps` | ana akışta `condition !!Steps.<adımAdı>.error` |
+> |---|---|---|---|
+> | Kapsam | yalnız BU adımın hatası | akıştaki HERHANGİ bir adımın hatası | yalnız BU adımın hatası |
+> | Ana akışın kalanı | **koşmaz** — bu dal devralır | **koşmaz** — hata akışı devralır | koşar, dalı sen seçersin |
+> | Yükleniyor bayrağı · modal kapatma · tablo tazeleme | dalda **yeniden kurmak zorundasın** | hata akışında **yeniden kurmak zorundasın**; kurmazsan bayrak açık kalır | zaten ana akışta duruyor |
+> | Hata metni | `Steps.<adımAdı>.error.message` | `Steps.error.message` (yukarıdaki tablo) | `Steps.<adımAdı>.error.message`; hata olduğunu `!!Steps.<adımAdı>.error` söyler — `.error.status` parametre ifadesi patladıysa `null`dur, o yolu KAÇIRIR |
+> | Ne zaman doğru | hata anında BU adımın sonrası **tamamen başka bir yola** sapacaksa | hata anında akış **tamamen başka bir yola** sapacaksa (başarısız giriş, yetkisiz sayfa) | kalan adımların çoğu hata hâlinde de koşacaksa — **form gönderimlerinin varsayılanı budur** (Kural 7) |
+>
+> **"Ana akışta condition" sütunu `.error`'u okumalı, `.data`'yı değil.** `Steps.<adımAdı>.data`'nın
+> DOLU/BOŞ olmasına bakarak başarı/hata ayırmak (`data.token` gibi bir alanın varlığını yoklamak)
+> artık yanıltıcıdır — `data` hata anında zaten `null`'dur (yukarıdaki §"4xx de hatadır"). Böyle bir
+> `condition`'ı gateway **FLOW-038** ile uyarır; adıma ayrıca bir `error` dalı bağlayın (aşağıdaki
+> 7c örneği) — `error` dalı bağlıysa uyarı düşer, çünkü hata artık `always`'e hiç uğramaz.
 
 Zorunlu filtresi olan uçlarda (`patient-*`, `doctor-appointments` gibi `isRequired: true`
 filtreli microservice'ler) parametreyi adımda ver, yoksa uç `MissingParameterException` atar:
@@ -540,21 +566,22 @@ Tarif: `platform_guide('middleware')`.
 
 **Sözlükler** (`StepType.cs`, `StepParameterValueType.cs` — hepsi küçük harf):
 `start · microservice · setter · setcookie · validation · condition · redirect · alert ·
-confirm · flow-trigger · storage · navigate · code · download · function · end`
+confirm · flow-trigger · storage · navigate · code · download · function · share · end · bpm`
+(`bpm` argümanı `value` içinde JSON metnidir — `platform_guide('bpm')` §Yürütme ve kutu)
 değer tipleri: `static · page · property · storage · variable · code · item · state`
 
 > **Sözlükte olmak KOŞACAĞI anlamına gelmez — koşan tipler barındırıcıdan gelir.** Motor yedi
 > tip register eder, gerisini uygulama ekler. Bir sayfa TEK bir uygulamaya aittir
 > (`Page.ApplicationId`) ve uygulamanın tipi `web` ya da `mobile`'dır (`ApplicationType.cs`), yani
 > sayfanın barındırıcısı bellidir — matris "hangi tip sende çalışır"ı söyler, iki barındırıcıda
-> birden koşmayı değil (web `Runtime.svelte`, mobil `ScreenRuntime.tsx`):
+> birden koşmayı değil (web `Runtime.svelte`, mobil uygulama `@ng-apps/ui-native` `NativeRuntime`):
 >
-> | Adım tipi | Web | Mobil | Nerede register ediliyor |
+> | Adım tipi | Web | Mobil uygulama | Nerede register ediliyor |
 > |---|---|---|---|
-> | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` · `function` | ✅ | ✅ | `flow-engine.ts` — motorun kendisi (`function` mobilde kayıtlıdır ama mobil runtime `Functions`'ı boş kurar — K11, çağrı çalışmaz) |
-> | `alert` · `redirect` · `setcookie` · `storage` | ✅ | ✅ | uygulama; mobilde `redirect` navigate, `setcookie` storage uygulamasına eşlenir |
-> | `confirm` · `download` | ✅ | ❌ | yalnız `Runtime.svelte` |
-> | `navigate` | ❌ | ✅ | yalnız `ScreenRuntime.tsx` — web'deki karşılığı `redirect` |
+> | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` · `function` · `bpm` | ✅ | ✅ | `flow-engine.ts` — motorun kendisi (`bpm` adımı Studio'da yalnız web uygulamasında listelenir) |
+> | `alert` · `redirect` · `setcookie` · `storage` | ✅ | ✅ | barındırıcı; mobilde `setcookie` cihaz deposuna yazar (`MOB-005`) |
+> | `confirm` · `download` · `share` | ✅ | ✅ | `Runtime.svelte` · `runtime-tasks.ts` (`download` mobilde açma/paylaşım — `MOB-005`; `share` aşağıda) |
+> | `navigate` | ❌ | ✅ (`redirect` takma adı) | web'deki karşılığı `redirect`; gateway `redirect`'e çevirir |
 > | `end` · `query` | ❌ | ❌ | hiçbir yerde — üstelik `query` backend sözlüğünde de yok (`StepType.cs` onu saymaz), yalnız frontend enum'unda duruyor |
 >
 > **Register edilmemiş bir tipe gelen akış SESSİZCE durur.** `flow-engine.ts` `process()`
@@ -590,6 +617,19 @@ değer tipleri: `static · page · property · storage · variable · code · it
 > adımında ve `{{ }}` bağlamasında `Functions.<ad>(…)` ile de çağrılır; gateway bilinmeyen adı ve
 > fazla argümanı FLOW-025 ile uyarır. Tam gövde `ngapps://examples/flow-call-function`, kurallar
 > **`platform_guide('functions')`**.
+>
+> **`share` adımı ("Share")** metin ve bağlantı paylaşır: `args: { title, message, path }`. `title`
+> DÜZ METİNDİR (ifade yazılırsa FLOW-022 uyarır); `message` ve `path` `storage.value` gibi
+> İFADEDİR — düz metin tırnak ister (`"'Şuna bak'"`, `"'https://…/urun/' + Page.queryParams.id"`).
+> Bağlantının adı `url` DEĞİL `path`'tir: backend `Title`/`Message`/`Path` alanlarında saklar ve
+> tanımadığı anahtarı 200 ile sessizce düşürür (FLOW-035 `url`/`link`/`text`'i ve tırnaksız adresi
+> bloklar). Bağlantı ŞEMALI TAM ADRES olmalı (`https://…`, `mailto:…`): şemasız değer (`www.…`,
+> `urun/42`) adres sayılmaz, metnin sonuna eklenir. İfadenin sonucu yalnız dize ya da sayıysa
+> paylaşılır; `false` (`koşul && 'x'`), `null` ve nesne boş sayılır. Cihazda paylaşım sayfası açılır
+> (Android'de bağlantı metnin sonuna eklenir), web'de tarayıcının paylaşım penceresi, yoksa ya da
+> reddederse metin + bağlantı panoya yazılır ve bildirim çıkar. Tek dal `always`: iOS'ta sayfa
+> kapanınca, Android'de seçici açılır açılmaz (RN seçicinin kapanışını bildirmez) sürer; metin de
+> bağlantı da boşsa hiçbir şey açılmaz, akış hemen sürer.
 
 > Bir microservice adımı kaydedildiğinde platform `args.microserviceSchema`'yı
 > (parameterScheme + returnScheme + `isReturnArray`) kendisi doldurur — `flow_get` ile geri
@@ -629,6 +669,175 @@ verilmemiş bir tablo kaynağı vardır ve sayfa göstergesi `NaN / N` olur (öl
 > bildirir, ama ham HTTP'de bu kural sana ait.) `add_component`'te ise sarmal ZORUNLUdur — iki
 > op'un şekli birbirinin tersidir, karıştırma.
 
+## Kural 1c-3 — Prop'u veri kaynağına BAĞLAMA (`connectData`)
+
+Liste, seçenek, grafik serisi ya da ağaç verisi bir TABLODAN geliyorsa akış yazılmaz: prop veri kaynağına bağlanır.
+Değer `{ type: 'connectData', ref: <tanım>, data: <son satırlar> }` olur; runtime satırları
+`POST /connect-data/{uygulama}/{sayfa}/{element}/{prop}` ucundan okur, politika her istekte uygulanır.
+
+| İş | Yol |
+|---|---|
+| Tablo/datatable satırları, dropdown/select seçenekleri, grafik serisi, kanban kartları — kaynak tablo, okuyan query, **liste dönen workflow (dönüş DTO'su array) ya da okuyan microservice** olsa da | **Bağla** (bu kural) |
+| Tek kayıt yükleyip forma doldurmak, bir düğmeyle tetiklenen yazma/işlem, çıktısı birden çok bileşene dağıtılan sonuç | **Akış** (Kural 1c) |
+
+**Tek çağrı.** `connect_data_bind` bileşenin bağlanabilir prop kaydını ve kaynağın kabiliyetini
+okur, tanımı kurar, bulguları istek gitmeden verir ve tek atomik yamayla yazar:
+
+```json
+{ "applicationId": "<app>", "pageId": "<sayfa>", "element": "tbl_musteri", "prop": "rows",
+  "source": { "kind": "entity", "id": "<entity id>" },
+  "fields": ["ad", "soyad", "tckn", "puan", "sube"], "expand": { "sube": ["ad"] },
+  "filterable": ["ad", "tckn", "puan"], "searchable": ["ad", "soyad"], "pageSize": 25 }
+```
+
+Layout'taki bileşende `pageId` yerine `layoutId`, widget içindekinde `componentId`. Yanıt `touched`, `newVersion` ve `runtime.propType: 'connectData'` döner. Önce `dryRun: true` ile
+tanımı, op'ları ve bulguları görebilirsiniz. **Var olan bağlantıyı değiştirmek** için aynı prop ve kaynakla
+yalnız değişen parçayı verin (`{ …, pageSize: 50 }`): verilmeyen parçalar kayıtlı tanımdan taşınır, alan
+listesi değişmediyse kolonlar (genişlik, biçim, başlık) yeniden yazılmaz. Kolonların filtre düğmesi (`isFilterable`)
+yalnız `filterable` listesindeki alanlarda açılır. Tam örnekler: `ngapps://examples/connect-data-table-entity`,
+`ngapps://examples/connect-data-dropdown-roles`, `ngapps://examples/connect-data-query-params` (parametreli query +
+`$ad`), `ngapps://examples/connect-data-workflow-microservice`, `ngapps://examples/connect-data-edit-m2m`,
+`ngapps://examples/connect-data-convert-verify` (convert/detach + kullanıcı gözüyle doğrulama). Resource okuyamayan
+istemcide: `platform_guide({ resource: 'ngapps://examples/<ad>' })`.
+
+**Keşif sırası.**
+
+1. `component_get` → `connectData.props`: hangi prop bağlanır (`rows`, `options`, `series[].data`).
+   Kayıt yoksa bileşen bağlanamaz (CD-001).
+2. `connect_data_sources` → kaynak listesi: `entity` · `query` (yalnız okuyan) · `view` · `workflow` · `microservice`.
+   Entity dışı kaynak yazmaz. Query, view ve workflow tanımı filtre/sıralama/searchable taşımaz (CD-013); microservice
+   yalnız dinamik filtreli tablo ucunda süzer ve aranır, parametreli sıralamada sıralar (describe `canFilter`/`sortable`,
+   CD-002). Microservice'te `searchable`'a yalnız `icontains` işleçli korumasız metin alanı konur; tablonun arama metni
+   bu alanlar üzerinde OR "içerir" filtresine çevrilip uca dinamik filtre olarak gider.
+   Describe `source.pageMode: client` ise sunucu sayfalamaz, runtime ilk 1000 satırı alıp tarayıcıda süzer (CD-007); view
+   `textSearch`: arama istekteki `search` ile, aramasız liste boş. `isSchemaSampled`: DTO'suz query ilk satırdan okundu.
+3. `connect_data_describe { source }` → alan başına efektif kabiliyet (`access` · `operators` · `sortable` · `canWrite` ·
+   `relation` · `enum`). İşleci ve sıralamayı alan tipinden tahmin etmeyin, buradan okuyun.
+
+**İki bağlanma biçimi.**
+
+- **Alan listesi (`fieldsFrom`)** — `datatable.rows`, `table.rows`, `repeater.rows`. Kolon listesi (`columns`) bileşenin
+  KENDİ kolon şemasından üretilir (metin → `text`, sayı → `number`, boolean → `switch`, ilişki → `relation` yoksa `tag`,
+  enum → `tag`); `expand` yolu (`sube.ad`) satıra okunur ama kolon OLMAZ — hedefte gösterilecek alanlar `lookup`'a yazılır.
+  Yeniden bağlamada kolonların sırası ve ayarları korunur.
+- **Roller** — dropdown/radio `{ label, value, … }`, grafik `{ category, value, series, … }`. Verilmezse
+  yalnız ZORUNLU roller önerilir: `value` ← birincil anahtar, `label` ← görünen alan, diğer zorunlu rol
+  türündeki ilk alan. İsteğe bağlı roller (`caption`, `color`, `isDisabled`, `series`…) açıkça verilmedikçe
+  boş kalır. Zorunlu rol doldurulamazsa bind aday listesiyle durur; rolü besleyemeyen alan tipi uyarıdır
+  (CD-016). Runtime satırları rol adlarına da yazar (`option.label ← ad`). Kaydında `fields` olan bileşende
+  (grafik `categoryField`, kanban `titleField`) alan adı o prop'lara aynı yamada yazılır; kanban `columns`
+  kolon rolünün enum değerlerinden üretilir (yeniden bağlamada elle girilen `wipLimit` korunur). Grafiğin
+  `aggregate`'i yazılmaz — satır başına tekrar eden kategori için elle ayarlayın (CD-015).
+  **Role ilişki alanının kendisi** (`category: 'kategori'`, o2m/self) eşlenirse runtime ve kanvas satırda o alanı
+  hedefin görünen alanına (`relation.targetDisplay`, datatable hücresindeki metin) çevirir — hem rolde hem alanın
+  kendisinde, çünkü `categoryField` satırı alan adıyla okur (39/03 U-3; önce eksen `[object Object]` çiziyordu). Kimlik
+  gerekiyorsa alt yolu eşleyin (`value: 'kategori.id'`); m2m dizisi çevrilmez.
+- **Sayfalamayan bileşen bütün sonucu okur** (bileşen tanımında `isPaginated` yok — grafik, dropdown, stat card,
+  kanban…; 39/03 U-5): `pageSize` verilmezse tanımın sayfa boyu **1000** (motorun tek okuma tavanı) yazılır, kayıtlı eski
+  25 de ezilir. Kaynak 1000'i aşarsa satırlar kesilir ve runtime bunu `runtimeErrors`'a `ConnectDataRowsTruncated` olarak
+  yazar; kanvas şeridi "Sayfalamıyor: N satırın M satırını gösterir" der.
+- **Stat Card ana değeri** (39/03 U-13): birincil bağlanabilir prop `rows` (rol `value: number`); kart `valueAggregate`
+  (`first` · `count` · `sum` · `avg` · `min` · `max`) özetini basar, `count` kaynağın `meta.total`'ıdır. `sparkline`
+  ikincil prop olarak bağlanır. Bağlama `valueAggregate`'i yazmaz — `page_schema_patch set_prop` ile seçin.
+
+**Alan kimliği kalıcıdır.** `slug` sayfanın gördüğü ad, `id` fiziksel alan: kaynakta ad değişse de yanıt kayıtlı adla
+gelir, sayfa kırılmaz. Elle yazılan tanımda her alana `id` koyun (`connect_data_bind` kendisi yazar).
+
+**Tanımın şekli (kısa).** `version: 1` · `source { kind, id, slug? }` · `fields [{ id, slug, expand? }]` ·
+`filter` (backend Filter ağacı) · `sort [{ field, ascending }]` · `page { mode: 'offset'|'cursor'|'client', limit }` ·
+`language` (`request` · `default` · `xx`) · `mapping { roles, columns? }` ·
+`behavior { filterable, searchable, edit { create, update, delete, bulk, saveMode, editable, defaults, writeMode }, refresh }`.
+Davranış, rol ve sıralama yalnız SEÇİLİ alanlardan olur; `editable` yalnız seçili kök alanlardan (CD-004).
+Tanım filtresinde `"$ad"` yazılan değer istekteki `params.ad`'dan bağlanır. `cursor` (keyset) yalnız entity'de, tek
+sıralama anahtarıyla; sonraki sayfa `page.after` ← `meta.page.nextCursor`.
+
+**Politika arayüzü ezer.** Politikanın gizlediği alan yanıtta YOKTUR ve kolonu çizilmez, maskeli alan maskeli gelir —
+ayrıca gizlemeye gerek yok. **Maske önkoşulu:** maske alanın depolama korumasından gelir — alan önce
+`entity_protection_update { field, protection: { mode: 'masked', mask } }` ile korunmalı; korumasız alana politika
+`fieldAccess: 'masked'` verilirse değer DÜZ döner (ACC-017 warn). Maskeli gören özne o alanı SÜZEMEZ (describe
+`canFilter: false`, `operators: []` — koruma varsayılanı maskelidir, yetkili kullanıcı için de; 39/05). Açık (`plain`) gören
+öznede korumalı alanda yalnız `eq` · `neq` · `in` · `notin`,
+sıralama yok; `contains` istek gitmeden durur (CD-002).
+
+### İlişki, enum, dosya ve Lookup
+
+- İlişki alanı satırda hedef nesnesi olarak gelir: `sube: { id, ad }` (hangi hedef alanların geleceği
+  `expand` ile seçilir). `datatable`'da kolon tipi `relation`, hücre görünen alanı basar; m2m ilk üç
+  chip + `+N`; kullanıcı hedef tabloyu okuyamıyorsa hücre kilitli `—` (lookup ayarı etkisiz, CD-011 warn).
+- Enum alanı `tag` kolonunda seçeneğin etiketi ve rengiyle çizilir.
+- İlişki alanının seçim listesi aynı motordan gelir: runtime `op: 'lookup'` (hedefin anahtarı, görünen
+  alanı ve ilk düz alanları türetilir). Özelleştirmek için alanın `lookup` alt tanımı:
+  `{ slug: 'sube', lookup: { fields: [{ slug: 'ad' }, { slug: 'kod' }], behavior: { filterable: ['kod'], searchable: ['ad'] }, sort, page, mode: 'drawer' } }`.
+  `lookup` yalnız ilişki alanında olur ve içinde ikinci `lookup` olmaz (CD-011).
+- `datatable`'da ilişki hücresi ve filtre değeri lookup panelinden seçilir (o2m tekil, m2m çoklu) — akış yazılmaz.
+- **Seçim bileşeninin kendi lookup'ı** (`dropdown`, `multi-select`; `component_get.connectData.props.options.lookup`):
+  tanımın KÖK `lookup`'ı, alan lookup'ıyla aynı biçimde ama kaynağın kendi alanlarıyla
+  (`{ ..., lookup: { fields: [{ slug: 'kod' }], behavior: { filterable: ['sehir'] }, mode: 'drawer' } }`;
+  `fields` boşsa platform türetir). Açıkken alanın sağında ↗ çıkar ve pencere bileşenin kaynağını kolonlarla
+  listeler (multi-select'te çoklu seçim, önceki seçimler üstte). `connect_data_bind` entity kaynağına yeni
+  bağlamada açık yazar, `lookup: null` kapatır; kök lookup'sız eski bağlantı kapalı kalır. Ana tanımın filtresi
+  pencerede de geçerlidir. İstek alansız `op: 'lookup'` (`connect_data_execute`); yalnız entity kaynağında (CD-013).
+- Dosya alanı (describe `type: 'file'`, `operators: [isnull, isnotnull]`, sıralanmaz) satırda dosya nesnesi olarak gelir:
+  `{ id, display_name, path, size, extension, content_type, folder_id, absolute_path, … }`; boş dosya/ilişki alanı `null` ya da satırda hiç yok (runtime `list` anahtarı atar — ikisini de boş sayın; 39/05)
+  (38/M-6 backend düzeltmesiyle; eski imaj `{ absolute_path: '', type: 'ref' }` döndürüyordu). Dosya alanı
+  `edit.editable`'a KONAMAZ — bağlı bileşen dosyayı satır içinde yazmaz, platform kaydı 422
+  `connect-data-editable-file` ile reddeder (CD-018, bind dryRun'da block). Dosyayı `file_upload` + `row_update` yazar.
+
+### Yazma (`edit`)
+
+- Tanım: `edit { create, update, delete, bulk, saveMode: 'row'|'cell'|'batch', editable: [kök alanlar], defaults, writeMode: 'atomic'|'partial' }`.
+  `row` satırı ✓ ile kaydeder; `cell` var olan satırda yalnız çift tıklanan hücreyi açar, ✓/✕ hücrenin içindedir ve
+  ✓ yalnız o alanı yazar (yeni satır yine bütün olarak kaydedilir); `batch` değişiklikleri taslakta biriktirip birlikte kaydeder.
+  Bağlı `datatable`'ın düzenleme prop'larını runtime tanım ∧ politikadan yazar; hücre yalnız `editable` ∧ `canWrite`
+  alanda açılır. Kaydetmek için akış YOK: `save` bağlantı uca gider (create → update → delete).
+- Yazmayı önden denemek: `connect_data_execute { applicationId, pageId, element, prop, op: 'update', rows: [{ id, durum: 'pasif' }], asUserId }`
+  — bileşenin isteğinin aynısı, GERÇEKTEN yazar; tanımın izin vermediği istek gitmeden durur (CD-012). İlişki alanı
+  `'<id>'`, m2m `['<id>', …]` (tam liste); hedefte olmayan kimlik 404 `ConnectDataRelationTargetNotFound` (`field`).
+  `atomic` (varsayılan) TEK transaction'dır: `rowIndex` gönderilen dizinin indeksi — HİÇBİR satır yazılmadı.
+  `writeMode: 'partial'` (yalnız built-in veritabanı): yazılabilenler yazılır, yanıt `errors[{ row, field, code, message }]`.
+- **Zorunlu alan** (describe `isRequired`) create'te boş/eksik, update'te `null`/boş gönderilirse istek gitmeden kaynağa
+  değil motorda düşer: `422 BulkRowFailed`, `field` alanın slug'ı, `rowIndex` satır, iç neden `ConnectDataFieldRequired`
+  ("Başlık alanı zorunludur."); `partial`'da yalnız o satır `errors[]`'a (39/03 U-8 — önce veritabanının NOT NULL'u
+  alan adsız `400 RowValidationFailed` veriyordu). `defaults` create'te eksik alanı doldurur.
+- `defaults` yalnız create'te, istemci değeri ezer. Politikanın vermediği eylem ya da alan etkisizdir (CD-006).
+  Anonim sayfada açık yazma oturumsuz ziyaretçiye yazma verir (CD-017). Denetim izinde kaynak `CONNECT_DATA`.
+
+**Doğrulama tarifi.** `connect_data_get` (tanım + drift) → `page_screenshot` (satırlar çizildi mi, `runtimeErrors`
+boş mu; bağlama hatası `flowId: 'connect-data'`) → `connect_data_execute { op: 'list' }` (runtime yanıtı;
+`connect_data_preview` Studio ucudur, sayfa kapısını koşmaz). **Kompleks + `enforce` projede** gateway kimliği uygulama
+öznesi değildir: runtime araçları (`connect_data_execute`, `microservice_execute`/`_debug`, `page_runtime_get`,
+`page_screenshot`) kimliksiz 401 `AppSessionRequired` alır. **Parolasız kullanıcı gözü:** aynı çağrıya
+`asUserId: '<users satır id'si>'` — istek gateway kimliği + `impersonated-user-id` başlığıyla gider, özne o kullanıcıdır
+(politika, satır kapsamı, maske); `page_screenshot` sayfanın bütün isteklerine başlığı ekler (Studio "View as user"
+seçicisinin aynısı). Yalnız development/dal: production'da platform başlığı düşürür, gateway isteği göndermez.
+Oturum açılmış üye gerekiyorsa `access_session_create` + `asUser`. **Kaynağın kendi grant'i** (kompleks + `enforce`,
+ölçüldü 39/05): entity kaynağı `entity.read` (+ yazmada `entity.create/update/delete`, ilişki hedefi için hedefin `entity.read`)
+ister; workflow kaynağı `workflow.execute` (`workflow:<id>`), microservice kaynağı `microservice.execute` (`microservice:<id>`)
+ister — yoksa bağlantı 403 `ForbiddenException`. Query kaynağı (ve query kaynaklı uç) kapsamlı tabloya dokunuyorsa her
+kullanıcıda 403 `AccessQueryNotScoped` (ACC-005): kullanıcıya özel liste için entity ya da tablo ucu, özet rapor için sorguyu
+`isUnrestricted` yapın. `connect_data_convert`'in açtığı uç da ayrı `microservice.execute` ister (sayfanın bağlantısı istemez).
+Kullanıcıda `page.view` yoksa sayfa ve bağlantı 403
+döner — politikaya `page:<sayfa>` grant'i ekleyin. `connect_data_bind { asUserId }` CD-006/CD-011 uyarılarını o
+kullanıcının gözüyle üretir (gateway kimliği yöneticidir, bu iki uyarıyı hiç görmez).
+
+**Yasaklar.**
+
+- Bağlı prop'a `set_binding`, `set_prop_type` ya da `{ type: … }` sarmallı `replace_prop` yazılmaz;
+  flow setter bağlı prop'u hedeflemez. Runtime setter'ı atlar ve bileşene hiçbir şey yazılmaz (CD-005).
+  Yalnız örnek satırları değiştirmek için `replace_prop { value: [ham satırlar] }`.
+- Bağlantıyı kaldırmak `remove_connect_data { target, path }`: son satırlar static veri olarak kalır.
+- Platformun yönettiği tabloda (organizasyon, rol tabloları) düzenleme açılamaz (CD-003); `users` sistem tablosu
+  değildir, `password` alanı kabiliyette hiç yoktur.
+- Kaynaktan silinmiş alan tanımda kalırsa uyarı; `connect_data_bind { fixDrift: true }` her yerden (filtre, expand dahil) düşürür (CD-008).
+- Aynı sayfada aynı kaynağa 5+ bağlantı uyarıdır (CD-010).
+- **Parametreli kaynak** (query/workflow/microservice): `connect_data_describe` `source.parameters` bağlantının doldurabileceği parametreleri verir; `connect_data_bind { params: { yil: 2026, sube: '$secilenSube' } }` sabit değer ya da sayfa değişkeni yazar. Bilinmeyen ad block (CD-013); `$ad` `page_state`'te yoksa warn (CD-014, runtime `null` gönderir). Önizleme `$ad`'ı sayfa durumundan DOLDURMAZ:
+`connect_data_preview { request: { params: { yil: 2026 } } }` verin — verilmezse null bağlanır, sonuç sessizce boş döner — ya da null'da filtresini düşüren workflow'da TÜM satırlar döner (39/05)
+(CD-014 warn, sayfa değişkeninin başlangıç değerini önerir). Entity/view parametre almaz — filtre değerinde `$ad` kullanın.
+- **Microservice'e çevirmek** (`connect_data_convert { …, name, slug }`, yalnız sayfa): tanım microservice'e taşınır, prop `{ version: 1, microserviceId }` olur; flow aynı veriyi `microservice_execute { body: { op: 'list' } }` ile alır. Çevrilmiş prop'u bind reddeder: önce `connect_data_detach` (başka yerde kullanılıyorsa 409).
+
+Kuralların tamamı, uygulandığı yer ve kaynağıyla: `ngapps://rules/connect-data` (resource okuyamayan istemcide
+`platform_guide({ resource: 'ngapps://rules/connect-data' })`).
+
 ## Kural 1c-2 — Komponentin `name`'i JS TANIMLAYICISI olmalı (yoksa sayfadaki tüm ifadeler ölür)
 
 Runtime, ifade çalıştırmadan önce sayfadaki **her** komponent için bir değişken üretir:
@@ -670,14 +879,6 @@ Tire yerine `_` kullan.
 > `component_schema_patch` yamalarında), `layout_create`, `layout_update(views)` ve `layout_patch`;
 > `page_schema_validate` aynı kararı verir. Ad doldurulduktan sonra denetlenir: geçersiz bir
 > elementId adsız gelirse o da reddedilir.
->
-> **`name` hiç verilmezse** gateway onu `elementId` ile tamamlar ve `gatewayNormalized`'da `name`
-> diye bildirir: adsız düğümü platform kabul eder ama sayfada bir akış ya da `{{ }}` kod prop'u
-> varsa FlowEngine `runCode` "Cannot read properties of undefined (reading 'catch')" ile düşer, akış
-> `running:1`'de takılır ve hata adsız düğümü işaret etmez. Tamamlama PAGE-009 denetiminden ÖNCE
-> koşar, yani `elementId` bu kuralın geçerli saydığı bir ad değilse (`'Ana Baslik'`, `'1abc'`,
-> `'Functions'`) tamamlanan ad da reddedilir. Yine de her `add_component` gövdesine
-> `name = elementId` yaz; tamamlama bir güvenlik ağıdır.
 
 ## Kural 1d — Sayfa iskeleti: `page_container` ve boyutlandırma
 
@@ -693,9 +894,10 @@ Tire yerine `_` kullan.
 `isScrollable: true`, `appearance.heightType: 'auto'`). `container`, `form` ve `repeater` de aynı
 şekilde kapsayıcıdır — onların içine de `parent` vererek eklenir.
 
-Sayfa düzeyi olaylar (page load vb.) **bu kapsayıcıya** bağlanır:
-`set_event { target: 'page_container', event: 'mount', eventValue: <flow id> }`.
-`page_container`'ın kendi `isLoading` prop'u vardır — sayfa açılış akışında yükleniyor bayrağı olarak
+Sayfa düzeyi olaylar (page load vb.) **bu kapsayıcıya DEĞİL, sayfanın kendi `events`'ine**
+bağlanır: `page_update { events: [{ name: 'mount', value: <flow id> }] }` (Kural 1d-2).
+`page_container` Studio'nun Layers ağacında görünmez; ona `set_event` ile bağlanan akış çalışır ama
+tasarımcıda hiçbir yerden bulunamaz. `page_container`'ın kendi `isLoading` prop'u vardır — sayfa açılış akışında yükleniyor bayrağı olarak
 onu kullan. Bir `container` olduğu için **düzen prop'larını da alır**: çocuklarını ızgara yerine
 akışla (ortalama, sağa yaslama, aralık) dizmek istiyorsan `layout: 'flex'` — Kural 1f-2.
 
@@ -738,9 +940,10 @@ gateway **PAGE-011 / LAY-004** ile istek gitmeden reddeder.
 
 - Bağlama yolu `set_event` DEĞİLDİR (o komponent hedefler): sayfada `page_create` /
   `page_update`'in `events` parametresi, layout'ta `layout_create/update`'in `events`'i.
-- Sayfa açılış akışı için yerleşik desen `page_container.mount`'tur (Kural 1d) — ikisi de
-  çalışır; **`destroy` için tek yol buradaki sayfa olayıdır** (interval temizliği, "ayrılmadan
-  kaydet" uyarısı gibi işler).
+- **Sayfa açılış akışı buraya, sayfanın `mount` olayına bağlanır.** `page_container.mount` da
+  koşar ama kullanma: kapsayıcı Studio'nun Layers ağacında görünmez, bağ tasarımcıda bulunamaz
+  (Kural 1d). **`destroy` için de tek yol buradaki sayfa olayıdır** (interval temizliği,
+  "ayrılmadan kaydet" uyarısı gibi işler).
 - Akış kilidi burada da geçerlidir (Kural 3): önce bütün `flow_create`'ler, sonra events bağı.
 - Mevcut bağları `page_get` gösterir (`events[].value` = flow id).
 
@@ -896,14 +1099,15 @@ kullanır: `page.mappers.ts` `mapPageLayoutToPreview` — layout varsa çizilen
 >
 > Kural: **`isWrapper` yalnız gerçekten sayfa boyu kaplaması gereken kap içindir**
 > (`page_container` böyledir ve öyle kalmalı). Sadece "başlık/çerçeve çizilmesin" diye wrapper
-> yapma — o iş `container` için de `form` için de `style` ile yapılır (`background:'transparent'`,
-> `border:'none'`, `padding:0`). `form`'un eski `hideBorders`/`hidePadding` prop'ları
+> yapma — çerçevesiz kutu için `box` kullan; `container`'da çerçeve ve zemin `surfaceStyle` ile
+> kapatılır (dört `border*` yönü `'none'`, `background:'transparent'` — §Kap seçimi), `form`'da
+> `style` ile (`background:'transparent'`, `border:'none'`, `padding:0`). `form`'un eski `hideBorders`/`hidePadding` prop'ları
 > 2026-09-09'da şemadan kaldırıldı — bileşen onları hiçbir zaman okumuyordu, no-op'tu. Yanlış
 > `isWrapper`'ı düğümü silmeden düzelt: `resize_component { target, states: { isWrapper: false } }`
 > (platforma `set_states` olarak gider). `remove_component` + `add_component` ona yazan akış
 > setter'larını öldürür (`FLOW-018`).
 
-Mobil not: <768px'te ızgara tek kolona düşer (`RenderComponent` media query'si) — y sırası
+Dar ekran notu: <768px'te ızgara tek kolona düşer (`RenderComponent` media query'si) — y sırası
 dikey sıraya dönüşür, x/w yok sayılır. Yerleşimi masaüstü (breakpoint 1024) bloğuyla kur.
 
 ## Kural 1f-2 — Kapsayıcı düzeni: `flex` (varsayılan) ↔ `grid`
@@ -921,7 +1125,7 @@ aynı prop grubunu o da alır. Grup katalogda tanımlıdır, yani şemadan kurul
 | `horizontalAlign` | **`left`** · `center` · `right` · `stretch` | `row`'da ana eksen (`justify-content`), `column`'da çapraz eksen (`align-items`). |
 | `verticalAlign` | **`top`** · `middle` · `bottom` · `stretch` | `row`'da çapraz eksen, `column`'da ana eksen (rolleri `horizontalAlign` ile takas). |
 | `size` | **`shrink`** · `grow` | Çocuklara `flex: 0 1 auto` / `1 1 auto`. |
-| `gap` | `none` · `small` · **`medium`** · `large` **ya da ham CSS** | Preset'ler tema değişkenidir: 0 / `var(--ng-spacing-sm)` / `--ng-spacing-md` / `--ng-spacing-lg` (varsayılan temada 8/16/32px). Alan `allowCustom`'dır: `"18px"` ya da `"var(--ng-spacing-xl)"` gibi ham değer de geçer. `box-section`/`aibox`'taki sayısal `gapCustom` doluysa preset'i ezer. |
+| `gap` | `none` · `small` · **`medium`** · `large` | Preset'ler tema değişkenidir: 0 / `var(--ng-spacing-sm)` / `--ng-spacing-md` / `--ng-spacing-lg` (varsayılan temada 8/16/32px). Yalnız bu dört preset geçer: `"18px"` gibi ham değer platform doğrulamasında `invalid-enum-value` ile reddedilir. `box-section`/`aibox`'taki sayısal `gapCustom` doluysa preset'i ezer. |
 | `wrap` | kapalı · **açık** | `flex-wrap`. **Varsayılan 2026-09-01'de açık oldu:** `row` + `w:12` çocuklar artık alt satıra sararak dikey akar. Kapatırsan taşan çocuklar tek satıra sıkışır. |
 
 **`form` da bu grubun tamamını taşır (2026-09-01):** varsayılanları container ile aynı
@@ -997,10 +1201,10 @@ Beş şeyi bilmeden flex kurma:
 4. **`layout: 'grid'` iken diğer altı prop ÖLÜDÜR.** Katalogda tanımlı oldukları için
    doğrulama duvarı susar, renderer da okumaz: ızgara kapsayıcıya `direction: 'column'` yazmak
    sessizce hiçbir şey yapmaz. Gateway bunu **PAGE-015 (uyarı)** ile söyler.
-5. **Flex düzeni kırılım BİLMEZ.** `direction`/`gap`/hizalama masaüstü ve mobilde AYNIDIR;
-   sıra ve span'lar Desktop (1024) bloğundandır — Studio, mobil kırılım düzenlenirken flex
+5. **Flex düzeni kırılım BİLMEZ.** `direction`/`gap`/hizalama masaüstü ve dar ekranda AYNIDIR;
+   sıra ve span'lar Desktop (1024) bloğundandır — Studio, dar ekran kırılımı düzenlenirken flex
    bölgeyi salt-okunur kilitler. Kırılım bilen yalnız `blocks[]` ve `appearance.hideOn`'dur;
-   mobilde farklı davranış gereken satır için `layout: 'grid'` kullan (Kural 1f mobil notu).
+   dar ekranda farklı davranış gereken satır için `layout: 'grid'` kullan (Kural 1f dar ekran notu).
 
 ```jsonc
 // Ortalanmış giriş kartı — style ile CSS hack'i YOK, kabın kendi düzeni
@@ -1023,7 +1227,7 @@ gibi bitişik duracak elemanlar için ÜÇ şart birden gerekir; biri eksikse ar
 
 1. Her çocuğa **`appearance.widthType: 'auto'`** — içerik kadar yer kaplar (`flex: 0 1 auto`).
    Yazılmazsa eski 12 kolon payı geçerlidir ve çocuk kolonunu doldurur, bitişemez.
-2. Kaba **`gap: 'none'`** (ya da ham ince değer: `"2px"`, `"4px"` — alan `allowCustom`).
+2. Kaba **`gap: 'none'`** (ham ince değer yazılamaz — `"2px"` platformda 422; ince aralık gerekiyorsa çocuğa `appearance.marginType: 'custom'`).
 3. Her çocuğa **`appearance.marginType: 'none'`** — en çok atlanan şart: `marginType`
    yazılmamış düğüm `normal` sayılır ve her kenara 4px basar (`spacing.ts`
    `CANVAS_NORMAL_MARGIN`), yani `gap:'none'` olsa bile komşular arasında 8px kalır.
@@ -1100,8 +1304,9 @@ UYGULAMAZ** — koordinatları aynen kaydeder (aşağı itme yalnız `page_creat
 > Ölçüm: `radio`, `textarea`, `container`, `form`, `button` **var**; `text` ve `multi-select`
 > **yok**. Çözüm: gizlenecek komponenti `isHidden`'ı olan bir `container`'a sar ve koşulu
 > sarmalayıcıya bağla (yukarıdaki `box_multi`). Sarmalayıcıyı **`isWrapper:false`** kur
-> (Kural 1f: wrapper = `min-height:80vh`) ve çerçevesini `style` ile kapat:
-> `{ background:'transparent', border:'none', '&__body': { padding:'0px' } }`.
+> (Kural 1f: wrapper = `min-height:80vh`) ve çerçevesini `surfaceStyle` ile kapat (dört
+> `border*` yönü `'none'`, `background:'transparent'` — §Kap seçimi); gövde dolgusu
+> `style`'da kalır: `{ '&__body': { padding:'0px' } }`.
 > `appearance.isHidden` diye bir alan YOKTUR (2026-09-15'te platformdan kaldırıldı, S-16) —
 > görünürlük yalnız `props.isHidden`'dır.
 >
@@ -1132,15 +1337,22 @@ UYGULAMAZ** — koordinatları aynen kaydeder (aşağı itme yalnız `page_creat
 > SONRAKİ ağaca bakarak. Layout'ta da geçerlidir: kırılma
 > `_repeaterValues` geri yazmasındadır, barındıranın sayfa mı layout mu olduğuna bakmaz.
 >
+> **Mobil uygulamada** başlıklar altında gruplu liste (güne/kategoriye göre) iç içe repeater
+> gerektirmez: tek `grouped-list` (`groupBy` + başlık `{{ Section.title }}` + öğe şablonu) —
+> `platform_guide('mobile')` §Güne göre görev listesi. PAGE-013 mesajı mobilde bunu önerir.
+>
 > **Yapılacak:** satır içi listeyi tek bir `textarea`'da **satır başına bir öğe** olarak topla
 > (`options_text`), kaydederken `split('\n')`'le böl. Ölçülmüş çalışan sürüm: anket editörü
 > (`anket-admin/anket-duzenle`). Gerçekten satır satır düzenleme gerekiyorsa iç listeyi AYRI bir
 > sayfada/modalda yönet — iç içe repeater bunu karşılamıyor.
 
 > **Repeater satırını akıştan silmek/eklemek:** repeater ÇOCUĞUNDAKİ bir butonun click akışında
-> `RowIndex` doğru satırı verir, ve hedef repeater'ın KENDİSİ olduğu için `rows`'a yazmak serbesttir
-> (`isRepeaterSelf` dalı satır-değeri yoluna girmez). Ölçülmüş desen:
-> `q_list.rows = (q_list.rows || []).filter(function(r, i){ return i !== RowIndex; })`.
+> tıklanan satır olay makineye gitmeden SEÇİLİR, yani `q_list.selectedIndex` o satırdır — her runtime
+> sürümünde. Hedef repeater'ın KENDİSİ olduğu için `rows`'a yazmak serbesttir (`isRepeaterSelf` dalı
+> satır-değeri yoluna girmez). Desen:
+> `q_list.rows = (q_list.rows || []).filter(function(r, i){ return i !== q_list.selectedIndex; })`.
+> `RowIndex` de aynı satırı verir, ama yalnız ARC-121 düzeltmesini (2026-09-27) taşıyan runtime'da;
+> eskisinde akışta tanımsızdı.
 > Ekleme aynı şekilde `.slice()` + `push` ile yapılır; satır numarasını ekledikten sonra yeniden ata.
 
 **Gönderimi saklamak:** satır başına normalize kayıt yerine tek `TEXT` kolonda anlık görüntü
@@ -1149,6 +1361,45 @@ kendisi nesneye çevirir; Studio tablosunda `[object Object]` görünmesi normal
 (`platform_guide('entity')` → "TEXT kolonunda JSON"). Ekranın görsel tarafı için **Kural 1h**:
 tema `--ng-*` değişkenleriyle tek yerden çevrilir, `html` kaçış kapısına gerek kalmaz.
 
+## Kural 1g-2 — Mobil davranış: dört ayar, dört ayrı sahip
+
+Mobil listelerin davranışı TEK bileşende toplanmaz. Hangi ayarın kimde olduğunu bilmeden yazılan
+şema sessizce çalışmaz — prop var olmayan bileşene yazılır ve `page_schema_patch` onu düşürmez,
+çizer yok sayar.
+
+| Davranış | Sahip bileşen | Prop / olay |
+|---|---|---|
+| Çekerek yenile | `scroll-view` (listeyi SARAN kap) | `refreshable: true` + `refresh` olayı |
+| Sonsuz kaydırma | `scroll-view` | `scrollEnd` olayı (prop yok) |
+| Kaydırma eylemleri | `repeater` | `swipeActions: [{ key, label, tone, icon }]` + `swipe` olayı, payload `{ key, index, row }` |
+| Satıra dokunma | `repeater` | `itemPressable: true` + `itemPress` olayı, payload `{ index, row }` |
+
+Çekerek yenileyi `repeater`'a yazmak en sık hatadır: liste kendi kaydırmasını yapmaz, onu saran
+`scroll-view` yapar. `repeater` kökteyse (kap yok) yenileme hiç çizilmez.
+
+Satıra dokunmanın kartın `click`'iyle yapılan eski yolu mobilde bırakıldı: `itemPress` satır
+bağlamını payload'da taşır ve seçimi (`selectedIndex`) de yazar, yani akış satırı
+`<tekrarlayıcı>.selectedItem` ile okumaya devam eder.
+
+### `redirect.presentation`
+
+`redirect` adımının `args.presentation` alanı ekranın NASIL açıldığını söyler ve kapalı bir küme
+alır:
+
+- `push` — yığına ekler, geri düğmesi önceki ekrana döner (**varsayılan**; alan yazılmayabilir)
+- `modal` — alttan açılan ayrı bir sunum; geri onu kapatır, altındaki ekran yerinde kalır
+- `replace` — geçerli ekranı değiştirir, geçmişe girmez (giriş → ana ekran için doğru olan)
+
+Küme dışı bir değer **MOB-008** uyarısıdır ve backend doğrulayıcısı 422 döner. Alanı hiç yazmamak
+kusur değildir.
+
+**Sekme hedefinde `modal` çalışmaz.** Hedef sayfa bir sekmeyse gezinme her zaman `navigate`'e
+düşer: sekme yığını kendi geçmişini tutar ve modal onu kırardı. `presentation`ı yazabilirsiniz,
+çizer sessizce yok sayar — sekme dışı bir sayfaya modal istiyorsanız o sayfayı sekme listesinden
+çıkarın.
+
+Web uygulamasında alan yok sayılır; gateway web profilinde bu konuda bulgu üretmez.
+
 ## Kural 1h — Tasarım: `style` prop'u ve tema değişkenleri
 
 Her komponentin `style` prop'u vardır ve emotion `css()` bloğudur: iç seçiciler, pseudo-class'lar
@@ -1171,6 +1422,12 @@ yapmanın yolu budur — ölçülmüş kurallar (anket-doldur, 2026-08-19):
 > düğümleri silip yeniden kurmaya, o da 20 setter'ın sessizce kopmasına yol açtı. Gateway artık
 > kebab-case anahtarı camelCase'e çevirir ve `gatewayNormalized` ile bildirir; seçici anahtarlara
 > (`&__body`, `:hover`, `--ng-*`) dokunmaz.
+>
+> **İSTİSNA — satır içi stil dalları (TB-129).** Kural `style` prop'unun emotion bloğu olan
+> dalları içindir. `table.style.thead|th|tr|td` ise DOM'un `style` attribute'una string olarak
+> basılır ve orada **kebab-case zorunludur**; gateway bu dört alanın altına 2026-09-20'den beri
+> hiç dokunmaz (`INLINE_STYLE_FIELDS_BY_TYPE`). `table.style.root` ve öteki komponentler eskisi
+> gibi çevrilir. Çeviri bu dalları da camelCase yapınca stil sessizce düşüyordu (S2-39).
 
 **1. Temayı tek yerden çevir: `page_container.style` içinde `--ng-*` değişkenlerini ez.**
 Runtime bütün renk/tipografi/form tokenlarını CSS değişkeni olarak basar
@@ -1330,6 +1587,20 @@ kullanacağını bilmek gereksiz CSS yazmayı önler:
 | Şema prop'ları | yerleşim (`layout`/`direction`/`gap`/`gridColumns`), semantik renkler, boyut (`size`) | `replace_prop` |
 | `style` prop'u | geri kalan her şey; iç seçiciler, pseudo-class, `--ng-*` token ezme | `replace_prop` / `set_binding` |
 
+**Kap seçimi — çerçeve tasarımdan gelir, kaptan değil.** `container`'ın tabanı kart yüzeyidir:
+tema her `container`'a 1px `--ng-border-primary` çerçeve verir. Salt düzen için açılan kaplar
+(satır, sütun, başlık şeridi, buton grubu, gövde/iki sütun kabuğu) bu yüzden ekranda iç içe
+çerçeveler olarak görünür — kullanıcı bunu hata olarak bildirdi (qm `qms-dokumanlar`,
+2026-09-30: başlık şeridi, buton grubu ve içerik sütunu çerçeveli çizildi).
+
+1. Tasarımda o kutunun **çerçevesi yoksa `box` kullan** — `box`'ın tabanında çerçeve yoktur.
+2. `container` kullanmak zorundaysan (başlık bandı, `isLoading`, `page_container`, mevcut düğüm)
+   çerçeveyi **`surfaceStyle` ile kapat**, `style`'a ham `border` yazma:
+   `replace_prop { target, prop: 'surfaceStyle', value: { borderTop: 'none', borderRight: 'none', borderBottom: 'none', borderLeft: 'none' } }`.
+   Tek yön kalacaksa (ör. ayraç çizgisi) yalnız o yönü boş bırak. Zemin de istenmiyorsa
+   aynı gruba `background: 'transparent'`.
+3. Çerçeveyi yalnız tasarımda **gerçekten kart olan** kutu taşır (tablo kartı, özet kartı).
+
 **Dikkat — `appearance` kutunun İÇİNİ boyamaz.** Yüzey stili düğüm sarmalayıcısına
 (`.ng-app__node-item`) yazılır; `box` gibi kendi zeminini çizen bir komponentin içi bundan
 etkilenmez. Tipli stil modeline göçen komponentler bu boşluğu kapatır: `box` (ve emekli
@@ -1389,6 +1660,16 @@ alanları silinir. Gateway bu yüzden `page_update`'te sayfayı önce okur, yaln
 alanları değiştirip tam gövdeyi geri yazar (`layout_update` ve `component_update` de aynı).
 Yine de `schema` parametresini elle doldurursan okuduğun hâli değil, **verdiğin liste** yazılır.
 
+**`page_update` sürümsüz yazmaz (PAGE-039).** Platform sayfa PUT'unu `baseVersion` olmadan reddeder.
+`baseVersion` vermezsen gateway bu sayfada en son gördüğü sürümü gönderir: `page_get` ya da
+`page_schema_get` yanıtındaki `version`, `page_schema_patch`'in `newVersion`'ı ya da önceki
+`page_update`'in yazdığı sürüm. Hiçbiri yoksa istek **gönderilmez** — önce oku. Sayfa o sürümden beri
+değiştiyse (Studio'da açık sekme, başka ajan) 409 döner; mesaj güncel sürümü ve son yazmayı (zaman,
+kullanıcı, kaynak, revizyon) söyler ve hiçbir şey yazılmaz. Doğru yol yeniden okuyup değişikliği
+`page_schema_patch` ile yapmaktır; aradaki değişikliği bilerek ezmek için `force: true` son sürümü
+okuyup onun üstüne yazar ve yanıt `forced: true` taşır. Sebep: Bitki Bakım koşusunda sürümsüz bir
+tam gövde yazımı ana sayfayı ve profili boşalttı, akışları sildirdi (14:02).
+
 ### Atomiklik: 500 KB'lık şemada tek komponente dokunmak
 
 `page_schema_patch` şemanın tamamını göndermez — yalnız op'ları gönderir. Tam gövde ne LLM
@@ -1398,7 +1679,8 @@ ve geri yazar. Sözleşme (`PatchPageSchemaCommandHandler`):
 | Aşama | Ne yapar |
 |---|---|
 | Kilit | Sayfa başına 60 sn'lik dağıtık kilit; başka bir aktör yazıyorsa istek `PageSchemaLockedException` ile döner (409) |
-| Sürüm | `baseVersion` verdiysen `UpdatedAt.Ticks` ile karşılaştırılır; tutmazsa `PageSchemaVersionConflictException` (409) ve **hiçbir op uygulanmaz** |
+| Sürüm | `baseVersion` verdiysen `UpdatedAt.Ticks` ile karşılaştırılır; tutmazsa `PageSchemaVersionConflictException` (409) ve **hiçbir op uygulanmaz** — bütün op'lar etkisizse hariç (aşağıdaki "Tekrar" satırı) |
+| Tekrar | `add_component`'in `elementId`'si zaten varsa ve düğüm istenen ebeveynde, istenen içerikle duruyorsa op **etkisizdir** (hata değil; konum karşılaştırılmaz). Hedef düğümü değiştirmeyen `replace_prop`/`set_*`/`add_event` da etkisizdir. Bütün op'lar etkisizse yama yazılmaz, sürüm artmaz ve eski `baseVersion`'a rağmen 200 `noop: true` döner; sürüm eskiyse `stale: true` ve `newVersion` sizin gönderdiğinizdir. Aynı id'de farklı düğüm hâlâ 422 `duplicate-id`'dir |
 | Uygulama | Her op hedefini ağaçta arar (`Find` → JSON Pointer) ve **yalnız o düğüme** dokunur; kardeşler, üst düğümler ve diğer alt ağaçlar bit düzeyinde korunur |
 | Hep-ya-hiç | Op'lar önce bellekte uygulanır; **tek bir hata** (bilinmeyen op, bulunamayan hedef, tekrar eden elementId, doğrulama) tüm komutu düşürür — kısmi yazma yoktur |
 | Doğrulama | Tam şema `PageSchemaValidator`'dan geçer (422 + alan bazlı `errors`) |
@@ -1407,7 +1689,18 @@ ve geri yazar. Sözleşme (`PatchPageSchemaCommandHandler`):
 
 Yanıt üç alan döner: `applied` (uygulanan op sayısı), **`appliedPatch`** (her op'un şemada tam
 olarak hangi JSON Pointer'a ne yaptığı — RFC 6902 biçiminde; "gerçekten yalnız o komponente mi
-dokunuldu" sorusunun kanıtı) ve **`newVersion`** (`UpdatedAt.Ticks`).
+dokunuldu" sorusunun kanıtı) ve **`newVersion`** (`UpdatedAt.Ticks`). Etkisiz op varsa `unchanged`
+(elementId listesi) ve `alreadyApplied` cümlesi gelir; hepsi etkisizse `noop: true`.
+
+**Yanıt kaybolursa aynı gövdeyle tekrarla.** Ağ koptu, zaman aşımı oldu ve yamanın uygulanıp
+uygulanmadığını bilmiyorsan aynı `page_schema_patch`'i **aynı gövde ve aynı `baseVersion`** ile
+yeniden gönder. Uygulanmışsa `noop: true` + `alreadyApplied` döner, hiçbir şey ikinci kez yazılmaz;
+uygulanmamışsa yama şimdi uygulanır. `add_component` (gövdede `id` verme — platform her istekte yeni
+`id` üretir, karşılaştırma onu yok sayar), aynı değeri yazan `replace_prop`/`set_*` ve aynı bağı kuran
+`add_event` tekrarda etkisizdir. İki istisna: `remove_component` ikinci kez `unknown-target` döner — o
+durumda `page_schema_get` ile bak; eklediğin düğümün bir prop'unu aynı yamanın sonraki op'u
+değiştirdiyse tekrar `duplicate-id` alır. Yanıt `stale: true` taşıyorsa sayfa sürümünden beri başka bir
+yazımla da değişmiştir: devam etmeden önce yeniden oku. `idempotencyKey` yoktur ve gerekmez.
 
 > **`appliedPatch` gövdesi VARSAYILAN OLARAK iskelettir.** Girdi `{ op, path }` döner; eklenen
 > düğüm `component` altında yalnız `id`/`elementId`/`name`/`type`/`children` taşır. Kanıt zaten
@@ -1427,12 +1720,29 @@ yamanın `baseVersion`'ıdır. Kontrol platformda atomiktir (satır kilidi + sü
 `UPDATE`'te), yani iki çağrı arasına giren yazarı da yakalar. `baseVersion` vermezsen gateway yalnız
 bu çağrıda zaten okuduğu sayfanın sürümünü gönderir; hiç okumadıysa yama sürümsüz gider ve son
 yazan kazanır. Eski `expectedUpdatedAt` hâlâ çalışır ama `baseVersion`'ın yerini tutmaz.
+
+**Studio da sürüm gönderir (2026-09-26, ZM-27).** Önceden Studio'da açık kalan bir sekme, yayını
+kaçırdığı yamalarının üstüne kendi eski (bir kez boş) şemasını yazıyor ve bağı kalmayan akışları
+sildiriyordu. Artık Studio'nun her kaydı sürüm taşır: eski sekme 409 alır ve taslağını senin
+yazdığının üstüne birleştirir. `revision_list`'te yamandan sonra `source: studio` satırı görürsen bu
+artık bir üzerine yazma değil, birleştirilmiş bir kayıttır — yine de `revision_diff` ile bak.
 Yanıttaki `touched`, kaydı değişen elementId'leri listeler (eklenen alt ağaç dâhil).
 
 > **Büyük şemada çalışma sırası:** `mode:'summary'` ile ağacı çıkar (props yok, 500 KB'lık sayfada
 > bile küçük) → hedefin `elementId`'sini al → gerekiyorsa `mode:'subtree'` ile yalnız o dalı oku →
 > op'ları `page_schema_validate` ile kuru koştur → `page_schema_patch`. `mode:'full'` yalnız
 > gerçekten tüm şema gerektiğinde çağrılır.
+>
+> **`full` sığmazsa hata verir, kırpmaz.** Yanıt boyut sınırını aşan şemada `mode:'full'` hata döner
+> ve düğüm sayısını söyler. Tamamı gerekiyorsa `cursor:'0'` ile oku ve `nextCursor` gelmeyene kadar
+> sür: her parça `items[]` taşır, kalem `parentElementId` düğümünün `children[index]`'inin yerine
+> geçer (`parentElementId` yoksa kök dizinin `[index]`'i); alt ağacı sığmayan düğüm kabuk gelir
+> (`children: [{ elementId, deferred: true }]`) ve sonraki kalemler onu doldurur. Toplanan düğüm sayısı
+> `nodeCount`'a eşit değilse okuma eksiktir. Okuma arasında sayfa değişirse 409 — baştan başla.
+> `allowTruncated:true` kırpılmış gövdeyi açıkça verir (`truncated: true`); o gövdeye dayanan
+> `page_schema_patch` PAGE-038 uyarısı taşır. **`page_update`'e kırpık ya da yarım şema gönderme:**
+> PUT tam REPLACE'tir, eksik düğümler geri dönüşsüz silinir — gateway düğüm eksilten şemayı
+> `allowNodeLoss:true` olmadan PAGE-043 ile reddeder.
 
 > **`remove_component`'in yan etkisi — tek istisna.** Sayfa kaydedilirken artık hiçbir komponent
 > olayının, prop'unun ya da sayfa olayının referans vermediği akışlar platformca **kalıcı olarak
@@ -1478,19 +1788,24 @@ patch'te bütün `set_event`'ler:
 ```
 page_create → page_schema_patch (tüm add_component)
             → TÜM flow_create'ler
-            → TEK page_schema_patch (bütün set_event'ler)
+            → TEK page_schema_patch (bütün set_event'ler) + page_update { events } (sayfanın mount'u)
 ```
 
 Sonradan akış eklemen gerekirse sayfayı baştan kurmana gerek yok — **bağı geçici olarak çöz**:
 
 ```jsonc
-1) page_schema_patch [{ "op":"set_event", "target":"page_container", "event":"mount", "eventValue": null }]
+1) page_schema_patch [{ "op":"set_event", "target":"<bağlı komponent>", "event":"click", "eventValue": null }]
+   page_update { events: [] }            // sayfanın kendi mount/destroy bağları
 2) flow_create × N
-3) page_schema_patch [ bütün set_event'ler tek seferde ]
+3) page_schema_patch [ bütün set_event'ler tek seferde ] + page_update { events: [...] }
 ```
 
 `eventValue: null` olay kaydını bırakıp değerini boşaltır ve kilidi açar.
 
+> Ölçüm 2026-09-25 (`egitim-portali` › `surecler`, Studio'nun `POST pages/<id>/flows` çağrısı):
+> sayfada `page_container.mount` ve komponent olayları bağlıyken yeni akış **reddedilmeden**
+> oluştu. Kilit artık her durumda devrede olmayabilir; yine de sıralı kuruluş güvenli yoldur.
+
 > **Aynı kilit LAYOUT'ta da vardır** (ölçüm 2026-08-18: menüye yeni bağlantı eklerken
 > `POST /layouts/<id>/flows` aynı hatayı verdi). Layout'ta sıra sayfadakiyle aynıdır ve bağlar
 > `layout_schema_patch` ile yazılır: `flow_create × N` → TEK `layout_schema_patch` (bütün
@@ -1543,7 +1858,9 @@ isimlerine bağlanır.
 
 **Platform değişkenleri tek tek değil SET olarak tutar:** uygulama başına bir kayıt, sayfa başına
 bir kayıt (`variable_create` `pageId` verirsen sayfa, vermezsen uygulama düzeyi). Kayıt zaten varsa
-create update'e döner. Şekil `[{ key, value }]`; `value` **herhangi bir JSON** olabilir:
+create update'e döner. Şekil `[{ key, value, storage? }]`; `value` **herhangi bir JSON** olabilir.
+State **bellektedir** — sayfa her açıldığında `value`'dan başlar; `storage: 'device' | 'secure'` yalnız
+mobil uygulamada değeri cihazda saklar (`platform_guide('mobile')` §Kalıcı state, `MOB-014`):
 
 ```jsonc
 variable_create({ applicationId, pageId, variables: [
@@ -1555,7 +1872,7 @@ variable_create({ applicationId, pageId, variables: [
 - Uç seti **komple değiştirir**; gateway mevcut seti okuyup anahtar bazında birleştirir. Kasten
   silmek için `replace: true`. `variable_delete` **setin tamamını** siler.
 - Platform `data`'yı JSON **string** olarak saklar (`"[{\"key\":…}]"`); gateway çeviriyi iki yönde
-  de yapar — `variable_list` sana `[{key, value}]` döndürür. Ham HTTP kullanıyorsan string
+  de yapar — `variable_list` sana `[{key, value, storage?}]` döndürür. Ham HTTP kullanıyorsan string
   zorunludur: gövdede yalnız `data` alanı okunur, `name`/`type`/`defaultValue` gibi alanlar
   **sessizce yok sayılır** ve kayıt boş yazılır (istek yine 200 döner).
 
@@ -1714,7 +2031,8 @@ ya da `set_binding { prop: 'isHidden' }` (Kural 7a'daki `isHidden` notu).
 
 **Kip ayrımı query parametresidir:** aynı sayfa `?id=<kayıt>` ile edit, parametresiz create.
 
-`mount` akışı (`page_container` ya da `form` üzerine bağlanır):
+`mount` akışı (sayfanın kendi `mount` olayına — `page_update { events }` — ya da `form` üzerine bağlanır;
+`page_container`'a değil, Kural 1d-2):
 
 ```
 start → [setter] page_container.isLoading = true
@@ -1876,15 +2194,24 @@ page_container
 ```
 start → [setter] btn.isLoading = true, btn.isDisabled = true, notification gizle
       → [microservice] sign-in (POST; email + password body'den)
-      → [condition] !!Steps.signIn.data.token
-          ├─ always → [setter] buton durumunu sıfırla
-          ├─ if   → [setcookie] { name:'APP_Token', value:'Steps.signIn.data.token',
-          │                        expiresInHours: 240 }
-          │         → [redirect] hedef sayfaya
-          └─ else → [setter] notification.content =
-                      { type:'code', ref:'Steps.signIn.data.message || "Giriş başarısız"' }
+          ├─ error  → [setter] btn.isLoading=false, btn.isDisabled=false,
+          │            notification.content =
+          │              { type:'code', ref:'Steps.signIn.error?.message ?? "Giriş başarısız"' }
+          └─ always → [condition] !!Steps.signIn.data.token
+                        ├─ always → [setter] buton durumunu sıfırla
+                        ├─ if   → [setcookie] { name:'APP_Token', value:'Steps.signIn.data.token',
+                        │                         expiresInHours: 240 }
+                        │          → [redirect] hedef sayfaya
+                        └─ else → [setter] notification.content =
+                                    { type:'code', ref:'Steps.signIn.error?.message ?? "Giriş başarısız"' }
 ```
 
+- **`sign-in` adımının `error` dalı burada ZORUNLUDUR, süs değil.** Dal bağlı değilken bu şablonun
+  `condition`'ı `Steps.signIn.data.token`'ı okur ve gateway'i **FLOW-038** ile uyarır (yukarıdaki
+  "Hangi yolu seçeceksin" notu): hata anında `data` `null`'dur, token okuması sessizce `undefined`
+  döner. Dal bağlanınca hata onun üzerinden sürer — `always`/`condition` yalnız BAŞARIDA çalışır,
+  yani `data.token` orada gerçek bir iş kuralıdır (uç 200 dönüp token'sız yanıt verirse), hata
+  algılama YÖNTEMİ değil.
 - **Cookie adı middleware'in okuduğu adla birebir aynı olmalı** (`cookie.APP_Token` —
   `platform_guide('middleware')` Tarif 1). Uyuşmazlık sessizce "hep 401" demektir.
 - `redirect` adımı `isRaw: true` iken `path` **çok satırlı JS bloğudur** (son ifade değeri döner) —
@@ -2074,9 +2401,14 @@ hiçbiri** bağlı değildi; üç portalın da rol menüsü boş çıkıyor, pan
 > (`dto_get` ile bak: genelde `role`, `role_name`, `roles_csv` vardır). Sayfa tarafında CSV
 > kullan — ayrıntı ve şablon `platform_guide('expressions')` §2.
 >
-> **Uç hata dönerse `.data` dizi değildir.** 401/404 sonrası `Steps.x.data` bir nesnedir ve
-> `rows || []` bunu yakalamaz (nesne truthy) → `rows.filter is not a function` /
-> `(items ?? []).map is not a function`. `Array.isArray(Steps.x?.data) ? Steps.x.data : []` yaz.
+> **Uç hata dönerse `.data` NULL'dur, hata gövdesi değil (ADR 0004, 2026-09-26).** 2026-09-26'ya
+> kadar `Steps.x.data` 401/404 sonrası hata gövdesiydi ve `rows || []` bunu yakalamıyordu (nesne
+> truthy) → `rows.filter is not a function` / `(items ?? []).map is not a function`; artık uç hata
+> dönünce `data` **null**'dur ve bu adım boş veriyle koşar — `rows` gibi bir listeye bağlarsan
+> bileşen `null`'ı boş liste sayar, `Array.isArray(...) ? ... : []` sarmalamaya artık gerek yok.
+> Hata OLDUĞUNU fark etmeden geçmemek için `error` dalı bağlayın (yukarıdaki §"4xx de hatadır",
+> gateway bunu bağlı değilken **FLOW-038** ile uyarır); hata gövdesini görmek istiyorsan
+> `Steps.x.error.body`'yi okuyun.
 
 ## ⚠️ `page_schema_patch` `html` komponentini reddediyor — katalogda mükerrer kayıt (2026-08-19)
 
@@ -2139,6 +2471,44 @@ micro-op hattına dönün.
 > uyarı yoktu. Silinmesini bilerek istiyorsanız çağrıyı `allowFlowDeletion: true` ile tekrarlayın;
 > yanıt `deletedFlows` ile hangi akışların gittiğini listeler.
 >
+> **Silinen akış geri kurulabilir (2026-09-26, ZM-27).** Sayfa kaydının sildiği akış artık revizyon
+> defterine `operation: delete` satırı olarak düşer (kaynağı `studio` ya da `mcp`). `flow_restore`
+> akışı son revizyonundaki ad, slug ve adımlarla AYNI id ile yeniden kurar; olaya bağlamaz —
+> geri geldikten sonra `set_event`. İki sınır: revizyon saklama süresi (budanan akış 404) ve
+> adımların hedeflediği komponentler — akış bir komponenti tetikleyen/parametre olarak
+> gösteriyorsa o komponent şemada durmalıdır (canlı ölçüldü: `flow_restore` "Trigger Element Id"
+> dış anahtarına çarpar).
+>
+> **Boşalan sayfa: `page_restore` (2026-09-26).** Sayfayı ve akışlarını birlikte geri kurar:
+> `revision_list(module: 'page', recordId: <pageId>)` → boşalmadan önceki revizyonu bul (`source` ve
+> `correlationId` yardım eder; `revision_get` ile içeriğine bak) → `page_restore({ revisionNo })`.
+> Platform önce eksik akışları adımsız kurar, sonra şemayı eski komponent id'leriyle yazar, sonra
+> adımları yazar — akış→komponent ve olay→akış dış anahtarları bu sırayla tek transaction'da çözülür.
+> Yanıt `restoredFlows` ve `deletedFlows` (N'den sonra bağlanmış, şimdi yetim kalan) döner.
+> Revizyonu kalmamış bir akış varsa 409 ve hiçbir şey yazılmaz.
+>
+> **Doğru revizyonu seç.** Şemayı yüklemeyen komutların (`UpdateProjectCommand`,
+> `UpdateApplicationCommand`…) yazdığı sayfa revizyonları komponent taşımaz; komponenti olan sayfayı
+> böyle bir revizyona döndürmek 409 `PageRevisionEmptyException` ile reddedilir (bilerek boşaltmak için
+> `allowEmpty: true`). `correlationId`'si `PatchPageSchemaCommand` ya da `UpdatePageCommand` olan
+> revizyonu seç. İki sınır daha: N'den beri silinen layout/rol/middleware/özel komponent ya da başka
+> sayfanın aldığı slug geri yüklemeyi dış anahtar/benzersizlik hatasıyla düşürür (transaction geri
+> alınır, veri kaybı yok); yalnız başka bir akışın adımından çağrılan (olaya bağlı olmayan) akışlar
+> geri kurulmaz — onlar için `flow_restore`.
+>
+> **Koruma op listesinin SONUCUNA bakar (TB-125).** İstek atomik olduğu için doğru soru tektir:
+> yama bittiğinde bu akışa referans kalıyor mu? Aynı yamada akışı başka bir düğüme bağlayıp
+> eskisini silmek (`add_component` + `set_event` + `remove_component`) artık TEK çağrıda geçer;
+> 2026-09-20 öncesinde koruma her op'a tek başına baktığı için düğüm taşıyan her yama ikiye
+> bölünmek zorundaydı (S2-35). Akışı gerçekten referanssız bırakan yama hâlâ durur.
+>
+> **Satır aksiyonları statik şemada görünmeyebilir (TB-126).** `table`/`datatable`'ın
+> `actions[].flow` bağı `{ type: 'flow', ref }` olarak sayılır — ama bu prop'u çoğu zaman YÜKLEME
+> AKIŞI çalışma zamanında yazar (aksiyon role göre eklenip çıkarılıyorsa başka yolu da yok) ve o
+> hâlde şemada `actions` BOŞ durur. `flow_list` böyle bir barındırıcıda `unboundFlowIds` yanına
+> `mayBeBoundAtRuntime: true` koyar: "bağsız akışları temizle" refleksinden önce akışın gerçekten
+> sahipsiz olduğunu doğrulayın (S2-36).
+>
 > **FLOW-018 artık silinen düğümün ALT AĞACINI da görüyor.** Eskiden yalnız op'un kendi
 > `target`'ına bakılıyordu: bir kapsayıcı silinince ÇOCUĞUNA yazan setter sessizce kopuyor ve
 > uyarı hiç çıkmıyordu (09-05, `sign_in_form` → `btn_sign_in`).
@@ -2182,6 +2552,9 @@ micro-op hattına dönün.
   style + Kural 1h deseniyle yeniden kurulunca kart 400px'e ve ortaya oturdu. Gateway bunu **PAGE-014 (uyarı)** ile
   yanıtın `layoutWarnings` alanında bildirir. **Düzeni `style` ile kurmaya hiç kalkışma:**
   ortalama/yaslama/aralık işi kapsayıcının kendi `layout: 'flex'` prop grubuna aittir (Kural 1f-2).
+  **İstisna `html`:** onun `style`'ı yazarın işaretlemesine kapsamlı giren CSS metnidir (web'de iç
+  seçicili sınıf, mobilde belgenin stil bloğu) — string asıl biçimdir ve PAGE-014 onda susar. Mobilde
+  `html`'e nesne `style` verme: çizilmez (MOB-002).
 - **Menüde "bulunduğun sayfa" vurgusu: `sidebar`/`layout`'ta `activeHref`, `header`'da
   `activeNavHref`.** `sidebar` ve `layout` menü ağacını ortak renderer'la çizer: `activeHref` boşken
   tarayıcıdaki adrese uyan satırı kendileri vurgular, prop yazılırsa o satır vurgulanır (akıştan
@@ -2231,6 +2604,13 @@ micro-op hattına dönün.
   elemanıdır; başlığı da `__header` bloğunu da render etmez (klinik ölçümü: `__header` sayısı 0).
   `isWrapper: false` olan ve başlığı açıkça verilen kapta başlık normal çizilir. Kart başlığını garantiye almak istiyorsan kabın
   `title`'ına güvenme, **içine bir `text` komponenti** koy.
+- **`selectedRow`'un ALANLARI sarmalı korur.** `tbl.selectedRow` prop olarak çözülür ama içindeki
+  alanlar `{data, type}` nesneleri olarak kalır: `mapSchemaPropToRawProp` yalnız üst düzey prop'u
+  açar, satırın iç alanlarını açmaz. `tbl.selectedRow.id` bu yüzden bir **nesnedir**, ham değer
+  değil — uca öyle gidince güncelleme hiçbir satırı tutmaz ve sonuç sessizdir (ölçüldü 2026-09-19:
+  `PUT kredi-onayla` → **404**). İfadede `tbl.selectedRow?.id?.data ?? tbl.selectedRow?.id` yazın;
+  aynısı satır eşlemesinden gelen her alan için geçerlidir (S-22).
+
 - **Kod prop'unun ifadesi `ref`'te ve `{{ }}` sarılı olmalı.** `{type:'code', ref:"'' + Row.value"}`
   (süssüz) ekrana ifadenin **kendisini** basar; ifade yalnız `data`'da olursa prop **boş**
   render edilir. `set_binding` micro-op'u eski sürümlerde `data`'ya yazıyordu — bu davranış