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

package/templates/bakim-takvimi/files/src/schedule.test.ts.tpl

@@ -0,0 +1,58 @@
+import { describe, expect, it } from 'vitest'
+import { addDays, checkMaintenanceDate, checkPeriod, daysBetween, dueStatus, groupByResponsible, isCalendarDate, needsReminder, nextDueDate, todayKey, type DueRow } from './schedule.ts'
+
+describe('bakım takvimi kuralları', () => {
+  it('sıradaki bakım = son bakım + aralık; ay ve yıl geçişleri doğru', () => {
+    expect(nextDueDate('2026-01-31', 30)).toBe('2026-03-02')
+    expect(nextDueDate('2028-02-28', 1)).toBe('2028-02-29') // artık yıl
+    expect(nextDueDate('2026-12-15', 30)).toBe('2027-01-14')
+    expect(addDays('2026-03-01', -1)).toBe('2026-02-28')
+    expect(daysBetween('2026-10-20', '2026-10-27')).toBe(7)
+    expect(daysBetween('2026-10-20', '2026-10-18')).toBe(-2)
+  })
+
+  it('bakım aralığı tam gün ve sınırlar içinde', () => {
+    expect(checkPeriod(30)).toEqual({ ok: true, value: 30 })
+    expect(checkPeriod('90')).toEqual({ ok: true, value: 90 })
+    expect(checkPeriod(1.5)).toMatchObject({ ok: false })
+    expect(checkPeriod(0)).toMatchObject({ ok: false })
+    expect(checkPeriod(3651)).toMatchObject({ ok: false })
+    expect(checkPeriod('otuz')).toMatchObject({ ok: false })
+  })
+
+  it('bakım tarihi: geçerli gün, ileri tarih ve çok eski tarih reddedilir', () => {
+    expect(isCalendarDate('2026-02-30')).toBe(false)
+    expect(checkMaintenanceDate('2026-10-20', '2026-10-20')).toEqual({ ok: true, value: '2026-10-20' })
+    expect(checkMaintenanceDate('2026-10-21', '2026-10-20')).toMatchObject({ ok: false })
+    expect(checkMaintenanceDate('1999-12-31', '2026-10-20')).toMatchObject({ ok: false })
+    expect(checkMaintenanceDate('20.10.2026', '2026-10-20')).toMatchObject({ ok: false })
+  })
+
+  it('durum: geçmiş geciken, pencere içi yaklaşan (bugün dahil), sonrası planlı', () => {
+    expect(dueStatus('2026-10-19', '2026-10-20')).toBe('overdue')
+    expect(dueStatus('2026-10-20', '2026-10-20')).toBe('due-soon')
+    expect(dueStatus('2026-10-27', '2026-10-20')).toBe('due-soon')
+    expect(dueStatus('2026-10-28', '2026-10-20')).toBe('scheduled')
+  })
+
+  it('hatırlatma: aynı bakım tarihi için bir kez; bakım kaydedilince yeni tarih yeniden hatırlatılır', () => {
+    expect(needsReminder({ next_due_date: '2026-10-25', reminder_sent_for: null }, '2026-10-20')).toBe(true)
+    expect(needsReminder({ next_due_date: '2026-10-25', reminder_sent_for: '2026-10-25' }, '2026-10-20')).toBe(false)
+    expect(needsReminder({ next_due_date: '2026-11-24', reminder_sent_for: '2026-10-25' }, '2026-11-20')).toBe(true)
+    expect(needsReminder({ next_due_date: '2026-11-24', reminder_sent_for: null }, '2026-10-20')).toBe(false)
+  })
+
+  it('gruplama: kişi başına tek e-posta, en acil önce, kişi sınırı', () => {
+    const row = (id: string, who: string, due: string): DueRow => ({ id, code: id, name: id, location: null, next_due_date: due, responsible_org_id: who, reminder_sent_for: null })
+    const groups = groupByResponsible([row('c', 'b'.repeat(24), '2026-10-22'), row('a', 'a'.repeat(24), '2026-10-25'), row('b', 'B'.repeat(24), '2026-10-21'), row('d', 'c'.repeat(24), '2026-10-30')], 2)
+    expect(groups.map((g) => [g.responsible, g.items.map((i) => i.id)])).toEqual([
+      ['b'.repeat(24), ['b', 'c']],
+      ['a'.repeat(24), ['a']],
+    ])
+  })
+
+  it('bugün İstanbul saatine göre', () => {
+    expect(todayKey(new Date('2026-10-20T20:59:00Z'))).toBe('2026-10-20')
+    expect(todayKey(new Date('2026-10-20T21:00:00Z'))).toBe('2026-10-21')
+  })
+})

package/templates/bakim-takvimi/files/src/schedule.ts.tpl

