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

package/package.json

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

@@ -271,14 +271,19 @@ 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, Devoplus Console'dan yapılır.
+- 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

@@ -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.
@@ -38,14 +43,15 @@ pnpm dev       # one dev — uygulamayı yerelde çalıştırır; Portal başlı
    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 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

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
 ```