create-devoplus-one-app 0.1.0-next.158 → 0.1.0-next.166

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-devoplus-one-app",
-  "version": "0.1.0-next.158",
+  "version": "0.1.0-next.166",
   "description": "Yeni bir Devoplus One uygulaması iskeleti üretir: manifest, SDK'lı giriş noktası, Portal köprülü kabuk, veritabanı migration'ı ve AGENTS.md",
   "license": "UNLICENSED",
   "type": "module",

package/templates/AGENTS.md.tpl

@@ -3,6 +3,10 @@
 Bu dosya, bu uygulamayı geliştiren AI aracına (Claude Code, Codex vb.) yöneliktir. Kurallar bağlayıcıdır; bir
 kuralın gerekçesi SDK belgesinde ya da platform karar defterindedir (aşağıda "Kaynaklar").
 
+Kullanıcıya soru sorarken ortamınız seçenekli soru kartı gösterebiliyorsa (örneğin Claude Code'da `AskUserQuestion`)
+soruları kartla ve iş dilinde 2-4 şıkla sorun; önerdiğiniz şıkkı ilk sıraya koyup "(önerilen)" yazın. Gösteremiyorsa
+metinle sorun ve şıkları numaralı yazın. Teknik soru sorulmaz.
+
 ## Platform sözleşmesi
 
 - Uygulama **Devoplus One** üzerinde, **Devoplus Portal içinde iframe ile** çalışır.
@@ -79,7 +83,8 @@ kuralın gerekçesi SDK belgesinde ya da platform karar defterindedir (aşağıd
 - **DEXA (ERP okuma)** yalnız SDK `queryDexa(api, key, parameters?)` ile ve yalnız ÖNCEDEN tanımlı QueryStore
   anahtarlarıyla; serbest SQL ya da ERP'ye yazma YOKTUR. Anahtarları Devoplus Console'da uygulamanın kayıt defterine
   yönetici ekler (kayıtta olmayan anahtar 403). Manifest'te `services.dexa.queryKeys` ve `scopes` içinde `dexa.read`
-  birlikte beyan edilir; anahtar adı uydurulmaz, geliştiriciden alınır. `result.unavailable === true` ise sorgu
+  birlikte beyan edilir; anahtar adı uydurulmaz. Portalda açılmış sorguları parametre ve sütunlarıyla
+  `one dexa queries` (MCP'de `one_dexa_queries`) listeler; anahtar oradan ya da geliştiriciden alınır. `result.unavailable === true` ise sorgu
   ÇALIŞAMADI; boş `rows` "kayıt yok" SAYILMAZ, kullanıcıya "şu anda getirilemiyor" gösterilir; `truncated` sonucun
   5.000 satırda kesildiğini söyler. `LangCode` platformundur, uygulama GÖNDERMEZ. `UserCode`, `CompanyCode`,
   `CostCenterCode`: kurulumda yönetici "kodları uygulama belirler" onayını verdiyse uygulama bunları her kipte (kişi,

package/templates/musteri-ziyaret/AGENTS.template.md.tpl

@@ -18,8 +18,9 @@ DEĞİŞTİRİN; baştan yazmayın. Dosya haritası:
 ⛔ Sorgu anahtarı ve kolon adları **UYDURULMAZ**. `CUSTOMER_QUERY = { key, codeColumn, nameColumn }` üçü de boşken
 uygulama DEXA'ya hiç gitmez, `/api/customers` `state: "not-configured"` döner ve müşteri elle girilir. Bağlamak için:
 
-1. Kullanıcıdan ya da yöneticiden kurumun DEXA Query Store'undaki **müşteri listesi okuma sorgusunun anahtarını** ve
-   sorgunun döndürdüğü **müşteri kodu** ile **müşteri adı** kolonlarının adlarını öğrenin. Sorgu parametre almayan bir
+1. Kurumun **müşteri listesi okuma sorgusunun anahtarını** ve sorgunun döndürdüğü **müşteri kodu** ile **müşteri
+   adı** kolonlarının adlarını öğrenin: portalda açılmış sorguları parametre ve sütunlarıyla `one_dexa_queries` (ya da
+   `one dexa queries`) listeler; listede yoksa kullanıcıya ya da yöneticiye sorun. Sorgu parametre almayan bir
    liste sorgusu olmalıdır. Sorgu yoksa erişim talebiyle `new-query` isteyin (taslak SQL yalnız öneridir).
 2. Üç değeri `CUSTOMER_QUERY`'ye yazın.
 3. `one.manifest.json`'a `scopes` içine `"dexa.read"` ve `services` içine `"dexa": { "queryKeys": ["<anahtar>"] }`

package/templates/musteri-ziyaret/files/src/customers.ts.tpl

@@ -2,8 +2,8 @@
 //
 // ⚠️ YER TUTUCU — sorgu anahtarı ve kolon adları kuruma özgüdür ve UYDURULMAZ. Aşağıdaki üç değer boşken uygulama ERP'ye
 // hiç gitmez ve müşteri ELLE girilir (ekran bunu söyler). Bağlamak için (ayrıntı AGENTS.md):
-//   1. Kurumunuzun DEXA Query Store'unda müşteri listesini döndüren okuma sorgusunun anahtarını ve müşteri kodu / müşteri
-//      adı kolonlarının adlarını öğrenin (yoksa erişim talebiyle `new-query` isteyin).
+//   1. Müşteri listesini döndüren okuma sorgusunun anahtarını ve müşteri kodu / müşteri adı kolonlarının adlarını
+//      öğrenin: portalda açılmış sorguları `one dexa queries` listeler (yoksa erişim talebiyle `new-query` isteyin).
 //   2. `CUSTOMER_QUERY`'ye yazın; manifest'e `"dexa.read"` yetki alanını ve `services.dexa.queryKeys` listesine aynı
 //      anahtarı ekleyin.
 //   3. Erişim talebiyle sorgunun uygulamaya açılmasını (`dexa-query`) ve gerekirse yetki alanını (`scope`) isteyin.