@appaflytech/zeyrek-ai-mcp 0.0.33 → 0.0.35

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (170) hide show
  1. package/.env.example +0 -15
  2. package/dist/config.js +0 -11
  3. package/dist/index.js +0 -2
  4. package/dist/knowledge/boxSections.js +184 -0
  5. package/dist/knowledge/componentCatalog.js +634 -255
  6. package/dist/knowledge/componentEvents.js +38 -32
  7. package/dist/knowledge/layoutSummary.js +2 -140
  8. package/dist/knowledge/normalize.js +144 -117
  9. package/dist/knowledge/rules.js +42 -291
  10. package/dist/knowledge/styleResolve.js +53 -58
  11. package/dist/knowledge/themeResolve.js +4 -4
  12. package/dist/knowledge/themeSchema.js +2 -1
  13. package/dist/observability/trace.js +1 -1
  14. package/dist/platform/diagnostics.js +4 -10
  15. package/dist/platform/domSummary.js +1 -1
  16. package/dist/platform/http.js +7 -23
  17. package/dist/platform/responses.js +2 -6
  18. package/dist/platform/screenshot.js +1162 -0
  19. package/dist/platform/secrets.js +0 -9
  20. package/dist/platform/strictArguments.js +12 -68
  21. package/dist/platform/tokenVault.js +4 -187
  22. package/dist/resources/examples/layout-app-shell.json +707 -229
  23. package/dist/resources/examples/page-flex-sections.json +1 -1
  24. package/dist/resources/guides/component.md +6 -14
  25. package/dist/resources/guides/entity.md +5 -3
  26. package/dist/resources/guides/expressions.md +5 -14
  27. package/dist/resources/guides/functions.md +1 -1
  28. package/dist/resources/guides/layout.md +58 -55
  29. package/dist/resources/guides/microservice.md +2 -9
  30. package/dist/resources/guides/middleware.md +2 -34
  31. package/dist/resources/guides/page.md +179 -256
  32. package/dist/resources/guides/theme.md +3 -8
  33. package/dist/resources/guides/translation.md +1 -1
  34. package/dist/resources/guides/workflow.md +1 -7
  35. package/dist/resources/schema-fingerprint.json +4 -4
  36. package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json +1 -3
  37. package/dist/resources/schemas/MicroserviceDto.json +2 -2
  38. package/dist/server.js +1 -7
  39. package/dist/tools/applications.js +3 -60
  40. package/dist/tools/components.js +16 -103
  41. package/dist/tools/datasources.js +1 -1
  42. package/dist/tools/designSchemaPatch.js +19 -23
  43. package/dist/tools/externalComponents.js +4 -25
  44. package/dist/tools/flows.js +13 -80
  45. package/dist/tools/layouts.js +20 -48
  46. package/dist/tools/microservices.js +10 -32
  47. package/dist/tools/pages.js +115 -396
  48. package/dist/tools/platformInfo.js +2 -7
  49. package/dist/tools/rows.js +1 -7
  50. package/dist/tools/schemaOps.js +4 -35
  51. package/dist/tools/screenWrite.js +37 -25
  52. package/dist/tools/screens.js +4 -91
  53. package/dist/tools/variables.js +5 -11
  54. package/package.json +2 -2
  55. package/dist/knowledge/access.js +0 -802
  56. package/dist/knowledge/case.js +0 -41
  57. package/dist/knowledge/connectDataBind.js +0 -819
  58. package/dist/knowledge/connectDataDefinition.js +0 -341
  59. package/dist/knowledge/connectDataExecute.js +0 -93
  60. package/dist/knowledge/connectDataRules.js +0 -128
  61. package/dist/knowledge/decision.js +0 -121
  62. package/dist/knowledge/expressionPrelude.js +0 -59
  63. package/dist/knowledge/microserviceParameters.js +0 -58
  64. package/dist/knowledge/mining.js +0 -94
  65. package/dist/knowledge/mobileComponentCatalog.js +0 -864
  66. package/dist/knowledge/mobileComponentEvents.js +0 -239
  67. package/dist/knowledge/mobileStore.js +0 -227
  68. package/dist/knowledge/platform/lint.js +0 -385
  69. package/dist/knowledge/platform/mobile.js +0 -142
  70. package/dist/knowledge/platform/mobileLayoutLint.js +0 -324
  71. package/dist/knowledge/platform/mobileRules.js +0 -231
  72. package/dist/knowledge/platform/mobileSpacing.js +0 -82
  73. package/dist/knowledge/platform/mobileTabs.js +0 -108
  74. package/dist/knowledge/platform/nativeBoxModel.js +0 -44
  75. package/dist/knowledge/platform/profile.js +0 -25
  76. package/dist/knowledge/platform/resolve.js +0 -122
  77. package/dist/knowledge/platform/web.js +0 -39
  78. package/dist/knowledge/process.js +0 -510
  79. package/dist/knowledge/rowFilter.js +0 -43
  80. package/dist/knowledge/styleResolveNative.js +0 -527
  81. package/dist/platform/argumentAliases.js +0 -128
  82. package/dist/platform/bodyFile.js +0 -103
  83. package/dist/platform/capture/actions.js +0 -333
  84. package/dist/platform/capture/browser.js +0 -1
  85. package/dist/platform/capture/capture.js +0 -659
  86. package/dist/platform/capture/console-log.js +0 -122
  87. package/dist/platform/capture/index.js +0 -11
  88. package/dist/platform/capture/readiness.js +0 -103
  89. package/dist/platform/capture/summary.js +0 -77
  90. package/dist/platform/capture/target.js +0 -5
  91. package/dist/platform/capture/targets/studio-mobile.js +0 -15
  92. package/dist/platform/capture/targets/studio-web.js +0 -5
  93. package/dist/platform/impersonation.js +0 -45
  94. package/dist/platform/jsonArray.js +0 -24
  95. package/dist/platform/schemaReadMemory.js +0 -60
  96. package/dist/resources/examples/bpm-gorev-kontrol.json +0 -294
  97. package/dist/resources/examples/bpm-iso-dokuman.json +0 -228
  98. package/dist/resources/examples/bpm-satinalma.json +0 -376
  99. package/dist/resources/examples/connect-data-convert-verify.json +0 -107
  100. package/dist/resources/examples/connect-data-dropdown-roles.json +0 -66
  101. package/dist/resources/examples/connect-data-edit-m2m.json +0 -73
  102. package/dist/resources/examples/connect-data-query-params.json +0 -50
  103. package/dist/resources/examples/connect-data-table-entity.json +0 -147
  104. package/dist/resources/examples/connect-data-workflow-microservice.json +0 -65
  105. package/dist/resources/examples/mobile-app-shell-drawer.json +0 -244
  106. package/dist/resources/examples/mobile-app-shell-stack.json +0 -157
  107. package/dist/resources/examples/mobile-app-shell-tab.json +0 -208
  108. package/dist/resources/examples/mobile-form-screen.json +0 -365
  109. package/dist/resources/examples/mobile-list-detail-form.json +0 -703
  110. package/dist/resources/guides/access.md +0 -796
  111. package/dist/resources/guides/bpm.md +0 -686
  112. package/dist/resources/guides/case.md +0 -153
  113. package/dist/resources/guides/decision.md +0 -185
  114. package/dist/resources/guides/mobile-layout.md +0 -193
  115. package/dist/resources/guides/mobile.md +0 -578
  116. package/dist/resources/read.js +0 -41
  117. package/dist/resources/schemas/AccessExplanationDto.json +0 -144
  118. package/dist/resources/schemas/AccessMatrixDto.json +0 -170
  119. package/dist/resources/schemas/AccessPermissionDto.json +0 -57
  120. package/dist/resources/schemas/AccessPolicyDto.json +0 -223
  121. package/dist/resources/schemas/AccessResourceDto.json +0 -86
  122. package/dist/resources/schemas/AppSessionDto.json +0 -53
  123. package/dist/resources/schemas/ConnectDataDescribeDto.json +0 -344
  124. package/dist/resources/schemas/ConnectDataRequestModel.json +0 -202
  125. package/dist/resources/schemas/ConnectDataResultDto.json +0 -421
  126. package/dist/resources/schemas/ConnectorCredentialDto.json +0 -70
  127. package/dist/resources/schemas/ConvertConnectDataToMicroserviceCommand.json +0 -37
  128. package/dist/resources/schemas/CreateAccessPolicyCommand.json +0 -209
  129. package/dist/resources/schemas/CreateDecisionCommand.json +0 -221
  130. package/dist/resources/schemas/CreateProcessDefinitionCommand.json +0 -1337
  131. package/dist/resources/schemas/DecisionDto.json +0 -302
  132. package/dist/resources/schemas/DetachConnectDataMicroserviceCommand.json +0 -28
  133. package/dist/resources/schemas/ExplainAccessQuery.json +0 -33
  134. package/dist/resources/schemas/GenerateProcessDocumentCommand.json +0 -116
  135. package/dist/resources/schemas/OrganizationProjectDto.json +0 -335
  136. package/dist/resources/schemas/OrganizationSchemaDto.json +0 -196
  137. package/dist/resources/schemas/OrganizationSchemaVersionDto.json +0 -207
  138. package/dist/resources/schemas/PatchProcessDefinitionCommand.json +0 -76
  139. package/dist/resources/schemas/ProcessDefinitionDto.json +0 -1480
  140. package/dist/resources/schemas/ProcessSimulationDto.json +0 -96
  141. package/dist/resources/schemas/SaveConnectorCredentialCommand.json +0 -90
  142. package/dist/resources/schemas/SaveProcessEventSourceCommand.json +0 -61
  143. package/dist/resources/schemas/SaveProcessMailSourceCommand.json +0 -89
  144. package/dist/resources/schemas/SignProcessTaskCommand.json +0 -73
  145. package/dist/resources/schemas/SimulateProcessDefinitionQuery.json +0 -92
  146. package/dist/resources/schemas/StartMobileBuildCommand.json +0 -54
  147. package/dist/resources/schemas/UpdateAccessPolicyCommand.json +0 -209
  148. package/dist/resources/schemas/UpdateDecisionCommand.json +0 -216
  149. package/dist/resources/schemas/UpdateProcessDefinitionCommand.json +0 -1357
  150. package/dist/resources/schemas/UpsertMobileStoreSettingsCommand.json +0 -259
  151. package/dist/resources/schemas/ValidateProcessDefinitionQuery.json +0 -1339
  152. package/dist/tools/accessOperations.js +0 -135
  153. package/dist/tools/accessPolicies.js +0 -170
  154. package/dist/tools/accessRuntime.js +0 -203
  155. package/dist/tools/bpm.js +0 -343
  156. package/dist/tools/bpmGovernance.js +0 -266
  157. package/dist/tools/bpmOperations.js +0 -230
  158. package/dist/tools/bpmReporting.js +0 -154
  159. package/dist/tools/bpmRouting.js +0 -150
  160. package/dist/tools/bpmRuntime.js +0 -396
  161. package/dist/tools/case.js +0 -178
  162. package/dist/tools/caseRuntime.js +0 -89
  163. package/dist/tools/connectData.js +0 -449
  164. package/dist/tools/connectors.js +0 -193
  165. package/dist/tools/decisions.js +0 -206
  166. package/dist/tools/mobile.js +0 -221
  167. package/dist/tools/mobileStore.js +0 -268
  168. package/dist/tools/modules.js +0 -48
  169. package/dist/tools/organizationStructure.js +0 -137
  170. package/dist/tools/profileWrite.js +0 -92
