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

package/templates/saha-denetimi/files/src/queries.ts.tpl

@@ -0,0 +1,143 @@
+// Veritabanı okumaları — pano, rapor ve Devoplus yapay zekâsı araçları aynı sorguları kullanır. Yalnız TAMAMLANMIŞ
+// denetimler sayılır (taslağın puanı yoktur).
+import type { BaseEnv } from './lib/server.ts'
+
+const DONE = "status = 'completed' AND deleted_at IS NULL"
+
+export interface AuditRow {
+  id: string
+  created_by: string
+  checklist_id: string
+  checklist_name: string | null
+  location_id: string | null
+  location_code: string | null
+  location_name: string
+  auditor_name: string | null
+  status: 'draft' | 'completed'
+  submitted_at: string | null
+  score: number | null
+  result: string | null
+  critical_failed: number
+  compliant_count: number
+  noncompliant_count: number
+  not_applicable_count: number
+  general_note: string | null
+  created_at: string
+  updated_at: string
+}
+
+export interface AnswerRow {
+  id: string
+  item_id: string
+  position: number
+  section: string | null
+  title: string
+  weight: number
+  critical: number
+  result: 'compliant' | 'noncompliant' | 'not_applicable' | null
+  note: string | null
+  photo: string | null
+  photo_name: string | null
+}
+
+const AUDIT_COLUMNS =
+  'id, created_by, checklist_id, checklist_name, location_id, location_code, location_name, auditor_name, status, submitted_at, score, result, ' +
+  'critical_failed, compliant_count, noncompliant_count, not_applicable_count, general_note, created_at, updated_at'
+
+export async function findAudit(env: BaseEnv, id: string): Promise<AuditRow | null> {
+  return env.DB.prepare(`SELECT ${AUDIT_COLUMNS} FROM "audits" WHERE id = ? AND deleted_at IS NULL`).bind(id).first<AuditRow>()
+}
+
+export async function answersOf(env: BaseEnv, auditId: string): Promise<AnswerRow[]> {
+  const rows = await env.DB.prepare(
+    'SELECT id, item_id, position, section, title, weight, critical, result, note, photo, photo_name FROM "audit_answers" WHERE audit_id = ? AND deleted_at IS NULL ORDER BY position, created_at',
+  )
+    .bind(auditId)
+    .all<AnswerRow>()
+  return rows.results
+}
+
+const round1 = (n: number | null): number | null => (n === null ? null : Math.round(n * 10) / 10)
+
+/** Son tamamlanmış denetimler (yer adında geçen ifadeyle süzülebilir; büyük/küçük harf yalnız Latin harflerde yok sayılır). */
+export async function recentAudits(env: BaseEnv, limit: number, location?: string) {
+  const q = (location ?? '').trim().toLowerCase()
+  const rows = await env.DB.prepare(
+    `SELECT id, location_name, checklist_name, auditor_name, submitted_at, score, result, critical_failed FROM "audits" WHERE ${DONE}` +
+      (q ? ' AND instr(lower(location_name), ?) > 0' : '') +
+      ' ORDER BY submitted_at DESC LIMIT ?',
+  )
+    .bind(...(q ? [q, limit] : [limit]))
+    .all<{ id: string; location_name: string; checklist_name: string | null; auditor_name: string | null; submitted_at: string; score: number; result: string; critical_failed: number }>()
+  return rows.results.map((r) => ({ ...r, critical_failed: r.critical_failed === 1 }))
+}
+
+/** Uygun bulunmayan maddelerin başlıkları (denetim başına en çok `limit`). */
+export async function failedItems(env: BaseEnv, auditIds: readonly string[], limit = 10): Promise<Map<string, string[]>> {
+  const out = new Map<string, string[]>()
+  if (auditIds.length === 0) return out
+  const rows = await env.DB.prepare(
+    `SELECT audit_id, title, critical FROM "audit_answers" WHERE result = 'noncompliant' AND deleted_at IS NULL AND audit_id IN (${auditIds.map(() => '?').join(', ')}) ORDER BY critical DESC, position`,
+  )
+    .bind(...auditIds)
+    .all<{ audit_id: string; title: string; critical: number }>()
+  for (const r of rows.results) {
+    const list = out.get(r.audit_id) ?? []
+    if (list.length < limit) list.push(r.critical === 1 ? `${r.title} (kritik)` : r.title)
+    out.set(r.audit_id, list)
+  }
+  return out
+}
+
+/**
+ * Yer başına: tamamlanmış denetim sayısı, son puan, ortalama puan, son tarih (sayılar sunucuda hesaplanır). Gruplama
+ * yerin KİMLİĞİYLE yapılır (org şemasındaki iş yeri `location_id`); aynı adı taşıyan iki iş yeri ("Merkez") ayrı satırdır.
+ * Elle yazılan yerlerin kimliği olmadığı için onlar adlarıyla ayrı bir anahtar uzayında gruplanır. Etiket son denetimdeki
+ * addır; mağaza kodu varsa yanına eklenir ki aynı adlı satırlar ayırt edilebilsin.
+ */
+export async function locationScores(env: BaseEnv, limit = 50) {
+  const rows = await env.DB.prepare(
+    `WITH done AS (SELECT a.*, COALESCE('id:' || a.location_id, 'name:' || a.location_name) AS loc_key FROM "audits" a WHERE a.status = 'completed' AND a.deleted_at IS NULL) ` +
+      `SELECT d.loc_key, COUNT(*) AS audits, AVG(d.score) AS average, MAX(d.submitted_at) AS last_at, SUM(d.critical_failed) AS critical_failures, ` +
+      `(SELECT b.score FROM done b WHERE b.loc_key = d.loc_key ORDER BY b.submitted_at DESC LIMIT 1) AS last_score, ` +
+      `(SELECT b.location_name FROM done b WHERE b.loc_key = d.loc_key ORDER BY b.submitted_at DESC LIMIT 1) AS location_name, ` +
+      `(SELECT b.location_code FROM done b WHERE b.loc_key = d.loc_key ORDER BY b.submitted_at DESC LIMIT 1) AS location_code ` +
+      `FROM done d GROUP BY d.loc_key ORDER BY last_at DESC LIMIT ?`,
+  )
+    .bind(limit)
+    .all<{
+      loc_key: string
+      location_name: string
+      location_code: string | null
+      audits: number
+      average: number | null
+      last_at: string
+      last_score: number | null
+      critical_failures: number
+    }>()
+  return rows.results.map(({ loc_key, location_name, location_code, ...r }) => ({
+    ...r,
+    key: loc_key,
+    location: location_code ? `${location_name} (${location_code})` : location_name,
+    average: round1(r.average),
+    critical_failures: Number(r.critical_failures ?? 0),
+  }))
+}
+
+/** Pano özeti: son 30 gün. */
+export async function summary(env: BaseEnv, since: string) {
+  const row = await env.DB.prepare(
+    `SELECT COUNT(*) AS audits, AVG(score) AS average, SUM(CASE WHEN result = 'failed' THEN 1 ELSE 0 END) AS failed, SUM(critical_failed) AS critical ` +
+      `FROM "audits" WHERE ${DONE} AND submitted_at >= ?`,
+  )
+    .bind(since)
+    .first<{ audits: number; average: number | null; failed: number | null; critical: number | null }>()
+  const drafts = await env.DB.prepare(`SELECT COUNT(*) AS n FROM "audits" WHERE status = 'draft' AND deleted_at IS NULL`).first<{ n: number }>()
+  return {
+    audits: row?.audits ?? 0,
+    average: round1(row?.average ?? null),
+    failed: Number(row?.failed ?? 0),
+    criticalFailures: Number(row?.critical ?? 0),
+    drafts: drafts?.n ?? 0,
+  }
+}

