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

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

@@ -0,0 +1,127 @@
+// Zamanlanmış görev (manifest `jobs`): her sabah 08:00 (İstanbul) termini geçmiş açık faaliyetleri sorumlusuna e-postayla
+// hatırlatır. Zamanlanmış iş KULLANICISIZDIR: e-posta kişi adına değil UYGULAMANIN kimliğiyle gider. Bunun için manifest
+// `jobs.services` içinde `mail.execute` beyan edilir VE kurulumda portal yöneticisi bu servisi ONAYLAR; onay yoksa
+// Devoplus 403 döner — iş bunu "onay gerekiyor" olarak kaydeder (uygulamada ve Devoplus yapay zekâsında görünür).
+//
+// ⛔ "Günde bir kez" kuralı damgadadır: faaliyet önce o günün anahtarıyla koşullu olarak damgalanır (`reminded_on`), e-posta
+// yalnız damgayı koyabilen faaliyetler için gider. Gönderim başarısızsa damga GERİ ALINIR (önceki değerine döner): ertesi
+// gün yeniden denenir. Aynı gün ikinci kez gelen iş (yeniden deneme) aynı kişiye ikinci e-posta göndermez.
+// Bir koşumda en çok REMINDER_OWNERS_PER_RUN kişiye gider; en uzun süredir hatırlatılmayan önce gelir, kalanlar ertesi güne.
+// Hatırlatması ulaşmamış sorumlu (`reminder_failed_on`) sıranın SONUNA geçer: hiç ulaşamayan bir kişi (ör. ayrılmış bir
+// çalışan) damgası geri alındığı için hep "en uzun süredir hatırlatılmayan" kalır ve öteki kişileri hatırlatmasız bırakırdı.
+import { BackendClient, defineJobs, foldSearchText, logError, notify, systemNotice, type OneContext, type Recipients, type ScenarioMessage } from '@devoplus/one-sdk'
+import { APP_NAME, type Env } from './app.ts'
+import { REMINDER_ACTIONS_PER_MAIL, REMINDER_OWNERS_PER_RUN, istanbulDay, reminderMessage } from './capa.ts'
+import type { MailOutcome } from './lib/mail.ts'
+import { OVERDUE } from './queries.ts'
+
+/** Sistemin yazdığı kayıtlarda `created_by` değeri (kişi kimliği değildir). */
+export const SYSTEM_ACTOR = 'system:overdue-reminders'
+
+/** İşte e-posta: onaysız servis 403 → `consent-needed` (portal yöneticisinin kurulum onayı gerekiyor). */
+async function sendJobMail(ctx: OneContext, api: BackendClient, message: ScenarioMessage, recipients: Recipients): Promise<MailOutcome> {
+  try {
+    const mail = (await notify(api, message, { ...recipients, channels: ['mail'] })).mail
+    if (mail && 'error' in mail) {
+      logError(ctx, 'hatırlatma e-postası gönderilemedi', mail.error)
+      return mail.error.status === 403 ? 'consent-needed' : '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:
+    // "gönderildi" sayılmaz, damga geri alınır ve sonraki koşumda yeniden denenir.
+    if (!mail || mail.queued === 0) {
+      logError(ctx, 'hatırlatma e-postası hiçbir alıcıya ulaşmadı', mail?.skipped ?? [])
+      return 'failed'
+    }
+    return 'sent'
+  } catch (error) {
+    logError(ctx, 'hatırlatma e-postası gönderilemedi', error)
+    return 'failed'
+  }
+}
+
+export const jobs = defineJobs<Env>({
+  schedules: {
+    'overdue-reminders': async (job, env, ctx) => {
+      const at = job.scheduledTime ? new Date(job.scheduledTime) : new Date()
+      const today = istanbulDay(at)
+      const pending = '(a.reminded_on IS NULL OR a.reminded_on <> ?)'
+      // Bu koşumda yazılacak kişiler SIRAYLA seçilir; bekleyen kişi SAYISI ayrı sayılır (okuma sınırıyla kesilmez): turun
+      // "ertelenen" sayısı, kaç kişi olursa olsun tamdır.
+      const [owners, waiting] = await env.DB.batch<{ owner: string; n: number }>([
+        env.DB.prepare(
+          `SELECT a.owner_org_id AS owner, MIN(coalesce(a.reminded_on, '')) AS last, MAX(coalesce(a.reminder_failed_on, '')) AS failed FROM "actions" a WHERE ${OVERDUE} AND ${pending} ` +
+            'GROUP BY a.owner_org_id ORDER BY failed, last, MIN(a.due_date) LIMIT ?',
+        ).bind(today, today, REMINDER_OWNERS_PER_RUN),
+        env.DB.prepare(`SELECT COUNT(DISTINCT a.owner_org_id) AS n FROM "actions" a WHERE ${OVERDUE} AND ${pending}`).bind(today, today),
+      ])
+      // Uygulamanın kimliğiyle (belirteçsiz): platform işte kendi kimliğini ekler.
+      const api = new BackendClient({ baseUrl: env.API_BASE, authorization: null })
+      const batch = owners?.results ?? []
+      const run = { owners: 0, actions: 0, failed: 0, deferred: Math.max(0, Number(waiting?.results[0]?.n ?? 0) - batch.length), consentNeeded: false }
+      for (let i = 0; i < batch.length; i++) {
+        const owner = batch[i]!.owner
+        const items = await env.DB.prepare(
+          `SELECT a.id, a.description, a.nonconformity_title, a.due_date, a.reminded_on FROM "actions" a WHERE a.owner_org_id = ? AND ${OVERDUE} AND ${pending} ORDER BY a.due_date, a.created_at`,
+        )
+          .bind(owner, today, today)
+          .all<{ id: string; description: string; nonconformity_title: string | null; due_date: string; reminded_on: string | null }>()
+        if (items.results.length === 0) continue
+        // ⛔ Damga koşulludur ve faaliyeti seçen koşulun TAMAMINI yeniden ister: eşzamanlı ikinci koşum aynı faaliyeti
+        // damgalayamaz; okumadan sonra faaliyet tamamlanır, termini ileri alınır, kaydı kapanır ya da faaliyet BAŞKASINA
+        // verilirse damgalanmaz ve bu kişiye giden e-postada yer almaz (yeni sorumlunun hatırlatması da bastırılmaz).
+        const stamps = await env.DB.batch(
+          items.results.map((item) =>
+            env.DB.prepare(`UPDATE "actions" AS a SET reminded_on = ?, reminded_on_fold = ? WHERE a.id = ? AND a.owner_org_id = ? AND ${OVERDUE} AND ${pending}`).bind(
+              today,
+              foldSearchText(today),
+              item.id,
+              owner,
+              today,
+              today,
+            ),
+          ),
+        )
+        const stamped = items.results.filter((_, k) => Number(stamps[k]?.meta.changes ?? 0) === 1)
+        if (stamped.length === 0) continue
+        const shown = stamped.slice(0, REMINDER_ACTIONS_PER_MAIL)
+        const text = reminderMessage(shown, today, stamped.length - shown.length)
+        const outcome = await sendJobMail(ctx, api, systemNotice({ appName: APP_NAME.tr, title: text.title, message: text.message }), { toOrgUserIds: [owner] })
+        if (outcome === 'sent') {
+          run.owners++
+          run.actions += stamped.length
+          // Ulaştı: önceki başarısız denemenin izi silinir (sıradaki yerine döner).
+          await env.DB.batch(stamped.map((item) => env.DB.prepare('UPDATE "actions" SET reminder_failed_on = NULL WHERE id = ? AND reminder_failed_on IS NOT NULL').bind(item.id)))
+          continue
+        }
+        // Gönderilemedi: damga önceki değerine döner (ertesi gün yeniden denenir); ileti ULAŞMADIYSA sıranın sonuna geçer.
+        await env.DB.batch(
+          stamped.map((item) =>
+            env.DB.prepare('UPDATE "actions" SET reminded_on = ?, reminded_on_fold = ?, reminder_failed_on = coalesce(?, reminder_failed_on) WHERE id = ? AND reminded_on = ?').bind(
+              item.reminded_on,
+              item.reminded_on === null ? null : foldSearchText(item.reminded_on),
+              outcome === 'failed' ? today : null,
+              item.id,
+              today,
+            ),
+          ),
+        )
+        if (outcome === 'consent-needed') {
+          // Servis kurulumda onaylanmamış: diğer kişiler için de aynı yanıt gelir, denemeye devam edilmez.
+          run.consentNeeded = true
+          run.deferred += batch.length - i
+          break
+        }
+        run.failed++
+      }
+      const now = at.toISOString()
+      await env.DB.batch([
+        env.DB.prepare(
+          'INSERT OR IGNORE INTO "reminder_runs" (id, created_at, created_by, updated_at, updated_by, run_key, reminded_owners, reminded_actions, failed, deferred_owners, consent_needed) VALUES (?, ?, ?, ?, ?, ?, 0, 0, 0, 0, 0)',
+        ).bind(crypto.randomUUID(), now, SYSTEM_ACTOR, now, SYSTEM_ACTOR, today),
+        env.DB.prepare(
+          'UPDATE "reminder_runs" SET reminded_owners = reminded_owners + ?, reminded_actions = reminded_actions + ?, failed = failed + ?, deferred_owners = ?, consent_needed = ?, updated_at = ?, updated_by = ? WHERE run_key = ? AND deleted_at IS NULL',
+        ).bind(run.owners, run.actions, run.failed, run.deferred, run.consentNeeded ? 1 : 0, now, SYSTEM_ACTOR, today),
+      ])
+    },
+  },
+})

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

@@ -0,0 +1,102 @@
+// Veritabanı okumaları — ekran, zamanlanmış iş ve Devoplus yapay zekâsı araçları aynı sorguları kullanır.
+import type { BaseEnv } from './lib/server.ts'
+
+export interface NcRow {
+  id: string
+  created_by: string
+  title: string
+  source: string
+  severity: string
+  description: string
+  location: string | null
+  detected_on: string | null
+  reporter_name: string | null
+  root_cause: string | null
+  status: 'open' | 'planned' | 'verification' | 'closed'
+  attachment: string | null
+  attachment_name: string | null
+  closed_at: string | null
+  closed_by_name: string | null
+  closure_note: string | null
+  /** Doğrulamada etkisiz bulunup planlamaya döndüğü son an; sonraki doğrulama bundan SONRA eklenmiş bir faaliyet ister. */
+  verification_failed_at: string | null
+  created_at: string
+  updated_at: string
+}
+
+export interface ActionRow {
+  id: string
+  nonconformity_id: string
+  nonconformity_title: string | null
+  description: string
+  owner_org_id: string
+  owner_name: string | null
+  due_date: string
+  status: 'open' | 'done'
+  done_at: string | null
+  done_note: string | null
+  done_by_name: string | null
+  reminded_on: string | null
+  created_at: string
+}
+
+const NC_COLUMNS =
+  'id, created_by, title, source, severity, description, location, detected_on, reporter_name, root_cause, status, attachment, attachment_name, closed_at, closed_by_name, closure_note, verification_failed_at, created_at, updated_at'
+const ACTION_COLUMNS =
+  'id, nonconformity_id, nonconformity_title, description, owner_org_id, owner_name, due_date, status, done_at, done_note, done_by_name, reminded_on, created_at'
+
+export async function findNc(env: BaseEnv, id: string): Promise<NcRow | null> {
+  return env.DB.prepare(`SELECT ${NC_COLUMNS} FROM "nonconformities" WHERE id = ? AND deleted_at IS NULL`).bind(id).first<NcRow>()
+}
+
+export async function findAction(env: BaseEnv, id: string): Promise<ActionRow | null> {
+  return env.DB.prepare(`SELECT ${ACTION_COLUMNS} FROM "actions" WHERE id = ? AND deleted_at IS NULL`).bind(id).first<ActionRow>()
+}
+
+export async function actionsOf(env: BaseEnv, ncId: string): Promise<ActionRow[]> {
+  const rows = await env.DB.prepare(`SELECT ${ACTION_COLUMNS} FROM "actions" WHERE nonconformity_id = ? AND deleted_at IS NULL ORDER BY due_date, created_at`).bind(ncId).all<ActionRow>()
+  return rows.results
+}
+
+/** Gecikmiş açık faaliyet: termini bugünden önce, kaydı silinmemiş ve kapanmamış. `a` takma adıyla kullanılır. */
+export const OVERDUE =
+  "a.status = 'open' AND a.deleted_at IS NULL AND a.due_date < ? AND EXISTS (SELECT 1 FROM \"nonconformities\" n WHERE n.id = a.nonconformity_id AND n.deleted_at IS NULL AND n.status <> 'closed')"
+
+/** Geciken faaliyetler (en çok geciken önce); sorumlunun adında geçen ifadeyle süzülebilir. */
+export async function overdueActions(env: BaseEnv, today: string, limit: number, owner?: string) {
+  const q = (owner ?? '').trim().toLowerCase()
+  const rows = await env.DB.prepare(
+    `SELECT a.id, a.description, a.owner_name, a.due_date, a.nonconformity_title, n.severity FROM "actions" a JOIN "nonconformities" n ON n.id = a.nonconformity_id WHERE ${OVERDUE}` +
+      (q ? " AND instr(lower(coalesce(a.owner_name, '')), ?) > 0" : '') +
+      ' ORDER BY a.due_date, a.created_at LIMIT ?',
+  )
+    .bind(...(q ? [today, q, limit] : [today, limit]))
+    .all<{ id: string; description: string; owner_name: string | null; due_date: string; nonconformity_title: string | null; severity: string }>()
+  return rows.results
+}
+
+/** Geciken faaliyet sayısı; `owner` verilirse `overdueActions` ile AYNI süzgeçle (liste ve toplam aynı kümeyi anlatır). */
+export async function overdueCount(env: BaseEnv, today: string, owner?: string): Promise<number> {
+  const q = (owner ?? '').trim().toLowerCase()
+  const row = await env.DB.prepare(`SELECT COUNT(*) AS n FROM "actions" a WHERE ${OVERDUE}` + (q ? " AND instr(lower(coalesce(a.owner_name, '')), ?) > 0" : ''))
+    .bind(...(q ? [today, q] : [today]))
+    .first<{ n: number }>()
+  return row?.n ?? 0
+}
+
+/** Sayılar sunucuda hesaplanır: durum, açık kayıtların önem ve kaynak dağılımı. */
+export async function counts(env: BaseEnv) {
+  const [byStatus, bySeverity, bySource] = await Promise.all([
+    env.DB.prepare('SELECT status AS key, COUNT(*) AS n FROM "nonconformities" WHERE deleted_at IS NULL GROUP BY status').all<{ key: string; n: number }>(),
+    env.DB.prepare("SELECT severity AS key, COUNT(*) AS n FROM \"nonconformities\" WHERE deleted_at IS NULL AND status <> 'closed' GROUP BY severity").all<{ key: string; n: number }>(),
+    env.DB.prepare("SELECT source AS key, COUNT(*) AS n FROM \"nonconformities\" WHERE deleted_at IS NULL AND status <> 'closed' GROUP BY source").all<{ key: string; n: number }>(),
+  ])
+  const map = (rows: { key: string; n: number }[]) => Object.fromEntries(rows.map((r) => [r.key, r.n]))
+  return { byStatus: map(byStatus.results), openBySeverity: map(bySeverity.results), openBySource: map(bySource.results) }
+}
+
+export async function lastReminderRun(env: BaseEnv) {
+  return env.DB.prepare(
+    'SELECT run_key, reminded_owners, reminded_actions, failed, deferred_owners AS deferred, consent_needed FROM "reminder_runs" WHERE deleted_at IS NULL ORDER BY run_key DESC LIMIT 1',
+  ).first<{ run_key: string; reminded_owners: number; reminded_actions: number; failed: number; deferred: number; consent_needed: number }>()
+}