@@ -10,7 +10,7 @@
10
10
  "stringNeedsFixedMode": "widthString/heightString YALNIZ ilgili *Type:'fixed' iken okunur. 'fill'/'auto' moda string yazmak ölüdür — gateway PAGE-017 uyarısı verir, Studio paneli mod değişiminde string'i siler.",
11
11
  "cssSizeAcceptance": "Boyut string'i kabul kuralı (normalizeCssSize): çıplak sayı px sayılır, birimler px/%/vw/vh/vmin/vmax/rem/em/ch, calc(...) geçer. Negatif, pt, fr, 'auto' GEÇMEZ — platform 200 döner ama panel ve runtime değeri sessizce düşürür (PAGE-018).",
12
12
  "wrapDefaultTrue": "wrap varsayılanı 2026-09-01'den beri AÇIK: w:12 çocuklar alt satıra sararak dikey akar. Bu örnekte de açık bırakıldı; kapatırsan üç hücre tek satıra sıkışır.",
13
- "gapThemeVars": "gap preset'leri tema değişkenidir (small/medium/large → var(--ng-spacing-sm/md/lg)); yalnız none/small/medium/large geçer, '18px' gibi ham değer platformda 422.",
13
+ "gapThemeVars": "gap preset'leri tema değişkenidir (small/medium/large → var(--ng-spacing-sm/md/lg)); alan allowCustom'dır, '18px' gibi ham CSS de geçer.",
14
14
  "quickStackSkeleton": "Studio'nun Quick Stack üreteci hücre olarak DAİMA box kurar, ebeveyne layout:'flex' + direction:'row' + wrap:true yazar ve satır span'ları 12'ye tamamlanır. states.isQuickStack yalnız editör süsüdür (kesikli çerçeve) — runtime'da hiçbir etkisi yoktur.",
