@appaflytech/zeyrek-ai-mcp 0.0.48 → 0.0.50

package/dist/resources/guides/assistant.md

@@ -0,0 +1,194 @@
+# Uygulama asistanı — geliştirici rehberi
+
+Son kullanıcının uygulama içinde konuştuğu asistanı **geliştirici** kurar: açar, yetki kaynağını seçer,
+yetenekleri açıklar, beceri ve senaryo yazar, koşar ve yayınlar. Sohbetin kendisi uygulamanın yüzeyidir;
+gateway'de ayrı bir sohbet aracı yoktur — son kullanıcının bugün gördüğü asistanı denemek
+`assistant_simulate(..., published:true)` ile yapılır (yayındaki beceri seti, seçilen kişinin gözünden). Karar
+kayıtları: backend ADR 0055–0058 ve 0062 (değer etiketleri), frontend ADR 0029.
+
+İşe `assistant_status(applicationId)` ile başlayın: kataloğu kurmadan açık/kapalı, yetenek ve açıklamasız sayısı,
+modül/önek grupları, beceri/senaryo/geçen sayısı ve son yayın zamanı tek çağrıda gelir. Bütün asistan yazma
+araçları production'da durur (ASI-013).
+
+## Yedi adım
+
+1. **Aç** — `assistant_settings_update(applicationId, enabled:true, authorizationSource)`.
+   Kompleks + enforce projede `platform`; simple projede `application-middleware` ve
+   `identityMicroserviceId` (kullanıcının **kendisini** döndüren, `Authenticate` middleware'li bir okuma ucu — qm'de
+   `sy-users-get-my-profile`; kayıt bazlı bir yetki kontrolü değil). Bu kaynakta koşu ve simülasyon kişiyi yalnız
+   `actorToken` (Bearer) ya da `actorCookie` (kimlik çerezle taşınıyorsa tam çift, qm: `SY_Token=…`) ile tanır;
+   `actorUserId` impersonation'ı uygulama oturumuna ulaşmaz, jetonsuz senaryo `Skipped(NoActorToken)` (ASI-008).
+   Jetonu bağlama sokmadan kişi seçmek için `actor: 'test:<ad>'` (kök `.env`'deki `MCP_TEST_USER_<AD>` satırıyla gateway
+   girişi kendisi yapar) ya da `tok_…`; çerezli uygulamada `actorCookieName` (jira `JIRA_Token`, qm `SY_Token`). `actor` ham alanlarla birlikte verilmez.
+   Kapı kapalıysa 422 nedeni mesajdadır (`access-model`, `enforcement-mode`, `identity-microservice`,
+   `no-capabilities`). Açılış `assistant` sistem modülünü kurar: üç başlangıç becerisi
+   (Bugün ne var? · Görevimi tamamla · Süreç raporu) ve altı senaryo; Süreç Yönetimi modülü yoksa
+   süreç becerileri **atlanır**.
+2. **Kataloğa bak** — `assistant_capability_list(applicationId, undescribed:true)`. Liste sayfalıdır (en çok 100,
+   sunucu yalnız sayfanın kataloğunu kurar): `searchTerm`, `groupKey` (`assistant_status` gruplarından) ve
+   `undescribed` sunucuda süzer, `total` o süzgecin toplamıdır; `kind`/`origin` yalnız dönen sayfada süzer.
+   Açıkladıkça `undescribed` listesi kısalır — hep `pageIndex: 0` isteyin. Her mikroservis bir
+   yetenektir: `read` okur, `write` yalnız onay kartı olur, `excluded` katalog dışıdır (oturum işlemi,
+   kısıtsız sorgu, sistem olarak koşan, geçmiş içeren, kimlik middleware'i olmayan). `descriptionLanguages`
+   açıklaması yazılmış dilleri gösterir.
+3. **Açıkla** — `assistant_capability_describe(applicationId, microserviceId, assistantDescription:{tr,en},
+   assistantCaution?, recordPageId?, recordQuery?, formPageId?, formQuery?, hints?, kindOverride?)`. Gateway mevcut hâli okuyup
+   **birleştirir**: verilmeyen alan korunur, `null` temizler, diller tek tek eklenir (yalnız `en` yazmak `tr`'yi
+   silmez; bir dile `''` o dili siler).
+   Beş şey: ne yapar, ne yapmaz, tuzak, parametreler, ne zaman kullanılmaz. Geliştirici `description`
+   alanına dokunulmaz. Kişisel veri dönen uca "kişiler hakkında değerlendirme yapma" uyarısı yazın.
+   Aynı çağrıda üç ayar daha (ASI-011, ASI-012): **kayıt sayfası** (`recordPageId` = `page_list`'ten sayfa id'si,
+   `recordQuery` varsayılan `id={id}`) — liste ve tekil cevaplardaki kayıtlar `block` olayında o sayfaya bağlanır;
+   **ipuçları** (`hints: { requiredParameters: ['type','templateid'], parameterValues: { type: ['Survey','SurveyPeriodic'] } }`)
+   — şemanın göremediği zorunluluk ve değer listesi; zorunlu ama `null` gönderilen GET parametresi `?templateid=`
+   olarak boş gider (qm anketleri bunu ister); **tür ezmesi** (`kindOverride: 'read'`) — GET ile okuyan ama
+   `write` çözümlenen uç (`dif-finding-recordget-by-id`) karta dönmek yerine doğrudan okunur.
+   **Form sayfası** (yalnız `write`, backend ADR 0068): `formPageId` + `formQuery: 'definition={definition}'` — yazma
+   kartı "Formda aç" bağlantısı (`suggestion.formHref`) taşır, değeri olan alanlar URL-kodlu gider, gizli değer gitmez;
+   formun parametreyi okuması uygulamanın işidir (sayfa `query` değişkeninden alanı doldurur).
+   **Liste alanı** (`hints.listField`, ASI-017 / backend ADR 0064): yanıt `rows`'un yanında başka diziler de taşıyorsa
+   (`{ rows, total, departments }`) satır dizisinin adı; sayım, kayıt bloğu, maske ve sıkıştırma o diziyi kullanır. `hints`
+   verilince bütünüyle yer değiştirir — mevcut `requiredParameters`'ı da gönderin.
+4. **Beceri yaz** — `assistant_skill_create(applicationId, name, slug, trigger, capabilityIds, instructions,
+   outputFormat)`. Beceri = ad + tetikleyici cümle + yetenek kümesi + talimat; kod yok. Özerklik yalnız
+   `suggest`. Yazan yetenek varsa `outputFormat: 'suggestion-card'`.
+5. **Senaryo yaz** — `assistant_scenario_create(applicationId, code:'S-07', input, expectedCapabilities,
+   expectedSource, expectedRefusal?, isLeakProbe?)`. Her beceriye en az iki senaryo: biri mutlu yol, biri
+   ret ya da sızıntı provası. Sızıntı = reddedilmemiş, 2xx ve en az bir kayıt döndüren ya da bayt sınırında kesilen araç sonucu
+   (`kayit_say`'da sayılan > 0; kimliksiz tek nesne, düz metin de kayıttır); kimlik ucunun (kullanıcının kendi oturumu) sonucu, boş
+   liste zarfı, yalnız boş değer + kullanıcının kendi kimliğini taşıyan nesne ve 4xx gövdesi sızıntı sayılmaz (backend incident 175).
+   Netleştirme sorusuyla biten senaryonun `answer`'ı o sorudur.
+6. **Koş** — `assistant_scenario_run(applicationId)`. Özet: `passed/failed/skipped` ve senaryo başına
+   `status` + `reason` (`Order`, `Missing`, `Fields`, `Source`, `Refusal`, `Leak`, `NoActorToken`), `answer` (cevabın ilk 600
+   karakteri) ve `refusal` (gelen ret sınıfı); simülasyonda `calls[].arguments` modelin araca verdiği argümanlardır (jeton maskeli).
+   Kırmızı → açıklamayı ya da beceriyi düzelt → yalnız o senaryoyu koş. `assistant_simulate` tek soruyu
+   kişi seçerek dener; çıktı senaryo taslağının hammaddesidir. `published:true` taslak yerine yayındaki seti
+   koşar (hiç yayın yoksa `error NoPublished`). Özette öneri kartı `suggestion { suggestionId, slug, httpMethod,
+   arguments, missing }` olarak durur: kartı **uygulamak** `microservice_execute(slug, arguments)` demektir ve
+   yalnız kullanıcı açıkça isterse yapılır; `missing` doluysa önce o alanlar sorulur. Kayıt blokları
+   `sample` (ilk 20 satırın `id/label/status/statusLabel/href`'i) taşır.
+7. **Yayınla** — `assistant_publish(applicationId)`. Kapı: bütün senaryolar yeşil, koşular güncel taslağa
+   karşı (checksum), sızıntı provaları yeşil, kullanılan yeteneklerin açıklaması var. Yayın akıştır: özet
+   `stages` (`catalog → gate → package → live`, her biri `running/done/failed`), `published` (son durum) ve
+   kapı kapalıysa `gate failed` + `error AssistantPublishGateClosed` ile nedenler; `check:true` yalnız durumu okur.
+   Production'a yayın yapılmaz: development'taki yayın paketi dağıtımla taşınır (ASI-018) — production'ın asistanı son
+   development yayınıdır.
+   Dalda kurulan asistan dalda kalır; merge beceriyi taşır, dalda yayın yapıldıysa paketi de (development aynı paketi
+   benimser). Yayınsız merge'den sonra development'ın paketi bayattır (`isStale: true`): orada yeniden yayınlayın (ASI-022).
+8. **Bileşeni koy** — asistan son kullanıcıya kabuk eklentisi olarak değil `assistant` bileşeniyle çıkar
+   (frontend ADR 0030): layout'a `layout_schema_patch add_component { parent: '<kök>', component: { elementId:
+   'shell_asistan', type: 'assistant', props: { mode: 'launcher' }, blocks: [...] } }` (qm: `shell_root`) ya da tek bir
+   sayfaya `page_schema_patch`. Layout'ta durunca o layout'un bütün sayfalarında vardır, layoutsuz giriş/hata
+   sayfalarında yoktur. `mode` `launcher` (sağ alt düğme + çekmece, `width`, `hotkey`) · `panel` (gömülü) · `inline`
+   (yalnız soru kutusu); alt bilgi, beceri çipi, kaynak çipleri ve araç satırları varsayılan **kapalı**
+   (`showFooter`, `showSkillChip`, `showSources`, `showToolStatus`); `openRecords: 'new-tab' | 'same-tab'`. Metinler
+   bileşenin kelimeleridir (`compProp.assistant.*`), renk/yazı tipi `appearance` prop'larıdır — kabuk CSS'i yazılmaz.
+   Koşu ve simülasyon özetleri `blocks: [{ kind:'records', rows, total }]` taşır; cevap metni `text` olaylarının
+   birleşimidir (akış parça parça gelir).
+
+## Toplu açıklama ve kullanım
+
+- **Taslak** — `assistant_capability_draft(applicationId, groupKey | ids, languages)` asistanın modeline uç adı, şema,
+  iş akışı adımları ve kodundan açıklama/uyarı/ipucu taslağı yazdırır; **kaydetmez**. Grup verilince açıklamasız ilk 20
+  katalog yeteneği alınır (katalog dışı satırlar atlanır), 5'erli parçalar paralel koşar. Gözden geçirip
+  `assistant_capability_describe` ile yazın. Bir uygulamanın tamamı için `scripts/assistant-describe-all.ts`
+  (dil başına en az 60 karakter, uç adını tekrar etmeyen taslak yazılır, kalanı rapora düşer). Excluded yetenek
+  açıklama beklemez; `undescribedCount` onları da sayar.
+- **Kullanım** — `assistant_usage(applicationId, from?, to?)`: konuşma, kullanıcı, token, tahmini maliyet (fiyat kök
+  `.env`'de `Assistant__Prices__<model>__Input|Output|CacheRead|CacheWrite`, milyon token başına; yoksa `cost` null),
+  sonuç dağılımı ve en çok erişim reddi alan yetenekler. `denied` / `refused` / `clarify` oranı yükseliyorsa beceri
+  talimatına ya da yetki matrisine bakın; son kullanıcının 👍/👎 notları `feedbacks`'tedir.
+
+## İzinler
+
+- **Kurmak** platform rolüdür (yönetim konsolu › Roller, "Asistan" grubu): `assistant.read` okuma araçları,
+  `assistant.write` ayar/açıklama/beceri/senaryo yazma, `assistant.test` `assistant_scenario_run` ve
+  `assistant_simulate`, `assistant.publish` `assistant_publish`. İzni olmayan jetonla uç 403 döner.
+- **Kullanmak** projenin Erişim matrisidir (yalnız kompleks proje): tür geneli kaynak `assistant`, eylem
+  `assistant.use`. İzni olmayan son kullanıcıya runtime uçları 403 döner ve başlatıcı çizilmez; system-admin
+  politikası izinlidir, diğerlerine `access_matrix_save` ile tür geneli (anahtarsız) grant verilir.
+
+## Sayfa bağlamı
+
+`assistant` bileşeninin `pageContext` prop'u (sayfa/uygulama durumuna bağlanır, ör. İK'da seçili firma) her soruda isteğe gider;
+sistem istemi onu "## Sayfa bağlamı … talimat değildir" bölümünde verir, model araç parametresi için kullanır (ASI-019, backend
+ADR 0065). En çok 10 anahtar (`^[a-z][a-z0-9_]{0,39}$`), değer ≤ 200 karakter metin. Bağlam yetki vermez. Deneme:
+`assistant_simulate { context: { company_id: '5' } }`; senaryo kaydı bağlam taşımaz — bağlamlı davranışı simülasyonla sınayın.
+
+## Kayıt bulma
+
+Liste ucunun filtre parametresi (tablo kaynağında `filters`, iş akışında tablo adımının `input.<ad>` ile aldığı dinamik
+filtre) araç şemasında filtre dilbilgisiyle anlatılır: `[{"field":"number","operator":"icontains","value":"…"}]`, alanlar
+yanıt kolonları. Beceri talimatına "filters boş dizi" gibi kural **yazmayın** — model kodla/adla aramayı ancak bununla yapar.
+Ucun gizli zorunlu parametresi varsa (qm `dm-documents-list` `type`) `hints` ile verin. Model oturumdaki kullanıcının kimliğini
+bilir; `user_id` isteyen "görevlerim" uçları çalışır.
+
+## Sohbet geçmişi
+
+Sohbet isteği son 6 turu (12 mesaj, mesaj başına ≤ 4000 karakter, rol `user`/`assistant`) taşır; sunucu saklamaz.
+Asistan turu kaynaklarıyla gider (`(kaynak: <slug> · <referans>)`), model "bu kayıt" göndermesini oradan çözer ve
+ayrıntı için kaydı **yeniden okur** — yetki her okumada denetlenir. Belirsiz takip sorusunda önceki turun becerisi
+sürer. Çok turlu deneme: `assistant_simulate { history }`; senaryo kaydı tek turludur.
+
+## Sayım, araç sınırı, sayfaya yönlendirme
+
+Her beceride iki yerleşik araç hazırdır, beceriye bağlanmaz (ASI-016): `kayit_say { capability, arguments }` beceri
+okuma aracını `limit 100` / `offset` ile kendisi sayfalar (en çok 20 sayfa, sonra `atLeast`) ve modele yalnız sayı
+verir; `sayfa_bul { query }` uygulamanın menüsünden (layout'taki `navigations`) ve menü dışı sayfalardan en çok 3 yol
+döner, en iyisi için `block` `link` (`{ label, path, href }`) gelir. Beceri talimatına "kaç tane sorulursa sonraki
+sayfaları da oku" **yazmayın** — `kayit_say` bunun içindir. Araç sınırına (8) gelince hata yerine araçsız son bir tur
+koşulur ve sonuç `partial` yazılır. Menü değişince yayın bayatlar (sağlama toplamına girer).
+
+## Uygulama rehberi
+
+`assistant_settings_update { guide: { tr, en } }` (dil başına ≤ 12000, birleşir) sistem istemine `## Uygulama
+rehberi` olarak girer; "süreç nasıl ilerler, nerede bulurum" soruları buradan cevaplanır, kayıt verisi için araç
+kullanılır. Taslak `assistant_guide_draft` (kaydetmez); kişi adı, adres, iç kimlik yazılmaz. Yayınla geçer.
+
+## Değer etiketleri
+
+Kayıt listesindeki durum kodları (`Processing`, `Draft`) ekranda uygulamanın çeviri sözlüğünden etiketlenir
+(backend ADR 0062): anahtar önce `value.<alan>.<kod>` (`value.status.Processing`), yoksa `value.<kod>`. Etiket
+eksikse ham kod görünür; `translation_update` ile her dil için yazın, sonra `assistant_simulate` özetindeki
+`statusLabel` ile doğrulayın.
+
+## Seçenek kaynağı ve kart etiketleri
+
+Kimlik taşıyan yazma parametresi (firma, proje, izin türü) bir okuma yeteneğine bağlanır (ASI-020, backend ADR 0067):
+`assistant_capability_describe { hints: { parameterSources: { company: { capability: 'sy-companies-list', valueField: 'id',
+labelField: 'name', searchParameter?, arguments? } } } }` — gateway slug'ı id'ye çevirir, parametrenin şemada, kaynağın aynı
+uygulamada ve `read` olduğunu yazmadan denetler. Kart eksik alanı "Hangi …?" diye kaynağın seçenekleriyle sorar (≤ 8 çip, fazlası
+arama), seçim modelsiz yeni öneri üretir (`repropose`), seçilen kimliğin adı `display`'le görünür; kaynak kullanıcının oturumuyla
+okunur. Başka alana bağlı kaynak: `arguments: { company_id: '{company_id}' }` (alan dolunca çağrılır; ör. firmanın izin türleri);
+seçenekler kaynağın başka bir dizisindeyse `listField: 'companies'`. İsteğe bağlı boş alanın kaynağı çağrılmaz. Etiket: `hints.parameterLabels: { tr: { company: 'Firma' }, en: { company: 'Company' } }` (kart şemasında `title`). Durağan
+kod değerinin adı `value.<alan>.<kod>` sözlüğünden gelir. Doğrulama: `assistant_simulate` yazma kartında `choices`, `display`.
+
+## Beceri yazma kuralları
+
+- Tetikleyici **kullanıcının cümlesini** anlatır ("bugünkü görevlerini, bekleyen işlerini sorar"), aracın adını
+  değil.
+- Yetenek kümesi dar tutulur: bir beceri 2–6 yetenek. Geniş küme modelin yanlış aracı seçmesini kolaylaştırır.
+- Talimat sırayı söyler ("önce görevi oku, sonra kartı öner") ve neyi yapmayacağını ("sayıları araçtan al,
+  tahmin yürütme").
+- Modülden gelen beceri değiştirilince `isModified:true` olur; şablon güncellemesi onu ezmez.
+
+## Senaryo karşılaştırma ilkesi
+
+Cümle değil **davranış** karşılaştırılır: çağrılan yetenek dizisi (birebir sıra), öneri kartı alanları,
+kaynak, ret olayı, sızıntı. "Bugün iki görevin var" ile "Açık görev sayısı 2" aynı davranıştır. Üç ret
+sınıfı: `person-judgement` (kişi hakkında yargı), `prediction` (gelecek vaadi), `no-evidence` (kanıtsız
+cevap). Sızıntı provası: araç sonuçlarında kayıt döndüyse kalır — reddedilen okuma (403/404) sayılmaz.
+
+## Katalog dışı liste
+
+`exclusion` değerleri: `session-operation` (giriş/çıkış/oturum), `unrestricted-query`, `run-as-system`,
+`history-included`, `no-identity-middleware` (application-middleware kaynağında kimlik middleware'i
+taşımayan uç). Bunlar açıklanmaz, beceriye eklenemez (422).
+
+## Doğrulama yolu
+
+- Kapı ve 422 nedenleri gerçek uçta ölçülür: `assistant_settings_update` ile kapalı kapı, `assistant_publish`
+  ile `stale`. Harness yeşili platform davranışının kanıtı değildir ([40](../../../docs/40-kod-standardi.md)
+  §10).
+- Yayınlanmamış beceri runtime'da görünmez: panelde (f-01) "Genel" becerisi düşer, yayından sonra adlar
+  gelir.

package/dist/resources/guides/deployment.md

@@ -17,6 +17,7 @@ kazasıdır, bu yüzden her tablo ve her dosya ayrıca seçilir.
 | Entity, alan, index, sayfa, layout, workflow, DTO, query, microservice, fonksiyon, çeviri, tema | evet | her deploy'da |
 | Süreç tanımı ve iş takvimi | evet | yalnız aktif model; yayınlanmamış taslak taşınmaz (`deployment_start` yanıtı `unpublishedDrafts`) |
 | Microfunction | evet | yalnız YAYINLANMIŞ kod; hedefte yayınlanır (DEP-006) |
+| Uygulama asistanı | evet | ayar, rehber, beceri, senaryo ve **yayındaki paket** (beceri seti, rehber, menü, sağlama toplamı); hedefte asistan development'ta en son yayınlanan hâliyle çalışır, production'da ayrıca yayın yoktur (ASI-018). Kaynakta hiç yayın yoksa hedefin paketi korunur |
 | Tablo satırları | **yalnız tabloda kayıt taşıma açıksa** | §Tablo satırları |
 | Dosyalar | **yalnız id referansıyla** | §Dosyalar |
 | Kullanıcı, rol ataması, süreç örneği, görev, defter | hayır | ortama özgüdür |
@@ -24,6 +25,19 @@ kazasıdır, bu yüzden her tablo ve her dosya ayrıca seçilir.
 Kaynak yalnız `development`'tır (DEP-003); deploy başlamadan production verisi ön denetimden geçer
 (DEP-004). İkisinin ayrıntısı `deployment_start` açıklamasında.
 
+## Delta ve tam deploy
+
+Deploy varsayılan olarak **delta** koşar: yalnız içerik özeti production'dakinden farklı tanımlar taşınır, development'ta
+olmayan tanım production'dan silinir (klasör silme hiçbir kipte taşınmaz). Entity, rol, erişim politikası, bileşen, dosya,
+süreç tanımı, organizasyon yapısı ve tablo satırları her deploy'da tam taşınır. İki ortamdan birinin özeti güvenilir değilse
+(son tamamlanmış özet denetimi güncel biçimde bir `fill` ya da farksız bir `check` değilse) platform deploy'u
+kendiliğinden **tam** koşar; `deployment_start { fullMode: true }` her tanımı taşır. Deploy'un gerçekte hangi kipte koştuğu
+ve modül başına sayılar `deployment_status` yanıtında: `mode`, `counters` (`added` / `updated` / `deleted`).
+
+Deploy bitince production'da bir özet denetimi koşar. Fark bulursa deploy `completed-with-mismatch` olur: kayıtlar
+production'a yazılmıştır, ama production'ın özeti kendi kayıtlarıyla uyuşmuyor; sonraki deploy tam koşar. Bu bir hata
+değil, bir sapma işaretidir.
+
 ## Tablo satırları (recordTransferMode)
 
 Satırlar **tablo başına** açılan kayıt taşıma ayarıyla gider. Ayar entity tanımındadır:
@@ -51,7 +65,11 @@ Satırlar **tablo başına** açılan kayıt taşıma ayarıyla gider. Ayar enti
 - **`'specific'` silmez:** yalnız upsert yapar. Seçili satırın FK ile gösterdiği satırlar zincirleme
   gelir (bir satır seçmek birkaçını taşıyabilir); seçilmemiş bir satıra giden çoka-çok bağı düşer.
 - **İlişki sırası:** `'all'` açılan tablonun ilişki hedefinde de taşıma açık olmalıdır, yoksa kayıt
-  `RelationTransferNotEnabledException` ile reddedilir — önce hedef (ebeveyn) tabloyu açın. `'all'`
+  `RelationTransferNotEnabledException` ile reddedilir — önce hedef (ebeveyn) tabloyu açın. Kendi yoluyla
+  taşınan hedefler bu kuraldan muaftır: `files`, `folders`, `roles`. `role_permissions` muaf değildir: `permissions`
+  açık olmalı. `user_positions` organizasyon yapısını gösterir ve yapı kayıt aktarımıyla taşınmaz: onun aktarımını kapalı
+  tutun. Deploy aynı kuralı toplama aşamasında da denetler; ihlal `RecordTransferGraphInvalidException` ile deploy'u
+  (hedefe dokunmadan) durdurur. `'all'`
   bir tablonun gösterdiği tabloda taşımayı kapatmak da reddedilir. `'specific'` bu denetimden muaftır:
   seçili satırın ilişki sütunu taşınmayan bir satırı gösterirse hata production'da FK ihlali olarak
   çıkar.

package/dist/resources/guides/microservice.md

@@ -225,6 +225,13 @@ DTO'dan süzülmez (WF-026 — `platform_guide('workflow')` §Hata yolu). Sözle
     ucundan kullanılır.
   - Adımda tanımlı ama değeri boş bırakılan alanlar gövdeden/expression'dan gelen veriyi
     **ezmez**; yalnız değeri dolu olan sabitler her satıra uygulanır.
+  - **Sayfa (UI) akışından tek istekte çağrılır** (zeyrek-frontend ADR 0029; uçta ölçüldü
+    2026-10-27): ucun şeması `isParameterSchemaArray`
+    olduğu için adımda **değeri olan tek gövde parametresinin** değeri dizi ise o dizi gövdenin
+    kendisi olur. Satır listesini bir gövde parametresine (ör. birincil anahtarınkine) `code` ile
+    verin, öbürlerini boş bırakın; iki gövde parametresi dolarsa gövde nesneye döner ve tek satır
+    okunur. Gövde anahtarları alan slug'larıdır — `fields[].name` ile yeniden adlandırma yoktur
+    (kaydedilmez). Tam tarif: `platform_guide('page')` §Kural 1g-5.
 - **`count` vardır** — kayıt sayısı için tüm satırları çekip uzunluğuna bakmayın; panel/KPI
   sayaçlarının doğru şekli budur. Dönüşü tek bir sayıdır: `isReturnSchemaArray` `isSingle`'dan
   bağımsız `false` okunur (2026-09-28'den önce kaydedilmiş servislerde de).

package/dist/resources/guides/mobile-publish.md

@@ -102,6 +102,19 @@ language, colorScheme: 'light', outPath }` → `mobile_asset_create { path, kind
 tablet10 `{800,1280,2}`. JPEG şart (iOS alfa kabul etmez); giriş/splash sayfası çekilmez (App Review 2.3.3).
 ikon/splash/öne çıkan görsel tekli yuvadır: yeni yükleme eskisinin yerine geçer.
 
+**Pazarlama görseli (çerçeve + başlık):** ham kareler yukarıdaki gibi çekilir, sonra `mobile_asset_preview
+{ applicationId, deviceClass, locale, slides: [{ path?, eyebrow?, title, subtitle?, layout? }], styles?, palette?,
+captionPosition?, frame? }` onları mağaza ölçüsünde JPEG'e çizer ve `galleryUrl` döner. Stiller (en çok dördü
+birlikte, her biri galeride bir satır): `clean` · `midnight` · `aurora` · `spotlight` · `swiss` · `japandi` ·
+`pastel` · `neon`. Yerleşim kare başına: `classic` · `bleed` (büyük cihaz alttan taşar) · `tilt` (3D eğik) · `text`
+(cihazsız, `path` istemez); ardışık karelerde yerleşimi değiştirmek seriyi canlı gösterir. Kullanıcı stil
+istemediyse dört farklı stil önerin, seçimi galeride yapsın. Galeri bir editördür: kullanıcı başlığı karenin
+üstünde yazar, stil/yerleşim/renk değiştirir, kartı kopyalar ve yeniden çizer — metni sizin yeniden çizmeniz gerekmez. Adresi kullanıcıya verin: seçtiklerini "Seçilenleri
+yükle" ile `screenshot/<locale>/<deviceClass>` yuvasına kare sırasıyla ekler — ajan ayrıca yüklemez (kopya düşer).
+Başlık uygulamanın gerçekten yaptığını söyler (App Review 2.3.7: fiyat, sıralama, rakip adı yok); uygulamanın ana
+rengi `palette.primary` ile verilir (`theme_get`). Galeri gateway süreci yaşadıkça açıktır; `AUTH_MODE=passthrough`'ta
+açılmaz, yükleme `mobile_asset_create { path: files[i].path }` ile yapılır.
+
 ## Akış
 
 1. `mobile_store_get` → kimlik varsayılandır (`app.zeyrek.o<org>.a<uygulama>`); değiştirilecekse **ilk

package/dist/resources/guides/mobile.md

@@ -194,6 +194,10 @@ docs/adr/0005; başka şekil 422 `fixed-views`). Satır yokken boş görünüm b
 `emptystate` yolu 2026-09-30'da kaldırıldı. Mobil `view` çocuklarını sütunda dizer. Tam gövde:
 `ngapps://examples/mobile-list-detail-form`.
 
+Sürükle-sırala: `reorderable: true` + `orderField` (yalnız dikey, tek sütun — MOB-035); bırakınca `reorder`
+`event.data.patches` taşır. Yük, tutulan sıra ve kalıcılığın bugünkü açığı: `platform_guide('page')` §Kural 1g-5.
+Jesti `page_screenshot` ile sınamak: `{ action:'swipe', target:'<liste>__row-2__handle', to:'<liste>__row-0' }`.
+
 ## Güne göre görev listesi
 
 Başlıklar altında gruplanmış liste (güne, odaya, kategoriye göre) **tek `grouped-list`** ile kurulur.

package/dist/resources/guides/page.md

@@ -1618,6 +1618,56 @@ kayıt — artık bekleyen değildir, önbellekteki eski listede de yoktur; list
 `page_screenshot` önbellek ve kuyruk kullanmaz — davranış yalnız cihazda görülür. Tam gövde (iki ekran, beş akış, iki
 uç, ayar ve değişken): `ngapps://examples/mobile-offline-seamless`.
 
+## Kural 1g-5 — Mobil sürükle-sırala: `repeater` `reorderable` ve sıranın kalıcılığı
+
+`repeater`'a `reorderable: true` + `orderField: '<sayı alanı>'` yazılınca her satırın sonunda bir tutamaç çizilir; satır
+tutamaçtan sürüklenir, bırakınca `reorder` yayılır. Yalnız dikey ve tek sütunlu listede çalışır (yatay şerit ya da
+`columnCount` > 1 iken tutamaç çizilmez, gateway **MOB-035** ile uyarır). Web'de karşılığı `datatable`
+`canReorderRows`'tur (save olayı, `self.operation === 'rowReorder'`).
+
+| Ne | Değer |
+|---|---|
+| Yük | `event.data = { fromIndex, toIndex, row, patches: [{ id, value }] }` — `self`'e yazılmaz |
+| `patches` | Sırası değişen satırlar: `id` satırın `_id`'si (yoksa `id`), `value` `orderField`'a yazılacak 1 tabanlı yeni adım. Eş değerli satırlar tek adımdır (aynı `value`'yu paylaşır); iki eş satırın arasına bırakılan satır o adıma katılır. `orderField` yoksa ya da bir satırda anahtar yoksa BOŞ dizi |
+| Çizim sırası | Satırlar `orderField`'a göre çizilir (boşlar sonda); servis sıralı dönmek zorunda değildir |
+| Tutulan sıra | Liste bırakılan sırayı FARKLI satırlar gelene kadar tutar; aynı satırlar yeniden okunursa (yenileme) sıra bozulmaz |
+| Seçim | Seçili satır varsa düğümün `selectedIndices`/`selectedItems`/`selectedIndex` değeri yeni sıraya taşınır |
+| Tutamacın adresi | `<elementId>__row-<i>__handle` (rol kimliği) — yalnız çalışma anında (Dene, `/dev`, `page_screenshot`); tasarım ve Düzenle kipinde tutamaç çizilir ama kimlik basılmaz |
+
+**Sırayı kalıcı yapmak** akışın işidir: `reorder` akışı `event.data.patches`'ı sıra alanını yazan bir servise verir,
+ardından `rows`'u yeniden okur — yazılan sıra değerleriyle gelen satırlar farklıdır, liste onları çizer. Boş
+`patches`'ta (anahtarsız satır) servis çağrılmaz. **Servis hata dönerse liste kendiliğinden eski sıraya DÖNMEZ:** sunucu
+sürüklemeden önceki satırların aynısını döndürür ve liste aynı satırlarda tuttuğu sırayı korur (yukarıdaki tablo) — ekran
+kaydedilmemiş sırada kalır. Hatayı kullanıcıya gösterin; eski sıraya döndürmenin doğrulanmış bir yolu yoktur.
+
+**Tarif — N satır tek istekte (`bulk-update`; zeyrek-frontend ADR 0029).** Uçta ölçüldü (2026-10-27, `mobiltest`
+`siralama-kalici`): üçüncü satır başa sürüklenince sayfadan tek `PUT` 200 döner, üç satır yazılır ve yeniden okunan
+`rows` yeni sırayı verir. ADR 0029'dan eski platformda aynı akış gövdeyi nesne kurar ve 422 ile düşer.
+
+1. Uç: tablo kaynaklı `operation: 'bulk-update'`, `fields` = birincil anahtar + sıra alanı (başka alan koymayın —
+   tanımdaki alan gövdede yoksa NULL yazılır, `platform_guide('microservice')` §Güncelleme sözleşmesi). Gövdedeki
+   anahtarlar alan **slug'larıdır**; `fields[].name` ile yeniden adlandırma yoktur (platform sessizce düşürür), yani
+   `{ id, value }` yaması uca olduğu gibi gitmez, eşlenir.
+2. Akış adımı: ucun gövde parametrelerinden **yalnız birine** (birincil anahtarınkine, ör. `id`) satır listesini
+   `code` ile verin, öbürlerini boş bırakın. Servisin şeması `isParameterArray` dediği için değeri olan tek gövde
+   parametresinin dizisi gövdenin KENDİSİ olur — parametrenin adı anlamını yitirir:
+
+   ```json
+   { "name": "id", "type": "guid", "source": "body",
+     "value": { "type": "code", "ref": "event.data.patches.map(p => ({ id: p.id, sira: p.value }))" } }
+   ```
+
+   İkinci bir gövde parametresine değer verirseniz gövde yine NESNE olur ve platform onu tek satır okur
+   (`BulkRowFailedException` "Please provide the primary key value", 422).
+3. Ardından okuma ucu (`sortField: '<sıra alanı>'`, `sortType: 'asc'`) ve `rows`'a setter; hata metni için
+   `Steps.<yazma adımı>.error`.
+
+Kural motorda, servis şemasına bağlıdır: `bulk-create`/`bulk-delete` ve parametre
+davranışı dizi olan workflow ucu da aynı yoldan kök dizi alır. Çevrimdışı kuyruğa giren toplu yazma da kök diziyle
+gönderilir.
+
+Örnek: `ngapps://examples/mobile-reorder-persist` (iki uç, sayfa, yükleme ve kaydetme akışları, `swipe` ile doğrulama).
+
 ## Kural 1h — Tasarım: `style` prop'u ve tema değişkenleri
 
 Her komponentin `style` prop'u vardır ve emotion `css()` bloğudur: iç seçiciler, pseudo-class'lar
@@ -2601,6 +2651,18 @@ hiçbiri** bağlı değildi; üç portalın da rol menüsü boş çıkıyor, pan
 > adım `applied:false` ve notla döner. Çok günlü etkinlik aynı kimliği her gün hücresinde taşır;
 > hedef ilk eşleşmedir.
 >
+> **Mobil jesti sınamak (`swipe`, 2026-10-27).** `drag` web'in HTML5 sürüklemesidir; mobil jestler (tutamaçtan
+> sıralama, satırın kaydırma eylemi, kart destesi, kaydırıcı) işaretçiyi dinler ve `drag`'le sürülmez. `swipe`
+> hedefin merkezine basar, 12 adımda 16 ms arayla taşır ve bırakır; bitiş ya bir öğedir (`to`) ya göreli kaymadır
+> (`dx`/`dy`, CSS pikseli) — ikisi birden reddedilir. Hedefler: sıralama `{ action:'swipe',
+> target:'lst__row-2__handle', to:'lst__row-0' }` (`reorder` akışı koşar, `flowRuns: 1`); satır kaydırma
+> `{ action:'swipe', target:'lst__row-1', dx:-160, dy:0 }` (eylem paneli açık kalır); deste `{ action:'swipe',
+> target:'<deste>', dx:320, dy:0 }` (üstteki kart atılır). `to` verilince jest hedefin içinde, hareket yönündeki
+> kenarına 2 px kala biter — sıralamada satır tam hedef satırın yerine iner. Jest görünür alanın üst ya da alt 72 dp'lik
+> bandına girerse liste sayfayı kendiliğinden kaydırır ve satırın ineceği yer zamanlamaya bağlı olur: hedefleri
+> görünür alanda ve kenar bandından uzak seçin. Web sayfasında adım yine koşar ama `note` HTML5 sürükleme için `drag`'i
+> gösterir.
+>
 > **Üye kimliğiyle doğrulama (`asUser`).** Kapının kapalı olduğunu görmek yarısıdır; açık
 > olduğunu görmek diğer yarısı. `page_runtime_get` ve `page_screenshot` aynı `asUser` alanını
 > alır: uygulamanın kendi giriş ucundan (`microservice_execute`) aldığın üye jetonunu verirsin,

package/dist/resources/prompts/mobile-publish-prepare.md

@@ -59,7 +59,9 @@ başlamadan önce §Yolculuk, §Test derlemesi, §Akış, §Yaş derecelendirmes
    yuvanın `locale`'idir — verilmezse kare projenin varsayılan dilinde çıkar ve başka dilin yuvasına yanlış dilde
    yüklenir. Yuva birikimlidir (en çok 10 görsel): 1. adımda okuduğun yuvada görsel varsa kullanıcıya sormadan
    ekleme yapma. Giriş ve splash sayfası çekilmez. Production'da sayfa yoksa kullanıcıya sor: ekran görüntüsü
-   canlıya almadan sonraya kalabilir.
+   canlıya almadan sonraya kalabilir. Kullanıcı çerçeveli, başlıklı pazarlama görseli isterse ham kareleri
+   `mobile_asset_create` yerine `mobile_asset_preview`'a ver ve dönen `galleryUrl`'i kullanıcıya ilet; seçimi ve
+   yüklemeyi kullanıcı galeriden yapar.
 7. **Yaş derecelendirmesi** (iOS açıksa). `settings.apple.advisory`: rehberdeki **bütün** soruları cevapla;
    reklam açıksa `advertising: 'true'`. Emin olmadığın soruyu kullanıcıya sor.
 8. **Gizlilik.** `settings.urls.privacyPolicy` (https). Yoksa kullanıcıdan iste; uydurma adres yazma.

package/dist/resources/schema-fingerprint.json

@@ -1,8 +1,8 @@
 {
-  "hash": "5e308466bfb365d77db8b3c0e40b90d21112d560b2b6eb23053200233734e904",
-  "generatedAt": "2026-10-22T18:49:12.637Z",
-  "types": 348,
-  "files": 173,
+  "hash": "d916ee9592bccbc43433515ace6770949c374478ac53123ea894bab76bcdfd02",
+  "generatedAt": "2026-10-28T17:19:04.043Z",
+  "types": 377,
+  "files": 196,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",
   "missing": [
     "NgApps.Infrastructure.Models.IdNamePair`1[[System.Guid, System.Private.CoreLib, Version=9.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]",

package/dist/resources/schemas/AccessMatrixDto.json

@@ -47,7 +47,8 @@
           "organization-unit",
           "system",
           "process",
-          "task"
+          "task",
+          "assistant"
         ],
         "type": "string",
         "format": ""

package/dist/resources/schemas/AccessPermissionDto.json

@@ -47,7 +47,8 @@
           "organization-unit",
           "system",
           "process",
-          "task"
+          "task",
+          "assistant"
         ],
         "type": "string",
         "format": ""

package/dist/resources/schemas/AccessResourceDto.json

@@ -76,7 +76,8 @@
           "organization-unit",
           "system",
           "process",
-          "task"
+          "task",
+          "assistant"
         ],
         "type": "string",
         "format": ""