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

package/templates/envanter/files/src/app.ts.tpl

@@ -0,0 +1,204 @@
+// {{nameTr}} — envanter (stok takibi). Uçlar (hepsi oturum ister; kimlik platformdan gelir):
+//   GET    /api/items[?…]                       stok kalemleri (herkes) — hazır liste + Excel
+//   POST   /api/items · PATCH/DELETE /api/items/{id}   kalem tanımı (stok sorumlusu); MİKTAR bu uçlardan YAZILMAZ
+//   POST   /api/items/{id}/movements            { kind: in|out|count, quantity, note? } (stok sorumlusu) — stok eksiye düşmez
+//   GET    /api/movements[?…]                   stok hareketleri (herkes) — hazır liste + Excel; değiştirilemez
+//   GET    /api/summary                         azalan kalemler, konuma göre dağılım, son günlük kontrol
+// Miktar YALNIZ hareketle değişir; hareket kaydı ve miktar değişikliği tek toplu yazımdır (ikisi birlikte ya da
+// hiçbiri). Azalma e-postası, miktarı eşiğin altına düşüren harekette kalemin sorumlusuna BİR KEZ gider (miktar yeniden
+// eşiğe çıkınca yeniden kurulur).
+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 } from './lib/http.ts'
+import { sendMailSafely } from './lib/mail.ts'
+import { createApp, json, type AppDefinition, type BaseEnv, type RouteInput } from './lib/server.ts'
+import { byLocation, lastCheck, lowStock } from './queries.ts'
+import { renderShell, renderShellScript } from './shell.ts'
+import { checkMovement, isLow } from './stock.ts'
+
+export type Env = BaseEnv
+
+export const APP_NAME = { tr: {{nameTrJs}}, en: {{nameEnJs}} }
+/** Stok sorumlusu izni (manifest `permissions`): kalem tanımlar, hareket girer. */
+export const MANAGE_PERMISSION = '{{permissionPrefix}}Manage'
+
+export const items = createCrudHandler({ model: dataModel, entity: 'items', records: 'shared', canWrite: MANAGE_PERMISSION })
+export const movements = createCrudHandler({ model: dataModel, entity: 'movements', records: 'shared' })
+
+const ITEM_FIELDS = ['sku', 'name', 'category', 'unit', 'location', 'min_quantity', 'active', 'responsible']
+const NOTE_MAX = 200
+const CONTROL_RE = /[\u0000-\u001f\u007f]/
+const UNIT_LABELS: Record<string, string> = { piece: 'adet', box: 'kutu', kg: 'kg', litre: 'litre', metre: 'metre' }
+
+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
+  }
+}
+
+/** Kalem gövdesi: kişi seçicinin değeri iki kolona ayrılır; miktar ve bildirim damgası istemciden ALINMAZ. */
+function itemRecord(body: Record<string, unknown>): Record<string, unknown> {
+  const { responsible, ...rest } = body
+  if (!('responsible' in body)) return rest
+  const person = personValue(responsible, 'responsible')
+  return { ...rest, responsible_org_id: person?.id ?? null, responsible_name: person?.name ?? null }
+}
+
+async function rearm(env: Env, id: string): Promise<void> {
+  await env.DB.prepare('UPDATE "items" SET low_notified_at = NULL WHERE id = ? AND low_notified_at IS NOT NULL AND (min_quantity = 0 OR quantity >= min_quantity)')
+    .bind(id)
+    .run()
+}
+
+async function itemWrite(input: RouteInput<Env>, id: string | null): Promise<Response> {
+  const { request, env, ctx, method } = input
+  requirePermission(ctx, MANAGE_PERMISSION)
+  if (id && method === 'DELETE') return (await items.handle(request, env.DB, ctx))!
+  const record = itemRecord(onlyFields(await readJsonObject(request), ITEM_FIELDS))
+  const res = (await items.handle(forward(request, id ? `${items.path}/${id}` : items.path, id ? 'PATCH' : 'POST', record), env.DB, ctx))!
+  if (id && res.ok) await rearm(env, id) // eşik değiştiyse azalma bildirimi yeniden kurulur
+  return res
+}
+
+async function notifyLow(input: RouteInput<Env>, item: { id: string; name: string; quantity: number; min_quantity: number; unit: string; responsible_org_id: string | null }) {
+  const { env, ctx } = input
+  const stamp = nowIso()
+  // ⛔ "Bir kez" kuralı koşullu güncellemededir: iki eşzamanlı çıkıştan yalnız biri damgayı koyar ve e-postayı gönderir.
+  const mark = await env.DB.prepare(
+    'UPDATE "items" SET low_notified_at = ? WHERE id = ? AND low_notified_at IS NULL AND min_quantity > 0 AND quantity < min_quantity',
+  )
+    .bind(stamp, item.id)
+    .run()
+  if (Number(mark.meta.changes ?? 0) !== 1 || !item.responsible_org_id) return 'skipped'
+  const unit = UNIT_LABELS[item.unit] ?? item.unit
+  const outcome = await sendMailSafely(
+    ctx,
+    input.api(),
+    systemNotice({
+      appName: APP_NAME.tr,
+      title: `Stok azaldı: ${item.name}`,
+      message: `Eldeki miktar ${item.quantity} ${unit}; en az miktar ${item.min_quantity} ${unit}. Uygulamanın Stok sekmesinden ayrıntıyı görebilirsiniz.`,
+    }),
+    { toOrgUserIds: [item.responsible_org_id] },
+  )
+  // Gönderilemediyse damga geri alınır: bir sonraki hareket (belki e-posta izni olan bir kullanıcının) yeniden dener.
+  if (outcome !== 'sent') await env.DB.prepare('UPDATE "items" SET low_notified_at = NULL WHERE id = ? AND low_notified_at = ?').bind(item.id, stamp).run()
+  return outcome
+}
+
+async function move(input: RouteInput<Env>, id: string): Promise<Response> {
+  const { request, env, ctx } = input
+  const user = requireUser(ctx)
+  requirePermission(ctx, MANAGE_PERMISSION)
+  const body = onlyFields(await readJsonObject(request), ['kind', 'quantity', 'note'])
+  const item = await env.DB.prepare('SELECT id, name, unit, active FROM "items" WHERE id = ? AND deleted_at IS NULL').bind(id).first<{ id: string; name: string; unit: string; active: number }>()
+  if (!item) throw new OneError(404, 'APP-E-404', 'Stok kalemi bulunamadı.')
+  if (item.active !== 1) throw new OneError(409, 'APP-E-021', 'Kullanımda olmayan kaleme hareket girilmez.')
+  const check = checkMovement(body.kind, body.quantity, item.unit)
+  if (!check.ok) throw fieldError(check.field, check.message)
+  const note = typeof body.note === 'string' ? body.note.trim() : ''
+  if ([...note].length > NOTE_MAX || CONTROL_RE.test(note)) throw fieldError('note', `Açıklama en çok ${NOTE_MAX} karakterlik tek satır olmalı.`)
+  const now = nowIso()
+  const movementId = crypto.randomUUID()
+  const actor = await myName(input)
+  // ⛔ Hareket kaydı ve miktar değişikliği TEK toplu yazımdır (batch = tek işlem): ikisi birlikte yazılır ya da hiçbiri.
+  //   1. Hareket yalnız kalem kullanımdaysa (çıkışta: eldeki miktar yetiyorsa) eklenir — koşul aynı ifadede.
+  //   2. Miktar yalnız BU hareket eklendiyse değişir (`EXISTS … movementId`).
+  // Toplu yazım veritabanında sırayla ve başka bir yazımla iç içe geçmeden yürür: eşzamanlı iki çıkışta ikincisi
+  // birincinin düşürdüğü miktarı görür; stok eksiye düşmez. Yazımlardan biri düşerse ikisi de geri alınır.
+  //   Miktar kuralı okunan birime göre denetlendi (ör. adet tam sayıdır): birim bu arada değiştiyse hareket eklenmez.
+  //   Kalemin adı hareketin kendi ifadesinde kalemden okunur (bayat ad kopyalanmaz).
+  const stockGuard = check.kind === 'out' ? ' AND i.quantity >= ?' : ''
+  const insert = env.DB.prepare(
+    'INSERT INTO "movements" (id, created_at, created_by, updated_at, updated_by, item_id, item_name, kind, quantity, note, actor_name) ' +
+      `SELECT ?, ?, ?, ?, ?, i.id, i.name, ?, ?, ?, ? FROM "items" i WHERE i.id = ? AND i.active = 1 AND i.deleted_at IS NULL AND i.unit = ?${stockGuard}`,
+  ).bind(
+    movementId,
+    now,
+    user.sub,
+    now,
+    user.sub,
+    check.kind,
+    check.quantity,
+    note || null,
+    actor,
+    id,
+    item.unit,
+    ...(check.kind === 'out' ? [check.quantity] : []),
+  )
+  const quantity = check.kind === 'in' ? 'quantity + ?' : check.kind === 'out' ? 'quantity - ?' : '?'
+  const update = env.DB.prepare(
+    `UPDATE "items" SET quantity = ${quantity}, updated_at = ?, updated_by = ? WHERE id = ? AND EXISTS (SELECT 1 FROM "movements" WHERE id = ?)`,
+  ).bind(check.quantity, now, user.sub, id, movementId)
+  const [inserted, changed] = await env.DB.batch([insert, update])
+  if (Number(inserted?.meta.changes ?? 0) !== 1 || Number(changed?.meta.changes ?? 0) !== 1) {
+    const current = await env.DB.prepare('SELECT quantity, unit, active FROM "items" WHERE id = ? AND deleted_at IS NULL').bind(id).first<{ quantity: number; unit: string; active: number }>()
+    if (!current) throw new OneError(404, 'APP-E-404', 'Stok kalemi bulunamadı.')
+    if (current.active !== 1) throw new OneError(409, 'APP-E-021', 'Kullanımda olmayan kaleme hareket girilmez.')
+    if (check.kind === 'out' && current.unit === item.unit && current.quantity < check.quantity)
+      throw fieldError('quantity', `Stokta yeterli miktar yok (eldeki: ${current.quantity}).`, 409)
+    throw new OneError(409, 'APP-E-021', 'Kalem bu arada değişti; sayfayı yenileyip yeniden deneyin.')
+  }
+  logAudit(ctx, `stock.${check.kind}`, id, { quantity: check.quantity })
+  const after = await env.DB.prepare('SELECT id, name, unit, quantity, min_quantity, responsible_org_id FROM "items" WHERE id = ?')
+    .bind(id)
+    .first<{ id: string; name: string; unit: string; quantity: number; min_quantity: number; responsible_org_id: string | null }>()
+  let notification = 'skipped'
+  if (after && isLow(after.quantity, after.min_quantity)) notification = await notifyLow(input, after)
+  else await rearm(env, id)
+  return json({ id: movementId, item: { id, quantity: after?.quantity ?? null, low: after ? isLow(after.quantity, after.min_quantity) : false }, notification }, 201)
+}
+
+async function summary({ env, ctx }: RouteInput<Env>): Promise<Response> {
+  requireUser(ctx)
+  const [low, locations, check] = await Promise.all([lowStock(env, 20), byLocation(env), lastCheck(env)])
+  return json({ low, byLocation: locations, lastCheck: check })
+}
+
+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)
+  const moveId = matchId(path, items.path, 'movements')
+  if (moveId && method === 'POST') return move(input, moveId)
+  if (path === items.path && method === 'POST') return itemWrite(input, null)
+  const itemId = matchId(path, items.path)
+  if (itemId && (method === 'PATCH' || method === 'PUT' || method === 'DELETE')) {
+    if (method === 'PUT') throw new OneError(405, 'APP-E-405', 'Kalem PATCH ile güncellenir.')
+    return itemWrite(input, itemId)
+  }
+  if (path === items.path || path.startsWith(`${items.path}/`)) return items.handle(input.request, env.DB, ctx)
+  if (path === movements.path || path.startsWith(`${movements.path}/`)) {
+    if (method !== 'GET' && method !== 'HEAD') throw new OneError(405, 'APP-E-405', 'Stok hareketi değiştirilemez; düzeltme için yeni bir hareket (ya da sayım) girin.')
+    return movements.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/envanter/files/src/jobs.ts.tpl

@@ -0,0 +1,30 @@
+// Zamanlanmış görevler (manifest `jobs`). Zamanlanmış iş KULLANICISIZDIR: Devoplus servislerini (e-posta, organizasyon
+// şeması) kullanmaz, yalnız uygulamanın kendi veritabanı. Bu yüzden günlük kontrol e-posta GÖNDERMEZ; sonucu kayda
+// yazar, uygulama ve Devoplus yapay zekâsı oradan okur. Azalma e-postası, miktarı eşiğin altına düşüren hareketle
+// (kullanıcının işlemi) gider — `app.ts`.
+// Aynı iş birden çok kez gelebilir: kayıt gün anahtarıyla TEKİLDİR, tekrar yeni kayıt açmaz.
+import { defineJobs } from '@devoplus/one-sdk'
+import type { Env } from './app.ts'
+import { lowStock } from './queries.ts'
+import { checkDayKey } from './stock.ts'
+
+/** Sistemin yazdığı kayıtlarda `created_by` değeri (kişi kimliği değildir). */
+export const SYSTEM_ACTOR = 'system:daily-stock-check'
+/** Kontrol kaydına yazılan en çok kalem (sayı her zaman tamdır). */
+export const CHECK_ITEMS_MAX = 100
+
+export const jobs = defineJobs<Env>({
+  schedules: {
+    // Her sabah 07:00 (İstanbul): en az miktarın altındaki kalemler o günün kontrol kaydına yazılır.
+    'daily-stock-check': async (job, env) => {
+      const at = job.scheduledTime ? new Date(job.scheduledTime) : new Date()
+      const now = at.toISOString()
+      const low = await lowStock(env, CHECK_ITEMS_MAX)
+      await env.DB.prepare(
+        'INSERT OR IGNORE INTO "stock_checks" (id, created_at, created_by, updated_at, updated_by, run_key, low_count, low_items) VALUES (?, ?, ?, ?, ?, ?, ?, ?)',
+      )
+        .bind(crypto.randomUUID(), now, SYSTEM_ACTOR, now, SYSTEM_ACTOR, checkDayKey(at), low.count, JSON.stringify(low.items))
+        .run()
+    },
+  },
+})

package/templates/envanter/files/src/queries.ts.tpl

@@ -0,0 +1,53 @@
+// Veritabanı okumaları — ekran, zamanlanmış iş ve Devoplus yapay zekâsı araçları aynı sorguları kullanır.
+import type { BaseEnv } from './lib/server.ts'
+
+const LOW = 'active = 1 AND deleted_at IS NULL AND min_quantity > 0 AND quantity < min_quantity'
+
+export interface LowItem {
+  sku: string
+  name: string
+  quantity: number
+  min_quantity: number
+  unit: string
+  location: string | null
+}
+
+/** Şu an en az miktarın altındaki kalemler (en çok `limit`) ve toplam sayıları. */
+export async function lowStock(env: BaseEnv, limit = 50): Promise<{ count: number; items: LowItem[] }> {
+  const [count, rows] = await Promise.all([
+    env.DB.prepare(`SELECT COUNT(*) AS n FROM "items" WHERE ${LOW}`).first<{ n: number }>(),
+    env.DB.prepare(`SELECT sku, name, quantity, min_quantity, unit, location FROM "items" WHERE ${LOW} ORDER BY (quantity * 1.0 / min_quantity), name LIMIT ?`)
+      .bind(limit)
+      .all<LowItem>(),
+  ])
+  return { count: count?.n ?? 0, items: rows.results }
+}
+
+/** Kalem arama: stok kodu, ad ya da konum içinde geçen (büyük/küçük harf yalnız Latin harflerde yok sayılır). */
+export async function searchItems(env: BaseEnv, query: string, limit: number) {
+  const q = query.trim().toLowerCase()
+  const rows = await env.DB.prepare(
+    'SELECT sku, name, quantity, min_quantity, unit, location FROM "items" WHERE active = 1 AND deleted_at IS NULL ' +
+      'AND (instr(lower(sku), ?) > 0 OR instr(lower(name), ?) > 0 OR instr(lower(coalesce(location, \'\')), ?) > 0) ORDER BY name LIMIT ?',
+  )
+    .bind(q, q, q, limit)
+    .all<LowItem>()
+  return rows.results.map((r) => ({ ...r, low: r.min_quantity > 0 && r.quantity < r.min_quantity }))
+}
+
+/** Konuma göre kalem sayısı ve eşiğin altındakiler (grafik için; sayılar sunucuda hesaplanır). */
+export async function byLocation(env: BaseEnv) {
+  const rows = await env.DB.prepare(
+    `SELECT coalesce(location, '') AS location, COUNT(*) AS total, SUM(CASE WHEN min_quantity > 0 AND quantity < min_quantity THEN 1 ELSE 0 END) AS low ` +
+      'FROM "items" WHERE active = 1 AND deleted_at IS NULL GROUP BY coalesce(location, \'\') ORDER BY total DESC LIMIT 12',
+  ).all<{ location: string; total: number; low: number }>()
+  return rows.results
+}
+
+export async function lastCheck(env: BaseEnv) {
+  return env.DB.prepare('SELECT run_key, created_at, low_count FROM "stock_checks" WHERE deleted_at IS NULL ORDER BY run_key DESC LIMIT 1').first<{
+    run_key: string
+    created_at: string
+    low_count: number
+  }>()
+}

package/templates/envanter/files/src/shell.ts.tpl

@@ -0,0 +1,265 @@
+// {{nameTr}} — sayfa (üç görünüm: Stok · Hareketler · Kalemler). Liste, süzgeç, form, kişi seçici ve grafik hazır
+// bileşenlerdir; seçenekler veri modelinden gelir. Azalan kalem sayısı ve grafik verisi sunucuda hesaplanır.
+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.',
+    stockIntro: 'Kalemlerin eldeki miktarları. Stok kodu, ad ya da konumla arayabilirsiniz.',
+    lowSome: '{n} kalem en az miktarın altında.',
+    lowNone: 'Bütün kalemler en az miktarın üzerinde.',
+    lastCheck: 'Son günlük kontrol: {day} — {n} kalem eşiğin altındaydı.',
+    noCheck: 'Henüz günlük kontrol yapılmadı.',
+    low: 'Azaldı',
+    search: 'Ara',
+    stockTable: 'Stok',
+    chartTitle: 'Konuma göre kalemler',
+    seriesTotal: 'Kalem',
+    seriesLow: 'Eşiğin altında',
+    noLocation: '(konumsuz)',
+    managersOnly: 'Bu işlem yalnız stok sorumlularına açıktır.',
+    movementsIntro: 'Giriş ve çıkışlar miktarı değiştirir; sayım eldeki miktarı sayılan değere eşitler. Stok eksiye düşmez.',
+    movementForm: 'Yeni hareket',
+    moved: 'Hareket kaydedildi.',
+    lowWarn: 'Kalem en az miktarın altına düştü.',
+    consentNeeded: 'Hareket kaydedildi ama sorumluya e-posta gönderilemedi: portaldaki "İzinleri incele" düğmesiyle e-posta izni verin.',
+    movementsTable: 'Stok hareketleri',
+    itemsIntro: 'Stok kalemlerinin tanımı. Miktar buradan değişmez; Hareketler sekmesinden girilir.',
+    itemsTable: 'Kalemler',
+    itemForm: 'Kalem bilgileri',
+    newItem: 'Yeni kalem',
+    itemSaved: 'Kalem kaydedildi.',
+    responsible: 'Sorumlu (azalma e-postası alır)',
+  },
+  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.',
+    stockIntro: 'Quantities on hand. You can search by SKU, name or location.',
+    lowSome: '{n} items are below the minimum quantity.',
+    lowNone: 'All items are above the minimum quantity.',
+    lastCheck: 'Latest daily check: {day} — {n} items were below the minimum.',
+    noCheck: 'No daily check has run yet.',
+    low: 'Low',
+    search: 'Search',
+    stockTable: 'Stock',
+    chartTitle: 'Items by location',
+    seriesTotal: 'Items',
+    seriesLow: 'Below minimum',
+    noLocation: '(no location)',
+    managersOnly: 'Only stock managers can do this.',
+    movementsIntro: 'In and out movements change the quantity; a count sets the quantity on hand to the counted value. Stock never goes below zero.',
+    movementForm: 'New movement',
+    moved: 'Movement saved.',
+    lowWarn: 'The item fell below the minimum quantity.',
+    consentNeeded: 'Movement saved, but no e-mail was sent to the responsible person: allow e-mail with the "Review permissions" button in the Portal.',
+    movementsTable: 'Stock movements',
+    itemsIntro: 'Stock item definitions. The quantity does not change here; enter it on the Movements tab.',
+    itemsTable: 'Items',
+    itemForm: 'Item details',
+    newItem: 'New item',
+    itemSaved: 'Item saved.',
+    responsible: 'Responsible (gets the low stock e-mail)',
+  },
+}
+
+const MODEL = {
+  manage: '{{permissionPrefix}}Manage',
+  unit: choices(dataModel, 'items', 'unit'),
+  kind: choices(dataModel, 'movements', 'kind'),
+  labels: {
+    sku: label(dataModel, 'items', 'sku'),
+    name: label(dataModel, 'items', 'name'),
+    category: label(dataModel, 'items', 'category'),
+    unit: label(dataModel, 'items', 'unit'),
+    location: label(dataModel, 'items', 'location'),
+    quantity: label(dataModel, 'items', 'quantity'),
+    min: label(dataModel, 'items', 'min_quantity'),
+    responsibleName: label(dataModel, 'items', 'responsible_name'),
+    active: label(dataModel, 'items', 'active'),
+    item: label(dataModel, 'movements', 'item_id'),
+    itemName: label(dataModel, 'movements', 'item_name'),
+    kind: label(dataModel, 'movements', 'kind'),
+    moveQuantity: label(dataModel, 'movements', 'quantity'),
+    note: label(dataModel, 'movements', 'note'),
+    actor: label(dataModel, 'movements', 'actor_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}">${escapeHtml(tx(key))}</button>`
+  const body = [
+    view(
+      '/',
+      path,
+      `${i18n(tx, 'stockIntro', 'p', 'class="one-muted"')}
+<p><strong id="lowBanner"></strong></p>
+<p class="one-muted" id="checkNote"></p>
+<one-filter id="stockFilter" for="stockTable"></one-filter>
+<one-table id="stockTable" src="/api/items?active=true" paging="page" export="xlsx csv" caption="${escapeHtml(tx('stockTable'))}"></one-table>
+<one-chart id="locationChart" type="bar"></one-chart>`,
+    ),
+    view(
+      '/movements',
+      path,
+      `${i18n(tx, 'movementsIntro', 'p', 'class="one-muted"')}
+${i18n(tx, 'managersOnly', 'p', 'class="one-muted" id="moveDenied"')}
+<section id="moveBox" class="one-card" hidden>
+<h2 data-i18n="movementForm">${escapeHtml(tx('movementForm'))}</h2>
+<one-form id="moveForm" no-cancel></one-form>
+</section>
+<one-table id="movementsTable" src="/api/movements" paging="page" export="xlsx csv" caption="${escapeHtml(tx('movementsTable'))}"></one-table>`,
+    ),
+    view(
+      '/items',
+      path,
+      `${i18n(tx, 'itemsIntro', 'p', 'class="one-muted"')}
+<one-table id="itemsTable" src="/api/items" paging="page" export="xlsx csv" clickable caption="${escapeHtml(tx('itemsTable'))}"></one-table>
+${i18n(tx, 'managersOnly', 'p', 'class="one-muted" id="itemsDenied"')}
+<section id="itemEditor" class="one-card" hidden>
+<h2 data-i18n="itemForm">${escapeHtml(tx('itemForm'))}</h2>
+<div class="app-toolbar">${btn('newItem', 'newItem')}</div>
+<one-form id="itemForm" action="/api/items" 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 stockTable = $('stockTable'), stockFilter = $('stockFilter'), chart = $('locationChart');
+  var moveForm = $('moveForm'), movementsTable = $('movementsTable'), itemsTable = $('itemsTable'), itemForm = $('itemForm');
+  var itemOptions = [];
+
+  function isLow(row) { return Number(row.min_quantity) > 0 && Number(row.quantity) < Number(row.min_quantity); }
+  stockTable.columns = [
+    { key: 'sku', label: M.labels.sku },
+    { key: 'name', label: M.labels.name },
+    { key: 'category', label: M.labels.category },
+    { key: 'location', label: M.labels.location },
+    { key: 'quantity', label: M.labels.quantity, type: 'number' },
+    { key: 'unit', label: M.labels.unit, type: 'choice', options: M.unit },
+    { key: 'min_quantity', label: M.labels.min, type: 'number' },
+    { key: 'low', label: { tr: S.tr.low, en: S.en.low }, sortable: false, format: function (v, row) { return isLow(row) ? t('low') : ''; } },
+    { key: 'responsible_name', label: M.labels.responsibleName }
+  ];
+  stockFilter.fields = [{ key: 'q', label: { tr: S.tr.search, en: S.en.search }, type: 'text' }];
+  movementsTable.columns = [
+    { key: 'created_at', label: { tr: 'Zaman', en: 'Time' }, type: 'datetime' },
+    { key: 'item_name', label: M.labels.itemName },
+    { key: 'kind', label: M.labels.kind, type: 'choice', options: M.kind },
+    { key: 'quantity', label: M.labels.moveQuantity, type: 'number' },
+    { key: 'note', label: M.labels.note },
+    { key: 'actor_name', label: M.labels.actor }
+  ];
+  itemsTable.columns = [
+    { key: 'sku', label: M.labels.sku },
+    { key: 'name', label: M.labels.name },
+    { key: 'category', label: M.labels.category },
+    { key: 'location', label: M.labels.location },
+    { key: 'min_quantity', label: M.labels.min, type: 'number' },
+    { key: 'responsible_name', label: M.labels.responsibleName },
+    { key: 'active', label: M.labels.active, type: 'boolean' }
+  ];
+  itemForm.fields = [
+    { key: 'sku', label: M.labels.sku, required: true, maxLength: 40 },
+    { key: 'name', label: M.labels.name, required: true, maxLength: 120 },
+    { key: 'category', label: M.labels.category, maxLength: 60 },
+    { key: 'unit', label: M.labels.unit, type: 'choice', options: M.unit, required: true },
+    { key: 'location', label: M.labels.location, maxLength: 120 },
+    { key: 'min_quantity', label: M.labels.min, type: 'number', min: 0, required: true },
+    { key: 'responsible', label: { tr: S.tr.responsible, en: S.en.responsible }, type: 'person' },
+    { key: 'active', label: M.labels.active, type: 'boolean' }
+  ];
+  function newItem() { itemForm.setAttribute('action', '/api/items'); itemForm.setAttribute('method', 'POST'); itemForm.value = { unit: 'piece', min_quantity: 0, active: true }; one.setTitle(null); }
+  newItem();
+
+  function moveFields() {
+    moveForm.fields = [
+      { key: 'item', label: M.labels.item, type: 'choice', options: itemOptions, required: true },
+      { key: 'kind', label: M.labels.kind, type: 'choice', options: M.kind, required: true },
+      { key: 'quantity', label: M.labels.moveQuantity, type: 'number', min: 0, required: true },
+      { key: 'note', label: M.labels.note, maxLength: 200 }
+    ];
+  }
+  function loadItems() {
+    return loadAll('/api/items?active=true&_sort=name').then(function (r) {
+      if (!r.ok) { one.toast({ severity: 'error', summary: problem(r) }); return; }
+      itemOptions = r.body.items.map(function (x) { return { value: x.id, label: x.sku + ' - ' + x.name }; });
+      moveFields();
+    });
+  }
+  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;
+      $('lowBanner').textContent = s.low.count > 0 ? t('lowSome', { n: fmtNumber(s.low.count) }) : t('lowNone');
+      $('checkNote').textContent = s.lastCheck ? t('lastCheck', { day: fmtDate(s.lastCheck.run_key), n: fmtNumber(s.lastCheck.low_count) }) : t('noCheck');
+      chart.label = { tr: S.tr.chartTitle, en: S.en.chartTitle };
+      chart.data = {
+        labels: s.byLocation.map(function (x) { return x.location || t('noLocation'); }),
+        series: [
+          { name: { tr: S.tr.seriesTotal, en: S.en.seriesTotal }, values: s.byLocation.map(function (x) { return x.total; }) },
+          { name: { tr: S.tr.seriesLow, en: S.en.seriesLow }, values: s.byLocation.map(function (x) { return x.low; }) }
+        ]
+      };
+    });
+  }
+  // Hareket formu kendisi göndermez: kalem seçimi adrese yazılır (gövde yalnız tür, miktar ve açıklamayı taşır).
+  moveForm.addEventListener('save', function (e) {
+    e.preventDefault();
+    var v = e.detail.value;
+    api('POST', '/api/items/' + encodeURIComponent(v.item) + '/movements', { kind: v.kind, quantity: v.quantity, note: v.note || '' }).then(function (r) {
+      if (!r.ok) {
+        if (r.body && r.body.errors) moveForm.setErrors(r.body.errors, problem(r));
+        else one.toast({ severity: 'error', summary: problem(r) });
+        return;
+      }
+      one.toast({ severity: 'success', summary: t('moved') });
+      if (r.body.item && r.body.item.low) one.toast({ severity: 'warn', summary: t('lowWarn') });
+      if (r.body.notification === 'consent-needed') one.toast({ severity: 'warn', summary: t('consentNeeded') });
+      moveForm.value = { kind: v.kind };
+      movementsTable.reload(); stockTable.reload(); loadSummary();
+    });
+  });
+  itemsTable.addEventListener('rowclick', function (e) {
+    if (!can(M.manage) || !canWrite()) return;
+    var r = e.detail.row;
+    itemForm.setAttribute('action', '/api/items/' + encodeURIComponent(r.id));
+    itemForm.setAttribute('method', 'PATCH');
+    itemForm.value = Object.assign({}, r, { responsible: r.responsible_org_id ? { id: r.responsible_org_id, name: r.responsible_name || '' } : null });
+    one.setTitle(r.name);
+  });
+  $('newItem').addEventListener('click', newItem);
+  itemForm.addEventListener('saved', function (e) {
+    e.preventDefault();
+    one.toast({ severity: 'success', summary: t('itemSaved') });
+    newItem(); itemsTable.reload(); stockTable.reload(); loadItems(); loadSummary();
+  });
+  onSession(function () {
+    var manager = can(M.manage) && canWrite();
+    $('moveBox').toggleAttribute('hidden', !manager); $('moveDenied').toggleAttribute('hidden', manager);
+    $('itemEditor').toggleAttribute('hidden', !manager); $('itemsDenied').toggleAttribute('hidden', manager);
+    if (manager) loadItems();
+  });
+  onLang(function () { loadSummary(); });
+  onReady(function () { loadSummary(); });
+`
+}

package/templates/envanter/files/src/stock.test.ts.tpl

@@ -0,0 +1,31 @@
+import { describe, expect, it } from 'vitest'
+import { MOVEMENT_MAX, checkDayKey, checkMovement, isLow } from './stock.ts'
+
+describe('stok kuralları', () => {
+  it('giriş ve çıkışta miktar pozitif; sayımda 0 geçerli', () => {
+    expect(checkMovement('in', 5, 'piece')).toEqual({ ok: true, kind: 'in', quantity: 5 })
+    expect(checkMovement('out', '0', 'piece')).toMatchObject({ ok: false, field: 'quantity' })
+    expect(checkMovement('count', 0, 'piece')).toEqual({ ok: true, kind: 'count', quantity: 0 })
+    expect(checkMovement('count', -1, 'piece')).toMatchObject({ ok: false, field: 'quantity' })
+  })
+
+  it('adet ve kutuda tam sayı; kg ve litrede en çok üç ondalık; tavan', () => {
+    expect(checkMovement('in', 1.5, 'piece')).toMatchObject({ ok: false })
+    expect(checkMovement('in', 1.255, 'kg')).toEqual({ ok: true, kind: 'in', quantity: 1.255 })
+    expect(checkMovement('in', 1.2555, 'kg')).toMatchObject({ ok: false })
+    expect(checkMovement('in', MOVEMENT_MAX + 1, 'piece')).toMatchObject({ ok: false })
+    expect(checkMovement('transfer', 1, 'piece')).toMatchObject({ ok: false, field: 'kind' })
+    expect(checkMovement('in', 'beş', 'piece')).toMatchObject({ ok: false, field: 'quantity' })
+  })
+
+  it('eşik: altında azalmış; eşitte değil; eşik 0 iken hiç', () => {
+    expect(isLow(4, 5)).toBe(true)
+    expect(isLow(5, 5)).toBe(false)
+    expect(isLow(0, 0)).toBe(false)
+  })
+
+  it('günlük kontrol anahtarı İstanbul gününe göre', () => {
+    expect(checkDayKey(new Date('2026-10-20T20:59:00Z'))).toBe('2026-10-20')
+    expect(checkDayKey(new Date('2026-10-20T21:00:00Z'))).toBe('2026-10-21')
+  })
+})

package/templates/envanter/files/src/stock.ts.tpl

@@ -0,0 +1,33 @@
+// Stok kuralları — SAF fonksiyonlar (veritabanı yok): hareket doğrulama, eşik ve günlük kontrol anahtarı. Sunucu her
+// hareketi burada doğrular; kuralı değiştiren bu dosyayı ve `stock.test.ts`'i birlikte değiştirir.
+export const MOVEMENT_KINDS = ['in', 'out', 'count'] as const
+export type MovementKind = (typeof MOVEMENT_KINDS)[number]
+/** Tek hareketin en büyük miktarı (yanlış yazılan fazladan sıfırı yakalar). */
+export const MOVEMENT_MAX = 1_000_000
+/** Miktar en çok üç ondalık (kg, litre); adet ve kutuda tam sayı. */
+export const DECIMALS = 3
+const WHOLE_UNITS = new Set(['piece', 'box'])
+
+export type MovementCheck = { ok: true; kind: MovementKind; quantity: number } | { ok: false; field: 'kind' | 'quantity'; message: string }
+
+export function checkMovement(kind: unknown, raw: unknown, unit: string): MovementCheck {
+  if (typeof kind !== 'string' || !(MOVEMENT_KINDS as readonly string[]).includes(kind)) return { ok: false, field: 'kind', message: 'Giriş, çıkış ya da sayım seçin.' }
+  const quantity = typeof raw === 'number' ? raw : typeof raw === 'string' && raw.trim() !== '' ? Number(raw) : NaN
+  if (!Number.isFinite(quantity)) return { ok: false, field: 'quantity', message: 'Miktar bir sayı olmalı.' }
+  if (WHOLE_UNITS.has(unit) && !Number.isInteger(quantity)) return { ok: false, field: 'quantity', message: 'Bu birimde miktar tam sayı olmalı.' }
+  if (Math.abs(Math.round(quantity * 10 ** DECIMALS) - quantity * 10 ** DECIMALS) > 1e-6) return { ok: false, field: 'quantity', message: `Miktar en çok ${DECIMALS} ondalık olabilir.` }
+  if (quantity > MOVEMENT_MAX) return { ok: false, field: 'quantity', message: `Tek harekette en çok ${MOVEMENT_MAX} girilebilir.` }
+  // Sayımda 0 geçerlidir (raf boş); giriş ve çıkışta değildir.
+  if (kind === 'count' ? quantity < 0 : quantity <= 0) return { ok: false, field: 'quantity', message: kind === 'count' ? 'Sayım sonucu 0 ya da daha büyük olmalı.' : 'Miktar 0\'dan büyük olmalı.' }
+  return { ok: true, kind: kind as MovementKind, quantity }
+}
+
+/** Eşik: miktar en az miktarın ALTINDAYSA azalmıştır (eşik 0 ise kalem hiç azalmış sayılmaz). */
+export function isLow(quantity: number, minQuantity: number): boolean {
+  return minQuantity > 0 && quantity < minQuantity
+}
+
+/** Günlük kontrolün anahtarı: İstanbul saatiyle gün (aynı gün ikinci kez koşan iş yeni kayıt açmaz). */
+export function checkDayKey(at: Date): string {
+  return new Date(at.getTime() + 3 * 3_600_000).toISOString().slice(0, 10)
+}