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

package/templates/egitim-sertifika/files/src/shell.ts.tpl

@@ -0,0 +1,345 @@
+// {{nameTr}} — sayfa (dört görünüm: Sertifikalarım · Ekibim · Tüm kayıtlar · Sertifika türleri). Liste, süzgeç, form,
+// kişi seçici ve dosya yükleyici hazır bileşenlerdir; alan adları veri modelinden gelir. Geçerlilik sonu, durum ve ekip
+// SUNUCUDA hesaplanır; sayfa yalnız gösterir.
+import type { OneNavigationItem } from '@devoplus/one-sdk'
+import { dataModel } from './data/types.ts'
+import { renderClientScript } from './lib/client.ts'
+import { label } from './lib/model.ts'
+import { escapeHtml, i18n, renderPage, translator, view, type Lang, type Strings, type Theme } from './lib/page.ts'
+
+export const STRINGS: Strings = {
+  tr: {
+    title: {{nameTrJs}},
+    waiting: "Portal'dan oturum bekleniyor…",
+    networkError: 'İstek gönderilemedi (ağ hatası).',
+    requestFailed: 'İşlem yapılamadı.',
+    readOnly: 'Vekalet ya da Yerine Görüntüle oturumundasınız: bu uygulamada yalnız görüntüleme yapabilirsiniz.',
+    myIntro: 'Size ait eğitim ve sertifika kayıtları. Geçerlilik sonu, tamamlanma tarihi ve türün geçerlilik süresinden hesaplanır. Belgeyi indirmek için satıra tıklayın.',
+    myBanner: '{expired} sertifikanızın süresi doldu, {expiring} sertifikanızın süresi 30 gün içinde doluyor.',
+    myNone: 'Süresi dolan ya da 30 gün içinde dolacak sertifikanız yok.',
+    teamIntro: 'Organizasyon şemasında size bağlı çalışanların kayıtları. Ekip bilgisi her açılışta organizasyon şemasından okunur.',
+    teamCount: 'Ekibinizde {n} kişi var.',
+    exportXlsx: "Excel'e aktar",
+    exportFailed: 'Dosya hazırlanamadı.',
+    listTruncated: "Liste çok uzun olduğu için ilk {n} kayıt gösteriliyor; tamamı için Excel'e aktarın.",
+    myTable: 'Sertifikalarım',
+    teamTable: 'Ekibimin sertifikaları',
+    status: 'Durum',
+    statusValid: 'Geçerli',
+    statusExpiring: 'Süresi doluyor',
+    statusExpired: 'Süresi doldu',
+    statusRenewed: 'Yenilendi',
+    statusNone: 'Süresiz',
+    noAttachment: 'Bu kayıtta belge yok.',
+    downloadFailed: 'Belge indirilemedi.',
+    recordsIntro: 'Bütün kayıtlar. Yeni kayıtta kişinin yöneticisi organizasyon şemasından alınır; yönetici değiştiyse "Yöneticileri yenile" ile güncelleyin.',
+    recordsBanner: 'Süresi dolmuş {expired}, 30 gün içinde dolacak {expiring} sertifika var (yenilenmiş olanlar hariç).',
+    lastRun: 'Son hatırlatma kontrolü: {day} — {sent} kişi için e-posta gönderildi.',
+    lastRunConsent: 'Son hatırlatma kontrolü: {day} — e-postalar gönderilemedi: arka plan e-postası için portal yöneticisinin uygulama kurulumunda onay vermesi gerekiyor.',
+    noRun: 'Henüz hatırlatma kontrolü yapılmadı.',
+    search: 'Ara',
+    recordsTable: 'Eğitim ve sertifika kayıtları',
+    recordForm: 'Kayıt bilgileri',
+    newRecord: 'Yeni kayıt',
+    recordSaved: 'Kayıt kaydedildi.',
+    refreshManagers: 'Yöneticileri yenile',
+    managersRefreshed: '{n} kayıtta yönetici güncellendi.',
+    typesIntro: 'Eğitim ve sertifika türleri. Geçerlilik süresi boş bırakılırsa tür süresizdir. Süre değişikliği yalnız sonraki kayıtlara uygulanır.',
+    typesTable: 'Sertifika türleri',
+    typeForm: 'Tür bilgileri',
+    newType: 'Yeni tür',
+    typeSaved: 'Tür kaydedildi.',
+    managersOnly: 'Bu işlem yalnız eğitim sorumlusu izni olan kişilere açıktır.',
+  },
+  en: {
+    title: {{nameEnJs}},
+    waiting: 'Waiting for the session from the Portal…',
+    networkError: 'Request could not be sent (network error).',
+    requestFailed: 'The action could not be completed.',
+    readOnly: 'You are in a Delegation or View as User session: you can only view this app.',
+    myIntro: 'Your training and certificate records. The expiry date is computed from the completion date and the validity of the type. Click a row to download the document.',
+    myBanner: '{expired} of your certificates have expired, {expiring} expire within 30 days.',
+    myNone: 'None of your certificates has expired or expires within 30 days.',
+    teamIntro: 'Records of the employees who report to you in the organization chart. The team is read from the organization chart each time.',
+    teamCount: 'There are {n} people in your team.',
+    exportXlsx: 'Export to Excel',
+    exportFailed: 'The file could not be prepared.',
+    listTruncated: 'The list is too long, so only the first {n} records are shown; export to Excel for all of them.',
+    myTable: 'My certificates',
+    teamTable: 'My team certificates',
+    status: 'Status',
+    statusValid: 'Valid',
+    statusExpiring: 'Expiring',
+    statusExpired: 'Expired',
+    statusRenewed: 'Renewed',
+    statusNone: 'No expiry',
+    noAttachment: 'This record has no document.',
+    downloadFailed: 'The document could not be downloaded.',
+    recordsIntro: 'All records. For a new record the manager is taken from the organization chart; if managers changed, update them with "Refresh managers".',
+    recordsBanner: '{expired} certificates have expired, {expiring} expire within 30 days (renewed ones excluded).',
+    lastRun: 'Latest reminder check: {day} — e-mail sent for {sent} people.',
+    lastRunConsent: 'Latest reminder check: {day} — e-mails could not be sent: the portal administrator must approve background e-mail in the app installation.',
+    noRun: 'No reminder check has run yet.',
+    search: 'Search',
+    recordsTable: 'Training and certificate records',
+    recordForm: 'Record details',
+    newRecord: 'New record',
+    recordSaved: 'Record saved.',
+    refreshManagers: 'Refresh managers',
+    managersRefreshed: 'Manager updated on {n} records.',
+    typesIntro: 'Training and certificate types. Leave the validity empty for a type that never expires. A validity change applies to later records only.',
+    typesTable: 'Certificate types',
+    typeForm: 'Type details',
+    newType: 'New type',
+    typeSaved: 'Type saved.',
+    managersOnly: 'Only people with the training manager permission can do this.',
+  },
+}
+
+const MODEL = {
+  manage: '{{permissionPrefix}}Manage',
+  labels: {
+    person: label(dataModel, 'certificates', 'person_name'),
+    manager: label(dataModel, 'certificates', 'manager_name'),
+    type: label(dataModel, 'certificates', 'type_id'),
+    typeName: label(dataModel, 'certificates', 'type_name'),
+    completed: label(dataModel, 'certificates', 'completed_on'),
+    expires: label(dataModel, 'certificates', 'expires_on'),
+    number: label(dataModel, 'certificates', 'certificate_no'),
+    attachment: label(dataModel, 'certificates', 'attachment'),
+    attachmentName: label(dataModel, 'certificates', 'attachment_name'),
+    typeTitle: label(dataModel, 'cert_types', 'name'),
+    validity: label(dataModel, 'cert_types', 'validity_months'),
+    description: label(dataModel, 'cert_types', 'description'),
+    active: label(dataModel, 'cert_types', 'active'),
+  },
+}
+
+export function renderShell(lang: Lang, theme: Theme, path: string): string {
+  const tx = translator(STRINGS, lang)
+  const btn = (id: string, key: string, cls = 'one-btn') => `<button type="button" class="${cls}" id="${id}" data-i18n="${key}">${escapeHtml(tx(key))}</button>`
+  const body = [
+    view(
+      '/',
+      path,
+      `${i18n(tx, 'myIntro', 'p', 'class="one-muted"')}
+<p><strong id="myBanner"></strong></p>
+<div class="app-toolbar">${btn('myExport', 'exportXlsx')}</div>
+<one-table id="myTable" clickable caption="${escapeHtml(tx('myTable'))}"></one-table>`,
+    ),
+    view(
+      '/team',
+      path,
+      `${i18n(tx, 'teamIntro', 'p', 'class="one-muted"')}
+<p class="one-muted" id="teamNote"></p>
+<div class="app-toolbar" id="teamToolbar" hidden>${btn('teamExport', 'exportXlsx')}</div>
+<one-table id="teamTable" clickable caption="${escapeHtml(tx('teamTable'))}"></one-table>`,
+    ),
+    view(
+      '/records',
+      path,
+      `${i18n(tx, 'recordsIntro', 'p', 'class="one-muted"')}
+${i18n(tx, 'managersOnly', 'p', 'class="one-muted" id="recordsDenied"')}
+<div id="recordsBox" hidden>
+<p><strong id="recordsBanner"></strong></p>
+<p class="one-muted" id="runNote"></p>
+<div class="app-toolbar">${btn('newRecord', 'newRecord')} ${btn('refreshManagers', 'refreshManagers')}</div>
+<one-filter id="recordsFilter" for="recordsTable"></one-filter>
+<one-table id="recordsTable" paging="page" export="xlsx csv" clickable caption="${escapeHtml(tx('recordsTable'))}"></one-table>
+<section class="one-card">
+<h2 data-i18n="recordForm">${escapeHtml(tx('recordForm'))}</h2>
+<one-form id="recordForm" action="/api/certificates" method="POST"></one-form>
+</section>
+</div>`,
+    ),
+    view(
+      '/types',
+      path,
+      `${i18n(tx, 'typesIntro', 'p', 'class="one-muted"')}
+<one-table id="typesTable" src="/api/cert_types" paging="page" export="xlsx csv" clickable caption="${escapeHtml(tx('typesTable'))}"></one-table>
+${i18n(tx, 'managersOnly', 'p', 'class="one-muted" id="typesDenied"')}
+<section id="typeEditor" class="one-card" hidden>
+<h2 data-i18n="typeForm">${escapeHtml(tx('typeForm'))}</h2>
+<div class="app-toolbar">${btn('newType', 'newType')}</div>
+<one-form id="typeForm" action="/api/cert_types" method="POST"></one-form>
+</section>`,
+    ),
+  ].join('\n')
+  return renderPage({ lang, theme, title: tx('title'), body })
+}
+
+export function renderShellScript(navigation: readonly OneNavigationItem[], options: { actingWrites?: boolean } = {}): string {
+  return renderClientScript({ strings: STRINGS, navigation, ...(options.actingWrites !== undefined ? { actingWrites: options.actingWrites } : {}), body: pageScript() })
+}
+
+function pageScript(): string {
+  return `
+  var M = ${JSON.stringify(MODEL).replace(/<\//g, '<\\/')};
+  var myTable = $('myTable'), teamTable = $('teamTable'), recordsTable = $('recordsTable'), typesTable = $('typesTable');
+  var recordForm = $('recordForm'), typeForm = $('typeForm');
+  var typeOptions = [], TODAY = null;
+  var STATUS = [
+    { value: 'valid', label: { tr: S.tr.statusValid, en: S.en.statusValid } },
+    { value: 'expiring', label: { tr: S.tr.statusExpiring, en: S.en.statusExpiring } },
+    { value: 'expired', label: { tr: S.tr.statusExpired, en: S.en.statusExpired } },
+    { value: 'renewed', label: { tr: S.tr.statusRenewed, en: S.en.statusRenewed } },
+    { value: 'no-expiry', label: { tr: S.tr.statusNone, en: S.en.statusNone } }
+  ];
+  var listColumns = [
+    { key: 'type_name', label: M.labels.typeName },
+    { key: 'status', label: { tr: S.tr.status, en: S.en.status }, type: 'choice', options: STATUS },
+    { key: 'completed_on', label: M.labels.completed, type: 'date' },
+    { key: 'expires_on', label: M.labels.expires, type: 'date' },
+    { key: 'certificate_no', label: M.labels.number },
+    { key: 'attachment_name', label: M.labels.attachmentName }
+  ];
+  myTable.columns = listColumns;
+  teamTable.columns = [{ key: 'person_name', label: M.labels.person }].concat(listColumns);
+  recordsTable.columns = [
+    { key: 'person_name', label: M.labels.person },
+    { key: 'type_name', label: M.labels.typeName },
+    { key: 'completed_on', label: M.labels.completed, type: 'date' },
+    { key: 'expires_on', label: M.labels.expires, type: 'date' },
+    { key: 'manager_name', label: M.labels.manager },
+    { key: 'certificate_no', label: M.labels.number }
+  ];
+  $('recordsFilter').fields = [
+    { key: 'q', label: { tr: S.tr.search, en: S.en.search }, type: 'text' },
+    { key: 'expires_on', label: M.labels.expires, type: 'dateRange' }
+  ];
+  typesTable.columns = [
+    { key: 'name', label: M.labels.typeTitle },
+    { key: 'validity_months', label: M.labels.validity, type: 'number' },
+    { key: 'description', label: M.labels.description },
+    { key: 'active', label: M.labels.active, type: 'boolean' }
+  ];
+  typeForm.fields = [
+    { key: 'name', label: M.labels.typeTitle, required: true, maxLength: 120 },
+    { key: 'validity_months', label: M.labels.validity, type: 'number', min: 1, max: 240 },
+    { key: 'description', label: M.labels.description, maxLength: 300 },
+    { key: 'active', label: M.labels.active, type: 'boolean' }
+  ];
+  var fileField = { key: 'attachment', label: M.labels.attachment, type: 'file', accept: 'image/*,.pdf', maxSize: 5242880, action: '/api/files' };
+  function newType() { typeForm.setAttribute('action', '/api/cert_types'); typeForm.setAttribute('method', 'POST'); typeForm.value = { active: true }; one.setTitle(null); }
+  // Yeni kayıtta kişi ve tür seçilir; düzenlemede yalnız tarih, belge numarası ve belge (kişi ve tür değişmez).
+  function newRecord() {
+    recordForm.fields = [
+      { key: 'person', label: M.labels.person, type: 'person', required: true },
+      { key: 'type_id', label: M.labels.type, type: 'choice', options: typeOptions, required: true },
+      { key: 'completed_on', label: M.labels.completed, type: 'date', required: true },
+      { key: 'certificate_no', label: M.labels.number, maxLength: 60 },
+      fileField
+    ];
+    recordForm.setAttribute('action', '/api/certificates'); recordForm.setAttribute('method', 'POST');
+    recordForm.value = { completed_on: TODAY };
+    one.setTitle(null);
+  }
+  function editRecord(r) {
+    recordForm.fields = [
+      { key: 'completed_on', label: M.labels.completed, type: 'date', required: true },
+      { key: 'certificate_no', label: M.labels.number, maxLength: 60 },
+      fileField
+    ];
+    recordForm.setAttribute('action', '/api/certificates/' + encodeURIComponent(r.id)); recordForm.setAttribute('method', 'PATCH');
+    recordForm.value = { completed_on: r.completed_on, certificate_no: r.certificate_no, attachment: r.attachment ? { key: r.attachment, name: r.attachment_name || '' } : null };
+    one.setTitle((r.person_name || '') + ' - ' + (r.type_name || ''));
+  }
+  function download(r) {
+    if (!r.has_attachment && !r.attachment) { one.toast({ severity: 'info', summary: t('noAttachment') }); return; }
+    one.fetch('/api/certificates/' + encodeURIComponent(r.id) + '/attachment').then(function (res) {
+      if (!res.ok) { one.toast({ severity: 'error', summary: t('downloadFailed') }); return; }
+      return res.arrayBuffer().then(function (data) {
+        return one.download({ name: r.attachment_name || 'belge', mime: (res.headers.get('content-type') || 'application/octet-stream').split(';')[0], data: data });
+      });
+    }, function () { one.toast({ severity: 'error', summary: t('downloadFailed') }); });
+  }
+  function exportList(path, name) {
+    one.fetch(path + '/export.xlsx?lang=' + lang).then(function (res) {
+      if (!res.ok) {
+        return res.text().then(function (text) {
+          var body = null;
+          try { body = text ? JSON.parse(text) : null; } catch (e) { body = null; }
+          one.toast({ severity: 'error', summary: t('exportFailed'), detail: problem({ status: res.status, body: body }) });
+        });
+      }
+      return res.arrayBuffer().then(function (data) {
+        return one.download({ name: name + '.xlsx', mime: (res.headers.get('content-type') || '').split(';')[0], data: data });
+      });
+    }, function () { one.toast({ severity: 'error', summary: t('exportFailed') }); });
+  }
+  function count(items, status) { return items.filter(function (x) { return x.status === status; }).length; }
+  function loadMine() {
+    return api('GET', '/api/my/certificates').then(function (r) {
+      if (!r.ok) { $('myBanner').textContent = problem(r); myTable.rows = []; return; }
+      TODAY = r.body.today;
+      myTable.rows = r.body.items;
+      var expired = count(r.body.items, 'expired'), expiring = count(r.body.items, 'expiring');
+      $('myBanner').textContent = expired + expiring > 0 ? t('myBanner', { expired: fmtNumber(expired), expiring: fmtNumber(expiring) }) : t('myNone');
+      if (r.body.truncated) $('myBanner').textContent += ' ' + t('listTruncated', { n: fmtNumber(r.body.items.length) });
+    });
+  }
+  function loadTeam() {
+    return api('GET', '/api/team/certificates').then(function (r) {
+      if (!r.ok) { $('teamNote').textContent = problem(r); $('teamToolbar').setAttribute('hidden', ''); teamTable.rows = []; return; }
+      $('teamNote').textContent = t('teamCount', { n: fmtNumber(r.body.team.length) });
+      if (r.body.truncated) $('teamNote').textContent += ' ' + t('listTruncated', { n: fmtNumber(r.body.items.length) });
+      $('teamToolbar').removeAttribute('hidden');
+      teamTable.rows = r.body.items;
+    });
+  }
+  function loadSummary() {
+    return api('GET', '/api/summary').then(function (r) {
+      if (!r.ok) return;
+      var s = r.body;
+      $('recordsBanner').textContent = t('recordsBanner', { expired: fmtNumber(s.expired), expiring: fmtNumber(s.expiring) });
+      $('runNote').textContent = !s.lastRun ? t('noRun') : s.lastRun.consent_needed ? t('lastRunConsent', { day: fmtDate(s.lastRun.run_key) }) : t('lastRun', { day: fmtDate(s.lastRun.run_key), sent: fmtNumber(s.lastRun.sent_count) });
+    });
+  }
+  function loadTypes() {
+    return loadAll('/api/cert_types?active=true&_sort=name').then(function (r) {
+      if (!r.ok) { one.toast({ severity: 'error', summary: problem(r) }); return; }
+      typeOptions = r.body.items.map(function (x) { return { value: x.id, label: x.name }; });
+      if (recordForm.getAttribute('method') !== 'PATCH') newRecord();
+    });
+  }
+  $('myExport').addEventListener('click', function () { exportList('/api/my/certificates', t('myTable')); });
+  $('teamExport').addEventListener('click', function () { exportList('/api/team/certificates', t('teamTable')); });
+  myTable.addEventListener('rowclick', function (e) { download(e.detail.row); });
+  teamTable.addEventListener('rowclick', function (e) { download(e.detail.row); });
+  recordsTable.addEventListener('rowclick', function (e) { if (canWrite()) editRecord(e.detail.row); });
+  typesTable.addEventListener('rowclick', function (e) {
+    if (!can(M.manage) || !canWrite()) return;
+    var r = e.detail.row;
+    typeForm.setAttribute('action', '/api/cert_types/' + encodeURIComponent(r.id)); typeForm.setAttribute('method', 'PATCH');
+    typeForm.value = r; one.setTitle(r.name);
+  });
+  $('newRecord').addEventListener('click', newRecord);
+  $('newType').addEventListener('click', newType);
+  $('refreshManagers').addEventListener('click', function () {
+    api('POST', '/api/certificates/refresh-managers', {}).then(function (r) {
+      if (!r.ok) { one.toast({ severity: 'error', summary: problem(r) }); return; }
+      one.toast({ severity: 'success', summary: t('managersRefreshed', { n: fmtNumber(r.body.updated) }) });
+      recordsTable.reload();
+    });
+  });
+  recordForm.addEventListener('saved', function (e) {
+    e.preventDefault();
+    one.toast({ severity: 'success', summary: t('recordSaved') });
+    newRecord(); recordsTable.reload(); loadSummary(); loadMine();
+  });
+  typeForm.addEventListener('saved', function (e) {
+    e.preventDefault();
+    one.toast({ severity: 'success', summary: t('typeSaved') });
+    newType(); typesTable.reload(); loadTypes();
+  });
+  onSession(function () {
+    var manager = can(M.manage);
+    $('recordsBox').toggleAttribute('hidden', !manager); $('recordsDenied').toggleAttribute('hidden', manager);
+    var editor = manager && canWrite();
+    $('typeEditor').toggleAttribute('hidden', !editor); $('typesDenied').toggleAttribute('hidden', editor);
+    // Bütün kayıtlar yalnız eğitim sorumlusuna yüklenir (uç da izin ister).
+    if (manager) { recordsTable.setAttribute('src', '/api/certificates'); loadSummary(); loadTypes(); newType(); }
+  });
+  onReady(function () { loadMine(); loadTeam(); });
+`
+}

