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

package/templates/musteri-ziyaret/files/src/shell.ts.tpl

@@ -0,0 +1,272 @@
+// {{nameTr}} — sayfa (üç görünüm: Ziyaretlerim · Ekip ziyaretleri · Tüm ziyaretler). Liste, süzgeç ve form hazır
+// bileşenlerdir; seçenekler veri modelinden gelir. Ekip ve ERP müşteri listesi sunucuda çözülü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 { 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.',
+    mineIntro: 'Kaydettiğiniz müşteri görüşmeleri. Bir satırı seçip düzenleyebilir, sonraki adımı tamamlandı olarak işaretleyebilirsiniz.',
+    week: 'Bu hafta ({from} - {to}): {n} görüşme.',
+    overdue: '{n} sonraki adımın tarihi geçti.',
+    upcomingTitle: 'Yaklaşan sonraki adımlar',
+    upcomingEmpty: 'Yaklaşan sonraki adım yok.',
+    formTitle: 'Ziyaret bilgileri',
+    newVisit: 'Yeni ziyaret',
+    saved: 'Ziyaret kaydedildi.',
+    customerTitle: 'ERP müşteri listesi',
+    customerHint: 'Müşteriyi listeden seçin; listede yoksa adını elle yazın.',
+    customerSearch: 'Müşteri ara',
+    stateNotConfigured: 'ERP müşteri listesi bu uygulamaya bağlanmadı: müşteri adını elle yazın.',
+    stateNotPermitted: 'ERP müşteri listesine bu uygulamanın ya da sizin izniniz yok: müşteri adını elle yazın.',
+    stateUnavailable: 'ERP müşteri listesine şu anda ulaşılamıyor: müşteri adını elle yazabilir ya da sonra yeniden deneyebilirsiniz.',
+    stateMisconfigured: 'ERP müşteri listesi beklenen bilgileri döndürmüyor (uygulamanın sorgu ayarı yanlış): müşteri adını elle yazın.',
+    truncated: 'Liste çok uzun olduğu için kesildi; aradığınız müşteri yoksa adını elle yazın.',
+    myTable: 'Ziyaretlerim',
+    teamIntro: 'Organizasyon şemasında yöneticisi olduğunuz çalışanların müşteri görüşmeleri.',
+    teamNone: 'Organizasyon şemasında size bağlı çalışan yok.',
+    teamTable: 'Ekip ziyaretleri',
+    allIntro: 'Bütün satış ekibinin müşteri görüşmeleri.',
+    managersOnly: 'Bu bölüm yalnız bütün ziyaretleri görme izni olan kişilere açıktır.',
+    allTable: 'Tüm ziyaretler',
+    search: 'Ara',
+    dateRange: 'Ziyaret 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.',
+    mineIntro: 'Customer contacts you recorded. Select a row to edit it or mark the next step as done.',
+    week: 'This week ({from} - {to}): {n} contacts.',
+    overdue: '{n} next steps are past their date.',
+    upcomingTitle: 'Upcoming next steps',
+    upcomingEmpty: 'No upcoming next steps.',
+    formTitle: 'Visit details',
+    newVisit: 'New visit',
+    saved: 'Visit saved.',
+    customerTitle: 'ERP customer list',
+    customerHint: 'Pick the customer from the list; if it is not there, type the name.',
+    customerSearch: 'Search customers',
+    stateNotConfigured: 'The ERP customer list is not connected to this app: type the customer name.',
+    stateNotPermitted: 'This app or you have no permission for the ERP customer list: type the customer name.',
+    stateUnavailable: 'The ERP customer list cannot be reached right now: type the customer name or try again later.',
+    stateMisconfigured: 'The ERP customer list does not return the expected data (the app query setting is wrong): type the customer name.',
+    truncated: 'The list was cut because it is too long; if your customer is missing, type the name.',
+    myTable: 'My visits',
+    teamIntro: 'Customer contacts of the employees you manage in the organization schema.',
+    teamNone: 'No employees report to you in the organization schema.',
+    teamTable: 'Team visits',
+    allIntro: 'Customer contacts of the whole sales team.',
+    managersOnly: 'Only people allowed to see all visits can use this section.',
+    allTable: 'All visits',
+    search: 'Search',
+    dateRange: 'Visit date',
+  },
+}
+
+const MODEL = {
+  manage: '{{permissionPrefix}}Manage',
+  type: choices(dataModel, 'visits', 'visit_type'),
+  outcome: choices(dataModel, 'visits', 'outcome'),
+  source: choices(dataModel, 'visits', 'customer_source'),
+  labels: {
+    code: label(dataModel, 'visits', 'customer_code'),
+    customer: label(dataModel, 'visits', 'customer_name'),
+    source: label(dataModel, 'visits', 'customer_source'),
+    rep: label(dataModel, 'visits', 'rep_name'),
+    date: label(dataModel, 'visits', 'visit_date'),
+    type: label(dataModel, 'visits', 'visit_type'),
+    notes: label(dataModel, 'visits', 'notes'),
+    outcome: label(dataModel, 'visits', 'outcome'),
+    step: label(dataModel, 'visits', 'next_step'),
+    stepDate: label(dataModel, 'visits', 'next_step_date'),
+    stepDone: label(dataModel, 'visits', 'next_step_done'),
+  },
+}
+
+export function renderShell(lang: Lang, theme: Theme, path: string): string {
+  const tx = translator(STRINGS, lang)
+  const body = [
+    view(
+      '/',
+      path,
+      `${i18n(tx, 'mineIntro', 'p', 'class="one-muted"')}
+<p><strong id="weekBanner"></strong> <span id="overdueBanner"></span></p>
+<section class="one-card">
+<h2 data-i18n="upcomingTitle">${escapeHtml(tx('upcomingTitle'))}</h2>
+<one-table id="upcomingTable" no-search></one-table>
+</section>
+<section class="one-card">
+<h2 data-i18n="formTitle">${escapeHtml(tx('formTitle'))}</h2>
+<div class="app-toolbar"><button type="button" class="one-btn" id="newVisit" data-i18n="newVisit">${escapeHtml(tx('newVisit'))}</button></div>
+<div id="customerBox">
+<h3 data-i18n="customerTitle">${escapeHtml(tx('customerTitle'))}</h3>
+<div id="customerState" class="one-message one-message-info" hidden></div>
+<div id="customerPicker" hidden>
+${i18n(tx, 'customerHint', 'p', 'class="one-muted"')}
+<one-filter id="customerFilter"></one-filter>
+<one-table id="customerTable" clickable no-search></one-table>
+</div>
+</div>
+<one-form id="visitForm" action="/api/visits" method="POST" no-cancel></one-form>
+</section>
+<one-table id="myTable" src="/api/visits" paging="page" export="xlsx csv" clickable caption="${escapeHtml(tx('myTable'))}"></one-table>`,
+    ),
+    view(
+      '/team',
+      path,
+      `${i18n(tx, 'teamIntro', 'p', 'class="one-muted"')}
+${i18n(tx, 'teamNone', 'p', 'class="one-message one-message-info" id="teamNone" hidden')}
+<one-filter id="teamFilter" for="teamTable"></one-filter>
+<one-table id="teamTable" src="/api/team/visits" paging="page" export="xlsx csv" caption="${escapeHtml(tx('teamTable'))}"></one-table>`,
+    ),
+    view(
+      '/all',
+      path,
+      `${i18n(tx, 'managersOnly', 'p', 'class="one-muted" id="allDenied"')}
+<div id="allBox" hidden>
+${i18n(tx, 'allIntro', 'p', 'class="one-muted"')}
+<one-filter id="allFilter" for="allTable"></one-filter>
+<one-table id="allTable" src="/api/all/visits" paging="page" export="xlsx csv" caption="${escapeHtml(tx('allTable'))}"></one-table>
+</div>`,
+    ),
+  ].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 form = $('visitForm'), myTable = $('myTable'), teamTable = $('teamTable'), allTable = $('allTable'), upcoming = $('upcomingTable');
+  var customerTable = $('customerTable'), customerFilter = $('customerFilter');
+  var STATE_KEYS = { 'not-configured': 'stateNotConfigured', 'not-permitted': 'stateNotPermitted', unavailable: 'stateUnavailable', misconfigured: 'stateMisconfigured' };
+  var customerState = null;
+
+  var listColumns = [
+    { key: 'visit_date', label: M.labels.date, type: 'date' },
+    { key: 'customer_name', label: M.labels.customer },
+    { key: 'visit_type', label: M.labels.type, type: 'choice', options: M.type },
+    { key: 'outcome', label: M.labels.outcome, type: 'choice', options: M.outcome },
+    { key: 'next_step', label: M.labels.step },
+    { key: 'next_step_date', label: M.labels.stepDate, type: 'date' },
+    { key: 'next_step_done', label: M.labels.stepDone, type: 'boolean' }
+  ];
+  myTable.columns = listColumns.concat([{ key: 'customer_source', label: M.labels.source, type: 'choice', options: M.source }]);
+  teamTable.columns = [{ key: 'rep_name', label: M.labels.rep }].concat(listColumns);
+  allTable.columns = [{ key: 'rep_name', label: M.labels.rep }].concat(listColumns);
+  upcoming.columns = [
+    { key: 'next_step_date', label: M.labels.stepDate, type: 'date' },
+    { key: 'customer_name', label: M.labels.customer },
+    { key: 'next_step', label: M.labels.step }
+  ];
+  upcoming.emptyText = { tr: S.tr.upcomingEmpty, en: S.en.upcomingEmpty };
+  customerTable.columns = [{ key: 'code', label: M.labels.code }, { key: 'name', label: M.labels.customer }];
+  customerFilter.fields = [{ key: 'q', label: { tr: S.tr.customerSearch, en: S.en.customerSearch }, type: 'text' }];
+  var filterFields = [
+    { key: 'q', label: { tr: S.tr.search, en: S.en.search }, type: 'text' },
+    { key: 'visit_type', label: M.labels.type, type: 'choice', options: M.type },
+    { key: 'outcome', label: M.labels.outcome, type: 'choice', options: M.outcome },
+    { key: 'visit_date', label: { tr: S.tr.dateRange, en: S.en.dateRange }, type: 'dateRange' }
+  ];
+  $('teamFilter').fields = filterFields;
+  $('allFilter').fields = filterFields;
+
+  function fields(editing) {
+    var list = [
+      { key: 'customer_code', label: M.labels.code, maxLength: 40 },
+      { key: 'customer_name', label: M.labels.customer, required: true, maxLength: 160 },
+      { key: 'visit_date', label: M.labels.date, type: 'date', required: true },
+      { key: 'visit_type', label: M.labels.type, type: 'choice', options: M.type, required: true },
+      { key: 'outcome', label: M.labels.outcome, type: 'choice', options: M.outcome, required: true },
+      { key: 'notes', label: M.labels.notes, type: 'longText', maxLength: 4000 },
+      { key: 'next_step', label: M.labels.step, maxLength: 200 },
+      { key: 'next_step_date', label: M.labels.stepDate, type: 'date' }
+    ];
+    if (editing) list.push({ key: 'next_step_done', label: M.labels.stepDone, type: 'boolean' });
+    form.fields = list;
+  }
+  function today() { var d = new Date(); return d.getFullYear() + '-' + (d.getMonth() < 9 ? '0' : '') + (d.getMonth() + 1) + '-' + (d.getDate() < 10 ? '0' : '') + d.getDate(); }
+  function newVisit() {
+    fields(false);
+    form.setAttribute('action', '/api/visits'); form.setAttribute('method', 'POST');
+    form.value = { visit_date: today(), visit_type: 'visit' };
+    one.setTitle(null);
+  }
+  newVisit();
+
+  function showCustomerState(state, truncated) {
+    customerState = state;
+    var box = $('customerState');
+    if (state === 'ok') {
+      $('customerPicker').removeAttribute('hidden');
+      if (truncated) { box.textContent = t('truncated'); box.removeAttribute('hidden'); } else box.setAttribute('hidden', '');
+    } else {
+      $('customerPicker').setAttribute('hidden', '');
+      box.textContent = t(STATE_KEYS[state] || 'stateUnavailable'); box.removeAttribute('hidden');
+    }
+  }
+  var customerTruncated = false;
+  function loadCustomers(q) {
+    return api('GET', '/api/customers' + (q ? '?q=' + encodeURIComponent(q) : '')).then(function (r) {
+      if (!r.ok) { showCustomerState('unavailable', false); return; }
+      customerTruncated = r.body.truncated === true;
+      showCustomerState(r.body.state, customerTruncated);
+      customerTable.rows = r.body.items;
+    });
+  }
+  customerFilter.addEventListener('change', function (e) { loadCustomers((e.detail.params && e.detail.params.q) || ''); });
+  customerTable.addEventListener('rowclick', function (e) {
+    var c = e.detail.row;
+    form.value = Object.assign({}, form.value, { customer_code: c.code, customer_name: c.name });
+  });
+
+  function loadSummary() {
+    return api('GET', '/api/summary').then(function (r) {
+      if (!r.ok) return;
+      var s = r.body;
+      $('weekBanner').textContent = t('week', { from: fmtDate(s.week.from), to: fmtDate(s.week.to), n: fmtNumber(s.week.total) });
+      $('overdueBanner').textContent = s.overdue > 0 ? t('overdue', { n: fmtNumber(s.overdue) }) : '';
+      upcoming.rows = s.upcoming;
+    });
+  }
+  myTable.addEventListener('rowclick', function (e) {
+    if (!canWrite()) return;
+    var r = e.detail.row;
+    fields(true);
+    form.setAttribute('action', '/api/visits/' + encodeURIComponent(r.id)); form.setAttribute('method', 'PATCH');
+    form.value = r;
+    one.setTitle(r.customer_name);
+  });
+  $('newVisit').addEventListener('click', newVisit);
+  form.addEventListener('saved', function (e) {
+    e.preventDefault();
+    one.toast({ severity: 'success', summary: t('saved') });
+    newVisit(); myTable.reload(); loadSummary();
+  });
+  function loadTeamNote() {
+    return api('GET', '/api/team/visits?limit=1').then(function (r) {
+      if (r.ok) $('teamNone').toggleAttribute('hidden', r.body.teamSize !== 0);
+    });
+  }
+  onSession(function () {
+    var manager = can(M.manage);
+    $('allBox').toggleAttribute('hidden', !manager); $('allDenied').toggleAttribute('hidden', manager);
+    if (manager) allTable.reload();
+  });
+  onLang(function () { loadSummary(); if (customerState) showCustomerState(customerState, customerTruncated); });
+  onReady(function () { loadSummary(); loadCustomers(''); loadTeamNote(); });
+`
+}

package/templates/musteri-ziyaret/files/src/visit.test.ts.tpl

@@ -0,0 +1,65 @@
+import type { OrgUserWithManagers } from '@devoplus/one-sdk'
+import { describe, expect, it } from 'vitest'
+import { CUSTOMER_QUERY, isConfigured, searchCustomers } from './customers.ts'
+import { BACKDATE_MAX_DAYS, checkVisit, istanbulDay, teamOf, weekRange } from './visit.ts'
+
+const NOW = new Date('2026-10-21T09:00:00Z') // çarşamba
+
+function user(id: string, functionalManager: string): OrgUserWithManagers {
+  return {
+    id,
+    userCode: null,
+    fullName: id,
+    companyId: '',
+    workplaceId: '',
+    departmentId: '',
+    employeeTypeId: '',
+    titleId: '',
+    positionId: '',
+    functionalManager,
+    operationalManager: '',
+    isEmployee: true,
+    isActive: true,
+  }
+}
+
+describe('ziyaret kuralları', () => {
+  it('hafta İstanbul saatiyle pazartesi - pazar', () => {
+    expect(weekRange(NOW)).toEqual({ from: '2026-10-19', to: '2026-10-25' })
+    expect(weekRange(new Date('2026-10-25T20:59:00Z'))).toEqual({ from: '2026-10-19', to: '2026-10-25' })
+    expect(weekRange(new Date('2026-10-25T21:00:00Z'))).toEqual({ from: '2026-10-26', to: '2026-11-01' })
+    expect(istanbulDay(NOW)).toBe('2026-10-21')
+  })
+
+  it('ziyaret bugünden ileri ve bir yıldan eski olamaz; sonraki adım tarihiyle birlikte ve ziyaretten sonra', () => {
+    expect(checkVisit({ visit_date: '2026-10-21', next_step: null, next_step_date: null }, NOW)).toBeNull()
+    expect(checkVisit({ visit_date: '2026-10-22', next_step: null, next_step_date: null }, NOW)).toMatchObject({ field: 'visit_date' })
+    expect(checkVisit({ visit_date: '2025-01-01', next_step: null, next_step_date: null }, NOW)).toMatchObject({ field: 'visit_date' })
+    expect(BACKDATE_MAX_DAYS).toBeGreaterThan(0)
+    expect(checkVisit({ visit_date: '2026-10-20', next_step: 'Teklif gönder', next_step_date: null }, NOW)).toMatchObject({ field: 'next_step_date' })
+    expect(checkVisit({ visit_date: '2026-10-20', next_step: '', next_step_date: '2026-10-30' }, NOW)).toMatchObject({ field: 'next_step' })
+    expect(checkVisit({ visit_date: '2026-10-20', next_step: 'Teklif', next_step_date: '2026-10-19' }, NOW)).toMatchObject({ field: 'next_step_date' })
+    expect(checkVisit({ visit_date: '2026-10-20', next_step: 'Teklif', next_step_date: '2026-10-30' }, NOW)).toBeNull()
+  })
+
+  it('ekip: yöneticisi ben olanlar; derinlik sınırlı, döngü ve kendim hariç', () => {
+    const users = [user('A', 'M'), user('B', 'm'), user('C', 'A'), user('M', 'C'), user('X', '')]
+    expect(teamOf(users, 'M').sort()).toEqual(['a', 'b'])
+    expect(teamOf(users, 'm', 2).sort()).toEqual(['a', 'b', 'c'])
+    expect(teamOf(users, 'm', 5).sort()).toEqual(['a', 'b', 'c'])
+    expect(teamOf(users, 'X')).toEqual([])
+  })
+
+  it('ERP müşteri sorgusu yer tutucu: doldurulmadan bağlı sayılmaz; arama Türkçe harflere duyarsız', () => {
+    expect(isConfigured(CUSTOMER_QUERY)).toBe(false)
+    expect(isConfigured({ key: 'ERP.Customers', codeColumn: 'Code', nameColumn: '' })).toBe(false)
+    expect(isConfigured({ key: 'ERP.Customers', codeColumn: 'Code', nameColumn: 'Name' })).toBe(true)
+    const list = [
+      { code: 'C1', name: 'Çağlar Ticaret' },
+      { code: 'C2', name: 'İstanbul Gıda' },
+    ]
+    expect(searchCustomers(list, 'caglar', 10).map((c) => c.code)).toEqual(['C1'])
+    expect(searchCustomers(list, 'ISTANBUL', 10).map((c) => c.code)).toEqual(['C2'])
+    expect(searchCustomers(list, '', 1)).toHaveLength(1)
+  })
+})

package/templates/musteri-ziyaret/files/src/visit.ts.tpl

@@ -0,0 +1,98 @@
+// Müşteri ziyareti kuralları — SAF fonksiyonlar (veritabanı ve ağ yok): tarih kuralları, sonraki adım, hafta aralığı ve
+// "ekibim kim" hesabı. Sunucu her kaydı burada doğrular; kuralı değiştiren bu dosyayı ve `visit.test.ts`'i birlikte değiştirir.
+import type { OrgUserWithManagers } from '@devoplus/one-sdk'
+
+/** Bütün ziyaretleri görme izni (manifest `permissions`): satış müdürü, bölge yöneticisi. */
+export const MANAGE_PERMISSION = '{{permissionPrefix}}Manage'
+
+/**
+ * Ekip derinliği: 1 = yalnız doğrudan bağlı çalışanlar (organizasyon şemasında yöneticisi BEN olanlar); 2 = onların
+ * bağlıları da … Ekip her istekte organizasyon şemasından SUNUCUDA hesaplanır; kayıtta yönetici tutulmaz, bu yüzden
+ * şema değişince ekip görünümü de kendiliğinden değişir.
+ */
+export const TEAM_DEPTH = 1
+/** Geçmişe dönük en çok kaç günlük ziyaret girilebilir. */
+export const BACKDATE_MAX_DAYS = 365
+
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/
+const DAY_MS = 86_400_000
+
+/** İstanbul saatiyle gün (YYYY-AA-GG). Türkiye'de yaz saati uygulaması yoktur (UTC+3). */
+export function istanbulDay(at: Date): string {
+  return new Date(at.getTime() + 3 * 3_600_000).toISOString().slice(0, 10)
+}
+
+function addDays(day: string, days: number): string {
+  return new Date(Date.parse(`${day}T00:00:00Z`) + days * DAY_MS).toISOString().slice(0, 10)
+}
+
+/** Bu hafta: İstanbul saatiyle pazartesi - pazar (ikisi de dahil). */
+export function weekRange(now: Date): { from: string; to: string } {
+  const today = istanbulDay(now)
+  const weekday = new Date(`${today}T00:00:00Z`).getUTCDay() // 0 = pazar
+  const from = addDays(today, -((weekday + 6) % 7))
+  return { from, to: addDays(from, 6) }
+}
+
+export interface VisitFields {
+  visit_date: unknown
+  next_step: unknown
+  next_step_date: unknown
+}
+
+export type VisitIssue = { field: 'visit_date' | 'next_step' | 'next_step_date'; message: string } | null
+
+const text = (v: unknown): string => (typeof v === 'string' ? v.trim() : '')
+
+/**
+ * Tarih kuralları: ziyaret bugünden ileri olamaz (gerçekleşmiş görüşme kaydedilir) ve bir yıldan eski olamaz; sonraki adım
+ * yazıldıysa tarihi de verilir (ya da tersi) ve sonraki adım ziyaretten önce olamaz.
+ */
+export function checkVisit(values: VisitFields, now: Date): VisitIssue {
+  const today = istanbulDay(now)
+  const visitDate = text(values.visit_date)
+  if (!DATE_RE.test(visitDate)) return { field: 'visit_date', message: 'Ziyaret tarihini girin.' }
+  if (visitDate > today) return { field: 'visit_date', message: 'Ziyaret tarihi bugünden ileri olamaz; gerçekleşen görüşmeyi kaydedin.' }
+  if (visitDate < addDays(today, -BACKDATE_MAX_DAYS)) return { field: 'visit_date', message: `Ziyaret tarihi ${BACKDATE_MAX_DAYS} günden eski olamaz.` }
+  const step = text(values.next_step)
+  const stepDate = text(values.next_step_date)
+  if (step && !stepDate) return { field: 'next_step_date', message: 'Sonraki adımın tarihini girin.' }
+  if (stepDate && !step) return { field: 'next_step', message: 'Sonraki adımı yazın ya da tarihini silin.' }
+  if (stepDate && !DATE_RE.test(stepDate)) return { field: 'next_step_date', message: 'Sonraki adım tarihini girin.' }
+  if (stepDate && stepDate < visitDate) return { field: 'next_step_date', message: 'Sonraki adım ziyaretten önce olamaz.' }
+  return null
+}
+
+/**
+ * Ekibim: organizasyon şemasında (fonksiyonel) yöneticisi `managerId` olan kişiler, `depth` basamak aşağıya kadar.
+ * Kendisi dahil edilmez; döngülü şemada sonsuza gitmez. Kimlikler küçük harfe indirilir.
+ * ⛔ Ekip KESİLMEZ: liste görünürlüğün (kimin ziyaretini görürüm) ve ekip büyüklüğünün kaynağıdır. Bir üst sınır sondaki
+ * kişileri sessizce dışarıda bırakır; yönetici o kişilerin ziyaretlerini göremez ve bunu öğrenmezdi. Sorgu ekibi tek bağlı
+ * parametreyle (JSON dizisi) alır, kişi sayısı sorgu metnini büyütmez.
+ */
+export function teamOf(users: readonly OrgUserWithManagers[], managerId: string, depth = TEAM_DEPTH): string[] {
+  const me = managerId.toLowerCase()
+  const byManager = new Map<string, string[]>()
+  for (const u of users) {
+    const m = typeof u.functionalManager === 'string' ? u.functionalManager.toLowerCase() : ''
+    if (!m) continue
+    const list = byManager.get(m) ?? []
+    list.push(u.id.toLowerCase())
+    byManager.set(m, list)
+  }
+  const seen = new Set<string>([me])
+  const team: string[] = []
+  let level = [me]
+  for (let d = 0; d < depth && level.length > 0; d++) {
+    const next: string[] = []
+    for (const m of level)
+      for (const id of byManager.get(m) ?? []) {
+        if (seen.has(id)) continue
+        seen.add(id)
+        team.push(id)
+        next.push(id)
+      }
+    level = next
+  }
+  return team
+}

package/templates/musteri-ziyaret/manifest.json.tpl

@@ -0,0 +1,37 @@
+{
+  "scopes": ["orgschema.read"],
+  "services": { "database": true, "files": false, "cache": false },
+  "menuIcon": "pi pi-briefcase",
+  "navigation": [
+    { "path": "/", "label": { "tr": "Ziyaretlerim", "en": "My visits" } },
+    { "path": "/team", "label": { "tr": "Ekip ziyaretleri", "en": "Team visits" } },
+    { "path": "/all", "label": { "tr": "Tüm ziyaretler", "en": "All visits" }, "permission": "{{permissionPrefix}}Manage" }
+  ],
+  "permissions": [
+    { "code": "{{permissionPrefix}}Manage", "name": { "tr": "Bütün müşteri ziyaretlerini gör", "en": "See all customer visits" } }
+  ],
+  "agent": {
+    "summary": {
+      "tr": "Müşteri ziyaret raporu: satış ekibinin bu haftaki müşteri görüşmeleri, sonuçları ve yaklaşan sonraki adımlar.",
+      "en": "Customer visit report: the sales team's customer contacts this week, their outcomes and upcoming next steps."
+    },
+    "tools": [
+      {
+        "name": "weekly-visit-summary",
+        "title": { "tr": "Bu haftaki ziyaret özeti", "en": "This week's visit summary" },
+        "description": {
+          "tr": "Bu haftanın (pazartesi-pazar, Türkiye saati) müşteri görüşmelerini türe ve sonuca göre sayar, en çok görüşülen müşterileri ve yaklaşan sonraki adımları döndürür. Salt okunur.",
+          "en": "Counts this week's (Monday-Sunday, Turkey time) customer contacts by type and outcome, returns the most contacted customers and upcoming next steps. Read-only."
+        },
+        "readOnly": true,
+        "permission": "{{permissionCode}}",
+        "input": {
+          "type": "object",
+          "properties": {
+            "scope": { "type": "string", "enum": ["mine", "all"], "description": "mine: kullanıcının kendi görüşmeleri (varsayılan) · all: bütün görüşmeler (yalnız tüm ziyaretleri görme izni olana)" }
+          }
+        }
+      }
+    ]
+  }
+}

package/templates/saha-denetimi/AGENTS.template.md.tpl

@@ -0,0 +1,32 @@
+## Bu uygulamanın şablonu: saha denetimi (`saha-denetimi`)
+
+Uygulama `create-devoplus-one-app --template saha-denetimi` 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: `checklists` + `checklist_items` (tanım) · `audits` (denetim) + `audit_answers` (madde cevabı). Değişince `pnpm data:generate` |
+| `src/app.ts` | Uçlar: kontrol listesi/madde tanımı, denetim başlatma (madde kopyası), taslak kaydı, tamamlama, rapor, fotoğraf, pano |
+| `src/score.ts` | Saf kurallar: ağırlıklı puan, kritik madde tavanı, sonuç bantları, tamamlama eksikleri + `score.test.ts` |
+| `src/queries.ts` | Pano ve yapay zekâ araçlarının ortak sorguları (yalnız tamamlanmış denetimler) |
+| `src/shell.ts` | Sayfa: Denetimlerim · Pano · Kontrol listeleri + denetim paneli (form, sonuç tablosu, yazdırma) |
+| `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):
+
+- **Puan YALNIZ sunucuda hesaplanır** (`computeScore`, tamamlama ucunda). Denetim uçları `score`, `result`, `status`,
+  sayılar ve `critical_failed` alanlarını istemciden ALMAZ (400); tamamlama ucunun gövdesi boştur.
+- **Tamamlanan denetim değişmez:** cevap ucu ve silme yalnız taslakta çalışır (409); genel güncelleme yoktur (405).
+  Cevap güncellemeleri `EXISTS (… status = 'draft')` koşuluyla aynı toplu yazımda yürür; tamamlama, denetimin
+  `updated_at`'i okunduğundan beri değiştiyse durur. Bu koşulları "önce oku, sonra yaz"a çevirmeyin.
+- **Madde kopyası:** denetim başlarken kontrol listesinin maddeleri `audit_answers`'a kopyalanır. Puan kopyadan
+  hesaplanır; kontrol listesini düzenlemek geçmiş denetimi değiştirmez. Puanı canlı listeden hesaplamayın.
+- **Görünürlük:** kişi yalnız kendi denetimini görür (`records: 'own'`); yönetici (`…Manage`) hepsini görür. Başkasının
+  denetimi "bulunamadı" (404) döner — kimlik yoklanamaz. Denetimi yalnız denetçi doldurur (yönetici bile değiştiremez).
+- **Yer:** `location_id` organizasyon şemasındaki iş yeri kimliğidir ve sunucuda şemaya karşı doğrulanır; ad şemadan
+  yazılır. Şema okunamazsa ekran serbest metne döner. Pano yerleri `location_name`'e göre gruplar.
+- **Fotoğraf:** yalnız kullanıcının kendi yükleme ön ekindeki anahtar kayda yazılır (`ownFileKey`); indirme denetimi
+  görebilen kişiye açıktır.
+- Telefon numarası alanı EKLEMEYİN; onay akışı (onaylayan zinciri) bu uygulamanın işi değildir — kurumun İş Akışı
+  modülü kullanılır.

