create-devoplus-one-app 0.0.0-stage → 0.1.0-next.158

package/templates/envanter/manifest.json.tpl

@@ -0,0 +1,56 @@
+{
+  "scopes": ["orgschema.read", "mail.execute"],
+  "services": { "database": true, "files": false, "cache": false },
+  "menuIcon": "pi pi-box",
+  "navigation": [
+    { "path": "/", "label": { "tr": "Stok", "en": "Stock" } },
+    { "path": "/movements", "label": { "tr": "Hareketler", "en": "Movements" } },
+    { "path": "/items", "label": { "tr": "Kalemler", "en": "Items" } }
+  ],
+  "permissions": [
+    { "code": "{{permissionPrefix}}Manage", "name": { "tr": "Stok kalemlerini ve hareketlerini yönet", "en": "Manage stock items and movements" } }
+  ],
+  "agent": {
+    "summary": {
+      "tr": "Envanter uygulaması: stok kalemleri, eldeki miktarlar, konumları ve en az miktarın altına düşen kalemler.",
+      "en": "Inventory app: stock items, quantities on hand, their locations and items below the minimum quantity."
+    },
+    "tools": [
+      {
+        "name": "search-items",
+        "title": { "tr": "Stok kalemi ara", "en": "Search stock items" },
+        "description": {
+          "tr": "Stok kodunda, adında ya da konumunda aranan ifade geçen kalemleri eldeki miktar, birim ve azalmış mı bilgisiyle döndürür. Salt okunur.",
+          "en": "Returns items whose SKU, name or location contains the query, with quantity on hand, unit and whether it is low. Read-only."
+        },
+        "readOnly": true,
+        "permission": "{{permissionCode}}",
+        "input": {
+          "type": "object",
+          "properties": {
+            "query": { "type": "string", "minLength": 1, "maxLength": 80, "description": "Aranan ifade (stok kodu, ad ya da konum)" },
+            "limit": { "type": "integer", "minimum": 1, "maximum": 50, "description": "En çok kaç kalem (varsayılan 10)" }
+          },
+          "required": ["query"]
+        }
+      },
+      {
+        "name": "list-low-stock",
+        "title": { "tr": "Azalan stoku listele", "en": "List low stock" },
+        "description": {
+          "tr": "Eldeki miktarı en az miktarın altına düşmüş kalemleri ve son günlük stok kontrolünün sonucunu döndürür. Salt okunur.",
+          "en": "Returns items whose quantity on hand is below the minimum quantity and the result of the latest daily stock check. Read-only."
+        },
+        "readOnly": true,
+        "permission": "{{permissionCode}}",
+        "input": { "type": "object", "properties": {} }
+      }
+    ]
+  },
+  "jobs": {
+    "schedules": [
+      { "name": "daily-stock-check", "cron": "0 7 * * *", "timeZone": "Europe/Istanbul", "description": "En az miktarın altındaki kalemleri günün kontrol kaydına yazar" }
+    ],
+    "queues": []
+  }
+}

package/templates/hedef-takibi/AGENTS.template.md.tpl