package/templates/saha-denetimi/files/src/score.test.ts.tpl

@@ -0,0 +1,48 @@
+import { describe, expect, it } from 'vitest'
+import { CRITICAL_CAP, computeScore, isAnswerResult, isValidWeight, resultFor, submitProblems, type ScoredItem } from './score.ts'
+
+const item = (result: ScoredItem['result'], weight = 1, critical = false): ScoredItem => ({ weight, critical, result })
+
+describe('denetim puanı', () => {
+  it('ağırlıklı: uygun ağırlık / değerlendirilen ağırlık; "uygulanamaz" hesaba girmez', () => {
+    const s = computeScore([item('compliant', 3), item('noncompliant', 1), item('not_applicable', 5)])
+    expect(s).toEqual({ score: 75, result: 'needs_improvement', criticalFailed: false, compliant: 1, noncompliant: 1, notApplicable: 1 })
+    expect(computeScore([item('compliant', 2), item('compliant', 1), item('noncompliant', 1)]).score).toBe(75)
+    expect(computeScore([item('compliant', 1), item('noncompliant', 2)]).score).toBe(33.3)
+  })
+
+  it('kritik madde uygun değilse sonuç başarısız ve puan tavanda', () => {
+    const s = computeScore([item('compliant', 10), item('compliant', 10), item('noncompliant', 1, true)])
+    expect(s.criticalFailed).toBe(true)
+    expect(s.score).toBe(CRITICAL_CAP)
+    expect(s.result).toBe('failed')
+    // Tavanın altındaki puan olduğu gibi kalır.
+    expect(computeScore([item('noncompliant', 5, true), item('compliant', 1)]).score).toBe(16.7)
+  })
+
+  it('bantlar', () => {
+    expect(resultFor(85, false)).toBe('passed')
+    expect(resultFor(84.9, false)).toBe('needs_improvement')
+    expect(resultFor(60, false)).toBe('needs_improvement')
+    expect(resultFor(59.9, false)).toBe('failed')
+    expect(resultFor(100, true)).toBe('failed')
+  })
+
+  it('tamamlama eksikleri: cevapsız, notsuz "uygun değil", hiç değerlendirilmemiş', () => {
+    expect(submitProblems([item(null), { ...item('noncompliant'), note: ' ' }])).toHaveLength(2)
+    expect(submitProblems([{ ...item('noncompliant'), note: 'Raf etiketi yok' }])).toEqual([])
+    expect(submitProblems([item('not_applicable'), item('not_applicable')])).toHaveLength(1)
+    expect(submitProblems([])).toHaveLength(1)
+    expect(() => computeScore([item(null)])).toThrow()
+    expect(() => computeScore([item('not_applicable')])).toThrow()
+  })
+
+  it('cevap ve ağırlık doğrulama', () => {
+    expect(isAnswerResult('compliant')).toBe(true)
+    expect(isAnswerResult('ok')).toBe(false)
+    expect(isValidWeight(3)).toBe(true)
+    expect(isValidWeight(0)).toBe(false)
+    expect(isValidWeight(2.5)).toBe(false)
+    expect(isValidWeight(11)).toBe(false)
+  })
+})

