@appaflytech/zeyrek-ai-mcp 0.0.28 → 0.0.30

package/dist/resources/guides/expressions.md

@@ -14,8 +14,10 @@ Uydurma fonksiyon adı runtime'da `X is not defined` 500'üdür — yalnız bura
 
 **Değişkenler:** step çıktıları (`<stepAdı>.data`), middleware değişkenleri (`user`,
 `settings`, `permissions`… — `workflow_middleware_variables` ile keşfet), HTTP bağlamı:
-`cookie`, `header`, `queryString`, `body`, `triggerSource`/`context` (tetikleyen ucun
-type/name/roles/impersonatedUserId'ı). Gövde bir JSON **nesnesi** ise `body.alan` diye okunur,
+`cookie`, `header`, `queryString`, `body`, `triggerSource` (tetikleyen ucun
+type/id/name/slug/roles/pathAndQuery'si — emekliye ayrılacak) ve `context`
+(type/name/roles/path/impersonatedUserId/language). **Kimlik devri yalnız `context.impersonatedUserId`**'dedir;
+`triggerSource`'ta bu alan yoktur (MW-006). Gövde bir JSON **nesnesi** ise `body.alan` diye okunur,
 gövde bir JSON **dizisi** ise `body[0].alan` diye — 2026-09-04 öncesinde nesne gövde de diziye
 sarılıyordu ve `body.alan` sessizce `undefined` dönüyordu, bu yüzden gövdeye bakan yetki kapıları
 açık kalıyordu. Workflow'da istek girdisi `input.`, automation'da
@@ -97,14 +99,16 @@ dalından devam eder.
 |---|---|
 | `Page` | `Page.user`, `Page.variables`, `Page.components`, `Page.properties`, `Page.queryParams`, `Page.authorized(roles)` |
 | **Komponent adları** | Her komponent adıyla doğrudan değişkendir: `specialties_table.rows = data` hem prop'u yazar hem UI'ı günceller (change event). Addaki `-` silinir: `tickets-table` → `ticketstable` |
-| `state.page` / `state.app` | Kalıcı state (oku/yaz): `state.page.selectedId = row.id`. **Tanımlı değişkenler de buradadır:** `variable_create` ile yazılan her `key` sayfa düzeyinde `state.page.<key>`, uygulama düzeyinde `state.app.<key>` olur; `value` nesneyse alanlarına inilir (`state.page.MyTest.isActive`) |
+| `state.page` / `state.app` | Sayfa/uygulama state'i (oku/yaz): `state.page.selectedId = row.id`. **Bellekte yaşar** — sayfa her açıldığında tanımlı `value`'dan başlar; mobil uygulamada kalıcı olması için değişkene `storage` verilir (`platform_guide('mobile')` §Kalıcı state). **Tanımlı değişkenler de buradadır:** `variable_create` ile yazılan her `key` sayfa düzeyinde `state.page.<key>`, uygulama düzeyinde `state.app.<key>` olur; `value` nesneyse alanlarına inilir (`state.page.MyTest.isActive`) |
 | `Steps` | Adım çıktıları: `Steps.load_specialties` — anahtar adımın **ADIdır**, `stepId` değil (`setStorage(task.name, …)`); `Steps.<adım>.error` o adımın hatası — ama YALNIZ HTTP durum metnidir (401 için `'Unauthorized'`), ucun mesajı değil. `Steps.error` ise hata akışı için doldurulur (`onError` koşmadan önce `setStorage('error', …)` yapar) ve **yalnız orada okunur**: storage sayfa başına tek `FlowMachine`'de yaşar, ama dışarıdan başlayan her akış başlarken `'error'`'u ve kendi adımlarının önceki değerlerini temizler (`flow-engine.ts` `run`, 2026-09-25) — normal akışta `Steps.error` boştur; hata akışı ve onun tetiklediği akış (`nested`) onu görür ve şekli `{ message, code, step: { id, name, type, data } }`'dir: kullanıcıya gösterilecek metin `Steps.error.message`'tır (`err.response.data.message`, boşsa durum metni). **Başarılı bir adımda `Steps.<adım>.data` gerçek bir `Array`'dir** — `.map` · `.filter` · `.concat` · `.length` çalışır. Adım HATA dönerse aynı alan ucun hata gövdesini taşır; aşağıdaki kutuya bakın |
-| `self` · `item` · `Row` / `RowIndex` | Tetikleyen komponent (yazılabilir) · repeater/tablo satırı (yazmak satırı günceller) |
+| `self` · `item` · `Row` / `RowIndex` | Tetikleyen komponent (yazılabilir) · repeater/tablo satırı (yazmak YALNIZ o satırı günceller). Satır AKIŞINDA (satırdaki düğümün olayı) ARC-121 düzeltmesini (2026-09-27) taşıyan runtime gerekir, eskisinde boştu — sürümden bağımsız yol `<liste>.selectedItem` / `.selectedIndex`. Tekrarlayıcının KENDİ `change`/`select` akışında satır bağlamı yoktur. `item.x = …` yazımı tekrarlayıcının `change` olayı olarak iletilir: `change`'e bağlı akış her yazımda koşar, o akış da `item`'a yazarsa döngü olur |
 | `event` | `{name, data, source: {id, props}}` |
 | `cookie` | `cookie.get(name)` / `cookie.set(name, value, {expiresInHours, path})` / `cookie.remove(name)` — tarayıcı cookie'si |
 | `setComponentProperty(name, key, value)` / `getComponentProperty(name, key)` | fonksiyon alternatifi |
 | `resetForm(name)` | Formu sıfırlar: alanlar başlangıç değerine döner, form "gönderilmemiş" olur, doğrulama mesajları silinir. Kayıt sonrası "yeni kayıt" için alanları tek tek `null`'a çekme — gönderilmiş formda her biri "zorunlu alan" mesajı çıkarır. Ad ya da komponent değişkeni alır: `resetForm('risk_form')` / `resetForm(risk_form)`. **Yalnız UI flow kodunda** |
-| `LocalStorage` · `Widget` · `params` | yerel veri · widget bağlamı · olay parametreleri |
+| `LocalStorage` · `Widget` · `params` | yerel veri · widget bağlamı · olay parametreleri. `LocalStorage` barındırıcının deposudur, salt okunur ve değerler METİNdir: web'de uygulamanın kökenindeki `localStorage` (Studio önizlemesinde Studio'nun kendi anahtarları da görünür), cihazda akışın `storage` deposu. `storage` adımı düz bir anahtara yazınca `LocalStorage.<anahtar>` aynı akışta yeni değeri verir ve sayfanın bağları yeniden değerlendirilir (`isSelected: {{ LocalStorage['zeyrek:theme-mode'] === 'dark' }}`). `state.page\|app.<key>`'e yazan adım `LocalStorage`'a girmez (ARC-147, 2026-09-29) |
+| `Device` | Salt okunur cihaz durumu, barındırıcı günceller: `Device.isOnline` — ağ bağlantısı var mı (bilinmiyorsa `true`). Değişince sayfanın bütün bağları yeniden değerlendirilir; çevrimdışı bandı: `isHidden: {{ Device.isOnline }}`. Cihazda `expo-network`, web'de tarayıcının `online`/`offline` olayları. `Device` adında komponent ifade bağlamından süzülür (ayrılmış ad) |
+| **Ayrılmış adlar** | Bu tablodaki globallerle (ve önsözün iç adlarıyla: `payload`, `error`, `repeaterId`, `_` ile başlayanlar…) aynı `name`'i taşıyan komponent (runtime yalnız İLK `-`'yi siler: `ite-m` da `item` sayılır) ifadede kendi adıyla GÖRÜNMEZ — süzülür, uyarı loglanır (liste: `@ng-apps/flow` `EXPRESSION_PRELUDE_NAMES`). Eskiden aynı ad sayfanın BÜTÜN ifadelerini `SyntaxError`'la düşürürdü (ARC-143). Gateway artık bu adların HEPSİNİ **PAGE-009** ile sayfa/layout yazma yollarında ve `page_schema_validate`'te istek gitmeden reddeder — komponente `t`, `state`, `event`, `item`, `self`, `Page`, `Row` gibi ad verme |
 | `t(key)` | Çeviri anahtarını çözer: aktif dil → projenin varsayılan dili → anahtarın kendisi. Boş string de "eksik" sayılır. Sözlük `machine.context.state.translations`'tan gelir; dil `language-selector` ile değişince bir sonraki çağrı yeni dili görür. **Yalnız UI flow kodunda vardır** — backend ifadelerinde karşılığı `Loc()`'tur (`platform_guide('workflow')`) | `t('home.welcome')` |
 | `log(...)` | console (proxy'leri temizler) |
 | `Functions` | **Kullanıcı fonksiyonları** (`function_create`): `Functions.toplamHesapla(fiyat, adet)` — uygulama kapsamlılar her sayfada, sayfa kapsamlılar yalnız kendi sayfasında. **Yalnız tarayıcı**; sunucuda bu ad alanı yoktur (2026-09-10, `WF-030`) |
@@ -125,6 +129,11 @@ dalından devam eder.
 > `runtimeErrors` taşır ve hangi komponentin hangi prop'unun yazılamadığını (`element` ·
 > `property`) söyler. Aynı defter hata dönen microservice adımlarını da kaydeder. **Kare
 > "çalışıyor" görünse bile `runtimeErrors` doluysa o adımlar işini YAPMAMIŞTIR.**
