@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.
- package/.env.example +0 -15
- package/dist/config.js +0 -11
- package/dist/index.js +0 -2
- package/dist/knowledge/boxSections.js +184 -0
- package/dist/knowledge/componentCatalog.js +634 -255
- package/dist/knowledge/componentEvents.js +38 -32
- package/dist/knowledge/layoutSummary.js +2 -140
- package/dist/knowledge/normalize.js +144 -117
- package/dist/knowledge/rules.js +42 -291
- package/dist/knowledge/styleResolve.js +53 -58
- package/dist/knowledge/themeResolve.js +4 -4
- package/dist/knowledge/themeSchema.js +2 -1
- package/dist/observability/trace.js +1 -1
- package/dist/platform/diagnostics.js +4 -10
- package/dist/platform/domSummary.js +1 -1
- package/dist/platform/http.js +7 -23
- package/dist/platform/responses.js +2 -6
- package/dist/platform/screenshot.js +1162 -0
- package/dist/platform/secrets.js +0 -9
- package/dist/platform/strictArguments.js +12 -68
- package/dist/platform/tokenVault.js +4 -187
- package/dist/resources/examples/layout-app-shell.json +707 -229
- package/dist/resources/examples/page-flex-sections.json +1 -1
- package/dist/resources/guides/component.md +6 -14
- package/dist/resources/guides/entity.md +5 -3
- package/dist/resources/guides/expressions.md +5 -14
- package/dist/resources/guides/functions.md +1 -1
- package/dist/resources/guides/layout.md +58 -55
- package/dist/resources/guides/microservice.md +2 -9
- package/dist/resources/guides/middleware.md +2 -34
- package/dist/resources/guides/page.md +179 -256
- package/dist/resources/guides/theme.md +3 -8
- package/dist/resources/guides/translation.md +1 -1
- package/dist/resources/guides/workflow.md +1 -7
- package/dist/resources/schema-fingerprint.json +4 -4
- package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json +1 -3
- package/dist/resources/schemas/MicroserviceDto.json +2 -2
- package/dist/server.js +1 -7
- package/dist/tools/applications.js +3 -60
- package/dist/tools/components.js +16 -103
- package/dist/tools/datasources.js +1 -1
- package/dist/tools/designSchemaPatch.js +19 -23
- package/dist/tools/externalComponents.js +4 -25
- package/dist/tools/flows.js +13 -80
- package/dist/tools/layouts.js +20 -48
- package/dist/tools/microservices.js +10 -32
- package/dist/tools/pages.js +115 -396
- package/dist/tools/platformInfo.js +2 -7
- package/dist/tools/rows.js +1 -7
- package/dist/tools/schemaOps.js +4 -35
- package/dist/tools/screenWrite.js +37 -25
- package/dist/tools/screens.js +4 -91
- package/dist/tools/variables.js +5 -11
- package/package.json +2 -2
- package/dist/knowledge/access.js +0 -802
- package/dist/knowledge/case.js +0 -41
- package/dist/knowledge/connectDataBind.js +0 -819
- package/dist/knowledge/connectDataDefinition.js +0 -341
- package/dist/knowledge/connectDataExecute.js +0 -93
- package/dist/knowledge/connectDataRules.js +0 -128
- package/dist/knowledge/decision.js +0 -121
- package/dist/knowledge/expressionPrelude.js +0 -59
- package/dist/knowledge/microserviceParameters.js +0 -58
- package/dist/knowledge/mining.js +0 -94
- package/dist/knowledge/mobileComponentCatalog.js +0 -864
- package/dist/knowledge/mobileComponentEvents.js +0 -239
- package/dist/knowledge/mobileStore.js +0 -227
- package/dist/knowledge/platform/lint.js +0 -385
- package/dist/knowledge/platform/mobile.js +0 -142
- package/dist/knowledge/platform/mobileLayoutLint.js +0 -324
- package/dist/knowledge/platform/mobileRules.js +0 -231
- package/dist/knowledge/platform/mobileSpacing.js +0 -82
- package/dist/knowledge/platform/mobileTabs.js +0 -108
- package/dist/knowledge/platform/nativeBoxModel.js +0 -44
- package/dist/knowledge/platform/profile.js +0 -25
- package/dist/knowledge/platform/resolve.js +0 -122
- package/dist/knowledge/platform/web.js +0 -39
- package/dist/knowledge/process.js +0 -510
- package/dist/knowledge/rowFilter.js +0 -43
- package/dist/knowledge/styleResolveNative.js +0 -527
- package/dist/platform/argumentAliases.js +0 -128
- package/dist/platform/bodyFile.js +0 -103
- package/dist/platform/capture/actions.js +0 -333
- package/dist/platform/capture/browser.js +0 -1
- package/dist/platform/capture/capture.js +0 -659
- package/dist/platform/capture/console-log.js +0 -122
- package/dist/platform/capture/index.js +0 -11
- package/dist/platform/capture/readiness.js +0 -103
- package/dist/platform/capture/summary.js +0 -77
- package/dist/platform/capture/target.js +0 -5
- package/dist/platform/capture/targets/studio-mobile.js +0 -15
- package/dist/platform/capture/targets/studio-web.js +0 -5
- package/dist/platform/impersonation.js +0 -45
- package/dist/platform/jsonArray.js +0 -24
- package/dist/platform/schemaReadMemory.js +0 -60
- package/dist/resources/examples/bpm-gorev-kontrol.json +0 -294
- package/dist/resources/examples/bpm-iso-dokuman.json +0 -228
- package/dist/resources/examples/bpm-satinalma.json +0 -376
- package/dist/resources/examples/connect-data-convert-verify.json +0 -107
- package/dist/resources/examples/connect-data-dropdown-roles.json +0 -66
- package/dist/resources/examples/connect-data-edit-m2m.json +0 -73
- package/dist/resources/examples/connect-data-query-params.json +0 -50
- package/dist/resources/examples/connect-data-table-entity.json +0 -147
- package/dist/resources/examples/connect-data-workflow-microservice.json +0 -65
- package/dist/resources/examples/mobile-app-shell-drawer.json +0 -244
- package/dist/resources/examples/mobile-app-shell-stack.json +0 -157
- package/dist/resources/examples/mobile-app-shell-tab.json +0 -208
- package/dist/resources/examples/mobile-form-screen.json +0 -365
- package/dist/resources/examples/mobile-list-detail-form.json +0 -703
- package/dist/resources/guides/access.md +0 -796
- package/dist/resources/guides/bpm.md +0 -686
- package/dist/resources/guides/case.md +0 -153
- package/dist/resources/guides/decision.md +0 -185
- package/dist/resources/guides/mobile-layout.md +0 -193
- package/dist/resources/guides/mobile.md +0 -578
- package/dist/resources/read.js +0 -41
- package/dist/resources/schemas/AccessExplanationDto.json +0 -144
- package/dist/resources/schemas/AccessMatrixDto.json +0 -170
- package/dist/resources/schemas/AccessPermissionDto.json +0 -57
- package/dist/resources/schemas/AccessPolicyDto.json +0 -223
- package/dist/resources/schemas/AccessResourceDto.json +0 -86
- package/dist/resources/schemas/AppSessionDto.json +0 -53
- package/dist/resources/schemas/ConnectDataDescribeDto.json +0 -344
- package/dist/resources/schemas/ConnectDataRequestModel.json +0 -202
- package/dist/resources/schemas/ConnectDataResultDto.json +0 -421
- package/dist/resources/schemas/ConnectorCredentialDto.json +0 -70
- package/dist/resources/schemas/ConvertConnectDataToMicroserviceCommand.json +0 -37
- package/dist/resources/schemas/CreateAccessPolicyCommand.json +0 -209
- package/dist/resources/schemas/CreateDecisionCommand.json +0 -221
- package/dist/resources/schemas/CreateProcessDefinitionCommand.json +0 -1337
- package/dist/resources/schemas/DecisionDto.json +0 -302
- package/dist/resources/schemas/DetachConnectDataMicroserviceCommand.json +0 -28
- package/dist/resources/schemas/ExplainAccessQuery.json +0 -33
- package/dist/resources/schemas/GenerateProcessDocumentCommand.json +0 -116
- package/dist/resources/schemas/OrganizationProjectDto.json +0 -335
- package/dist/resources/schemas/OrganizationSchemaDto.json +0 -196
- package/dist/resources/schemas/OrganizationSchemaVersionDto.json +0 -207
- package/dist/resources/schemas/PatchProcessDefinitionCommand.json +0 -76
- package/dist/resources/schemas/ProcessDefinitionDto.json +0 -1480
- package/dist/resources/schemas/ProcessSimulationDto.json +0 -96
- package/dist/resources/schemas/SaveConnectorCredentialCommand.json +0 -90
- package/dist/resources/schemas/SaveProcessEventSourceCommand.json +0 -61
- package/dist/resources/schemas/SaveProcessMailSourceCommand.json +0 -89
- package/dist/resources/schemas/SignProcessTaskCommand.json +0 -73
- package/dist/resources/schemas/SimulateProcessDefinitionQuery.json +0 -92
- package/dist/resources/schemas/StartMobileBuildCommand.json +0 -54
- package/dist/resources/schemas/UpdateAccessPolicyCommand.json +0 -209
- package/dist/resources/schemas/UpdateDecisionCommand.json +0 -216
- package/dist/resources/schemas/UpdateProcessDefinitionCommand.json +0 -1357
- package/dist/resources/schemas/UpsertMobileStoreSettingsCommand.json +0 -259
- package/dist/resources/schemas/ValidateProcessDefinitionQuery.json +0 -1339
- package/dist/tools/accessOperations.js +0 -135
- package/dist/tools/accessPolicies.js +0 -170
- package/dist/tools/accessRuntime.js +0 -203
- package/dist/tools/bpm.js +0 -343
- package/dist/tools/bpmGovernance.js +0 -266
- package/dist/tools/bpmOperations.js +0 -230
- package/dist/tools/bpmReporting.js +0 -154
- package/dist/tools/bpmRouting.js +0 -150
- package/dist/tools/bpmRuntime.js +0 -396
- package/dist/tools/case.js +0 -178
- package/dist/tools/caseRuntime.js +0 -89
- package/dist/tools/connectData.js +0 -449
- package/dist/tools/connectors.js +0 -193
- package/dist/tools/decisions.js +0 -206
- package/dist/tools/mobile.js +0 -221
- package/dist/tools/mobileStore.js +0 -268
- package/dist/tools/modules.js +0 -48
- package/dist/tools/organizationStructure.js +0 -137
- 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));
|
|
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** (
|
|
66
|
-
`
|
|
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).
|
|
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)
|
|
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
|
|
294
|
-
|
|
295
|
-
`
|
|
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/
|
|
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` |
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
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.
|
|
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
|
-
|
|
82
|
-
`layout_create`'in `views` alanına doğrudan verilebilir
|
|
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
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
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
|
-
- **
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
`
|
|
100
|
-
|
|
101
|
-
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
`
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
- **
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
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
|
|
148
|
-
//
|
|
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
|
|
187
|
-
| Kırılıma duyarlı prop yok | `direction`/`gap` masaüstü ve
|
|
188
|
-
|
|
|
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` (
|
|
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:
|
|
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
|
|
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,
|
|
60
|
-
slug, roles,
|
|
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
|