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

package/templates/shell.test.ts.tpl

@@ -0,0 +1,30 @@
+import { describe, expect, it } from 'vitest'
+import { STRINGS, normalizeLang, normalizeTheme, renderShell, renderShellScript } from './shell.ts'
+
+describe('kabuk', () => {
+  it('iki dilin anahtar kümeleri aynıdır (yeni metin iki dile birden eklenir)', () => {
+    expect(Object.keys(STRINGS.en).sort()).toEqual(Object.keys(STRINGS.tr).sort())
+  })
+
+  it('sayfada satır içi betik yok; köprü ve sayfa betiği ayrı dosyadan yüklenir (platform satır içi betiği engeller)', () => {
+    const html = renderShell('tr', 'light')
+    expect(html).not.toMatch(/<script(?![^>]*\bsrc=)[^>]*>/)
+    expect(html).toContain('<script src="/one-bridge.js"></script>')
+    expect(html).toContain('<script src="/shell.js"></script>')
+  })
+
+  it('sayfa betiği Portal ile yalnız köprüden konuşur ve menüyü Portal\'a bildirir', () => {
+    const script = renderShellScript([{ path: '/', label: { tr: 'Ana sayfa', en: 'Home' } }])
+    expect(script).not.toMatch(/postMessage/)
+    expect(script).toContain('one.start({ navigation: NAVIGATION })')
+    expect(script).toContain('"path":"/"')
+  })
+
+  it('ilk çizim dil/tema sorgusunu uygular; bilinmeyen değer varsayılana düşer', () => {
+    expect(normalizeLang('en-US')).toBe('en')
+    expect(normalizeLang(null)).toBe('tr')
+    expect(normalizeTheme('DARK')).toBe('dark')
+    expect(normalizeTheme('x')).toBe('light')
+    expect(renderShell('en', 'dark')).toContain('<html lang="en" data-theme="dark">')
+  })
+})

package/templates/shell.ts.tpl