@@ -0,0 +1,37 @@
+## Bu uygulamanın şablonu: hedef ve aksiyon takibi (`hedef-takibi`)
+
+Uygulama `create-devoplus-one-app --template hedef-takibi` ile üretildi. Kullanıcının ihtiyacını bu şablona göre DEĞİŞTİRİN;
+baştan yazmayın. Dosya haritası:
+
+| Dosya | Ne |
+|---|---|
+| `one.data.json` | Veri modeli: `periods` (dönem) + `goals` (hedef) + `key_results` (ölçülebilir sonuç) + `check_ins` (değer geçmişi) + `actions` (aksiyon). Değişince `pnpm data:generate` |
+| `src/app.ts` | Uçlar: dönem (kapatma/yeniden açma), hedef, ölçülebilir sonuç, değer güncellemesi, aksiyon, ekip ve dönem panosu, Excel |
+| `src/progress.ts` | Saf kurallar: ilerleme (sınırlama, başlangıç = hedef durumu), ortalama, ağırlıklı ortalama, değer doğrulama, doğrudan bağlılar + `progress.test.ts` |
+| `src/queries.ts` | Dönem ve dönem özeti sorguları (pano ve yapay zekâ aracı ortak) |
+| `src/shell.ts` | Sayfa: Hedeflerim, Ekip panosu, Dönem panosu (grafik), Dönemler + hedef ayrıntısı |
+| `src/agent.ts` · `AGENT_GUIDE.md` | Devoplus yapay zekâsının aracı (`period-summary`) ve rehberi |
+| `src/lib/*` | Şablonların ortak parçaları — gerekmedikçe değiştirmeyin |
+
+Değişmezler (bozmayın):
+
+- **İlerleme YALNIZ sunucuda hesaplanır.** Hiçbir uç `progress` ya da `current_value` alanını istemciden ALMAZ (400).
+  Kural `progress.ts`'tedir; hedefin ilerlemesi veritabanında aynı kuralla (`GOAL_PROGRESS_SQL`: ortalama, bir ondalık)
+  yeniden hesaplanır — kuralı değiştirirseniz ikisini birlikte değiştirin.
+- **Değer güncellemesi TEK toplu yazımdır** (`env.DB.batch([geçmiş, değer, hedef ilerlemesi])`): geçmiş satırı yalnız
+  değer hâlâ okunan değerse ve dönem açıksa eklenir, değer yalnız o satır eklendiyse değişir. İki ayrı yazıma ya da
+  "önce oku, sonra yaz"a çevirmeyin — geçmişi olmayan değer ya da birbirini ezen iki güncelleme doğardı.
+- **Görünürlük sunucuda organizasyon şemasından türetilir** (`viewer` → `getMyOrgContext` + `getOrgUsersWithManagers`):
+  kişi kendi hedefini, yönetici doğrudan bağlılarının hedefini, `{{permissionPrefix}}Manage` hepsini görür. Görülemeyen
+  hedef **404**'tür (403 değil: var olduğu sızmaz). Hedeflerim listesinde sorumlu süzgeci sunucuda zorlanır. Kayıt
+  uçlarını (`goals`, `/internal/*`) görünürlük denetimi olmadan yönlendirmeyin.
+- **Kişi kimlikleri:** sorumlu `owner_org_id` organizasyon şeması kimliğidir (`ctx.user.sub` DEĞİL).
+- **Kapanan dönem salt okunurdur (409).** Dönem durumu yalnız `close` / `reopen` uçlarıyla değişir; dönem uçları `status`
+  alanını istemciden almaz. Hedefi olan dönem silinmez.
+- **Dönemin açık olması yazımla AYNI ifadededir** — hedefin silinmemiş ve sorumlusunun yazana görünür olmasıyla birlikte
+  (`goalWritable`). Hedef, ölçülebilir sonuç ve aksiyon ekleme, düzenleme ve silme hazır kayıt ucuna iletilmez;
+  `lib/record.ts` ile doğrulanıp koşullu SQL ile yazılır (`… WHERE … AND <hedef yazılabilir>`). Hedefe kopyalanan dönem
+  kodu eklemede dönemin o anki koduyla karşılaştırılır; dönem tarihlerinin kuralı yazımdan sonraki satıra uygulanır. Dönem silme de
+  "dönemde hedef yok" koşulunu kendi ifadesinde ister. "Önce oku, sonra kayıt ucuna ilet"e çevirmeyin: arada kapanan ya da
+  silinen dönemde hedef yazılır, silinmiş döneme bağlı hedef panolardan kaybolurdu.
+- Hedef açan, değer güncelleyen ya da dönem kapatan bir yapay zekâ aracı eklemeyin; araçlar salt okunurdur.

package/templates/hedef-takibi/README.md.tpl

