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

package/templates/ziyaretci-kaydi/files/one.data.json

@@ -0,0 +1,42 @@
+{
+  "version": 1,
+  "entities": {
+    "visitors": {
+      "title": { "tr": "Ziyaretçiler", "en": "Visitors" },
+      "fields": {
+        "full_name": { "type": "text", "title": { "tr": "Ad soyad", "en": "Full name" }, "required": true, "maxLength": 120 },
+        "company": { "type": "text", "title": { "tr": "Firma", "en": "Company" }, "maxLength": 120 },
+        "purpose": { "type": "text", "title": { "tr": "Ziyaret amacı", "en": "Purpose of visit" }, "required": true, "maxLength": 200 },
+        "host_org_id": { "type": "text", "title": { "tr": "Ziyaret edilen (kimlik)", "en": "Host (id)" }, "maxLength": 24, "index": true },
+        "host_name": { "type": "text", "title": { "tr": "Ziyaret edilen", "en": "Host" }, "maxLength": 120 },
+        "planned_at": { "type": "datetime", "title": { "tr": "Planlanan zaman", "en": "Planned time" }, "required": true, "index": true },
+        "visit_day": { "type": "text", "title": { "tr": "Ziyaret günü", "en": "Visit day" }, "required": true, "maxLength": 10, "index": true },
+        "status": {
+          "type": "choice",
+          "title": { "tr": "Durum", "en": "Status" },
+          "required": true,
+          "default": "expected",
+          "index": true,
+          "choices": [
+            { "value": "expected", "title": { "tr": "Bekleniyor", "en": "Expected" } },
+            { "value": "inside", "title": { "tr": "İçeride", "en": "Inside" } },
+            { "value": "left", "title": { "tr": "Ayrıldı", "en": "Left" } },
+            { "value": "cancelled", "title": { "tr": "İptal edildi", "en": "Cancelled" } }
+          ]
+        },
+        "checked_in_at": { "type": "datetime", "title": { "tr": "Giriş zamanı", "en": "Check-in time" } },
+        "checked_out_at": { "type": "datetime", "title": { "tr": "Çıkış zamanı", "en": "Check-out time" } },
+        "registered_by_name": { "type": "text", "title": { "tr": "Kaydeden", "en": "Registered by" }, "maxLength": 120 },
+        "anonymized_at": { "type": "datetime", "title": { "tr": "Kişisel bilgiler silindi", "en": "Personal data deleted" } }
+      }
+    },
+    "retention_runs": {
+      "title": { "tr": "Kişisel veri temizlikleri", "en": "Personal data clean-ups" },
+      "fields": {
+        "run_key": { "type": "text", "title": { "tr": "Temizlik günü", "en": "Clean-up day" }, "required": true, "unique": true, "maxLength": 20 },
+        "cutoff": { "type": "datetime", "title": { "tr": "Bu tarihten eski", "en": "Older than" }, "required": true },
+        "cleared_count": { "type": "number", "title": { "tr": "Silinen kayıt", "en": "Records cleared" }, "required": true, "default": 0, "min": 0 }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,13 @@
+// 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 ziyaretçinin KİŞİSEL BİLGİSİNİ (ad soyad, firma, ziyaret amacı) döndürmez: yalnız sayılar. Ziyaretçi kaydeden,
+// giriş ya da çıkış yapan araç bilinçli olarak yoktur.
+import { defineAgentTools } from '@devoplus/one-sdk'
+import type { Env } from './app.ts'
+import { dayCounts } from './queries.ts'
+
+export const agentTools = defineAgentTools<Env>({
+  'count-visitors-today': {
+    handler: async ({ env }) => dayCounts(env),
+  },
+})

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

@@ -0,0 +1,293 @@
+// {{nameTr}} — ziyaretçi kaydı. Uçlar (hepsi oturum ister; kimlik platformdan gelir):
+//   GET    /api/mine/visitors[?…]                  ziyaretçilerim: YALNIZ beni ziyaret edenler (süzgeç sunucuda zorlanır) + Excel
+//   GET    /api/mine/visitors/{id}                 beni ziyaret eden tek kayıt (başkasınınki 404)
+//   GET    /api/today/visitors[?…]                 bugünkü ziyaretçiler (resepsiyon) — gün sunucuda zorlanır + günün Excel'i
+//   GET    /api/visitors[?…] · /api/visitors/{id}  bütün kayıtlar (resepsiyon) + Excel
+//   POST   /api/visitors · PATCH /api/visitors/{id}   ziyaretçi kaydı (resepsiyon); durum ve giriş/çıkış zamanı istemciden ALINMAZ
+//   POST   /api/visitors/{id}/check-in             giriş: zamanı SUNUCU yazar, ziyaret edilen çalışana bildirim gider
+//   POST   /api/visitors/{id}/check-out            çıkış: zamanı SUNUCU yazar
+//   POST   /api/visitors/{id}/cancel               gelmeyecek ziyaretin iptali
+//   GET    /api/summary                            bugünün sayıları (kişisel bilgi yok) + son kişisel veri temizliği
+// Ziyaret silinmez (405): kişisel bilgiler saklama süresi dolunca gece işiyle silinir (`jobs.ts`, `RETENTION_DAYS`).
+// Telefon numarası ve kimlik numarası bilinçli olarak TUTULMAZ (KVKK: amaçla sınırlı veri).
+import {
+  OneError,
+  createCrudHandler,
+  getMyOrgContext,
+  logAudit,
+  logError,
+  requirePermission,
+  requireUser,
+  systemNotice,
+} from '@devoplus/one-sdk'
+import manifest from '../one.manifest.json' with { type: 'json' }
+import { agentTools } from './agent.ts'
+import { dataModel } from './data/types.ts'
+import { jobs } from './jobs.ts'
+import { fieldError, forward, matchId, nowIso, onlyFields, personValue, readJsonObject, withQuery } from './lib/http.ts'
+import { refuseActingSession } from './lib/record.ts'
+import { createApp, json, type AppDefinition, type BaseEnv, type RouteInput } from './lib/server.ts'
+import { notifyHost } from './notice.ts'
+import { dayCounts, lastRetentionRun } from './queries.ts'
+import { renderShell, renderShellScript } from './shell.ts'
+import { RETENTION_DAYS, TRANSITIONS, checkPlannedAt, istanbulDay, transitionConflict, type VisitAction } from './visitor.ts'
+
+export type Env = BaseEnv
+
+export const APP_NAME = { tr: {{nameTrJs}}, en: {{nameEnJs}} }
+/** Resepsiyon izni (manifest `permissions`): ziyaretçi kaydeder, giriş ve çıkış yapar, bütün kayıtları görür. */
+export const MANAGE_PERMISSION = '{{permissionPrefix}}Manage'
+
+/** Bütün kayıtlar: yalnız resepsiyon okur ve yazar. */
+export const visitors = createCrudHandler({ model: dataModel, entity: 'visitors', records: 'shared', canRead: MANAGE_PERMISSION, canWrite: MANAGE_PERMISSION })
+/** Bugünkü ziyaretçiler: yalnız resepsiyon; gün süzgeci sunucuda ZORLANIR. */
+export const todayVisitors = createCrudHandler({ model: dataModel, entity: 'visitors', records: 'shared', basePath: '/api/today', canRead: MANAGE_PERMISSION, canWrite: MANAGE_PERMISSION })
+/** Ziyaretçilerim: herkes; "ziyaret edilen = ben" süzgeci sunucuda ZORLANIR ve yazma yoktur. */
+export const myVisitors = createCrudHandler({ model: dataModel, entity: 'visitors', records: 'shared', basePath: '/api/mine' })
+
+/** Resepsiyonun yazabildiği alanlar; durum, giriş/çıkış zamanı, ziyaret günü ve kaydeden SUNUCUDAN gelir. */
+const EDITABLE = ['full_name', 'company', 'purpose', 'host', 'planned_at']
+const LIST_RESTS = new Set(['', '/export.xlsx', '/export.csv', '/report.html'])
+
+async function myName(input: RouteInput<Env>): Promise<string | null> {
+  try {
+    return (await getMyOrgContext(input.api()))?.fullName ?? null
+  } catch (error) {
+    logError(input.ctx, 'kişi adı okunamadı', error)
+    return null
+  }
+}
+
+/** Ziyaret edilen kişi zorunludur (gelişi ona bildirilir); kişi seçicinin değeri iki kolona ayrılır. */
+function hostColumns(raw: unknown): { host_org_id: string; host_name: string | null } {
+  const person = personValue(raw, 'host')
+  if (!person) throw fieldError('host', 'Ziyaret edilen çalışanı seçin.')
+  return { host_org_id: person.id, host_name: person.name || null }
+}
+
+async function createVisitor(input: RouteInput<Env>): Promise<Response> {
+  const { request, env, ctx } = input
+  requirePermission(ctx, MANAGE_PERMISSION)
+  const { host, planned_at, ...rest } = onlyFields(await readJsonObject(request), EDITABLE)
+  const planned = checkPlannedAt(planned_at, new Date())
+  if (!planned.ok) throw fieldError('planned_at', planned.message)
+  const record = {
+    ...rest,
+    ...hostColumns(host),
+    planned_at: planned.iso,
+    visit_day: planned.day,
+    status: 'expected',
+    registered_by_name: await myName(input),
+  }
+  const res = (await visitors.handle(forward(request, visitors.path, 'POST', record), env.DB, ctx))!
+  if (res.status === 201) {
+    const saved = (await res.clone().json()) as { id: string }
+    logAudit(ctx, 'visitor.register', saved.id)
+  }
+  return res
+}
+
+interface VisitorState {
+  status: string
+  anonymized_at: string | null
+}
+
+async function findState(env: Env, id: string): Promise<VisitorState | null> {
+  return env.DB.prepare('SELECT status, anonymized_at FROM "visitors" WHERE id = ? AND deleted_at IS NULL').bind(id).first<VisitorState>()
+}
+
+const ANONYMIZED = 'Bu ziyaretin kişisel bilgileri saklama süresi dolduğu için silindi; kayıt değiştirilemez.'
+
+async function updateVisitor(input: RouteInput<Env>, id: string): Promise<Response> {
+  const { request, env, ctx } = input
+  requirePermission(ctx, MANAGE_PERMISSION)
+  refuseActingSession(ctx)
+  const body = onlyFields(await readJsonObject(request), EDITABLE)
+  const current = await findState(env, id)
+  if (!current) throw new OneError(404, 'APP-E-404', 'Ziyaret bulunamadı.')
+  if (current.anonymized_at) throw new OneError(409, 'APP-E-022', ANONYMIZED)
+  if (current.status !== 'expected') throw new OneError(409, 'APP-E-021', 'Yalnız henüz gelmemiş ziyaretin bilgileri düzenlenebilir.')
+  const columns: Record<string, string | null> = {}
+  for (const name of VISITOR_TEXT_FIELDS) if (name in body) columns[name] = visitorText(body[name], name)
+  if ('host' in body) Object.assign(columns, hostColumns(body.host))
+  if ('planned_at' in body) {
+    const planned = checkPlannedAt(body.planned_at, new Date())
+    if (!planned.ok) throw fieldError('planned_at', planned.message)
+    columns.planned_at = planned.iso
+    columns.visit_day = planned.day
+  }
+  const names = Object.keys(columns)
+  if (names.length === 0) throw fieldError('', 'Güncellenecek alan gönderilmedi.')
+  // ⛔ Tek koşullu güncelleme: yalnız ziyaret hâlâ BEKLENİYORSA ve kişisel bilgileri silinmemişse yazılır. Durum yukarıda
+  //    okunduktan sonra araya giriş, iptal ya da gece temizliği girerse düzenleme 409 alır; aksi hâlde temizlenmiş bir
+  //    ziyaretin adı ve firması geri yazılabilirdi. Değişen metin alanının arama kolonu (`<alan>_fold`) NULL yapılır:
+  //    arama boş kolonda metni kendisi katlar.
+  const sets = names.flatMap((n) => (n === 'planned_at' ? [`${n} = ?`] : [`${n} = ?`, `${n}_fold = NULL`]))
+  const user = requireUser(ctx)
+  const res = await env.DB.prepare(
+    `UPDATE "visitors" SET ${sets.join(', ')}, updated_at = ?, updated_by = ? WHERE id = ? AND status = 'expected' AND anonymized_at IS NULL AND deleted_at IS NULL`,
+  )
+    .bind(...names.map((n) => columns[n] ?? null), nowIso(), user.sub, id)
+    .run()
+  if (Number(res.meta.changes ?? 0) !== 1) {
+    const now = await findState(env, id)
+    if (!now) throw new OneError(404, 'APP-E-404', 'Ziyaret bulunamadı.')
+    if (now.anonymized_at) throw new OneError(409, 'APP-E-022', ANONYMIZED)
+    throw new OneError(409, 'APP-E-021', 'Yalnız henüz gelmemiş ziyaretin bilgileri düzenlenebilir.')
+  }
+  logAudit(ctx, 'visitor.update', id)
+  // Yanıt, kaydın veri katmanındaki gösterimidir (liste ve ayrıntı ekranıyla aynı biçim).
+  return (await visitors.handle(forward(request, `${visitors.path}/${id}`, 'GET'), env.DB, ctx))!
+}
+
+/** Resepsiyonun düzenleyebildiği metin alanları; kuralları (zorunluluk, karakter sınırı) veri modelinden okunur. */
+const VISITOR_TEXT_FIELDS = ['full_name', 'company', 'purpose'] as const
+const SINGLE_LINE_BAD = /[\u0000-\u001f\u007f]/
+
+/** Veri katmanının metin kuralıyla aynı: boş = değer yok, tek satır, denetim karakteri yok, karakter sınırı. */
+function visitorText(raw: unknown, name: (typeof VISITOR_TEXT_FIELDS)[number]): string | null {
+  const field = dataModel.entities.visitors!.fields[name]!
+  const label = `"${field.title.tr}"`
+  if (raw === null || raw === undefined || (typeof raw === 'string' && raw.trim() === '')) {
+    if (field.required) throw fieldError(name, `${label} zorunlu.`)
+    return null
+  }
+  if (typeof raw !== 'string' || SINGLE_LINE_BAD.test(raw)) throw fieldError(name, `${label} tek satır olmalı ve denetim karakteri içermemeli.`)
+  if (field.maxLength !== undefined && [...raw].length > field.maxLength) throw fieldError(name, `${label} en çok ${field.maxLength} karakter olabilir.`)
+  return raw
+}
+
+/** Eylem uçları gövde ALMAZ: zaman ve durum sunucudandır; gövdede gelen her alan (ör. `checked_in_at`) 400 ile reddedilir. */
+async function rejectBodyFields(request: Request): Promise<void> {
+  if (!request.headers.has('content-type') && request.body === null) return
+  onlyFields(await readJsonObject(request), [])
+}
+
+async function transition(input: RouteInput<Env>, id: string, action: VisitAction): Promise<Response> {
+  const { request, env, ctx } = input
+  const user = requirePermission(ctx, MANAGE_PERMISSION)
+  refuseActingSession(ctx)
+  await rejectBodyFields(request)
+  const { from, to } = TRANSITIONS[action]
+  const now = nowIso()
+  const set =
+    action === 'check-in'
+      ? { sql: 'status = ?, checked_in_at = ?, visit_day = ?, visit_day_fold = NULL', params: [to, now, istanbulDay(new Date(now))] }
+      : action === 'check-out'
+        ? { sql: 'status = ?, checked_out_at = ?', params: [to, now] }
+        : { sql: 'status = ?', params: [to] }
+  // ⛔ Geçiş tek koşullu güncellemedir: yalnız kayıt BEKLENEN durumdaysa uygulanır. İki resepsiyon görevlisi aynı anda
+  // "Giriş" derse yalnız biri yazar, öteki 409 alır; giriş zamanı ilk yazıldığı gibi kalır.
+  const res = await env.DB.prepare(
+    `UPDATE "visitors" SET ${set.sql}, updated_at = ?, updated_by = ? WHERE id = ? AND status = ? AND anonymized_at IS NULL AND deleted_at IS NULL`,
+  )
+    .bind(...set.params, now, user.sub, id, from)
+    .run()
+  if (Number(res.meta.changes ?? 0) !== 1) {
+    const current = await findState(env, id)
+    if (!current) throw new OneError(404, 'APP-E-404', 'Ziyaret bulunamadı.')
+    if (current.anonymized_at) throw new OneError(409, 'APP-E-022', ANONYMIZED)
+    throw new OneError(409, 'APP-E-021', transitionConflict(action, current.status))
+  }
+  logAudit(ctx, `visitor.${action}`, id)
+  if (action !== 'check-in') return json({ id, status: to, ...(action === 'check-out' ? { checked_out_at: now } : {}) })
+
+  const row = await env.DB.prepare('SELECT full_name, company, host_org_id FROM "visitors" WHERE id = ?')
+    .bind(id)
+    .first<{ full_name: string; company: string | null; host_org_id: string | null }>()
+  const who = row ? (row.company ? `${row.full_name} (${row.company})` : row.full_name) : 'Ziyaretçiniz'
+  const notification = await notifyHost(
+    ctx,
+    input.api(),
+    systemNotice({ appName: APP_NAME.tr, title: `Ziyaretçiniz geldi: ${who}`, message: `${who} resepsiyonda giriş yaptı ve sizi bekliyor.` }),
+    row?.host_org_id ?? null,
+  )
+  return json({ id, status: to, checked_in_at: now, notification })
+}
+
+async function myOrgId(input: RouteInput<Env>): Promise<string> {
+  const me = await getMyOrgContext(input.api())
+  if (!me) throw new OneError(409, 'APP-E-010', 'Portalda kişi kaydınız bulunamadı; ziyaretçileriniz gösterilemiyor.')
+  return me.orgUserId.toLowerCase()
+}
+
+/** Ziyaretçilerim: liste ve dışa aktarma; istemcinin gönderdiği "ziyaret edilen" süzgeci YOK SAYILIR. */
+async function mine(input: RouteInput<Env>): Promise<Response | null> {
+  const { request, env, ctx, url, method } = input
+  requireUser(ctx)
+  if (method !== 'GET' && method !== 'HEAD') throw new OneError(405, 'APP-E-405', 'Ziyaretçilerim yalnız görüntülenir.')
+  const rest = url.pathname.slice(myVisitors.path.length)
+  const id = matchId(url.pathname, myVisitors.path)
+  if (id) {
+    // Tek kayıt: yalnız ziyaret edilen kişi okur; başkasının ziyaretçisi "yok" yanıtı alır (kimlik yoklanamaz).
+    const me = await myOrgId(input)
+    const own = await env.DB.prepare('SELECT 1 AS ok FROM "visitors" WHERE id = ? AND host_org_id = ? AND deleted_at IS NULL').bind(id, me).first<{ ok: number }>()
+    if (!own) throw new OneError(404, 'APP-E-404', 'Ziyaret bulunamadı.')
+    return myVisitors.handle(request, env.DB, ctx)
+  }
+  if (!LIST_RESTS.has(rest)) throw new OneError(404, 'APP-E-404', 'Bulunamadı.')
+  const me = await myOrgId(input)
+  const scoped = withQuery(request, url.pathname, (params) => {
+    params.delete('host_org_id')
+    params.set('host_org_id', me)
+  })
+  return myVisitors.handle(scoped, env.DB, ctx)
+}
+
+/** Bugünkü ziyaretçiler: gün sunucuda İstanbul saatiyle hesaplanır; istemcinin gün süzgeci YOK SAYILIR. */
+async function today(input: RouteInput<Env>): Promise<Response | null> {
+  const { request, env, ctx, url, method } = input
+  requirePermission(ctx, MANAGE_PERMISSION)
+  if (method !== 'GET' && method !== 'HEAD') throw new OneError(405, 'APP-E-405', 'Bugünkü liste yalnız görüntülenir; işlemler ziyaret kaydının uçlarındadır.')
+  const rest = url.pathname.slice(todayVisitors.path.length)
+  if (!LIST_RESTS.has(rest)) throw new OneError(404, 'APP-E-404', 'Bulunamadı.')
+  const day = istanbulDay(new Date())
+  const scoped = withQuery(request, url.pathname, (params) => {
+    params.delete('visit_day')
+    params.set('visit_day', day)
+  })
+  return todayVisitors.handle(scoped, env.DB, ctx)
+}
+
+async function summary({ env, ctx }: RouteInput<Env>): Promise<Response> {
+  requireUser(ctx)
+  const [counts, retention] = await Promise.all([dayCounts(env), lastRetentionRun(env)])
+  return json({ counts, retentionDays: RETENTION_DAYS, lastRetention: retention })
+}
+
+const ACTIONS: readonly VisitAction[] = ['check-in', 'check-out', 'cancel']
+
+async function routes(input: RouteInput<Env>): Promise<Response | null> {
+  const { url, method, env, ctx } = input
+  const path = url.pathname
+  if (path === '/api/summary' && method === 'GET') return summary(input)
+  if (path === myVisitors.path || path.startsWith(`${myVisitors.path}/`)) return mine(input)
+  if (path === todayVisitors.path || path.startsWith(`${todayVisitors.path}/`)) return today(input)
+  for (const action of ACTIONS) {
+    const id = matchId(path, visitors.path, action)
+    if (id && method === 'POST') return transition(input, id, action)
+  }
+  if (path === visitors.path && method === 'POST') return createVisitor(input)
+  const id = matchId(path, visitors.path)
+  if (id && method === 'PATCH') return updateVisitor(input, id)
+  if (id && (method === 'PUT' || method === 'DELETE'))
+    throw new OneError(405, 'APP-E-405', 'Ziyaret silinmez; gelmeyecekse iptal edin. Kişisel bilgiler saklama süresi dolunca kendiliğinden silinir.')
+  if (path === visitors.path || path.startsWith(`${visitors.path}/`)) {
+    if (method !== 'GET' && method !== 'HEAD') throw new OneError(405, 'APP-E-405', 'Bu işlem yapılamaz.')
+    return visitors.handle(input.request, env.DB, ctx)
+  }
+  return null
+}
+
+export const definition: Omit<AppDefinition<Env>, 'guide'> = {
+  manifest,
+  tools: agentTools,
+  jobs,
+  page: renderShell,
+  script: renderShellScript,
+  routes,
+}
+
+export function buildApp(guide: string) {
+  return createApp<Env>({ ...definition, guide })
+}

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

@@ -0,0 +1,49 @@
+// Zamanlanmış görevler (manifest `jobs`). Zamanlanmış iş KULLANICISIZDIR: Devoplus servislerini kullanmaz, yalnız
+// uygulamanın kendi veritabanını değiştirir.
+//
+// ⛔ KVKK: her gece 02:30'da (İstanbul) son olayı `RETENTION_DAYS` günden eski ziyaretlerin kişisel bilgileri silinir —
+// ad soyad, firma ve ziyaret amacı ile bu alanların arama kolonları (`<alan>_fold`). Arama kolonu da silinir: yalnız
+// asıl alanı boşaltmak kişinin adını arama kolonunda bırakırdı. Kayıt satırı kalır (zaman, durum, ziyaret edilen
+// çalışan): ziyaret sayıları bozulmaz, ama kişi artık tanınamaz. Silinmiş (yumuşak silme) satırlar da kapsanır.
+// Aynı iş birden çok kez gelebilir: güncelleme yalnız henüz silinmemiş satırlara uygulanır, kayıt gün anahtarıyla tekildir.
+import { defineJobs } from '@devoplus/one-sdk'
+import type { Env } from './app.ts'
+import { istanbulDay, retentionCutoff } from './visitor.ts'
+
+/** Sistemin yazdığı kayıtlarda `updated_by` / `created_by` değeri (kişi kimliği değildir). */
+export const SYSTEM_ACTOR = 'system:visitor-data-retention'
+
+/** Kişisel bilgileri silinen alanlar (arama kolonlarıyla birlikte). Yeni bir kişisel alan eklerseniz buraya da ekleyin. */
+export const PERSONAL_FIELDS_SQL =
+  "full_name = '', full_name_fold = NULL, company = NULL, company_fold = NULL, purpose = '', purpose_fold = NULL"
+
+export async function clearExpiredPersonalData(env: Env, now: Date): Promise<{ cutoff: string; cleared: number }> {
+  const cutoff = retentionCutoff(now)
+  const stamp = now.toISOString()
+  const res = await env.DB.prepare(
+    // Saklama süresini aşmış AÇIK ziyaret (çıkışı unutulmuş "içeride" ya da hiç gelmemiş "bekleniyor") aynı güncellemede
+    // kapanış durumuna geçer: anonim satır uygulamadan düzeltilemediği için açık kalsaydı "şu an içeride" sayısını kalıcı
+    // olarak şişirirdi. Çıkış zamanı bilinmediği için yazılmaz.
+    `UPDATE "visitors" SET ${PERSONAL_FIELDS_SQL}, status = CASE status WHEN 'inside' THEN 'left' WHEN 'expected' THEN 'cancelled' ELSE status END, ` +
+      'anonymized_at = ?, updated_at = ?, updated_by = ? ' +
+      'WHERE anonymized_at IS NULL AND coalesce(checked_out_at, checked_in_at, planned_at) < ?',
+  )
+    .bind(stamp, stamp, SYSTEM_ACTOR, cutoff)
+    .run()
+  return { cutoff, cleared: Number(res.meta.changes ?? 0) }
+}
+
+export const jobs = defineJobs<Env>({
+  schedules: {
+    'visitor-data-retention': async (job, env) => {
+      const at = job.scheduledTime ? new Date(job.scheduledTime) : new Date()
+      const { cutoff, cleared } = await clearExpiredPersonalData(env, at)
+      const now = at.toISOString()
+      await env.DB.prepare(
+        'INSERT OR IGNORE INTO "retention_runs" (id, created_at, created_by, updated_at, updated_by, run_key, cutoff, cleared_count) VALUES (?, ?, ?, ?, ?, ?, ?, ?)',
+      )
+        .bind(crypto.randomUUID(), now, SYSTEM_ACTOR, now, SYSTEM_ACTOR, istanbulDay(at), cutoff, cleared)
+        .run()
+    },
+  },
+})

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

@@ -0,0 +1,48 @@
+// Ziyaretçi geldi bildirimi: ziyaret edilen çalışana e-posta (ortak `sendMailSafely`) ve Devoplus Portal mobil
+// uygulamasına bildirim. Bildirim asıl işin sonucudur, parçası değildir: giriş kaydı yazıldıktan SONRA gönderilir ve
+// düşerse giriş geri alınmaz — sonuç kanal başına döner, arayüz kullanıcıya söyler.
+// Mobil bildirim (`push.execute`) e-posta gibi kullanıcının Portal'daki ayrı ve süreli onayına bağlıdır. Ayrıca platformda
+// her ortamda açık olmayabilir: kapalıysa sunucu reddeder (`ONE-APP-E-029`) ve sonuç `unavailable` olur.
+import { awaitsUserConsent, logError, notify, type BackendClient, type OneContext, type Recipients, type ScenarioMessage } from '@devoplus/one-sdk'
+import { sendMailSafely, type MailOutcome } from './lib/mail.ts'
+
+export type PushOutcome = 'sent' | 'consent-needed' | 'unavailable' | 'failed' | 'skipped'
+/** Platformun "mobil bildirim bu ortamda/portalda kapalı" kodu. */
+export const PUSH_DISABLED_CODE = 'ONE-APP-E-029'
+
+export async function sendPushSafely(ctx: OneContext, api: BackendClient, message: ScenarioMessage, recipients: Recipients): Promise<PushOutcome> {
+  if ((recipients.toSubjects?.length ?? 0) + (recipients.toOrgUserIds?.length ?? 0) === 0) return 'skipped'
+  if (awaitsUserConsent(ctx, 'push.execute')) return 'consent-needed'
+  try {
+    const result = await notify(api, message, { ...recipients, channels: ['push'] })
+    const push = result.push
+    if (push && 'error' in push) {
+      if (push.error.code === PUSH_DISABLED_CODE) return 'unavailable'
+      logError(ctx, 'mobil bildirim gönderilemedi', push.error)
+      return 'failed'
+    }
+    // Sunucu isteği kabul edip HİÇBİR alıcıyı kuyruğa almadıysa (pasif kişi, adres yok, sınır…) ileti kimseye gitmedi:
+    // ekranda "ev sahibine bildirildi" denmez.
+    if (!push || push.queued === 0) {
+      logError(ctx, 'mobil bildirim hiçbir alıcıya ulaşmadı', push?.skipped ?? [])
+      return 'failed'
+    }
+    return 'sent'
+  } catch (error) {
+    logError(ctx, 'mobil bildirim gönderilemedi', error)
+    return 'failed'
+  }
+}
+
+export interface HostNotice {
+  mail: MailOutcome
+  push: PushOutcome
+}
+
+/** İki kanal birbirinden bağımsızdır: biri düşerse öteki yine denenir. */
+export async function notifyHost(ctx: OneContext, api: BackendClient, message: ScenarioMessage, hostOrgId: string | null): Promise<HostNotice> {
+  const to: Recipients = hostOrgId ? { toOrgUserIds: [hostOrgId] } : {}
+  const mail = await sendMailSafely(ctx, api, message, to)
+  const push = await sendPushSafely(ctx, api, message, to)
+  return { mail, push }
+}

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

@@ -0,0 +1,45 @@
+// Veritabanı okumaları — ekran, zamanlanmış iş ve Devoplus yapay zekâsı araçları aynı sorguları kullanır. Bu dosyadaki
+// sayımlar KİŞİSEL BİLGİ döndürmez (ad, firma, amaç yok): yapay zekâ aracı da bunları kullanır.
+import type { BaseEnv } from './lib/server.ts'
+import { istanbulDay } from './visitor.ts'
+
+export interface DayCounts {
+  day: string
+  /** Bugün için planlanmış, henüz gelmemiş. */
+  expected: number
+  /** Bugün giriş yapmış (içeride ya da ayrılmış). */
+  checkedIn: number
+  /** Bugün giriş yapıp ayrılmış. */
+  left: number
+  /** Şu an içeride (önceki günlerden çıkışı yapılmamış olanlar dahil). */
+  insideNow: number
+}
+
+export async function dayCounts(env: BaseEnv, now = new Date()): Promise<DayCounts> {
+  const day = istanbulDay(now)
+  const row = await env.DB.prepare(
+    'SELECT ' +
+      "SUM(CASE WHEN status = 'expected' AND visit_day = ? THEN 1 ELSE 0 END) AS expected, " +
+      "SUM(CASE WHEN status IN ('inside', 'left') AND visit_day = ? THEN 1 ELSE 0 END) AS checked_in, " +
+      "SUM(CASE WHEN status = 'left' AND visit_day = ? THEN 1 ELSE 0 END) AS left_count, " +
+      "SUM(CASE WHEN status = 'inside' THEN 1 ELSE 0 END) AS inside_now " +
+      'FROM "visitors" WHERE deleted_at IS NULL',
+  )
+    .bind(day, day, day)
+    .first<{ expected: number | null; checked_in: number | null; left_count: number | null; inside_now: number | null }>()
+  return {
+    day,
+    expected: row?.expected ?? 0,
+    checkedIn: row?.checked_in ?? 0,
+    left: row?.left_count ?? 0,
+    insideNow: row?.inside_now ?? 0,
+  }
+}
+
+export async function lastRetentionRun(env: BaseEnv) {
+  return env.DB.prepare('SELECT run_key, cutoff, cleared_count FROM "retention_runs" WHERE deleted_at IS NULL ORDER BY run_key DESC LIMIT 1').first<{
+    run_key: string
+    cutoff: string
+    cleared_count: number
+  }>()
+}