package/templates/egitim-sertifika/manifest.json.tpl

@@ -0,0 +1,57 @@
+{
+  "scopes": ["orgschema.read", "mail.execute"],
+  "services": { "database": true, "files": true, "cache": false },
+  "menuIcon": "pi pi-verified",
+  "navigation": [
+    { "path": "/", "label": { "tr": "Sertifikalarım", "en": "My certificates" } },
+    { "path": "/team", "label": { "tr": "Ekibim", "en": "My team" } },
+    { "path": "/records", "label": { "tr": "Tüm kayıtlar", "en": "All records" }, "permission": "{{permissionPrefix}}Manage" },
+    { "path": "/types", "label": { "tr": "Sertifika türleri", "en": "Certificate types" }, "permission": "{{permissionPrefix}}Manage" }
+  ],
+  "permissions": [
+    { "code": "{{permissionPrefix}}Manage", "name": { "tr": "Eğitim ve sertifika kayıtlarını yönet", "en": "Manage training and certificate records" } }
+  ],
+  "agent": {
+    "summary": {
+      "tr": "Eğitim ve sertifika takibi: çalışanların eğitim ve sertifikaları, geçerlilik süreleri ve süresi dolmak üzere olanlar.",
+      "en": "Training and certificate tracking: employee trainings and certificates, validity periods and those about to expire."
+    },
+    "tools": [
+      {
+        "name": "expiring-certificates",
+        "title": { "tr": "Süresi yaklaşan sertifikalar", "en": "Expiring certificates" },
+        "description": {
+          "tr": "Geçerlilik süresi verilen gün içinde dolacak ya da dolmuş (yenilenmemiş) sertifikaları kişi, yönetici ve tür bilgisiyle, en acil olan önce döndürür. Yalnız eğitim kayıtlarını yönetme izni olanlara açıktır. Salt okunur.",
+          "en": "Returns certificates that expire within the given number of days or have expired (not renewed), with person, manager and type, most urgent first. Only for people allowed to manage training records. Read-only."
+        },
+        "readOnly": true,
+        "permission": "{{permissionPrefix}}Manage",
+        "input": {
+          "type": "object",
+          "properties": {
+            "days": { "type": "integer", "minimum": 0, "maximum": 365, "description": "Bugünden itibaren kaç gün (varsayılan 30; dolmuş olanlar her zaman dahil)" },
+            "limit": { "type": "integer", "minimum": 1, "maximum": 50, "description": "En çok kaç kayıt (varsayılan 20)" }
+          }
+        }
+      },
+      {
+        "name": "certificate-types",
+        "title": { "tr": "Sertifika türleri", "en": "Certificate types" },
+        "description": {
+          "tr": "Tanımlı eğitim ve sertifika türlerini geçerlilik süreleriyle (ay) döndürür; kişisel veri içermez. Salt okunur.",
+          "en": "Returns the defined training and certificate types with their validity (months); contains no personal data. Read-only."
+        },
+        "readOnly": true,
+        "permission": "{{permissionCode}}",
+        "input": { "type": "object", "properties": {} }
+      }
+    ]
+  },
+  "jobs": {
+    "schedules": [
+      { "name": "daily-certificate-reminders", "cron": "0 8 * * *", "timeZone": "Europe/Istanbul", "description": "Süresi 30 gün içinde dolacak sertifikaları kişiye ve yöneticisine e-postayla hatırlatır" }
+    ],
+    "queues": [],
+    "services": ["mail.execute"]
+  }
+}

