@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.
- package/README.md +5 -5
- package/dist/config.js +0 -26
- package/dist/knowledge/backendConstraints.js +1 -18
- package/dist/knowledge/componentCatalog.js +27 -493
- package/dist/knowledge/componentEvents.js +2 -120
- package/dist/knowledge/connectDataDefinition.js +4 -4
- package/dist/knowledge/connectDataRules.js +1 -1
- package/dist/knowledge/mobileComponentCatalog.js +13 -8
- package/dist/knowledge/mobileStore.js +227 -0
- package/dist/knowledge/normalize.js +48 -131
- package/dist/knowledge/outlines.js +0 -36
- package/dist/knowledge/platform/lint.js +1 -1
- package/dist/knowledge/platform/nativeBoxModel.js +1 -1
- package/dist/knowledge/policy.js +4 -18
- package/dist/knowledge/process.js +1 -1
- package/dist/knowledge/reservedTables.js +0 -79
- package/dist/knowledge/rules.js +10 -83
- package/dist/knowledge/schemaGuard.js +0 -11
- package/dist/observability/trace.js +2 -5
- package/dist/platform/capture/capture.js +1 -25
- package/dist/platform/errors.js +10 -162
- package/dist/platform/http.js +1 -6
- package/dist/platform/responses.js +4 -34
- package/dist/platform/schemaReadMemory.js +2 -2
- package/dist/platform/secrets.js +1 -8
- package/dist/resources/examples/middleware-authenticate.json +1 -1
- package/dist/resources/examples/mobile-app-shell-drawer.json +62 -61
- package/dist/resources/examples/mobile-list-detail-form.json +51 -20
- package/dist/resources/examples/page-detail-profile.json +1 -2
- package/dist/resources/examples/page-dynamic-form.json +2 -3
- package/dist/resources/examples/page-html-embed.json +1 -1
- package/dist/resources/examples/workflow-basic.json +2 -8
- package/dist/resources/guides/access.md +4 -18
- package/dist/resources/guides/bpm.md +1 -6
- package/dist/resources/guides/component.md +4 -83
- package/dist/resources/guides/entity.md +8 -50
- package/dist/resources/guides/getting-started.md +1 -38
- package/dist/resources/guides/merge.md +3 -37
- package/dist/resources/guides/microservice.md +0 -78
- package/dist/resources/guides/middleware.md +3 -35
- package/dist/resources/guides/mobile.md +85 -2
- package/dist/resources/guides/page.md +26 -278
- package/dist/resources/guides/workflow.md +0 -51
- package/dist/resources/rules.js +5 -11
- package/dist/resources/schema-fingerprint.json +5 -7
- package/dist/resources/schemas/CreateEntityCommand.json +0 -118
- package/dist/resources/schemas/CreateMicroserviceCommand.json +1 -13
- package/dist/resources/schemas/CreateQueryCommand.json +0 -4
- package/dist/resources/schemas/CreateWorkflowCommand.json +1 -146
- package/dist/resources/schemas/DataJobDto.json +1 -6
- package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json +2 -20
- package/dist/resources/schemas/MicroserviceDto.json +1 -13
- package/dist/resources/schemas/PreviewMicroserviceCommand.json +1 -10
- package/dist/resources/schemas/PreviewWorkflowCommand.json +1 -25
- package/dist/resources/schemas/StartMobileBuildCommand.json +54 -0
- package/dist/resources/schemas/StepDto.json +1 -25
- package/dist/resources/schemas/UpdateEntityCommand.json +0 -118
- package/dist/resources/schemas/UpdateMicroserviceCommand.json +1 -13
- package/dist/resources/schemas/UpdateQueryCommand.json +0 -4
- package/dist/resources/schemas/UpdateViewCommand.json +2 -0
- package/dist/resources/schemas/UpdateWorkflowCommand.json +1 -146
- package/dist/resources/schemas/UpsertMobileStoreSettingsCommand.json +259 -0
- package/dist/server.js +5 -25
- package/dist/tools/access.js +2 -369
- package/dist/tools/common.js +0 -7
- package/dist/tools/components.js +2 -15
- package/dist/tools/datasources.js +2 -2
- package/dist/tools/dependencies.js +1 -1
- package/dist/tools/deployments.js +3 -38
- package/dist/tools/designSchemaPatch.js +3 -13
- package/dist/tools/dtos.js +5 -36
- package/dist/tools/entities.js +12 -79
- package/dist/tools/externalComponents.js +1 -1
- package/dist/tools/flows.js +10 -45
- package/dist/tools/folders.js +1 -1
- package/dist/tools/imports.js +2 -5
- package/dist/tools/layouts.js +5 -6
- package/dist/tools/merges.js +2 -2
- package/dist/tools/microservices.js +20 -50
- package/dist/tools/mobileStore.js +268 -0
- package/dist/tools/pages.js +35 -89
- package/dist/tools/platformInfo.js +6 -20
- package/dist/tools/projects.js +9 -71
- package/dist/tools/rows.js +12 -62
- package/dist/tools/schemaOps.js +1 -29
- package/dist/tools/screenWrite.js +1 -22
- package/dist/tools/screens.js +3 -6
- package/dist/tools/templates.js +1 -26
- package/dist/tools/translations.js +1 -1
- package/dist/tools/workflows.js +5 -10
- package/package.json +2 -2
|
@@ -177,6 +177,14 @@ istekle gider.
|
|
|
177
177
|
Workflow'un dosya yükleme adımı yalnız `{ id }` döndürür (URL yok); görsel adresi kaydı okuyan uçtan
|
|
178
178
|
gelir. `page_screenshot` ile listede görseli doğrulayın.
|
|
179
179
|
|
|
180
|
+
## Liste ve boş durumu
|
|
181
|
+
|
|
182
|
+
Mobil `repeater`'ın çocukları TAM İKİ `view`'dır (web listesi tek şablonludur, bu şekil YALNIZ mobildir) — satır şablonu ve boş görünüm (ADR
|
|
183
|
+
docs/adr/0005; başka şekil 422 `fixed-views`). Satır yokken boş görünüm bir kez, tam genişlikte
|
|
184
|
+
çizilir; boş ekranı oraya tasarla. `emptyTitle`/`emptyDescription`/`emptyIcon` prop'ları ve kardeş
|
|
185
|
+
`emptystate` yolu 2026-09-30'da kaldırıldı. Mobil `view` çocuklarını sütunda dizer. Tam gövde:
|
|
186
|
+
`ngapps://examples/mobile-list-detail-form`.
|
|
187
|
+
|
|
180
188
|
## Güne göre görev listesi
|
|
181
189
|
|
|
182
190
|
Başlıklar altında gruplanmış liste (güne, odaya, kategoriye göre) **tek `grouped-list`** ile kurulur.
|
|
@@ -240,7 +248,8 @@ düğümü sayfa kök kabının SONUNA koyun (akıştaki yeri boş kalır).
|
|
|
240
248
|
çapalı kap app-bar'ın üstüne biner, sabit app-bar'ın altına `offsetY` ile inilir (ör. 72).
|
|
241
249
|
- **Kaydırırken üstte kalan başlık:** `scroll-view` içinde ilk çocuk `stickyHeader: true`, diğer
|
|
242
250
|
doğrudan çocuklar düğüm durumu `states: { isSticky: true }` ile (yalnız dikey; kaydırıcıya `fixed`
|
|
243
|
-
boy verin). Sayfayı örten katman için `modal` / `drawer` widget'
|
|
251
|
+
boy verin). Sayfayı örten katman için `modal` / `drawer` widget'ı — şemanın **kökünde**, sayfa
|
|
252
|
+
kabının kardeşi olarak (kabın içinde `422 layer-outside-root`).
|
|
244
253
|
|
|
245
254
|
`page_screenshot` (viewport karesi, `layoutReport: true`) sabit içeriğin çapalı noktada, sekme çubuğunun
|
|
246
255
|
üstünde durduğunu gösterir; uzun sayfada içerik kabın altından akar.
|
|
@@ -359,6 +368,7 @@ etiketi ailesini `typographyStyle`'dan alır, alan etiketleri platform yazı tip
|
|
|
359
368
|
`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
|
|
360
369
|
layout/sayfada eski `tab-bar` / `drawer-menu` düğümü `MOB-007` alır. Sekme dışı sayfalar yığına açılır.
|
|
361
370
|
- **Çekmece bir bileşendir.** `drawer` widget'ı + `app-bar`'ın `menuTarget` prop'u çekmeceyi açar.
|
|
371
|
+
Çekmece layout'un kök dizisindedir (`views: [shell_root, nav_drawer]`), kabuk kabının içinde değil.
|
|
362
372
|
- Kabuk örnekleri: `ngapps://examples/mobile-app-shell-stack` (yığın), `ngapps://examples/mobile-app-shell-tab`
|
|
363
373
|
(sekmeler), `ngapps://examples/mobile-app-shell-drawer` (çekmece); üç sayfalık liste → detay → form akışı:
|
|
364
374
|
`ngapps://examples/mobile-list-detail-form`.
|
|
@@ -400,7 +410,7 @@ Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `functi
|
|
|
400
410
|
| `confirm` | `yes` / `no` dalları |
|
|
401
411
|
| `download` | adres cihazın açma sayfasında açılır; ikili gövde (JSON değil) önbelleğe dosya olarak yazılıp paylaşım sayfasında (`expo-sharing`) açılır, Studio mobil önizlemesi dosyayı indirir (`MOB-005`, bilgi) |
|
|
402
412
|
| `storage` | `args.name` `state.page.<key>` / `state.app.<key>` ise o state'i yazar (§Kalıcı state), değilse cihaz deposuna |
|
|
403
|
-
| `setcookie` |
|
|
413
|
+
| `setcookie` | cihaz deposuna yazar (`MOB-005`, bilgi); Studio paleti mobilde de sunar |
|
|
404
414
|
| `share` | RN paylaşım sayfası (metin + bağlantı; Android'de bağlantı metne eklenir, `title` iOS'ta e-posta konusu, Android'de seçici başlığı); akış `always` ile sürer — iOS'ta sayfa kapanınca, Android'de seçici açılır açılmaz (RN kapanışı bildirmez). Argümanlar `platform_guide('page')` §`share` adımı |
|
|
405
415
|
| `haptic` | dokunsal geri bildirim (`expo-haptics`, izin istemez). `args.value` stil, **düz metin**: `success` · `warning` · `error` · `light` · `medium` · `heavy` · `selection`; boş → `medium`. Değer yazmaz, hep `always`. Web'de titreşim varsa kısa titreşim, yoksa hiçbir şey (paletten yalnız mobilde sunulur) |
|
|
406
416
|
| `location` | cihaz konumu (`expo-location`; ilk kullanımda izin sorulur). `args.value` doğruluk, düz metin: `low` · `balanced` · `high` (boş → `balanced`); `args.isRaw: true` → adres çözülmez. Sonuç `Steps.<adım>.data = { latitude, longitude, accuracy, address }`, `address = { country, region, subregion, city, district, street, postalCode }` ya da `null` (Türkiye'de il `region`, ilçe `subregion`, yoksa `city`). İzin reddi `Steps.<adım>.error = { status: 'denied', message }`, okunamayan konum `unavailable`: adımın `error` dalı bağlıysa o koşar (`always` koşmaz), yoksa akışın hata akışı, o da yoksa `always` (`data: null`). Web'de tarayıcı konumu, adres hep `null` |
|
|
@@ -483,6 +493,79 @@ Expo uygulaması (`apps/mobile-runtime`) aynı sayfayı native çizer. Derin ba
|
|
|
483
493
|
yapmış olmalıdır. Canlı önizleme sayfa şeması değişikliğini (`/hubs/page-schema`) dinler; yazdığın
|
|
484
494
|
yama cihazda yenilenir.
|
|
485
495
|
|
|
496
|
+
## Yayın
|
|
497
|
+
|
|
498
|
+
Mağaza derlemesi bir Mac runner'da koşar; uygulama **production ortamını** okur (yükleme için açılış sayfası
|
|
499
|
+
production'a dağıtılmış olmalı; yalın `build` onsuz da derlenir, uygulama "yayımlanmamış" ekranını gösterir). Mağaza bilgisi ortam değil uygulama düzeyindedir (Core DB), dağıtımla kopyalanmaz.
|
|
500
|
+
|
|
501
|
+
**Ajanın yaptığı:** `mobile_store_get` (ayar, kilitli alanlar, görsel yuvası sayısı, beyanlar; `manifest: true`
|
|
502
|
+
derleme manifesti) · `mobile_store_update` (gizli olmayan ayar — yama okunan kaydın üstüne birleşir) ·
|
|
503
|
+
`mobile_build_start` (`dryRun: true` yalnız ön kontrol) · `mobile_build_status` · `mobile_build_log` (`after` ile
|
|
504
|
+
artımlı) · `mobile_build_cancel`.
|
|
505
|
+
|
|
506
|
+
**İnsanın Studio › Yayın'da yaptığı (MCP'de araç yok):** Apple/Google hesabı, sertifika, profil, keystore,
|
|
507
|
+
inceleme demo parolası (gizli bilgi) · ikon, splash, ekran görüntüsü, öne çıkan görsel (dosya yükleme) ·
|
|
508
|
+
mağaza beyanları (App Privacy, Data safety, içerik derecelendirme, hedef kitle, uygulama erişimi — kullanıcı
|
|
509
|
+
beyanıdır, ajan işaretlemez). `mobile_store_update` `review.demoPassword` gibi alanı şema katmanında reddeder.
|
|
510
|
+
|
|
511
|
+
**Akış:**
|
|
512
|
+
|
|
513
|
+
1. `mobile_store_get` → kimlik varsayılandır (`app.zeyrek.o<org>.a<uygulama>`); değiştirilecekse **ilk
|
|
514
|
+
derlemeden önce** `mobile_store_update { settings: { bundleIdentifier, androidPackage, scheme } }`. İlk
|
|
515
|
+
derleme bu üçünü ve sayaçları kilitler (`lockedFields`); değişim 422.
|
|
516
|
+
2. Mağaza metni: `settings.listing.<dil>` (`title` ≤ 30, `description` ≤ 4000, `keywords` virgülle ≤ 100…),
|
|
517
|
+
`urls.privacyPolicy`, iOS `apple.categories.primary` + `apple.copyright`, Android `play.contactEmail`.
|
|
518
|
+
Biçimsiz alan **MOB-022** ile yazılmadan durur; yükleme için eksik alan uyarıdır (taslak kaydedilir).
|
|
519
|
+
3. `mobile_build_start { platform, target, dryRun: true }` → `fail` satırlarını düzelt (aşağıdaki tablo).
|
|
520
|
+
4. `mobile_build_start { platform, target }` → `mobile_build_status { buildId }` ile `completed`/`failed`
|
|
521
|
+
bekle. Her başlatma derleme numarası ayırır; iptal/hata numarayı geri vermez.
|
|
522
|
+
|
|
523
|
+
Hedef: `build` (iki platform, yalnız derler) · `testflight` (yalnız iOS) · `internal` (yalnız Android, Play
|
|
524
|
+
iç test). TestFlight'ta runner yükledikten sonra iş `running` + `store_processing` kalır (`awaitingStore`),
|
|
525
|
+
Apple işleyince `completed` (en çok 60 dk); bu durumda iptal 409. İptal 409'unun mesajı nedeni söyler (iş zaten
|
|
526
|
+
tamamlandı / başarısız / iptal edildi, mağaza yüklemeyi işliyor).
|
|
527
|
+
TestFlight'ta derleme yüklenip mağaza metni/ekran görüntüleri reddedilirse iş yine tamamlanır;
|
|
528
|
+
`storeResult.listingError` (hata kodu, ör. `store_rejected`) + `listingMessage` (ne yapılacağı) gelir. Derleme
|
|
529
|
+
TestFlight'tadır, numara harcanmıştır: metni düzeltip yeni sürüm yüklemek gerekir, işi yeniden başlatmak aynı
|
|
530
|
+
metni yeni numarayla yeniden dener.
|
|
531
|
+
|
|
532
|
+
### Ön kontrol (`mobile_build_start` `dryRun`)
|
|
533
|
+
|
|
534
|
+
| id | Kod (`fail`) | Nerede düzelir |
|
|
535
|
+
|---|---|---|
|
|
536
|
+
| P-01 | `settings_incomplete`; Android `internal`'da `release_notes_too_long` (bir dilde `releaseNotes` > 500 — Play sınırı; ayar 4000'e izin verir çünkü App Store'a da gider; ikisi birlikteyse tek satırda iki cümle) | `mobile_store_update` |
|
|
537
|
+
| P-02 | `assets_missing` | Studio › Yayın › Görseller |
|
|
538
|
+
| P-03 | `secrets_missing`, `secrets_unreadable`, `signing_expired` (`warn signing_expiring`) | Studio › Yayın › Hesaplar |
|
|
539
|
+
| P-04 | `apple_account_missing`, `asc_bundle_id_missing`, `asc_app_missing`, `asc_unauthorized`, `asc_forbidden`, `asc_unreachable` | `asc_bundle_id_missing`: bundle id Apple'da kayıtlı değil — Studio ön kontrolündeki "Bundle ID'yi Apple'a kaydet" (`POST mobile-store/{appId}/ios/bundle-id`, insan onayı; ajan basmaz). `asc_app_missing`: App Store Connect'te uygulama kaydı (API açamaz, insan açar). Diğerleri: Studio hesabı |
|
|
540
|
+
| P-05 | `google_account_missing`, `play_app_missing`, `play_unauthorized`, `play_forbidden`, `play_unreachable` | Play Console'da uygulama + servis hesabı yetkisi |
|
|
541
|
+
| P-06 | `production_missing`, `production_page_missing` (yalın `build`'de `warn`, başlatmayı engellemez) | production ortamı ve dağıtım — insan onaylı, ajan yapmaz |
|
|
542
|
+
| P-07 | `https_required` | platform ayarı (destek) |
|
|
543
|
+
| P-08 | `build_active` | etkin işi bekle ya da `mobile_build_cancel` |
|
|
544
|
+
| P-09 | `runner_offline` | runner Mac'te `zeyrek-mobile-runner run` |
|
|
545
|
+
| P-10 | `manual declarations_pending` | Studio › Yayın › Beyanlar (başlatmayı engellemez) |
|
|
546
|
+
|
|
547
|
+
Satırın `message` ve `fixHint`'i backend'den, istek dilinde gelir.
|
|
548
|
+
|
|
549
|
+
### Hata kodları (`mobile_build_status` → `error.code`)
|
|
550
|
+
|
|
551
|
+
| Kod | Ne oldu → ne yapılır |
|
|
552
|
+
|---|---|
|
|
553
|
+
| `toolchain_missing` | Runner'da bir derleme aracı eksik → Mac'te runner'ın doctor komutunu çalıştırın ve listelediklerini kurun (Xcode, CocoaPods, JDK ya da Android SDK). |
|
|
554
|
+
| `manifest_invalid` | Derleme ayarları geçersiz → Uygulamanın mağaza ayarlarını — ad, kimlik ve sürüm — kontrol edip derlemeyi yeniden başlatın. |
|
|
555
|
+
| `secrets_missing` | İmzalama bilgileri eksik → İmzalama sertifikasını ve mağaza hesabını Hesaplar ve kimlik bilgileri altında ekleyin. |
|
|
556
|
+
| `prebuild_failed` | Native proje hazırlanamadı → İlk hatayı günlükte bulun. Bir modülün adını veriyorsa Zeyrek desteğine bildirin. |
|
|
557
|
+
| `pod_install_failed` | iOS bağımlılıkları kurulamadı → Runner Mac'te pod repo update çalıştırın ya da ağ erişimini kontrol edip yeniden deneyin. |
|
|
558
|
+
| `xcodebuild_failed` | iOS derlemesi başarısız → Günlükte ilk hata satırını bulun. Runner'daki Xcode sürümünün desteklendiğini kontrol edin. |
|
|
559
|
+
| `gradle_failed` | Android derlemesi başarısız → Günlükte ilk hata satırını bulun. Runner'daki JDK ve Android SDK sürümlerini kontrol edin. |
|
|
560
|
+
| `signing_failed` | Uygulama imzalanamadı → Sertifika ve profilin paket kimliğiyle eşleştiğini ve süresinin dolmadığını kontrol edin. |
|
|
561
|
+
| `upload_failed` | Derleme yüklenemedi → Mağaza hesabı bilgilerini ve runner'ın ağını kontrol edip yeniden deneyin. |
|
|
562
|
+
| `store_rejected` | Mağaza derlemeyi reddetti → Mağazanın gerekçesini günlükte okuyun, kaydı ya da derlemeyi düzeltin ve yeni bir derleme numarasıyla yayımlayın. |
|
|
563
|
+
| `timeout` | Derleme çok uzun sürdü → Yeniden deneyin. Zaman aşımı sürerse runner Mac'in yükünü ve disk hızını kontrol edin. |
|
|
564
|
+
| `cancelled` | Derleme iptal edildi → Hazır olduğunuzda yeni bir derleme başlatın. |
|
|
565
|
+
| `runner_lost` | Runner yanıt vermeyi bıraktı → Runner Mac'in uyanık ve çevrim içi olduğunu kontrol edip derlemeyi yeniden başlatın. İpucu `runner_offline`: 24 saat içinde hiçbir runner işi almadı. |
|
|
566
|
+
| `disk_full` | Runner Mac'in diski doldu → Runner Mac'te yer açın (eski derlemeler, DerivedData) ve yeniden deneyin. |
|
|
567
|
+
| `unknown` | Derleme başarısız → Ayrıntı için günlüğü açın. Neden belirsizse derlemeyi Zeyrek desteğine bildirin. |
|
|
568
|
+
|
|
486
569
|
## Bilinen farklar
|
|
487
570
|
|
|
488
571
|
- Piksel paritesi yoktur: yazı tipi ölçüsü, gölge ve güvenli alan cihaza göre değişir. Parite yapısaldır.
|
|
@@ -31,14 +31,8 @@ blokları 1h-3'te).
|
|
|
31
31
|
|
|
32
32
|
## Kural 1 — Komponent gövdesinin şekli (`DesignComponentManagementSchema`)
|
|
33
33
|
|
|
34
|
-
Sayfa şeması **micro-op hattından** kurulur; `page_create
|
|
35
|
-
|
|
36
|
-
gateway geçersiz enum değerini `invalid-enum-value`, olmayan prop'u `unknown-prop`, geçersiz
|
|
37
|
-
`appearance` jetonunu `invalid-appearance` ile **istek gitmeden** reddeder — platformun micro-op
|
|
38
|
-
ucundaki duvarıyla aynı kural kimlikleri. Micro-op hattının hâlâ iki üstünlüğü var: **canlı
|
|
39
|
-
canvas** (SignalR) ve ATOMİK op listesi. Gateway'in tam şema denetimi ÜST DÜZEY prop'lara ve
|
|
40
|
-
`appearance` jetonlarına bakar (platformun duvarı da öyle: `surfaceStyle.contentOverflow` gibi iç
|
|
41
|
-
alanlar denetlenmez); katalog okunamazsa denetim susar ve yazma eskisi gibi geçer.
|
|
34
|
+
Sayfa şeması **micro-op hattından** kurulur; `page_create`'e satır içi `schema` vermek de
|
|
35
|
+
mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`'te çalışır.
|
|
42
36
|
|
|
43
37
|
```jsonc
|
|
44
38
|
{ "elementId": "page_header_1", "kind": "component", "type": "<component_list slug'ı>",
|
|
@@ -396,7 +390,7 @@ göstermek error flow'un işidir.
|
|
|
396
390
|
> ifadeyi `null.token` üzerinden dener; `runCode` hatayı yutar (K2), ifade `undefined` döner ve
|
|
397
391
|
> akış sessizce diğer dala düşer — `else` dalı bağlı değilse akış orada biter. `data`yı bir
|
|
398
392
|
> liste prop'una yazan bir setter artık patlayan bir nesne değil `null` görür (repeater/table
|
|
399
|
-
> `null`'ı boş liste sayar), ama hata OLDUĞUNU fark etmeden geçer — gateway bunu **FLOW-
|
|
393
|
+
> `null`'ı boş liste sayar), ama hata OLDUĞUNU fark etmeden geçer — gateway bunu **FLOW-028**
|
|
400
394
|
> ile uyarır.
|
|
401
395
|
>
|
|
402
396
|
> **`errorSteps` yalnız `start` taşıyorsa hata yolu YOKTUR:** `hasErrorFlow`
|
|
@@ -461,7 +455,7 @@ göstermek error flow'un işidir.
|
|
|
461
455
|
> **"Ana akışta condition" sütunu `.error`'u okumalı, `.data`'yı değil.** `Steps.<adımAdı>.data`'nın
|
|
462
456
|
> DOLU/BOŞ olmasına bakarak başarı/hata ayırmak (`data.token` gibi bir alanın varlığını yoklamak)
|
|
463
457
|
> artık yanıltıcıdır — `data` hata anında zaten `null`'dur (yukarıdaki §"4xx de hatadır"). Böyle bir
|
|
464
|
-
> `condition`'ı gateway **FLOW-
|
|
458
|
+
> `condition`'ı gateway **FLOW-028** ile uyarır; adıma ayrıca bir `error` dalı bağlayın (aşağıdaki
|
|
465
459
|
> 7c örneği) — `error` dalı bağlıysa uyarı düşer, çünkü hata artık `always`'e hiç uğramaz.
|
|
466
460
|
|
|
467
461
|
Zorunlu filtresi olan uçlarda (`patient-*`, `doctor-appointments` gibi `isRequired: true`
|
|
@@ -539,8 +533,7 @@ Tarif: `platform_guide('middleware')`.
|
|
|
539
533
|
|
|
540
534
|
**Sözlükler** (`StepType.cs`, `StepParameterValueType.cs` — hepsi küçük harf):
|
|
541
535
|
`start · microservice · setter · setcookie · validation · condition · redirect · alert ·
|
|
542
|
-
confirm · flow-trigger · storage · navigate · code · download · function · share · end
|
|
543
|
-
(`bpm` argümanı `value` içinde JSON metnidir — `platform_guide('bpm')` §Yürütme ve kutu)
|
|
536
|
+
confirm · flow-trigger · storage · navigate · code · download · function · share · end`
|
|
544
537
|
değer tipleri: `static · page · property · storage · variable · code · item · state`
|
|
545
538
|
|
|
546
539
|
> **Sözlükte olmak KOŞACAĞI anlamına gelmez — koşan tipler barındırıcıdan gelir.** Motor yedi
|
|
@@ -551,7 +544,7 @@ değer tipleri: `static · page · property · storage · variable · code · it
|
|
|
551
544
|
>
|
|
552
545
|
> | Adım tipi | Web | Mobil uygulama | Nerede register ediliyor |
|
|
553
546
|
> |---|---|---|---|
|
|
554
|
-
> | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` · `function`
|
|
547
|
+
> | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` · `function` | ✅ | ✅ | `flow-engine.ts` — motorun kendisi |
|
|
555
548
|
> | `alert` · `redirect` · `setcookie` · `storage` | ✅ | ✅ | barındırıcı; mobilde `setcookie` cihaz deposuna yazar (`MOB-005`) |
|
|
556
549
|
> | `confirm` · `download` · `share` | ✅ | ✅ | `Runtime.svelte` · `runtime-tasks.ts` (`download` mobilde açma/paylaşım — `MOB-005`; `share` aşağıda) |
|
|
557
550
|
> | `navigate` | ❌ | ✅ (`redirect` takma adı) | web'deki karşılığı `redirect`; gateway `redirect`'e çevirir |
|
|
@@ -595,7 +588,7 @@ değer tipleri: `static · page · property · storage · variable · code · it
|
|
|
595
588
|
> DÜZ METİNDİR (ifade yazılırsa FLOW-022 uyarır); `message` ve `path` `storage.value` gibi
|
|
596
589
|
> İFADEDİR — düz metin tırnak ister (`"'Şuna bak'"`, `"'https://…/urun/' + Page.queryParams.id"`).
|
|
597
590
|
> Bağlantının adı `url` DEĞİL `path`'tir: backend `Title`/`Message`/`Path` alanlarında saklar ve
|
|
598
|
-
> tanımadığı anahtarı 200 ile sessizce düşürür (FLOW-
|
|
591
|
+
> tanımadığı anahtarı 200 ile sessizce düşürür (FLOW-027 `url`/`link`/`text`'i ve tırnaksız adresi
|
|
599
592
|
> bloklar). Bağlantı ŞEMALI TAM ADRES olmalı (`https://…`, `mailto:…`): şemasız değer (`www.…`,
|
|
600
593
|
> `urun/42`) adres sayılmaz, metnin sonuna eklenir. İfadenin sonucu yalnız dize ya da sayıysa
|
|
601
594
|
> paylaşılır; `false` (`koşul && 'x'`), `null` ve nesne boş sayılır. Cihazda paylaşım sayfası açılır
|
|
@@ -642,168 +635,6 @@ verilmemiş bir tablo kaynağı vardır ve sayfa göstergesi `NaN / N` olur (öl
|
|
|
642
635
|
> bildirir, ama ham HTTP'de bu kural sana ait.) `add_component`'te ise sarmal ZORUNLUdur — iki
|
|
643
636
|
> op'un şekli birbirinin tersidir, karıştırma.
|
|
644
637
|
|
|
645
|
-
## Kural 1c-3 — Prop'u veri kaynağına BAĞLAMA (`connectData`)
|
|
646
|
-
|
|
647
|
-
Liste, seçenek, grafik serisi ya da ağaç verisi bir TABLODAN geliyorsa akış yazılmaz: prop veri kaynağına bağlanır.
|
|
648
|
-
Değer `{ type: 'connectData', ref: <tanım>, data: <son satırlar> }` olur; runtime satırları
|
|
649
|
-
`POST /connect-data/{uygulama}/{sayfa}/{element}/{prop}` ucundan okur, politika her istekte uygulanır.
|
|
650
|
-
|
|
651
|
-
| İş | Yol |
|
|
652
|
-
|---|---|
|
|
653
|
-
| Tablo/datatable satırları, dropdown/select seçenekleri, grafik serisi, kanban kartları — kaynak tablo, okuyan query, **liste dönen workflow (dönüş DTO'su array) ya da okuyan microservice** olsa da | **Bağla** (bu kural) |
|
|
654
|
-
| Tek kayıt yükleyip forma doldurmak, bir düğmeyle tetiklenen yazma/işlem, çıktısı birden çok bileşene dağıtılan sonuç | **Akış** (Kural 1c) |
|
|
655
|
-
|
|
656
|
-
**Tek çağrı.** `connect_data_bind` bileşenin bağlanabilir prop kaydını ve kaynağın kabiliyetini
|
|
657
|
-
okur, tanımı kurar, bulguları istek gitmeden verir ve tek atomik yamayla yazar:
|
|
658
|
-
|
|
659
|
-
```json
|
|
660
|
-
{ "applicationId": "<app>", "pageId": "<sayfa>", "element": "tbl_musteri", "prop": "rows",
|
|
661
|
-
"source": { "kind": "entity", "id": "<entity id>" },
|
|
662
|
-
"fields": ["ad", "soyad", "tckn", "puan", "sube"], "expand": { "sube": ["ad"] },
|
|
663
|
-
"filterable": ["ad", "tckn", "puan"], "searchable": ["ad", "soyad"], "pageSize": 25 }
|
|
664
|
-
```
|
|
665
|
-
|
|
666
|
-
Layout'taki bileşende `pageId` yerine `layoutId`, widget içindekinde `componentId`. Yanıt `touched`, `newVersion` ve `runtime.propType: 'connectData'` döner. Önce `dryRun: true` ile
|
|
667
|
-
tanımı, op'ları ve bulguları görebilirsiniz. **Var olan bağlantıyı değiştirmek** için aynı prop ve kaynakla
|
|
668
|
-
yalnız değişen parçayı verin (`{ …, pageSize: 50 }`): verilmeyen parçalar kayıtlı tanımdan taşınır, alan
|
|
669
|
-
listesi değişmediyse kolonlar (genişlik, biçim, başlık) yeniden yazılmaz. Kolonların filtre düğmesi (`isFilterable`)
|
|
670
|
-
yalnız `filterable` listesindeki alanlarda açılır. Tam örnekler: `ngapps://examples/connect-data-table-entity`,
|
|
671
|
-
`ngapps://examples/connect-data-dropdown-roles`, `ngapps://examples/connect-data-query-params` (parametreli query +
|
|
672
|
-
`$ad`), `ngapps://examples/connect-data-workflow-microservice`, `ngapps://examples/connect-data-edit-m2m`,
|
|
673
|
-
`ngapps://examples/connect-data-convert-verify` (convert/detach + kullanıcı gözüyle doğrulama). Resource okuyamayan
|
|
674
|
-
istemcide: `platform_guide({ resource: 'ngapps://examples/<ad>' })`.
|
|
675
|
-
|
|
676
|
-
**Keşif sırası.**
|
|
677
|
-
|
|
678
|
-
1. `component_get` → `connectData.props`: hangi prop bağlanır (`rows`, `options`, `series[].data`).
|
|
679
|
-
Kayıt yoksa bileşen bağlanamaz (CD-001).
|
|
680
|
-
2. `connect_data_sources` → kaynak listesi: `entity` · `query` (yalnız okuyan) · `view` · `workflow` · `microservice`.
|
|
681
|
-
Entity dışı kaynak yazmaz. Query, view ve workflow tanımı filtre/sıralama/searchable taşımaz (CD-013); microservice
|
|
682
|
-
yalnız dinamik filtreli tablo ucunda süzer ve aranır, parametreli sıralamada sıralar (describe `canFilter`/`sortable`,
|
|
683
|
-
CD-002). Microservice'te `searchable`'a yalnız `icontains` işleçli korumasız metin alanı konur; tablonun arama metni
|
|
684
|
-
bu alanlar üzerinde OR "içerir" filtresine çevrilip uca dinamik filtre olarak gider.
|
|
685
|
-
Describe `source.pageMode: client` ise sunucu sayfalamaz, runtime ilk 1000 satırı alıp tarayıcıda süzer (CD-007); view
|
|
686
|
-
`textSearch`: arama istekteki `search` ile, aramasız liste boş. `isSchemaSampled`: DTO'suz query ilk satırdan okundu.
|
|
687
|
-
3. `connect_data_describe { source }` → alan başına efektif kabiliyet (`access` · `operators` · `sortable` · `canWrite` ·
|
|
688
|
-
`relation` · `enum`). İşleci ve sıralamayı alan tipinden tahmin etmeyin, buradan okuyun.
|
|
689
|
-
|
|
690
|
-
**İki bağlanma biçimi.**
|
|
691
|
-
|
|
692
|
-
- **Alan listesi (`fieldsFrom`)** — `datatable.rows`, `table.rows`, `repeater.rows`. Kolon listesi (`columns`) bileşenin
|
|
693
|
-
KENDİ kolon şemasından üretilir (metin → `text`, sayı → `number`, boolean → `switch`, ilişki → `relation` yoksa `tag`,
|
|
694
|
-
enum → `tag`); `expand` yolu (`sube.ad`) satıra okunur ama kolon OLMAZ — hedefte gösterilecek alanlar `lookup`'a yazılır.
|
|
695
|
-
Yeniden bağlamada kolonların sırası ve ayarları korunur.
|
|
696
|
-
- **Roller** — dropdown/radio `{ label, value, … }`, grafik `{ category, value, series, … }`. Verilmezse
|
|
697
|
-
yalnız ZORUNLU roller önerilir: `value` ← birincil anahtar, `label` ← görünen alan, diğer zorunlu rol
|
|
698
|
-
türündeki ilk alan. İsteğe bağlı roller (`caption`, `color`, `isDisabled`, `series`…) açıkça verilmedikçe
|
|
699
|
-
boş kalır. Zorunlu rol doldurulamazsa bind aday listesiyle durur; rolü besleyemeyen alan tipi uyarıdır
|
|
700
|
-
(CD-016). Runtime satırları rol adlarına da yazar (`option.label ← ad`). Kaydında `fields` olan bileşende
|
|
701
|
-
(grafik `categoryField`, kanban `titleField`) alan adı o prop'lara aynı yamada yazılır; kanban `columns`
|
|
702
|
-
kolon rolünün enum değerlerinden üretilir (yeniden bağlamada elle girilen `wipLimit` korunur). Grafiğin
|
|
703
|
-
`aggregate`'i yazılmaz — satır başına tekrar eden kategori için elle ayarlayın (CD-015).
|
|
704
|
-
**Role ilişki alanının kendisi** (`category: 'kategori'`, o2m/self) eşlenirse runtime ve kanvas satırda o alanı
|
|
705
|
-
hedefin görünen alanına (`relation.targetDisplay`, datatable hücresindeki metin) çevirir — hem rolde hem alanın
|
|
706
|
-
kendisinde, çünkü `categoryField` satırı alan adıyla okur (39/03 U-3; önce eksen `[object Object]` çiziyordu). Kimlik
|
|
707
|
-
gerekiyorsa alt yolu eşleyin (`value: 'kategori.id'`); m2m dizisi çevrilmez.
|
|
708
|
-
- **Sayfalamayan bileşen bütün sonucu okur** (bileşen tanımında `isPaginated` yok — grafik, dropdown, stat card,
|
|
709
|
-
kanban…; 39/03 U-5): `pageSize` verilmezse tanımın sayfa boyu **1000** (motorun tek okuma tavanı) yazılır, kayıtlı eski
|
|
710
|
-
25 de ezilir. Kaynak 1000'i aşarsa satırlar kesilir ve runtime bunu `runtimeErrors`'a `ConnectDataRowsTruncated` olarak
|
|
711
|
-
yazar; kanvas şeridi "Sayfalamıyor: N satırın M satırını gösterir" der.
|
|
712
|
-
- **Stat Card ana değeri** (39/03 U-13): birincil bağlanabilir prop `rows` (rol `value: number`); kart `valueAggregate`
|
|
713
|
-
(`first` · `count` · `sum` · `avg` · `min` · `max`) özetini basar, `count` kaynağın `meta.total`'ıdır. `sparkline`
|
|
714
|
-
ikincil prop olarak bağlanır. Bağlama `valueAggregate`'i yazmaz — `page_schema_patch set_prop` ile seçin.
|
|
715
|
-
|
|
716
|
-
**Alan kimliği kalıcıdır.** `slug` sayfanın gördüğü ad, `id` fiziksel alan: kaynakta ad değişse de yanıt kayıtlı adla
|
|
717
|
-
gelir, sayfa kırılmaz. Elle yazılan tanımda her alana `id` koyun (`connect_data_bind` kendisi yazar).
|
|
718
|
-
|
|
719
|
-
**Tanımın şekli (kısa).** `version: 1` · `source { kind, id, slug? }` · `fields [{ id, slug, expand? }]` ·
|
|
720
|
-
`filter` (backend Filter ağacı) · `sort [{ field, ascending }]` · `page { mode: 'offset'|'cursor'|'client', limit }` ·
|
|
721
|
-
`language` (`request` · `default` · `xx`) · `mapping { roles, columns? }` ·
|
|
722
|
-
`behavior { filterable, searchable, edit { create, update, delete, bulk, saveMode, editable, defaults, writeMode }, refresh }`.
|
|
723
|
-
Davranış, rol ve sıralama yalnız SEÇİLİ alanlardan olur; `editable` yalnız seçili kök alanlardan (CD-004).
|
|
724
|
-
Tanım filtresinde `"$ad"` yazılan değer istekteki `params.ad`'dan bağlanır. `cursor` (keyset) yalnız entity'de, tek
|
|
725
|
-
sıralama anahtarıyla; sonraki sayfa `page.after` ← `meta.page.nextCursor`.
|
|
726
|
-
|
|
727
|
-
**Politika arayüzü ezer.** Politikanın gizlediği alan yanıtta YOKTUR ve kolonu çizilmez, maskeli alan maskeli gelir —
|
|
728
|
-
ayrıca gizlemeye gerek yok. **Maske önkoşulu:** maske alanın depolama korumasından gelir — alan önce
|
|
729
|
-
`entity_protection_update { field, protection: { mode: 'masked', mask } }` ile korunmalı; korumasız alana politika
|
|
730
|
-
`fieldAccess: 'masked'` verilirse değer DÜZ döner (ACC-017 warn). Maskeli gören özne o alanı SÜZEMEZ (describe
|
|
731
|
-
`canFilter: false`, `operators: []` — koruma varsayılanı maskelidir, yetkili kullanıcı için de; 39/05). Açık (`plain`) gören
|
|
732
|
-
öznede korumalı alanda yalnız `eq` · `neq` · `in` · `notin`,
|
|
733
|
-
sıralama yok; `contains` istek gitmeden durur (CD-002).
|
|
734
|
-
|
|
735
|
-
### İlişki, enum, dosya ve Lookup
|
|
736
|
-
|
|
737
|
-
- İlişki alanı satırda hedef nesnesi olarak gelir: `sube: { id, ad }` (hangi hedef alanların geleceği
|
|
738
|
-
`expand` ile seçilir). `datatable`'da kolon tipi `relation`, hücre görünen alanı basar; m2m ilk üç
|
|
739
|
-
chip + `+N`; kullanıcı hedef tabloyu okuyamıyorsa hücre kilitli `—` (lookup ayarı etkisiz, CD-011 warn).
|
|
740
|
-
- Enum alanı `tag` kolonunda seçeneğin etiketi ve rengiyle çizilir.
|
|
741
|
-
- İlişki alanının seçim listesi aynı motordan gelir: runtime `op: 'lookup'` (hedefin anahtarı, görünen
|
|
742
|
-
alanı ve ilk düz alanları türetilir). Özelleştirmek için alanın `lookup` alt tanımı:
|
|
743
|
-
`{ slug: 'sube', lookup: { fields: [{ slug: 'ad' }, { slug: 'kod' }], behavior: { filterable: ['kod'], searchable: ['ad'] }, sort, page, mode: 'drawer' } }`.
|
|
744
|
-
`lookup` yalnız ilişki alanında olur ve içinde ikinci `lookup` olmaz (CD-011).
|
|
745
|
-
- `datatable`'da ilişki hücresi ve filtre değeri lookup panelinden seçilir (o2m tekil, m2m çoklu) — akış yazılmaz.
|
|
746
|
-
- Dosya alanı (describe `type: 'file'`, `operators: [isnull, isnotnull]`, sıralanmaz) satırda dosya nesnesi olarak gelir:
|
|
747
|
-
`{ id, display_name, path, size, extension, content_type, folder_id, absolute_path, … }`; boş dosya/ilişki alanı `null` ya da satırda hiç yok (runtime `list` anahtarı atar — ikisini de boş sayın; 39/05)
|
|
748
|
-
(38/M-6 backend düzeltmesiyle; eski imaj `{ absolute_path: '', type: 'ref' }` döndürüyordu). Dosya alanı
|
|
749
|
-
`edit.editable`'a KONAMAZ — bağlı bileşen dosyayı satır içinde yazmaz, platform kaydı 422
|
|
750
|
-
`connect-data-editable-file` ile reddeder (CD-018, bind dryRun'da block). Dosyayı `file_upload` + `row_update` yazar.
|
|
751
|
-
|
|
752
|
-
### Yazma (`edit`)
|
|
753
|
-
|
|
754
|
-
- Tanım: `edit { create, update, delete, bulk, saveMode: 'row'|'cell'|'batch', editable: [kök alanlar], defaults, writeMode: 'atomic'|'partial' }`.
|
|
755
|
-
`row` satırı ✓ ile kaydeder; `cell` var olan satırda yalnız çift tıklanan hücreyi açar, ✓/✕ hücrenin içindedir ve
|
|
756
|
-
✓ yalnız o alanı yazar (yeni satır yine bütün olarak kaydedilir); `batch` değişiklikleri taslakta biriktirip birlikte kaydeder.
|
|
757
|
-
Bağlı `datatable`'ın düzenleme prop'larını runtime tanım ∧ politikadan yazar; hücre yalnız `editable` ∧ `canWrite`
|
|
758
|
-
alanda açılır. Kaydetmek için akış YOK: `save` bağlantı uca gider (create → update → delete).
|
|
759
|
-
- Yazmayı önden denemek: `connect_data_execute { applicationId, pageId, element, prop, op: 'update', rows: [{ id, durum: 'pasif' }], asUserId }`
|
|
760
|
-
— bileşenin isteğinin aynısı, GERÇEKTEN yazar; tanımın izin vermediği istek gitmeden durur (CD-012). İlişki alanı
|
|
761
|
-
`'<id>'`, m2m `['<id>', …]` (tam liste); hedefte olmayan kimlik 404 `ConnectDataRelationTargetNotFound` (`field`).
|
|
762
|
-
`atomic` (varsayılan) TEK transaction'dır: `rowIndex` gönderilen dizinin indeksi — HİÇBİR satır yazılmadı.
|
|
763
|
-
`writeMode: 'partial'` (yalnız built-in veritabanı): yazılabilenler yazılır, yanıt `errors[{ row, field, code, message }]`.
|
|
764
|
-
- **Zorunlu alan** (describe `isRequired`) create'te boş/eksik, update'te `null`/boş gönderilirse istek gitmeden kaynağa
|
|
765
|
-
değil motorda düşer: `422 BulkRowFailed`, `field` alanın slug'ı, `rowIndex` satır, iç neden `ConnectDataFieldRequired`
|
|
766
|
-
("Başlık alanı zorunludur."); `partial`'da yalnız o satır `errors[]`'a (39/03 U-8 — önce veritabanının NOT NULL'u
|
|
767
|
-
alan adsız `400 RowValidationFailed` veriyordu). `defaults` create'te eksik alanı doldurur.
|
|
768
|
-
- `defaults` yalnız create'te, istemci değeri ezer. Politikanın vermediği eylem ya da alan etkisizdir (CD-006).
|
|
769
|
-
Anonim sayfada açık yazma oturumsuz ziyaretçiye yazma verir (CD-017). Denetim izinde kaynak `CONNECT_DATA`.
|
|
770
|
-
|
|
771
|
-
**Doğrulama tarifi.** `connect_data_get` (tanım + drift) → `page_screenshot` (satırlar çizildi mi, `runtimeErrors`
|
|
772
|
-
boş mu; bağlama hatası `flowId: 'connect-data'`) → `connect_data_execute { op: 'list' }` (runtime yanıtı;
|
|
773
|
-
`connect_data_preview` Studio ucudur, sayfa kapısını koşmaz). **Kompleks + `enforce` projede** gateway kimliği uygulama
|
|
774
|
-
öznesi değildir: runtime araçları (`connect_data_execute`, `microservice_execute`/`_debug`, `page_runtime_get`,
|
|
775
|
-
`page_screenshot`) kimliksiz 401 `AppSessionRequired` alır. **Parolasız kullanıcı gözü:** aynı çağrıya
|
|
776
|
-
`asUserId: '<users satır id'si>'` — istek gateway kimliği + `impersonated-user-id` başlığıyla gider, özne o kullanıcıdır
|
|
777
|
-
(politika, satır kapsamı, maske); `page_screenshot` sayfanın bütün isteklerine başlığı ekler (Studio "View as user"
|
|
778
|
-
seçicisinin aynısı). Yalnız development/dal: production'da platform başlığı düşürür, gateway isteği göndermez.
|
|
779
|
-
Oturum açılmış üye gerekiyorsa `access_session_create` + `asUser`. **Kaynağın kendi grant'i** (kompleks + `enforce`,
|
|
780
|
-
ölçüldü 39/05): entity kaynağı `entity.read` (+ yazmada `entity.create/update/delete`, ilişki hedefi için hedefin `entity.read`)
|
|
781
|
-
ister; workflow kaynağı `workflow.execute` (`workflow:<id>`), microservice kaynağı `microservice.execute` (`microservice:<id>`)
|
|
782
|
-
ister — yoksa bağlantı 403 `ForbiddenException`. Query kaynağı (ve query kaynaklı uç) kapsamlı tabloya dokunuyorsa her
|
|
783
|
-
kullanıcıda 403 `AccessQueryNotScoped` (ACC-005): kullanıcıya özel liste için entity ya da tablo ucu, özet rapor için sorguyu
|
|
784
|
-
`isUnrestricted` yapın. `connect_data_convert`'in açtığı uç da ayrı `microservice.execute` ister (sayfanın bağlantısı istemez).
|
|
785
|
-
Kullanıcıda `page.view` yoksa sayfa ve bağlantı 403
|
|
786
|
-
döner — politikaya `page:<sayfa>` grant'i ekleyin. `connect_data_bind { asUserId }` CD-006/CD-011 uyarılarını o
|
|
787
|
-
kullanıcının gözüyle üretir (gateway kimliği yöneticidir, bu iki uyarıyı hiç görmez).
|
|
788
|
-
|
|
789
|
-
**Yasaklar.**
|
|
790
|
-
|
|
791
|
-
- Bağlı prop'a `set_binding`, `set_prop_type` ya da `{ type: … }` sarmallı `replace_prop` yazılmaz;
|
|
792
|
-
flow setter bağlı prop'u hedeflemez. Runtime setter'ı atlar ve bileşene hiçbir şey yazılmaz (CD-005).
|
|
793
|
-
Yalnız örnek satırları değiştirmek için `replace_prop { value: [ham satırlar] }`.
|
|
794
|
-
- Bağlantıyı kaldırmak `remove_connect_data { target, path }`: son satırlar static veri olarak kalır.
|
|
795
|
-
- Platformun yönettiği tabloda (organizasyon, rol tabloları) düzenleme açılamaz (CD-003); `users` sistem tablosu
|
|
796
|
-
değildir, `password` alanı kabiliyette hiç yoktur.
|
|
797
|
-
- Kaynaktan silinmiş alan tanımda kalırsa uyarı; `connect_data_bind { fixDrift: true }` her yerden (filtre, expand dahil) düşürür (CD-008).
|
|
798
|
-
- Aynı sayfada aynı kaynağa 5+ bağlantı uyarıdır (CD-010).
|
|
799
|
-
- **Parametreli kaynak** (query/workflow/microservice): `connect_data_describe` `source.parameters` bağlantının doldurabileceği parametreleri verir; `connect_data_bind { params: { yil: 2026, sube: '$secilenSube' } }` sabit değer ya da sayfa değişkeni yazar. Bilinmeyen ad block (CD-013); `$ad` `page_state`'te yoksa warn (CD-014, runtime `null` gönderir). Önizleme `$ad`'ı sayfa durumundan DOLDURMAZ:
|
|
800
|
-
`connect_data_preview { request: { params: { yil: 2026 } } }` verin — verilmezse null bağlanır, sonuç sessizce boş döner — ya da null'da filtresini düşüren workflow'da TÜM satırlar döner (39/05)
|
|
801
|
-
(CD-014 warn, sayfa değişkeninin başlangıç değerini önerir). Entity/view parametre almaz — filtre değerinde `$ad` kullanın.
|
|
802
|
-
- **Microservice'e çevirmek** (`connect_data_convert { …, name, slug }`, yalnız sayfa): tanım microservice'e taşınır, prop `{ version: 1, microserviceId }` olur; flow aynı veriyi `microservice_execute { body: { op: 'list' } }` ile alır. Çevrilmiş prop'u bind reddeder: önce `connect_data_detach` (başka yerde kullanılıyorsa 409).
|
|
803
|
-
|
|
804
|
-
Kuralların tamamı, uygulandığı yer ve kaynağıyla: `ngapps://rules/connect-data` (resource okuyamayan istemcide
|
|
805
|
-
`platform_guide({ resource: 'ngapps://rules/connect-data' })`).
|
|
806
|
-
|
|
807
638
|
## Kural 1c-2 — Komponentin `name`'i JS TANIMLAYICISI olmalı (yoksa sayfadaki tüm ifadeler ölür)
|
|
808
639
|
|
|
809
640
|
Runtime, ifade çalıştırmadan önce sayfadaki **her** komponent için bir değişken üretir:
|
|
@@ -853,10 +684,9 @@ Türkçe başlık `props.title` / `props.text` / `props.label` / `props.pageTitl
|
|
|
853
684
|
`isScrollable: true`, `appearance.heightType: 'auto'`). `container`, `form` ve `repeater` de aynı
|
|
854
685
|
şekilde kapsayıcıdır — onların içine de `parent` vererek eklenir.
|
|
855
686
|
|
|
856
|
-
Sayfa düzeyi olaylar (page load vb.) **bu kapsayıcıya
|
|
857
|
-
|
|
858
|
-
`page_container`
|
|
859
|
-
tasarımcıda hiçbir yerden bulunamaz. `page_container`'ın kendi `isLoading` prop'u vardır — sayfa açılış akışında yükleniyor bayrağı olarak
|
|
687
|
+
Sayfa düzeyi olaylar (page load vb.) **bu kapsayıcıya** bağlanır:
|
|
688
|
+
`set_event { target: 'page_container', event: 'mount', eventValue: <flow id> }`.
|
|
689
|
+
`page_container`'ın kendi `isLoading` prop'u vardır — sayfa açılış akışında yükleniyor bayrağı olarak
|
|
860
690
|
onu kullan. Bir `container` olduğu için **düzen prop'larını da alır**: çocuklarını ızgara yerine
|
|
861
691
|
akışla (ortalama, sağa yaslama, aralık) dizmek istiyorsan `layout: 'flex'` — Kural 1f-2.
|
|
862
692
|
|
|
@@ -899,10 +729,9 @@ gateway **PAGE-011 / LAY-004** ile istek gitmeden reddeder.
|
|
|
899
729
|
|
|
900
730
|
- Bağlama yolu `set_event` DEĞİLDİR (o komponent hedefler): sayfada `page_create` /
|
|
901
731
|
`page_update`'in `events` parametresi, layout'ta `layout_create/update`'in `events`'i.
|
|
902
|
-
-
|
|
903
|
-
|
|
904
|
-
|
|
905
|
-
"ayrılmadan kaydet" uyarısı gibi işler).
|
|
732
|
+
- Sayfa açılış akışı için yerleşik desen `page_container.mount`'tur (Kural 1d) — ikisi de
|
|
733
|
+
çalışır; **`destroy` için tek yol buradaki sayfa olayıdır** (interval temizliği, "ayrılmadan
|
|
734
|
+
kaydet" uyarısı gibi işler).
|
|
906
735
|
- Akış kilidi burada da geçerlidir (Kural 3): önce bütün `flow_create`'ler, sonra events bağı.
|
|
907
736
|
- Mevcut bağları `page_get` gösterir (`events[].value` = flow id).
|
|
908
737
|
|
|
@@ -1058,9 +887,8 @@ kullanır: `page.mappers.ts` `mapPageLayoutToPreview` — layout varsa çizilen
|
|
|
1058
887
|
>
|
|
1059
888
|
> Kural: **`isWrapper` yalnız gerçekten sayfa boyu kaplaması gereken kap içindir**
|
|
1060
889
|
> (`page_container` böyledir ve öyle kalmalı). Sadece "başlık/çerçeve çizilmesin" diye wrapper
|
|
1061
|
-
> yapma —
|
|
1062
|
-
>
|
|
1063
|
-
> `style` ile (`background:'transparent'`, `border:'none'`, `padding:0`). `form`'un eski `hideBorders`/`hidePadding` prop'ları
|
|
890
|
+
> yapma — o iş `container` için de `form` için de `style` ile yapılır (`background:'transparent'`,
|
|
891
|
+
> `border:'none'`, `padding:0`). `form`'un eski `hideBorders`/`hidePadding` prop'ları
|
|
1064
892
|
> 2026-09-09'da şemadan kaldırıldı — bileşen onları hiçbir zaman okumuyordu, no-op'tu. **`states` için micro-op
|
|
1065
893
|
> YOKTUR:** yanlış `isWrapper`'ı düzeltmenin tek yolu düğümü `remove_component` +
|
|
1066
894
|
> `add_component` ile yeniden kurmaktır (sonrasında Kural 2'deki flow yeniden kaydetme adımı
|
|
@@ -1257,9 +1085,8 @@ UYGULAMAZ** — koordinatları aynen kaydeder (aşağı itme yalnız `page_creat
|
|
|
1257
1085
|
> Ölçüm: `radio`, `textarea`, `container`, `form`, `button` **var**; `text` ve `multi-select`
|
|
1258
1086
|
> **yok**. Çözüm: gizlenecek komponenti `isHidden`'ı olan bir `container`'a sar ve koşulu
|
|
1259
1087
|
> sarmalayıcıya bağla (yukarıdaki `box_multi`). Sarmalayıcıyı **`isWrapper:false`** kur
|
|
1260
|
-
> (Kural 1f: wrapper = `min-height:80vh`) ve çerçevesini `
|
|
1261
|
-
> `
|
|
1262
|
-
> `style`'da kalır: `{ '&__body': { padding:'0px' } }`.
|
|
1088
|
+
> (Kural 1f: wrapper = `min-height:80vh`) ve çerçevesini `style` ile kapat:
|
|
1089
|
+
> `{ background:'transparent', border:'none', '&__body': { padding:'0px' } }`.
|
|
1263
1090
|
> `appearance.isHidden` diye bir alan YOKTUR (2026-09-15'te platformdan kaldırıldı, S-16) —
|
|
1264
1091
|
> görünürlük yalnız `props.isHidden`'dır.
|
|
1265
1092
|
|
|
@@ -1371,12 +1198,6 @@ yapmanın yolu budur — ölçülmüş kurallar (anket-doldur, 2026-08-19):
|
|
|
1371
1198
|
> düğümleri silip yeniden kurmaya, o da 20 setter'ın sessizce kopmasına yol açtı. Gateway artık
|
|
1372
1199
|
> kebab-case anahtarı camelCase'e çevirir ve `gatewayNormalized` ile bildirir; seçici anahtarlara
|
|
1373
1200
|
> (`&__body`, `:hover`, `--ng-*`) dokunmaz.
|
|
1374
|
-
>
|
|
1375
|
-
> **İSTİSNA — satır içi stil dalları (TB-129).** Kural `style` prop'unun emotion bloğu olan
|
|
1376
|
-
> dalları içindir. `table.style.thead|th|tr|td` ise DOM'un `style` attribute'una string olarak
|
|
1377
|
-
> basılır ve orada **kebab-case zorunludur**; gateway bu dört alanın altına 2026-09-20'den beri
|
|
1378
|
-
> hiç dokunmaz (`INLINE_STYLE_FIELDS_BY_TYPE`). `table.style.root` ve öteki komponentler eskisi
|
|
1379
|
-
> gibi çevrilir. Çeviri bu dalları da camelCase yapınca stil sessizce düşüyordu (S2-39).
|
|
1380
1201
|
|
|
1381
1202
|
**1. Temayı tek yerden çevir: `page_container.style` içinde `--ng-*` değişkenlerini ez.**
|
|
1382
1203
|
Runtime bütün renk/tipografi/form tokenlarını CSS değişkeni olarak basar
|
|
@@ -1536,20 +1357,6 @@ kullanacağını bilmek gereksiz CSS yazmayı önler:
|
|
|
1536
1357
|
| Şema prop'ları | yerleşim (`layout`/`direction`/`gap`/`gridColumns`), semantik renkler, boyut (`size`) | `replace_prop` |
|
|
1537
1358
|
| `style` prop'u | geri kalan her şey; iç seçiciler, pseudo-class, `--ng-*` token ezme | `replace_prop` / `set_binding` |
|
|
1538
1359
|
|
|
1539
|
-
**Kap seçimi — çerçeve tasarımdan gelir, kaptan değil.** `container`'ın tabanı kart yüzeyidir:
|
|
1540
|
-
tema her `container`'a 1px `--ng-border-primary` çerçeve verir. Salt düzen için açılan kaplar
|
|
1541
|
-
(satır, sütun, başlık şeridi, buton grubu, gövde/iki sütun kabuğu) bu yüzden ekranda iç içe
|
|
1542
|
-
çerçeveler olarak görünür — kullanıcı bunu hata olarak bildirdi (qm `qms-dokumanlar`,
|
|
1543
|
-
2026-09-30: başlık şeridi, buton grubu ve içerik sütunu çerçeveli çizildi).
|
|
1544
|
-
|
|
1545
|
-
1. Tasarımda o kutunun **çerçevesi yoksa `box` kullan** — `box`'ın tabanında çerçeve yoktur.
|
|
1546
|
-
2. `container` kullanmak zorundaysan (başlık bandı, `isLoading`, `page_container`, mevcut düğüm)
|
|
1547
|
-
çerçeveyi **`surfaceStyle` ile kapat**, `style`'a ham `border` yazma:
|
|
1548
|
-
`replace_prop { target, prop: 'surfaceStyle', value: { borderTop: 'none', borderRight: 'none', borderBottom: 'none', borderLeft: 'none' } }`.
|
|
1549
|
-
Tek yön kalacaksa (ör. ayraç çizgisi) yalnız o yönü boş bırak. Zemin de istenmiyorsa
|
|
1550
|
-
aynı gruba `background: 'transparent'`.
|
|
1551
|
-
3. Çerçeveyi yalnız tasarımda **gerçekten kart olan** kutu taşır (tablo kartı, özet kartı).
|
|
1552
|
-
|
|
1553
1360
|
**Dikkat — `appearance` kutunun İÇİNİ boyamaz.** Yüzey stili düğüm sarmalayıcısına
|
|
1554
1361
|
(`.ng-app__node-item`) yazılır; `box` gibi kendi zeminini çizen bir komponentin içi bundan
|
|
1555
1362
|
etkilenmez. Tipli stil modeline göçen komponentler bu boşluğu kapatır: `box` (ve emekli
|
|
@@ -1576,20 +1383,6 @@ bağlamında `page_runtime_get` → `theme.presets`; `componentStyles[type]` ref
|
|
|
1576
1383
|
Preset'in kendisini yazmak/silmek `theme_update` işidir — `platform_guide('theme')`. Bir alanı temaya bırakmak = o alanı hiç yazmamak;
|
|
1577
1384
|
studio'da bunun adı "Temaya dön"dür. Tema değerini gruba kopyalama — bağ kopar, tema değişince izlemez.
|
|
1578
1385
|
|
|
1579
|
-
**Yatay denge MÜREKKEPLE ölçülür, kutuyla değil (2026-09-29).** "Soldan sağdan eşit" bir
|
|
1580
|
-
düğme/çip/hap için iki kenardaki boşluk, elemanların kutusundan değil GÖRÜNEN çizgiden ölçülür:
|
|
1581
|
-
Material glifinin kendi yan boşluğu (~0.2em) vardır ve kutular eşitken ikon tarafı 3px daha
|
|
1582
|
-
geniş görünür. Rexora'da "Export Report" ve "Save Order" kutu ölçüsüyle 12/12 "eşit" raporlandı,
|
|
1583
|
-
kullanıcı iki kez "yazı sağa yapışmış" dedi. Kurallar:
|
|
1584
|
-
- `button` ikon + metinde dengeyi KENDİSİ kurar (ikon tarafını ~0.2em daraltır). Dolguyu
|
|
1585
|
-
değiştirmek için `style.padding` YAZMA — `!important` ile bu dengeyi ezer; `style:
|
|
1586
|
-
{ '--ng-btn-pad-x': '18px' }` yaz, iki taraf ondan türetilir.
|
|
1587
|
-
- Yuvarlak (pill) düğmede yatay dolgu yüksekliğin ~%35-40'ı olmalı; 44px'lik hapta 12px dar
|
|
1588
|
-
görünür (16-18px).
|
|
1589
|
-
- Kendi kurduğun çipte (container/html) ikon tarafını glif yan boşluğu kadar dar tut ya da
|
|
1590
|
-
simetrik bir öğeyle (avatar, nokta) başla. Doğrulama: `page_screenshot` + ölçü betiğinde
|
|
1591
|
-
glifin `measureText().actualBoundingBox*` değerleriyle mürekkep kenarı.
|
|
1592
|
-
|
|
1593
1386
|
**Efektif stili okumak:** `page_runtime_get(resolveStyles: true)` her düğüme `resolvedStyle`
|
|
1594
1387
|
(kaskad çözülmüş birleşik stil) ve `styleLayers` (`{ typedGroups, componentStyle, preset, own }`)
|
|
1595
1388
|
ekler. "Bu kutu neden böyle görünüyor / benim yazdığım stil neden görünmüyor" sorusunun cevabı
|
|
@@ -1609,7 +1402,7 @@ alanları silinir. Gateway bu yüzden `page_update`'te sayfayı önce okur, yaln
|
|
|
1609
1402
|
alanları değiştirip tam gövdeyi geri yazar (`layout_update` ve `component_update` de aynı).
|
|
1610
1403
|
Yine de `schema` parametresini elle doldurursan okuduğun hâli değil, **verdiğin liste** yazılır.
|
|
1611
1404
|
|
|
1612
|
-
**`page_update` sürümsüz yazmaz (PAGE-
|
|
1405
|
+
**`page_update` sürümsüz yazmaz (PAGE-039).** Platform sayfa PUT'unu `baseVersion` olmadan reddeder.
|
|
1613
1406
|
`baseVersion` vermezsen gateway bu sayfada en son gördüğü sürümü gönderir: `page_get` ya da
|
|
1614
1407
|
`page_schema_get` yanıtındaki `version`, `page_schema_patch`'in `newVersion`'ı ya da önceki
|
|
1615
1408
|
`page_update`'in yazdığı sürüm. Hiçbiri yoksa istek **gönderilmez** — önce oku. Sayfa o sürümden beri
|
|
@@ -1689,9 +1482,9 @@ Yanıttaki `touched`, kaydı değişen elementId'leri listeler (eklenen alt ağa
|
|
|
1689
1482
|
> (`children: [{ elementId, deferred: true }]`) ve sonraki kalemler onu doldurur. Toplanan düğüm sayısı
|
|
1690
1483
|
> `nodeCount`'a eşit değilse okuma eksiktir. Okuma arasında sayfa değişirse 409 — baştan başla.
|
|
1691
1484
|
> `allowTruncated:true` kırpılmış gövdeyi açıkça verir (`truncated: true`); o gövdeye dayanan
|
|
1692
|
-
> `page_schema_patch` PAGE-
|
|
1485
|
+
> `page_schema_patch` PAGE-038 uyarısı taşır. **`page_update`'e kırpık ya da yarım şema gönderme:**
|
|
1693
1486
|
> PUT tam REPLACE'tir, eksik düğümler geri dönüşsüz silinir — gateway düğüm eksilten şemayı
|
|
1694
|
-
> `allowNodeLoss:true` olmadan PAGE-
|
|
1487
|
+
> `allowNodeLoss:true` olmadan PAGE-037 ile reddeder.
|
|
1695
1488
|
|
|
1696
1489
|
> **`remove_component`'in yan etkisi — tek istisna.** Sayfa kaydedilirken artık hiçbir komponent
|
|
1697
1490
|
> olayının, prop'unun ya da sayfa olayının referans vermediği akışlar platformca **kalıcı olarak
|
|
@@ -1737,24 +1530,19 @@ patch'te bütün `set_event`'ler:
|
|
|
1737
1530
|
```
|
|
1738
1531
|
page_create → page_schema_patch (tüm add_component)
|
|
1739
1532
|
→ TÜM flow_create'ler
|
|
1740
|
-
→ TEK page_schema_patch (bütün set_event'ler)
|
|
1533
|
+
→ TEK page_schema_patch (bütün set_event'ler)
|
|
1741
1534
|
```
|
|
1742
1535
|
|
|
1743
1536
|
Sonradan akış eklemen gerekirse sayfayı baştan kurmana gerek yok — **bağı geçici olarak çöz**:
|
|
1744
1537
|
|
|
1745
1538
|
```jsonc
|
|
1746
|
-
1) page_schema_patch [{ "op":"set_event", "target":"
|
|
1747
|
-
page_update { events: [] } // sayfanın kendi mount/destroy bağları
|
|
1539
|
+
1) page_schema_patch [{ "op":"set_event", "target":"page_container", "event":"mount", "eventValue": null }]
|
|
1748
1540
|
2) flow_create × N
|
|
1749
|
-
3) page_schema_patch [ bütün set_event'ler tek seferde ]
|
|
1541
|
+
3) page_schema_patch [ bütün set_event'ler tek seferde ]
|
|
1750
1542
|
```
|
|
1751
1543
|
|
|
1752
1544
|
`eventValue: null` olay kaydını bırakıp değerini boşaltır ve kilidi açar.
|
|
1753
1545
|
|
|
1754
|
-
> Ölçüm 2026-09-25 (`egitim-portali` › `surecler`, Studio'nun `POST pages/<id>/flows` çağrısı):
|
|
1755
|
-
> sayfada `page_container.mount` ve komponent olayları bağlıyken yeni akış **reddedilmeden**
|
|
1756
|
-
> oluştu. Kilit artık her durumda devrede olmayabilir; yine de sıralı kuruluş güvenli yoldur.
|
|
1757
|
-
|
|
1758
1546
|
> **Aynı kilit LAYOUT'ta da vardır** (ölçüm 2026-08-18: menüye yeni bağlantı eklerken
|
|
1759
1547
|
> `POST /layouts/<id>/flows` aynı hatayı verdi). Layout'ta sıra sayfadakiyle aynıdır ve bağlar
|
|
1760
1548
|
> `layout_schema_patch` ile yazılır: `flow_create × N` → TEK `layout_schema_patch` (bütün
|
|
@@ -1847,25 +1635,6 @@ Tercih kuralı: *"bu değer başka bir değerden TÜRETİLİYORSA"* `set_binding
|
|
|
1847
1635
|
*"bir OLAY sonucunda bir kez yazılacaksa"* (uçtan veri çekme gibi) flow + setter kullan.
|
|
1848
1636
|
İkisini aynı prop'ta karıştırma — setter'ın yazdığı değeri canlı bağ bir sonraki tetikte ezer.
|
|
1849
1637
|
|
|
1850
|
-
**Designer'da da görünsün: varsayılan değer kur (2026-09-29).** Studio kanvası akış
|
|
1851
|
-
koşturmaz; `type:'code'` prop'larını tasarım anında `state.page.*` / `state.app.*`
|
|
1852
|
-
değişkenlerinin **varsayılan değerleriyle** çözer (Rexora dashboard: KPI'lar, grafikler ve
|
|
1853
|
-
metinler önce `{{ state.page… }}` ham metni olarak görünüyordu). Kural: tasarımcıya boş kutu
|
|
1854
|
-
bırakma, kanvasta da view'daki içeriğin aynısı görünsün.
|
|
1855
|
-
- Veriyi akışla (microservice → setter) yüklesen bile, bağlanan şeklin **gerçekçi bir
|
|
1856
|
-
örneğini** `variable_create` ile sayfa değişkeni olarak kur ve prop'u ona bağla — view'da akış
|
|
1857
|
-
değeri ezer, kanvasta örnek görünür.
|
|
1858
|
-
- Kanvasta çözülmeyen ifadeler: `item.*` (repeater satırı), `Functions.*`, komponent adları ve
|
|
1859
|
-
`Steps.*`. Bunları taşıyan prop'a `data` alanında tasarım değeri ver (metin olmayan prop'larda
|
|
1860
|
-
kanvas `data`'yı çizer); metin prop'u çözülmeyen ifadeyi ipucu olarak gösterir, bu yüzden
|
|
1861
|
-
metni mümkünse `state.page` üzerinden besle (`{{ state.page.summary.totalText }}`).
|
|
1862
|
-
- `repeater`'ın `rows`'u statik ya da `state.page`'e bağlı olsun; kanvas tek satırı şablon
|
|
1863
|
-
olarak çizer.
|
|
1864
|
-
- Yer tutucu boşluk için BOŞ `container` kurma, `spacer` kullan. Boş kap kanvasta bırakma
|
|
1865
|
-
alanı olarak ~130px yükseklik alır ve bulunduğu satırı şişirir (Rexora New Order: tablo
|
|
1866
|
-
başlık satırı designer'da 148px, view'da 38px). Satırda yatay boşluk: `spacer` +
|
|
1867
|
-
`mode:'fixed'` + `size: 0` + `appearance.widthType:'fixed'` / `widthString:'32px'`.
|
|
1868
|
-
|
|
1869
1638
|
**`stateBindings[]` (şema düğümündeki dizi)** Studio'nun state-bağımlılık özelliğidir:
|
|
1870
1639
|
`[{ name, expression, targets: [{ elementId, elementProperty }] }]` — bir ifade değişince
|
|
1871
1640
|
listedeki hedef prop'lara yazılır. Micro-op sözlüğünde karşılığı YOKTUR; yalnız
|
|
@@ -1980,8 +1749,7 @@ ya da `set_binding { prop: 'isHidden' }` (Kural 7a'daki `isHidden` notu).
|
|
|
1980
1749
|
|
|
1981
1750
|
**Kip ayrımı query parametresidir:** aynı sayfa `?id=<kayıt>` ile edit, parametresiz create.
|
|
1982
1751
|
|
|
1983
|
-
`mount` akışı (
|
|
1984
|
-
`page_container`'a değil, Kural 1d-2):
|
|
1752
|
+
`mount` akışı (`page_container` ya da `form` üzerine bağlanır):
|
|
1985
1753
|
|
|
1986
1754
|
```
|
|
1987
1755
|
start → [setter] page_container.isLoading = true
|
|
@@ -2156,7 +1924,7 @@ start → [setter] btn.isLoading = true, btn.isDisabled = true, notification giz
|
|
|
2156
1924
|
```
|
|
2157
1925
|
|
|
2158
1926
|
- **`sign-in` adımının `error` dalı burada ZORUNLUDUR, süs değil.** Dal bağlı değilken bu şablonun
|
|
2159
|
-
`condition`'ı `Steps.signIn.data.token`'ı okur ve gateway'i **FLOW-
|
|
1927
|
+
`condition`'ı `Steps.signIn.data.token`'ı okur ve gateway'i **FLOW-028** ile uyarır (yukarıdaki
|
|
2160
1928
|
"Hangi yolu seçeceksin" notu): hata anında `data` `null`'dur, token okuması sessizce `undefined`
|
|
2161
1929
|
döner. Dal bağlanınca hata onun üzerinden sürer — `always`/`condition` yalnız BAŞARIDA çalışır,
|
|
2162
1930
|
yani `data.token` orada gerçek bir iş kuralıdır (uç 200 dönüp token'sız yanıt verirse), hata
|
|
@@ -2356,7 +2124,7 @@ hiçbiri** bağlı değildi; üç portalın da rol menüsü boş çıkıyor, pan
|
|
|
2356
2124
|
> dönünce `data` **null**'dur ve bu adım boş veriyle koşar — `rows` gibi bir listeye bağlarsan
|
|
2357
2125
|
> bileşen `null`'ı boş liste sayar, `Array.isArray(...) ? ... : []` sarmalamaya artık gerek yok.
|
|
2358
2126
|
> Hata OLDUĞUNU fark etmeden geçmemek için `error` dalı bağlayın (yukarıdaki §"4xx de hatadır",
|
|
2359
|
-
> gateway bunu bağlı değilken **FLOW-
|
|
2127
|
+
> gateway bunu bağlı değilken **FLOW-028** ile uyarır); hata gövdesini görmek istiyorsan
|
|
2360
2128
|
> `Steps.x.error.body`'yi okuyun.
|
|
2361
2129
|
|
|
2362
2130
|
## ⚠️ `page_schema_patch` `html` komponentini reddediyor — katalogda mükerrer kayıt (2026-08-19)
|
|
@@ -2445,19 +2213,6 @@ micro-op hattına dönün.
|
|
|
2445
2213
|
> alınır, veri kaybı yok); yalnız başka bir akışın adımından çağrılan (olaya bağlı olmayan) akışlar
|
|
2446
2214
|
> geri kurulmaz — onlar için `flow_restore`.
|
|
2447
2215
|
>
|
|
2448
|
-
> **Koruma op listesinin SONUCUNA bakar (TB-125).** İstek atomik olduğu için doğru soru tektir:
|
|
2449
|
-
> yama bittiğinde bu akışa referans kalıyor mu? Aynı yamada akışı başka bir düğüme bağlayıp
|
|
2450
|
-
> eskisini silmek (`add_component` + `set_event` + `remove_component`) artık TEK çağrıda geçer;
|
|
2451
|
-
> 2026-09-20 öncesinde koruma her op'a tek başına baktığı için düğüm taşıyan her yama ikiye
|
|
2452
|
-
> bölünmek zorundaydı (S2-35). Akışı gerçekten referanssız bırakan yama hâlâ durur.
|
|
2453
|
-
>
|
|
2454
|
-
> **Satır aksiyonları statik şemada görünmeyebilir (TB-126).** `table`/`datatable`'ın
|
|
2455
|
-
> `actions[].flow` bağı `{ type: 'flow', ref }` olarak sayılır — ama bu prop'u çoğu zaman YÜKLEME
|
|
2456
|
-
> AKIŞI çalışma zamanında yazar (aksiyon role göre eklenip çıkarılıyorsa başka yolu da yok) ve o
|
|
2457
|
-
> hâlde şemada `actions` BOŞ durur. `flow_list` böyle bir barındırıcıda `unboundFlowIds` yanına
|
|
2458
|
-
> `mayBeBoundAtRuntime: true` koyar: "bağsız akışları temizle" refleksinden önce akışın gerçekten
|
|
2459
|
-
> sahipsiz olduğunu doğrulayın (S2-36).
|
|
2460
|
-
>
|
|
2461
2216
|
> **FLOW-018 artık silinen düğümün ALT AĞACINI da görüyor.** Eskiden yalnız op'un kendi
|
|
2462
2217
|
> `target`'ına bakılıyordu: bir kapsayıcı silinince ÇOCUĞUNA yazan setter sessizce kopuyor ve
|
|
2463
2218
|
> uyarı hiç çıkmıyordu (09-05, `sign_in_form` → `btn_sign_in`).
|
|
@@ -2553,13 +2308,6 @@ micro-op hattına dönün.
|
|
|
2553
2308
|
elemanıdır; başlığı da `__header` bloğunu da render etmez (klinik ölçümü: `__header` sayısı 0).
|
|
2554
2309
|
`isWrapper: false` olan ve başlığı açıkça verilen kapta başlık normal çizilir. Kart başlığını garantiye almak istiyorsan kabın
|
|
2555
2310
|
`title`'ına güvenme, **içine bir `text` komponenti** koy.
|
|
2556
|
-
- **`selectedRow`'un ALANLARI sarmalı korur.** `tbl.selectedRow` prop olarak çözülür ama içindeki
|
|
2557
|
-
alanlar `{data, type}` nesneleri olarak kalır: `mapSchemaPropToRawProp` yalnız üst düzey prop'u
|
|
2558
|
-
açar, satırın iç alanlarını açmaz. `tbl.selectedRow.id` bu yüzden bir **nesnedir**, ham değer
|
|
2559
|
-
değil — uca öyle gidince güncelleme hiçbir satırı tutmaz ve sonuç sessizdir (ölçüldü 2026-09-19:
|
|
2560
|
-
`PUT kredi-onayla` → **404**). İfadede `tbl.selectedRow?.id?.data ?? tbl.selectedRow?.id` yazın;
|
|
2561
|
-
aynısı satır eşlemesinden gelen her alan için geçerlidir (S-22).
|
|
2562
|
-
|
|
2563
2311
|
- **Kod prop'unun ifadesi `ref`'te ve `{{ }}` sarılı olmalı.** `{type:'code', ref:"'' + Row.value"}`
|
|
2564
2312
|
(süssüz) ekrana ifadenin **kendisini** basar; ifade yalnız `data`'da olursa prop **boş**
|
|
2565
2313
|
render edilir. `set_binding` micro-op'u eski sürümlerde `data`'ya yazıyordu — bu davranış
|