package/templates/saha-denetimi/files/src/score.ts.tpl

@@ -0,0 +1,102 @@
+// Denetim kuralları — SAF fonksiyonlar (veritabanı ve ağ yok; `score.test.ts` sınar). Puan YALNIZ burada, sunucuda
+// hesaplanır; istemcinin gönderdiği puan kabul edilmez. Kuralı değiştiren bu dosyayı ve testini birlikte değiştirir.
+//
+//   puan = uygun maddelerin ağırlığı / değerlendirilen maddelerin ağırlığı × 100 (bir ondalık)
+//   "uygulanamaz" maddeler hesaba GİRMEZ (ne paya ne paydaya)
+//   kritik bir madde "uygun değil" ise sonuç her zaman BAŞARISIZ'dır ve puan CRITICAL_CAP'i aşamaz
+//   sonuç: puan ≥ PASS_MIN → başarılı · ≥ IMPROVE_MIN → geliştirilmeli · altı → başarısız
+//
+// ⚠️ İş kuralıdır — eşikleri ve kritik madde davranışını keşif görüşmesinde kullanıcıyla netleştirin.
+export const ANSWER_RESULTS = ['compliant', 'noncompliant', 'not_applicable'] as const
+export type AnswerResult = (typeof ANSWER_RESULTS)[number]
+export type AuditResult = 'passed' | 'needs_improvement' | 'failed'
+
+/** Başarılı sayılmanın alt sınırı (dahil). */
+export const PASS_MIN = 85
+/** "Geliştirilmeli" sayılmanın alt sınırı (dahil); altı başarısızdır. */
+export const IMPROVE_MIN = 60
+/** Kritik madde uygun değilse puanın çıkabileceği en yüksek değer (başarısız bandının içinde kalır). */
+export const CRITICAL_CAP = IMPROVE_MIN - 1
+/** Madde ağırlığı: tam sayı, 1-10. */
+export const WEIGHT_MIN = 1
+export const WEIGHT_MAX = 10
+/** Bir kontrol listesindeki en çok madde (form ve rapor bu kadarıyla sınanmıştır). */
+export const CHECKLIST_ITEMS_MAX = 60
+/** Madde notunun en çok uzunluğu. */
+export const NOTE_MAX = 500
+
+export interface ScoredItem {
+  weight: number
+  critical: boolean
+  result: AnswerResult | null
+}
+
+export interface AuditScore {
+  /** 0-100, bir ondalık. */
+  score: number
+  result: AuditResult
+  criticalFailed: boolean
+  compliant: number
+  noncompliant: number
+  notApplicable: number
+}
+
+export function isAnswerResult(value: unknown): value is AnswerResult {
+  return typeof value === 'string' && (ANSWER_RESULTS as readonly string[]).includes(value)
+}
+
+/** Ağırlık doğrulama (madde tanımında): tam sayı, WEIGHT_MIN-WEIGHT_MAX. */
+export function isValidWeight(value: unknown): value is number {
+  return typeof value === 'number' && Number.isInteger(value) && value >= WEIGHT_MIN && value <= WEIGHT_MAX
+}
+
+/** Puan bandı → sonuç. */
+export function resultFor(score: number, criticalFailed: boolean): AuditResult {
+  if (criticalFailed || score < IMPROVE_MIN) return 'failed'
+  return score >= PASS_MIN ? 'passed' : 'needs_improvement'
+}
+
+/**
+ * Tamamlamadan önceki eksikler (madde sırası 1'den başlar): cevaplanmamış madde, notsuz "uygun değil" ve hiç
+ * değerlendirilmemiş (hepsi "uygulanamaz") denetim. Boş liste = tamamlanabilir.
+ */
+export function submitProblems(items: readonly (ScoredItem & { note?: string | null })[]): string[] {
+  const problems: string[] = []
+  items.forEach((item, i) => {
+    if (item.result === null) problems.push(`${i + 1}. madde cevaplanmadı.`)
+    else if (item.result === 'noncompliant' && !(item.note ?? '').trim()) problems.push(`${i + 1}. madde "uygun değil": ne gördüğünüzü nota yazın.`)
+  })
+  if (items.length === 0) problems.push('Denetimde madde yok.')
+  else if (problems.length === 0 && items.every((item) => item.result === 'not_applicable'))
+    problems.push('En az bir madde "uygun" ya da "uygun değil" olarak değerlendirilmeli.')
+  return problems
+}
+
+/** Ağırlıklı puan. Önce `submitProblems` boş olmalıdır; değilse (cevapsız ya da hiç değerlendirilmemiş) fırlatır. */
+export function computeScore(items: readonly ScoredItem[]): AuditScore {
+  let earned = 0
+  let possible = 0
+  let compliant = 0
+  let noncompliant = 0
+  let notApplicable = 0
+  let criticalFailed = false
+  for (const item of items) {
+    if (item.result === null) throw new Error('cevaplanmamış madde var')
+    if (item.result === 'not_applicable') {
+      notApplicable++
+      continue
+    }
+    possible += item.weight
+    if (item.result === 'compliant') {
+      compliant++
+      earned += item.weight
+    } else {
+      noncompliant++
+      if (item.critical) criticalFailed = true
+    }
+  }
+  if (possible === 0) throw new Error('değerlendirilen madde yok')
+  let score = Math.round((earned / possible) * 1000) / 10
+  if (criticalFailed) score = Math.min(score, CRITICAL_CAP)
+  return { score, result: resultFor(score, criticalFailed), criticalFailed, compliant, noncompliant, notApplicable }
+}