+>
+> **Prop'a bağlı ifade patlarsa** (Studio'da "Expression error" toast'ı) `page_screenshot` yanıtı
+> `expressionErrors` taşır: `{ elementId, prop, expression, message, count }`, öğe başına en çok iki.
+> Toast da öğeyi adlandırır (`Expression error · tx_baslik.content`); cihazda geliştirme paketi aynı
+> satırı Metro günlüğüne basar (ZM-05).
 
 **Prop'a doğrudan ifade bağlama (`{{ }}`):** akış kurmadan bir prop'u ifadeye bağlamak için
 prop `type: 'code'` olur, **ifade `ref` alanına `{{ }}` içinde** yazılır, `data` tasarım zamanı

package/dist/resources/guides/functions.md

@@ -273,7 +273,7 @@ toplamHesapla(row.fiyat, row.adet) > 1000
   serbesttir — sunucuda o ad alanı yok.
 - **Önekli hata:** gövde hatası `Functions.<ad>: <mesaj>` (studio) ya da `<ad>: <mesaj>` (workflow)
   olarak gelir; `Steps.<adım>.error.message` ya da `runtimeErrors`'ta bu öneki ara.
-- **Mobil yok** (K11): `apps/mobile` runtime'ı `Functions`'ı boş nesne kurar.
+- **Mobil uygulama:** mobil runtime (`@ng-apps/ui-native`) `appFunctions`/`pageFunctions`'ı `Functions`'a geçirir, çağrı web'deki gibi çalışır.
 - **Önbellek:** `/view` yolu eski gövdeyi birkaç saniye gösterebilir; `/dev` yolu anlıktır.
 - **Parametre konumsal:** `parameters` sırasını değiştirmek mevcut çağrıların anlamını değiştirir;
   `function` adımları ada göre eşlendiği için etkilenmez.

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

@@ -5,7 +5,10 @@
 Bağımlılıklar bu sırayı zorunlu kılar; atlama:
 
 ```
-1. project_create        (application zorunlu: ilk application projeyle birlikte açılır;
+1. project_create        (ÖNCE TÜRÜ SEÇ: accessModel 'simple' | 'complex' — aşağıdaki
+                          'Basit mi kompleks mi?' tablosu; sonradan değiştirmek ayrı bir dönüşüm
+                          işidir.
+                          application zorunlu: ilk application projeyle birlikte açılır;
                           application slug'ı ORG GENELİNDE tekildir — 'web' büyük olasılıkla
                           doludur, 409'da project_list ile mevcut slug'ları tara.
                           DİL: gateway create'ten sonra projenin dillerini kurar — verirsen
@@ -68,6 +71,8 @@ Bağımlılıklar bu sırayı zorunlu kılar; atlama:
 13. application_update   (homepageId — ana sayfa sayfadan değil application'dan seçilir)
 ```
 
+Onay zinciri, görev kutusu, SLA gibi insanı bekleyen işler workflow'a sıkıştırılmaz: entity ve (gerekiyorsa) servis workflow'ları hazır olduktan sonra süreç tanımı yazılır — `platform_guide('bpm')`.
+
 ## İlk kullanıcıyı kim açar? (tavuk-yumurta kilidi)
 
 Kimlik kurulmuş yeni bir projede **giriş yapabilecek hiç kimse yoktur** ve zincir kendi kendini
@@ -119,6 +124,38 @@ Middleware bir kontrol listesi maddesi değil; **ihtiyaca** kurulur:
 `middlewareIds` ile bağlı olmalı. Bir-iki uca bağlayıp gerisini açık bırakmak, hiç kurmamaktan
 kötüdür — sistem güvenli görünür, değildir.
 