15
15
  "orderFromBlocks": "Flex'te sıra blocks[].position'dan gelir (önce y, sonra x) ve y yalnız SIRADIR; boşluk çizilmez. Yine de bitişik ver ki grid'e dönüşte şema geçerli kalsın.",
16
16
  "heightStringOnlyFixed": "heightType:'fixed' ölçüyü heightString'den alır ('30vh' gibi), o yoksa size.h×10px'ten. heightType:'auto' içerik kadar, 'fill' ebeveynin bıraktığı yer."
@@ -3,11 +3,6 @@
3
3
  Sayfaya konan her şeyin ortak kuralları. Kuruluş sırası ve şema gövdesi için
4
4
  `platform_guide('page')`; HTML kaçış kapısının derin sözleşmesi için `platform_guide('html')`.
5
5
 
6
- > **Mobil uygulamada** katalog ayrıdır: `component_list`/`component_get` mobil satırları okur,
7
- > `component_get` `mobileKnowledge` (bileşenin mobil farkları) ve `mobileNotes` ekler; katalogda
8
- > olmayan tip `MOB-003` alır. Stil CSS değil React Native'dir — `page_runtime_get(resolveStyles)`
9
- > `nativeStyle` döner (`platform_guide('mobile')`).
10
-
11
6
  ## Keşif: iki tool, üç bilgi katmanı
12
7
 
13
8
  ```
@@ -62,9 +57,9 @@ Doğrulama mesajını çeviriye bağlamak ayrı bir sözleşmedir (`t:` öneki,
62
57
 
63
58
  ## Olay modeli
64
59
 
65
- - Olay adları `component_get.events`'ten okunur, **`on` öneki almaz** (tek istisna
66
- `texteditor`: onMount/onChange). Uydurma ada bağ sessizce ölü kalır — gateway PAGE-008 ile
67
- reddeder.
60
+ - Olay adları `component_get.events`'ten okunur, **`on` öneki almaz** (`texteditor` dahil:
61
+ `mount`/`change`/`changed`/`focus`/`blur`). Uydurma ada bağ sessizce ölü kalır — gateway
62
+ PAGE-008 ile reddeder.
68
63
  - Yük `events[].payload`'dadır ama akışa **`event.data` ile GELMEZ**: motor yükü komponentin
69
64
  KENDİ prop'una yazar (`FlowMachine.onEmit` → `setNode`) ve akışı emit'in `params`'ıyla başlatır.
70
65
  Yani `payload` anahtarları prop adlarıdır ve `self.<anahtar>` ile okunur (ya da
@@ -93,10 +88,7 @@ Widget, kendi komponent ağacını taşıyan yeniden kullanılabilir pakettir (`
93
88
 
94
89
  1. **Kayıt:** `component_create` — `kind:'widget'`, `widgetType`, `schema` (widget'ın kendi
95
90
  ağacı; `name = elementId` kuralı burada da geçerli — layout gibi widget adları da kullanan
96
- sayfaya sızar). Ağacın KÖKÜ tiplidir: `container` → `widget-area`, `modal`/`drawer` → kendi
97
- tipi (+ düğümde `widgetType`). Runtime widget'ı yalnız bu kökten çizer; düz `container` kökle
98
- kayıt 200 döner ama boş çizilir. Kök vermezsen gateway düğümlerini Studio'nun kurduğu köke
99
- sarar ve `gatewayNormalized`'da CMP-002 ile bildirir (`component_update` şemada da aynı).
91
+ sayfaya sızar).
100
92
  2. **Sayfaya koyma:** `add_component` düğümünde `kind:'widget'` ve **`type` = widget KAYDININ
101
93
  ID'si** — slug DEĞİL (runtime widget'ı `widget.id === node.type` ile çözer; slug yazarsan
102
94
  kayıt 200 döner, render sessizce boş kalır — gateway **PAGE-012/LAY-005** ile reddeder).
@@ -116,7 +108,7 @@ Her şema düğümünde iki sözlük vardır; ikisi de ortak render katmanında
116
108
 
117
109
  | `states` | Anlamı |
118
110
  |---|---|
119
- | `isDroppable` | İçine komponent alır (container/form/repeater true). **Değer kataloğun kararıdır** (`component_list` `droppable` sütunu): Studio kanvası bırakma hedefini bu alandan çözer, bu yüzden gateway yazdığı düğümlerde alanı katalogdan doldurur ve `gatewayNormalized` ile bildirir (PAGE-036). `false` yazılmış bir kabın içine kanvasta bırakma yapılamaz — bilerek kapatmak için `resize_component`/`set_states` |
111
+ | `isDroppable` | İçine komponent alır (container/form/repeater true) |
120
112
  | `isScrollable` | İçeriği kendi alanında kaydırır (sabit yükseklikte `overflow-y: auto`) |
121
113
  | `isWrapper` | Sayfanın/layout'un/widget'ın ANA kabı — salt düzen elemanı: `height:100%` + **`min-height:80vh`**, kap başlığı ÇİZİLMEZ. **Yalnız sayfa boyu kaplaması gereken tek kap için kullan:** iç içe kutuya verirsen 720px'lik pencerede o kutu 36px içerikle bile 576px çizilir (ölçüldü, `platform_guide('page')` Kural 1f). Çerçeve/başlık gizlemek için wrapper değil `style` (`border:'none'`) kullan. Kurulmuş bir düğümün bayrağını `resize_component` micro-op'unun `states` alanı değiştirir — düğümü yeniden kurmak gerekmez |