package/templates/saha-denetimi/README.md.tpl

@@ -0,0 +1,44 @@
+# {{nameTr}}
+
+Mağaza ve şubelerde yapılan saha denetimlerini kaydeden bir uygulama. Devoplus Portal'ın içinde, Portal menüsünden
+açılır. Bu uygulama Devoplus One'ın **saha denetimi** şablonundan üretildi; ihtiyacınıza göre değiştirilecek bir
+başlangıç noktasıdır.
+
+## Ne yapar
+
+1. **Kontrol listeleri:** yönetici denetimde bakılacak maddeleri tanımlar. Her maddenin bir bölümü, bir ağırlığı (1-10)
+   vardır ve "kritik" olarak işaretlenebilir.
+2. **Denetimlerim:** denetçi kontrol listesini ve denetlenen yeri seçer. Yer, Portal'daki iş yerleri listesinden
+   seçilir; listede yoksa adı elle yazılır. Her madde "uygun", "uygun değil" ya da "uygulanamaz" olarak işaretlenir;
+   not ve fotoğraf eklenebilir. Denetim taslak olarak kaydedilip sonra tamamlanabilir.
+3. **Puan:** denetim tamamlanınca puanı uygulama hesaplar: uygun maddelerin ağırlığının, değerlendirilen maddelerin
+   ağırlığına oranı. "Uygulanamaz" maddeler puana girmez. Kritik bir madde uygun değilse denetim her zaman başarısız
+   sayılır. 85 ve üstü başarılı, 60 ile 85 arası geliştirilmeli, 60'ın altı başarısızdır.
+4. **Değişmez kayıt:** tamamlanan denetim değiştirilemez ve silinemez. Kontrol listesi sonradan değişse de geçmiş
+   denetimler ve puanları aynı kalır.
+5. **Rapor:** her denetimin raporu yazdırılabilir (tarayıcının "PDF olarak kaydet" seçeneğiyle PDF yapılabilir).
+   Denetim listeleri Excel'e aktarılabilir.
+6. **Pano:** yönetici son 30 günün özetini, yerlere göre son ve ortalama puanı ve son denetimleri görür.
+7. **Devoplus asistanı:** "Hangi mağazaların puanı düşük?" gibi sorular Devoplus'un yapay zekâ asistanına
+   sorulduğunda cevap bu uygulamadan gelir.
+
+## Kimler ne görür
+
+| Kim | Ne yapabilir |
+|---|---|
+| Uygulamayı kullanma izni olan herkes ({{permissionCode}}) | Denetim yapar; yalnız kendi denetimlerini görür |
+| Yönetici ({{permissionPrefix}}Manage) | Kontrol listelerini yönetir, bütün denetimleri ve panoyu görür, Excel'e aktarır |
+
+İzinleri portal yöneticisi **Yetki Yönetimi** ekranından verir.
+
+## Neleri değiştirebilirsiniz
+
+Yapay zekâ aracınıza iş diliyle söylemeniz yeterlidir:
+
+- "Başarılı sayılma sınırı 90 olsun" — puan bandı.
+- "Uygun değil seçilen maddede fotoğraf zorunlu olsun" — yeni kural.
+- "Denetim tamamlanınca mağaza müdürüne e-posta gitsin" — bildirim (e-posta izni gerekir).
+- "Her ay her mağaza en az bir kez denetlensin, eksik olanlar panoda görünsün" — yeni pano bilgisi.
+
+Bilinmesi gerekenler: iş yeri listesi Portal'ın organizasyon bilgisinden okunur; okunamadığında yerin adı elle
+yazılır. Fotoğraflar uygulamanın kendi dosya alanında saklanır ve yalnız denetçi ile yöneticiler indirebilir.