@@ -0,0 +1,106 @@
+// Bakım takvimi kuralları — SAF fonksiyonlar (veritabanı ve ağ yok; `schedule.test.ts` sınar). Sıradaki bakım tarihi
+// HER ZAMAN sunucuda hesaplanır: son bakım + bakım aralığı (gün). İstemciden gelen tarih yazılmaz. Kuralı değiştiren bu
+// dosyayı, `queries.ts` içindeki aynı kuralın SQL karşılığını (`NEXT_DUE_SQL`) ve testleri birlikte değiştirir.
+
+/** Bakım aralığı sınırları (gün). ⚠️ İş kuralıdır — keşif görüşmesinde kullanıcıyla netleştirin. */
+export const PERIOD_MIN_DAYS = 1
+export const PERIOD_MAX_DAYS = 3650
+/** Sıradaki bakıma kaç gün kala hatırlatılır (geciken bakım da hatırlatılır). ⚠️ İş kuralıdır. */
+export const REMIND_DAYS = 7
+/** Kabul edilen en eski bakım tarihi (yanlış yazılan yılı yakalar). */
+export const EARLIEST_DATE = '2000-01-01'
+
+const DATE_RE = /^(\d{4})-(\d{2})-(\d{2})$/
+const DAY_MS = 86_400_000
+
+/** `YYYY-AA-GG` biçiminde gerçek bir takvim günü mü (31 Şubat değil)? */
+export function isCalendarDate(value: unknown): value is string {
+  if (typeof value !== 'string') return false
+  const m = DATE_RE.exec(value)
+  if (!m) return false
+  const d = new Date(Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3])))
+  return d.toISOString().slice(0, 10) === value
+}
+
+/** İstanbul saatiyle bugünün tarihi (Türkiye'de yaz saati uygulaması yoktur: UTC+3). */
+export function todayKey(at: Date): string {
+  return new Date(at.getTime() + 3 * 3_600_000).toISOString().slice(0, 10)
+}
+
+/** Takvim gününe gün ekler (`YYYY-AA-GG`). */
+export function addDays(date: string, days: number): string {
+  if (!isCalendarDate(date)) throw new Error(`geçersiz tarih: ${date}`)
+  return new Date(Date.parse(`${date}T00:00:00Z`) + days * DAY_MS).toISOString().slice(0, 10)
+}
+
+/** `from`'dan `to`'ya kaç gün (geçmişse eksi). */
+export function daysBetween(from: string, to: string): number {
+  return Math.round((Date.parse(`${to}T00:00:00Z`) - Date.parse(`${from}T00:00:00Z`)) / DAY_MS)
+}
+
+/** Sıradaki bakım = son bakım + aralık. ⛔ `queries.ts` → `NEXT_DUE_SQL` ile AYNI kural (test ikisini karşılaştırır). */
+export function nextDueDate(lastMaintenance: string, periodDays: number): string {
+  return addDays(lastMaintenance, periodDays)
+}
+
+export type Check<T> = { ok: true; value: T } | { ok: false; message: string }
+
+/** Bakım aralığı: tam gün, sınırlar içinde. */
+export function checkPeriod(raw: unknown): Check<number> {
+  const n = typeof raw === 'number' ? raw : typeof raw === 'string' && raw.trim() !== '' ? Number(raw) : NaN
+  if (!Number.isInteger(n)) return { ok: false, message: 'Bakım aralığı tam gün sayısı olmalı.' }
+  if (n < PERIOD_MIN_DAYS || n > PERIOD_MAX_DAYS) return { ok: false, message: `Bakım aralığı ${PERIOD_MIN_DAYS} ile ${PERIOD_MAX_DAYS} gün arasında olmalı.` }
+  return { ok: true, value: n }
+}
+
+/** Bakım tarihi: geçerli bir gün, bugünden ileri değil, `EARLIEST_DATE`'ten eski değil. */
+export function checkMaintenanceDate(raw: unknown, today: string): Check<string> {
+  if (!isCalendarDate(raw)) return { ok: false, message: 'Tarih YYYY-AA-GG biçiminde geçerli bir gün olmalı.' }
+  if (raw > today) return { ok: false, message: 'İleri tarihli bakım girilemez.' }
+  if (raw < EARLIEST_DATE) return { ok: false, message: `Tarih ${EARLIEST_DATE} ya da daha yeni olmalı.` }
+  return { ok: true, value: raw }
+}
+
+export type DueStatus = 'overdue' | 'due-soon' | 'scheduled'
+
+/** Durum: sıradaki bakım geçtiyse geciken; `REMIND_DAYS` içindeyse yaklaşan; değilse planlı. Bugün = yaklaşan. */
+export function dueStatus(nextDue: string, today: string, windowDays = REMIND_DAYS): DueStatus {
+  if (nextDue < today) return 'overdue'
+  return daysBetween(today, nextDue) <= windowDays ? 'due-soon' : 'scheduled'
+}
+
+/** Hatırlatma gerekir mi: pencere içinde (ya da gecikmiş) ve BU bakım tarihi için daha önce hatırlatılmamış. */
+export function needsReminder(row: { next_due_date: string | null; reminder_sent_for: string | null }, today: string, windowDays = REMIND_DAYS): boolean {
+  if (!row.next_due_date) return false
+  return daysBetween(today, row.next_due_date) <= windowDays && row.reminder_sent_for !== row.next_due_date
+}
+
+export interface DueRow {
+  id: string
+  code: string
+  name: string
+  location: string | null
+  next_due_date: string
+  responsible_org_id: string
+  reminder_sent_for: string | null
+}
+
+/**
+ * Hatırlatılacak bakımları sorumluya göre gruplar: kişi başına TEK e-posta. Bir koşumda en çok `maxGroups` kişiye
+ * gider (platformun istek başına dış çağrı sınırı); sıra en acil bakımdır. Kalanlar damgalanmadığı için ertesi gün gider.
+ */
+/** Bir hatırlatma e-postasında listelenen en çok ekipman (kalanlar damgalanmaz, sonraki koşumda gider). */
+export const REMINDER_ITEMS_PER_MAIL = 20
+
+export function groupByResponsible(rows: readonly DueRow[], maxGroups: number, maxItems = REMINDER_ITEMS_PER_MAIL): Array<{ responsible: string; items: DueRow[] }> {
+  const groups = new Map<string, DueRow[]>()
+  const sorted = [...rows].sort((a, b) => (a.next_due_date < b.next_due_date ? -1 : a.next_due_date > b.next_due_date ? 1 : a.code < b.code ? -1 : 1))
+  for (const row of sorted) {
+    const key = row.responsible_org_id.toLowerCase()
+    const list = groups.get(key)
+    if (list) {
+      if (list.length < maxItems) list.push(row)
+    } else if (groups.size < maxGroups) groups.set(key, [row])
+  }
+  return [...groups].map(([responsible, items]) => ({ responsible, items }))
+}