122
114
  | `isSticky` | Kaydırmada yerinde kalır (header/sidebar; z-index'i otomatik) |
@@ -135,7 +127,7 @@ Her şema düğümünde iki sözlük vardır; ikisi de ortak render katmanında
135
127
 
136
128
  | `appearance` | Değerler | Anlamı |
137
129
  |---|---|---|
138
- | `heightType` | `auto` · `fixed` · `fill` | `auto`: içerik kadar (önerilen — Kural 1d); `fixed`: `heightString` varsa o, yoksa `blocks.h × 10px`; `fill`: **kalanı doldur** — ebeveynin bıraktığı yer (ızgarada `height:100%`, flex sütununda `flex:1 1 auto`, flex satırında `align-self:stretch`). Tam ekran yerleşim kabuğu bununla kurulur, bkz. `platform_guide('layout')` |
130
+ | `heightType` | `auto` · `fixed` · `fill` | `auto`: içerik kadar (önerilen — Kural 1d); `fixed`: `heightString` varsa o, yoksa `blocks.h × 10px`; `fill`: **kalanı doldur** — ebeveynin bıraktığı yer (ızgarada `height:100%`, flex sütununda `flex:1 1 auto`, flex satırında `align-self:stretch`). Tam ekran yerleşim kabuğu bununla kurulur, bkz. `platform_guide('layout')`. **Mobilde (≤ 767 px) mobil bloğu olmayan her düğüme `height: auto !important` yazılır**: yüksekliği `height` olarak yazılan `fixed` düğüm (flex ya da CSS grid ebeveyni, stretch yokken) içeriğine göre çizilir; stretch'li satırdaki `min-height` ve 12 kolonlu eski ebeveynin `grid-row` yüksekliği bundan bağımsızdır. Yazılı yüksekliği mobilde de istiyorsan (`heightType: 'fixed'` iken) `appearance.className`'e ayrılmış **`ng-keep-height-mobile`** belirtecini yaz (`className: "hero ng-keep-height-mobile"`) |
139
131
  | `widthType` | `cover` · `contain` · `auto` · `fixed` · `fill` | İlk ikisi görsel/medya sığdırma. Kalanı **flex (ve eski cssgrid) kabın çocuğunun genişlik modu** (2026-09-01): `auto` içerik kadar, `fixed` `widthString`'den, `fill` kabın tüm genişliği (satırda `flex:1 1 100%`, sütunda `align-self:stretch`). **Yazılmazsa eski 12 kolon `blocks.size.w` payı geçerlidir** — öncelik: `fill` > `fixed` > `auto` > span |
140
132
  | `widthString` / `heightString` | CSS uzunluğu | Sabit ölçü; **yalnız ilgili `*Type: 'fixed'` iken okunur** (aksi PAGE-017 uyarısı). Kabul: çıplak sayı (px sayılır) · `px % vw vh vmin vmax rem em ch` birimli değer · `calc(...)`. Negatif/`pt`/`fr`/`auto` GEÇMEZ — platform kaydeder ama panel ve runtime sessizce düşürür (PAGE-018). Eski `widthPx` alanı 2026-09-01'de kaldırıldı |
141
133
  | `marginType` / `marginValue` | `normal` · `none` · `custom` + px | Dış boşluk: **yazılmazsa `normal` sayılır** = her kenara 4px (`spacing.ts` `CANVAS_NORMAL_MARGIN`); custom=`marginValue`. Bileşenleri dip dibe dizmek için `none` ŞART — `gap:'none'` olsa bile normal margin komşular arasında 8px bırakır (sıkı dizilim tarifi: `platform_guide('page')` Kural 1f-2) |
@@ -290,9 +290,11 @@ create step'inde aynı kural geçerlidir:
290
290
  "ticket_no": "TLP-0002"
291
291
  ```
292
292
 
293
- Girdi sınırları (`IncrementalCodeInput.TryParse`; ihlal edilirse nesne geçersiz sayılır ve kod
294
- üretilmez): `Prefix` ≤ 3 karakter · `Separator` ≤ 1 karakter · `Counter` ≥ 1 ·
295
- `DigitCount` 1–12.
293
+ Girdi sınırları (`IncrementalCodeInput.TryParse`): `Prefix` ≤ 3 karakter · `Separator` ≤ 1
294
+ karakter · `Counter` ≥ 1 · `DigitCount` 1–12. İhlal edilirse yazma 400
295
+ `InvalidParameterException` ile düşer ve satır yazılmaz (`EntityService.ApplyIncrementalValuesAsync`;
296
+ tablo kaynaklı uçta ölçüldü 2026-10-02). `row_next_code` bu sınırları DENETLEMEZ, aşan şekli de
297
+ kodla döndürür. Nesnedeki `FieldId` yazılan alanın id'si olmalı, değilse aynı 400.
296
298
 
297
299
  - **Sayaç kendini onarır:** üretim var olan en yüksek koddan devam eder
298
300
  (`EntityIncrementSequenceService.ResolveStartingCounterAsync`), yani elle `TLP-0005` yazdıktan
@@ -14,10 +14,8 @@ Uydurma fonksiyon adı runtime'da `X is not defined` 500'üdür — yalnız bura
14
14
 
15
15
  **Değişkenler:** step çıktıları (`<stepAdı>.data`), middleware değişkenleri (`user`,
16
16
  `settings`, `permissions`… — `workflow_middleware_variables` ile keşfet), HTTP bağlamı:
17
- `cookie`, `header`, `queryString`, `body`, `triggerSource` (tetikleyen ucun
18
- type/id/name/slug/roles/pathAndQuery'si — emekliye ayrılacak) ve `context`
19
- (type/name/roles/path/impersonatedUserId/language). **Kimlik devri yalnız `context.impersonatedUserId`**'dedir;
20
- `triggerSource`'ta bu alan yoktur (MW-006). Gövde bir JSON **nesnesi** ise `body.alan` diye okunur,
17
+ `cookie`, `header`, `queryString`, `body`, `triggerSource`/`context` (tetikleyen ucun
18
+ type/name/roles/impersonatedUserId'ı). Gövde bir JSON **nesnesi** ise `body.alan` diye okunur,
21
19
  gövde bir JSON **dizisi** ise `body[0].alan` diye — 2026-09-04 öncesinde nesne gövde de diziye
22
20
  sarılıyordu ve `body.alan` sessizce `undefined` dönüyordu, bu yüzden gövdeye bakan yetki kapıları
23
21
  açık kalıyordu. Workflow'da istek girdisi `input.`, automation'da
@@ -99,16 +97,14 @@ dalından devam eder.
99
97
  |---|---|
100
98
  | `Page` | `Page.user`, `Page.variables`, `Page.components`, `Page.properties`, `Page.queryParams`, `Page.authorized(roles)` |
101
99
  | **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` |
102
- | `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`) |
100
+ | `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`) |
103
101
  | `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 |
104
- | `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 |
102
+ | `self` · `item` · `Row` / `RowIndex` | Tetikleyen komponent (yazılabilir) · repeater/tablo satırı (yazmak satırı günceller) |
105
103
  | `event` | `{name, data, source: {id, props}}` |
106
104
  | `cookie` | `cookie.get(name)` / `cookie.set(name, value, {expiresInHours, path})` / `cookie.remove(name)` — tarayıcı cookie'si |