@@ -0,0 +1,52 @@
+# {{nameTr}}
+
+Ekiplerin dönemlik hedeflerini, her hedefin ölçülebilir sonuçlarını ve aksiyonlarını izleyen bir hedef takip
+uygulaması. Devoplus Portal'ın içinde, Portal menüsünden açılır. Bu uygulama Devoplus One'ın **hedef ve aksiyon takibi**
+şablonundan üretildi; ihtiyacınıza göre değiştirilecek bir başlangıç noktasıdır. Bir onay akışı değildir: hedefler
+kimseye onaya gönderilmez.
+
+## Ne yapar
+
+1. **Dönemler:** hedef yöneticisi dönemleri tanımlar (ör. "2026-Ç4", başlangıç ve bitiş tarihiyle). Dönem kapatılınca
+   o dönemin hedefleri, ölçülebilir sonuçları ve aksiyonları artık değiştirilemez; yalnız görüntülenir.
+2. **Hedeflerim:** her çalışan kendisine hedef açabilir; yönetici doğrudan kendisine bağlı çalışanlara hedef verebilir.
+   Hedefin ekibi, sorumlunun Devoplus'taki departmanından kendiliğinden gelir. Liste Excel'e ya da CSV'ye aktarılabilir.
+3. **Ölçülebilir sonuçlar:** her hedefe "aylık yeni müşteri sayısı: 20'den 50'ye" gibi ölçütler eklenir. Güncel değer
+   girildikçe ilerleme hesaplanır ve kimin, ne zaman, hangi değeri hangi değere çevirdiği geçmişte kalır.
+4. **Aksiyonlar:** hedefe ulaşmak için yapılacak işler sorumlusu ve termini ile yazılır, tamamlanınca işaretlenir.
+5. **Ekip panosu:** yönetici, Devoplus organizasyon şemasında doğrudan kendisine bağlı çalışanların hedeflerini görür.
+6. **Dönem panosu:** dönemin ekip başına ilerlemesi grafikle gösterilir; dönemin hedef listesi Excel'e aktarılabilir.
+7. **Devoplus asistanı:** "Bu çeyrekte hedeflerin neresindeyiz?" gibi sorular Devoplus'un yapay zekâ asistanına
+   sorulduğunda cevap bu uygulamadan gelir (hedef yöneticileri için).
+
+## İlerleme nasıl hesaplanır
+
+- Ölçülebilir sonuç: (güncel değer − başlangıç) ÷ (hedef − başlangıç). Hedef aşılırsa %100, başlangıcın gerisine
+  düşülürse %0 yazılır. Azalması istenen değerlerde (ör. şikâyeti 40'tan 10'a indirmek) aynı kural çalışır.
+- Başlangıç ile hedef aynıysa (ör. "hata sayısını 0'da tut"): güncel değer hedefe eşitse %100, değilse %0.
+- Hedef: ölçülebilir sonuçlarının ortalaması. Ekip ve dönem: hedeflerin ağırlığa göre ortalaması.
+- İlerleme elle girilmez; uygulama hesaplar.
+
+## Kimler ne görür
+
+| Kim | Ne yapabilir |
+|---|---|
+| Uygulamayı kullanma izni olan herkes ({{permissionCode}}) | Kendi hedeflerini açar, değer günceller, aksiyon yazar |
+| Yönetici (organizasyon şemasında doğrudan bağlısı olan) | Ayrıca doğrudan bağlılarının hedeflerini görür ve düzenler |
+| Hedef yöneticisi ({{permissionPrefix}}Manage) | Dönem tanımlar ve kapatır, bütün hedefleri görür ve düzenler |
+
+İzinleri portal yöneticisi **Yetki Yönetimi** ekranından verir. Yöneticilik ayrı bir izin değildir; Devoplus'taki
+organizasyon şemasından okunur.
+
+## Neleri değiştirebilirsiniz
+
+Yapay zekâ aracınıza iş diliyle söylemeniz yeterlidir:
+
+- "Yöneticiler alt kademelerin hedeflerini de görsün" — ekip yalnız doğrudan bağlılardan oluşuyor.
+- "Hedefe öncelik (yüksek, orta, düşük) eklensin" — yeni alan.
+- "Ölçülebilir sonuçların da ağırlığı olsun" — hesap kuralı değişir.
+- "Geciken aksiyonlar ekranın üstünde görünsün" — yeni özet.
+
+Bilinmesi gerekenler: ekip ve yönetici bilgisi Devoplus organizasyon şemasından okunur; bir çalışanın yöneticisi orada
+tanımlı değilse yöneticisi onun hedeflerini göremez. Bir çalışanın departmanı sonradan değişirse eski hedefleri eski
+ekipte kalır.