package/templates/envanter/AGENTS.template.md.tpl

@@ -0,0 +1,28 @@
+## Bu uygulamanın şablonu: envanter (`envanter`)
+
+Uygulama `create-devoplus-one-app --template envanter` 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: `items` (stok kalemi) + `movements` (hareket) + `stock_checks` (günlük kontrol). Değişince `pnpm data:generate` |
+| `src/app.ts` | Uçlar: kalem tanımı, stok hareketi (eksi stok engelli), azalma e-postası, özet |
+| `src/stock.ts` | Saf kurallar: hareket doğrulama (birim, ondalık, tavan), eşik, kontrol günü + `stock.test.ts` |
+| `src/jobs.ts` | Sabah işi `daily-stock-check` (azalan kalemleri günün kaydına yazar; kullanıcısız, e-posta GÖNDERMEZ) |
+| `src/shell.ts` | Sayfa: stok (süzgeç + grafik), hareketler, kalemler |
+| `src/agent.ts` · `src/queries.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):
+
+- **Miktar YALNIZ hareketle değişir.** Kalem uçları `quantity` ve `low_notified_at` alanlarını istemciden ALMAZ.
+- **Hareket kaydı ve miktar değişikliği TEK toplu yazımdır** (`env.DB.batch([hareket, miktar])` — ikisi birlikte yazılır
+  ya da hiçbiri): hareket yalnız kalem kullanımdaysa ve çıkışta eldeki miktar yetiyorsa (`quantity >= ?`) eklenir, miktar
+  yalnız o hareket eklendiyse değişir. "Önce oku, sonra yaz"a ya da iki ayrı yazıma çevirmeyin — iki eşzamanlı çıkış stoku
+  eksiye düşürürdü, ikinci yazım düşerse miktar değişmiş ama hareket eksik kalırdı.
+- **Azalma e-postası bir kez gider:** damga koşullu güncellemeyle konur (`low_notified_at IS NULL`); gönderim
+  başarısızsa damga geri alınır. Miktar eşiğe çıkınca ya da eşik değişince damga silinir.
+- **Hareket değiştirilmez ve silinmez** (405); düzeltme yeni bir hareket ya da sayımla yapılır.
+- **Kişi kimlikleri:** kalem sorumlusu `responsible_org_id` (Organization Schema kimliği → `toOrgUserIds`).
+- **Zamanlanmış iş kullanıcısızdır ve e-posta GÖNDEREMEZ.** "Her sabah azalanları e-postayla gönder" isteğinde bunun
+  bugün mümkün olmadığını söyleyin; sonuç uygulamada ve Devoplus yapay zekâsında görünür.

package/templates/envanter/README.md.tpl

@@ -0,0 +1,40 @@
+# {{nameTr}}
+
+Kurumun stok kalemlerini, eldeki miktarlarını ve konumlarını izleyen bir envanter uygulaması. Devoplus Portal'ın
+içinde, Portal menüsünden açılır. Bu uygulama Devoplus One'ın **envanter** şablonundan üretildi; ihtiyacınıza göre
+değiştirilecek bir başlangıç noktasıdır.
+
+## Ne yapar
+
+1. **Stok:** bütün kalemlerin eldeki miktarı, birimi, konumu ve en az miktarı listelenir; azalan kalemler işaretlenir.
+   Ekranın üstünde kaç kalemin azaldığı ve son günlük kontrolün sonucu yazar; grafik kalemlerin konumlara dağılımını
+   gösterir. Liste Excel'e ya da CSV'ye aktarılabilir.
+2. **Hareketler:** stok sorumlusu giriş, çıkış ya da sayım girer. Çıkış eldeki miktardan fazla olamaz; sayım eldeki
+   miktarı sayılan değere eşitler. Her hareket kimin yaptığıyla birlikte kayıtta kalır ve değiştirilmez.
+3. **Kalemler:** stok sorumlusu kalem tanımlar (stok kodu, ad, birim, konum, en az miktar, sorumlu kişi).
+4. **Azalma uyarısı:** miktar en az miktarın altına düştüğünde kalemin sorumlusuna bir kez e-posta gider; miktar
+   yeniden yeterli seviyeye çıkınca uyarı yeniden kurulur. Her sabah 07:00'de yapılan kontrol azalan kalemleri kaydeder.
+5. **Devoplus asistanı:** "Hangi malzemeler azaldı?" gibi sorular Devoplus'un yapay zekâ asistanına sorulduğunda
+   cevap bu uygulamadan gelir.
+
+## Kimler ne görür
+
+| Kim | Ne yapabilir |
+|---|---|
+| Uygulamayı kullanma izni olan herkes ({{permissionCode}}) | Stoku, hareketleri ve grafiği görür, Excel'e aktarır |
+| Stok sorumlusu ({{permissionPrefix}}Manage) | Kalem tanımlar, giriş, çıkış ve sayım girer |
+
+İzinleri portal yöneticisi **Yetki Yönetimi** ekranından verir.
+
+## Neleri değiştirebilirsiniz
+
+Yapay zekâ aracınıza iş diliyle söylemeniz yeterlidir:
+
+- "Birimlere *paket* ekle" (ilk yayından önce netleştirin).
+- "Çıkışta hangi departmana verildiği de sorulsun" — yeni alan.
+- "Konumlar arasında transfer yapılabilsin" — yeni hareket türü.
+- "Stok değeri (birim fiyat × miktar) de görünsün" — yeni hesap.
+
+Bilinmesi gerekenler: azalma e-postası, miktarı eşiğin altına düşüren hareketi giren kişinin Portal'daki
+**"İzinleri incele"** düğmesiyle e-posta izni vermiş olmasını gerektirir; izin yoksa hareket yine kaydedilir ve uyarı
+bir sonraki harekette yeniden denenir. Sabah kontrolü e-posta göndermez, sonucu uygulamada gösterir.

package/templates/envanter/files/AGENT_GUIDE.md.tpl

@@ -0,0 +1,47 @@
+# {{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}}, kurumun stok kalemlerini, eldeki miktarlarını ve nerede durduklarını izleyen bir envanter uygulamasıdır.
+Miktar yalnız stok hareketiyle değişir (giriş, çıkış, sayım) ve eksiye düşmez. Her kalemin bir "en az miktarı"
+vardır; miktar bunun altına düşünce kalem "azaldı" sayılır, kalemin sorumlusuna bir kez e-posta gider ve her sabah
+yapılan kontrol azalan kalemleri kaydeder. Kullanıcı "A4 kâğıt kaldı mı", "depoda kaç toner var", "hangi malzemeler
+azaldı" gibi şeyler sorduğunda bu uygulamaya başvurun. Stok hareketi girmek için araç yoktur.
+
+## Veri
+
+- **Stok kalemi** (`items`): stok kodu (tekil), ad, kategori, birim (`piece` adet · `box` kutu · `kg` · `litre` ·
+  `metre`), konum, eldeki miktar, en az miktar, sorumlu kişinin adı, kullanımda mı.
+- **Stok hareketi** (`movements`): kalem, tür (`in` giriş · `out` çıkış · `count` sayım — sayım eldeki miktarı
+  sayılan değere eşitler), miktar, açıklama, işlemi yapan. Hareket değiştirilmez.
+- **Günlük stok kontrolü** (`stock_checks`): her sabah 07:00'de (Türkiye saati) en az miktarın altındaki kalemler.
+- En az miktarı 0 olan kalem hiçbir zaman "azaldı" sayılmaz.
+
+## Araçlar
+
+### `search-items` — stok kalemi ara (salt okunur)
+
+- **Ne zaman:** kullanıcı bir malzemenin stokta olup olmadığını, ne kadar kaldığını ya da nerede durduğunu sorduğunda.
+- **Girdi:** `query` — stok kodunda, adda ya da konumda geçen ifade; `limit` (1-50, varsayılan 10).
+- **Çıktı:** `{ "items": [{ "sku", "name", "quantity", "min_quantity", "unit", "location", "low" }] }`.
+- **Dikkat:** 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.
+
+### `list-low-stock` — azalan stoku listele (salt okunur)
+
+- **Ne zaman:** kullanıcı hangi malzemelerin azaldığını ya da sipariş edilmesi gerekenleri sorduğunda.
+- **Girdi:** yok.
+- **Çıktı:** `{ "count": 3, "items": [{ "sku", "name", "quantity", "min_quantity", "unit", "location" }],
+  "lastDailyCheck": { "day": "2026-10-20", "lowCount": 2 } }` — `items` en çok 50 kalem, en kritik olan önce;
+  `count` tam sayıdır. Hiç kontrol yapılmadıysa `lastDailyCheck` `null`.
+
+## Örnek istekler
+
+- "A4 kâğıt kaldı mı?" → `search-items` (`query: "a4"`) → `quantity` ve `unit`
+- "Hangi malzemeler azaldı?" → `list-low-stock`
+- "Toner nerede duruyor?" → `search-items` → `location`
+- "Depoya 20 kutu kâğıt girişi yap." → araç yok; kullanıcıyı uygulamanın Hareketler sekmesine yönlendirin.

package/templates/envanter/files/one.data.json

@@ -0,0 +1,62 @@
+{
+  "version": 1,
+  "entities": {
+    "items": {
+      "title": { "tr": "Stok kalemleri", "en": "Stock items" },
+      "fields": {
+        "sku": { "type": "text", "title": { "tr": "Stok kodu", "en": "SKU" }, "required": true, "unique": true, "maxLength": 40 },
+        "name": { "type": "text", "title": { "tr": "Ad", "en": "Name" }, "required": true, "maxLength": 120 },
+        "category": { "type": "text", "title": { "tr": "Kategori", "en": "Category" }, "maxLength": 60, "index": true },
+        "unit": {
+          "type": "choice",
+          "title": { "tr": "Birim", "en": "Unit" },
+          "required": true,
+          "default": "piece",
+          "choices": [
+            { "value": "piece", "title": { "tr": "Adet", "en": "Piece" } },
+            { "value": "box", "title": { "tr": "Kutu", "en": "Box" } },
+            { "value": "kg", "title": { "tr": "Kilogram", "en": "Kilogram" } },
+            { "value": "litre", "title": { "tr": "Litre", "en": "Litre" } },
+            { "value": "metre", "title": { "tr": "Metre", "en": "Metre" } }
+          ]
+        },
+        "location": { "type": "text", "title": { "tr": "Konum", "en": "Location" }, "maxLength": 120, "index": true },
+        "quantity": { "type": "number", "title": { "tr": "Miktar", "en": "Quantity" }, "required": true, "default": 0, "min": 0 },
+        "min_quantity": { "type": "number", "title": { "tr": "En az miktar", "en": "Minimum quantity" }, "required": true, "default": 0, "min": 0 },
+        "responsible_org_id": { "type": "text", "title": { "tr": "Sorumlu (kimlik)", "en": "Responsible (id)" }, "maxLength": 24 },
+        "responsible_name": { "type": "text", "title": { "tr": "Sorumlu", "en": "Responsible" }, "maxLength": 120 },
+        "low_notified_at": { "type": "datetime", "title": { "tr": "Azalma bildirimi", "en": "Low stock notice" } },
+        "active": { "type": "boolean", "title": { "tr": "Kullanımda", "en": "In use" }, "required": true, "default": true }
+      }
+    },
+    "movements": {
+      "title": { "tr": "Stok hareketleri", "en": "Stock movements" },
+      "fields": {
+        "item_id": { "type": "text", "title": { "tr": "Kalem", "en": "Item" }, "required": true, "maxLength": 36, "index": true },
+        "item_name": { "type": "text", "title": { "tr": "Kalem adı", "en": "Item name" }, "maxLength": 120 },
+        "kind": {
+          "type": "choice",
+          "title": { "tr": "Hareket", "en": "Movement" },
+          "required": true,
+          "index": true,
+          "choices": [
+            { "value": "in", "title": { "tr": "Giriş", "en": "In" } },
+            { "value": "out", "title": { "tr": "Çıkış", "en": "Out" } },
+            { "value": "count", "title": { "tr": "Sayım", "en": "Count" } }
+          ]
+        },
+        "quantity": { "type": "number", "title": { "tr": "Miktar", "en": "Quantity" }, "required": true, "min": 0 },
+        "note": { "type": "text", "title": { "tr": "Açıklama", "en": "Note" }, "maxLength": 200 },
+        "actor_name": { "type": "text", "title": { "tr": "İşlemi yapan", "en": "Done by" }, "maxLength": 120 }
+      }
+    },
+    "stock_checks": {
+      "title": { "tr": "Günlük stok kontrolleri", "en": "Daily stock checks" },
+      "fields": {
+        "run_key": { "type": "text", "title": { "tr": "Kontrol günü", "en": "Check day" }, "required": true, "unique": true, "maxLength": 20 },
+        "low_count": { "type": "number", "title": { "tr": "Eşiğin altındaki kalem", "en": "Items below minimum" }, "required": true, "default": 0, "min": 0 },
+        "low_items": { "type": "longText", "title": { "tr": "Eşiğin altındaki kalemler", "en": "Items below minimum" }, "maxLength": 20000 }
+      }
+    }
+  }
+}

package/templates/envanter/files/src/agent.ts.tpl

@@ -0,0 +1,20 @@
+// 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. Stok hareketi GİREN araç bilinçli olarak yoktur.
+import { defineAgentTools } from '@devoplus/one-sdk'
+import type { Env } from './app.ts'
+import { lastCheck, lowStock, searchItems } from './queries.ts'
+
+export const agentTools = defineAgentTools<Env>({
+  'search-items': {
+    handler: async ({ input, env }) => ({
+      items: await searchItems(env, String(input.query), typeof input.limit === 'number' ? input.limit : 10),
+    }),
+  },
+  'list-low-stock': {
+    handler: async ({ env }) => {
+      const [low, check] = await Promise.all([lowStock(env, 50), lastCheck(env)])
+      return { count: low.count, items: low.items, lastDailyCheck: check ? { day: check.run_key, lowCount: check.low_count } : null }
+    },
+  },
+})