@appaflytech/zeyrek-ai-mcp 0.0.18 → 0.0.20
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/README.md +13 -14
- package/dist/config.js +2 -0
- package/dist/knowledge/componentCatalog.js +204 -836
- package/dist/knowledge/componentEvents.js +75 -368
- package/dist/knowledge/mobileComponentCatalog.js +331 -0
- package/dist/knowledge/mobileComponentEvents.js +50 -0
- package/dist/knowledge/normalize.js +63 -66
- package/dist/knowledge/platform/lint.js +205 -0
- package/dist/knowledge/platform/mobile.js +78 -0
- package/dist/knowledge/platform/mobileRules.js +121 -0
- package/dist/knowledge/platform/mobileTabs.js +108 -0
- package/dist/knowledge/platform/profile.js +20 -0
- package/dist/knowledge/platform/resolve.js +122 -0
- package/dist/knowledge/platform/web.js +38 -0
- package/dist/knowledge/rules.js +6 -29
- package/dist/knowledge/styleResolve.js +1 -1
- package/dist/knowledge/styleResolveNative.js +410 -0
- package/dist/knowledge/themeResolve.js +3 -3
- package/dist/platform/capture/actions.js +333 -0
- package/dist/platform/capture/browser.js +1 -0
- package/dist/platform/{screenshot.js → capture/capture.js} +23 -509
- package/dist/platform/capture/index.js +10 -0
- package/dist/platform/capture/readiness.js +103 -0
- package/dist/platform/capture/summary.js +77 -0
- package/dist/platform/capture/target.js +5 -0
- package/dist/platform/capture/targets/studio-mobile.js +15 -0
- package/dist/platform/capture/targets/studio-web.js +5 -0
- package/dist/platform/domSummary.js +1 -1
- package/dist/platform/responses.js +1 -2
- package/dist/platform/strictArguments.js +2 -22
- package/dist/platform/writeDiff.js +31 -58
- package/dist/resources/examples/mobile-app-shell-drawer.json +209 -0
- package/dist/resources/examples/mobile-app-shell-stack.json +123 -0
- package/dist/resources/examples/mobile-app-shell-tab.json +174 -0
- package/dist/resources/examples/mobile-list-detail-form.json +656 -0
- package/dist/resources/guides/component.md +6 -9
- package/dist/resources/guides/functions.md +3 -32
- package/dist/resources/guides/getting-started.md +0 -35
- package/dist/resources/guides/layout.md +11 -7
- package/dist/resources/guides/mobile.md +215 -0
- package/dist/resources/guides/page.md +71 -49
- package/dist/resources/guides/translation.md +6 -5
- package/dist/resources/schema-fingerprint.json +2 -2
- package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json +0 -18
- package/dist/server.js +2 -0
- package/dist/tools/applications.js +60 -3
- package/dist/tools/components.js +50 -10
- package/dist/tools/designSchemaPatch.js +18 -13
- package/dist/tools/externalComponents.js +25 -4
- package/dist/tools/flows.js +51 -38
- package/dist/tools/functions.js +10 -20
- package/dist/tools/layouts.js +41 -9
- package/dist/tools/microservices.js +11 -39
- package/dist/tools/mobile.js +203 -0
- package/dist/tools/pages.js +127 -95
- package/dist/tools/platformInfo.js +2 -1
- package/dist/tools/profileWrite.js +45 -0
- package/dist/tools/schemaOps.js +2 -2
- package/dist/tools/screenWrite.js +2 -2
- package/dist/tools/screens.js +9 -3
- package/dist/tools/workflows.js +12 -39
- package/package.json +2 -7
- package/dist/platform/diagnostics.js +0 -85
- package/dist/platform/ifExists.js +0 -129
- package/dist/platform/writeView.js +0 -17
|
@@ -105,16 +105,14 @@ globalThis["toplamHesapla"] = function (fiyat, adet) { // studio: Function
|
|
|
105
105
|
"name": "toplamHesapla", "description": "fiyat × adet; adet verilmezse 1",
|
|
106
106
|
"parameters": [ { "name": "fiyat", "type": "number", "required": true },
|
|
107
107
|
{ "name": "adet", "type": "number", "defaultValue": 1 } ],
|
|
108
|
-
"body": "
|
|
109
|
-
return fiyat * adet;" }
|
|
108
|
+
"body": "return fiyat * adet;" }
|
|
110
109
|
|
|
111
110
|
// tarayıcı
|
|
112
111
|
{ "source": "studio", "applicationId": "<app id>", "scope": "application",
|
|
113
112
|
"name": "toplamHesapla", "description": "fiyat × adet; adet verilmezse 1",
|
|
114
113
|
"isAsync": false,
|
|
115
114
|
"parameters": [ … aynı liste … ],
|
|
116
|
-
"body": "
|
|
117
|
-
return fiyat * adet;" }
|
|
115
|
+
"body": "return fiyat * adet;" }
|
|
118
116
|
```
|
|
119
117
|
|
|
120
118
|
Gövde **düz deyimlerdir** — `function (…) { }` sarmalı ya da arrow yazılmaz; `return` serbesttir,
|
|
@@ -130,33 +128,6 @@ sözdizimi hatası `422 GlobalFunctionBodyInvalid` ile ve ayrıştırıcı mesaj
|
|
|
130
128
|
| FN-004 | `source:'workflow'` + `isAsync:true` | **block** — motor senkron, 422 `GlobalFunctionAsyncNotAllowed` |
|
|
131
129
|
| FN-004 | studio: `isAsync:true` ama `await` yok · `isAsync:false` ama `await` var | warn — ilki gereksiz async (inline `[object Promise]`), ikincisi **derlenmeyen gövde**: fonksiyon atlanır |
|
|
132
130
|
| FN-005 | Kaynak/kapsam tutarsız: workflow'a `applicationId`/`scope`/`pageId`; studio'ya `applicationId` ya da `scope` yok; `page` kapsamına `pageId` yok; `application` kapsamına `pageId` var | **block** — platform 422 |
|
|
133
|
-
| FN-006 | 5+ dolu satırlı gövdede hiç yorum yok | warn — baş yorumu ekleyin (§Gövdede yorum) |
|
|
134
|
-
|
|
135
|
-
### Gövdede yorum (FN-006)
|
|
136
|
-
|
|
137
|
-
Gövdeyi okuyan bir sonraki kişi (insan ya da ajan) fonksiyonu Studio'nun Functions drawer'ında
|
|
138
|
-
açar; yorumlar orada **yeşil italik** çizilir ve koddan ayrı okunur. Bu yüzden her gövde yorum taşır:
|
|
139
|
-
|
|
140
|
-
- **Baş yorumu** — ilk satırlar: fonksiyon ne yapar, parametrelerin anlamı ve birimi, ne döner.
|
|
141
|
-
Tek satırlık `return` gövdesinde bile bir satır yeterlidir.
|
|
142
|
-
- **Adım yorumu** — yalnız açık olmayan adımların üstüne: iş kuralı, sınır durumu, neden bu yol.
|
|
143
|
-
Kodu tekrar eden yorum yazılmaz (`// toplamı döndür` + `return toplam` gürültüdür).
|
|
144
|
-
- `//` kullanın; `/* */` çok satırlı açıklama için serbest. Gövde kendi satırına sarıldığı için
|
|
145
|
-
son satırdaki `//` kapanış parantezini yutmaz.
|
|
146
|
-
|
|
147
|
-
```js
|
|
148
|
-
// KDV dahil sepet toplamı. satirlar: [{ fiyat, adet }], oran: 0.2 gibi ondalık.
|
|
149
|
-
// Boş sepette 0 döner; tutar kuruş hassasiyetinde yuvarlanır.
|
|
150
|
-
const araToplam = satirlar.reduce((toplam, satir) => toplam + satir.fiyat * satir.adet, 0)
|
|
151
|
-
|
|
152
|
-
// İndirim KDV'den ÖNCE uygulanır (muhasebe kuralı)
|
|
153
|
-
const indirimli = araToplam * (1 - (indirim ?? 0))
|
|
154
|
-
|
|
155
|
-
return Math.round(indirimli * (1 + oran) * 100) / 100
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
5 ya da daha fazla dolu satırlı ve hiç yorumu olmayan gövde **FN-006** uyarısı alır; kayıt yine
|
|
159
|
-
yapılır.
|
|
160
131
|
|
|
161
132
|
Studio kaydı sonrası bağlı sayfaların çalışma paketi `Pages.Updated` ile yeniden kurulur (B-11):
|
|
162
133
|
`/dev` yolu yeni gövdeyi hemen, `/view` yolu önbellek tazelenince gösterir. Workflow kaydı önbellek
|
|
@@ -273,7 +244,7 @@ toplamHesapla(row.fiyat, row.adet) > 1000
|
|
|
273
244
|
serbesttir — sunucuda o ad alanı yok.
|
|
274
245
|
- **Önekli hata:** gövde hatası `Functions.<ad>: <mesaj>` (studio) ya da `<ad>: <mesaj>` (workflow)
|
|
275
246
|
olarak gelir; `Steps.<adım>.error.message` ya da `runtimeErrors`'ta bu öneki ara.
|
|
276
|
-
- **Mobil
|
|
247
|
+
- **Mobil uygulama:** mobil runtime (`@ng-apps/ui-native`) `appFunctions`/`pageFunctions`'ı `Functions`'a geçirir, çağrı web'deki gibi çalışır.
|
|
277
248
|
- **Önbellek:** `/view` yolu eski gövdeyi birkaç saniye gösterebilir; `/dev` yolu anlıktır.
|
|
278
249
|
- **Parametre konumsal:** `parameters` sırasını değiştirmek mevcut çağrıların anlamını değiştirir;
|
|
279
250
|
`function` adımları ada göre eşlendiği için etkilenmez.
|
|
@@ -153,21 +153,6 @@ koda baktığını gizlemek yerine raporlamak.
|
|
|
153
153
|
(GW-005). Bir argüman kabul edildiyse gateway onu okuyor demektir.
|
|
154
154
|
|
|
155
155
|
|
|
156
|
-
## Aynı çağrıyı iki kez yapmak kopya açmaz: `ifExists`
|
|
157
|
-
|
|
158
|
-
Platform aynı adla ikinci kaydı hata vermeden `"<ad> (1)"` olarak açar. `flow_create`,
|
|
159
|
-
`microservice_create`, `workflow_create` ve `page_create` bu yüzden yazmadan önce aynı ad ya da
|
|
160
|
-
slug'ı (harf duyarsız) arar:
|
|
161
|
-
|
|
162
|
-
| `ifExists` | Kayıt zaten varsa |
|
|
163
|
-
|---|---|
|
|
164
|
-
| `error` (varsayılan) | Yazmaz; hata mevcut id'yi ve varsa `(n)` sayaçlı kopyaları söyler |
|
|
165
|
-
| `update` | Mevcut kaydı günceller, yanıtta `outcome: 'updated'`. `page_create`'te yalnız verilen alanlar yazılır, şema korunur. `workflow_create`'te mevcut kaydın `type`'ı farklıysa (middleware ↔ automation) yazmaz — tür değişirdi |
|
|
166
|
-
| `duplicate` | Platform davranışı: ikinci kayıt açılır. Platformun eklediği sayaç (ad `' (1)'`, slug `-1`; akışta ikisi de `' (1)'`) kayıp değildir, yanıtta `renamedByPlatform`'dadır |
|
|
167
|
-
|
|
168
|
-
Betiği yeniden koşturacaksan `ifExists: 'update'` ver; kopyaları elle ayıklayan yardımcı kod
|
|
169
|
-
yazma. Mevcut liste okunamazsa çağrı yazmadan düşer — tekrar dene.
|
|
170
|
-
|
|
171
156
|
## Yazdıktan sonra `silentlyDropped` alanına bak
|
|
172
157
|
|
|
173
158
|
Platformun bir alanı **hatasız yutması** bu depodaki en pahalı hata sınıfı: çağrı 200 döner,
|
|
@@ -184,26 +169,6 @@ Gateway yazma tool'larında gönderdiğin gövdeyi kaydedilenle karşılaştır
|
|
|
184
169
|
]
|
|
185
170
|
```
|
|
186
171
|
|
|
187
|
-
Yazma yanıtında bu liste ve `gatewayNormalized` **kısaltılmış** gelir: aynı yolun düşmeleri tek
|
|
188
|
-
satırda sayıyla toplanır (`selectFields[*].path · kaydedilmedi: 25 öğe — ör. …`). Kayıp sayısı
|
|
189
|
-
`droppedCount`'tadır; sayım 1000 farkta durursa `droppedCountCapped: true` gelir ve sayı "en az"
|
|
190
|
-
demektir. Liste dışı bilgiler (20 satır kesmesi, sıra tabanlı karşılaştırma uyarısı)
|
|
191
|
-
`silentlyDroppedNotes`'tadır ve sayıya girmez. Tam liste gerekiyorsa yazmayı tekrarlama — kaydı `*_get` ile oku,
|
|
192
|
-
sonraki yazmalarda `diagnostics: 'full'` ver. `microservice_*` ve `workflow_*` create/update
|
|
193
|
-
yanıtında `data` yalnız kimlik alanlarını taşır; gövdenin tamamı için `view: 'full'`.
|
|
194
|
-
|
|
195
|
-
**Betikten toplu yazarken yanıtı olduğu gibi basma.** Otuz yazmanın tam yanıtı çıktı sınırını aşar
|
|
196
|
-
ve dosyaya düşer. Her çağrı için tek satır bas; ayrıntıyı yalnız sorunlu çağrıda bas:
|
|
197
|
-
|
|
198
|
-
```js
|
|
199
|
-
const r = JSON.parse(result.content[0].text)
|
|
200
|
-
if (result.isError || r.droppedCount > 0) console.log(JSON.stringify({ slug, error: result.isError ? r : undefined, droppedCount: r.droppedCount, silentlyDropped: r.silentlyDropped }))
|
|
201
|
-
else console.log(JSON.stringify({ slug, id: r.data?.id, outcome: r.outcome }))
|
|
202
|
-
```
|
|
203
|
-
|
|
204
|
-
Yalnız `isError`'a bakma: platform alanı hatasız yutunca çağrı başarılıdır ve kayıp yalnız
|
|
205
|
-
`droppedCount`'ta görünür.
|
|
206
|
-
|
|
207
172
|
Diff dizi öğelerini indeksle değil KİMLİKLE eşler (`stepId`, `elementId`, `name`, `id`), çünkü
|
|
208
173
|
platform diziyi kendi sırasında geri döndürür. Diff üretilemeyen tek durum, yanıtın kayıt değil
|
|
209
174
|
kabul gövdesi olmasıdır; o zaman alan hiç görünmez ve doğrulamayı `*_get` ile kendin yaparsın.
|
|
@@ -4,6 +4,10 @@ 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
|
+
|
|
7
11
|
## Karar kuralları
|
|
8
12
|
|
|
9
13
|
**1. Layout, tek `slot` içeren SIRADAN bir komponent ağacıdır.** Ayrı bir dil yoktur:
|
|
@@ -61,7 +65,7 @@ yapılan eski numaraya artık gerek yok.
|
|
|
61
65
|
NEREDE durduğunu değil, BİÇİMİNİ söyler (dikey kolon / yatay şerit / dolgu yüzeyi). Hem
|
|
62
66
|
runtime hem Studio tuvali bölgeleri 12 kolonluk ızgarayla yerleştirir.
|
|
63
67
|
|
|
64
|
-
**7.
|
|
68
|
+
**7. Dar ekranda flex YIĞILMAZ.** Runtime'ın dar ekran kuralı yalnız ızgara özelliklerini ezer.
|
|
65
69
|
Telefonda alt alta düşmesi gereken satırı `layout:'grid'` ile kur; `layout:'flex'` +
|
|
66
70
|
`direction:'row'` telefonda da yan yana kalır (375px'te ölçüldü: ızgara çocukları 375/375px
|
|
67
71
|
alt alta, flex çocukları 49/310px yan yana). Not: `wrap` varsayılanı artık açık (2026-09-01) —
|
|
@@ -140,8 +144,8 @@ bağlantı nesnesi ya da tam yol).
|
|
|
140
144
|
"direction": { "type": "static", "data": "row" } },
|
|
141
145
|
"blocks": [{ "breakpoint": 1024, "size": { "w": 12, "h": 80 }, "position": { "x": 0, "y": 0 } }] }
|
|
142
146
|
|
|
143
|
-
// KÖTÜ — telefonda 49px'lik yan menü: row flex
|
|
144
|
-
//
|
|
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
|
|
145
149
|
// flex anlamının devreye girmemesi.
|
|
146
150
|
```
|
|
147
151
|
|
|
@@ -179,9 +183,9 @@ bunlardan biri olabilir:
|
|
|
179
183
|
|---|---|
|
|
180
184
|
| ~~`heightType` yalnız `auto` \| `fixed`~~ | **28 Ağustos'ta kapandı:** üçüncü değer `fill` (Kural 5b) |
|
|
181
185
|
| ~~Kök kap viewport'a kilitlenmez~~ | **28 Ağustos'ta kapandı:** `fill` verilmiş kök 100vh (Kural 5b) |
|
|
182
|
-
| Flex
|
|
183
|
-
| Kırılıma duyarlı prop yok | `direction`/`gap` masaüstü ve
|
|
184
|
-
|
|
|
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')`) |
|
|
185
189
|
|
|
186
190
|
---
|
|
187
191
|
|
|
@@ -189,7 +193,7 @@ bunlardan biri olabilir:
|
|
|
189
193
|
(`injectPageSchemaIntoSlots`, `getResolvedLayoutViews`), `apps/studio/src/features/page/api/page.mappers.ts`
|
|
190
194
|
(`mapPageLayoutToPreview`), `packages/ng-apps-ui/src/shared/render/render.functions.ts`
|
|
191
195
|
(`resolveNodeBoxStyle` — slot'un `y / auto` satırı, flex çocuk genişliği),
|
|
192
|
-
`packages/ng-apps-ui/src/shared/render/RenderComponent.svelte` (
|
|
196
|
+
`packages/ng-apps-ui/src/shared/render/RenderComponent.svelte` (dar ekran media kuralı),
|
|
193
197
|
`packages/ng-apps-screen-builder/src/flex-layout.ts` (`getFlexChildStyle` — `widthType`
|
|
194
198
|
fill/fixed/auto dalları, `normalizeCssSize` kabul kuralı; tuval ve runtime aynı fonksiyonu okur),
|
|
195
199
|
`apps/studio/src/features/page/components/appearance/appearance-size.functions.ts` (panelin
|
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
# Mobil uygulama rehberi
|
|
2
|
+
|
|
3
|
+
Mobil uygulama (`application_create` → `type: 'mobile'`) web uygulamasıyla **aynı şemayı**, aynı
|
|
4
|
+
micro-op sözlüğünü ve aynı akış motorunu kullanır; farkı çizerdedir. Sayfalar
|
|
5
|
+
`@ng-apps/ui-native` ile React Native olarak çizilir: Studio'da (kanvas, `/preview`, `/dev|/view`)
|
|
6
|
+
react-native-web üzerinde, cihazda Expo uygulamasında. Gateway uygulamanın tipini kendisi okur
|
|
7
|
+
(platform profili) ve mobilde çizilmeyecek her yazımı `MOB-*` satırıyla söyler — yazım yine
|
|
8
|
+
platforma gider, veri düşürülmez.
|
|
9
|
+
|
|
10
|
+
**Sözlük.** Bu rehberde "mobil" yalnız **mobil uygulama** demektir. Web uygulamasının telefondaki
|
|
11
|
+
dar ekran kırılımı (`hideOn: 'mobile'`, `breakpoint: mobile`) ayrı bir kavramdır ve
|
|
12
|
+
`platform_guide('page')` / `platform_guide('layout')`'ta anlatılır; alan adları değişmedi, yalnız
|
|
13
|
+
anlamları ayrı.
|
|
14
|
+
|
|
15
|
+
## Kurulum sırası
|
|
16
|
+
|
|
17
|
+
1. **Uygulama ve kabuk.** Tek çağrıda: `mobile_app_create` (uygulama + sayfalar + kabuk layout'u +
|
|
18
|
+
sekme ayarı + ana sayfa bağı, `dryRun` ile önce planı görün). Tekil araçlarla aynı sıra:
|
|
19
|
+
`application_create({ type: 'mobile' })` → `page_create` × N → `layout_create` (kabuk) →
|
|
20
|
+
`page_update({ layoutId })` × N → `application_update({ homepageId, properties.mobile.tabs })`.
|
|
21
|
+
Sekme ayarı sayfa **id**'si ister; bu yüzden sayfalardan SONRA yazılır.
|
|
22
|
+
2. **Veri.** Entity, microservice ve workflow web'dekiyle aynıdır (`platform_guide('microservice')`).
|
|
23
|
+
Sayfa akışı `microservice` adımıyla aynı uçları çağırır.
|
|
24
|
+
3. **Ekranlar.** `page_schema_patch` ile bileşen ekle, akış bağla (`flow_create` → `set_event`).
|
|
25
|
+
4. **Doğrulama.** `page_screenshot` (mobilde varsayılan `device: 'phone'`, 390x844 @2) ve
|
|
26
|
+
`page_runtime_get({ resolveStyles: true })` (düğümün React Native stili). Ayrıntı §Doğrulama.
|
|
27
|
+
|
|
28
|
+
`page_create` mobil uygulamada kökü kendisi kurar: `page_container`, `layout` prop'u YOK,
|
|
29
|
+
`direction: 'column'`, `blocks: []`, `appearance.heightType: 'fill'` — kök telefon ekranını doldurur.
|
|
30
|
+
|
|
31
|
+
## Bileşenler
|
|
32
|
+
|
|
33
|
+
Mobil uygulamanın bileşen kataloğu ayrıdır (backend satırları `(slug, type: 'mobile')`).
|
|
34
|
+
`component_list` ve `component_get` mobil uygulamada **kendiliğinden** mobil kataloğu okur.
|
|
35
|
+
`component_get` yanıtı `platform: 'mobile'` ile üç katman taşır: `knowledge` (web kaydı — mobil
|
|
36
|
+
şema web sınıfını genişlettiği için prop'ların anlamı oradadır), `mobileKnowledge` (bu bileşenin
|
|
37
|
+
mobil farkları: düşen prop, değişen etkileşim, mobile özgü prop notları) ve `mobileNotes` (bütün
|
|
38
|
+
mobil bileşenlere geçen notlar). Web'de karşılığı olmayan bileşende (`app-bar`, `safe-area`,
|
|
39
|
+
`scroll-view`, `choice-chips`, `tooltip`) bilgi yalnız `mobileKnowledge`'tadır. Olay yükleri
|
|
40
|
+
(`events[].payload`) önce mobile özgü sözleşmeden okunur (`app-bar.clickAction`, `repeater.swipe`,
|
|
41
|
+
`choice-chips.change`…), yoksa web'inkinden.
|
|
42
|
+
|
|
43
|
+
- Katalogda olmayan tip `MOB-003` alır ve backend `unknown-type` (422) ile reddeder. Mobil pakette
|
|
44
|
+
olan ama bu uygulamanın kataloğuna yazılmamış tip için gateway katalog senkronunu gösterir; web'de
|
|
45
|
+
olup mobilde henüz olmayan için ne zaman geleceğini söyler (Dalga 2, Faz 3).
|
|
46
|
+
- **Katalog A** (FlutterFlow paritesi, 2026-09-24) on bileşen ekledi: `badge`, `avatar`, `progress`,
|
|
47
|
+
`radio`, `checkboxgroup`, `choice-chips`, `collapsible-container`, `slider`, `tabs`, `tooltip`;
|
|
48
|
+
`button` mobilde `secondary`/`ghost`/`link` varyantlarını ve `icon` boyunu alır. Tam liste
|
|
49
|
+
`component_list`'tir.
|
|
50
|
+
- **Katalog B** (FlutterFlow paritesi) önce dört prop'la başladı; hepsi YALNIZ mobil şemadadır:
|
|
51
|
+
`scroll-view.stickyHeader` (ilk çocuk dikey kaydırmada üstte kalır), `numberinput.variant: stepper`
|
|
52
|
+
(± düğmeleri, iç roller `__decrement`/`__increment`), `modal.presentation: center | sheet | fullscreen`
|
|
53
|
+
(alt sayfa şeritten aşağı sürükleyince `change { isOpen: false }` ile kapanır; en çok ekranın %90'ı,
|
|
54
|
+
uzun içerik için içine `scroll-view`). En-boy oranı yeni
|
|
55
|
+
prop DEĞİLDİR: boyut panelinin `appearance.aspectRatio`'su mobilde kaplara da uygulanır
|
|
56
|
+
(§Yerleşim).
|
|
57
|
+
- Web'e özgü bileşenlerin mobil karşılığı:
|
|
58
|
+
|
|
59
|
+
| Web | Mobilde |
|
|
60
|
+
|---|---|
|
|
61
|
+
| `navigations`, `sidebar`, `header`, `layout-shell` | `app-bar` + Ayarlar › Sekmeler + `drawer` widget'ı (`MOB-004`) |
|
|
62
|
+
| `popover` | `modal` widget'ı |
|
|
63
|
+
| `pagination` | `repeater` + "daha fazla yükle" düğmesi |
|
|
64
|
+
| `breadcrumb` | yığın gezinmesi (app-bar geri düğmesi) |
|
|
65
|
+
| `iframe` | `button` + `redirect` (`targetBlank`) ile tarayıcıda aç |
|
|
66
|
+
| `theme-toggle` | cihaz teması |
|
|
67
|
+
|
|
68
|
+
**Harici bileşen mobilde yoktur** (`MOB-006`): protokol v1 tarayıcı `.mjs` paketidir;
|
|
69
|
+
`external_component_*` araçları mobil uygulamada platforma gitmez.
|
|
70
|
+
|
|
71
|
+
## Yerleşim — yalnız flex
|
|
72
|
+
|
|
73
|
+
Mobil çizer 12 sütunlu ızgarayı **okumaz**: sıra dizi indeksidir, yerleşim flex'tir.
|
|
74
|
+
|
|
75
|
+
- `blocks[]`, `set_block`, `layout: 'grid' | 'cssgrid'` yazılır ama çizilmez (`MOB-001`).
|
|
76
|
+
`add_component` / `move_component`'ın `index`'i dizideki sıradır; gateway konum çevirisi yapmaz.
|
|
77
|
+
- Kaplar flex kabıdır: `direction`, `gap`, `horizontalAlign`, `verticalAlign`, `wrap`, `size`.
|
|
78
|
+
Mobil `container` şemasında `layout` prop'u yoktur.
|
|
79
|
+
- Ölçü `appearance` ile: `widthType: 'fill' | 'auto' | 'fixed'` (+ `widthString`),
|
|
80
|
+
`heightType: 'fill' | 'auto' | 'fixed'` (+ `heightString`). `fill` kalan alanı alır.
|
|
81
|
+
- En-boy oranı `appearance.aspectRatio` (sayı; 16:9 için `1.78`): boy genişlikten türer. Koşullar:
|
|
82
|
+
`heightType: 'auto'` ve genişlik belli — `widthType: 'fill'` ya da `'fixed'` (içerik genişliğinde
|
|
83
|
+
web ile cihaz oranı ters yönden çözer, uygulanmaz). Web'den farkı: mobilde **akış kapları** da oran
|
|
84
|
+
alır (`container`, `form`, `safe-area`, `scroll-view`) ve akışları oranlı boyu doldurur; öteki
|
|
85
|
+
bırakılabilir tipler, widget örneği, sayfa kökü ve `modal`/`drawer` almaz; `image` oranı kendi
|
|
86
|
+
çizimine yazar.
|
|
87
|
+
- Hiza (`verticalAlign` `top | middle | bottom`, `horizontalAlign` `left | center | right`) web ile
|
|
88
|
+
aynıdır. Dikey hizanın boşluğu kabın boyundan gelir: `heightType` `fill`, `fixed` ya da oranlı kapta
|
|
89
|
+
akış kabın boyunu doldurur; boyu içerikten gelen sütun kapta dikey hiza etkisizdir (satır kapta farklı
|
|
90
|
+
boydaki kardeşleri yine hizalar). `stretch` de web gibi: ana eksende çocukları yayar, çapraz eksende gerer.
|
|
91
|
+
- Birim: `px` ve `%`. `em`/`rem` tema puntosuyla çarpılır; `calc()` ve `vw/vh` React Native'de yoktur
|
|
92
|
+
(`MOB-002`).
|
|
93
|
+
|
|
94
|
+
## Görünüm — tipli gruplar
|
|
95
|
+
|
|
96
|
+
React Native'de CSS yoktur; tipli stil grupları **derlenir** (web'in `composeTypedStyle` ikizi,
|
|
97
|
+
aynı katman sırası: tema taban → gruplar → serbest `style`).
|
|
98
|
+
|
|
99
|
+
- `surfaceStyle` → zemin, köşe, kenarlık, gölge (tek katman), opaklık, taşma.
|
|
100
|
+
- `typographyStyle` → renk, aile (tek ad), punto, kalınlık, hizalama, satır yüksekliği.
|
|
101
|
+
- Tema token'ları (`var(--ng-*)`) sayılara çözülür; proje teması değişince mobil de değişir.
|
|
102
|
+
|
|
103
|
+
Çizilmeyen alanlar (`MOB-002`) ve yerine ne:
|
|
104
|
+
|
|
105
|
+
| Alan | Yerine |
|
|
106
|
+
|---|---|
|
|
107
|
+
| `className` | `surfaceStyle` / `typographyStyle` |
|
|
108
|
+
| serbest `style` nesnesi (alt seçici `&:hover`, `&__body`) | tipli gruplar; düz anahtarlar (ör. `padding`) çevrilir, alt seçici düşer |
|
|
109
|
+
| `hoverStyle` | yok — dokunmatikte üzerine gelme durumu yoktur |
|
|
110
|
+
| `tooltip`, `tooltipPosition` | düğümü `tooltip` bileşenine sarın (dokunuşla açılır, yanı `side`) ya da açıklamayı metin olarak koyun |
|
|
111
|
+
| `zIndex` | katman için `modal` ya da `drawer` widget'ı |
|
|
112
|
+
|
|
113
|
+
Düğümün gerçek stilini görmek: `page_runtime_get({ applicationSlug, pageSlug, resolveStyles: true })`
|
|
114
|
+
→ her düğümde `nativeStyle: { shell, text, warnings }` (`shell` kutunun, `text` içine akan metnin
|
|
115
|
+
stili; RN'de tipografi miras alınmaz). Yanıtta `styleResolver: 'native'`. Temanın
|
|
116
|
+
`componentStyles`/preset katmanı mobil çizerde henüz uygulanmıyor ve rapora da girmez.
|
|
117
|
+
|
|
118
|
+
## Görünüm — shadcn/ui
|
|
119
|
+
|
|
120
|
+
Bileşenler shadcn/ui görünümünde çizilir (react-native-reusables ilkelleri, NativeWind). Renk ve
|
|
121
|
+
köşe yine **proje temasından** gelir: `--ng-*` değişkenleri shadcn token'larına köprüyle çevrilir
|
|
122
|
+
(`--primary` ← `accent.primary`, `--destructive` ← hata rengi, `--border`, `--input`, `--ring`…).
|
|
123
|
+
`theme_update` web'i ve mobili birlikte değiştirir; koyu kip aynı köprünün ikinci çözümüdür. Ölçü
|
|
124
|
+
(alan yüksekliği, punto, iç boşluk) temanın `--ng-form-*` değişkenlerinden gelir. Yazı **ailesi**
|
|
125
|
+
köprüde yoktur: temanın ailesi alanlarda, başlıklarda ve sekme çubuğunda uygulanır; `text` ve düğme
|
|
126
|
+
etiketi ailesini `typographyStyle`'dan alır, alan etiketleri platform yazı tipiyle çizilir.
|
|
127
|
+
|
|
128
|
+
- `button`: `kind` rengi, `variant` kullanımını seçer — `solid` dolu (`kind: error` → shadcn
|
|
129
|
+
`destructive`), `outline` çerçeveli, `text`/`ghost` zeminsiz; mobilde ayrıca `secondary` (nötr
|
|
130
|
+
dolgu) ve `link`. `info`/`success`/`warning` → temanın `--status-*` renkleri. Eşlemenin tamamı ve
|
|
131
|
+
bilinen sınırlar: `component_get('button')` → `mobileKnowledge.propNotes`.
|
|
132
|
+
- `switch` platformun kendi anahtarı DEĞİLDİR: üç barındırıcıda (kanvas, önizleme, cihaz) aynı
|
|
133
|
+
shadcn anahtarı çizilir; kanvasta basılamadığı için soluk görünür.
|
|
134
|
+
- Web sayfası kendi bileşen ailesiyle çizilir; iki platformun görünüm farkı bilinçlidir, ortak olan
|
|
135
|
+
temadır. Yakalama seçicileri (`role="button"`, `__tabs__item-<slug>`, `submit` köprüsü) görünümden
|
|
136
|
+
bağımsızdır (§Doğrulama).
|
|
137
|
+
|
|
138
|
+
## Gezinme
|
|
139
|
+
|
|
140
|
+
- **Yığın varsayılandır; ayar yoktur.** `redirect` adımı hedef sayfayı yığına iter, geri hareketi
|
|
141
|
+
(cihaz geri tuşu, app-bar geri düğmesi, tarayıcı geri) önceki ekrana döner. Göreli yol uygulama
|
|
142
|
+
köküne eklenir; tam adres (`https://…`) dışarıda açılır.
|
|
143
|
+
- **Sekmeler uygulama ayarıdır, layout'ta değil.** `application_update({ properties: { mobile: { tabs } } })`:
|
|
144
|
+
|
|
145
|
+
```json
|
|
146
|
+
{
|
|
147
|
+
"mobile": {
|
|
148
|
+
"tabs": {
|
|
149
|
+
"enabled": true,
|
|
150
|
+
"style": "default",
|
|
151
|
+
"items": [
|
|
152
|
+
{ "page": "<page_list id>", "label": "Görevler", "icon": "list" },
|
|
153
|
+
{ "page": "<page_list id>", "label": "Profil", "icon": "user" }
|
|
154
|
+
],
|
|
155
|
+
"showLabels": true
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
`items` 1–5 sayfa **id**'si (slug değil), tekrar yok; `style: 'floating'` köşe `pill` + gölge `md`
|
|
162
|
+
çizer. Çubuğun rengi ayarda YOKTUR: zemin `surface`, seçili `accent-primary`, seçilmemiş
|
|
163
|
+
`text-secondary` — değiştirmek için `theme_update`; eski `appearance` alanı okunmaz; `style: 'custom'` + `customWidgetId` çubuğu kendi widget'ınla çizer. Tutarsız ayar ve
|
|
164
|
+
layout/sayfada eski `tab-bar` / `drawer-menu` düğümü `MOB-007` alır. Sekme dışı sayfalar yığına açılır.
|
|
165
|
+
- **Çekmece bir bileşendir.** `drawer` widget'ı + `app-bar`'ın `menuTarget` prop'u çekmeceyi açar.
|
|
166
|
+
- Kabuk örnekleri: `ngapps://examples/mobile-app-shell-stack` (yığın), `ngapps://examples/mobile-app-shell-tab`
|
|
167
|
+
(sekmeler), `ngapps://examples/mobile-app-shell-drawer` (çekmece); üç sayfalık liste → detay → form akışı:
|
|
168
|
+
`ngapps://examples/mobile-list-detail-form`.
|
|
169
|
+
|
|
170
|
+
## Akış adımları
|
|
171
|
+
|
|
172
|
+
Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `function`, `flow-trigger`,
|
|
173
|
+
`validation`) iki platformda aynıdır. Barındırıcıya dokunan adımlar:
|
|
174
|
+
|
|
175
|
+
| Adım | Mobilde |
|
|
176
|
+
|---|---|
|
|
177
|
+
| `redirect` | yığına iter (göreli yol) ya da dışarıda açar (tam adres) |
|
|
178
|
+
| `navigate` | eski mobil şemaların adı — `redirect`'in takma adıdır; gateway `redirect`'e çevirir |
|
|
179
|
+
| `alert` | tipli uyarı (`success`/`error`/`info`/`warning`) toast'tur ve beklemez; düz uyarı onay bekler |
|
|
180
|
+
| `confirm` | `yes` / `no` dalları |
|
|
181
|
+
| `download` | adres cihazın açma sayfasında açılır, gövde paylaşım sayfasına gider (`MOB-005`, bilgi) |
|
|
182
|
+
| `storage` | cihaz deposu |
|
|
183
|
+
| `setcookie` | cihaz deposuna yazar (`MOB-005`, bilgi); paletten yalnız web'de sunulur |
|
|
184
|
+
|
|
185
|
+
Sayfa ve layout `mount` akışları ilk çizimden sonra, `destroy` akışları sayfa kalkarken koşar.
|
|
186
|
+
`Functions.<ad>()` uygulama ve sayfa fonksiyonlarını görür (`platform_guide('functions')`).
|
|
187
|
+
|
|
188
|
+
## Doğrulama
|
|
189
|
+
|
|
190
|
+
- `page_screenshot({ applicationSlug, pageSlug })` mobil uygulamada `device: 'phone'` (390x844, kare
|
|
191
|
+
780x1688 px) çeker; `'tablet'` 820x1180 @2 ya da `{ width, height, scale? }`. `viewport` verilirse
|
|
192
|
+
cihaz yok sayılır (`deviceNote`). Yanıt `applicationType: 'mobile'` ve `platformNote` taşır: kare
|
|
193
|
+
react-native-web çizimidir, cihazdakiyle yapısal olarak (düğüm, sıra, ölçü, renk) aynıdır.
|
|
194
|
+
- Eylemler aynı sözlük: `click` basılabilir öğeyi (`role="button"`) bulur; `submit` runtime
|
|
195
|
+
köprüsüyle gider (`submitVia: 'bridge'`); sekme öğesi `__tabs__item-<sayfa slug'ı>`, çubuk `__tabs`
|
|
196
|
+
özet satırıdır. `select` açılır listeyi açar ve seçeneği değerle ya da görünen metinle seçer
|
|
197
|
+
(liste katmanda açılır, `optionsSeen` kaç seçenek görüldüğünü söyler); `tab` bir `tabs`
|
|
198
|
+
bileşeninin sekmesini anahtarıyla (`<elementId>__tab-<anahtar>`) bulur.
|
|
199
|
+
- `flowRuns: 0` + `requests: 0` bir tıklamada akışın koşmadığını söyler: olay bağını
|
|
200
|
+
`page_runtime_get`, akışı `flow_get` ile doğrulayın.
|
|
201
|
+
- Kuru doğrulama: `page_schema_validate` mobil kataloğa karşı doğrular (`MOB-003`).
|
|
202
|
+
|
|
203
|
+
## Cihazda önizleme
|
|
204
|
+
|
|
205
|
+
Expo uygulaması (`apps/mobile-runtime`) aynı sayfayı native çizer. Derin bağlantı
|
|
206
|
+
`zeyrek://open/{proje}/{uygulama}/{sayfa}?env=<ortam>` **token taşımaz**: cihazdaki uygulama zaten giriş
|
|
207
|
+
yapmış olmalıdır. Canlı önizleme sayfa şeması değişikliğini (`/hubs/page-schema`) dinler; yazdığın
|
|
208
|
+
yama cihazda yenilenir.
|
|
209
|
+
|
|
210
|
+
## Bilinen farklar
|
|
211
|
+
|
|
212
|
+
- Piksel paritesi yoktur: yazı tipi ölçüsü, gölge ve güvenli alan cihaza göre değişir. Parite yapısaldır.
|
|
213
|
+
- Bileşen kataloğu dalga dalga gelir; `component_list` ne döndürüyorsa odur.
|
|
214
|
+
- Temanın bileşen stilleri (`componentStyles`, preset'ler) mobil çizerde henüz uygulanmıyor.
|
|
215
|
+
- Dar ekran kırılımı (`hideOn: 'mobile'`) mobil uygulamada anlamsızdır: ekran zaten tek boydur.
|
|
@@ -4,6 +4,10 @@ Studio'nun tuval tarafı. Buradaki kurallar controller + komut kodundan doğrula
|
|
|
4
4
|
(`zeyrek-mcp/docs/13-faz2-envanter.md` §4); veri/mantık tarafı için
|
|
5
5
|
`platform_guide('entity')`, `('microservice')`, `('workflow')`.
|
|
6
6
|
|
|
7
|
+
> **Mobil uygulamada** (`type: 'mobile'`) şema ve micro-op'lar aynıdır ama yerleşim yalnız flex'tir
|
|
8
|
+
> (blocks çizilmez), görünüm tipli gruplarla yazılır ve `page_create` kökü flex sütun kurar —
|
|
9
|
+
> `platform_guide('mobile')`. Bu rehberdeki "dar ekran" notları WEB uygulamasının telefon kırılımıdır.
|
|
10
|
+
|
|
7
11
|
## Kuruluş sırası
|
|
8
12
|
|
|
9
13
|
```
|
|
@@ -93,9 +97,8 @@ mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`
|
|
|
93
97
|
komponentin iç kimliğidir (aşağıda Kural 2, `FLOW-018`).
|
|
94
98
|
|
|
95
99
|
- **`blocks[].size`'ı komponentin `component_get`'teki `minSize`..`maxSize` aralığında tut.** Dikkat:
|
|
96
|
-
katalog varsayılanı aşabiliyor (`
|
|
97
|
-
|
|
98
|
-
12'ye açarak çıktı) — varsayılanı körü körüne kopyalama. Sınır grid kanvasının kuralıdır; API 2026-09-15'ten beri reddetmez, ama aşan
|
|
100
|
+
katalog varsayılanı aşabiliyor (`page-header` default `h:8`, `maxSize` `h:4`) — varsayılanı körü
|
|
101
|
+
körüne kopyalama. Sınır grid kanvasının kuralıdır; API 2026-09-15'ten beri reddetmez, ama aşan
|
|
99
102
|
blok kanvasta boyutlandırılamaz (aşağıda Kural 7 "Boyut tuzağı").
|
|
100
103
|
- **Kurulmuş bir düğümün boyutunu `resize_component` micro-op'u değiştirir.**
|
|
101
104
|
`{ op: 'resize_component', target: '<elementId>', size: { w, h } }` ızgara boyutunu,
|
|
@@ -160,32 +163,19 @@ Sayfa açılışında veri çekmek için `mount` kullanılır ama tek seçenek o
|
|
|
160
163
|
|
|
161
164
|
Yani "satırı seçince detay getir" (`select`), "kolondan süzünce sunucudan yeniden çek"
|
|
162
165
|
(`filter`), "sayfa değişince yeni sayfayı çek" (`pagination`), "satıra çift tıklayınca formu aç"
|
|
163
|
-
(`doubleClick`) akışları da aynı `set_event` mekanizmasıyla kurulur. Buna karşılık `
|
|
164
|
-
yalnız `mount` yayar (bilinçli — Kural 1e)
|
|
165
|
-
tıklamasını `clickItem` olarak yayar (`component_get` yükü verir).
|
|
166
|
+
(`doubleClick`) akışları da aynı `set_event` mekanizmasıyla kurulur. Buna karşılık `page-header`
|
|
167
|
+
ve `datatable` yalnız `mount` yayar (`datatable`'ınki bilinçli — Kural 1e).
|
|
166
168
|
|
|
167
169
|
**Olay adları `on` ÖNEKİ ALMAZ** (`button` → `click`, `form` → `submit`), tek istisna katalogda
|
|
168
170
|
`texteditor`'dur (`onMount`/`onChange`). **Komponentin desteklemediği bir olay adı verirsen bağ
|
|
169
171
|
sessizce ölü kalır** — önce `component_get`. Gateway `set_event`'i katalogla karşılaştırır ve
|
|
170
172
|
uymayan adı **PAGE-008** ile istek gitmeden reddeder.
|
|
171
173
|
|
|
172
|
-
**Bir olaya birden fazla akış bağlanabilir — ikinciyi `add_event` ile ekle.** `set_event` olayın
|
|
173
|
-
BÜTÜN bağlarını tek akışa indirir: başlık alanının `change` olayına makale önerisi bağlıyken akıllı
|
|
174
|
-
öneriyi `set_event` ile bağlamak makale önerisini devre dışı bırakır. Gateway bunu **PAGE-034** ile
|
|
175
|
-
istek gitmeden reddeder. Doğru op `{ "op": "add_event", "target": "<elementId>", "event": "change",
|
|
176
|
-
"eventValue": "<ikinci flow id>" }`'dir. Olay tetiklenince bağlı akışların hepsi **paralel ve
|
|
177
|
-
birbirinden bağımsız** koşar: biri hata verirse diğeri etkilenmez, **sıra garantisi yoktur**. Biri
|
|
178
|
-
diğerinin sonucunu bekliyorsa ya da ikisi aynı değişkene/prop'a yazıyorsa ayrı bağ değil,
|
|
179
|
-
`flow-trigger` adımıyla zincir kur (Kural 1c). Mevcut bağı bilerek değiştirmek için `set_event`
|
|
180
|
-
op'una `replaceBoundFlows: true` ekle. **Mobil runtime yalnız ilk akışı koşar** — mobil
|
|
181
|
-
uygulamada olay başına tek akış bağla.
|
|
182
|
-
|
|
183
174
|
**Olay KALDIRMAK için `remove_event` kullan.** Platformun `set_event` micro-op'u olay silemez:
|
|
184
175
|
`eventValue: null` verildiğinde kayıt `{ name: 'click' }` olarak (değersiz) kalır, diziden
|
|
185
176
|
çıkmaz — şemada ölü bağ artığı bırakır. `{ "op": "remove_event", "target": "<elementId>",
|
|
186
177
|
"event": "click" }` platformun op'udur: olayı diziden çıkarır (yanıtta `removedEvents`); olmayan
|
|
187
|
-
bir olayı kaldırmaya çalışmak `missing-event` ile 422 döner.
|
|
188
|
-
kaldırılacak akışı `eventValue` ile ver; vermezsen `ambiguous-event` ile 422 döner. Sayfa düzeyi olaylar için
|
|
178
|
+
bir olayı kaldırmaya çalışmak `missing-event` ile 422 döner. Sayfa düzeyi olaylar için
|
|
189
179
|
`target: "page"`. Referanssız kalan akış silineceği için `allowFlowDeletion` kuralı (G-21) bu op'ta
|
|
190
180
|
da geçerlidir.
|
|
191
181
|
|
|
@@ -199,14 +189,12 @@ olaylarında **boştur** (ölçüm 2026-08-25, kaynak okuması: `flow-machine.ts
|
|
|
199
189
|
Pratik kural: **`payload` anahtarları aynı zamanda prop adlarıdır; akışta `self.<anahtar>` ile
|
|
200
190
|
oku** (ya da `value { type:'property', ref:{ source:'component', element, property } }` ile).
|
|
201
191
|
`event.data` yalnız `params` ile gelen olaylarda dolar — `html` komponentinin `fireEvent`
|
|
202
|
-
aksiyonları (`platform_guide('html')`) ve
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
döndürür; hata yok, sayfalama yok. (Bağımsız `pagination` komponenti bu tuzağa girmez, yükünü
|
|
209
|
-
`params` ile de gönderir.)
|
|
192
|
+
aksiyonları (`platform_guide('html')`) ve **2026-08-27 kuşağı komponentler** (`eventcalendar` ·
|
|
193
|
+
`importwizard` · `kanban` · `signature` · `stepper`): bu kuşak `params`'ı da gönderir, yani
|
|
194
|
+
yükleri `event.data.<anahtar>` ile okunur; `kanban` ve `eventcalendar` yükü `self`'e HİÇ
|
|
195
|
+
yazmaz (`component_get` çıktısındaki sözleşme notları ayrımı söyler). Sessiz hata örneği:
|
|
196
|
+
sayfalama akışını `event.data.limit`'e bağlarsan sorgu `LIMIT null OFFSET null` ile koşar ve
|
|
197
|
+
**tüm satırları** döndürür; hata yok, sayfalama yok.
|
|
210
198
|
|
|
211
199
|
| Komponent · olay | Yük (aynı zamanda prop adları) | Akışta nereden okunur |
|
|
212
200
|
|---|---|---|
|
|
@@ -216,18 +204,16 @@ döndürür; hata yok, sayfalama yok. (Bağımsız `pagination` komponenti bu tu
|
|
|
216
204
|
| `table.select` · `doubleClick` | — | `self.selectedRow` |
|
|
217
205
|
| `table.selectionChange` | — | `self.selectedRows` |
|
|
218
206
|
| `datatable.mount` | — | `self.filters` · `self.sortField` · `self.sortType` · `self.offset` |
|
|
219
|
-
| `pagination.change` | `{ offset, limit }` | `self.offset` · `self.limit`
|
|
207
|
+
| `pagination.change` | `{ offset, limit }` | `self.offset` · `self.limit` |
|
|
220
208
|
| `textinput/textarea/password.change` | `{ value }` | `self.value` |
|
|
221
209
|
| `dropdown.change` · `multi-select.change` | `{ value }` | `self.value` |
|
|
222
210
|
| `dropdown.search` · `multi-select.search` | `{ searchText }` | `self.searchText` |
|
|
223
|
-
| `tabs.tab` | `{ selected }` | `self.selected`
|
|
211
|
+
| `tabs.tab` | `{ selected }` | `self.selected` |
|
|
224
212
|
| `chart.dataPointClick` | `{ name, seriesName, value, dataIndex, row }` | `self.row` (kaynak satırın tamamı) |
|
|
225
|
-
| `repeater.change`
|
|
213
|
+
| `repeater.change` | `{ selectedIndex }` | `item` / `Row` satır bağlamı |
|
|
226
214
|
| `html` aksiyonu (`fireEvent`) | ikinci argüman | **`event.data`** |
|
|
227
215
|
| `kanban.cardMove` | `{ id, row, from, to }` | **`event.data`** (self'e yazılmaz) |
|
|
228
|
-
| `kanban.cardAdd` · `kanban.cardRemove` | `{ column }` · `{ id, row, column }` | **`event.data`** (self'e yazılmaz; kart eklenmez/gizlenmez, akış yazıp `rows`'u tazeler) |
|
|
229
216
|
| `eventcalendar.eventMove` | `{ id, row, start, end, previousStart, previousEnd }` | **`event.data`** (self'e yazılmaz) |
|
|
230
|
-
| `eventcalendar.monthChange` · `eventcalendar.viewChange` · `eventcalendar.eventCreate` | `{ month, year, view, start, end }` · `{ view, start, end }` · `{ start, end, allDay }` | **`event.data`** (self'e yazılmaz; veri sorgusunu kesişimle bağla: başlangıç < `end`+1 gün ve bitiş >= `start`) |
|
|
231
217
|
| `importwizard.complete` | `{ rows, errors, fileName, total }` | `self.rows`… ya da `event.data` |
|
|
232
218
|
| `stepper.stepChange` | `{ currentStep, previous }` | `self.currentStep` ya da `event.data` |
|
|
233
219
|
| `signature.change` | `{ value }` | `self.value` ya da `event.data.value` |
|
|
@@ -386,11 +372,8 @@ göstermek error flow'un işidir.
|
|
|
386
372
|
> `errorTasks.some(t => t.type !== 'start')` arar. Start'ın ardına en az bir adım bağla —
|
|
387
373
|
> gateway `FLOW-021` ile uyarır.
|
|
388
374
|
>
|
|
389
|
-
> **
|
|
390
|
-
> `
|
|
391
|
-
> `hasErrorFlow` her zaman false: hata yolu hiç koşmaz ve akış yukarıdaki 2. yoldan —
|
|
392
|
-
> `always` + hata gövdeli storage — devam eder. Mobil sayfada hata yolunu `condition
|
|
393
|
-
> Steps.<adımAdı>.error` ile kur.
|
|
375
|
+
> **Mobil uygulama:** mobil runtime (`@ng-apps/ui-native` `NativeRuntime`) `errorSteps`'i web gibi
|
|
376
|
+
> `errorTasks`'a eşler — hata yolu iki platformda aynı koşar.
|
|
394
377
|
|
|
395
378
|
> **Hata metni ÜÇ ayrı yerde durur ve ikisi kullanıcıya gösterilecek metin DEĞİLDİR.**
|
|
396
379
|
> `onError` hata akışını koşturmadan önce `machine.setStorage('error', errorInfo)` yapar
|
|
@@ -520,14 +503,14 @@ değer tipleri: `static · page · property · storage · variable · code · it
|
|
|
520
503
|
> tip register eder, gerisini uygulama ekler. Bir sayfa TEK bir uygulamaya aittir
|
|
521
504
|
> (`Page.ApplicationId`) ve uygulamanın tipi `web` ya da `mobile`'dır (`ApplicationType.cs`), yani
|
|
522
505
|
> sayfanın barındırıcısı bellidir — matris "hangi tip sende çalışır"ı söyler, iki barındırıcıda
|
|
523
|
-
> birden koşmayı değil (web `Runtime.svelte`, mobil `
|
|
506
|
+
> birden koşmayı değil (web `Runtime.svelte`, mobil uygulama `@ng-apps/ui-native` `NativeRuntime`):
|
|
524
507
|
>
|
|
525
|
-
> | Adım tipi | Web | Mobil | Nerede register ediliyor |
|
|
508
|
+
> | Adım tipi | Web | Mobil uygulama | Nerede register ediliyor |
|
|
526
509
|
> |---|---|---|---|
|
|
527
|
-
> | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` · `function` | ✅ | ✅ | `flow-engine.ts` — motorun kendisi
|
|
528
|
-
> | `alert` · `redirect` · `setcookie` · `storage` | ✅ | ✅ |
|
|
529
|
-
> | `confirm` · `download` | ✅ |
|
|
530
|
-
> | `navigate` | ❌ | ✅
|
|
510
|
+
> | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` · `function` | ✅ | ✅ | `flow-engine.ts` — motorun kendisi |
|
|
511
|
+
> | `alert` · `redirect` · `setcookie` · `storage` | ✅ | ✅ | barındırıcı; mobilde `setcookie` cihaz deposuna yazar (`MOB-005`) |
|
|
512
|
+
> | `confirm` · `download` | ✅ | ✅ | `Runtime.svelte` · `runtime-tasks.ts` (`download` mobilde açma/paylaşım — `MOB-005`) |
|
|
513
|
+
> | `navigate` | ❌ | ✅ (`redirect` takma adı) | web'deki karşılığı `redirect`; gateway `redirect`'e çevirir |
|
|
531
514
|
> | `end` · `query` | ❌ | ❌ | hiçbir yerde — üstelik `query` backend sözlüğünde de yok (`StepType.cs` onu saymaz), yalnız frontend enum'unda duruyor |
|
|
532
515
|
>
|
|
533
516
|
> **Register edilmemiş bir tipe gelen akış SESSİZCE durur.** `flow-engine.ts` `process()`
|
|
@@ -861,7 +844,7 @@ kullanır: `page.mappers.ts` `mapPageLayoutToPreview` — layout varsa çizilen
|
|
|
861
844
|
> `add_component` ile yeniden kurmaktır (sonrasında Kural 2'deki flow yeniden kaydetme adımı
|
|
862
845
|
> ZORUNLU olur).
|
|
863
846
|
|
|
864
|
-
|
|
847
|
+
Dar ekran notu: <768px'te ızgara tek kolona düşer (`RenderComponent` media query'si) — y sırası
|
|
865
848
|
dikey sıraya dönüşür, x/w yok sayılır. Yerleşimi masaüstü (breakpoint 1024) bloğuyla kur.
|
|
866
849
|
|
|
867
850
|
## Kural 1f-2 — Kapsayıcı düzeni: `flex` (varsayılan) ↔ `grid`
|
|
@@ -950,10 +933,10 @@ Beş şeyi bilmeden flex kurma:
|
|
|
950
933
|
4. **`layout: 'grid'` iken diğer altı prop ÖLÜDÜR.** Katalogda tanımlı oldukları için
|
|
951
934
|
doğrulama duvarı susar, renderer da okumaz: ızgara kapsayıcıya `direction: 'column'` yazmak
|
|
952
935
|
sessizce hiçbir şey yapmaz. Gateway bunu **PAGE-015 (uyarı)** ile söyler.
|
|
953
|
-
5. **Flex düzeni kırılım BİLMEZ.** `direction`/`gap`/hizalama masaüstü ve
|
|
954
|
-
sıra ve span'lar Desktop (1024) bloğundandır — Studio,
|
|
936
|
+
5. **Flex düzeni kırılım BİLMEZ.** `direction`/`gap`/hizalama masaüstü ve dar ekranda AYNIDIR;
|
|
937
|
+
sıra ve span'lar Desktop (1024) bloğundandır — Studio, dar ekran kırılımı düzenlenirken flex
|
|
955
938
|
bölgeyi salt-okunur kilitler. Kırılım bilen yalnız `blocks[]` ve `appearance.hideOn`'dur;
|
|
956
|
-
|
|
939
|
+
dar ekranda farklı davranış gereken satır için `layout: 'grid'` kullan (Kural 1f dar ekran notu).
|
|
957
940
|
|
|
958
941
|
```jsonc
|
|
959
942
|
// Ortalanmış giriş kartı — style ile CSS hack'i YOK, kabın kendi düzeni
|
|
@@ -1097,6 +1080,45 @@ kendisi nesneye çevirir; Studio tablosunda `[object Object]` görünmesi normal
|
|
|
1097
1080
|
(`platform_guide('entity')` → "TEXT kolonunda JSON"). Ekranın görsel tarafı için **Kural 1h**:
|
|
1098
1081
|
tema `--ng-*` değişkenleriyle tek yerden çevrilir, `html` kaçış kapısına gerek kalmaz.
|
|
1099
1082
|
|
|
1083
|
+
## Kural 1g-2 — Mobil davranış: dört ayar, dört ayrı sahip
|
|
1084
|
+
|
|
1085
|
+
Mobil listelerin davranışı TEK bileşende toplanmaz. Hangi ayarın kimde olduğunu bilmeden yazılan
|
|
1086
|
+
şema sessizce çalışmaz — prop var olmayan bileşene yazılır ve `page_schema_patch` onu düşürmez,
|
|
1087
|
+
çizer yok sayar.
|
|
1088
|
+
|
|
1089
|
+
| Davranış | Sahip bileşen | Prop / olay |
|
|
1090
|
+
|---|---|---|
|
|
1091
|
+
| Çekerek yenile | `scroll-view` (listeyi SARAN kap) | `refreshable: true` + `refresh` olayı |
|
|
1092
|
+
| Sonsuz kaydırma | `scroll-view` | `scrollEnd` olayı (prop yok) |
|
|
1093
|
+
| Kaydırma eylemleri | `repeater` | `swipeActions: [{ key, label, tone, icon }]` + `swipe` olayı, payload `{ key, index, row }` |
|
|
1094
|
+
| Satıra dokunma | `repeater` | `itemPressable: true` + `itemPress` olayı, payload `{ index, row }` |
|
|
1095
|
+
|
|
1096
|
+
Çekerek yenileyi `repeater`'a yazmak en sık hatadır: liste kendi kaydırmasını yapmaz, onu saran
|
|
1097
|
+
`scroll-view` yapar. `repeater` kökteyse (kap yok) yenileme hiç çizilmez.
|
|
1098
|
+
|
|
1099
|
+
Satıra dokunmanın kartın `click`'iyle yapılan eski yolu mobilde bırakıldı: `itemPress` satır
|
|
1100
|
+
bağlamını payload'da taşır ve seçimi (`selectedIndex`) de yazar, yani akış satırı
|
|
1101
|
+
`<tekrarlayıcı>.selectedItem` ile okumaya devam eder.
|
|
1102
|
+
|
|
1103
|
+
### `redirect.presentation`
|
|
1104
|
+
|
|
1105
|
+
`redirect` adımının `args.presentation` alanı ekranın NASIL açıldığını söyler ve kapalı bir küme
|
|
1106
|
+
alır:
|
|
1107
|
+
|
|
1108
|
+
- `push` — yığına ekler, geri düğmesi önceki ekrana döner (**varsayılan**; alan yazılmayabilir)
|
|
1109
|
+
- `modal` — alttan açılan ayrı bir sunum; geri onu kapatır, altındaki ekran yerinde kalır
|
|
1110
|
+
- `replace` — geçerli ekranı değiştirir, geçmişe girmez (giriş → ana ekran için doğru olan)
|
|
1111
|
+
|
|
1112
|
+
Küme dışı bir değer **MOB-008** uyarısıdır ve backend doğrulayıcısı 422 döner. Alanı hiç yazmamak
|
|
1113
|
+
kusur değildir.
|
|
1114
|
+
|
|
1115
|
+
**Sekme hedefinde `modal` çalışmaz.** Hedef sayfa bir sekmeyse gezinme her zaman `navigate`'e
|
|
1116
|
+
düşer: sekme yığını kendi geçmişini tutar ve modal onu kırardı. `presentation`ı yazabilirsiniz,
|
|
1117
|
+
çizer sessizce yok sayar — sekme dışı bir sayfaya modal istiyorsanız o sayfayı sekme listesinden
|
|
1118
|
+
çıkarın.
|
|
1119
|
+
|
|
1120
|
+
Web uygulamasında alan yok sayılır; gateway web profilinde bu konuda bulgu üretmez.
|
|
1121
|
+
|
|
1100
1122
|
## Kural 1h — Tasarım: `style` prop'u ve tema değişkenleri
|
|
1101
1123
|
|
|
1102
1124
|
Her komponentin `style` prop'u vardır ve emotion `css()` bloğudur: iç seçiciler, pseudo-class'lar
|
|
@@ -1316,7 +1338,7 @@ budur — bir preset ya da `componentStyles` sizin değerinizi eziyorsa `styleLa
|
|
|
1316
1338
|
| Değişiklik | Tool | Neden |
|
|
1317
1339
|
|---|---|---|
|
|
1318
1340
|
| Komponent ekle/sil/taşı, prop, binding, event | `page_schema_patch` | Doğrulama duvarı + açık Studio canvas'ına SignalR canlı yayını + eşzamanlı yazar kilidi yalnız bu yolda çalışır |
|
|
1319
|
-
| Ad, slug, browserTitle, `browserTitleKey`, layout, roller, middleware | `page_update` | Üstbilgi alanları micro-op sözlüğünde yok. `browserTitleKey` sekme başlığını çeviri anahtarına bağlar: verilirse başlık sözlükten çözülür, boşsa `browserTitle` kullanılır. Başlık
|
|
1341
|
+
| Ad, slug, browserTitle, `browserTitleKey`, layout, roller, middleware | `page_update` | Üstbilgi alanları micro-op sözlüğünde yok. `browserTitleKey` sekme başlığını çeviri anahtarına bağlar: verilirse başlık sözlükten çözülür, boşsa `browserTitle` kullanılır. Başlık sayfa yüklenirken çözülür ve canlı dil değişimini izlemez (`platform_guide('translation')`) |
|
|
1320
1342
|
|
|
1321
1343
|
Platformun `PUT /pages/...` ucu **replace**'tir: gönderilmeyen `schema`/`events`/`roleIds`
|
|
1322
1344
|
alanları silinir. Gateway bu yüzden `page_update`'te sayfayı önce okur, yalnız verdiğin
|
|
@@ -1831,7 +1853,7 @@ bağlanır, filtre `source:'expression'` + `value:'user.id'` olur.
|
|
|
1831
1853
|
| Kimlik alanları | `email` · `password` |
|
|
1832
1854
|
| Dosya | `fileUpload` (dropzone) · `fileInput` · `filebutton` · `file-viewer` |
|
|
1833
1855
|
| Liste | `table` · `datatable` (Kural 1e) · `repeater` (kart listesi VE dinamik form — Kural 1g) · `tree-view` (hiyerarşi; `isSearchable` ile istemci içi arama) · `timeline` (tarihli olay akışı) |
|
|
1834
|
-
| Pano / takvim | `kanban` (durum kolonlarında sürüklenebilir kartlar; taşıma `cardMove` ile `event.data`'dan okunur, kalıcılık AKIŞIN işidir) · `eventcalendar` (ay/hafta/gün
|
|
1856
|
+
| Pano / takvim | `kanban` (durum kolonlarında sürüklenebilir kartlar; taşıma `cardMove` ile `event.data`'dan okunur, kalıcılık AKIŞIN işidir) · `eventcalendar` (ay/hafta/gün; veri `rows`'a akışla yazılır, `monthChange` tazeleme kancasıdır, `month` 1-tabanlı) |
|
|
1835
1857
|
| Kayıt detayı | `detailview` — tek kaydı etiket/değer ızgarası basar (alan başına format, iç içe alan yolu); OLAY YAYMAZ, tıklanabilirlik gerekiyorsa kapsayıcıya sar |
|
|
1836
1858
|
| Adımlı akış | `stepper` — tabs gibi her adım kendi droppable görünümünü taşır; ileri gidiş `canProceed` kapısıyla (`{{ form1.isValid === true }}` biçimi), adım `currentStep` setter'ıyla sürülür |
|
|
1837
1859
|
| İmza / CSV içe aktarma | `signature` (değer PNG data-URL ya da ham SVG; `change` setter'lı) · `importwizard` (3 adımlı sihirbaz; temiz+hatalı satırlar `complete` yükünde — satırları uca yazmak akışın işidir) |
|