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

package/templates/ziyaretci-kaydi/files/src/shell.ts.tpl

@@ -0,0 +1,252 @@
+// {{nameTr}} — sayfa (üç görünüm: Ziyaretçilerim · Resepsiyon · Tüm kayıtlar). Liste, süzgeç, form ve kişi seçici hazır
+// bileşenlerdir; seçenekler veri modelinden gelir. Giriş ve çıkış zamanını sunucu yazar; sayfa yalnız eylemi ister.
+import type { OneNavigationItem } from '@devoplus/one-sdk'
+import { dataModel } from './data/types.ts'
+import { renderClientScript } from './lib/client.ts'
+import { choices, 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.',
+    mineIntro: 'Sizi ziyarete gelen ve gelecek olan ziyaretçiler. Ziyaretçiniz giriş yaptığında size bildirim gelir.',
+    mineTable: 'Ziyaretçilerim',
+    receptionIntro: 'Bugün beklenen ziyaretçiler. Bir satırı seçip giriş ya da çıkışını yapın; zamanı sistem yazar.',
+    managersOnly: 'Bu bölüm yalnız resepsiyon görevlilerine açıktır.',
+    counts: 'Bugün: {expected} bekleniyor, {checkedIn} giriş yaptı, {left} ayrıldı. Şu an içeride: {inside}.',
+    registerForm: 'Yeni ziyaretçi',
+    registered: 'Ziyaretçi kaydedildi.',
+    host: 'Ziyaret edilen çalışan',
+    todayTable: 'Bugünkü ziyaretçiler',
+    selected: 'Seçili ziyaretçi',
+    selectHint: 'İşlem yapmak için listeden bir ziyaretçi seçin.',
+    checkIn: 'Giriş yap',
+    checkOut: 'Çıkış yap',
+    cancel: 'İptal et',
+    cancelConfirm: 'Bu ziyaret iptal edilsin mi?',
+    checkedIn: 'Giriş kaydedildi.',
+    checkedOut: 'Çıkış kaydedildi.',
+    cancelled: 'Ziyaret iptal edildi.',
+    hostNotified: 'Ziyaret edilen çalışana bildirim gönderildi.',
+    mailConsent: 'Giriş kaydedildi ama e-posta gönderilemedi: portaldaki "İzinleri incele" düğmesiyle e-posta izni verin.',
+    mailFailed: 'Giriş kaydedildi ama e-posta gönderilemedi.',
+    allIntro: 'Bütün ziyaret kayıtları. Ad soyad, firma ve ziyaret amacı {days} gün sonra kendiliğinden silinir.',
+    allTable: 'Ziyaret kayıtları',
+    search: 'Ara',
+    lastRetention: 'Son kişisel veri temizliği: {day} — {n} kaydın kişisel bilgileri silindi.',
+    noRetention: 'Henüz kişisel veri temizliği yapılmadı.',
+    anonymized: '(silindi)',
+  },
+  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.',
+    mineIntro: 'Visitors who came or will come to see you. You are notified when your visitor checks in.',
+    mineTable: 'My visitors',
+    receptionIntro: 'Visitors expected today. Select a row to check them in or out; the system records the time.',
+    managersOnly: 'Only reception staff can use this section.',
+    counts: 'Today: {expected} expected, {checkedIn} checked in, {left} left. Inside now: {inside}.',
+    registerForm: 'New visitor',
+    registered: 'Visitor registered.',
+    host: 'Employee being visited',
+    todayTable: "Today's visitors",
+    selected: 'Selected visitor',
+    selectHint: 'Select a visitor from the list to take an action.',
+    checkIn: 'Check in',
+    checkOut: 'Check out',
+    cancel: 'Cancel',
+    cancelConfirm: 'Cancel this visit?',
+    checkedIn: 'Check-in recorded.',
+    checkedOut: 'Check-out recorded.',
+    cancelled: 'Visit cancelled.',
+    hostNotified: 'The employee being visited was notified.',
+    mailConsent: 'Check-in recorded, but no e-mail was sent: allow e-mail with the "Review permissions" button in the Portal.',
+    mailFailed: 'Check-in recorded, but the e-mail could not be sent.',
+    allIntro: 'All visit records. Full name, company and purpose of visit are deleted automatically after {days} days.',
+    allTable: 'Visit records',
+    search: 'Search',
+    lastRetention: 'Latest personal data clean-up: {day} — personal data of {n} records was deleted.',
+    noRetention: 'No personal data clean-up has run yet.',
+    anonymized: '(deleted)',
+  },
+}
+
+const MODEL = {
+  manage: '{{permissionPrefix}}Manage',
+  status: choices(dataModel, 'visitors', 'status'),
+  labels: {
+    fullName: label(dataModel, 'visitors', 'full_name'),
+    company: label(dataModel, 'visitors', 'company'),
+    purpose: label(dataModel, 'visitors', 'purpose'),
+    hostName: label(dataModel, 'visitors', 'host_name'),
+    plannedAt: label(dataModel, 'visitors', 'planned_at'),
+    status: label(dataModel, 'visitors', 'status'),
+    checkedInAt: label(dataModel, 'visitors', 'checked_in_at'),
+    checkedOutAt: label(dataModel, 'visitors', 'checked_out_at'),
+    registeredBy: label(dataModel, 'visitors', 'registered_by_name'),
+  },
+}
+
+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}" disabled>${escapeHtml(tx(key))}</button>`
+  const body = [
+    view(
+      '/',
+      path,
+      `${i18n(tx, 'mineIntro', 'p', 'class="one-muted"')}
+<one-table id="mineTable" src="/api/mine/visitors" paging="page" export="xlsx csv" caption="${escapeHtml(tx('mineTable'))}"></one-table>`,
+    ),
+    view(
+      '/reception',
+      path,
+      `${i18n(tx, 'receptionIntro', 'p', 'class="one-muted"')}
+${i18n(tx, 'managersOnly', 'p', 'class="one-muted" id="receptionDenied"')}
+<div id="receptionBox" hidden>
+<p><strong id="countsBanner"></strong></p>
+<section class="one-card">
+<h2 data-i18n="registerForm">${escapeHtml(tx('registerForm'))}</h2>
+<one-form id="visitorForm" action="/api/visitors" method="POST" no-cancel></one-form>
+</section>
+<one-table id="todayTable" src="/api/today/visitors" paging="page" export="xlsx csv" clickable caption="${escapeHtml(tx('todayTable'))}"></one-table>
+<section class="one-card app-detail">
+<h2 data-i18n="selected">${escapeHtml(tx('selected'))}</h2>
+<p id="selectedName" class="one-muted" data-i18n="selectHint">${escapeHtml(tx('selectHint'))}</p>
+<div class="app-toolbar">${btn('checkIn', 'checkIn', 'one-btn one-btn-primary')}${btn('checkOut', 'checkOut')}${btn('cancelVisit', 'cancel')}</div>
+</section>
+</div>`,
+    ),
+    view(
+      '/visitors',
+      path,
+      `${i18n(tx, 'managersOnly', 'p', 'class="one-muted" id="allDenied"')}
+<div id="allBox" hidden>
+<p class="one-muted" id="allIntro"></p>
+<p class="one-muted" id="retentionNote"></p>
+<one-filter id="allFilter" for="allTable"></one-filter>
+<one-table id="allTable" src="/api/visitors" paging="page" export="xlsx csv" caption="${escapeHtml(tx('allTable'))}"></one-table>
+</div>`,
+    ),
+  ].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 mineTable = $('mineTable'), todayTable = $('todayTable'), allTable = $('allTable'), allFilter = $('allFilter'), form = $('visitorForm');
+  var selected = null, retentionDays = null, lastRetention = null;
+
+  // Saklama süresi dolan kaydın adı boştur; listede "(silindi)" yazar.
+  function personName(v, row) { return row && row.anonymized_at ? t('anonymized') : (v || ''); }
+  var common = [
+    { key: 'full_name', label: M.labels.fullName, format: personName },
+    { key: 'company', label: M.labels.company },
+    { key: 'purpose', label: M.labels.purpose }
+  ];
+  mineTable.columns = common.concat([
+    { key: 'planned_at', label: M.labels.plannedAt, type: 'datetime' },
+    { key: 'status', label: M.labels.status, type: 'choice', options: M.status },
+    { key: 'checked_in_at', label: M.labels.checkedInAt, type: 'datetime' },
+    { key: 'checked_out_at', label: M.labels.checkedOutAt, type: 'datetime' }
+  ]);
+  todayTable.columns = common.concat([
+    { key: 'host_name', label: M.labels.hostName },
+    { key: 'planned_at', label: M.labels.plannedAt, type: 'datetime' },
+    { key: 'status', label: M.labels.status, type: 'choice', options: M.status },
+    { key: 'checked_in_at', label: M.labels.checkedInAt, type: 'datetime' },
+    { key: 'checked_out_at', label: M.labels.checkedOutAt, type: 'datetime' }
+  ]);
+  allTable.columns = common.concat([
+    { key: 'host_name', label: M.labels.hostName },
+    { key: 'planned_at', label: M.labels.plannedAt, type: 'datetime' },
+    { key: 'status', label: M.labels.status, type: 'choice', options: M.status },
+    { key: 'checked_in_at', label: M.labels.checkedInAt, type: 'datetime' },
+    { key: 'checked_out_at', label: M.labels.checkedOutAt, type: 'datetime' },
+    { key: 'registered_by_name', label: M.labels.registeredBy }
+  ]);
+  allFilter.fields = [
+    { key: 'q', label: { tr: S.tr.search, en: S.en.search }, type: 'text' },
+    { key: 'status', label: M.labels.status, type: 'choice', options: M.status }
+  ];
+  form.fields = [
+    { key: 'full_name', label: M.labels.fullName, required: true, maxLength: 120 },
+    { key: 'company', label: M.labels.company, maxLength: 120 },
+    { key: 'purpose', label: M.labels.purpose, required: true, maxLength: 200 },
+    { key: 'host', label: { tr: S.tr.host, en: S.en.host }, type: 'person', required: true },
+    { key: 'planned_at', label: M.labels.plannedAt, type: 'datetime', required: true }
+  ];
+  function resetForm() { form.value = { planned_at: new Date().toISOString() }; }
+  resetForm();
+
+  function select(row) {
+    selected = row;
+    var name = $('selectedName');
+    if (!row) { name.setAttribute('data-i18n', 'selectHint'); name.textContent = t('selectHint'); }
+    else { name.removeAttribute('data-i18n'); name.textContent = personName(row.full_name, row) + (row.host_name ? ' → ' + row.host_name : ''); }
+    var ok = !!row && canWrite() && !row.anonymized_at;
+    $('checkIn').disabled = !(ok && row.status === 'expected');
+    $('cancelVisit').disabled = !(ok && row.status === 'expected');
+    $('checkOut').disabled = !(ok && row.status === 'inside');
+  }
+  function refresh() { todayTable.reload(); mineTable.reload(); if (!$('allBox').hidden) allTable.reload(); loadSummary(); select(null); }
+  function loadSummary() {
+    return api('GET', '/api/summary').then(function (r) {
+      if (!r.ok) return;
+      var c = r.body.counts;
+      $('countsBanner').textContent = t('counts', { expected: fmtNumber(c.expected), checkedIn: fmtNumber(c.checkedIn), left: fmtNumber(c.left), inside: fmtNumber(c.insideNow) });
+      retentionDays = r.body.retentionDays; lastRetention = r.body.lastRetention;
+      renderRetention();
+    });
+  }
+  function renderRetention() {
+    if (retentionDays == null) return;
+    $('allIntro').textContent = t('allIntro', { days: fmtNumber(retentionDays) });
+    $('retentionNote').textContent = lastRetention ? t('lastRetention', { day: fmtDate(lastRetention.run_key), n: fmtNumber(lastRetention.cleared_count) }) : t('noRetention');
+  }
+  function notifyResult(n) {
+    if (!n) return;
+    if (n.mail === 'sent' || n.push === 'sent') one.toast({ severity: 'success', summary: t('hostNotified') });
+    if (n.mail === 'consent-needed') one.toast({ severity: 'warn', summary: t('mailConsent') });
+    else if (n.mail === 'failed') one.toast({ severity: 'warn', summary: t('mailFailed') });
+  }
+  function act(action, okKey) {
+    if (!selected) return;
+    api('POST', '/api/visitors/' + encodeURIComponent(selected.id) + '/' + action).then(function (r) {
+      if (!r.ok) { one.toast({ severity: 'error', summary: problem(r) }); refresh(); return; }
+      one.toast({ severity: 'success', summary: t(okKey) });
+      notifyResult(r.body.notification);
+      refresh();
+    });
+  }
+  todayTable.addEventListener('rowclick', function (e) { select(e.detail.row); });
+  $('checkIn').addEventListener('click', function () { act('check-in', 'checkedIn'); });
+  $('checkOut').addEventListener('click', function () { act('check-out', 'checkedOut'); });
+  $('cancelVisit').addEventListener('click', function () {
+    one.confirm({ message: t('cancelConfirm'), severity: 'warn' }).then(function (yes) { if (yes) act('cancel', 'cancelled'); });
+  });
+  form.addEventListener('saved', function (e) {
+    e.preventDefault();
+    one.toast({ severity: 'success', summary: t('registered') });
+    resetForm(); refresh();
+  });
+  onSession(function () {
+    var manager = can(M.manage);
+    $('receptionBox').toggleAttribute('hidden', !manager); $('receptionDenied').toggleAttribute('hidden', manager);
+    $('allBox').toggleAttribute('hidden', !manager); $('allDenied').toggleAttribute('hidden', manager);
+    if (manager) { todayTable.reload(); allTable.reload(); }
+  });
+  onLang(function () { loadSummary(); select(selected); });
+  onReady(function () { loadSummary(); select(null); });
+`
+}

package/templates/ziyaretci-kaydi/files/src/visitor.test.ts.tpl

@@ -0,0 +1,34 @@
+import { describe, expect, it } from 'vitest'
+import { PLAN_AHEAD_MAX_DAYS, RETENTION_DAYS, TRANSITIONS, checkPlannedAt, istanbulDay, retentionCutoff, transitionConflict } from './visitor.ts'
+
+const NOW = new Date('2026-10-20T09:00:00Z')
+const DAY = 86_400_000
+
+describe('ziyaretçi kuralları', () => {
+  it('ziyaret günü İstanbul saatine göre', () => {
+    expect(istanbulDay(new Date('2026-10-20T20:59:00Z'))).toBe('2026-10-20')
+    expect(istanbulDay(new Date('2026-10-20T21:00:00Z'))).toBe('2026-10-21')
+  })
+
+  it('saklama sınırı: şu andan RETENTION_DAYS gün önce', () => {
+    expect(RETENTION_DAYS).toBeGreaterThan(0)
+    expect(retentionCutoff(NOW)).toBe(new Date(NOW.getTime() - RETENTION_DAYS * DAY).toISOString())
+    expect(retentionCutoff(NOW, 30)).toBe('2026-09-20T09:00:00.000Z')
+  })
+
+  it('planlanan zaman: saat dilimli; saklama süresinden eski ya da çok ileri olamaz', () => {
+    expect(checkPlannedAt('2026-10-20T14:00:00+03:00', NOW)).toEqual({ ok: true, iso: '2026-10-20T11:00:00.000Z', day: '2026-10-20' })
+    expect(checkPlannedAt('2026-10-20T14:00:00', NOW)).toMatchObject({ ok: false })
+    expect(checkPlannedAt('yarın', NOW)).toMatchObject({ ok: false })
+    expect(checkPlannedAt(new Date(NOW.getTime() - (RETENTION_DAYS + 1) * DAY).toISOString(), NOW)).toMatchObject({ ok: false })
+    expect(checkPlannedAt(new Date(NOW.getTime() + (PLAN_AHEAD_MAX_DAYS + 1) * DAY).toISOString(), NOW)).toMatchObject({ ok: false })
+  })
+
+  it('durum geçişleri: giriş yalnız beklenenden, çıkış yalnız içeridekinden', () => {
+    expect(TRANSITIONS['check-in']).toEqual({ from: 'expected', to: 'inside' })
+    expect(TRANSITIONS['check-out']).toEqual({ from: 'inside', to: 'left' })
+    expect(TRANSITIONS.cancel).toEqual({ from: 'expected', to: 'cancelled' })
+    expect(transitionConflict('check-in', 'inside')).toContain('zaten')
+    expect(transitionConflict('check-out', 'expected')).toContain('henüz')
+  })
+})

package/templates/ziyaretci-kaydi/files/src/visitor.ts.tpl

@@ -0,0 +1,57 @@
+// Ziyaretçi kuralları — SAF fonksiyonlar (veritabanı yok): saklama süresi, ziyaret günü, planlanan zaman doğrulaması ve
+// durum geçişleri. Sunucu her işlemi burada doğrular; kuralı değiştiren bu dosyayı ve `visitor.test.ts`'i birlikte
+// değiştirir.
+
+/**
+ * ⛔ KVKK saklama süresi (gün): ziyaretin son olayından (çıkış, yoksa giriş, yoksa planlanan zaman) bu kadar gün sonra
+ * ziyaretçinin kişisel bilgileri (ad soyad, firma, ziyaret amacı) gece işiyle silinir. TEK yer burasıdır; değiştirirseniz
+ * README ve AGENTS.md'deki süreyi de güncelleyin. Süreyi kurumunuzun kişisel veri saklama politikası belirler.
+ */
+export const RETENTION_DAYS = 90
+/** En çok kaç gün sonrası için ziyaret planlanabilir. */
+export const PLAN_AHEAD_MAX_DAYS = 365
+const DAY_MS = 86_400_000
+
+export const STATUSES = ['expected', 'inside', 'left', 'cancelled'] as const
+export type VisitStatus = (typeof STATUSES)[number]
+export type VisitAction = 'check-in' | 'check-out' | 'cancel'
+
+/** Eylem → hangi durumdan hangi duruma (başka durumdaki kayıtta eylem yapılmaz: 409). */
+export const TRANSITIONS: Record<VisitAction, { from: VisitStatus; to: VisitStatus }> = {
+  'check-in': { from: 'expected', to: 'inside' },
+  'check-out': { from: 'inside', to: 'left' },
+  cancel: { from: 'expected', to: 'cancelled' },
+}
+
+/** Ziyaret günü: İstanbul saatiyle gün (YYYY-AA-GG). Türkiye'de yaz saati uygulaması yoktur (UTC+3). */
+export function istanbulDay(at: Date): string {
+  return new Date(at.getTime() + 3 * 3_600_000).toISOString().slice(0, 10)
+}
+
+/** Saklama süresinin sınırı: son olayı bu andan ESKİ olan ziyaretlerin kişisel bilgileri silinir. */
+export function retentionCutoff(now: Date, days = RETENTION_DAYS): string {
+  return new Date(now.getTime() - days * DAY_MS).toISOString()
+}
+
+const DATETIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,3})?)?(?:Z|[+-]\d{2}:\d{2})$/
+
+export type PlannedCheck = { ok: true; iso: string; day: string } | { ok: false; message: string }
+
+/** Planlanan zaman: saat dilimli ISO tarih-saat; saklama süresinden eski ya da bir yıldan ileri olamaz. */
+export function checkPlannedAt(raw: unknown, now: Date): PlannedCheck {
+  if (typeof raw !== 'string' || !DATETIME_RE.test(raw.trim())) return { ok: false, message: 'Planlanan zamanı tarih ve saat olarak girin.' }
+  const t = Date.parse(raw.trim())
+  if (!Number.isFinite(t)) return { ok: false, message: 'Planlanan zamanı tarih ve saat olarak girin.' }
+  if (t < now.getTime() - RETENTION_DAYS * DAY_MS) return { ok: false, message: `Planlanan zaman ${RETENTION_DAYS} günden eski olamaz.` }
+  if (t > now.getTime() + PLAN_AHEAD_MAX_DAYS * DAY_MS) return { ok: false, message: `Ziyaret en çok ${PLAN_AHEAD_MAX_DAYS} gün sonrası için planlanabilir.` }
+  const at = new Date(t)
+  return { ok: true, iso: at.toISOString(), day: istanbulDay(at) }
+}
+
+/** Eylem yapılamadığında kullanıcıya söylenecek neden (kaydın bugünkü durumuna göre). */
+export function transitionConflict(action: VisitAction, current: string): string {
+  if (current === 'inside') return action === 'check-in' ? 'Ziyaretçinin girişi zaten yapıldı.' : 'Ziyaretçi içeride; önce çıkışını yapın.'
+  if (current === 'left') return 'Ziyaretçi çıkış yaptı; bu kayıtta işlem yapılamaz.'
+  if (current === 'cancelled') return 'Ziyaret iptal edildi; bu kayıtta işlem yapılamaz.'
+  return 'Ziyaretçinin girişi henüz yapılmadı.'
+}

package/templates/ziyaretci-kaydi/manifest.json.tpl

@@ -0,0 +1,38 @@
+{
+  "scopes": ["orgschema.read", "mail.execute", "push.execute"],
+  "services": { "database": true, "files": false, "cache": false },
+  "menuIcon": "pi pi-id-card",
+  "navigation": [
+    { "path": "/", "label": { "tr": "Ziyaretçilerim", "en": "My visitors" } },
+    { "path": "/reception", "label": { "tr": "Resepsiyon", "en": "Reception" }, "permission": "{{permissionPrefix}}Manage" },
+    { "path": "/visitors", "label": { "tr": "Tüm kayıtlar", "en": "All records" }, "permission": "{{permissionPrefix}}Manage" }
+  ],
+  "permissions": [
+    { "code": "{{permissionPrefix}}Manage", "name": { "tr": "Ziyaretçi kaydı tut (resepsiyon)", "en": "Keep the visitor log (reception)" } }
+  ],
+  "agent": {
+    "summary": {
+      "tr": "Ziyaretçi kaydı uygulaması: bugün beklenen, içeride olan ve ayrılan ziyaretçilerin sayıları (kişisel bilgi vermez).",
+      "en": "Visitor log app: counts of visitors expected today, inside now and left today (no personal data)."
+    },
+    "tools": [
+      {
+        "name": "count-visitors-today",
+        "title": { "tr": "Bugünkü ziyaretçi sayıları", "en": "Today's visitor counts" },
+        "description": {
+          "tr": "Bugün beklenen, şu an içeride olan ve bugün ayrılan ziyaretçilerin SAYILARINI döndürür; ad, firma ya da amaç döndürmez. Salt okunur.",
+          "en": "Returns the NUMBERS of visitors expected today, inside now and left today; never names, companies or purposes. Read-only."
+        },
+        "readOnly": true,
+        "permission": "{{permissionCode}}",
+        "input": { "type": "object", "properties": {} }
+      }
+    ]
+  },
+  "jobs": {
+    "schedules": [
+      { "name": "visitor-data-retention", "cron": "30 2 * * *", "timeZone": "Europe/Istanbul", "description": "Saklama süresi dolan ziyaretçilerin kişisel bilgilerini siler" }
+    ],
+    "queues": []
+  }
+}