package/templates/hedef-takibi/files/AGENT_GUIDE.md.tpl

@@ -0,0 +1,48 @@
+# {{nameTr}} — Devoplus yapay zekâsı için rehber
+
+Bu dosyayı **Devoplus yapay zekâsı** okur (uygulama adresinde `/.well-known/one-agent.md`). Bir aracı eklerken,
+değiştirirken ya da kaldırırken bu dosyayı AYNI değişiklikte güncelleyin; yayın kapısı dört başlığı ve her aracın adını
+arar.
+
+## Uygulama ne yapar
+
+{{nameTr}}, ekiplerin dönemlik hedeflerini (ör. "2026-Ç4"), her hedefin ölçülebilir sonuçlarını ve aksiyonlarını izleyen
+bir hedef takip uygulamasıdır. Her ölçülebilir sonucun bir başlangıç, hedef ve güncel değeri vardır; ilerleme bu
+değerlerden **uygulamanın sunucusunda** hesaplanır. Hedefin ilerlemesi ölçülebilir sonuçlarının ortalaması, ekibin ve
+dönemin ilerlemesi hedeflerin ağırlıklı ortalamasıdır. Kişi kendi hedeflerini, yönetici doğrudan kendisine bağlı
+çalışanların hedeflerini, hedef yöneticisi bütün hedefleri görür. Kapanan dönemin hedefleri değiştirilemez. Kullanıcı
+"bu çeyrekte hedeflerin neresindeyiz", "hangi ekip geride", "en geride kalan hedefler hangileri" gibi şeyler sorduğunda
+bu uygulamaya başvurun. Hedef açmak ya da değer güncellemek için araç yoktur.
+
+## Veri
+
+- **Dönem** (`periods`): kod (tekil, ör. `2026-Ç4`), ad, başlangıç ve bitiş tarihi, durum (`open` açık · `closed`
+  kapandı).
+- **Hedef** (`goals`): başlık, açıklama, sorumlu kişinin adı, ekip (sorumlunun organizasyon şemasındaki departmanı),
+  ağırlık (1-100), ilerleme (yüzde, 0-100).
+- **Ölçülebilir sonuç** (`key_results`): ölçüt, birim, başlangıç, hedef ve güncel değer, ilerleme (yüzde). Hedef
+  aşılırsa %100, başlangıcın gerisine düşülürse %0 sayılır; başlangıç ile hedef aynıysa güncel değer hedefe eşitken
+  %100'dür.
+- **Değer güncellemesi** (`check_ins`): kim, ne zaman, önceki değer, yeni değer, not.
+- **Aksiyon** (`actions`): açıklama, sorumlu, termin, tamamlandı mı.
+
+## Araçlar
+
+### `period-summary` — dönem hedef özeti (salt okunur)
+
+- **Ne zaman:** kullanıcı bir dönemin genel durumunu, ekiplerin ilerlemesini ya da geride kalan hedefleri sorduğunda.
+  Yalnız hedef yöneticisi iznine sahip kullanıcıya açıktır; izni olmayan kullanıcıya kendi hedefleri için uygulamanın
+  Hedeflerim sekmesini önerin.
+- **Girdi:** `period` — dönem kodu (ör. `2026-Ç4`); verilmezse başlangıcı en yeni olan dönem.
+- **Çıktı:** `{ "period": { "code", "name", "status", "start", "end" }, "overall": 62.5, "goalCount": 14,
+  "teams": [{ "team", "goals", "progress" }], "lowest": [{ "title", "owner", "team", "progress" }] }` — ilerlemeler
+  yüzdedir (bir ondalık); `lowest` en geride kalan en çok beş hedeftir. Dönem yoksa `period` `null`.
+- **Dikkat:** sayıları kendiniz yeniden hesaplamayın; sunucunun verdiği değeri aktarın. Kapanmış dönemin
+  (`status: "closed"`) sayıları artık değişmez.
+
+## Örnek istekler
+
+- "Bu çeyrekte hedeflerin neresindeyiz?" → `period-summary` → `overall` ve `teams`
+- "2026-Ç3'te hangi ekip en geride kaldı?" → `period-summary` (`period: "2026-Ç3"`) → `teams` içinde en düşük `progress`
+- "En geride kalan hedefler hangileri?" → `period-summary` → `lowest`
+- "Satış hedefimin değerini 120 yap." → araç yok; kullanıcıyı uygulamanın Hedeflerim sekmesine yönlendirin.