package/templates/bakim-takvimi/files/src/shell.ts.tpl

@@ -0,0 +1,299 @@
+// {{nameTr}} — sayfa (dört görünüm: Bakım takvimi · Gecikenler · Bakım kayıtları · Ekipmanlar). Liste, süzgeç, form,
+// kişi seçici ve dosya yükleyici hazır bileşenlerdir; seçenekler ve alan adları veri modelinden gelir. Sıradaki bakım
+// tarihi, geciken/yaklaşan sayıları ve geciken listesinin süzgeci 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.',
+    scheduleIntro: 'Kullanımdaki ekipmanlar, sıradaki bakım tarihine göre sıralı. Sıradaki tarih son bakım ve bakım aralığından hesaplanır.',
+    dueBanner: '{overdue} ekipmanın bakımı gecikti, {soon} ekipmanın bakımı {days} gün içinde.',
+    dueNone: 'Geciken ya da {days} gün içinde yaklaşan bakım yok.',
+    lastRun: 'Son hatırlatma kontrolü: {day} — {sent} kişiye 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ı.',
+    status: 'Durum',
+    statusOverdue: 'Gecikti',
+    statusSoon: 'Yaklaşıyor',
+    statusScheduled: 'Planlı',
+    search: 'Ara',
+    scheduleTable: 'Bakım takvimi',
+    overdueIntro: 'Sıradaki bakım tarihi geçmiş ekipmanlar. Liste Excel ya da CSV olarak alınabilir.',
+    overdueTable: 'Geciken bakımlar',
+    recordsIntro: 'Yapılan bakımlar. Bakım kaydı girilince ekipmanın son ve sıradaki bakım tarihi birlikte güncellenir. Kayıtlar değiştirilmez.',
+    recordForm: 'Bakım kaydı gir',
+    recordHint: 'Bakımı ekipmanın sorumlusu ya da bakım sorumlusu izni olan kişi kaydeder.',
+    recordSaved: 'Bakım kaydedildi. Sıradaki bakım: {next}.',
+    recordsTable: 'Bakım kayıtları',
+    download: 'Ek dosyayı indir',
+    downloadFailed: 'Ek dosya indirilemedi.',
+    noAttachment: 'Bu kayıtta ek dosya yok.',
+    equipmentIntro: 'Ekipman tanımları. Son bakım tarihi yalnız ilk tanımda girilir; sonrasında bakım kaydıyla değişir.',
+    equipmentTable: 'Ekipmanlar',
+    managersOnly: 'Bu işlem yalnız bakım sorumlusu izni olan kişilere açıktır.',
+    equipmentForm: 'Ekipman bilgileri',
+    newEquipment: 'Yeni ekipman',
+    equipmentSaved: 'Ekipman kaydedildi.',
+    responsible: 'Sorumlu (hatırlatma e-postasını alır)',
+    firstDate: 'Son bakım (ya da başlangıç) tarihi',
+  },
+  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.',
+    scheduleIntro: 'Equipment in use, sorted by next due date. The next date is computed from the last maintenance and the interval.',
+    dueBanner: '{overdue} items are overdue, {soon} items are due within {days} days.',
+    dueNone: 'No maintenance is overdue or due within {days} days.',
+    lastRun: 'Latest reminder check: {day} — e-mail sent to {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.',
+    status: 'Status',
+    statusOverdue: 'Overdue',
+    statusSoon: 'Due soon',
+    statusScheduled: 'Scheduled',
+    search: 'Search',
+    scheduleTable: 'Maintenance schedule',
+    overdueIntro: 'Equipment whose next maintenance date has passed. The list can be exported to Excel or CSV.',
+    overdueTable: 'Overdue maintenance',
+    recordsIntro: 'Completed maintenance. Recording maintenance updates the last and next dates of the equipment together. Records cannot be changed.',
+    recordForm: 'Record maintenance',
+    recordHint: 'Maintenance is recorded by the responsible person of the equipment or by someone with the maintenance manager permission.',
+    recordSaved: 'Maintenance saved. Next due: {next}.',
+    recordsTable: 'Maintenance records',
+    download: 'Download attachment',
+    downloadFailed: 'The attachment could not be downloaded.',
+    noAttachment: 'This record has no attachment.',
+    equipmentIntro: 'Equipment definitions. The last maintenance date is entered only when the item is created; afterwards it changes with maintenance records.',
+    equipmentTable: 'Equipment',
+    managersOnly: 'Only people with the maintenance manager permission can do this.',
+    equipmentForm: 'Equipment details',
+    newEquipment: 'New equipment',
+    equipmentSaved: 'Equipment saved.',
+    responsible: 'Responsible (gets the reminder e-mail)',
+    firstDate: 'Last maintenance (or start) date',
+  },
+}
+
+const MODEL = {
+  manage: '{{permissionPrefix}}Manage',
+  labels: {
+    code: label(dataModel, 'equipment', 'code'),
+    name: label(dataModel, 'equipment', 'name'),
+    category: label(dataModel, 'equipment', 'category'),
+    location: label(dataModel, 'equipment', 'location'),
+    responsibleName: label(dataModel, 'equipment', 'responsible_name'),
+    period: label(dataModel, 'equipment', 'period_days'),
+    last: label(dataModel, 'equipment', 'last_maintenance_date'),
+    next: label(dataModel, 'equipment', 'next_due_date'),
+    active: label(dataModel, 'equipment', 'active'),
+    equipment: label(dataModel, 'maintenance_records', 'equipment_id'),
+    equipmentName: label(dataModel, 'maintenance_records', 'equipment_name'),
+    performedOn: label(dataModel, 'maintenance_records', 'performed_on'),
+    note: label(dataModel, 'maintenance_records', 'note'),
+    attachment: label(dataModel, 'maintenance_records', 'attachment'),
+    attachmentName: label(dataModel, 'maintenance_records', 'attachment_name'),
+    performer: label(dataModel, 'maintenance_records', 'performer_name'),
+    recordNext: label(dataModel, 'maintenance_records', 'next_due_date'),
+  },
+}
+
+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, 'scheduleIntro', 'p', 'class="one-muted"')}
+<p><strong id="dueBanner"></strong></p>
+<p class="one-muted" id="runNote"></p>
+<one-filter id="scheduleFilter" for="scheduleTable"></one-filter>
+<one-table id="scheduleTable" src="/api/equipment?active=true" paging="page" export="xlsx csv" caption="${escapeHtml(tx('scheduleTable'))}"></one-table>`,
+    ),
+    view(
+      '/overdue',
+      path,
+      `${i18n(tx, 'overdueIntro', 'p', 'class="one-muted"')}
+<one-table id="overdueTable" src="/api/overdue/equipment" paging="page" export="xlsx csv" caption="${escapeHtml(tx('overdueTable'))}"></one-table>`,
+    ),
+    view(
+      '/records',
+      path,
+      `${i18n(tx, 'recordsIntro', 'p', 'class="one-muted"')}
+<section id="recordBox" class="one-card" hidden>
+<h2 data-i18n="recordForm">${escapeHtml(tx('recordForm'))}</h2>
+${i18n(tx, 'recordHint', 'p', 'class="one-muted"')}
+<one-form id="recordForm" no-cancel></one-form>
+</section>
+<one-table id="recordsTable" src="/api/maintenance_records" paging="page" export="xlsx csv" clickable caption="${escapeHtml(tx('recordsTable'))}"></one-table>`,
+    ),
+    view(
+      '/equipment',
+      path,
+      `${i18n(tx, 'equipmentIntro', 'p', 'class="one-muted"')}
+<one-table id="equipmentTable" src="/api/equipment" paging="page" export="xlsx csv" clickable caption="${escapeHtml(tx('equipmentTable'))}"></one-table>
+${i18n(tx, 'managersOnly', 'p', 'class="one-muted" id="equipmentDenied"')}
+<section id="equipmentEditor" class="one-card" hidden>
+<h2 data-i18n="equipmentForm">${escapeHtml(tx('equipmentForm'))}</h2>
+<div class="app-toolbar">${btn('newEquipment', 'newEquipment')}</div>
+<one-form id="equipmentForm" action="/api/equipment" 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 scheduleTable = $('scheduleTable'), overdueTable = $('overdueTable'), recordsTable = $('recordsTable'), equipmentTable = $('equipmentTable');
+  var recordForm = $('recordForm'), equipmentForm = $('equipmentForm');
+  var TODAY = null, DAYS = 7, equipmentOptions = [];
+
+  // Durum yalnız gösterimdir; geciken listesinin süzgeci ve sayıları sunucudadır.
+  function dayDiff(a, b) { return Math.round((Date.parse(b + 'T00:00:00Z') - Date.parse(a + 'T00:00:00Z')) / 86400000); }
+  function statusText(row) {
+    if (!TODAY || !row.next_due_date) return '';
+    if (row.next_due_date < TODAY) return t('statusOverdue');
+    return dayDiff(TODAY, row.next_due_date) <= DAYS ? t('statusSoon') : t('statusScheduled');
+  }
+  var scheduleColumns = [
+    { key: 'next_due_date', label: M.labels.next, type: 'date' },
+    { key: 'status', label: { tr: S.tr.status, en: S.en.status }, sortable: false, format: function (v, row) { return statusText(row); } },
+    { key: 'code', label: M.labels.code },
+    { key: 'name', label: M.labels.name },
+    { key: 'category', label: M.labels.category },
+    { key: 'location', label: M.labels.location },
+    { key: 'responsible_name', label: M.labels.responsibleName },
+    { key: 'last_maintenance_date', label: M.labels.last, type: 'date' },
+    { key: 'period_days', label: M.labels.period, type: 'number' }
+  ];
+  scheduleTable.columns = scheduleColumns;
+  overdueTable.columns = scheduleColumns;
+  $('scheduleFilter').fields = [{ key: 'q', label: { tr: S.tr.search, en: S.en.search }, type: 'text' }];
+  recordsTable.columns = [
+    { key: 'performed_on', label: M.labels.performedOn, type: 'date' },
+    { key: 'equipment_name', label: M.labels.equipmentName },
+    { key: 'note', label: M.labels.note },
+    { key: 'performer_name', label: M.labels.performer },
+    { key: 'next_due_date', label: M.labels.recordNext, type: 'date' },
+    { key: 'attachment_name', label: M.labels.attachmentName }
+  ];
+  equipmentTable.columns = [
+    { key: 'code', label: M.labels.code },
+    { key: 'name', label: M.labels.name },
+    { key: 'category', label: M.labels.category },
+    { key: 'location', label: M.labels.location },
+    { key: 'period_days', label: M.labels.period, type: 'number' },
+    { key: 'next_due_date', label: M.labels.next, type: 'date' },
+    { key: 'responsible_name', label: M.labels.responsibleName },
+    { key: 'active', label: M.labels.active, type: 'boolean' }
+  ];
+  var baseFields = [
+    { key: 'code', label: M.labels.code, required: true, maxLength: 40 },
+    { key: 'name', label: M.labels.name, required: true, maxLength: 120 },
+    { key: 'category', label: M.labels.category, maxLength: 60 },
+    { key: 'location', label: M.labels.location, maxLength: 120 },
+    { key: 'period_days', label: M.labels.period, type: 'number', min: 1, max: 3650, required: true },
+    { key: 'responsible', label: { tr: S.tr.responsible, en: S.en.responsible }, type: 'person' },
+    { key: 'active', label: M.labels.active, type: 'boolean' }
+  ];
+  // Son bakım tarihi YALNIZ yeni ekipmanda sorulur; düzenlemede alan formda yoktur (sunucu da kabul etmez).
+  function newEquipment() {
+    equipmentForm.fields = baseFields.concat([{ key: 'last_maintenance_date', label: { tr: S.tr.firstDate, en: S.en.firstDate }, type: 'date', required: true, max: TODAY || undefined }]);
+    equipmentForm.setAttribute('action', '/api/equipment'); equipmentForm.setAttribute('method', 'POST');
+    equipmentForm.value = { period_days: 30, active: true, last_maintenance_date: TODAY };
+    one.setTitle(null);
+  }
+  function recordFields() {
+    recordForm.fields = [
+      { key: 'equipment', label: M.labels.equipment, type: 'choice', options: equipmentOptions, required: true },
+      { key: 'performed_on', label: M.labels.performedOn, type: 'date', required: true, max: TODAY || undefined },
+      { key: 'note', label: M.labels.note, type: 'longText', maxLength: 2000 },
+      { key: 'attachment', label: M.labels.attachment, type: 'file', accept: 'image/*,.pdf', maxSize: 5242880, action: '/api/files' }
+    ];
+  }
+  function loadEquipmentOptions() {
+    return loadAll('/api/equipment?active=true').then(function (r) {
+      if (!r.ok) { one.toast({ severity: 'error', summary: problem(r) }); return; }
+      equipmentOptions = r.body.items.map(function (x) { return { value: x.id, label: x.code + ' - ' + x.name }; });
+      recordFields();
+      recordForm.value = { performed_on: TODAY };
+    });
+  }
+  function loadSummary() {
+    return api('GET', '/api/summary').then(function (r) {
+      if (!r.ok) { one.toast({ severity: 'error', summary: problem(r) }); return; }
+      var s = r.body;
+      TODAY = s.today; DAYS = s.remindDays;
+      $('dueBanner').textContent = s.overdue + s.dueSoon > 0 ? t('dueBanner', { overdue: fmtNumber(s.overdue), soon: fmtNumber(s.dueSoon), days: s.remindDays }) : t('dueNone', { days: s.remindDays });
+      $('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) });
+      scheduleTable.reload(); overdueTable.reload();
+    });
+  }
+  recordForm.addEventListener('save', function (e) {
+    e.preventDefault();
+    var v = e.detail.value;
+    api('POST', '/api/equipment/' + encodeURIComponent(v.equipment) + '/maintenance', { performed_on: v.performed_on, note: v.note || '', attachment: v.attachment || null }).then(function (r) {
+      if (!r.ok) {
+        if (r.body && r.body.errors) recordForm.setErrors(r.body.errors, problem(r));
+        else one.toast({ severity: 'error', summary: problem(r) });
+        return;
+      }
+      one.toast({ severity: 'success', summary: t('recordSaved', { next: fmtDate(r.body.equipment.next_due_date) }) });
+      recordForm.value = { performed_on: TODAY };
+      recordsTable.reload(); equipmentTable.reload(); loadSummary();
+    });
+  });
+  recordsTable.addEventListener('rowclick', function (e) {
+    var r = e.detail.row;
+    if (!r.attachment) { one.toast({ severity: 'info', summary: t('noAttachment') }); return; }
+    one.fetch('/api/maintenance_records/' + 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 || 'ek', mime: (res.headers.get('content-type') || 'application/octet-stream').split(';')[0], data: data });
+      });
+    }, function () { one.toast({ severity: 'error', summary: t('downloadFailed') }); });
+  });
+  equipmentTable.addEventListener('rowclick', function (e) {
+    if (!can(M.manage) || !canWrite()) return;
+    var r = e.detail.row;
+    equipmentForm.fields = baseFields;
+    equipmentForm.setAttribute('action', '/api/equipment/' + encodeURIComponent(r.id));
+    equipmentForm.setAttribute('method', 'PATCH');
+    equipmentForm.value = Object.assign({}, r, { responsible: r.responsible_org_id ? { id: r.responsible_org_id, name: r.responsible_name || '' } : null });
+    one.setTitle(r.name);
+  });
+  $('newEquipment').addEventListener('click', newEquipment);
+  equipmentForm.addEventListener('saved', function (e) {
+    e.preventDefault();
+    one.toast({ severity: 'success', summary: t('equipmentSaved') });
+    newEquipment(); equipmentTable.reload(); loadEquipmentOptions(); loadSummary();
+  });
+  onSession(function () {
+    var manager = can(M.manage) && canWrite();
+    $('equipmentEditor').toggleAttribute('hidden', !manager); $('equipmentDenied').toggleAttribute('hidden', manager);
+    if (manager) newEquipment();
+  });
+  onLang(function () { loadSummary(); });
+  onReady(function () {
+    loadSummary().then(function () {
+      if (canWrite()) { $('recordBox').removeAttribute('hidden'); loadEquipmentOptions(); }
+    });
+  });
+`
+}

package/templates/bakim-takvimi/manifest.json.tpl

@@ -0,0 +1,64 @@
+{
+  "scopes": ["orgschema.read", "mail.execute"],
+  "services": { "database": true, "files": true, "cache": false },
+  "menuIcon": "pi pi-wrench",
+  "navigation": [
+    { "path": "/", "label": { "tr": "Bakım takvimi", "en": "Schedule" } },
+    { "path": "/overdue", "label": { "tr": "Gecikenler", "en": "Overdue" } },
+    { "path": "/records", "label": { "tr": "Bakım kayıtları", "en": "Maintenance log" } },
+    { "path": "/equipment", "label": { "tr": "Ekipmanlar", "en": "Equipment" }, "permission": "{{permissionPrefix}}Manage" }
+  ],
+  "permissions": [
+    { "code": "{{permissionPrefix}}Manage", "name": { "tr": "Ekipmanları ve bakım kayıtlarını yönet", "en": "Manage equipment and maintenance records" } }
+  ],
+  "agent": {
+    "summary": {
+      "tr": "Bakım takvimi uygulaması: cihaz ve ekipmanların periyodik bakımı, sıradaki bakım tarihleri, yaklaşan ve geciken bakımlar.",
+      "en": "Maintenance schedule app: periodic maintenance of devices and equipment, next due dates, upcoming and overdue work."
+    },
+    "tools": [
+      {
+        "name": "upcoming-maintenance",
+        "title": { "tr": "Yaklaşan bakımlar", "en": "Upcoming maintenance" },
+        "description": {
+          "tr": "Sıradaki bakım tarihi bugünden itibaren verilen gün içinde olan ya da geçmiş (geciken) ekipmanları, en acil olan önce döndürür. Salt okunur.",
+          "en": "Returns equipment whose next maintenance is due within the given number of days or already overdue, most urgent first. Read-only."
+        },
+        "readOnly": true,
+        "permission": "{{permissionCode}}",
+        "input": {
+          "type": "object",
+          "properties": {
+            "days": { "type": "integer", "minimum": 0, "maximum": 90, "description": "Bugünden itibaren kaç gün (varsayılan 14; 0 yalnız bugün ve gecikenler)" },
+            "limit": { "type": "integer", "minimum": 1, "maximum": 50, "description": "En çok kaç ekipman (varsayılan 20)" }
+          }
+        }
+      },
+      {
+        "name": "search-equipment",
+        "title": { "tr": "Ekipman ara", "en": "Search equipment" },
+        "description": {
+          "tr": "Ekipman kodunda, adında ya da konumunda aranan ifade geçen ekipmanları son ve sıradaki bakım tarihleri ve sorumlusuyla döndürür. Salt okunur.",
+          "en": "Returns equipment whose code, name or location contains the query, with last and next maintenance dates and the responsible person. Read-only."
+        },
+        "readOnly": true,
+        "permission": "{{permissionCode}}",
+        "input": {
+          "type": "object",
+          "properties": {
+            "query": { "type": "string", "minLength": 1, "maxLength": 80, "description": "Aranan ifade (ekipman kodu, ad ya da konum)" },
+            "limit": { "type": "integer", "minimum": 1, "maximum": 50, "description": "En çok kaç ekipman (varsayılan 10)" }
+          },
+          "required": ["query"]
+        }
+      }
+    ]
+  },
+  "jobs": {
+    "schedules": [
+      { "name": "daily-maintenance-reminders", "cron": "0 8 * * *", "timeZone": "Europe/Istanbul", "description": "Yaklaşan ve geciken bakımları sorumlusuna e-postayla hatırlatır" }
+    ],
+    "queues": [],
+    "services": ["mail.execute"]
+  }
+}

package/templates/egitim-sertifika/AGENTS.template.md.tpl

@@ -0,0 +1,41 @@
+## Bu uygulamanın şablonu: eğitim ve sertifika takibi (`egitim-sertifika`)
+
+Uygulama `create-devoplus-one-app --template egitim-sertifika` 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: `cert_types` (tür) + `certificates` (kişi başına kayıt) + `reminder_runs` (günlük hatırlatma kontrolü). Değişince `pnpm data:generate` |
+| `src/app.ts` | Uçlar: kendi kayıtlarım, ekibim (org şemasından), bütün kayıtlar, kayıt yazma, yönetici yenileme, belge, türler, özet |
+| `src/certificate.ts` | Saf kurallar: geçerlilik sonu (ay ekleme), doğrulama, durum, ekip, gruplama + `certificate.test.ts` |
+| `src/queries.ts` | Okumalar; "yenilendi" kuralı (`SUPERSEDED_SQL`) |
+| `src/jobs.ts` | Sabah işi `daily-certificate-reminders` (kişiye + yöneticisine e-posta; kişi başına tek e-posta; damga ile tekrar yok) |
+| `src/names.ts` | Uygulama adı ve eğitim sorumlusu izni |
+| `src/shell.ts` | Sayfa: sertifikalarım, ekibim, tüm kayıtlar, türler |
+| `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):
+
+- **Geçerlilik sonu SUNUCUDA hesaplanır:** tamamlanma tarihi + türün süresi (ay; hedef ayda o gün yoksa ayın son günü).
+  Kayıt uçları `expires_on`, `manager_org_id`, `manager_name`, `person_name`, `type_name` ve hatırlatma damgalarını
+  (`reminder_sent_for`, `manager_reminder_sent_for`, `reminder_failed_on`) istemciden ALMAZ (400). Türün süresi değişince eski kayıtlar değişmez.
+- **Kişi ve yönetici organizasyon şemasından SUNUCUDA çözülür:** kişi seçicinin değeri şemada aranır (yoksa 400), yönetici
+  `approvalChainReport(..., { maxDepth: 1 })` ile alınır (pasif yönetici atlanır).
+- **"Sertifikalarım" kişiyi oturumdan, "Ekibim" ekibi org şemasından çözer** (işlevsel yöneticisi oturumdaki kişi olan
+  aktif çalışanlar). İstemciden kişi ya da ekip listesi ALINMAZ; ekibi olmayana 403. Belgeyi yalnız kişinin kendisi,
+  doğrudan yöneticisi ya da eğitim sorumlusu indirir; başkasına 404.
+- **Bütün kayıtlar kişisel veridir:** liste ucu ve Devoplus yapay zekâsının `expiring-certificates` aracı eğitim
+  sorumlusu iznine (`…Manage`) bağlıdır. Bunu genişletmeyin.
+- **Hatırlatma alıcı başına bir kez gider:** gönderimden önce koşullu damga, kişiye `reminder_sent_for`, yöneticiye
+  `manager_reminder_sent_for` (= hatırlatılan geçerlilik sonu). Posta servisi alıcılardan birini atlarsa (`skipped`)
+  yalnız onun damgası geri alınır; ertesi gün yalnız o yeniden denenir, iletiyi almış olan aynı kaydı ikinci kez almaz.
+  "Yöneticileri yenile" yöneticisi değişen kaydın yönetici damgasını sıfırlar. Hatırlatması ulaşmayan kayıt
+  (`reminder_failed_on`) sıranın sonuna geçer: hiç ulaşamayan bir alıcı öteki kişileri hatırlatmasız bırakmaz. Yenilenen
+  (aynı kişi ve türde daha yeni kaydı olan) sertifika hatırlatılmaz.
+- **Zamanlanmış iş kullanıcısızdır:** e-posta uygulamanın kimliğiyle gider (`jobs.services: ["mail.execute"]` +
+  kurulumda yönetici onayı). Organizasyon şeması işte kullanılamaz; alıcılar kayıttaki kişi ve yönetici kimlikleridir.
+  Yöneticiler değiştiyse `POST /api/certificates/refresh-managers` kayıtları günceller.
+- **Bir koşumda en çok `MAILS_PER_RUN` (5) kişi** için e-posta gider (platformun istek başına dış çağrı sınırı 10); sayıyı
+  artırmayın.
+- Mobil bildirim bugün hiçbir ortamda açık değildir; "telefonuma bildirim gelsin" isteğinde bunu söyleyin.

