@appaflytech/zeyrek-ai-mcp 0.0.31 → 0.0.33

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 (91) hide show
  1. package/README.md +5 -5
  2. package/dist/config.js +0 -26
  3. package/dist/knowledge/backendConstraints.js +1 -18
  4. package/dist/knowledge/componentCatalog.js +27 -493
  5. package/dist/knowledge/componentEvents.js +2 -120
  6. package/dist/knowledge/connectDataDefinition.js +4 -4
  7. package/dist/knowledge/connectDataRules.js +1 -1
  8. package/dist/knowledge/mobileComponentCatalog.js +13 -8
  9. package/dist/knowledge/mobileStore.js +227 -0
  10. package/dist/knowledge/normalize.js +48 -131
  11. package/dist/knowledge/outlines.js +0 -36
  12. package/dist/knowledge/platform/lint.js +1 -1
  13. package/dist/knowledge/platform/nativeBoxModel.js +1 -1
  14. package/dist/knowledge/policy.js +4 -18
  15. package/dist/knowledge/process.js +1 -1
  16. package/dist/knowledge/reservedTables.js +0 -79
  17. package/dist/knowledge/rules.js +10 -83
  18. package/dist/knowledge/schemaGuard.js +0 -11
  19. package/dist/observability/trace.js +2 -5
  20. package/dist/platform/capture/capture.js +1 -25
  21. package/dist/platform/errors.js +10 -162
  22. package/dist/platform/http.js +1 -6
  23. package/dist/platform/responses.js +4 -34
  24. package/dist/platform/schemaReadMemory.js +2 -2
  25. package/dist/platform/secrets.js +1 -8
  26. package/dist/resources/examples/middleware-authenticate.json +1 -1
  27. package/dist/resources/examples/mobile-app-shell-drawer.json +62 -61
  28. package/dist/resources/examples/mobile-list-detail-form.json +51 -20
  29. package/dist/resources/examples/page-detail-profile.json +1 -2
  30. package/dist/resources/examples/page-dynamic-form.json +2 -3
  31. package/dist/resources/examples/page-html-embed.json +1 -1
  32. package/dist/resources/examples/workflow-basic.json +2 -8
  33. package/dist/resources/guides/access.md +4 -18
  34. package/dist/resources/guides/bpm.md +1 -6
  35. package/dist/resources/guides/component.md +4 -83
  36. package/dist/resources/guides/entity.md +8 -50
  37. package/dist/resources/guides/getting-started.md +1 -38
  38. package/dist/resources/guides/merge.md +3 -37
  39. package/dist/resources/guides/microservice.md +0 -78
  40. package/dist/resources/guides/middleware.md +3 -35
  41. package/dist/resources/guides/mobile.md +85 -2
  42. package/dist/resources/guides/page.md +26 -278
  43. package/dist/resources/guides/workflow.md +0 -51
  44. package/dist/resources/rules.js +5 -11
  45. package/dist/resources/schema-fingerprint.json +5 -7
  46. package/dist/resources/schemas/CreateEntityCommand.json +0 -118
  47. package/dist/resources/schemas/CreateMicroserviceCommand.json +1 -13
  48. package/dist/resources/schemas/CreateQueryCommand.json +0 -4
  49. package/dist/resources/schemas/CreateWorkflowCommand.json +1 -146
  50. package/dist/resources/schemas/DataJobDto.json +1 -6
  51. package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json +2 -20
  52. package/dist/resources/schemas/MicroserviceDto.json +1 -13
  53. package/dist/resources/schemas/PreviewMicroserviceCommand.json +1 -10
  54. package/dist/resources/schemas/PreviewWorkflowCommand.json +1 -25
  55. package/dist/resources/schemas/StartMobileBuildCommand.json +54 -0
  56. package/dist/resources/schemas/StepDto.json +1 -25
  57. package/dist/resources/schemas/UpdateEntityCommand.json +0 -118
  58. package/dist/resources/schemas/UpdateMicroserviceCommand.json +1 -13
  59. package/dist/resources/schemas/UpdateQueryCommand.json +0 -4
  60. package/dist/resources/schemas/UpdateViewCommand.json +2 -0
  61. package/dist/resources/schemas/UpdateWorkflowCommand.json +1 -146
  62. package/dist/resources/schemas/UpsertMobileStoreSettingsCommand.json +259 -0
  63. package/dist/server.js +5 -25
  64. package/dist/tools/access.js +2 -369
  65. package/dist/tools/common.js +0 -7
  66. package/dist/tools/components.js +2 -15
  67. package/dist/tools/datasources.js +2 -2
  68. package/dist/tools/dependencies.js +1 -1
  69. package/dist/tools/deployments.js +3 -38
  70. package/dist/tools/designSchemaPatch.js +3 -13
  71. package/dist/tools/dtos.js +5 -36
  72. package/dist/tools/entities.js +12 -79
  73. package/dist/tools/externalComponents.js +1 -1
  74. package/dist/tools/flows.js +10 -45
  75. package/dist/tools/folders.js +1 -1
  76. package/dist/tools/imports.js +2 -5
  77. package/dist/tools/layouts.js +5 -6
  78. package/dist/tools/merges.js +2 -2
  79. package/dist/tools/microservices.js +20 -50
  80. package/dist/tools/mobileStore.js +268 -0
  81. package/dist/tools/pages.js +35 -89
  82. package/dist/tools/platformInfo.js +6 -20
  83. package/dist/tools/projects.js +9 -71
  84. package/dist/tools/rows.js +12 -62
  85. package/dist/tools/schemaOps.js +1 -29
  86. package/dist/tools/screenWrite.js +1 -22
  87. package/dist/tools/screens.js +3 -6
  88. package/dist/tools/templates.js +1 -26
  89. package/dist/tools/translations.js +1 -1
  90. package/dist/tools/workflows.js +5 -10
  91. package/package.json +2 -2