@@ -0,0 +1,201 @@
+// Kabuk: HTML sayfası + ayrı betik dosyası (bundler yok). Satır içi betik platformda KAPALIDIR (CSP `script-src 'self'`):
+// sayfa Devoplus One köprüsünü `/one-bridge.js`, kendi betiğini `/shell.js` adresinden yükler, görsel dili `/one-ui.css`'ten
+// alır. Portal ile her konuşma `window.one` köprüsünden geçer (sözleşme: AGENTS.md "Portal köprüsü").
+//   src sorgusu   parent=<portal origin[,…]>  lang=<tr-TR|en-US|…>  theme=<light|dark>   (ilk yükleme)
+//   Portal → app  belirteç · bağlam (tema, dil, Vekalet/Yerine Görüntüle, tasarım) · sekme gezinmesi · görünen alan
+//   app → Portal  hazır · menü · yol · yükseklik · alt başlık · bildirim · onay · indirme · dış bağlantı · kaydedilmemiş değişiklik
+// Menüyü (sekmeleri) ve kullanıcı/portal üst bilgisini Portal çizer: bu sayfa sol menü ya da kendi üst bilgisini ÇİZMEZ.
+// Bildirim ve onay penceresi de Portal'dadır (`one.toast`, `one.confirm`): sayfa uzunsa `position: fixed` ekranın dışında kalır.
+// ⛔ Kök öğelerde 100vh / height:100% kullanmayın: içerik iframe boyuna bağlanırsa yükseklik hiç küçülmez.
+// Belirteç yalnız Portal'dan gelir; bu sayfa kendi başına oturum açamaz. Tema/dil değişince iframe YENİDEN YÜKLENMEZ;
+// kabuk metinleri yerinde değiştirir.
+import type { OneNavigationItem } from '@devoplus/one-sdk'
+
+export type Lang = 'tr' | 'en'
+export type Theme = 'light' | 'dark'
+
+export function normalizeLang(raw: string | null | undefined): Lang {
+  return (raw ?? '').trim().toLowerCase().startsWith('en') ? 'en' : 'tr'
+}
+
+export function normalizeTheme(raw: string | null | undefined): Theme {
+  return (raw ?? '').trim().toLowerCase() === 'dark' ? 'dark' : 'light'
+}
+
+/** Kullanıcıya görünen metinler; iki dil de sayfaya gömülür ve one:context ile yerinde değişir. Yeni metin İKİ dile birden eklenir (test anahtar kümelerini karşılaştırır). */
+export const STRINGS: Record<Lang, Record<string, string>> = {
+  tr: {
+    title: {{nameTrJs}},
+    waiting: "Portal'dan oturum bekleniyor…",
+    ready: 'Oturum alındı.',
+    networkError: 'İstek gönderilemedi (ağ hatası).',
+    me: 'Kullanıcı bilgim',
+    notes: 'Notlarım (bu kurulumun veritabanı)',
+    notePlaceholder: 'Yeni not…',
+    add: 'Ekle',
+    refresh: 'Yenile',
+    remove: 'Sil',
+    empty: 'Henüz not yok.',
+    added: 'Not eklendi.',
+    removed: 'Not silindi.',
+    removeTitle: 'Notu sil',
+    removeConfirm: 'Bu not silinsin mi? Bu işlem geri alınamaz.',
+    readOnly: 'Vekalet ya da Yerine Görüntüle oturumundasınız: bu uygulamada yalnız görüntüleme yapabilirsiniz.',
+    output: 'Son yanıt',
+  },
+  en: {
+    title: {{nameEnJs}},
+    waiting: 'Waiting for the session from the Portal…',
+    ready: 'Session received.',
+    networkError: 'Request could not be sent (network error).',
+    me: 'My user info',
+    notes: 'My notes (this installation’s database)',
+    notePlaceholder: 'New note…',
+    add: 'Add',
+    refresh: 'Refresh',
+    remove: 'Delete',
+    empty: 'No notes yet.',
+    added: 'Note added.',
+    removed: 'Note deleted.',
+    removeTitle: 'Delete note',
+    removeConfirm: 'Delete this note? This cannot be undone.',
+    readOnly: 'You are in a Delegation or View as User session: you can only view this app.',
+    output: 'Last response',
+  },
+}
+
+function escapeHtml(value: string): string {
+  return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;')
+}
+
+/** İlk çizim `lang`/`theme` sorgusuyla yapılır; sonraki değişimler `/shell.js`'te one:context ile uygulanır. */
+export function renderShell(lang: Lang, theme: Theme): string {
+  const s = STRINGS[lang]
+  const tx = (key: string): string => s[key] ?? STRINGS.tr[key] ?? key
+
+  return `<!doctype html>
+<html lang="${lang}" data-theme="${theme}"><head><meta charset="utf-8"><title>${escapeHtml(tx('title'))}</title>
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<link rel="stylesheet" href="/one-ui.css">
+<style>
+#noteText{flex:1 1 16rem;width:auto}
+.notes{list-style:none;padding:0;margin:8px 0}.notes li{display:flex;justify-content:space-between;align-items:center;gap:8px;padding:6px 0;border-bottom:1px solid var(--one-border)}
+pre{background:var(--one-surface);border:1px solid var(--one-border);padding:12px;border-radius:var(--one-radius);overflow:auto;max-height:24rem;white-space:pre-wrap;word-break:break-word}
+</style></head><body>
+<p id="status" class="one-muted">${escapeHtml(tx('waiting'))}</p>
+<div id="readOnly" class="one-message one-message-info" data-i18n="readOnly" hidden>${escapeHtml(tx('readOnly'))}</div>
+<div class="one-row"><button type="button" class="one-btn" data-act="me" data-i18n="me">${escapeHtml(tx('me'))}</button></div>
+<h2 data-i18n="notes">${escapeHtml(tx('notes'))}</h2>
+<div class="one-row"><input type="text" class="one-input" id="noteText" maxlength="500" data-i18n-ph="notePlaceholder" placeholder="${escapeHtml(tx('notePlaceholder'))}"><button type="button" class="one-btn one-btn-primary" data-act="add" data-i18n="add">${escapeHtml(tx('add'))}</button><button type="button" class="one-btn" data-act="refresh" data-i18n="refresh">${escapeHtml(tx('refresh'))}</button></div>
+<ul id="notes" class="notes"></ul>
+<h2 data-i18n="output">${escapeHtml(tx('output'))}</h2>
+<pre id="out"></pre>
+<script src="/one-bridge.js"></script>
+<script src="/shell.js"></script>
+</body></html>`
+}
+
+/**
+ * `/shell.js` — sayfanın betiği. Metinler ve menü sunucuda gömülür (JSON); ilk dil/tema `<html>` niteliklerinden okunur.
+ * Yeni bir görünüm (ör. `/reports`) eklerken: manifest `navigation`'a yolu yazın, `one.onNavigate` ile görünümü değiştirin,
+ * kendi geçişlerinizde `one.setRoute(yol)` çağırın. Sol menü ya da üst bilgi ÇİZMEYİN — sekmeleri Portal çizer.
+ */
+export function renderShellScript(
+  navigation: readonly OneNavigationItem[],
+  options: { actingWrites?: boolean } = {},
+): string {
+  // JSON bir betik dosyasına gömülüyor; "</" dizisi kaçırılır.
+  const json = (value: unknown): string => JSON.stringify(value).replace(/<\//g, '<\\/')
+  return `(function () {
+  var one = window.one;
+  var S = ${json(STRINGS)};
+  var NAVIGATION = ${json(navigation)};
+  // manifest actingSessions: "write" ise Vekalet / Yerine Görüntüle oturumunda da yazılır → salt-okunur uyarısı gösterilmez.
+  var ACTING_WRITES = ${json(options.actingWrites === true)};
+  var root = document.documentElement;
+  var lang = root.lang === 'en' ? 'en' : 'tr', theme = root.getAttribute('data-theme') === 'dark' ? 'dark' : 'light';
+  // Durum satırı bir metin ANAHTARI taşır ve one:context gelince o anahtar yeni dile çevrilir. Metni doğrudan
+  // textContent'e yazmayın: dil değişiminde eski dilde kalır ya da başka bir durumla (ör. ağ hatası → "hazır") ezilir.
+  var statusKey = 'waiting', hadToken = false;
+  function $(id) { return document.getElementById(id); }
+  function t(k) { return (S[lang] && S[lang][k]) || S.tr[k] || k; }
+  function showStatus(key) { statusKey = key; $('status').textContent = t(key); }
+  function apply(nextLang, nextTheme) {
+    lang = String(nextLang || '').toLowerCase().indexOf('en') === 0 ? 'en' : 'tr';
+    theme = nextTheme === 'dark' ? 'dark' : 'light';
+    document.documentElement.lang = lang; document.documentElement.setAttribute('data-theme', theme);
+    var nodes = document.querySelectorAll('[data-i18n]');
+    for (var i = 0; i < nodes.length; i++) nodes[i].textContent = t(nodes[i].getAttribute('data-i18n'));
+    var phs = document.querySelectorAll('[data-i18n-ph]');
+    for (var j = 0; j < phs.length; j++) phs[j].setAttribute('placeholder', t(phs[j].getAttribute('data-i18n-ph')));
+    showStatus(statusKey);
+  }
+  // Her istek Portal'dan gelen belirteci taşır (one.fetch); belirteç henüz yoksa istek yine gider, uygulama 401 döner.
+  function call(method, path, body) {
+    var headers = {};
+    if (body !== undefined) headers['content-type'] = 'application/json';
+    return one.fetch(path, { method: method, headers: headers, body: body === undefined ? undefined : JSON.stringify(body) })
+      .then(function (r) {
+        return r.text().then(function (text) {
+          var data = text;
+          try { data = JSON.parse(text); } catch (e) {}
+          $('out').textContent = JSON.stringify({ status: r.status, body: data }, null, 2);
+          // Yanıt geldiyse önceki ağ hatası artık geçerli değildir; durum satırı oturum durumuna döner.
+          if (statusKey === 'networkError') showStatus(one.token ? 'ready' : 'waiting');
+          return { ok: r.ok, body: data };
+        });
+      })
+      .catch(function (e) { $('out').textContent = String(e); showStatus('networkError'); return { ok: false, body: null }; });
+  }
+  function renderNotes(notes) {
+    var ul = $('notes'); ul.textContent = '';
+    // Sonradan eklenen metinler de data-i18n taşır ki one:context gelince yeni dile çevrilsin.
+    if (!notes || !notes.length) { var empty = document.createElement('li'); empty.setAttribute('data-i18n', 'empty'); empty.textContent = t('empty'); ul.appendChild(empty); return; }
+    for (var i = 0; i < notes.length; i++) (function (n) {
+      // Metin textContent ile yazılır: not içeriği kullanıcı girdisidir, HTML olarak YORUMLANMAZ.
+      var li = document.createElement('li'); var span = document.createElement('span'); span.textContent = n.text;
+      var del = document.createElement('button'); del.type = 'button'; del.setAttribute('class', 'one-btn'); del.setAttribute('data-i18n', 'remove'); del.textContent = t('remove');
+      del.addEventListener('click', function () { remove(n.id); });
+      li.appendChild(span); li.appendChild(del); ul.appendChild(li);
+    })(notes[i]);
+  }
+  function refresh() { return call('GET', '/api/notes').then(function (r) { if (r.ok) renderNotes(r.body && r.body.notes); }); }
+  // Onay penceresini Portal çizer: sayfa uzunsa sayfanın kendi penceresi ekranın dışında kalırdı.
+  function remove(id) {
+    return one.confirm({ title: t('removeTitle'), message: t('removeConfirm'), severity: 'danger', acceptLabel: t('remove') }).then(function (ok) {
+      if (!ok) return;
+      return call('DELETE', '/api/notes/' + encodeURIComponent(id)).then(function (r) {
+        if (r.ok) one.toast({ severity: 'success', summary: t('removed') });
+        return refresh();
+      });
+    });
+  }
+  var ACTIONS = {
+    me: function () { return call('GET', '/api/me'); },
+    refresh: refresh,
+    add: function () {
+      var text = ($('noteText').value || '').trim();
+      if (!text) return;
+      return call('POST', '/api/notes', { text: text }).then(function (r) {
+        if (!r.ok) return;
+        $('noteText').value = ''; one.setDirty(false);
+        one.toast({ severity: 'success', summary: t('added') });
+        return refresh();
+      });
+    }
+  };
+  var buttons = document.querySelectorAll('[data-act]');
+  for (var b = 0; b < buttons.length; b++) (function (btn) { btn.addEventListener('click', function () { ACTIONS[btn.getAttribute('data-act')](); }); })(buttons[b]);
+  // Yazılmış ama eklenmemiş not "kaydedilmemiş değişiklik"tir: Portal kullanıcı ayrılmadan önce sorar.
+  $('noteText').addEventListener('input', function () { one.setDirty(($('noteText').value || '').trim() !== ''); });
+  one.onToken(function () { var first = !hadToken; hadToken = true; showStatus('ready'); if (first) refresh(); });
+  one.onContext(function (c) {
+    apply(c.lang, c.theme);
+    // Vekalet / Yerine Görüntüle oturumunda platform yazma isteklerini reddeder; kullanıcıya baştan söylenir.
+    if (c.actor && !ACTING_WRITES) $('readOnly').removeAttribute('hidden'); else $('readOnly').setAttribute('hidden', '');
+  });
+  apply(lang, theme);
+  one.start({ navigation: NAVIGATION });
+})();
+`
+}

package/templates/uygunsuzluk-dof/AGENTS.template.md.tpl

@@ -0,0 +1,40 @@
+## Bu uygulamanın şablonu: uygunsuzluk ve düzeltici faaliyet (`uygunsuzluk-dof`)
+
+Uygulama `create-devoplus-one-app --template uygunsuzluk-dof` 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: `nonconformities` (kayıt) + `actions` (düzeltici faaliyet) + `reminder_runs` (hatırlatma turu). Değişince `pnpm data:generate` |
+| `src/app.ts` | Uçlar: bildirim, kayıt düzenleme, durum akışı, faaliyet ekle/değiştir/sil/tamamla, faaliyetlerim, özet |
+| `src/capa.ts` | Saf kurallar: geçiş tablosu ve koşulları, termin doğrulama, gecikme, hatırlatma metni + `capa.test.ts` |
+| `src/jobs.ts` | Sabah işi `overdue-reminders` (geciken faaliyet e-postası; uygulama kimliğiyle, günde bir kez) |
+| `src/queries.ts` | Ekran, iş ve yapay zekâ araçlarının ortak sorguları |
+| `src/shell.ts` | Sayfa: Faaliyetlerim · Uygunsuzluk bildir · Kayıtlar + kayıt paneli |
+| `src/agent.ts` · `AGENT_GUIDE.md` | Devoplus yapay zekâsının araçları ve rehberi |
+| `src/lib/*` | Şablonların ortak parçaları — gerekmedikçe değiştirmeyin |
+
+Değişmezler (bozmayın):
+
+- **Durum YALNIZ `/status` ucundan ve yalnız `capa.ts` geçiş tablosuyla değişir.** Bildirim ve düzenleme uçları
+  `status`, `closed_*` alanlarını istemciden ALMAZ (400). Geçişin koşulu (kök neden + faaliyet, bütün faaliyetler
+  tamamlandı) güncelleme ifadesinin İÇİNDEDİR; "önce say, sonra yaz"a çevirmeyin — araya giren bir faaliyet eklemesi
+  kapanışı geçersiz kılamazdı. Doğrulamada etkisiz bulunan kayıt (`verification_failed_at`) yeniden doğrulamaya ancak o
+  andan SONRA eklenmiş bir faaliyetle geçer; bu koşul da aynı ifadededir.
+- **Kapanmış kayıt değişmez:** düzenleme hazır kayıt ucuna iletilmez; `lib/record.ts` ile doğrulanıp
+  `… WHERE status <> 'closed'` koşullu tek ifadeyle yazılır (eşleşmezse 409). Durumu önce okuyup sonra yazmayın.
+- **Bütün geçişler ve faaliyet yönetimi yöneticinindir** (`…Manage`, 403). Faaliyeti sorumlusu ya da yönetici
+  tamamlar; başkasının faaliyeti "bulunamadı" (404) döner — yönetici olmayan kişi için "hâlâ sorumlusu" koşulu tamamlama
+  ifadesindedir. Faaliyet yalnız "açık" ve "faaliyet planlandı" durumundaki kayıtta eklenir, değişir, silinir ve
+  tamamlanır (409). Faaliyet kaydın başlığının kopyasını taşır: başlık düzenlemesi kopyaları aynı toplu yazımda günceller.
+- **Görünürlük:** bütün kayıt ve faaliyet listeleri yöneticiye açıktır; diğer kişi yalnız kendi bildirdiği kaydı,
+  sorumlusu olduğu faaliyeti ve o faaliyetin kaydını görür. "Faaliyetlerim" listesinde sorumlu süzgecini SUNUCU yazar.
+- **Kişi kimlikleri:** faaliyet sorumlusu `owner_org_id` (Organization Schema kimliği → `toOrgUserIds`). Oturum
+  kimliği (`sub`) ile karıştırmayın; "benim faaliyetlerim" `getMyOrgContext` ile çözülür.
+- **Hatırlatma günde bir kez:** faaliyet o günün anahtarıyla koşullu damgalanır (`reminded_on`); e-posta yalnız
+  damgalananlar için gider, gönderim başarısızsa damga önceki değerine döner. Sorumlu ya da termin değişince damga
+  sıfırlanır. İş uygulama kimliğiyle gönderir (manifest `jobs.services: ["mail.execute"]` + kurulumda yönetici onayı);
+  onaysız servis 403 döner ve tur "onay gerekiyor" olarak kaydedilir. Bir turda en çok `REMINDER_OWNERS_PER_RUN` kişi;
+  hatırlatması ulaşmayan sorumlu (`reminder_failed_on`) sıranın sonuna geçer, ötekileri hatırlatmasız bırakmaz.
+- Bu bir onay akışı DEĞİLDİR (kurumun İş Akışı modülü vardır); onaylayan zinciri eklemeyin. Telefon numarası alanı
+  EKLEMEYİN.

package/templates/uygunsuzluk-dof/README.md.tpl

@@ -0,0 +1,46 @@
+# {{nameTr}}
+
+Kalite ve iş güvenliği uygunsuzluklarını ve onlar için yapılan düzeltici faaliyetleri (DÖF) izleyen bir kayıt
+uygulaması. Devoplus Portal'ın içinde, Portal menüsünden açılır. Bu uygulama Devoplus One'ın **uygunsuzluk ve
+düzeltici faaliyet** şablonundan üretildi; ihtiyacınıza göre değiştirilecek bir başlangıç noktasıdır.
+
+## Ne yapar
+
+1. **Uygunsuzluk bildir:** herkes gördüğü bir uygunsuzluğu kaynağı (denetim, müşteri şikâyeti, iç tespit, iş
+   güvenliği), önemi, açıklaması ve isterse bir dosya ekiyle bildirir. Bildirdiği kayıtları aynı sekmede görür.
+2. **Kayıtlar:** kalite ekibi bütün kayıtları görür, kök nedeni yazar ve sorumlusu ile termini olan düzeltici
+   faaliyetler açar. Sorumluya e-posta gider. Kayıtlar ve faaliyetler Excel'e aktarılabilir.
+3. **Durum akışı:** kayıt "açık → faaliyet planlandı → doğrulama → kapandı" sırasıyla ilerler. Faaliyet planlamak için
+   kök neden ve en az bir faaliyet gerekir; doğrulamaya geçmek ve kapatmak için bütün faaliyetler tamamlanmış olmalıdır.
+   Doğrulamada faaliyet yetersiz bulunursa kayıt yeniden "faaliyet planlandı"ya alınır; tekrar doğrulamaya geçmek için
+   yeni bir faaliyet eklenip tamamlanmalıdır.
+4. **Faaliyetlerim:** faaliyetin sorumlusu kendi faaliyetlerini görür ve ne yaptığını yazarak tamamlar.
+5. **Hatırlatma:** termini geçen faaliyet her sabah 08:00'de sorumlusuna e-postayla hatırlatılır; aynı gün ikinci kez
+   gönderilmez. Bir sabahta en çok 8 kişiye gider, kalanlar ertesi sabah gelir.
+6. **Devoplus asistanı:** "Geciken faaliyetler hangileri?" gibi sorular Devoplus'un yapay zekâ asistanına
+   sorulduğunda cevap bu uygulamadan gelir.
+
+Bu uygulama bir onay akışı değildir: onay gereken işler kurumunuzun İş Akışı modülünde kalır.
+
+## Kimler ne görür
+
+| Kim | Ne yapabilir |
+|---|---|
+| Uygulamayı kullanma izni olan herkes ({{permissionCode}}) | Uygunsuzluk bildirir; kendi bildirdiklerini ve sorumlusu olduğu faaliyetleri görür, faaliyetini tamamlar |
+| Kalite ekibi ({{permissionPrefix}}Manage) | Bütün kayıtları görür, kök neden yazar, faaliyet açar ve değiştirir, durumu ilerletir ve kaydı kapatır |
+
+İzinleri portal yöneticisi **Yetki Yönetimi** ekranından verir.
+
+## Neleri değiştirebilirsiniz
+
+Yapay zekâ aracınıza iş diliyle söylemeniz yeterlidir:
+
+- "Kaynaklara *tedarikçi* de eklensin" — yeni seçenek.
+- "Kritik uygunsuzluk bildirilince kalite müdürüne hemen e-posta gitsin" — yeni bildirim.
+- "Faaliyet tamamlanırken kanıt fotoğrafı istensin" — yeni alan.
+- "Hatırlatma termin gününden iki gün önce de gelsin" — hatırlatma kuralı.
+
+Bilinmesi gerekenler: faaliyet açıldığında sorumluya giden e-posta, işlemi yapan kişinin Portal'daki **"İzinleri
+incele"** düğmesiyle e-posta izni vermiş olmasını gerektirir. Sabah hatırlatması kişi adına değil uygulama adına gider;
+bunun için portal yöneticisinin uygulama kurulumunda e-posta servisini onaylaması gerekir. Onay yoksa durum Kayıtlar
+sekmesinde yazar.

package/templates/uygunsuzluk-dof/files/AGENT_GUIDE.md.tpl

@@ -0,0 +1,56 @@
+# {{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}}, kalite ve iş güvenliği uygunsuzluklarını ve onlar için açılan düzeltici faaliyetleri kaydeder. Herkes bir
+uygunsuzluk bildirebilir (denetim, müşteri şikâyeti, iç tespit ya da iş güvenliği). Kalite ekibi kök nedeni yazar,
+sorumlusu ve termini olan düzeltici faaliyetler açar, kaydı "açık → faaliyet planlandı → doğrulama → kapandı" sırasıyla
+ilerletir. Kayıt yalnız bütün faaliyetler tamamlanınca kapanır. Faaliyetin sorumlusu ne yaptığını yazarak faaliyeti
+tamamlar. Termini geçen faaliyet her sabah sorumlusuna e-postayla hatırlatılır (günde en çok bir kez). Kullanıcı
+"geciken faaliyetler hangileri", "kaç açık uygunsuzluk var", "Ahmet'in geciken işi var mı" gibi şeyler sorduğunda bu
+uygulamaya başvurun. Bu bir onay akışı değildir; kayıt açan, durum değiştiren ya da faaliyet tamamlayan araç yoktur.
+
+## Veri
+
+- **Uygunsuzluk** (`nonconformities`): konu, kaynak (`audit` denetim · `customer_complaint` müşteri şikâyeti ·
+  `internal` iç tespit · `safety` iş güvenliği), önem (`low` · `medium` · `high` · `critical`), açıklama, yer, tespit
+  tarihi, bildiren, kök neden, durum (`open` açık · `planned` faaliyet planlandı · `verification` doğrulama · `closed`
+  kapandı), kapanış zamanı ve notu.
+- **Düzeltici faaliyet** (`actions`): bağlı uygunsuzluk, faaliyet metni, sorumlu kişinin adı, termin (gün), durum
+  (`open` açık · `done` tamamlandı), ne yapıldığı.
+- Faaliyet, termininden SONRAKİ gün "gecikmiş" sayılır. Kapanmış kayıtlardaki faaliyetler gecikmiş sayılmaz.
+- **Hatırlatma turu** (`reminder_runs`): her sabahki e-posta turunun özeti; e-posta servisi kurulumda onaylanmamışsa
+  "onay gerekiyor" olarak kaydedilir.
+
+## Araçlar
+
+### `overdue-actions` — geciken faaliyetler (salt okunur)
+
+- **Ne zaman:** kullanıcı termini geçmiş faaliyetleri, kimin işinin geciktiğini ya da neyin acil olduğunu sorduğunda.
+- **Girdi:** `owner` (isteğe bağlı) — sorumlunun adında geçen ifade; `limit` (1-50, varsayılan 20).
+- **Çıktı:** `{ "total": 7, "actions": [{ "action", "owner", "dueDate", "daysOverdue", "nonconformity", "severity" }] }`
+  — en çok geciken önce; `total` süzgeçsiz toplam sayıdır.
+- **Dikkat:** adda büyük/küçük harf eşleşmesi yalnız Latin harflerde yok sayılır; Türkçe harfli bir aramada sonuç
+  çıkmazsa ifadeyi küçük harfle yeniden deneyin. Yalnız yöneticiler kullanabilir.
+
+### `nonconformity-summary` — uygunsuzluk özeti (salt okunur)
+
+- **Ne zaman:** kullanıcı kaç kaydın açık olduğunu, önem ya da kaynağa göre dağılımı veya hatırlatmaların gidip
+  gitmediğini sorduğunda.
+- **Girdi:** yok.
+- **Çıktı:** `{ "byStatus": { "open": 3, … }, "openBySeverity": { "high": 1, … }, "openBySource": { "safety": 2, … },
+  "overdueActions": 4, "lastReminderRun": { "day", "ownersReminded", "actionsReminded", "failed", "deferred",
+  "approvalNeeded" } }` — hiç tur yapılmadıysa `lastReminderRun` `null`. `approvalNeeded: true` ise e-posta
+  gönderilemedi: portal yöneticisinin kurulumda arka plan işi e-posta onayını vermesi gerekir.
+
+## Örnek istekler
+
+- "Geciken düzeltici faaliyetler hangileri?" → `overdue-actions`
+- "Ahmet'in geciken işi var mı?" → `overdue-actions` (`owner: "ahmet"`)
+- "Kaç açık uygunsuzluk var, kritik olan var mı?" → `nonconformity-summary` → `byStatus`, `openBySeverity`
+- "Hatırlatma e-postaları gidiyor mu?" → `nonconformity-summary` → `lastReminderRun`
+- "Depodaki yangın tüpü için kayıt aç." → araç yok; kullanıcıyı uygulamanın Uygunsuzluk bildir sekmesine yönlendirin.

package/templates/uygunsuzluk-dof/files/one.data.json

@@ -0,0 +1,99 @@
+{
+  "version": 1,
+  "entities": {
+    "nonconformities": {
+      "title": { "tr": "Uygunsuzluklar", "en": "Nonconformities" },
+      "fields": {
+        "title": { "type": "text", "title": { "tr": "Konu", "en": "Subject" }, "required": true, "maxLength": 120 },
+        "source": {
+          "type": "choice",
+          "title": { "tr": "Kaynak", "en": "Source" },
+          "required": true,
+          "default": "internal",
+          "index": true,
+          "choices": [
+            { "value": "audit", "title": { "tr": "Denetim", "en": "Audit" } },
+            { "value": "customer_complaint", "title": { "tr": "Müşteri şikâyeti", "en": "Customer complaint" } },
+            { "value": "internal", "title": { "tr": "İç tespit", "en": "Internal finding" } },
+            { "value": "safety", "title": { "tr": "İş güvenliği", "en": "Occupational safety" } }
+          ]
+        },
+        "severity": {
+          "type": "choice",
+          "title": { "tr": "Önem", "en": "Severity" },
+          "required": true,
+          "default": "medium",
+          "index": true,
+          "choices": [
+            { "value": "low", "title": { "tr": "Düşük", "en": "Low" } },
+            { "value": "medium", "title": { "tr": "Orta", "en": "Medium" } },
+            { "value": "high", "title": { "tr": "Yüksek", "en": "High" } },
+            { "value": "critical", "title": { "tr": "Kritik", "en": "Critical" } }
+          ]
+        },
+        "description": { "type": "longText", "title": { "tr": "Açıklama", "en": "Description" }, "required": true, "maxLength": 4000 },
+        "location": { "type": "text", "title": { "tr": "Yer", "en": "Location" }, "maxLength": 120 },
+        "detected_on": { "type": "date", "title": { "tr": "Tespit tarihi", "en": "Detected on" }, "index": true },
+        "reporter_name": { "type": "text", "title": { "tr": "Bildiren", "en": "Reported by" }, "maxLength": 120 },
+        "root_cause": { "type": "longText", "title": { "tr": "Kök neden", "en": "Root cause" }, "maxLength": 4000 },
+        "status": {
+          "type": "choice",
+          "title": { "tr": "Durum", "en": "Status" },
+          "required": true,
+          "default": "open",
+          "index": true,
+          "choices": [
+            { "value": "open", "title": { "tr": "Açık", "en": "Open" } },
+            { "value": "planned", "title": { "tr": "Faaliyet planlandı", "en": "Actions planned" } },
+            { "value": "verification", "title": { "tr": "Doğrulama", "en": "Verification" } },
+            { "value": "closed", "title": { "tr": "Kapandı", "en": "Closed" } }
+          ]
+        },
+        "attachment": { "type": "file", "title": { "tr": "Dosya eki", "en": "Attachment" } },
+        "attachment_name": { "type": "text", "title": { "tr": "Ek dosya adı", "en": "Attachment name" }, "maxLength": 200 },
+        "closed_at": { "type": "datetime", "title": { "tr": "Kapanma zamanı", "en": "Closed at" } },
+        "closed_by_name": { "type": "text", "title": { "tr": "Kapatan", "en": "Closed by" }, "maxLength": 120 },
+        "closure_note": { "type": "longText", "title": { "tr": "Kapanış notu", "en": "Closing note" }, "maxLength": 2000 },
+        "verification_failed_at": { "type": "datetime", "title": { "tr": "Doğrulamada etkisiz bulundu", "en": "Found ineffective at" } }
+      }
+    },
+    "actions": {
+      "title": { "tr": "Düzeltici faaliyetler", "en": "Corrective actions" },
+      "fields": {
+        "nonconformity_id": { "type": "text", "title": { "tr": "Uygunsuzluk (kimlik)", "en": "Nonconformity (id)" }, "required": true, "maxLength": 36, "index": true },
+        "nonconformity_title": { "type": "text", "title": { "tr": "Uygunsuzluk", "en": "Nonconformity" }, "maxLength": 120 },
+        "description": { "type": "longText", "title": { "tr": "Faaliyet", "en": "Action" }, "required": true, "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 },
+        "due_date": { "type": "date", "title": { "tr": "Termin", "en": "Due date" }, "required": true, "index": 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": "done", "title": { "tr": "Tamamlandı", "en": "Done" } }
+          ]
+        },
+        "done_at": { "type": "datetime", "title": { "tr": "Tamamlanma", "en": "Done at" } },
+        "done_note": { "type": "text", "title": { "tr": "Yapılan", "en": "What was done" }, "maxLength": 500 },
+        "done_by_name": { "type": "text", "title": { "tr": "Tamamlayan", "en": "Done by" }, "maxLength": 120 },
+        "reminded_on": { "type": "text", "title": { "tr": "Son hatırlatma günü", "en": "Last reminder day" }, "maxLength": 10 },
+        "reminder_failed_on": { "type": "date", "title": { "tr": "Hatırlatmanın ulaşmadığı son gün", "en": "Last undelivered reminder" } }
+      }
+    },
+    "reminder_runs": {
+      "title": { "tr": "Geciken faaliyet hatırlatmaları", "en": "Overdue action reminders" },
+      "fields": {
+        "run_key": { "type": "text", "title": { "tr": "Gün", "en": "Day" }, "required": true, "unique": true, "maxLength": 20 },
+        "reminded_owners": { "type": "number", "title": { "tr": "Hatırlatılan kişi", "en": "Owners reminded" }, "required": true, "default": 0, "min": 0 },
+        "reminded_actions": { "type": "number", "title": { "tr": "Hatırlatılan faaliyet", "en": "Actions reminded" }, "required": true, "default": 0, "min": 0 },
+        "failed": { "type": "number", "title": { "tr": "Gönderilemeyen", "en": "Failed" }, "required": true, "default": 0, "min": 0 },
+        "deferred_owners": { "type": "number", "title": { "tr": "Sonraki güne kalan", "en": "Deferred" }, "required": true, "default": 0, "min": 0 },
+        "consent_needed": { "type": "boolean", "title": { "tr": "Yönetici onayı gerekiyor", "en": "Approval needed" }, "required": true, "default": false }
+      }
+    }
+  }
+}

package/templates/uygunsuzluk-dof/files/src/agent.ts.tpl

@@ -0,0 +1,45 @@
+// 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çlar yalnız uygulamanın KENDİ veritabanını okur ve yalnız yöneticiye açıktır (manifest `permission`). Kayıt açan,
+// durum değiştiren ya da faaliyet tamamlayan araç bilinçli olarak yoktur.
+import { defineAgentTools } from '@devoplus/one-sdk'
+import type { Env } from './app.ts'
+import { daysOverdue, istanbulDay } from './capa.ts'
+import { counts, lastReminderRun, overdueActions, overdueCount } from './queries.ts'
+
+export const agentTools = defineAgentTools<Env>({
+  'overdue-actions': {
+    handler: async ({ input, env }) => {
+      const today = istanbulDay(new Date())
+      const limit = typeof input.limit === 'number' ? input.limit : 20
+      const owner = typeof input.owner === 'string' ? input.owner : undefined
+      const [rows, total] = await Promise.all([overdueActions(env, today, limit, owner), overdueCount(env, today, owner)])
+      return {
+        total,
+        actions: rows.map((r) => ({
+          action: r.description,
+          owner: r.owner_name,
+          dueDate: r.due_date,
+          daysOverdue: daysOverdue(r.due_date, today),
+          nonconformity: r.nonconformity_title,
+          severity: r.severity,
+        })),
+      }
+    },
+  },
+  'nonconformity-summary': {
+    handler: async ({ env }) => {
+      const today = istanbulDay(new Date())
+      const [c, overdue, run] = await Promise.all([counts(env), overdueCount(env, today), lastReminderRun(env)])
+      return {
+        byStatus: c.byStatus,
+        openBySeverity: c.openBySeverity,
+        openBySource: c.openBySource,
+        overdueActions: overdue,
+        lastReminderRun: run
+          ? { day: run.run_key, ownersReminded: run.reminded_owners, actionsReminded: run.reminded_actions, failed: run.failed, deferred: run.deferred, approvalNeeded: run.consent_needed === 1 }
+          : null,
+      }
+    },
+  },
+})