empuno 1.2.0 → 1.3.0

package/empuno.mjs

@@ -21,7 +21,7 @@ import os from 'node:os';
 import path from 'node:path';
 import crypto from 'node:crypto';
 
-const VERSION = '1.2.0'; // EMPUNO_CLI_VERSION — config/agent_api.php cli_version + package.json ile aynı tutulur
+const VERSION = '1.3.0'; // EMPUNO_CLI_VERSION — config/agent_api.php cli_version + package.json ile aynı tutulur
 const NPM_PACKAGE = 'empuno';
 const DEFAULT_URL = 'https://empuno.com';
 const CATALOG_TTL_MS = 10 * 60 * 1000;
@@ -840,6 +840,140 @@ async function cmdTickets(args) {
     }
 }
 
+// ─── geçiş (başka sistemden geçmiş verinin aktarımı) ─────────────────────────
+
+const MIGRATE_KINDS = {
+  employees: { path: '/manager/data-migration/employees/commit', chunk: 200 },
+  leaves: { path: '/manager/data-migration/leaves/commit', chunk: 500 },
+  advances: { path: '/manager/data-migration/advances/commit', chunk: 200 },
+  expenses: { path: '/manager/data-migration/expenses/commit', chunk: 200 },
+  documents: { path: '/manager/data-migration/documents/commit', chunk: 10 },
+};
+
+/** Basit CSV ayrıştırıcı: tırnak, "" kaçışı, ; ya da , ayırıcı (başlıktan seçilir), BOM. */
+function parseCsv(text) {
+  const src = text.replace(/^/, '');
+  const firstLine = src.split(/\r?\n/, 1)[0] || '';
+  const delim = (firstLine.match(/;/g) || []).length > (firstLine.match(/,/g) || []).length ? ';' : ',';
+  const rows = [];
+  let row = [];
+  let field = '';
+  let quoted = false;
+  for (let i = 0; i < src.length; i++) {
+    const c = src[i];
+    if (quoted) {
+      if (c === '"' && src[i + 1] === '"') { field += '"'; i++; }
+      else if (c === '"') quoted = false;
+      else field += c;
+      continue;
+    }
+    if (c === '"') quoted = true;
+    else if (c === delim) { row.push(field); field = ''; }
+    else if (c === '\n' || c === '\r') {
+      if (c === '\r' && src[i + 1] === '\n') i++;
+      row.push(field); field = '';
+      if (row.some((v) => v !== '')) rows.push(row);
+      row = [];
+    } else field += c;
+  }
+  row.push(field);
+  if (row.some((v) => v !== '')) rows.push(row);
+  const [header, ...data] = rows;
+  if (!header) return [];
+  const keys = header.map((h) => h.trim());
+  return data.map((cells) => {
+    const obj = {};
+    keys.forEach((k, idx) => {
+      const v = (cells[idx] ?? '').trim();
+      if (v === '' || !k) return;
+      // CSV değerleri metin kalır (TC, sicil no, telefon); yalnız mantıksal değerler çevrilir.
+      obj[k] = ['true', 'false'].includes(v.toLowerCase()) ? v.toLowerCase() === 'true' : v;
+    });
+    return obj;
+  });
+}
+
+function readRecordsFile(file) {
+  if (!fs.existsSync(file)) throw new UsageError(`dosya bulunamadı: ${file}`);
+  const text = fs.readFileSync(file, 'utf8');
+  if (/\.csv$/i.test(file)) return parseCsv(text);
+  let data;
+  try { data = JSON.parse(text); } catch (e) { throw new UsageError(`geçersiz JSON (${file}): ${e.message}`); }
+  const records = Array.isArray(data) ? data : data?.records;
+  if (!Array.isArray(records)) throw new UsageError('JSON bir dizi ya da {"records": [...]} olmalı');
+  return records;
+}
+
+async function cmdMigrate(args) {
+  const { flags, fields, positional } = args;
+  const [kind, file] = positional;
+  if (!kind || !MIGRATE_KINDS[kind] || !file) {
+    throw new UsageError(`kullanım: empuno migrate <${Object.keys(MIGRATE_KINDS).join('|')}> <kayitlar.json|.csv> [--validate] [--on_existing update] [--employee_id N] [--chunk N]
+alanlar: empuno describe data-migration.${kind && MIGRATE_KINDS[kind] ? kind : 'employees'}.commit · rehber: https://empuno.com/api-docs/agent#gecis`);
+  }
+  const auth = resolveAuth(flags);
+  requireKey(auth);
+  const opts = fieldMap(fields);
+  const spec = MIGRATE_KINDS[kind];
+  const records = readRecordsFile(file);
+  const chunkSize = Math.max(1, Math.min(Number(opts.chunk) || spec.chunk, spec.chunk));
+  const validate = Boolean(flags.validate);
+  const baseDir = path.dirname(path.resolve(file));
+
+  const summary = { kind, file, dry_run: validate, records: records.length, created: 0, updated: 0, skipped: 0, failed: 0, results: [] };
+
+  for (let offset = 0; offset < records.length; offset += chunkSize) {
+    const chunk = records.slice(offset, offset + chunkSize);
+    let response;
+
+    if (kind === 'documents') {
+      const files = [];
+      const manifest = chunk.map((entry, i) => {
+        const filePath = path.resolve(baseDir, String(entry.file ?? ''));
+        files.push({ field: 'files[]', file: filePath });
+        return { ...entry, file: i };
+      });
+      for (const f of files) if (!fs.existsSync(f.file)) throw new UsageError(`dosya bulunamadı: ${f.file}`);
+      response = await request(auth, 'POST', spec.path, {
+        body: { manifest: JSON.stringify(manifest), ...(validate ? { dry_run: 1 } : {}) },
+        files,
+        dryRun: flags['dry-run'],
+      });
+    } else {
+      const body = { records: chunk, ...(validate ? { dry_run: true } : {}) };
+      if (opts.on_existing) body.on_existing = String(opts.on_existing);
+      if (opts.employee_id) body.employee_id = Number(opts.employee_id);
+      response = await request(auth, 'POST', spec.path, { body, dryRun: flags['dry-run'] });
+    }
+
+    if (response.dryRun) {
+      print(response.result);
+      return 0;
+    }
+    const r = response.result || {};
+    if (!response.ok) {
+      // Doğrulama hatası (422) tüm parçayı etkiler: sunucunun errors'ını kayıt indeksine çevir.
+      summary.failed += chunk.length;
+      summary.results.push({ chunk_offset: offset, action: 'failed', status: response.status, message: r.message, errors: r.errors });
+      continue;
+    }
+    for (const key of ['created', 'updated', 'skipped', 'failed']) summary[key] += Number(r[key] || 0);
+    for (const row of r.results || []) summary.results.push({ ...row, index: offset + Number(row.index ?? 0) });
+    if (isTTY) warn(`${Math.min(offset + chunkSize, records.length)}/${records.length} işlendi`);
+  }
+
+  summary.message = `${summary.created} ${validate ? 'eklenecek' : 'eklendi'}, ${summary.updated} güncellen${validate ? 'ecek' : 'di'}, ${summary.skipped} atlandı, ${summary.failed} hatalı${validate ? ' (doğrulama — hiçbir şey yazılmadı)' : ''}`;
+  if (wantsText()) {
+    process.stdout.write(`${summary.message}\n`);
+    for (const row of summary.results.filter((x) => x.action === 'failed')) {
+      process.stdout.write(`  ✗ #${row.index ?? row.chunk_offset}: ${row.reason || row.message || ''}${row.errors ? ' ' + JSON.stringify(row.errors) : ''}\n`);
+    }
+  } else {
+    print(summary);
+  }
+  return summary.failed > 0 ? 1 : 0;
+}
+
 // ─── destek (yalnız empuno ekibinin ajanları — emp_staff_ jetonu) ────────────
 
 function requireStaff(auth) {
@@ -968,6 +1102,15 @@ ALANLAR
   --alan @./dosya.pdf | --file alan=./dosya.pdf   # multipart yükleme
   --query anahtar=değer              # yazma isteğinde ek sorgu parametresi
 
+GEÇİŞ (başka sistemden geçmiş veri — JSON ya da CSV; davet/e-posta/bildirim gitmez; tekrar çalıştırmak güvenli)
+  empuno migrate employees calisanlar.csv --validate        # önce yazmadan doğrula
+  empuno migrate employees calisanlar.csv [--on_existing update]   # ayrılmışlar dahil; TC ile eşler
+  empuno migrate leaves izinler.json                        # her satırda identity_number|employee_number + leave_type
+  empuno migrate advances avanslar.csv                      # geçmiş avans + devreden bakiye (deducted_amount)
+  empuno migrate expenses masraflar.csv                     # ödenmiş geçmiş masraf (kategori adla)
+  empuno migrate documents manifest.csv                     # file sütunu: dosya yolu; ≤10'arlı gönderilir
+  alanlar: empuno describe data-migration.<tür>.commit · sıra: çalışanlar → izin → avans → masraf → evrak
+
 TALEPLER (geliştirme isteği, hata, eleştiri, soru → empuno ekibi)
   empuno tickets [--status active|open|answered|closed|all] [--unread] [--mine]
   empuno tickets open "Toplu izin onayı" --kind feature --body "…"|@not.md [--priority high] [--command leave-requests.approve]
@@ -994,8 +1137,9 @@ BELGE: https://empuno.com/api-docs/agent
 
 async function main() {
     const argv = process.argv.slice(2);
-    const ticketish = ['tickets', 'ticket', 'support'].includes(argv.find((a) => !a.startsWith('--')) ?? '');
-    const args = parseArgs(argv, ticketish ? ['mine', 'unread', 'close', 'token-stdin'] : []);
+    const sub0 = argv.find((a) => !a.startsWith('--')) ?? '';
+    const ticketish = ['tickets', 'ticket', 'support'].includes(sub0);
+    const args = parseArgs(argv, ticketish ? ['mine', 'unread', 'close', 'token-stdin'] : sub0 === 'migrate' ? ['validate'] : []);
     const [sub, ...rest] = args.positional;
     args.positional = rest;
 
@@ -1004,7 +1148,7 @@ async function main() {
         return 0;
     }
     if (args.flags.help) {
-        if (['tickets', 'ticket', 'support', 'login', 'commands', 'describe', 'call', 'api'].includes(sub)) {
+        if (['tickets', 'ticket', 'support', 'login', 'commands', 'describe', 'call', 'api', 'migrate', 'reference'].includes(sub)) {
             process.stdout.write(HELP);
             return 0;
         }
@@ -1041,6 +1185,8 @@ async function main() {
         case 'reference':
         case 'ref':
             return cmdReference(args);
+        case 'migrate':
+            return cmdMigrate(args);
         case 'support':
             return cmdSupport(args);
         case 'run':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "empuno",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "empuno İK platformunun komut satırı: yönetim panelindeki tüm işlemleri (izin, bordro, vardiya, PDKS, zimmet, masraf, işe alım) yapay zekâ ajanlarına ve otomasyonlara açar.",
   "type": "module",
   "bin": {