107
105
  | `setComponentProperty(name, key, value)` / `getComponentProperty(name, key)` | fonksiyon alternatifi |
108
106
  | `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** |
109
- | `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) |
110
- | `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) |
111
- | **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 |
107
+ | `LocalStorage` · `Widget` · `params` | yerel veri · widget bağlamı · olay parametreleri |
112
108
  | `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')` |
113
109
  | `log(...)` | console (proxy'leri temizler) |
114
110
  | `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`) |
@@ -129,11 +125,6 @@ dalından devam eder.
129
125
  > `runtimeErrors` taşır ve hangi komponentin hangi prop'unun yazılamadığını (`element` ·
130
126
  > `property`) söyler. Aynı defter hata dönen microservice adımlarını da kaydeder. **Kare
131
127
  > "çalışıyor" görünse bile `runtimeErrors` doluysa o adımlar işini YAPMAMIŞTIR.**
132
- >
133
- > **Prop'a bağlı ifade patlarsa** (Studio'da "Expression error" toast'ı) `page_screenshot` yanıtı
134
- > `expressionErrors` taşır: `{ elementId, prop, expression, message, count }`, öğe başına en çok iki.
135
- > Toast da öğeyi adlandırır (`Expression error · tx_baslik.content`); cihazda geliştirme paketi aynı
136
- > satırı Metro günlüğüne basar (ZM-05).
137
128
 
138
129
  **Prop'a doğrudan ifade bağlama (`{{ }}`):** akış kurmadan bir prop'u ifadeye bağlamak için
139
130
  prop `type: 'code'` olur, **ifade `ref` alanına `{{ }}` içinde** yazılır, `data` tasarım zamanı
@@ -273,7 +273,7 @@ toplamHesapla(row.fiyat, row.adet) > 1000
273
273
  serbesttir — sunucuda o ad alanı yok.
274
274
  - **Önekli hata:** gövde hatası `Functions.<ad>: <mesaj>` (studio) ya da `<ad>: <mesaj>` (workflow)
275
275
  olarak gelir; `Steps.<adım>.error.message` ya da `runtimeErrors`'ta bu öneki ara.
276
- - **Mobil uygulama:** mobil runtime (`@ng-apps/ui-native`) `appFunctions`/`pageFunctions`'ı `Functions`'a geçirir, çağrı web'deki gibi çalışır.
276
+ - **Mobil yok** (K11): `apps/mobile` runtime'ı `Functions`'ı boş nesne kurar.
277
277
  - **Önbellek:** `/view` yolu eski gövdeyi birkaç saniye gösterebilir; `/dev` yolu anlıktır.
278
278
  - **Parametre konumsal:** `parameters` sırasını değiştirmek mevcut çağrıların anlamını değiştirir;
279
279
  `function` adımları ada göre eşlendiği için etkilenmez.
@@ -4,10 +4,6 @@ Sayfaların paylaştığı kabuk: yan menü, üst şerit, kullanıcı menüsü v
4
4
  gireceği delik. Şema gövdesi ve koordinat modeli için `platform_guide('page')` (Kural 1,
5
5
  1d, 1f); komponent sözleşmeleri için `platform_guide('component')`.
6
6
 
7
- > **Mobil uygulamada** kabuk `app-bar` + tek `slot`'tur; sekmeler uygulama ayarı
8
- > (`properties.mobile.tabs`), çekmece `drawer` widget'ıdır. Web kabuk bileşenleri (`navigations`,
9
- > `sidebar`, `header`) `MOB-004` alır — `platform_guide('mobile')` §Gezinme.
10
-
11
7
  ## Karar kuralları
12
8
 
13
9
  **1. Layout, tek `slot` içeren SIRADAN bir komponent ağacıdır.** Ayrı bir dil yoktur:
@@ -43,16 +39,20 @@ göre kurmaktır. `version` bir **string**tir (mikrosaniye zaman damgası) — s
43
39
  **4. TEK slot.** Sayfa şeması **her** slot'a ayrı ayrı kopyalanır — iki slot, sayfayı iki
44
40
  kez çizer ve `elementId`'leri tekrarlar. (LAY-002 / LAY-006)
45
41
 
46
- **5. Kabuğu `container` + `slot` ile kur.** `layout` monoliti (sabit logo/menü/kullanıcı
47
- bandı — yalnız doldurulur) ve `layout-shell` + `layout-region` ikilisi **emekliye
48
- ayrıldı**; kayıtlı kalırlar ve mevcut layout'lar çalışır, ama yeni kabuk `container` ile
49
- kurulur. Sebebi: `container` zaten `layout-region`'ın yaptığının üstünü yapıyor (flex/ızgara
50
- düzeni, hizalama, gap, wrap), region'ın kattığı tek şey `dock` sözlüğüydü.
51
-
52
- **5a. Kök, sayfanın `page_container`'ının yerleşim ikizidir.** Studio'nun yeni layout
53
- iskeleti (`getDefaultLayout`) tam olarak şunu kurar ve sen de aynısını yazmalısın:
54
- `states.isWrapper: true` (çerçevesiz, başlıksız, saydam) + `appearance.heightType: 'fill'`
55
- + `blocks` x0/w12. Sarmalayıcı olmayan bir kök, kenarlıklı beyaz bir kart olarak çizilir.
42
+ **5. VARSAYILAN kabuğu kullan, sonra özelleştir (2026-09-29).** Yeni bir layout kurarken
43
+ önce `ngapps://examples/layout-app-shell` örneğini `layout_create`'in `views` alanına olduğu
44
+ gibi ver — Studio'da "New layout" ile açılan iskeletin birebir aynısıdır (aşağıdaki mini
45
+ tarif). Sonra uygulamaya göre değiştir: menü öğeleri ve `href`'leri, başlık, ikonlar;
46
+ gerekmeyen parçayı (arama, yardım, bildirim) sil. Kullanıcı açıkça başka bir kabuk isterse
47
+ sıfırdan kur. Kabuk sıradan bileşenlerden oluşur: `container` + `navigations` + `icon` +
48
+ `slot`. `layout` monoliti (sabit logo/menü/kullanıcı bandı — yalnız doldurulur) ve
49
+ `layout-shell` + `layout-region` ikilisi **emekliye ayrıldı**; kayıtlı kalırlar ve mevcut
50
+ layout'lar çalışır, ama yeni kabukta kullanılmaz — Studio iskeleti de artık onları kurmaz.
51
+
52
+ **5a. Kök, sayfanın `page_container`'ının yerleşim ikizidir.** Varsayılan kabuk kökü şöyle
53
+ kurar ve sen de aynısını yazmalısın: `states.isWrapper: true` (çerçevesiz, başlıksız,
54
+ saydam) + `appearance.heightType: 'fill'` + `blocks` x0/w12. Sarmalayıcı olmayan bir kök,
55
+ kenarlıklı beyaz bir kart olarak çizilir.
56
56
 