package/templates/hedef-takibi/files/one.data.json

@@ -0,0 +1,76 @@
+{
+  "version": 1,
+  "entities": {
+    "periods": {
+      "title": { "tr": "Dönemler", "en": "Periods" },
+      "fields": {
+        "code": { "type": "text", "title": { "tr": "Dönem kodu", "en": "Period code" }, "required": true, "unique": true, "maxLength": 20 },
+        "name": { "type": "text", "title": { "tr": "Dönem adı", "en": "Period name" }, "required": true, "maxLength": 120 },
+        "start_date": { "type": "date", "title": { "tr": "Başlangıç", "en": "Start" }, "required": true },
+        "end_date": { "type": "date", "title": { "tr": "Bitiş", "en": "End" }, "required": true },
+        "status": {
+          "type": "choice",
+          "title": { "tr": "Durum", "en": "Status" },
+          "required": true,
+          "default": "open",
+          "index": true,
+          "choices": [
+            { "value": "open", "title": { "tr": "Açık", "en": "Open" } },
+            { "value": "closed", "title": { "tr": "Kapandı", "en": "Closed" } }
+          ]
+        },
+        "closed_at": { "type": "datetime", "title": { "tr": "Kapanış", "en": "Closed at" } }
+      }
+    },
+    "goals": {
+      "title": { "tr": "Hedefler", "en": "Goals" },
+      "fields": {
+        "period_id": { "type": "text", "title": { "tr": "Dönem", "en": "Period" }, "required": true, "maxLength": 36, "index": true },
+        "period_code": { "type": "text", "title": { "tr": "Dönem kodu", "en": "Period code" }, "maxLength": 20 },
+        "title": { "type": "text", "title": { "tr": "Hedef", "en": "Goal" }, "required": true, "maxLength": 160 },
+        "description": { "type": "longText", "title": { "tr": "Açıklama", "en": "Description" }, "maxLength": 2000 },
+        "owner_org_id": { "type": "text", "title": { "tr": "Sorumlu (kimlik)", "en": "Owner (id)" }, "required": true, "maxLength": 24, "index": true },
+        "owner_name": { "type": "text", "title": { "tr": "Sorumlu", "en": "Owner" }, "maxLength": 120 },
+        "team_id": { "type": "text", "title": { "tr": "Ekip (kimlik)", "en": "Team (id)" }, "maxLength": 24, "index": true },
+        "team_name": { "type": "text", "title": { "tr": "Ekip", "en": "Team" }, "maxLength": 120 },
+        "weight": { "type": "number", "title": { "tr": "Ağırlık", "en": "Weight" }, "required": true, "default": 1, "min": 1, "max": 100 },
+        "progress": { "type": "number", "title": { "tr": "İlerleme (%)", "en": "Progress (%)" }, "required": true, "default": 0, "min": 0, "max": 100 }
+      }
+    },
+    "key_results": {
+      "title": { "tr": "Ölçülebilir sonuçlar", "en": "Key results" },
+      "fields": {
+        "goal_id": { "type": "text", "title": { "tr": "Hedef", "en": "Goal" }, "required": true, "maxLength": 36, "index": true },
+        "name": { "type": "text", "title": { "tr": "Ölçüt", "en": "Metric" }, "required": true, "maxLength": 160 },
+        "unit": { "type": "text", "title": { "tr": "Birim", "en": "Unit" }, "maxLength": 20 },
+        "start_value": { "type": "number", "title": { "tr": "Başlangıç değeri", "en": "Start value" }, "required": true, "default": 0 },
+        "target_value": { "type": "number", "title": { "tr": "Hedef değer", "en": "Target value" }, "required": true },
+        "current_value": { "type": "number", "title": { "tr": "Güncel değer", "en": "Current value" }, "required": true, "default": 0 },
+        "progress": { "type": "number", "title": { "tr": "İlerleme (%)", "en": "Progress (%)" }, "required": true, "default": 0, "min": 0, "max": 100 }
+      }
+    },
+    "check_ins": {
+      "title": { "tr": "Değer güncellemeleri", "en": "Check-ins" },
+      "fields": {
+        "key_result_id": { "type": "text", "title": { "tr": "Ölçülebilir sonuç", "en": "Key result" }, "required": true, "maxLength": 36, "index": true },
+        "goal_id": { "type": "text", "title": { "tr": "Hedef", "en": "Goal" }, "required": true, "maxLength": 36, "index": true },
+        "old_value": { "type": "number", "title": { "tr": "Önceki değer", "en": "Previous value" }, "required": true },
+        "new_value": { "type": "number", "title": { "tr": "Yeni değer", "en": "New value" }, "required": true },
+        "note": { "type": "text", "title": { "tr": "Not", "en": "Note" }, "maxLength": 200 },
+        "actor_name": { "type": "text", "title": { "tr": "Güncelleyen", "en": "Updated by" }, "maxLength": 120 }
+      }
+    },
+    "actions": {
+      "title": { "tr": "Aksiyonlar", "en": "Actions" },
+      "fields": {
+        "goal_id": { "type": "text", "title": { "tr": "Hedef", "en": "Goal" }, "required": true, "maxLength": 36, "index": true },
+        "description": { "type": "text", "title": { "tr": "Aksiyon", "en": "Action" }, "required": true, "maxLength": 200 },
+        "owner_org_id": { "type": "text", "title": { "tr": "Sorumlu (kimlik)", "en": "Owner (id)" }, "maxLength": 24 },
+        "owner_name": { "type": "text", "title": { "tr": "Sorumlu", "en": "Owner" }, "maxLength": 120 },
+        "due_date": { "type": "date", "title": { "tr": "Termin", "en": "Due date" } },
+        "done": { "type": "boolean", "title": { "tr": "Tamamlandı", "en": "Done" }, "required": true, "default": false },
+        "done_at": { "type": "datetime", "title": { "tr": "Tamamlanma", "en": "Done at" } }
+      }
+    }
+  }
+}