package/templates/saha-denetimi/files/AGENT_GUIDE.md.tpl

@@ -0,0 +1,55 @@
+# {{nameTr}} — Devoplus yapay zekâsı için rehber
+
+Bu dosyayı **Devoplus yapay zekâsı** okur (uygulama adresinde `/.well-known/one-agent.md`). Bir aracı eklerken,
+değiştirirken ya da kaldırırken bu dosyayı AYNI değişiklikte güncelleyin; yayın kapısı dört başlığı ve her aracın adını
+arar.
+
+## Uygulama ne yapar
+
+{{nameTr}}, mağaza ve şubelerde yapılan saha denetimlerini kaydeder. Yönetici kontrol listeleri tanımlar (bölüm, madde,
+ağırlık, kritik madde). Denetçi bir yeri seçip denetimi başlatır, her maddeyi "uygun", "uygun değil" ya da
+"uygulanamaz" olarak işaretler, not ve fotoğraf ekler ve denetimi tamamlar. Puanı uygulama hesaplar: uygun maddelerin
+ağırlığının değerlendirilen maddelerin ağırlığına oranı (0-100). "Uygulanamaz" maddeler puana girmez. Kritik bir madde
+uygun değilse denetim her zaman başarısızdır. Tamamlanan denetim değiştirilemez. Kullanıcı "Kadıköy mağazasının son
+denetimi nasıldı", "hangi mağazaların puanı düşük", "son denetimlerde neler uygun değildi" gibi sorular sorduğunda bu
+uygulamaya başvurun. Denetim açan ya da dolduran araç yoktur.
+
+## Veri
+
+- **Kontrol listesi** (`checklists`) ve **maddeleri** (`checklist_items`): bölüm, madde metni, ağırlık (1-10),
+  kritik mi.
+- **Denetim** (`audits`): denetlenen yer (iş yeri ya da elle yazılmış ad), kontrol listesi, denetçi, durum (`draft`
+  taslak · `completed` tamamlandı), tamamlanma zamanı, puan, sonuç (`passed` başarılı · `needs_improvement`
+  geliştirilmeli · `failed` başarısız), kritik madde uygun değil mi.
+- **Denetim cevabı** (`audit_answers`): maddenin denetim anındaki kopyası, sonuç (`compliant` uygun · `noncompliant`
+  uygun değil · `not_applicable` uygulanamaz), not, fotoğraf.
+- Sonuç bantları: 85 ve üstü başarılı, 60-85 arası geliştirilmeli, 60'ın altı başarısız. Taslağın puanı yoktur;
+  araçlar yalnız tamamlanmış denetimleri döndürür.
+
+## Araçlar
+
+### `recent-audit-results` — son denetim sonuçları (salt okunur)
+
+- **Ne zaman:** kullanıcı bir yerin ya da genel olarak son denetimlerin sonucunu, puanını ya da uygun bulunmayan
+  maddeleri sorduğunda.
+- **Girdi:** `location` (isteğe bağlı) — yer adında geçen ifade; `limit` (1-30, varsayılan 10).
+- **Çıktı:** `{ "audits": [{ "location", "checklist", "auditor", "completedAt", "score", "result", "criticalFailed",
+  "failedItems": ["…"] }] }` — en yenisi önce; `failedItems` en çok 10 madde, kritik olanlar "(kritik)" ekiyle önce.
+- **Dikkat:** yer adında büyük/küçük harf eşleşmesi yalnız Latin harflerde yok sayılır; Türkçe harfli bir aramada
+  sonuç çıkmazsa ifadeyi küçük harfle yeniden deneyin. Yalnız yöneticiler kullanabilir.
+
+### `location-scores` — yerlere göre denetim puanları (salt okunur)
+
+- **Ne zaman:** kullanıcı mağazaları karşılaştırmak, en düşük ya da en yüksek puanlı yerleri görmek istediğinde.
+- **Girdi:** yok.
+- **Çıktı:** `{ "locations": [{ "location", "audits", "lastScore", "averageScore", "lastAuditAt", "criticalFailures" }] }`
+  — son denetimi en yeni olan önce, en çok 50 yer.
+
+## Örnek istekler
+
+- "Kadıköy mağazasının son denetimi nasıldı?" → `recent-audit-results` (`location: "kadıköy"`) → `score`, `result`,
+  `failedItems`
+- "Hangi mağazaların puanı düşük?" → `location-scores` → `lastScore`'a göre sıralayın
+- "Son denetimlerde en sık uygun bulunmayan maddeler neler?" → `recent-audit-results` (`limit: 30`) → `failedItems`
+- "Yarın Bakırköy mağazasını denetleyeceğim, denetimi aç." → araç yok; kullanıcıyı uygulamanın Denetimlerim sekmesine
+  yönlendirin.