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

package/package.json

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

@@ -133,6 +133,23 @@ metinle sorun ve şıkları numaralı yazın. Teknik soru sorulmaz.
   yöneticisi her izne sahip sayılır (platformla aynı kural). Platform uygulamaya yalnız KENDİ ad alanındaki izinleri
   iletir; başka bir uygulamanın ya da portalın izni okunamaz.
 
+## Eksik izin: erişim talebi
+
+- Uygulamanın bir portala kurulması, bir ERP (DEXA) sorgusu ya da işlemi, izninin bir kullanıcı grubuna atanması ya da
+  yeni bir yetki alanı gerekiyorsa kullanıcıya teknik adım anlatılmaz: talebi AI kendisi gönderir. Devoplus One
+  bağlantısında `one_request_access` aracı, yoksa komut satırında `one login` ve `one request <tür> ...`. Durum
+  `one_list_my_requests` / `one_get_request` ya da `one requests` ile izlenir.
+- Talep izni kendiliğinden VERMEZ. Talebin portalının şirket yöneticisi Devoplus Console'da onaylar ya da gerekçesiyle
+  reddeder (yetki alanı talebini platform yöneticisi onaylar); sonuç talep sahibine e-postayla bildirilir. Kayıt dışındaki
+  talepleri yalnız uygulamanın sahibi gönderebilir; portal ve gönderen oturumdan gelir.
+- Gerekçe (`justification`) kullanıcının iş diliyle yazılır. ERP sorgusu istemeden önce `one_dexa_queries` (ya da
+  `one dexa queries`) listesine bakılır ve anahtar listeden aynen alınır; uygun sorgu yoksa `new-query` gönderilir.
+  Kurulum talebinde portal anahtarı gönderilmez, kullanıcıya da sorulmaz.
+- Uygulama içi izinlerin hepsi kayıt talebinde istenir: kayıttan sonra izin eklemenin talep türü yoktur, izni uygulamanın
+  ana portalının şirket yöneticisi Devoplus Console'dan ekler (ana portalı belirlenemeyen uygulamada platform yöneticisi).
+- Türler, alanlar ve hata kodları: SDK başvurusunun "Erişim talebi" bölümü (`node_modules/@devoplus/one-sdk/REFERENCE.md`)
+  ve `one_request_access` aracının açıklaması.
+
 ## Devoplus yapay zekası: iki yön (ZORUNLU adım)
 
 Devoplus yapay zekası bu uygulamanın verisine ve işlemlerine erişebilmelidir: kullanıcı Devoplus'ta "son notlarımı
@@ -271,14 +288,20 @@ Her Devoplus One uygulaması Portal'ın bir parçası gibi görünür. Kurallar
 - Hata yolu tek yerdedir: `catch (error) { return problemResponse(error) }`. `OneError` RFC 9457 gövdeye çevrilir,
   bilinmeyen hata 500 döner ve ayrıntı sızdırılmaz. `OneError.retryAfterSeconds` pozitif tam sayıysa (ör. 409
   `ERPCMD-APP-E-016`) yanıt onu `Retry-After` başlığında ve gövdedeki `retryAfterSeconds` alanında da taşır.
-- Kod Devoplus git deposuna push edilir; `one-ci validate` (manifest + giriş dosyası + README.md/AGENTS.md + araç
-  beyanı varsa AGENT_GUIDE.md + `one.data.json` varsa üretilmiş dosyaların güncelliği (`one data generate --check`) +
-  arayüz denetimi) ve taramalardan geçmeyen sürüm yüklenmez. Geliştirici makinesinden doğrudan yükleme YOKTUR.
-- **AI değişikliği ayrı dalda yapılır ve izlenebilir kalır:** çalışmaya `ai/<konu>` adlı yeni bir dalda başlayın;
-  yayın dallarına (`test`, `uat`, `main`) doğrudan commit atmayın, değişiklik birleştirme isteğiyle (merge request /
-  pull request) girer. AI ile yazdığınız her commit'in iletisine ayrı satırda `AI-Assisted: <araç adı>` trailer'ı
-  ekleyin (ör. `AI-Assisted: Claude Code`). `one-ci deploy` bu commit'leri ve geldikleri dalı sürüm defterine yazar;
-  platform `ONE_AI_BRANCH_POLICY=enforce` açarsa yayın dalına doğrudan yazılmış AI commit'i yayını durdurur.
+- Kod Devoplus API'si üzerinden uygulamanın deposuna yüklenir: komut satırında uygulamanın kök dizininde `one publish`
+  (projenin tam görüntüsünü yükler ve test ortamına yayınlar; açıklama `--message` ile), dosya sistemi olmayan araçta
+  Devoplus One bağlantısının `one_source_upload` aracı. Deponun kendisine erişim gerekmez; kullanıcıdan da istenmez.
+  Yükleme test dalına tek commit olarak yazılır ve yükleyenin adını taşır; bağımlılıklar, yerel durum klasörleri, hat
+  dosyası ve sır dosyaları yüklenmez. `one-ci validate` (manifest + giriş dosyası + README.md/AGENTS.md + araç beyanı
+  varsa AGENT_GUIDE.md + `one.data.json` varsa üretilmiş dosyaların güncelliği (`one data generate --check`) + arayüz
+  denetimi) ve taramalardan geçmeyen sürüm yayımlanmaz. Hat düşerse nedenini `one pipeline` (ya da `one_pipeline_status`)
+  gösterir. Geliştirici makinesinden doğrudan yayın YOKTUR.
+- Terfi: test'ten uat'a `one promote` (uat oturumuyla) ya da `one_publish`; kod birleştirmesini ve `v<sürüm>` etiketini
+  Devoplus yapar. Canlıya terfi ve canlıda geri alma insan onaylıdır: uygulamanın sahibi Portal'daki "Devoplus One
+  Uygulamalarım" ekranından, şirket yöneticisi Devoplus Console'dan yapar.
+- Depoya doğrudan git ile çalışılıyorsa (yalnız Devoplus ekibi) AI değişikliği `ai/<konu>` dalında yapılır ve birleştirme
+  isteğiyle girer; AI ile yazılan her commit'in iletisine ayrı satırda `AI-Assisted: <araç adı>` trailer'ı eklenir.
+  `one-ci deploy` commit'leri ve geldikleri dalı sürüm defterine yazar.
 - `README.md` uygulamanın amacını ve davranışını, bu dosya AI kurallarını, `AGENT_GUIDE.md` Devoplus yapay zekasının
   araçları nasıl kullanacağını anlatır; davranışı değiştiren değişiklik üçünü aynı commit'te günceller (one-ci README ya da
   AGENTS yoksa veya boşsa, araç beyanı olan uygulamada AGENT_GUIDE.md eksikse yayını durdurur).