57
57
  **5b. Tam ekran kabuk `heightType: 'fill'` ile kurulur (2026-08-28).** Yükseklik ne
58
58
  içerikten (`auto`) ne satır sayısından (`fixed`) gelir — ebeveynin bıraktığı yerden gelir:
@@ -65,7 +65,7 @@ yapılan eski numaraya artık gerek yok.
65
65
  NEREDE durduğunu değil, BİÇİMİNİ söyler (dikey kolon / yatay şerit / dolgu yüzeyi). Hem
66
66
  runtime hem Studio tuvali bölgeleri 12 kolonluk ızgarayla yerleştirir.
67
67
 
68
- **7. Dar ekranda flex YIĞILMAZ.** Runtime'ın dar ekran kuralı yalnız ızgara özelliklerini ezer.
68
+ **7. Mobilde flex YIĞILMAZ.** Runtime'ın mobil kuralı yalnız ızgara özelliklerini ezer.
69
69
  Telefonda alt alta düşmesi gereken satırı `layout:'grid'` ile kur; `layout:'flex'` +
70
70
  `direction:'row'` telefonda da yan yana kalır (375px'te ölçüldü: ızgara çocukları 375/375px
71
71
  alt alta, flex çocukları 49/310px yan yana). Not: `wrap` varsayılanı artık açık (2026-09-01) —
@@ -76,45 +76,48 @@ yana kalmaya devam eder.
76
76
  gerçek çıktıyı, layout'a bağlı bir sayfanın runtime paketinde görürsün (slot yerleşimi
77
77
  dahil). Slot kurgusu için ayrıca `page_state` → `layoutSlots`.
78
78
 
79
- ## Mini tarif — uygulama kabuğu
79
+ ## Mini tarif — uygulama kabuğu (VARSAYILAN)
80
80
 
81
- Yan menü + üst şerit + içerik. Studio'nun `getDefaultLayout` iskeletiyle birebir aynı ağaç;
82
- `layout_create`'in `views` alanına doğrudan verilebilir (`resource: layout-app-shell`).
81
+ Sol menü + üst şerit + ortada boş içerik alanı ve slot. Studio'nun `getDefaultLayout`
82
+ iskeletiyle birebir aynı ağaç; `layout_create`'in `views` alanına doğrudan verilebilir
83
+ (`resource: layout-app-shell`).
83
84
 
84
85
  ```
85
- container isWrapper:true heightType:'fill' layout:'flex' direction:'row' gap:'none'
86
- │ verticalAlign:'stretch' block w12 x0
87
- ├ container heightType:'fill' layout:'flex' direction:'column' block w2 ← yan menü
88
- │ └ navigations block w12
89
- └ container heightType:'fill' layout:'flex' direction:'column' block w10 x2
90
- ├ container layout:'flex' direction:'row' states.isSticky block w12 h6
91
- │ └ breadcrumb block w12 h3
92
- └ slot heightType:'fill' block w12 y6
86
+ container shell_root isWrapper · fill · flex row · gap none · stretch
87
+ └ navigations shell_menu layout:'sidebar' · fill · başlık + menüde arama + daraltma
88
+ └ container shell_main fill · flex column · wrap:false · center · zemin surface-alt · taşma gizli
89
+ ├ container shell_topbar fixed 64px · flex row · stretch/middle · wrap:false · alt çizgi
90
+ │ ├ navigations shell_crumbs layout:'breadcrumb' · 30px · fill
91
+ │ ├ navigations shell_search layout:'command' · 393px × 36px · "Sayfa ara…"
92
+ │ ├ icon shell_help help · tooltip "Yardım"
93
+ │ └ icon shell_bell notifications · tooltip "Bildirimler"
94
+ └ container shell_content fill · isScrollable · isWrapper · dolgu 28/32/32/32
95
+ └ container shell_page fill · en fazla 1600px · ortalı
96
+ └ slot shell_slot fill
93
97
  ```
94
98
 
