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

package/templates/index.ts.tpl

@@ -0,0 +1,262 @@
+/// <reference path="./markdown.d.ts" />
+// {{nameTr}} — Devoplus One uygulaması (iskelet: create-devoplus-one-app). Uçlar:
+//   GET    /                 kabuk (sayfa; manifest `navigation` yolları da kabuğu döndürür — sekmeleri Portal çizer)
+//   GET    /shell.js         kabuğun betiği (satır içi betik platformda kapalıdır)
+//   GET    /one-bridge.js · /one-ui.css   Devoplus One köprüsü ve görsel dili (SDK clientAssetResponse)
+//   GET    /api/me           oturumdaki kullanıcı: dispatch bağlamı + CA Users/me
+//   GET    /api/notes        bu kurulumun veritabanındaki notlarım (PortalId kolonu YOK — veritabanı zaten bu portala aittir, D-17)
+//   POST   /api/notes        not ekle  { text }
+//   DELETE /api/notes/{id}   notumu sil
+{{#files}}
+//   GET/POST /api/files · GET/DELETE /api/files/{key}   bu kurulumun dosya deposu (SDK OneFiles; env.FILES) — kullanıcı yalnız kendi dosyalarını görür
+{{/files}}
+{{#cache}}
+//   GET/PUT/DELETE /api/cache                             bu kurulumun önbelleği (SDK OneCache; env.CACHE)
+{{/cache}}
+//   POST   /__one/agent/list-notes                       Devoplus yapay zekâsının aracı — YALNIZ platformun imzalı yolundan (src/agent.ts)
+//   GET    /.well-known/one-agent.json · one-agent.md     yapay zekâ kataloğu (manifest `agent`) ve rehberi (AGENT_GUIDE.md)
+// Kimlik X-One-* başlıklarından OKUNUR (dispatch yazar); bu dosya o başlıkları asla üretmez.
+import {
+  BackendClient,
+  agentManifestResponse,
+  clientAssetResponse,
+  handleAgentRequest,
+  navigationFromManifest,
+  scriptResponse,
+{{#cache}}
+  OneCache,
+{{/cache}}
+{{#files}}
+  OneFiles,
+{{/files}}
+  logAudit,
+  problemResponse,
+  readBoundedBody,
+  readContext,
+  requireUser,
+{{#files}}
+  sanitizeFileName,
+{{/files}}
+  type OneApp,
+{{#cache}}
+  type OneCacheBinding,
+{{/cache}}
+  type OneContext,
+  type OneDatabase,
+{{#files}}
+  type OneFilesBinding,
+{{/files}}
+} from '@devoplus/one-sdk'
+import manifest from '../one.manifest.json' with { type: 'json' }
+import guide from '../AGENT_GUIDE.md' with { type: 'text' }
+import { agentTools } from './agent.ts'
+import { normalizeLang, normalizeTheme, renderShell, renderShellScript } from './shell.ts'
+
+// Menü manifest'ten gelir (tek kaynak): Portal sekmeleri çizer, sayfa betiği bir kez üretilir.
+const NAVIGATION = navigationFromManifest(manifest)
+// Salt-okunur uyarısı manifestin Vekalet / Yerine Görüntüle kipine uyar (actingSessions: "write" ise gösterilmez).
+const SHELL_SCRIPT = renderShellScript(NAVIGATION, {
+  actingWrites: (manifest as { actingSessions?: string }).actingSessions === 'write',
+})
+const isPage = (pathname: string): boolean => pathname === '/' || NAVIGATION.some((item) => item.path === pathname)
+
+interface Env {
+  /** Bu kurulumun veritabanı — yalnız bu portala aittir (D-17); tabloya PortalId eklenmez. */
+  DB: OneDatabase
+{{#files}}
+  /** Bu kurulumun dosya deposu (manifest services.files → env.FILES). */
+  FILES: OneFilesBinding
+{{/files}}
+{{#cache}}
+  /** Bu kurulumun önbelleği (manifest services.cache → env.CACHE). TTL zorunludur; kalıcı veri için DEĞİL. */
+  CACHE: OneCacheBinding
+{{/cache}}
+  /** CA backend tabanı; one-ci `vars` olarak yazar ve outbound allowlist'indedir. */
+  API_BASE: string
+}
+
+interface MeResponse {
+  id: string
+  firstName?: string
+  lastName?: string
+  email?: string
+}
+
+interface NoteRow {
+  id: number
+  text: string
+  createdAt: string
+}
+
+const NOTE_MAX_LENGTH = 500
+const NOTE_BODY_MAX_BYTES = 16 * 1024
+{{#files}}
+const UPLOAD_PREFIX = 'uploads/'
+const UPLOAD_MAX_BYTES = 5 * 1024 * 1024
+// Yüklenen anahtar `<ön ek>/<uuid>-<ad>`: indirme adı için uuid ön eki soyulur.
+const UPLOAD_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}-/
+
+/**
+ * Her kullanıcının dosyaları KENDİ ön ekindedir (`uploads/<sub>/`); liste, indirme ve silme bu ön ekin dışına
+ * çıkamaz. Tek bir ortak ön ek kullanılsaydı aynı adla yüklenen dosya bir başkasınınkini EZERDİ ve anahtarı bilen
+ * herkes silebilirdi. `sub` URL kodlanır ki anahtar parçası `/` ya da kontrol karakteri taşımasın.
+ */
+function uploadPrefixFor(sub: string): string {
+  return `${UPLOAD_PREFIX}${encodeURIComponent(sub)}/`
+}
+{{/files}}
+
+function json(body: unknown, status = 200): Response {
+  return Response.json(body, { status })
+}
+
+/** JSON gövdeyi SINIRLI okur: hazır `.json()` metodu gövdenin tamamını belleğe aldıktan SONRA ayrıştırırdı. */
+async function readJsonBody(request: Request, maxBytes: number): Promise<unknown> {
+  const buffer = await readBoundedBody(request, maxBytes)
+  try {
+    return JSON.parse(new TextDecoder().decode(buffer))
+  } catch {
+    return null
+  }
+}
+
+export default {
+  async fetch(request, env): Promise<Response> {
+    const { pathname, searchParams } = new URL(request.url)
+    const method = request.method
+    // `catch` bağlamı görsün diye dışarıda: beklenmeyen hata Event Logger'a uygulama ve portal bağlamıyla yazılır (D-45).
+    let context: OneContext | undefined
+    try {
+      // Devoplus yapay zekâsı: imzalı araç çağrısı (`/__one/agent/…`) ve katalog/rehber (`/.well-known/one-agent.*`) —
+      // SDK karşılar; yönlendirmeden ÖNCE durur.
+      const agent = (await handleAgentRequest(request, env, agentTools, manifest)) ?? agentManifestResponse(request, manifest, guide)
+      if (agent) return agent
+
+      const ctx = readContext(request.headers)
+      context = ctx
+
+      if (method === 'GET') {
+        const asset = clientAssetResponse(pathname)
+        if (asset) return asset
+        if (pathname === '/shell.js') return scriptResponse(SHELL_SCRIPT)
+      }
+
+      if (method === 'GET' && isPage(pathname)) {
+        return new Response(renderShell(normalizeLang(searchParams.get('lang')), normalizeTheme(searchParams.get('theme'))), {
+          headers: { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store' },
+        })
+      }
+
+      if (pathname === '/api/me' && method === 'GET') {
+        const user = requireUser(ctx)
+        const api = new BackendClient({ baseUrl: env.API_BASE, authorization: request.headers.get('authorization') })
+        const me = await api.get<MeResponse>('Users/me')
+        return json({ app: ctx.app, portalKey: ctx.portalKey, sub: user.sub, scope: user.scope, me })
+      }
+
+      // ── Notlar: bu kurulumun KENDİ veritabanı. Satırlar `sub` ile kişiye bağlıdır; portal süzgeci GEREKMEZ (veritabanı zaten bu portalın). ──
+      if (pathname === '/api/notes' && method === 'GET') {
+        const user = requireUser(ctx)
+        const rows = await env.DB.prepare('SELECT id, text, created_at AS createdAt FROM notes WHERE sub = ? ORDER BY id DESC LIMIT 50')
+          .bind(user.sub)
+          .all<NoteRow>()
+        return json({ notes: rows.results })
+      }
+
+      if (pathname === '/api/notes' && method === 'POST') {
+        const user = requireUser(ctx)
+        const body = (await readJsonBody(request, NOTE_BODY_MAX_BYTES)) as { text?: unknown } | null
+        const text = typeof body?.text === 'string' ? body.text.trim() : ''
+        if (text.length === 0 || text.length > NOTE_MAX_LENGTH) return json({ detail: `Not metni 1–${NOTE_MAX_LENGTH} karakter olmalı.` }, 400)
+        const result = await env.DB.prepare('INSERT INTO notes (sub, text) VALUES (?, ?)').bind(user.sub, text).run()
+        const id = Number(result.meta.last_row_id)
+        logAudit(ctx, '{{slug}}.note.create', String(id))
+        return json({ id }, 201)
+      }
+
+      if (pathname.startsWith('/api/notes/') && method === 'DELETE') {
+        const user = requireUser(ctx)
+        const id = Number(pathname.slice('/api/notes/'.length))
+        if (!Number.isInteger(id) || id <= 0) return json({ detail: 'Geçersiz not kimliği.' }, 400)
+        // Yalnız kendi notu: `AND sub = ?` olmasaydı kimliği bilen başkasının notunu silerdi.
+        const result = await env.DB.prepare('DELETE FROM notes WHERE id = ? AND sub = ?').bind(id, user.sub).run()
+        if (result.meta.changes === 0) return json({ detail: 'Not bulunamadı.' }, 404)
+        logAudit(ctx, '{{slug}}.note.delete', String(id))
+        return json({ deleted: id })
+      }
+{{#files}}
+
+      // ── Dosyalar: bu kurulumun KENDİ dosya deposu (SDK OneFiles anahtar/boyut kurallarını uygular) ──────────────
+      if (pathname === '/api/files' && method === 'GET') {
+        const user = requireUser(ctx)
+        const files = new OneFiles(env.FILES)
+        // Yalnız kendi ön eki listelenir. Liste imleci istemciye OLDUĞU GİBİ döner ve `?cursor=` ile geri alınır
+        // (sıra leksikografiktir, yükleme sırası değil).
+        const cursor = searchParams.get('cursor')
+        const page = await files.list({ prefix: uploadPrefixFor(user.sub), limit: 20, ...(cursor ? { cursor } : {}) })
+        return json({ files: page.files, truncated: page.truncated, cursor: page.cursor ?? null })
+      }
+
+      if (pathname === '/api/files' && method === 'POST') {
+        const user = requireUser(ctx)
+        const files = new OneFiles(env.FILES)
+        const name = sanitizeFileName(request.headers.get('x-file-name') ?? 'dosya.bin')
+        const contentType = request.headers.get('content-type') ?? 'application/octet-stream'
+        // Sınır gövde belleğe alınmadan ÖNCE uygulanır (Content-Length), parçalı akışta okuma sırasında kesilir.
+        const body = await readBoundedBody(request, UPLOAD_MAX_BYTES)
+        // Anahtar her yüklemede benzersizdir (uuid): aynı adla ikinci yükleme öncekini EZMEZ, iki kayıt olur.
+        const key = `${uploadPrefixFor(user.sub)}${crypto.randomUUID()}-${name}`
+        const stored = await files.put(key, body, { contentType, maxBytes: UPLOAD_MAX_BYTES, metadata: { sub: user.sub } })
+        logAudit(ctx, '{{slug}}.file.put', stored.key, { size: stored.size })
+        return json(stored, 201)
+      }
+
+      if (pathname.startsWith('/api/files/') && (method === 'GET' || method === 'DELETE')) {
+        const user = requireUser(ctx)
+        const files = new OneFiles(env.FILES)
+        const key = decodeURIComponent(pathname.slice('/api/files/'.length))
+        // Başkasının ön eki 404'tür (403 değil): anahtar uzayı yoklanamaz, "var ama senin değil" sızmaz.
+        if (!key.startsWith(uploadPrefixFor(user.sub))) return json({ detail: 'Dosya bulunamadı.' }, 404)
+        if (method === 'DELETE') {
+          await files.delete(key)
+          logAudit(ctx, '{{slug}}.file.delete', key, { sub: user.sub })
+          return json({ deleted: key })
+        }
+        const object = await files.get(key)
+        if (!object) return json({ detail: 'Dosya bulunamadı.' }, 404)
+        const headers = new Headers()
+        object.writeHttpMetadata(headers)
+        headers.set('etag', object.httpEtag)
+        const downloadName = (key.split('/').pop() ?? 'dosya').replace(UPLOAD_ID_RE, '')
+        headers.set('content-disposition', `attachment; filename="${downloadName}"`)
+        return new Response(object.body, { headers })
+      }
+{{/files}}
+{{#cache}}
+
+      // ── Önbellek: bu kurulumun KENDİ önbelleği. TTL zorunlu; önbellek nihai tutarlıdır — sayaç/kilit/kalıcı kayıt için DEĞİL. ──
+      if (pathname === '/api/cache' && (method === 'GET' || method === 'PUT' || method === 'DELETE')) {
+        const user = requireUser(ctx)
+        const cache = new OneCache(env.CACHE)
+        const key = `me:${user.sub}`
+        if (method === 'GET') {
+          const value = await cache.get(key)
+          return json({ key, hit: value !== null, value })
+        }
+        if (method === 'DELETE') {
+          await cache.delete(key)
+          return json({ deleted: key })
+        }
+        const value = { writtenAt: new Date().toISOString(), sub: user.sub }
+        await cache.put(key, value, { ttlSeconds: 300 })
+        return json({ key, value }, 201)
+      }
+{{/cache}}
+
+      return json({ detail: 'Bulunamadı.' }, 404)
+    } catch (error) {
+      // OneError → RFC 9457 ProblemDetails (status + code); bilinmeyen hata 500 ONE-SDK-E-999 (ayrıntı sızdırılmaz).
+      return problemResponse(error, context)
+    }
+  },
+} satisfies OneApp<Env>

package/templates/markdown.d.ts.tpl

@@ -0,0 +1,6 @@
+// `import guide from '../AGENT_GUIDE.md' with { type: 'text' }` — Markdown dosyası derlemede metin olarak gömülür
+// (`one build` ve yayın aynı paketleyiciyi kullanır). Bu bildirim yalnız tip denetimi içindir.
+declare module '*.md' {
+  const text: string
+  export default text
+}

package/templates/musteri-ziyaret/AGENTS.template.md.tpl

@@ -0,0 +1,47 @@
+## Bu uygulamanın şablonu: müşteri ziyaret raporu (`musteri-ziyaret`)
+
+Uygulama `create-devoplus-one-app --template musteri-ziyaret` 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: `visits` (müşteri görüşmesi). Değişince `pnpm data:generate` |
+| `src/app.ts` | Uçlar: ziyaretlerim (kendi kaydım), ekip ziyaretleri (sunucuda hesaplanan ekip + Excel), tüm ziyaretler, müşteri listesi, özet |
+| `src/visit.ts` | Saf kurallar: tarih ve sonraki adım, hafta aralığı, **ekip hesabı `teamOf` (`TEAM_DEPTH`)** + `visit.test.ts` |
+| `src/customers.ts` | **ERP müşteri listesi — YER TUTUCU `CUSTOMER_QUERY`** (DEXA okuma sorgusu; bağlı değilse elle giriş) |
+| `src/shell.ts` | Sayfa: ziyaretlerim (özet + form + müşteri seçici), ekip ziyaretleri, tüm ziyaretler |
+| `src/agent.ts` · `src/queries.ts` · `AGENT_GUIDE.md` | Devoplus yapay zekâsının aracı ve rehberi |
+| `src/lib/*` | Şablonların ortak parçaları — gerekmedikçe değiştirmeyin |
+
+### ERP müşteri listesini bağlamak (`src/customers.ts`)
+
+⛔ Sorgu anahtarı ve kolon adları **UYDURULMAZ**. `CUSTOMER_QUERY = { key, codeColumn, nameColumn }` üçü de boşken
+uygulama DEXA'ya hiç gitmez, `/api/customers` `state: "not-configured"` döner ve müşteri elle girilir. Bağlamak için:
+
+1. Kullanıcıdan ya da yöneticiden kurumun DEXA Query Store'undaki **müşteri listesi okuma sorgusunun anahtarını** ve
+   sorgunun döndürdüğü **müşteri kodu** ile **müşteri adı** kolonlarının adlarını öğrenin. Sorgu parametre almayan bir
+   liste sorgusu olmalıdır. Sorgu yoksa erişim talebiyle `new-query` isteyin (taslak SQL yalnız öneridir).
+2. Üç değeri `CUSTOMER_QUERY`'ye yazın.
+3. `one.manifest.json`'a `scopes` içine `"dexa.read"` ve `services` içine `"dexa": { "queryKeys": ["<anahtar>"] }`
+   ekleyin — manifest şeması ikisini birlikte ister.
+4. Erişim talepleri: sorgunun uygulamaya açılması `dexa-query` (`queryKey`), yetki alanı `scope` (`dexa.read`).
+
+Durumlar: `ok` · `not-configured` · `not-permitted` (yetki alanı belirteçte yok ya da sunucu 401/403 döndü) ·
+`unavailable` (ERP'ye ulaşılamıyor; boş liste "müşteri yok" DEĞİLDİR) · `misconfigured` (yanıtta kolonlar yok). `ok`
+dışındaki her durumda kayıt elle girilen adla yapılır ve `customer_source = "manual"` olur.
+
+Değişmezler (bozmayın):
+
+- **ERP'ye YAZILMAZ.** Bu şablon yalnız okur; ERP'ye yazma (`dexa.write`) istenirse bunun ayrı bir onay ve işlem
+  anahtarı gerektirdiğini söyleyin.
+- **Müşteri kaynağını SUNUCU belirler:** ERP listesi bağlıyken kod verilen kayıtta kod listede olmalıdır (yoksa 400) ve
+  müşteri adı ERP'den alınır (`customer_source = "erp"`); istemcinin gönderdiği ad o durumda yok sayılır.
+- **Temsilci SUNUCUDAN gelir:** `rep_org_id` ve `rep_name` `Users/me`'den yazılır, gövdede gönderilemez (400).
+  `rep_org_id` Organization Schema kimliğidir, oturum kimliği (`sub`) DEĞİLDİR.
+- **Ekip her istekte organizasyon şemasından SUNUCUDA hesaplanır** (`getOrgUsersWithManagers` + `teamOf`, fonksiyonel
+  yönetici). Kayıtta yönetici TUTULMAZ; istemciden ekip ya da temsilci süzgeci alınmaz. Ekip dışındaki tek kayıt 404.
+  Ekip süzgeci tek bağlı parametredir (`rep_org_id IN (SELECT value FROM json_each(?))`): kimlikleri SQL metnine
+  yazmayın. Ekip KESİLMEZ (üst sınır yok): kesilseydi sondaki kişilerin ziyaretleri yöneticiden sessizce gizlenirdi.
+- **Ziyaretlerim yalnız kayıt sahibine açıktır** (`records: 'own'`); tüm ziyaretler yalnız okunur ve izinle kapılıdır.
+- Zamanlanmış iş yoktur. "Sonraki adım tarihi gelince hatırlat" istenirse zamanlanmış işin e-postayı ancak manifest
+  `jobs.services` beyanı ve kurulumdaki yönetici onayıyla gönderebileceğini söyleyin.

package/templates/musteri-ziyaret/README.md.tpl

@@ -0,0 +1,48 @@
+# {{nameTr}}
+
+Satış ekibinin müşteri görüşmelerini kaydettiği ve yöneticilerin ekiplerinin görüşmelerini izlediği bir uygulama.
+Devoplus Portal'ın içinde, Portal menüsünden açılır. Bu uygulama Devoplus One'ın **müşteri ziyaret raporu**
+şablonundan üretildi; ihtiyacınıza göre değiştirilecek bir başlangıç noktasıdır.
+
+## Ne yapar
+
+1. **Ziyaretlerim:** satış temsilcisi her görüşmeyi kaydeder: müşteri, ziyaret tarihi, görüşme türü (ziyaret, telefon,
+   çevrimiçi), görüşme notu, sonuç ve sonraki adım (tarihiyle). Ekranın üstünde bu haftaki görüşme sayısı, tarihi
+   geçmiş sonraki adımlar ve yaklaşan sonraki adımların listesi durur. Kendi görüşmelerini düzenler, sonraki adımı
+   tamamlandı olarak işaretler, listeyi Excel'e ya da CSV'ye aktarır.
+2. **Müşteri seçimi:** kurumunuz ERP müşteri listesini bağladıysa müşteri listeden aranıp seçilir ve adı ERP'den
+   alınır. Liste bağlı değilse, uygulamanın izni yoksa ya da ERP'ye o an ulaşılamıyorsa ekran bunu söyler ve müşteri
+   adı elle yazılır; kayıt "Elle girildi" olarak işaretlenir. Uygulama ERP'ye **hiçbir şey yazmaz**, yalnız okur.
+3. **Ekip ziyaretleri:** yönetici, organizasyon şemasında kendisine bağlı çalışanların görüşmelerini görür, arar,
+   süzer ve Excel'e aktarır. Ekip her açılışta organizasyon şemasından hesaplanır; şemada yöneticisi değişen çalışanın
+   görüşmeleri yeni yöneticisine görünür.
+4. **Tüm ziyaretler:** bütün ziyaretleri görme izni olan kişi (ör. satış müdürü) bütün ekibin görüşmelerini görür.
+5. **Devoplus asistanı:** "Bu hafta kaç müşteri görüşmesi yaptım?" ya da "Yaklaşan sonraki adımlarım neler?" 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}}) | Kendi görüşmelerini kaydeder ve görür; yöneticiyse ekibinin görüşmelerini görür |
+| Bütün ziyaretleri görme izni ({{permissionPrefix}}Manage) | Bütün ekibin görüşmelerini görür ve Excel'e aktarır |
+
+İzinleri portal yöneticisi **Yetki Yönetimi** ekranından verir. Kimin kimin yöneticisi olduğu Devoplus'un
+organizasyon şemasından okunur; uygulamada ayrıca tanımlanmaz.
+
+## ERP müşteri listesini bağlamak
+
+Uygulama ilk üretildiğinde ERP'ye bağlı değildir ve müşteri elle yazılır. Bağlamak için kurumunuzun ERP'sinde müşteri
+listesini döndüren bir sorgu gerekir. Yapay zekâ aracınıza "müşteri listesini ERP'den alalım" demeniz yeterlidir: araç
+sorgunun bilgilerini sizden ya da yöneticinizden ister, uygulamanın ayarına yazar ve gereken izni yöneticiden ister.
+Sorgu hazır değilse yöneticiden yeni bir sorgu yazılmasını isteyebilir.
+
+## Neleri değiştirebilirsiniz
+
+- "Sonuçlara *fiyat teklifi verildi* ekle" (ilk yayından önce netleştirin).
+- "Görüşmeye katılan müşteri yetkilisinin adı da yazılsın" — yeni alan.
+- "Yöneticinin yöneticisi de görsün" — ekip derinliği tek bir ayardır.
+- "Sonraki adımın tarihi gelince temsilciye hatırlatılsın" — yeni bildirim.
+
+Bilinmesi gerekenler: ziyaret tarihi bugünden ileri olamaz (gerçekleşen görüşme kaydedilir) ve bir yıldan eski olamaz.
+Sonraki adım yazıldıysa tarihi de verilmelidir.

package/templates/musteri-ziyaret/files/AGENT_GUIDE.md.tpl

@@ -0,0 +1,44 @@
+# {{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}}, satış ekibinin müşteri görüşmelerini kaydettiği bir rapor uygulamasıdır. Temsilci her görüşmeyi (ziyaret,
+telefon ya da çevrimiçi) müşteri, tarih, görüşme notu, sonuç ve sonraki adımla kaydeder. Müşteri, kurum bağladıysa ERP
+müşteri listesinden seçilir; bağlı değilse elle yazılır. Yönetici, organizasyon şemasında kendisine bağlı çalışanların
+görüşmelerini görür. Kullanıcı "bu hafta kaç müşteri görüşmesi yaptım", "yaklaşan sonraki adımlarım neler", "en çok
+hangi müşteriyle görüştük" gibi şeyler sorduğunda bu uygulamaya başvurun. Görüşme kaydeden ya da ERP'ye yazan araç
+yoktur.
+
+## Veri
+
+- **Görüşme** (`visits`): müşteri kodu ve adı, müşteri kaynağı (`erp` ERP listesinden · `manual` elle girildi), satış
+  temsilcisi, ziyaret tarihi, görüşme türü (`visit` ziyaret · `phone` telefon · `online` çevrimiçi), görüşme notu,
+  sonuç (`interested` ilgileniyor · `order` sipariş/anlaşma · `follow_up` takip gerekiyor · `no_interest`
+  ilgilenmiyor), sonraki adım, sonraki adımın tarihi ve tamamlandı mı.
+- Hafta pazartesi başlar, pazar biter (Türkiye saati).
+
+## Araçlar
+
+### `weekly-visit-summary` — bu haftaki ziyaret özeti (salt okunur)
+
+- **Ne zaman:** kullanıcı bu haftaki müşteri görüşmelerini, sonuçlarını ya da yaklaşan sonraki adımlarını sorduğunda.
+- **Girdi:** `scope` — `mine` (varsayılan: kullanıcının kendi görüşmeleri) ya da `all` (bütün ekip; yalnız bütün
+  ziyaretleri görme izni olan kişide çalışır, yoksa 403 döner — o zaman `mine` ile yeniden deneyin ve kullanıcıya
+  yalnız kendi görüşmelerini görebildiğini söyleyin).
+- **Çıktı:** `{ "scope": "mine", "from": "2026-10-19", "to": "2026-10-25", "total": 7, "byType": { "visit": 4, "phone": 3 },
+  "byOutcome": { "interested": 3, "order": 2, "follow_up": 2 }, "topCustomers": [{ "customer_name", "visits" }],
+  "upcomingNextSteps": [{ "customer_name", "next_step", "next_step_date", "rep_name" }], "overdueNextSteps": 1 }` —
+  `topCustomers` en çok 5, `upcomingNextSteps` en çok 10 kayıt (en yakın tarih önce).
+- **Dikkat:** "Ekibimin görüşmeleri" sorusunu bu araç cevaplamaz (ekip organizasyon şemasından ekranda hesaplanır);
+  kullanıcıyı uygulamanın Ekip ziyaretleri sekmesine yönlendirin.
+
+## Örnek istekler
+
+- "Bu hafta kaç müşteri görüşmesi yaptım?" → `weekly-visit-summary` → `total`, `byType`
+- "Yaklaşan sonraki adımlarım neler?" → `weekly-visit-summary` → `upcomingNextSteps`
+- "Bu hafta bütün ekip kaç sipariş aldı?" → `weekly-visit-summary` (`scope: "all"`) → `byOutcome.order`
+- "Yarın ABC firmasını ziyaret ettiğimi kaydet." → araç yok; kullanıcıyı uygulamanın Ziyaretlerim sekmesine yönlendirin.

package/templates/musteri-ziyaret/files/one.data.json

@@ -0,0 +1,53 @@
+{
+  "version": 1,
+  "entities": {
+    "visits": {
+      "title": { "tr": "Müşteri ziyaretleri", "en": "Customer visits" },
+      "fields": {
+        "customer_code": { "type": "text", "title": { "tr": "Müşteri kodu", "en": "Customer code" }, "maxLength": 40, "index": true },
+        "customer_name": { "type": "text", "title": { "tr": "Müşteri", "en": "Customer" }, "required": true, "maxLength": 160 },
+        "customer_source": {
+          "type": "choice",
+          "title": { "tr": "Müşteri kaynağı", "en": "Customer source" },
+          "required": true,
+          "default": "manual",
+          "choices": [
+            { "value": "erp", "title": { "tr": "ERP müşteri listesi", "en": "ERP customer list" } },
+            { "value": "manual", "title": { "tr": "Elle girildi", "en": "Entered manually" } }
+          ]
+        },
+        "rep_org_id": { "type": "text", "title": { "tr": "Satış temsilcisi (kimlik)", "en": "Sales rep (id)" }, "maxLength": 24, "index": true },
+        "rep_name": { "type": "text", "title": { "tr": "Satış temsilcisi", "en": "Sales rep" }, "maxLength": 120 },
+        "visit_date": { "type": "date", "title": { "tr": "Ziyaret tarihi", "en": "Visit date" }, "required": true, "index": true },
+        "visit_type": {
+          "type": "choice",
+          "title": { "tr": "Görüşme türü", "en": "Contact type" },
+          "required": true,
+          "default": "visit",
+          "index": true,
+          "choices": [
+            { "value": "visit", "title": { "tr": "Ziyaret", "en": "Visit" } },
+            { "value": "phone", "title": { "tr": "Telefon", "en": "Phone" } },
+            { "value": "online", "title": { "tr": "Çevrimiçi", "en": "Online" } }
+          ]
+        },
+        "notes": { "type": "longText", "title": { "tr": "Görüşme notu", "en": "Notes" }, "maxLength": 4000 },
+        "outcome": {
+          "type": "choice",
+          "title": { "tr": "Sonuç", "en": "Outcome" },
+          "required": true,
+          "index": true,
+          "choices": [
+            { "value": "interested", "title": { "tr": "İlgileniyor", "en": "Interested" } },
+            { "value": "order", "title": { "tr": "Sipariş / anlaşma", "en": "Order / deal" } },
+            { "value": "follow_up", "title": { "tr": "Takip gerekiyor", "en": "Follow-up needed" } },
+            { "value": "no_interest", "title": { "tr": "İlgilenmiyor", "en": "Not interested" } }
+          ]
+        },
+        "next_step": { "type": "text", "title": { "tr": "Sonraki adım", "en": "Next step" }, "maxLength": 200 },
+        "next_step_date": { "type": "date", "title": { "tr": "Sonraki adım tarihi", "en": "Next step date" }, "index": true },
+        "next_step_done": { "type": "boolean", "title": { "tr": "Sonraki adım tamamlandı", "en": "Next step done" }, "required": true, "default": false }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,21 @@
+// Devoplus yapay zekâsının bu uygulamada çağırabileceği araçların İŞLEYİCİLERİ. Adı, açıklaması, girdi şeması,
+// salt-okunurluğu ve izni `one.manifest.json` → `agent.tools`'tadır; rehber `AGENT_GUIDE.md`'dir. Yeni araç = üçü birlikte.
+// Araçlar yalnız uygulamanın KENDİ veritabanını okur; ERP'ye gitmez. Ziyaret kaydeden ya da değiştiren araç bilinçli
+// olarak yoktur. `all` kapsamı ekranla aynı kuralla bütün ziyaretleri görme iznine bağlıdır.
+import { OneError, defineAgentTools, hasPermission } from '@devoplus/one-sdk'
+import type { Env } from './app.ts'
+import { overdueCount, upcomingSteps, weekSummary } from './queries.ts'
+import { MANAGE_PERMISSION } from './visit.ts'
+
+export const agentTools = defineAgentTools<Env>({
+  'weekly-visit-summary': {
+    handler: async ({ input, ctx, env }) => {
+      const scope = input.scope === 'all' ? 'all' : 'mine'
+      if (scope === 'all' && !hasPermission(ctx, MANAGE_PERMISSION))
+        throw new OneError(403, 'APP-E-403', 'Bütün ziyaretleri görmek için izniniz yok; yalnız kendi ziyaretlerinizi sorabilirsiniz.')
+      const owner = scope === 'all' ? null : (ctx.user?.sub ?? '')
+      const [week, upcoming, overdue] = await Promise.all([weekSummary(env, owner), upcomingSteps(env, owner, new Date(), 10), overdueCount(env, owner)])
+      return { scope, ...week, upcomingNextSteps: upcoming.map(({ id: _id, ...rest }) => rest), overdueNextSteps: overdue }
+    },
+  },
+})