@@ -5,32 +5,6 @@ import { logError, logStep } from '../observability/trace.js';
5
5
  import { PlatformApiError, describeErrorBody } from './errors.js';
6
6
  import { PolicyBlockError } from '../knowledge/policy.js';
7
7
  import { maskSecrets } from './secrets.js';
8
- const STACK_FRAMES_KEPT = 3;
9
- /**
10
- * Platformun hata gövdesindeki `stackTrace` yüzlerce satırdır ve çağıranın işine yarayan kısmı
11
- * ilk birkaç karedir: hatayı atan servis ve satır. Tamamını taşımak uzun bir koşuda bağlamın
12
- * büyük bölümünü yer (2026-09-19 senaryo koşusunda tek 404 ~4 bin token). Gateway izi ilk
13
- * STACK_FRAMES_KEPT kareye indirir ve kaç karenin düştüğünü söyler; tam iz platform günlüğündedir.
14
- */
15
- export function collapseStackTraces(value) {
16
- if (Array.isArray(value))
17
- return value.map(collapseStackTraces);
18
- if (value && typeof value === 'object') {
19
- const result = {};
20
- for (const [key, entry] of Object.entries(value)) {
21
- if (key === 'stackTrace' && typeof entry === 'string') {
22
- const frames = entry.split('\n');
23
- result[key] = frames.length <= STACK_FRAMES_KEPT
24
- ? entry
25
- : `${frames.slice(0, STACK_FRAMES_KEPT).join('\n')}\n … (+${frames.length - STACK_FRAMES_KEPT} kare gateway tarafından kırpıldı; tam iz platform günlüğünde)`;
26
- continue;
27
- }
28
- result[key] = collapseStackTraces(entry);
29
- }
30
- return result;
31
- }
32
- return value;
33
- }
34
8
  export function prune(value) {
35
9
  if (Array.isArray(value))
36
10
  return value.map(prune);
@@ -168,7 +142,7 @@ function asStructured(payload) {
168
142
  return { data: payload };
169
143
  }
170
144
  export function toolResult(payload, config, expectFailure) {
171
- const pruned = collapseStackTraces(prune(compactDiagnostics(payload)));
145
+ const pruned = prune(compactDiagnostics(payload));
172
146
  const { payload: safe, masked, tokenRefs } = maskSecrets(pruned);
173
147
  const runtimeErrors = runtimeErrorSummary(safe);
174
148
  if (runtimeErrors.length > 0) {
@@ -190,7 +164,7 @@ export function toolResult(payload, config, expectFailure) {
190
164
  ...(runtimeErrors.length > 0 ? { runtimeErrors } : {}),
191
165
  ...(runtimeErrors.length > 0 && expectFailure === true ? { expectedFailure: true } : {}),
192
166
  ...(masked.length > 0 ? { gatewayMasked: masked } : {}),
193
- ...(Object.keys(tokenRefs).length > 0 ? { tokenRefs, tokenRefNote: `Maskelenen JWT'ler gateway içinde tutuldu; bu referansları microservice_execute / microservice_debug / page_runtime_get / page_screenshot 'asUser' alanına verebilirsiniz (${tokenTtlMinutes()} dk geçerli; kompleks projede referans access_session_create'ten gelir). Jetonun kendisi yanıta ve günlüğe hiç girmez.` } : {}),
167
+ ...(Object.keys(tokenRefs).length > 0 ? { tokenRefs, tokenRefNote: `Maskelenen JWT'ler gateway içinde tutuldu; bu referansları page_screenshot / page_runtime_get 'asUser' alanına verebilirsiniz (${tokenTtlMinutes()} dk geçerli). Jetonun kendisi yanıta ve günlüğe hiç girmez.` } : {}),
194
168
  ...(truncated ? { truncated: true, truncationNote: 'Liste, yanıt boyutu sınırı nedeniyle kırpıldı; sayfalama ya da daha dar filtre kullanın.' } : {}),
195
169
  ...(argumentNotes().aliasesApplied.length > 0 ? { aliasesApplied: argumentNotes().aliasesApplied } : {}),
196
170
  ...(argumentNotes().bodyFile ? { bodyFile: argumentNotes().bodyFile } : {})
@@ -200,7 +174,7 @@ export function toolResult(payload, config, expectFailure) {
200
174
  structuredContent: enriched
201
175
  };
202
176
  }
203
- export function toolError(error, expectFailure) {
177
+ export function toolError(error) {
204
178
  logError(error);
205
179
  // Politika durdurması bilinçli bir karardır, "beklenmeyen" değil (33/S-5).
206
180
  const message = error instanceof PlatformApiError || error instanceof PolicyBlockError
@@ -208,12 +182,8 @@ export function toolError(error, expectFailure) {
208
182
  : error instanceof Error
209
183
  ? `Beklenmeyen gateway hatası: ${error.message}`
210
184
  : `Beklenmeyen gateway hatası: ${String(error)}`;
211
- // Kasıtlı negatif testte (bayat version 409, yetkisiz kişi 403) platform hatası da bir KANITTIR:
212
- // ölçüm aracı bu satırı plansız hata saymasın diye işaret taşınır.
213
- const isExpectedPlatformError = expectFailure === true && (error instanceof PlatformApiError || error instanceof PolicyBlockError);
214
185
  return {
215
186
  content: [{ type: 'text', text: message }],
216
- ...(isExpectedPlatformError ? { structuredContent: { expectedFailure: true } } : {}),
217
187
  isError: true
218
188
  };
219
189
  }
@@ -229,7 +199,7 @@ export function handle(config, run) {
229
199
  return toolResult(await run(args), config, expectFailure);
230
200
  }
231
201
  catch (error) {
232
- return toolError(error, args?.expectFailure === true);
202
+ return toolError(error);
233
203
  }
234
204
  };
235
205
  }
@@ -1,11 +1,11 @@
1
1
  /**
2
2
  * Sayfa okumalarının belleği. İki soru cevaplar:
3
3
  *
4
- * - "Bu sayfa sürümü kırpık okundu mu" (ZM-28, PAGE-042): `page_schema_get(mode:'full',
4
+ * - "Bu sayfa sürümü kırpık okundu mu" (ZM-28, PAGE-038): `page_schema_get(mode:'full',
5
5
  * allowTruncated:true)` sığmayan şemayı kırparak döndüğünde anahtar işaretlenir; aynı sürümü
6
6
  * `baseVersion` olarak veren `page_schema_patch` uyarı taşır — plan, düşen düğümleri görmeden
7
7
  * yapılmış olabilir.
8
- * - "Bu gateway sayfanın hangi sürümünü en son gördü" (PAGE-043, `plans/mobil-plantcare-acigi`
8
+ * - "Bu gateway sayfanın hangi sürümünü en son gördü" (PAGE-039, `plans/mobil-plantcare-acigi`
9
9
  * g-05): `page_get`, `page_schema_get`, `page_schema_patch`'in `newVersion`'ı ve `page_update`'in
10
10
  * kendi yazdığı sürüm hatırlanır; `page_update` `baseVersion` verilmediğinde onu gönderir. Hiç
11
11
  * okunmamış sayfaya sürümsüz tam gövde yazılmaz.
@@ -3,13 +3,6 @@
3
3
  * anahtarları da yakalıyordu. Günlükte zararsızdı, tool yanıtında veri kaybı olurdu.
4
4
  */
5
5
  export const secretKeyPattern = /password|passwd|secret|token|authorization|api[-_]?key|credential|connection[-_]?string/i;
6
- /**
7
- * Sırrın DEĞERİNİ değil adını, yerini ya da türünü taşıyan anahtarlar: `credentialRef`, `tokenUrl`,
8
- * `apiKeyHeader`, `secretFields`, `credentialKind`. Maskelenirlerse süreç tanımındaki
9
- * `connector.credentialRef` get → update turunda `***` olarak geri yazılır ve düğüm kasayı bulamaz
10
- * (BPM-017, Faz 8 incelemesi). Yalnız yanıt maskesinde uygulanır; günlük maskesi (`trace.ts`) geniş kalır.
11
- */
12
- export const secretNameKeyPattern = /(ref|refs|url|uri|header|fields|kind|name|names|id|ids)$/i;
13
6
  import { looksLikeJwt, rememberToken } from './tokenVault.js';
14
7
  const maskedValue = '***';
15
8
  const maxPaths = 20;
@@ -23,7 +16,7 @@ function walk(value, path, masked, refs, depth) {
23
16
  const result = {};
24
17
  for (const [key, entry] of Object.entries(value)) {
25
18
  const child = path === '' ? key : `${path}.${key}`;
26
- if (secretKeyPattern.test(key) && !secretNameKeyPattern.test(key) && entry !== null && entry !== undefined && entry !== '') {
19
+ if (secretKeyPattern.test(key) && entry !== null && entry !== undefined && entry !== '') {
27
20
  if (masked.length < maxPaths)
28
21
  masked.push(child);
29
22
  // Maskelenen değer bir JWT ise kimlik testinin yolu kapanmasın: jeton kasada tutulur ve
@@ -182,7 +182,7 @@
182
182
  ]
183
183
  },
184
184
  "settingsSetterVariant": {
185
- "note": "Genel amaçlı setter (qm '[SY] Settings Setter'): start -> settings [table get, ayarlar tablosu] -> setPrivate [type:'variable', rule.name:'settingsPrivate', rule.expression:'{ ...settings.data }', rule.dataTransferObjectId:<ayarlar DTO>, rule.isPrivate:true] -> setPublic [type:'variable', rule.name:'settings', rule.expression:'({ app_name: settings.data.app_name })']. Response YOK — sadece değişken kurar; bağlandığı her uçta settings.<alan> okunur. Sayfaya bağlanırsa işaretsiz değişkenler Page.variables ile istemciye gider: gizli değer taşıyan ya da kaydı yayan değişken isPrivate:true olmalı, istemciye gidecek alanlar izin listesiyle kurulur (MW-007). Ad öneki ([A]/[SY]) alfabetik koşum sırasını kurmak içindir."
185
+ "note": "Genel amaçlı setter (qm '[SY] Settings Setter', 3 step): start -> settings [table get, ayarlar tablosu] -> setVar [type:'variable', rule.name:'settings', rule.expression:'{ ...settings.data }', rule.dataTransferObjectId:<ayarlar DTO>]. Response YOK — sadece değişken kurar; bağlandığı her uçta settings.<alan> okunur. Ad öneki ([A]/[SY]) alfabetik koşum sırasını kurmak içindir."
186
186
  },
187
187
  "roleGateVariant": {
188
188
  "note": "Rol kapısını AYRI bir middleware'e ayırma: kimlik middleware'i set-user'a ULAŞMADAN biterse (çerez yok, koşul else dalı) 'user' hiç tanımlanmaz ve rolü okuyan middleware ham 'user is not defined' ile 500 verir — kullanıcı 401 yerine 500 görür (crm koşumu B-3). Kapıyı bu akışın İÇİNE, setUser'dan SONRA koy. Authorized hedefin rolleri BOŞSA true döndüğü için tek middleware her uca bağlanabilir; kapı yalnız roleIds dolu uçlarda kapanır.",
@@ -14,7 +14,8 @@
14
14
  "menuTarget": "app-bar.menuTarget çekmecenin elementId'sidir (nav_drawer); iç rol app_bar__menu düğmesidir — page_screenshot actions:[{ action:'click', target:'app_bar__menu' }] çekmeceyi açar.",
15
15
  "drawerFlows": "Menü düğmelerine akış ayrı adımda bağlanır: flow_create (host: 'layout', adım redirect { path: '<sayfa slug'ı>' }) → layout_schema_patch set_event { target: 'menu_gorevler', event: 'click' }.",
16
16
  "drawerNode": "Çekmece mobil kataloğun `drawer` bileşenidir (kind 'component', çocuk alır): layout'a doğrudan yazılır, prop'ları katalogdakilerdir (`position`, `size`, `title`, `isDismissDisabled`); kapalı doğar, `app-bar` menüsü `isOpen: true` yazarak açar. Katalogda olmayan prop (ör. `width`, `overlay`) ya da seçenek dışı değer (düğmede `variant: 'ghost'` — geçerli olanlar `solid`/`text`/`outline`) layout_create'i 422 ile düşürür.",
17
- "layoutContract": "Mizanpaj sözleşmesi: üst güvenli alan tek yerde, kabukta (app-bar 'safe-area' edges:'top' içinde; sayfa ikinci pay vermez). Ekran kenarı boşluğu tek değer (16) ve tek yerde: slot'un yatay ve üst margin'i — içerik app-bar'ın 16 dp altından başlar, kabuksuz sayfadaki gibi. shell_root 'shrink' ve padding'siz — düz container olduğu için tip yazılmazsa runtime 10 dp padding verir ve app-bar kenardan kopar."
17
+ "layoutContract": "Mizanpaj sözleşmesi: üst güvenli alan tek yerde, kabukta (app-bar 'safe-area' edges:'top' içinde; sayfa ikinci pay vermez). Ekran kenarı boşluğu tek değer (16) ve tek yerde: slot'un yatay ve üst margin'i — içerik app-bar'ın 16 dp altından başlar, kabuksuz sayfadaki gibi. shell_root 'shrink' ve padding'siz — düz container olduğu için tip yazılmazsa runtime 10 dp padding verir ve app-bar kenardan kopar.",
18
+ "layerAtRoot": "Katman (drawer, modal) layout ya da sayfa şemasının KÖK dizisinde, kök kabın kardeşi olarak durur; kabın içinde 422 layer-outside-root alır. Çekmece runtime'da katman olarak açılır, akıştaki yeri yoktur."
18
19
  },
19
20
  "mobileAppCreate": {
20
21
  "slug": "saha-menu",
@@ -158,83 +159,83 @@
158
159
  "validations": [],
159
160
  "stateBindings": [],
160
161
  "children": []
162
+ }
163
+ ]
164
+ },
165
+ {
166
+ "elementId": "nav_drawer",
167
+ "name": "nav_drawer",
168
+ "type": "drawer",
169
+ "kind": "component",
170
+ "props": {
171
+ "position": {
172
+ "type": "static",
173
+ "ref": null,
174
+ "data": "left"
161
175
  },
176
+ "size": {
177
+ "type": "static",
178
+ "ref": null,
179
+ "data": "default"
180
+ }
181
+ },
182
+ "appearance": {},
183
+ "blocks": [],
184
+ "events": [],
185
+ "validations": [],
186
+ "stateBindings": [],
187
+ "children": [
162
188
  {
163
- "elementId": "nav_drawer",
164
- "name": "nav_drawer",
165
- "type": "drawer",
189
+ "elementId": "menu_gorevler",
190
+ "name": "menu_gorevler",
191
+ "type": "button",
166
192
  "kind": "component",
167
193
  "props": {
168
- "position": {
194
+ "text": {
169
195
  "type": "static",
170
196
  "ref": null,
171
- "data": "left"
197
+ "data": "Görevler"
172
198
  },
173
- "size": {
199
+ "variant": {
174
200
  "type": "static",
175
201
  "ref": null,
176
- "data": "default"
202
+ "data": "text"
177
203
  }
178
204
  },
179
- "appearance": {},
205
+ "appearance": {
206
+ "widthType": "fill"
207
+ },
180
208
  "blocks": [],
181
209
  "events": [],
182
210
  "validations": [],
183
211
  "stateBindings": [],
184
- "children": [
185
- {
186
- "elementId": "menu_gorevler",
187
- "name": "menu_gorevler",
188
- "type": "button",
189
- "kind": "component",
190
- "props": {
191
- "text": {
192
- "type": "static",
193
- "ref": null,
194
- "data": "Görevler"
195
- },
196
- "variant": {
197
- "type": "static",
198
- "ref": null,
199
- "data": "text"
200
- }
201
- },
202
- "appearance": {
203
- "widthType": "fill"
204
- },
205
- "blocks": [],
206
- "events": [],
207
- "validations": [],
208
- "stateBindings": [],
209
- "children": []
212
+ "children": []
213
+ },
214
+ {
215
+ "elementId": "menu_profil",
216
+ "name": "menu_profil",
217
+ "type": "button",
218
+ "kind": "component",
219
+ "props": {
220
+ "text": {
221
+ "type": "static",
222
+ "ref": null,
223
+ "data": "Profil"
210
224
  },
211
- {
212
- "elementId": "menu_profil",
213
- "name": "menu_profil",
214
- "type": "button",
215
- "kind": "component",
216
- "props": {
217
- "text": {
218
- "type": "static",
219
- "ref": null,
220
- "data": "Profil"
221
- },
222
- "variant": {
223
- "type": "static",
224
- "ref": null,
225
- "data": "text"
226
- }
227
- },
228
- "appearance": {
229
- "widthType": "fill"
230
- },
231
- "blocks": [],
232
- "events": [],
233
- "validations": [],
234
- "stateBindings": [],
235
- "children": []
225
+ "variant": {
226
+ "type": "static",
227
+ "ref": null,
228
+ "data": "text"
236
229
  }
237
- ]
230
+ },
231
+ "appearance": {
232
+ "widthType": "fill"
233
+ },
234
+ "blocks": [],
235
+ "events": [],
236
+ "validations": [],
237
+ "stateBindings": [],
238
+ "children": []
238
239
  }
239
240
  ]
240
241
  }
@@ -80,28 +80,59 @@
80
80
  "stateBindings": [],
81
81
  "children": [
82
82
  {
83
- "elementId": "row_card",
84
- "name": "row_card",
85
- "type": "card",
83
+ "elementId": "lst_tasks_satir",
84
+ "name": "lst_tasks_satir",
85
+ "type": "view",
86
86
  "kind": "component",
87
- "props": {
88
- "title": {
89
- "type": "code",
90
- "ref": "{{ item.title }}"
91
- },
92
- "description": {
93
- "type": "code",
94
- "ref": "{{ item.status }}"
87
+ "props": {},
88
+ "children": [
89
+ {
90
+ "elementId": "row_card",
91
+ "name": "row_card",
92
+ "type": "card",
93
+ "kind": "component",
94
+ "props": {
95
+ "title": {
96
+ "type": "code",
97
+ "ref": "{{ item.title }}"
98
+ },
99
+ "description": {
100
+ "type": "code",
101
+ "ref": "{{ item.status }}"
102
+ }
103
+ },
104
+ "appearance": {
105
+ "widthType": "fill"
106
+ },
107
+ "blocks": [],
108
+ "events": [],
109
+ "validations": [],
110
+ "stateBindings": [],
111
+ "children": []
95
112
  }
96
- },
97
- "appearance": {
98
- "widthType": "fill"
99
- },
100
- "blocks": [],
101
- "events": [],
102
- "validations": [],
103
- "stateBindings": [],
104
- "children": []
113
+ ]
114
+ },
115
+ {
116
+ "elementId": "lst_tasks_bos_gorunum",
117
+ "name": "lst_tasks_bos_gorunum",
118
+ "type": "view",
119
+ "kind": "component",
120
+ "props": {},
121
+ "children": [
122
+ {
123
+ "elementId": "lst_tasks_bos",
124
+ "name": "lst_tasks_bos",
125
+ "type": "emptystate",
126
+ "kind": "component",
127
+ "props": {
128
+ "title": {
129
+ "type": "static",
130
+ "data": "Kayıt yok"
131
+ }
132
+ },
133
+ "children": []
134
+ }
135
+ ]
105
136
  }
106
137
  ]
107
138
  }
@@ -64,10 +64,9 @@
64
64
  "children": [], "events": [], "validations": [], "stateBindings": []
65
65
  }
66
66
  },
67
+ { "op": "set_event", "target": "page_container", "event": "mount", "eventValue": "<profil yükleme flow id>" },
67
68
  { "op": "set_event", "target": "password_form", "event": "submit", "eventValue": "<şifre güncelleme flow id>" }
68
69
  ],
69
- "pageEvents": [{ "name": "mount", "value": "<profil yükleme flow id>" }],
70
- "_pageEventsNote": "pageEvents page_update { events } ile yazılır; set_event ile page_container'a bağlanmaz — page_container Studio'nun Layers ağacında görünmez.",
71
70
  "mountFlowCreateArgs": {
72
71
  "host": "page",
73
72
  "hostId": "<sayfa id>",
@@ -70,7 +70,7 @@
70
70
  "hostId": "<page id>",
71
71
  "name": "Formu yukle",
72
72
  "slug": "formu-yukle",
73
- "_note": "Sayfanın kendi mount olayına bağlanır (page_update { events: [{ name: 'mount', value: <flow id> }] }; page_container'a değil — Layers'ta görünmez). condition adımı `always` dalını kural dallarıyla BİRLİKTE taşır: always yükleniyor bayrağını her koşumda kapatır, kural dalları içeriği kurar.",
73
+ "_note": "page_container.mount'a bağlanır. condition adımı `always` dalını kural dallarıyla BİRLİKTE taşır: always yükleniyor bayrağını her koşumda kapatır, kural dalları içeriği kurar.",
74
74
  "steps": [
75
75
  {
76
76
  "stepId": "start", "name": "start", "type": "start", "kind": "normal",
@@ -208,9 +208,8 @@
208
208
  }
209
209
  ]
210
210
  },
211
- "pageEvents": [{ "name": "mount", "value": "<load flow id>" }],
212
- "_pageEventsNote": "pageEvents page_update { events } ile yazılır; set_event ile page_container'a bağlanmaz — page_container Studio'nun Layers ağacında görünmez.",
213
211
  "eventPatchOps": [
212
+ { "op": "set_event", "target": "page_container", "event": "mount", "eventValue": "<load flow id>" },
214
213
  { "op": "set_event", "target": "btn_submit", "event": "click", "eventValue": "<submit flow id>" }
215
214
  ],
216
215
  "verification": {
@@ -60,7 +60,7 @@
60
60
  {
61
61
  "name": "Panoyu doldur",
62
62
  "slug": "panoyu-doldur",
63
- "note": "actions[0].flow buna işaret eder; ayrıca sayfanın kendi mount olayına page_update { events } ile bağlanır (ilk yükleme; page_container'a değil — Layers'ta görünmez).",
63
+ "note": "actions[0].flow buna işaret eder; ayrıca page_container.mount'a set_event ile bağlanır (ilk yükleme).",
64
64
  "steps": [
65
65
  {
66
66
  "stepId": "start", "name": "Start", "type": "start", "kind": "normal", "args": {},
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "_meta": {
3
3
  "synthetic": true,
4
- "note": "hr projesinde doğrulanmış şekil. Kurallar: step/branch id'leri GERÇEK GUID ve global benzersiz (RowAlreadyExists); DtoId verilen yerde Behavior zorunlu; table rule'da datasourceId + fieldId zorunlu; filtre value JavaScript ifadesi ve source:\"expression\" + filterType:\"single\" ister (yoksa filtre sessizce yok sayılır, bütün satırlar döner — 38/U-16); adım adı ifadedeki değişken adıdır, geçerli JS tanımlayıcısı olmalı (load_product.data); preview girdisi previewPayload anahtarıyla. bağlanmamış fail dalı hataya düşerse start'taki global-error dalına gider (IStep.cs:74-86)."
4
+ "note": "hr projesinde doğrulanmış şekil. Kurallar: step/branch id'leri GERÇEK GUID ve global benzersiz (RowAlreadyExists); DtoId verilen yerde Behavior zorunlu; table rule'da datasourceId + fieldId zorunlu; filtre value JavaScript ifadesi; preview girdisi previewPayload anahtarıyla. bağlanmamış fail dalı hataya düşerse start'taki global-error dalına gider (IStep.cs:74-86)."
5
5
  },
6
6
  "definition": {
7
7
  "name": "Product Lookup",
@@ -34,7 +34,7 @@
34
34
  },
35
35
  {
36
36
  "id": "<GUID-3>",
37
- "name": "load_product",
37
+ "name": "Load Product",
38
38
  "description": "input.productName ile ürünü okur; tek kayıt bekler.",
39
39
  "caution": "Ad benzersiz değil: aynı adda birden çok ürün varsa ilkini alır, hiç yoksa sessizce boş döner.",
40
40
  "type": "table",
@@ -59,15 +59,9 @@
59
59
  ],
60
60
  "filters": [
61
61
  {
62
- "alias": "<entity slug>",
63
62
  "fieldSlug": "name",
64
63
  "operator": "eq",
65
- "source": "expression",
66
64
  "value": "input.productName",
67
- "filterType": "single",
68
- "conditionType": "and",
69
- "children": [],
70
- "order": 0,
71
65
  "fieldId": "<name alanı id>"
72
66
  }
73
67
  ],
@@ -350,8 +350,9 @@ hesaplar.
350
350
  olunca değerler yerindedir; o ana kadar yeni kolona filtre 0 satır dönebilir. Kaynak alan o sırada
351
351
  dönüşümdeyse doldurma onu atlar; dönüşüm bitince (`protection-*` `completed`) platform aynı tabloya
352
352
  bir `derived-fill` işi daha açar ve dönüşümün önceden işlediği satırları da doldurur — değerleri o
353
- işin bitişinden sonra okuyun. Yalnız ad değişikliği ve silme iş açmaz. Deployment, merge ya da şablon
354
- güncellemesiyle hedef ortama gelen türetilmiş alanı da platform hedefte aynı işle doldurur.
353
+ işin bitişinden sonra okuyun. Yalnız ad değişikliği ve silme iş açmaz. Bilinen eksik:
354
+ deployment/merge ya da şablon kurulumuyla hedef ortama gelen türetilmiş alan orada kendiliğinden
355
+ dolmaz (platform bulgusu VK-21).
355
356
 
356
357
  ## Arama ve sıralama (PROT-001 · PROT-002)
357
358
 
@@ -378,8 +379,7 @@ Kompleks projede kimliği platform yönetir; uygulamanın kendi kimlik middlewar
378
379
 
379
380
  - Jeton önce çerezden, yoksa `Authorization: Bearer`'dan okunur. Çerezle gelen **durum değiştiren**
380
381
  istek `X-ZY-CSRF` başlığında `ZY_Csrf_{proje}` değerini ister (yoksa `403 CsrfTokenMismatch`);
381
- Bearer'lı istek CSRF istemez. Oturum veren yanıt değeri `X-ZY-CSRF` yanıt başlığıyla da döner (mobil
382
- runtime çerez kavanozunu okuyamaz, değeri buradan alır). Giriş hız sınırı 5 dk'da 10 deneme (429).
382
+ Bearer'lı istek CSRF istemez. Giriş hız sınırı 5 dk'da 10 deneme (429).
383
383
  - Kullanıcı projenin `users` tablosundadır; parola biçimi değişmedi (`Hasher.Hash`).
384
384
  - **Özne:** kullanıcı id'si, pozisyonları, birimleri, şirketleri, rol slug'ları, işlev kodları.
385
385
  **Kompleks projede rol YALNIZ pozisyondan gelir** (2026-09-21, S-15): `users` ekranından verilen
@@ -397,20 +397,6 @@ Kompleks projede kimliği platform yönetir; uygulamanın kendi kimlik middlewar
397
397
  kartı `access.session.get` system microservice'iyle `microservice` adımından çağrılır: runtime
398
398
  `X-Environment`'ı, CSRF'i ve 401'de tek yenilemeyi kendisi yapar, giriş gövdesi jeton taşımaz.
399
399
  Yanlış parola `401 AppSignInFailedException` döner (oturum hatası değildir, yenileme tetiklemez).
400
- - **Çıkış `access.session.delete`'tir (FLOW-037).** `source: 'system'`, `isAnonymous: true` bir uç
401
- açın; çıkış akışı `microservice` adımıyla onu çağırır, ardından `redirect` ile giriş sayfasına
402
- gider. Uç refresh ailesini sunucuda iptal eder ve üç oturum çerezini (`ZY_App_` · `ZY_AppRefresh_` ·
403
- `ZY_Csrf_`) yanıtla siler. Koruması `session`'dır: erişim jetonu (15 dk) dolmuşsa uç
404
- `401 AppSessionRequired` döner, runtime (web `/view` ve mobil) oturumu bir kez yeniler ve çıkışı
405
- tekrarlar — aile ancak böyle bulunur, refresh çerezi uca gitmez. Yenileme düşerse (aile zaten
406
- kapalı) runtime uygulamanın giriş/açılış sayfasına gider; çıkış akışının `error` dalı da `redirect`
407
- ile giriş sayfasına bağlanır (FLOW-036). Uç yine `isAnonymous: true` kalır: anonim olmayan uçta
408
- `microservice.execute` izni sorulur, çıkış her rol için izin isterdi. Akışın
409
- `cookie.remove` / `storage` / `setcookie` adımları bu çerezlere **ulaşmaz** — HttpOnly'dir; mobilde
410
- akış deposu Keychain/kv-store'dur, cihazın çerez kavanozu değil. Öyle kurulan çıkış ekranda çalışır
411
- görünür, ama refresh çerezi (30 gün) kalır ve uygulama kapat-aç sonrası girişli açılır (ölçüldü
412
- 2026-10-01, `mobile-qm`). Uygulamanın kendi değerleri (ör. "oturumu açık tut" bayrağı) `storage`'da
413
- kalabilir.
414
400
 
415
401
  ## Zorlama modu
416
402
 
@@ -164,8 +164,7 @@ da yazılır) — yine de açık bir snake_case ad verin (`"resultKey": "grup_on
164
164
  düğümü geri yazar). "Ret satıra durum yazsın" isteyen tasarım, ret hedefini geri yazmayı yapan bir
165
165
  `script` düğümü yapar ve oradan asıl hedefe bir kenar çeker (ölçüldü 2026-09-21, S-6 CAPA).
166
166
 
167
- **service** — workflow çağrısı: `workflowId` (zorunlu; yalnız `workflowSlug` yazılan düğüm önizlemede ve yayında
168
- `DefinitionInvalid` alır — slug değişebilir, bağ kimlikle tutulur; yanıt ikisini birlikte döner), `input: { ad: "<Jint>" }`, `output: "vars.x"`,
167
+ **service** — workflow çağrısı: `workflowId`, `input: { ad: "<Jint>" }`, `output: "vars.x"`,
169
168
  `retry: { count }`. Başarısızlık `retry.count` (varsayılan 3) sonra örneği `faulted` yapar.
170
169
  `runAs: system` gerekçesi `caution`'da durur (BPM-005). `input` anahtarları workflow'un **parametre DTO
171
170
  alanlarının `slug`'larıdır** (`dto_get` → `children[].slug`); platform onları alan kimliğine bağlar. DTO'da
@@ -211,10 +210,6 @@ nesnesi), `input`, `output`, `binding: latest (varsayılan) | deployed | v:<n>`
211
210
  aktif sürümü okur; sabitlemek için `v:<n>`), `forEach { entity, where: "item.aktif === true",
212
211
  batch }` (partili başlatma, hepsi bitince devam). Alt örnek kuyruktan başlar; üst örnek
213
212
  `sub-process-completed` ile ilerler.
214
- `v:<n>` yayında **o sürümün kimliğine** bağlanır; numara ortamın yerel sayacıdır ve merge/promote
215
- ara sürümleri taşımaz. Aktarım bağı hedefte **aynı içerikli** sürüme yeniden yazar (numara değişebilir,
216
- ör. development `v:3` → production `v:2`); hedefte o içerik yoksa promote 422
217
- `SubProcessBindingNotCarried` ile durur — önce çağrılan sürümü taşıyın ya da bağı değiştirin.
218
213
 
219
214
  **region** — uyarlanabilir blok ve olay kapsamı: `nodes`, `edges`, `limits { maxSteps, nodeTypes,
220
215
  assigneeRules }`, `on[]`. Girişler iç kenarlarda hedef olmayan düğümlerdir; iç tokenlar bitince dış