+## Basit mi kompleks mi? (proje türü)
+
+Tür `project_create` `accessModel` ile proje açılırken seçilir; varsayılan `simple`'dır.
+
+| Durum | Tür |
+|---|---|
+| Kimlik ve yetki uygulamanın kendi işi; birkaç rol yeter, satır kapsamı elle yazılan `user.id` filtresi | **simple** — bugünkü davranış, aşağıdaki middleware tablosu geçerli |
+| Kurumun birim/pozisyon ağacı var (holding → şirket → bölge → departman), "müdür ekibinin kayıtlarını görür", maskeli/şifreli alan (TCKN) | **complex** |
+
+Kompleks projede fark edilmesi gerekenler:
+
+- Proje organizasyonun **yayınlı son** rol şemasının kopyasıyla doğar; yayın yoksa organizasyon
+  tabloları boştur (ORG-002). Açmadan önce `organization_schema_get` → `publishedVersion`.
+- Ağaç tabloları (`organization_units`, `organization_positions`, `user_positions`) yalnız
+  okunur; `row_*` ile yazılmaz (ORG-001).
+- Abonelik `project_get` → `organizationSchema`: `customizedAt` görünüyorsa proje ayrışmıştır ve
+  yeni sürümler artık gelmez.
+
+### Kompleks projede ilk kullanıcı
+
+`users` kompleks projede de boş doğar ve yukarıdaki bootstrap deseni **`enforce` ortamda çalışmaz**:
+anonim uç işareti olmadığı için oturumsuz her microservice isteği — bootstrap ucu da — `401` döner.
+Yeni kompleks proje `enforce` başlar. Sıra:
+
+1. Kullanıcıya söyle: development ortamının zorlama modu Studio › Ayarlar › Ortamlar'dan geçici olarak
+   `shadow` yapılsın (insan işi, ACC-007; production'a dokunulmaz). `shadow` engellemez.
+2. Bootstrap desenini uygula (geçici uç → kullanıcı → ucu hemen sil).
+3. Kullanıcının koltuğu Studio › Organizasyon ekranında atanır (`user_positions`); politika pozisyona ya da
+   role atanmışsa yetki buradan gelir.
+4. Mod `enforce`'a döner; `access_session_create` ile giriş yap, `asUser` ile uçları sına, reddi
+   `access_preview` ile açıkla (`platform_guide('access')`).
+
 ## Örnek arama davranışı
 
 Örnek gövde için **mevcut projeleri taramak yerine** önce şunlara bak:

package/dist/resources/guides/layout.md

@@ -4,6 +4,10 @@ Sayfaların paylaştığı kabuk: yan menü, üst şerit, kullanıcı menüsü v
 gireceği delik. Şema gövdesi ve koordinat modeli için `platform_guide('page')` (Kural 1,
 1d, 1f); komponent sözleşmeleri için `platform_guide('component')`.
 
+> **Mobil uygulamada** kabuk `app-bar` + tek `slot`'tur; sekmeler uygulama ayarı
+> (`properties.mobile.tabs`), çekmece `drawer` widget'ıdır. Web kabuk bileşenleri (`navigations`,
+> `sidebar`, `header`) `MOB-004` alır — `platform_guide('mobile')` §Gezinme.
+
 ## Karar kuralları
 
 **1. Layout, tek `slot` içeren SIRADAN bir komponent ağacıdır.** Ayrı bir dil yoktur:
@@ -61,7 +65,7 @@ yapılan eski numaraya artık gerek yok.
 NEREDE durduğunu değil, BİÇİMİNİ söyler (dikey kolon / yatay şerit / dolgu yüzeyi). Hem
 runtime hem Studio tuvali bölgeleri 12 kolonluk ızgarayla yerleştirir.
 
-**7. Mobilde flex YIĞILMAZ.** Runtime'ın mobil kuralı yalnız ızgara özelliklerini ezer.
+**7. Dar ekranda flex YIĞILMAZ.** Runtime'ın dar ekran kuralı yalnız ızgara özelliklerini ezer.
 Telefonda alt alta düşmesi gereken satırı `layout:'grid'` ile kur; `layout:'flex'` +
 `direction:'row'` telefonda da yan yana kalır (375px'te ölçüldü: ızgara çocukları 375/375px
 alt alta, flex çocukları 49/310px yan yana). Not: `wrap` varsayılanı artık açık (2026-09-01) —
@@ -140,8 +144,8 @@ bağlantı nesnesi ya da tam yol).
              "direction": { "type": "static", "data": "row" } },
   "blocks": [{ "breakpoint": 1024, "size": { "w": 12, "h": 80 }, "position": { "x": 0, "y": 0 } }] }
 
