create-devoplus-one-app 0.1.0-next.163 → 0.1.0-next.173

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-devoplus-one-app",
-  "version": "0.1.0-next.163",
+  "version": "0.1.0-next.173",
   "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

@@ -83,7 +83,8 @@ metinle sorun ve şıkları numaralı yazın. Teknik soru sorulmaz.
 - **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/README.md.tpl

@@ -22,9 +22,14 @@ kiracı ve servisler `@devoplus/one-sdk`'dan gelir. Uygulamayı geliştirecek AI
 pnpm install
 pnpm type-check && pnpm test && pnpm build   # build = one build: yükleme provası, hiçbir yere göndermez
 pnpm migrate   # one migrate — migrations/ altındaki SQL dosyalarını yerel veritabanına uygular (ilk çalıştırmada ve her yeni migration'da)
-pnpm dev       # one dev — uygulamayı yerelde çalıştırır; Portal başlıklarını (X-One-*) elle göndermeniz gerekir
+pnpm dev       # one dev: uygulamayı yerel Portal içinde açar (http://127.0.0.1:8787/); kişi --as <kişi> ile seçilir
 ```
 
+> `one dev` kimlik bağlamını seçilen kişiden üretir (başlık elle yazılmaz). E-posta ve SMS gönderilmez, yerel posta
+> kutusuna yazılır (`/__one-dev/posta-kutusu`); mobil bildirim platformun varsayılanı gibi kapalıdır. DEXA ve
+> organizasyon şeması örnek veridendir. Kişiler ve örnek veri `one.dev.json` dosyasındadır (yoksa iki örnek kişi);
+> ayrıntı SDK başvurusundadır.
+
 > `one` komutu `@devoplus/one-sdk` ile gelir. Yerel yapılandırma, yerel veri ve paket çıktısı `.one/` altındadır
 > (depoya girmez); her komutta `one.manifest.json`'dan yeniden üretilir. Migration uygulanmadan `notes` tablosu
 > yoktur ve `/api/notes` hata döner. Gerçek yüklemede migration'ları platform sürümle birlikte uygular.

package/templates/_shared/README.tail.md.tpl

@@ -7,7 +7,7 @@ Bu bölüm uygulamayı yazan kişi ya da yapay zekâ aracı içindir; kurallar *
 pnpm install
 pnpm type-check && pnpm test && pnpm build   # build = one build: yükleme provası, hiçbir yere göndermez
 pnpm migrate   # one migrate — migrations/ altındaki dosyaları yerel veritabanına uygular
-pnpm dev       # one dev — yerelde çalıştırır; Portal başlıklarını (X-One-*) elle göndermeniz gerekir
+pnpm dev       # one dev: yerel Portal içinde açar (http://127.0.0.1:8787/); kişiler ve örnek veri one.dev.json
 pnpm data:generate   # one.data.json değişince: yeni migration + src/data/types.ts
 ```
 

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.