95
- - **Genişlik `appearance.widthType`'tan gelir (2026-09-01); kolon payı fallback'tir.**
96
- Yan menü için `widthType: 'fixed'` + `widthString: "240px"` (serbest CSS uzunluğu:
97
- `"50%"`, `"10vw"`, `calc(...)` de geçer; yalnız flex kabın çocuğunda okunur, mutlak
98
- ızgara kabında okunmaz). `'fill'` kabın tüm genişliğini alır, `'auto'` içeriğe oturur;
99
- `widthType` HİÇ yazılmazsa `w:2` = 12'de 2 → 1440px tasarım genişliğinde 240px payı
100
- geçerlidir. String yalnız `'fixed'` modda okunur — tek başına `widthString` ölüdür.
101
- - **Yükseklik `fill`'dir**, `size.h` değil: kök ekranı doldurur, yan menü ve içerik sütunu
102
- kökün bıraktığını, slot da üst şeritten artanı alır. Slot'un grid satırı ayrıca açık
103
- uçludur (`y / auto`), yani sayfa uzadıkça slot uzar.
104
- - **Kaydırma:** `fill` + `states.isScrollable:true` verilen düğüm büyümek yerine İÇİNDE
105
- kaydırır — uzun içerikte kabuğu sabit tutmanın yolu budur.
106
- - **Slot'un kenar boşluğu margin'dir, padding değil.** Slot droppable değildir; ona yazılan
107
- `paddingType`/`paddingValue` hiçbir kutuya çizilmez (LAY-010). Her sayfanın kenardan uzak
108
- durmasını tek yerden istiyorsan slot'a `appearance.marginType: 'custom'` + `marginValue: 24`
109
- yaz — margin slot'un sarmalayıcısına iç boşluk olarak iner ve slot'un zemini olmadığı için
110
- sonuç padding'le aynıdır. Studio iskeleti slot'a zaten 8px custom margin verir. Değer SAYIDIR
111
- (`24`, `"24px"` değil — LAY-011). Her sayfaya sarmalayıcı container eklemek gerekmez.
112
- - **MOBİL UYARISI:** bu ağaç `flex` olduğu için telefonda YIĞILMAZ (Kural 7) — 375px'te yan
113
- menü ince bir şerite iner. Telefonda alt alta düşmesi gereken bir kabuk için kökü
114
- `layout:'grid'` kur; o zaman `fill`'in flex anlamı (`flex:1 1 auto`) devreye girmez,
115
- yükseklik yine `blocks` satırlarından gelir. İkisini aynı anda veren bir yol bugün yok.
116
- - Menü satırlarını biçimlendirme: **bugün mümkün değil.** `navigations`'ın `style` prop'u
117
- ölüdür (bkz. `component_get('navigations')`).
99
+ - **Menü bir kaptır.** `navigations` droppable'dır ve içine bırakılanı KENDİ YANINA çizer:
100
+ `shell_main` kökün değil menünün çocuğudur. Ana sütunu köke kardeş koyarsan satıra
101
+ sığmaz ve menünün altına sarar (ölçüldü 2026-09-29).
102
+ - **Tek menü, üç görünüm.** Menü, kırıntı yolu (`layout:'breadcrumb'`) ve arama
103
+ (`layout:'command'`) AYNI `navigations` ağacını taşır; kırıntı aktif sayfanın yolunu, komut
104
+ paleti sonuçları bu ağaçtan çıkarır. Menüyü değiştirirken üçünü birlikte güncelle.
105
+ - **Örnek menü adressizdir.** Öğelere `href` olarak sayfa slug'ı ya da `{ page: '<id>' }` ver;
106
+ başlıkları ve ikonları uygulamanın diline göre değiştir. Menü başlığı (`title`) uygulamanın
107
+ adıdır. Renkler tema token'ıdır (`var(--ng-text-primary)` …) — sabit hex yazma, koyu temada
108
+ okunmaz.
109
+ - **Yerleşim prop'larını açıkça yaz.** `layout_create` katalog varsayılanlarını düğüme
110
+ yazmaz: `layout` prop'u olmayan `container` ızgara çizer. Örnekte her kapta
111
+ `layout:'flex'` + yön/hizalama/gap/wrap yazılıdır; kapatılan bayrak da (`wrap:false`,
112
+ `crumbSiblings:false`) açıkça yazılır.
113
+ - **Yükseklik `fill`'dir**, `size.h` değil: kök ekranı doldurur, menü ve ana sütun kökün
114
+ bıraktığını, içerik alanı üst şeritten artanı, slot da içerik alanını alır. İçerik alanı
115
+ `isScrollable` olduğu için uzun sayfa kabuğu itmez, içeride kaydırır.
116
+ - **Menü satırlarını biçimlendirme:** `navigations`'ın tipli grupları ve renk prop'ları
117
+ (`textColor`, `mutedColor`, `iconColor`, `bgColor` …) — bkz. `component_get('navigations')`.
118
+ - **Mobil:** menü ≤768px'te kendi çekmecesine ve hamburger düğmesine döner (bağımsız
119
+ `navigations`'ta `mobileBehavior:'drawer'` varsayılandır); üst şerit ve içerik tam genişliğe
120
+ yayılır.
118
121
 
119
122
  ## Mini tarif — menüde aktif satır
120
123
 
@@ -144,8 +147,8 @@ bağlantı nesnesi ya da tam yol).
144
147
  "direction": { "type": "static", "data": "row" } },
145
148
  "blocks": [{ "breakpoint": 1024, "size": { "w": 12, "h": 80 }, "position": { "x": 0, "y": 0 } }] }
146
149
 
147
- // KÖTÜ — telefonda 49px'lik yan menü: row flex dar ekranda yığılmaz (Kural 7)
148
- // Dar ekranda alt alta düşmesi gerekiyorsa kökü layout:'grid' kur — bedeli, fill'in
150
+ // KÖTÜ — telefonda 49px'lik yan menü: row flex mobilde yığılmaz (Kural 7)
151
+ // Mobilde alt alta düşmesi gerekiyorsa kökü layout:'grid' kur — bedeli, fill'in
149
152
  // flex anlamının devreye girmemesi.
150
153
  ```
151
154
 
@@ -183,9 +186,9 @@ bunlardan biri olabilir:
183
186
  |---|---|
184
187
  | ~~`heightType` yalnız `auto` \| `fixed`~~ | **28 Ağustos'ta kapandı:** üçüncü değer `fill` (Kural 5b) |
185
188
  | ~~Kök kap viewport'a kilitlenmez~~ | **28 Ağustos'ta kapandı:** `fill` verilmiş kök 100vh (Kural 5b) |
186
- | Flex dar ekranda yığılmaz | Kural 7 — kabuk bugün bir MASAÜSTÜ kabuğudur |
187
- | 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 |
188
- | 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
+ | Flex mobilde yığılmaz | Kural 7 — kabuk bugün bir MASAÜSTÜ kabuğudur |
190
+ | 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 |
191
+ | ~~Mobil çekmece (overlay) yok~~ | **Kapandı:** `navigations` (`layout:'sidebar'`) ≤768px'te kendi çekmecesine ve hamburger düğmesine döner — varsayılan kabuğun sol menüsü bunu kendiliğinden yapar |
189
192
 
190
193
  ---
191
194
 
@@ -193,7 +196,7 @@ bunlardan biri olabilir:
193
196
  (`injectPageSchemaIntoSlots`, `getResolvedLayoutViews`), `apps/studio/src/features/page/api/page.mappers.ts`
194
197
  (`mapPageLayoutToPreview`), `packages/ng-apps-ui/src/shared/render/render.functions.ts`
195
198
  (`resolveNodeBoxStyle` — slot'un `y / auto` satırı, flex çocuk genişliği),
196
- `packages/ng-apps-ui/src/shared/render/RenderComponent.svelte` (dar ekran media kuralı),
199
+ `packages/ng-apps-ui/src/shared/render/RenderComponent.svelte` (mobil media kuralı),
197
200
  `packages/ng-apps-screen-builder/src/flex-layout.ts` (`getFlexChildStyle` — `widthType`
198
201
  fill/fixed/auto dalları, `normalizeCssSize` kabul kuralı; tuval ve runtime aynı fonksiyonu okur),
199
202
  `apps/studio/src/features/page/components/appearance/appearance-size.functions.ts` (panelin
@@ -243,16 +243,9 @@ DTO'dan süzülmez (WF-026 — `platform_guide('workflow')` §Hata yolu). Sözle
243
243
  - **Operatör sözlüğü kapalıdır:** `eq · neq · lt · lte · gt · gte · contains · icontains ·