package/templates/egitim-sertifika/README.md.tpl

@@ -0,0 +1,46 @@
+# {{nameTr}}
+
+Çalışanların eğitim ve sertifikalarını, geçerlilik sürelerini ve yenileme zamanlarını izleyen bir uygulama. Devoplus
+Portal'ın içinde, Portal menüsünden açılır. Bu uygulama Devoplus One'ın **eğitim ve sertifika takibi** şablonundan
+üretildi; ihtiyacınıza göre değiştirilecek bir başlangıç noktasıdır.
+
+## Ne yapar
+
+1. **Sertifikalarım:** herkes kendi eğitim ve sertifika kayıtlarını, geçerlilik sonlarını ve durumlarını (geçerli,
+   süresi doluyor, süresi doldu, yenilendi, süresiz) görür; belgeyi indirir, listeyi Excel'e aktarır.
+2. **Ekibim:** yöneticiler, organizasyon şemasında kendilerine bağlı çalışanların kayıtlarını görür ve Excel'e aktarır.
+   Ekip her açılışta organizasyon şemasından okunur; kimse başka bir ekibin kayıtlarını göremez.
+3. **Geçerlilik sonu kendiliğinden hesaplanır:** tamamlanma tarihi + sertifika türünün geçerlilik süresi (ay). Süresi
+   olmayan türler süresizdir. Aynı kişiye aynı türden daha yeni bir kayıt girilince eski kayıt "yenilendi" sayılır.
+4. **Hatırlatma:** her sabah 08:00'de, geçerliliği 30 gün içinde dolacak ya da dolmuş (yenilenmemiş) sertifikalar için
+   kişiye ve yöneticisine tek bir e-posta gider. Aynı sertifika her gün yeniden hatırlatılmaz; e-posta alıcılardan birine
+   ulaşmadıysa ertesi gün yalnız ona yeniden gönderilir.
+5. **Tüm kayıtlar ve sertifika türleri:** eğitim sorumlusu türleri tanımlar ve herkesin kayıtlarını girer (kişi, tür,
+   tamamlanma tarihi, belge numarası, belge dosyası). Liste süzülür ve Excel'e aktarılır.
+6. **Devoplus asistanı:** "Süresi yaklaşan sertifikalar hangileri?" gibi sorular Devoplus'un yapay zekâ asistanına
+   sorulduğunda cevap bu uygulamadan gelir (bu soru yalnız eğitim sorumlularına açıktır).
+
+## Kimler ne görür
+
+| Kim | Ne yapabilir |
+|---|---|
+| Uygulamayı kullanma izni olan herkes ({{permissionCode}}) | Kendi kayıtlarını görür, belgesini indirir, Excel'e aktarır |
+| Yönetici (organizasyon şemasına göre) | Ayrıca kendisine bağlı çalışanların kayıtlarını görür; hatırlatma e-postasını alır |
+| Eğitim sorumlusu ({{permissionPrefix}}Manage) | Türleri ve bütün kayıtları yönetir; Tüm kayıtlar ve Sertifika türleri sekmelerini görür |
+
+İzinleri portal yöneticisi **Yetki Yönetimi** ekranından verir. Yöneticilik ayrı bir izin değildir; organizasyon
+şemasından gelir.
+
+## Neleri değiştirebilirsiniz
+
+Yapay zekâ aracınıza iş diliyle söylemeniz yeterlidir:
+
+- "Hatırlatma 30 değil 60 gün önce gitsin."
+- "Ekibim görünümünde alt kademeler de görünsün" (bugün yalnız doğrudan bağlılar).
+- "Eğitimi veren kurum ve eğitim saati de tutulsun" — yeni alan.
+- "Çalışan kendi sertifikasını yükleyebilsin, eğitim sorumlusu onaylasın."
+
+Bilinmesi gerekenler: sabah hatırlatması uygulamanın kendi adına gönderilir; bunun için portal yöneticisinin uygulamayı
+kurarken **arka plan e-postasını onaylaması** gerekir. Onay yoksa hatırlatma gönderilmez, uygulamada "onay bekleniyor"
+yazar. Hatırlatma, kayıt girilirken organizasyon şemasından alınan yöneticiye gider; yöneticiler değiştiyse eğitim
+sorumlusu **Yöneticileri yenile** düğmesine basar. Bir sabahta en çok 5 kişi için e-posta gider; kalanlar ertesi sabaha kalır.