package/templates/README.md.tpl

@@ -43,14 +43,15 @@ pnpm dev       # one dev: uygulamayı yerel Portal içinde açar (http://127.0.0
    sınırı, izin kodu `{{permissionCode}}`). Kayıt kimlik sağlayıcıda uygulamanın client kaydını açar.
 2. **Kurulum:** aynı ekrandan uygulama bir portala kurulur (portal anahtarı). Kurulum = uygulama × portal; adres
    `{{slug}}-<portalAnahtarı>.<ortam tabanı>` olur.
-3. **Yayın:** kod Devoplus GitLab'ına push edilir. Hat **platformundur** (proje ayarı "CI/CD configuration file" platform
-   projesindeki `one-app.gitlab-ci.yml`'yi gösterir); bu depoya `.gitlab-ci.yml` YAZILMAZ — yazılsa da okunmaz. Her MR ve
-   `test`/`uat`/`main` itişinde `prepare` koşar: `one-ci validate` (manifest · README/AGENTS · sır taraması) · bağımlılık
-   taraması · `pnpm install` · `type-check` · `test`. Dağıtım dal = ortamdır ve elle başlatılır (`deploy:<ortam>` →
-   "Run job", `ONE_PORTAL_KEY` + `ONE_PORTAL_ID`); client kimliği `one-{{slug}}`'dur. Geliştirici makinesinden doğrudan
-   yükleme yoktur. `pnpm-lock.yaml` depoya girer (hat `--frozen-lockfile` kurar). AI ile yapılan değişiklikler
-   `ai/<konu>` dalında ve `AI-Assisted:` trailer'ıyla gelir; one-ci son yayından bu yana gelen AI commit'lerini ve
-   dallarını sürüm defterine yazar (`one-ci releases`).
+3. **Yayın:** `one publish` kaynağı Devoplus API'si üzerinden uygulamanın deposuna (test dalı) yükler ve test ortamına
+   yayını başlatır; depoya erişim gerekmez. Hat **platformundur** (proje ayarı "CI/CD configuration file" platform
+   projesindeki `one-app.gitlab-ci.yml`'yi gösterir); bu depoya `.gitlab-ci.yml` YAZILMAZ ve yükleme onu kabul etmez. Her
+   yüklemede `prepare` koşar: `one-ci validate` (manifest · README/AGENTS · sır taraması) · bağımlılık taraması ·
+   `pnpm install` · `type-check` · `test`. Hat düşerse `one pipeline` hangi işin neden düştüğünü gösterir. Dal = ortamdır:
+   test'ten uat'a `one promote` (uat oturumuyla), canlıya terfi sahip için Portal'daki "Devoplus One Uygulamalarım" ekranından, şirket yöneticisi için Devoplus Console'dan; birleştirmeyi ve `v<sürüm>` etiketini
+   Devoplus yapar. Client kimliği `one-{{slug}}`'dur. Geliştirici makinesinden doğrudan yayın yoktur. `pnpm-lock.yaml`
+   depoya girer (hat `--frozen-lockfile` kurar). one-ci son yayından bu yana gelen commit'leri sürüm defterine yazar
+   (`one-ci releases`).
 4. Portal menüsünde uygulama, `{{permissionCode}}` izni atanmış kullanıcılara görünür.
 
 ## Yeni yetenek eklerken