244
244
  in · notin · startswith · endswith · istartswith · iendswith · isnull · isnotnull`.
245
245
  **`like` YOKTUR** — metin
246
- araması `contains`/`icontains` iledir. Kritik tuzak: eski backend bilinmeyen operatörü 400 ile
246
+ araması `contains`/`icontains` iledir. Kritik tuzak: platform bilinmeyen operatörü 400 ile
247
247
  reddetmez, **sessizce `eq`'e düşürür** (enum çözümlemesi unknown'da default'a düşer) — uç
248
- testten geçer ama yanlış sonuç döner (koşuda `ne` böyle geçti). 2026-09-27'den sonraki backend
249
- uç çağrısının `filters` parametresinde (JSON dizisi) 400 verir; workflow tablo adımının filtresi
250
- hâlâ sessizce `eq`'e düşer. Ad büyük/küçük harfe duyarlıdır: `NEQ` geçersizdir. Gateway her iki
251
- sürümde istek gitmeden keser: uç tanımında ve
252
- workflow tablo adımında MS-012/WF-015 (blok), çalışma anında `row_list` / `row_export` filtresinde ve
253
- `microservice_execute` / `microservice_debug`'ın `filters` parametresinde hata — sık yanlışlara öneriyle
254
- (`ne`/`!=` → `neq`, `like` → `contains`, `=` → `eq`). Studio'nun filtre ARAYÜZÜNDEKİ adlar
255
- (`notContains`, `between`…) ayrı bir sözlüktür; arayüz onları bu işleçlere çevirir.
248
+ testten geçer ama arama hiçbir şey döndürmez. Gateway MS-012/WF-015 bunu istek gitmeden keser.
256
249
  - **Write operasyonunda (`create`/`update`) yanıt yalnız primary key'dir** — platform sonucu
257
250
  PK'ya indirger ve `selectFields`'ı kaydederken sessizce boşaltır. Yanıtın başka alan da
258
251
  dönmesi gerekiyorsa **`returnFields`** kullanılır (öğeler `selectFields` ile aynı şekildedir:
@@ -56,15 +56,8 @@ cevabı adımın ifadesinde gizlidir. Ayrıntı ve yazım ölçütü: `platform_
56
56
  kuracaksan ifadeyi guard'la: `typeof user === 'undefined' ? false : Authorized(user.roles)`.
57
57
  Gateway `set-user` adımı olmadan `user` okuyan middleware'i **MW-003** ile uyarır.
58
58
  4. **`input` YOKTUR.** Middleware girdisini HTTP bağlamından okur: `cookie`, `header`,
59
- `queryString`, `body`, `triggerSource` (hangi microservice/sayfa tetikledi: type, id, name,
60
- slug, roles, pathAndQuery — emekliye ayrılacak) ve `context` (type, name, roles, path,
61
- **impersonatedUserId**, language). Kimlik devri **yalnız `context.impersonatedUserId`**'dedir;
62
- `triggerSource.impersonatedUserId` diye bir alan yoktur, hep `undefined` okunur (MW-006).
63
- `context.impersonatedUserId` ve start adımının `impersonation` dalı yalnız Studio önizlemesinde
64
- seçilen uygulama kullanıcısı için dolar; kimlik devrini yalnız super-admin yapabilir, anonim ya da
65
- yetkisiz istekte başlık platformda silinir. `impersonation` dalı bağlı değilse start
66
- `success`'e düşer — uygulamanın kendi auth yolu koşar (ZM-22, 2026-09-26). Tarif: 1c. Hazır
67
- fonksiyonlar: `system.validateToken(...)`,
59
+ `queryString`, `body`, `triggerSource` (hangi microservice/sayfa tetikledi: type, name,
60
+ slug, roles, impersonatedUserId). Hazır fonksiyonlar: `system.validateToken(...)`,
68
61
  `system.generateToken(...)`, `crypto.JWT.encode/validate`, `Authorized(user.roles)`,
69
62
  `request.url.searchParams`, `GenerateGuid()`, `UtcNow()`, `system.getPageUrl(slug)` —
70
63
  **tam sözlük ve gerçek örnekler: `platform_guide('expressions')`**.
@@ -204,31 +197,6 @@ guard → [condition] triggerSource.type === 'page'
204
197
  Korumalı her sayfada yukarıdaki `redirect → response` zinciri kurulmalı ve **tokensız bir
205
198
  istekle 401 verdiği görülerek** kabul edilmeli. Karşılığı: `platform_guide('page')` Kural 8.
206
199
 
207
- ## Tarif 1c — Studio önizlemesinde seçilen kullanıcıyla açılış (`impersonation` dalı)
208
-
209
- Özel auth middleware'li bir uygulamada Studio'nun Preview alt çubuğundaki kullanıcı seçici
210
- (`impersonated-user-id` başlığı) jeton taşımaz; yalnız jeton yolu olan middleware bu istekte 401
211
- döner ya da `user` kurmadan biter ve korumalı her uç `user is not defined` ile 500 verir (ZM-22).
212
- Seçilen kullanıcıyla açılmak için start adımının **`impersonation` dalını** bağlayın:
213
-
214
- ```
215
- start ─ success → token → token_check → userTable → setUser → response 200 (normal yol)
216
- ─ impersonation → kimlik [table get: users, filtre id eq context.impersonatedUserId]
217
- → var_mi [condition] ─ else → response 401
218
- → setUser (aynı set-user ifadesi) → response 200
219
- ```
220
-
221
- ```jsonc
222
- // start adımının dalları — impersonation dalının adı ve tipi 'impersonation'
223
- { "id": "<GUID>", "name": "impersonation", "type": "impersonation", "nextStepId": "<kimlik adımının id'si>" }
224
- ```
225
-
226
- - Dal **yalnız** platform kimlik devrini doğruladığında seçilir (Studio önizlemesi, super-admin);
227
- başlığı elle ekleyen istek normal `success` yolundan geçer. Bu yüzden değer yalnız bu dalda anlamlıdır:
228
- **`context.impersonatedUserId`'yi dal dışında yetki kararı için okumayın.**
229
- - Kullanıcı satırını yine tablodan okuyun; değerin kendisi yalnız bir kimliktir, rol ya da sahiplik
230
- taşımaz. `set-user` ifadesi normal yolla aynı şekli üretmelidir (kapsam workflow'ları `user.id` okur).
231
-
232
200
  ## Tarif 3b — Rol kapısı: `microservice.roles` TEK BAŞINA hiçbir şeyi kapatmaz
233
201
 
234
202
  **Ölçüm (2026-08-19):** `roleIds: ['<admin rol id>']` verilmiş ama `middlewareIds` **boş** bir