-// KÖTÜ — telefonda 49px'lik yan menü: row flex mobilde yığılmaz (Kural 7)
-// Mobilde alt alta düşmesi gerekiyorsa kökü layout:'grid' kur — bedeli, fill'in
+// KÖTÜ — telefonda 49px'lik yan menü: row flex dar ekranda yığılmaz (Kural 7)
+// Dar ekranda alt alta düşmesi gerekiyorsa kökü layout:'grid' kur — bedeli, fill'in
 // flex anlamının devreye girmemesi.
 ```
 
@@ -179,9 +183,9 @@ bunlardan biri olabilir:
 |---|---|
 | ~~`heightType` yalnız `auto` \| `fixed`~~ | **28 Ağustos'ta kapandı:** üçüncü değer `fill` (Kural 5b) |
 | ~~Kök kap viewport'a kilitlenmez~~ | **28 Ağustos'ta kapandı:** `fill` verilmiş kök 100vh (Kural 5b) |
-| Flex mobilde yığılmaz | Kural 7 — kabuk bugün bir MASAÜSTÜ kabuğudur |
-| Kırılıma duyarlı prop yok | `direction`/`gap` masaüstü ve mobilde AYNI; yalnız `blocks` ve `appearance.hideOn` kırılım bilir |
-| Mobil çekmece (overlay) yok | Telefonda içeriğin üstüne binen panel kurulamaz |
+| Flex dar ekranda yığılmaz | Kural 7 — kabuk bugün bir MASAÜSTÜ kabuğudur |
+| Kırılıma duyarlı prop yok | `direction`/`gap` masaüstü ve dar ekranda AYNI; yalnız `blocks` ve `appearance.hideOn` kırılım bilir |
+| Dar ekranda çekmece (overlay) yok | Telefon genişliğinde içeriğin üstüne binen panel kurulamaz (mobil UYGULAMADA çekmece `drawer` widget'ıdır — `platform_guide('mobile')`) |
 
 ---
 
@@ -189,7 +193,7 @@ bunlardan biri olabilir:
 (`injectPageSchemaIntoSlots`, `getResolvedLayoutViews`), `apps/studio/src/features/page/api/page.mappers.ts`
 (`mapPageLayoutToPreview`), `packages/ng-apps-ui/src/shared/render/render.functions.ts`
 (`resolveNodeBoxStyle` — slot'un `y / auto` satırı, flex çocuk genişliği),
-`packages/ng-apps-ui/src/shared/render/RenderComponent.svelte` (mobil media kuralı),
+`packages/ng-apps-ui/src/shared/render/RenderComponent.svelte` (dar ekran media kuralı),
 `packages/ng-apps-screen-builder/src/flex-layout.ts` (`getFlexChildStyle` — `widthType`
 fill/fixed/auto dalları, `normalizeCssSize` kabul kuralı; tuval ve runtime aynı fonksiyonu okur),
 `apps/studio/src/features/page/components/appearance/appearance-size.functions.ts` (panelin

package/dist/resources/guides/microservice.md

@@ -243,9 +243,16 @@ DTO'dan süzülmez (WF-026 — `platform_guide('workflow')` §Hata yolu). Sözle
 - **Operatör sözlüğü kapalıdır:** `eq · neq · lt · lte · gt · gte · contains · icontains ·
   in · notin · startswith · endswith · istartswith · iendswith · isnull · isnotnull`.
   **`like` YOKTUR** — metin
-  araması `contains`/`icontains` iledir. Kritik tuzak: platform bilinmeyen operatörü 400 ile
+  araması `contains`/`icontains` iledir. Kritik tuzak: eski backend bilinmeyen operatörü 400 ile
   reddetmez, **sessizce `eq`'e düşürür** (enum çözümlemesi unknown'da default'a düşer) — uç
-  testten geçer ama arama hiçbir şey döndürmez. Gateway MS-012/WF-015 bunu istek gitmeden keser.
+  testten geçer ama yanlış sonuç döner (koşuda `ne` böyle geçti). 2026-09-27'den sonraki backend
+  uç çağrısının `filters` parametresinde (JSON dizisi) 400 verir; workflow tablo adımının filtresi
+  hâlâ sessizce `eq`'e düşer. Ad büyük/küçük harfe duyarlıdır: `NEQ` geçersizdir. Gateway her iki
+  sürümde istek gitmeden keser: uç tanımında ve
+  workflow tablo adımında MS-012/WF-015 (blok), çalışma anında `row_list` / `row_export` filtresinde ve
+  `microservice_execute` / `microservice_debug`'ın `filters` parametresinde hata — sık yanlışlara öneriyle
+  (`ne`/`!=` → `neq`, `like` → `contains`, `=` → `eq`). Studio'nun filtre ARAYÜZÜNDEKİ adlar
+  (`notContains`, `between`…) ayrı bir sözlüktür; arayüz onları bu işleçlere çevirir.
 - **Write operasyonunda (`create`/`update`) yanıt yalnız primary key'dir** — platform sonucu
   PK'ya indirger ve `selectFields`'ı kaydederken sessizce boşaltır. Yanıtın başka alan da
   dönmesi gerekiyorsa **`returnFields`** kullanılır (öğeler `selectFields` ile aynı şekildedir:
@@ -337,6 +344,25 @@ kart doğru sütuna geçer, başlığı ve sorumlusu silinir.
 > ifadeden gelir ve `undefined` dönen ifade de `null` yazar —
 > `platform_guide('workflow')` §"Table update adımı".
 
+### Toplu güncelleme FİLTREYLE kurulmaz
+
+"Bekleyen bütün başvuruları onayla" bir table-source `update` ucuyla YAZILAMAZ. `update`
+operasyonu tam olarak **bir tekil alan filtresi** ister: birden çok filtre
+`InvalidFilterCountException`, tekil olmayan alanla filtre `FilterFieldMustUniqueException`
+döndürür (ölçüldü 2026-09-20, S2-22). Yani hedef kümeyi bir KOŞUL belirleyemez, yalnız bir ANAHTAR
+belirler. İki doğru yol var:
+
+| Ne istiyorsun | Yol |
+|---|---|
+| Anahtarlar elinde, hepsi ya hep ya hiç yazılsın | **`bulk-update` ucu** — gövde satır dizisi, filtre yok, tek çağrı, tek transaction (yukarıdaki §"Toplu yazma"). En fazla 1000 satır; bir satır düşerse hiçbiri yazılmaz |
+| Satır başına SONUÇ ve satır başına YETKİ kararı gerekiyor | **İş akışı + döngü** (BK-05 deseni): liste ucunu çağır → her satır için `microservice` adımı → sayaçları topla → özet döndür |
+
+Kapsam ve politika koşulu her iki yolda da satır satır uygulanır; fark sonucun şeklidir. Toplu
+onay gibi işlerde ikinci yol tercih edilir çünkü yetkisi yetmeyen satır ötekileri geri almaz:
+çağıran "N onaylandı · M reddedildi" özetini alır (ölçülen koşu: iki satır da 403 ile reddedildi,
+akış "0 onaylandı · 2 reddedildi" döndürdü). Döngüdeki uç, çağıranın kimliğiyle denetlenir —
+akış içinden yazmak yetki YÜKSELTMEZ.
+
 ## İlişki alanı: `row_list` NESNE döner, uç/step JOIN'siz DÜZ FK döner
 
 Aynı alan iki yoldan farklı şekilde gelir ve bu fark sessizce yanlış sonuç üretir:
@@ -678,6 +704,20 @@ Rol listesini **değiştirmek** için yukarıdaki §"Patch belgesi OKUMA şeklid
 > rota `/{project}/m/{application}/{microservice SLUG'ı}`'dır ( `url` alanı rotaya GİRMEZ) ve
 > `Host: <org>.<suffix>` + `X-Environment` başlıkları zorunludur.
 
+### Kompleks projede
+
+- `enforce` ortamda **anonim uç yoktur**: oturumsuz her istek `401 AppSessionRequired` döner; yukarıdaki
+  anonim veri toplama deseni kompleks projede kurulamaz. Uç izni erişim politikasıyla gelir
+  (`microservice.execute`); platform `roleIds`'i hiçbir modda karar için kullanmaz.
+- `middlewareIds`'e bağlı middleware **her modda koşar** ve reddedebilir; set-user adımı ya da yanıttaki
+  `user` platformun doldurduğu `user`'ı ezer. Kimlik middleware'ini uçtan çıkarın (ACC-006).
+- Table kaynaklı uç satırları kapsamla SQL'de süzer (kapsam dışı id 404), gizli alanı çıkarır, korumalı
+  alanı `__protected` ile işaretler; yetkisiz alana yazma ya da filtre 403.
+- Query kaynaklı uç kapsamlı ya da korumalı tabloya dokunuyorsa sorgu `isUnrestricted` olmadıkça
+  `403 AccessQueryNotScoped` (ACC-005).
+- Sınama: `access_session_create` → `asUser`; ret nedeni `access_preview` ve `microservice_debug`
+  yanıtındaki `accessDecision`. Kurallar: `platform_guide('access')`.
+
 ## Alias nerede geçerli
 
 Alias bir **SQL tablo takma adıdır**: yalnız okunan tarafta anlamı vardır. Sözleşme iki ayrı
@@ -698,6 +738,29 @@ Yazma alanına `alias` koyarsan istek **hata vermez**, alan model bağlamada dü
 istek gitmeden gövdeden çıkarır ve `gatewayNormalized` ile bildirir — böylece `silentlyDropped`
 listesi yalnız gerçek kayıpları gösterir.
 
+### Kök filtrenin alias'ı entity SLUG'ı olmak zorundadır (MS-023)
+
+`filters[].alias` runtime'da iki şeyden birine eşlenir: **ana entity'nin slug'ı** ya da bir **join
+alias'ı** (`PostgreSqlRelationHandler.GetField`). Üçüncü bir seçenek yoktur — `sourceParameters.alias`
+alanına yazdığın kök takma ad da dâhil. Eşleşmeyen alias'lı **zorunlu** filtre isteği 400
+`FilterFieldNotResolvedException` ile düşürür ve parametreyi hangi adla gönderirsen gönder değişmez.
+
+Çağrı parametresinin adı aynı kuraldan çıkar:
+
+| Filtrenin alias'ı | Çağrı parametresi (`parameterScheme[].name`) | Çalışır mı |
+|---|---|---|
+| entity slug'ı (`kredi_basvurusu`) | `id` — **nitelenmemiş** alan slug'ı | evet |
+| join alias'ı (`musteri`) | `musteri.id` | evet |
+| başka bir şey (`kredi`) | `kredi.id` | **hayır** — 400 `FilterFieldNotResolvedException` |
+
+Yani şemadaki ad, uç çalışabildiği sürece runtime'ın beklediği addır; nitelikli bir ad görüyorsan
+alias'ın bir JOIN alias'ı olduğundan emin ol. `microservice_get` join olmayan nitelikli adı
+**MS-023** uyarısıyla işaretler. Düzeltme:
+`microservice_patch { op: 'replace', path: '/sourceParameters/filters/0/alias', value: '<entity slug>' }`.
+
+Ölçüldü 2026-09-20 (`rehber-basit/tb119-get`, entity slug `tb119_urun`): alias `u` → parametre
+`u.kod`, çağrı 400; alias `tb119_urun` → parametre `kod`, çağrı 200.
+
 ## Zamanlanmış iş (`type: 'schedule-job'`) — `typeParameters.schedule`
 
 Zamanlama tek bir tanımdır; `cronExpression` tek başına verilirse **UTC cron** sayılır (eski gövde).
@@ -813,3 +876,19 @@ Dört gerçek daha:
   (`{ "op": "add", "path": "/description", "value": "…" }`). Patch yanıtındaki `silentlyDropped`
   alanı, gönderilen ama kaydedilmeyen alanları listeler — boş değilse platform bir alanı yutmuş
   demektir.
+
+## Connect Data kaynağı olarak uç
+
+Okuyan bir uç prop'a **akışsız** bağlanabilir (`connect_data_bind`, `platform_guide('page')` §Kural 1c-3). Şartlar
+(ölçüldü 2026-09-21, koşu 38):
+
+- Uç **okur** (GET tablo `get`, query ya da view kaynağı), **middleware'siz** ve **dönüş şeması** vardır; yazan tablo/sistem
+  ucu, middleware'li uç ve şemasız uç `connect_data_describe`'da 422 `ConnectDataSourceUnsupported`.
+- **Tablo ucunda `enableDynamicFilters: true`** alanları `canFilter`/`sortable` yapar (kullanıcı filtresi tanım filtresiyle
+  AND'lenir); `sort`/`limit` query-string parametreleri offset sayfalama açar. Dinamik filtresiz ya da query kaynaklı uç
+  `pageMode: client` kalır (CD-007) ve süzmez.
+- Uç parametreleri bağlantının `params`'ından gelir (`source.parameters`; CD-013).
+- `connect_data_convert` bir bağlantıyı `source: connectData` bir uca çevirir: `m/{app}/{slug}` `POST { op: 'list' }` aynı
+  kabiliyet damgalı `{ data, meta, errors }` zarfını döner. Kompleks projede `microservice_execute { asUserId }` ile
+  kullanıcı gözüyle doğrulayın; `microservice_preview` Studio ucudur (ROLLBACK'li, kapıları koşmaz).
+- Örnekler: `ngapps://examples/connect-data-workflow-microservice`, `ngapps://examples/connect-data-convert-verify`.

package/dist/resources/guides/middleware.md

@@ -19,6 +19,16 @@ kavramı olmayan bir üründe auth middleware'i, ayar tablosu olmayan bir ürün
 kur** — giriş sayfası + korunacak her uç ve her sayfa `middlewareIds`'e bağlı. Kısmi koruma,
 sistemi güvenli gösterip açık bırakır.
 
+> **Kompleks projede (`accessModel: 'complex'`) kimlik tarifleri gerekmez — bağlı kalırsa da etkisiz
+> değildir.** Platform uygulama oturumunu kendisi yönetir (`POST /{proje}/runtime/{app}/auth/sign-in`), uç
+> yolunda `user` değişkenini güvenilir özneyle önceden doldurur ve yetkiyi erişim politikasıyla verir. Bağlı
+> middleware'ler ise zorlama modundan bağımsız **her modda koşar** ve reddedebilir; set-user adımı ya da
+> yanıttaki `user` platformun `user`'ını **ezer**. Kimlik middleware'ini uçların ve sayfaların
+> `middlewareIds`'inden çıkarın (ACC-006, warn). Rol listesini (`microservice.roles`, `page.roleIds`)
+> platform hiçbir modda karar için kullanmaz; yalnız `Authorized(user.roles)` çağıran middleware okur.
+> Kompleks projenin yolu `platform_guide('access')` §Runtime; bu rehberin tarifleri basit projede aynen
+> geçerlidir.
+
 ## Açıklama zorunlu
 
 Middleware de bir workflow'dur: her adımı ve middleware'in kendisi `description` taşımak
@@ -56,8 +66,15 @@ cevabı adımın ifadesinde gizlidir. Ayrıntı ve yazım ölçütü: `platform_
    kuracaksan ifadeyi guard'la: `typeof user === 'undefined' ? false : Authorized(user.roles)`.
    Gateway `set-user` adımı olmadan `user` okuyan middleware'i **MW-003** ile uyarır.
 4. **`input` YOKTUR.** Middleware girdisini HTTP bağlamından okur: `cookie`, `header`,
-   `queryString`, `body`, `triggerSource` (hangi microservice/sayfa tetikledi: type, name,
-   slug, roles, impersonatedUserId). Hazır fonksiyonlar: `system.validateToken(...)`,
+   `queryString`, `body`, `triggerSource` (hangi microservice/sayfa tetikledi: type, id, name,
+   slug, roles, pathAndQuery — emekliye ayrılacak) ve `context` (type, name, roles, path,
+   **impersonatedUserId**, language). Kimlik devri **yalnız `context.impersonatedUserId`**'dedir;
+   `triggerSource.impersonatedUserId` diye bir alan yoktur, hep `undefined` okunur (MW-006).
+   `context.impersonatedUserId` ve start adımının `impersonation` dalı yalnız Studio önizlemesinde
+   seçilen uygulama kullanıcısı için dolar; kimlik devrini yalnız super-admin yapabilir, anonim ya da
+   yetkisiz istekte başlık platformda silinir. `impersonation` dalı bağlı değilse start
+   `success`'e düşer — uygulamanın kendi auth yolu koşar (ZM-22, 2026-09-26). Tarif: 1c. Hazır
+   fonksiyonlar: `system.validateToken(...)`,
    `system.generateToken(...)`, `crypto.JWT.encode/validate`, `Authorized(user.roles)`,
    `request.url.searchParams`, `GenerateGuid()`, `UtcNow()`, `system.getPageUrl(slug)` —
    **tam sözlük ve gerçek örnekler: `platform_guide('expressions')`**.
@@ -197,6 +214,31 @@ guard → [condition] triggerSource.type === 'page'
   Korumalı her sayfada yukarıdaki `redirect → response` zinciri kurulmalı ve **tokensız bir
   istekle 401 verdiği görülerek** kabul edilmeli. Karşılığı: `platform_guide('page')` Kural 8.
 
+## Tarif 1c — Studio önizlemesinde seçilen kullanıcıyla açılış (`impersonation` dalı)
+
+Özel auth middleware'li bir uygulamada Studio'nun Preview alt çubuğundaki kullanıcı seçici
+(`impersonated-user-id` başlığı) jeton taşımaz; yalnız jeton yolu olan middleware bu istekte 401
+döner ya da `user` kurmadan biter ve korumalı her uç `user is not defined` ile 500 verir (ZM-22).
+Seçilen kullanıcıyla açılmak için start adımının **`impersonation` dalını** bağlayın:
+
+```
+start ─ success       → token → token_check → userTable → setUser → response 200   (normal yol)
+      ─ impersonation → kimlik [table get: users, filtre id eq context.impersonatedUserId]
+                         → var_mi [condition] ─ else → response 401
+                         → setUser (aynı set-user ifadesi) → response 200
+```
+
+```jsonc
+// start adımının dalları — impersonation dalının adı ve tipi 'impersonation'
+{ "id": "<GUID>", "name": "impersonation", "type": "impersonation", "nextStepId": "<kimlik adımının id'si>" }
+```
+
+- Dal **yalnız** platform kimlik devrini doğruladığında seçilir (Studio önizlemesi, super-admin);
+  başlığı elle ekleyen istek normal `success` yolundan geçer. Bu yüzden değer yalnız bu dalda anlamlıdır:
+  **`context.impersonatedUserId`'yi dal dışında yetki kararı için okumayın.**
+- Kullanıcı satırını yine tablodan okuyun; değerin kendisi yalnız bir kimliktir, rol ya da sahiplik
+  taşımaz. `set-user` ifadesi normal yolla aynı şekli üretmelidir (kapsam workflow'ları `user.id` okur).
+
 ## Tarif 3b — Rol kapısı: `microservice.roles` TEK BAŞINA hiçbir şeyi kapatmaz
 
 **Ölçüm (2026-08-19):** `roleIds: ['<admin rol id>']` verilmiş ama `middlewareIds` **boş** bir

package/dist/resources/guides/mobile-layout.md

@@ -0,0 +1,193 @@
+# Mobil mizanpaj — uygulamanın her yeri tek dil
+
+Bir mobil ekran kurmadan önce bunu okuyun. Buradaki kurallar zevk meselesi değildir, **ölçülür**:
+
+- **Doğru varsayılan.** Gateway iskeleti kendisi doğru kurar (`mobile_app_create`, `page_create`, yeni
+  düğümlerin boşluğu).
+- **Yazımda uyarı.** Yazım yanıtında sözleşme dışı durum `MOB-015…021` olarak gelir (`layoutWarnings`).
+- **Çizimde ölçüm.** `page_screenshot({ layoutReport: true })` sonucu sayıyla ölçer (`layoutSummary.alignment`).
+
+Temel mobil bilgi (flex-only yerleşim, tipli stil, gezinme, adımlar) için `platform_guide('mobile')`.
+Altın örnek: `ngapps://examples/mobile-form-screen`.
+
+## Sözleşme
+
+Birim dp. Ölçek **4 · 8 · 16 · 24 · 32**. `gap` jetonları `small` 8, `medium` 16, `large` 24.
+
+| # | Konu | Kural | Bulgu |
+|---|---|---|---|
+| S1 | Üst güvenli alan | Tek yerde. Kabuklu uygulamada kabukta (`safe-area` `edges: 'top'` içinde app-bar). Kabuksuz sayfada ilk öğe `safe-area` `top`. Sayfa kabuğun payını ikinci kez vermez | MOB-015 |
+| S2 | Alt güvenli alan | Formun gönder düğmesi akışta, formun sonunda durur. Ekrana sabit alt eylem gerekiyorsa `floating-container` (`respectSafeArea`) kullanılır, ayrıntısı §Bileşen dizgisi'nde. Akışın sonunda pay gerekiyorsa `safe-area` `bottom` (`all` değil) | — |
+| S3 | Kaydırma | Sayfa kökü kaydırır, `size: 'shrink'`. `scroll-view` yalnız gerekçeyle; iç içe dikey kaydırıcı yok | MOB-016 |
+| S4 | Ekran kenarı | Yatayda ve üstte **16**, tek yerde. Kabuklu sayfada slot'un margin'i verir. Kabuksuz sayfada yatayı kökün padding'i verir; üstteki 16, tepedeki `safe-area`'dan sonraki `gap`tir. Bileşenlere yazılmaz | ölçüm `gutter` |
+| S5 | Aralık | Kardeşler arası boşluk yalnız ebeveynin `gap`'i; çocuklar `marginType: 'none'`. Bölümler arası `large`, bölüm içi alanlar `medium`, satır içi öğeler `small` | MOB-019, MOB-021 |
+| S6 | Saydam sarmalayıcı | Yalnız davranış ekleyen kap (`tooltip`, zeminsiz grup kabı) içeriği içeri itmez: `paddingType: 'none'`, `marginType: 'none'`, `widthType: 'fill'` | MOB-019 |
+| S7 | Yüzey | Görünen grup (kart) iç boşluğu 16, yarıçap `lg`, 1 dp kenarlık ya da zemin (ikisi birden değil). Yüzeyin içeriği bilerek içeride durur | MOB-021 |
+| S8 | Genişlik | Tam genişlik öğesi (alan, birincil düğme, yüzey) `widthType: 'fill'`. Aynı sütundaki kardeşlerin sol ve sağ kenarı eşittir | MOB-019, MOB-020 |
+| S9 | Kap yönü | Dikey grup `direction: 'column'` + `horizontalAlign: 'stretch'`. **Yönü yazılmamış container/form satırdır.** Satır yalnız gerçekten yan yana dizilen öğeler için | MOB-020 |
+| S10 | Bileşen içi | Alan yüksekliği, iç boşluk, etiket aralığı ve yarıçap temadan (`--ng-form-*`) gelir; alanlara padding ya da yarıçap yazılmaz | — |
+| S11 | Yarıçap, renk, yazı | Yarıçap ölçek adıyla (`sm`, `md`, `lg`, `pill`), renk tanımlı jetonla, yazı boyu `text`'in `type` seviyesiyle (`h1`…`h4`, `p`, `small`, `label`). Ham px yok | MOB-021 |
+| S12 | App-bar | Ekranda tek app-bar, ilk çizilen öğe. Kabuk veriyorsa sayfa eklemez; başlık kabuğun app-bar'ına bağlanır | MOB-017 |
+| S13 | Boş kap | Çalışma anında boş kalan kap bırakılmaz (tepedeki `safe-area` payı hariç) | MOB-018 |
+
+## İskelet ağaçları
+
+Aşağıdaki iskeleti `mobile_app_create` ile mobil `page_create` kendisi kurar. Elle kuruyorsanız bu biçimi
+kullanın.
+
+**Kabuk (layout).** `shell_root` düz bir `container`'dır. Padding tipi yazılmazsa runtime ona 10 dp verir ve
+app-bar kenardan kopar.
+
+```
+container  shell_root   direction:column  gap:none  size:shrink  appearance.paddingType:none  heightType:fill
+├─ safe-area  edges:top
+│  └─ app-bar  (başlık, leading, menuTarget)
+├─ slot       appearance.marginType:custom  marginValues:{ top:16, right:16, bottom:0, left:16 }  heightType:fill
+└─ drawer     (çekmeceli kabukta)
+```
+
+**Kabuklu sayfa.** Pay ve kenar boşluğu kabuktan gelir.
+
+```
+container  page_container  direction:column  horizontalAlign:stretch  size:shrink  gap:medium  paddingType:none
+└─ … içerik
+```
+
+**Kabuksuz sayfa** (giriş, karşılama, izin). `isWrapper` yalnız margin'i sıfırlar, kökün padding'i çizilir.
+
+```
+container  page_container  direction:column  horizontalAlign:stretch  size:shrink  gap:medium
+           appearance.paddingType:custom  paddingValues:{ top:0, right:16, bottom:0, left:16 }
+├─ safe-area  edges:top     (boş: durum çubuğu payı + gap kadar üst boşluk)
+└─ … içerik
+```
+
+**Form ekranı.** Gönder düğmesi formun içinde, akışın sonundadır. Form doğrulaması yalnız bu yolda koşar.
+
+```
+page_container
+├─ text  type:h2  (başlık)
+└─ form  direction:column  horizontalAlign:stretch  gap:large  paddingType:none  marginType:none  widthType:fill
+   ├─ … bölümler
+   └─ button  type:submit  widthType:fill
+```
+
+## Bileşen dizgisi
+
+Bir ekran yukarıdan aşağıya şu sırayla kurulur: **başlık → bölümler → eylem.**
+
+- **Başlık:** `text` `type: 'h2'`, bölüm başlığı `type: 'h4'`. `typographyStyle.fontSize` yazılmaz.
+- **Bölüm iki türlüdür:**
+  - *Görünen grup (yüzey kabı):* `container` + `surfaceStyle` (zemin ya da kenarlık, `radius: 'lg'`) +
+    `paddingType: 'custom'` ve `paddingValue: 16`. İçeriği bilerek 16 içeride durur; kabın kendisi kardeşleriyle
+    hizalıdır.
+  - *Görünmeyen grup (saydam kap):* `container` `direction: 'column'`, `paddingType: 'none'`,
+    `marginType: 'none'`. İçerik kardeşleriyle aynı kenarda başlar.
+
+  Başlığı (`title`) olan ama zemini olmayan kap saydam kap gibi davranmalıdır. Varsayılan 10 dp padding'i
+  içeriği kaydırır (MOB-019). Ya yüzey verin ya da padding'i `none` yapın.
+- **`card` çocuk almaz.** Kart görünümlü alan grubu `container` + `surfaceStyle` ile kurulur.
+- **`tooltip`** dokunulan içeriği sarar ve saydamdır. Runtime ona varsayılan boşluk vermez; gateway yine de yeni
+  tooltip'e `paddingType: 'none'` ve `widthType: 'fill'` yazar. 2026-09-29'dan önce derlenmiş uygulamada
+  boşluksuz tooltip'in içeriği 14 dp içeri kayar ve 28 dp daralır; açık değer onu da korur.
+- **Satır (`direction: 'row'`)** yan yana dizilen öğeler içindir: arama kutusu + düğme, ikon + metin,
+  "Ekle / Sil" düğmeleri. Form alanlarını alt alta dizmek için satır kullanılmaz.
+- **Eylem:** birincil düğme tam genişlik (`widthType: 'fill'`). İkincil eylem `variant: 'text'` ya da
+  `'outline'`; metin görünümlü düğme içerik genişliğinde durabilir.
+- **Ekrana sabit eylem** (`floating-container`, `anchor: 'bottom-center'`, `fullWidth`, `respectSafeArea`) iki
+  şeye dikkat ister:
+  - *Yerleşim.* `fullWidth` ekran kenarına dayanır; S4 kenarı için içine `paddingType: 'custom'` +
+    `paddingValues` yatay 16 olan bir kap koyun, `floating-container`'ın kendisine `paddingType: 'none'`
+    yazın (yoksa akışta 20 dp boş şerit kalır). Sabit düğme uzun formun son alanını örter; akışın sonuna
+    düğme boyu kadar boşluk bırakın.
+  - *Gönderim.* Formun dışındaki `type: 'submit'` + `formId` düğmesi formun olayını tetikler ama **form
+    doğrulamasını koşmaz** (bilinen açık). Doğrulanan form için gönder düğmesi formun içinde kalmalı.
+
+## Boşluk
+
+Aralığın tek kaynağı ebeveynin `gap`'idir. Runtime'ın varsayılanları katmanlarda birikir: margin tipi
+yazılmamış her düğüm 4 dp, bırakılabilir düğüm ayrıca 10 dp padding alır. İki kat iç içe zeminsiz kap, içeriği
+28 dp kaydırır.
+
+- **Gateway yeni düğüme `marginType: 'none'` yazar** (`page_create`, `page_schema_patch`,
+  `page_schema_validate`) ve bunu `gatewayNormalized`'da söyler.
+  - Kardeşleri varsayılan margin'le duran eski bir kaba eklenen düğüme dokunulmaz; yeni düğüm eskilerden
+    4 dp kayardı. Kabı sözleşmeye taşımak için bütün çocuklarına `marginType: 'none'` yazın.
+  - `layout_schema_patch` ve `component_schema_patch` bu varsayılanı yazmaz. Kabukta ya da widget'ta eklenen
+    düğüme boşluğu siz yazın.
+- **Ritim:**
+  - bölümler arası `gap: 'large'` (24);
+  - bölüm içi alanlar `gap: 'medium'` (16);
+  - satır içi öğeler `gap: 'small'` (8).
+
+- **Özel değer** (`custom`) ve sayısal `gap` yalnız ölçekten seçilir: 0, 4, 8, 16, 24, 32 (MOB-021).
+
+## Genişlik ve hiza
+
+- **`horizontalAlign: 'stretch'`** olan sütun, çocuklarını `widthType` yazılmasa da tam genişlik gerer. Öteki
+  hizalarda tam genişlik öğesine `widthType: 'fill'` yazın. Aynı sütunda bir kısmı `fill`, bir kısmı değilse
+  sağ kenar hizadan kopar (MOB-020).
+- **Yönü yazılmamış `container` ve `form` satırdır.** Alanlar yan yana sıkışır; `direction: 'column'` yazın.
+  `safe-area` ve `scroll-view` sütun doğar.
+- **Ortalanmış ekran** (giriş, boş durum) için sütuna `horizontalAlign: 'center'` verin. Bu kapsamda kenar
+  eşitliği aranmaz.
+
+## Kenarlık, yarıçap, yazı
+
+- **Yüzey:** `surfaceStyle` ile verilir.
+  - zemin `background: 'var(--ng-…)'` (temada tanımlı jeton);
+  - kenarlık `borderTop…borderLeft` 1 dp, renk `border` jetonu;
+  - yarıçap `radius: 'lg'`.
+
+  Zemin ve kenarlığı birlikte kullanmayın; biri yeter.
+- **Yarıçap ölçeği:** kartlar `lg`, çip ve rozetler `pill`, alan ve düğmeler temadan. Ham `'10px'` yazılmaz.
+- **Yazı:** `text` `type` seviyesi.
+- **Tasarım sistemi çapında görünüm** (bütün kartlar, bütün düğmeler) temadan yönetilir. Ölçekler, adlı ön
+  ayarlar ve yeni düğümlerin başlangıç değerleri `platform_guide('theme')`'dadır. Aynı değer tek tek düğümlere
+  kopyalanmaz. Temanın eski `componentStyles` alanı emeklidir.
+
+## Kaydırma
+
+Sayfa kökü her zaman kaydırır: barındırıcı sayfayı bir kaydırıcı içinde çizer.
+
+`scroll-view` yalnız şu gerekçelerle eklenir:
+
+- `refreshable` (çekerek yenile);
+- `stickyHeader` ya da `states.isSticky` çocuk (yapışkan başlık);
+- `horizontal` (yatay şerit);
+- `heightType: 'fixed'` (sabit boylu iç liste).
+
+Gerekçesiz ya da iç içe dikey kaydırıcı jestleri çakıştırır (MOB-016). Kökün `size: 'grow'`'u çocukları ekran
+boyunca eşit böler ve kısa içerik üst üste biner. Yapışkan başlık ve ekrana sabit içerik için
+`platform_guide('mobile')` §Ekrana sabit içerik.
+
+## Doğrulama
+
+Bir ekranı bitirince iki çağrı yapın:
+
+1. **`page_schema_validate`** (kuru koşu): `layoutWarnings`'te MOB-015…021 bulgusu olmamalı.
+   - Yazım araçları (`page_schema_patch`, `layout_schema_patch`) yalnız o yazımın **getirdiği** bulguyu söyler.
+   - Sayfanın bütün durumunu kuru koşu verir.
+2. **`page_screenshot({ layoutReport: true })`:** `layoutSummary.alignment` şu değerleri vermeli.
+
+| Alan | Temiz değer | Anlamı |
+|---|---|---|
+| `gutter` | 16 | ekran kenarı boşluğu (sol = sağ) |
+| `leftEdges` | tek küme | aynı kapsamdaki geniş içeriğin sol kenarları |
+| `surfaces` | `[]` | iç hizası bozuk yüzey kabı yok |
+| `widthOutliers` | `[]` | sağ kenarı sapan geniş öğe yok (`insetLeft`/`insetRight` dp) |
+| `offScaleGaps` | `[]` | ardışık öğeler arası boşluk ölçekte |
+
+İki kaynak aynı şeyi söyler. MOB-019'un şemadan öngördüğü dp farkı, `leftEdges` kümeleri arasındaki farktır.
+
+## Bulgu → reçete
+
+| Kod | Ne diyor | Ne yapılır |
+|---|---|---|
+| MOB-015 | Üst pay eksik ya da çift | Kabuksuz sayfaya `safe-area` `top`. Kabuğu payı vermiyorsa kabukta app-bar'ı `safe-area` `top` içine alın. Kabuk veriyorsa sayfadaki `top`/`all` güvenli alanı kaldırın |
+| MOB-016 | Kaydırma tek yerde değil | Kök `size: 'shrink'`. Gerekçesiz `scroll-view`'ı kaldırın ya da gerekçesini verin. İç içe olanda içtekine `fixed` boy verin |
+| MOB-017 | İkinci ya da yanlış yerde app-bar | Kabuk veriyorsa sayfadakini silin, başlığı kabuğa bağlayın. Kabuksuzda app-bar'ı ilk sıraya (ya da tepedeki `safe-area`'nın içine) taşıyın |
+| MOB-018 | Boş kap | İçeriğini ekleyin ya da silin |
+| MOB-019 | Kenar kayması (dp) | Bulgunun hedefi içeriği iten kaptır. Görünen grup olacaksa yüzey verin, olmayacaksa `paddingType: 'none'` + `marginType: 'none'`. Hedef öğenin kendisiyse margin'ini kardeşleriyle aynı yapın |
+| MOB-020 | Genişlik tutarsız | Öğeye `widthType: 'fill'`. Yönü yazılmamış kaba `direction: 'column'` + `horizontalAlign: 'stretch'` |
+| MOB-021 | Ölçek dışı değer | Boşluğu ve sayısal gap'i 0/4/8/16/24/32'den, yarıçapı `sm`/`md`/`lg`/`pill`'den, yazı boyunu `text` `type`'tan seçin |