package/templates/hedef-takibi/files/src/agent.ts.tpl

@@ -0,0 +1,26 @@
+// Devoplus yapay zekâsının bu uygulamada çağırabileceği araçların İŞLEYİCİLERİ. Adı, açıklaması, girdi şeması,
+// salt-okunurluğu ve izni `one.manifest.json` → `agent.tools`'tadır; rehber `AGENT_GUIDE.md`'dir. Yeni araç = üçü birlikte.
+// Araç yalnız uygulamanın KENDİ veritabanını okur ve yalnız hedef yöneticisi iznine ({{permissionPrefix}}Manage) açıktır:
+// özet bütün ekipleri kapsar, yönetici-çalışan ilişkisi burada çözülmez. Hedef açan, değer güncelleyen ya da dönem
+// kapatan araç bilinçli olarak YOKTUR.
+import { defineAgentTools } from '@devoplus/one-sdk'
+import type { Env } from './app.ts'
+import { findPeriod, lowestGoals, periodSummary } from './queries.ts'
+
+export const agentTools = defineAgentTools<Env>({
+  'period-summary': {
+    handler: async ({ input, env }) => {
+      const code = typeof input.period === 'string' && input.period.trim() !== '' ? input.period.trim() : null
+      const period = await findPeriod(env, { code })
+      if (!period) return { period: null, overall: 0, goalCount: 0, teams: [], lowest: [] }
+      const summary = await periodSummary(env, period.id, null)
+      return {
+        period: { code: period.code, name: period.name, status: period.status, start: period.start_date, end: period.end_date },
+        overall: summary.overall,
+        goalCount: summary.goalCount,
+        teams: summary.teams.map((t) => ({ team: t.team_name, goals: t.goals, progress: t.progress })),
+        lowest: await lowestGoals(env, period.id, null, 5),
+      }
+    },
+  },
+})