empuno 1.2.0 → 1.4.0

package/README.md

@@ -55,6 +55,26 @@ komutu CLI güncellemesi olmadan görünür.
   `flash.created` ya da `redirect.params` içindedir.
 - Geçmiş veri aktarımı (`data-migration.*`) davet/e-posta/bildirim göndermez.
 
+## Başka sistemden geçiş
+
+Eski sistemin geçmişini JSON ya da Excel'den alınmış CSV ile taşıyın. Çalışan her
+satırda TC (`identity_number`), sicil no ya da `employee_id` ile belirtilir;
+tekrar çalıştırmak güvenlidir (aynı kayıt `skipped` döner).
+
+```bash
+empuno migrate employees calisanlar.csv --validate     # önce yazmadan doğrula
+empuno migrate employees calisanlar.csv                # ayrılmışlar dahil
+empuno migrate leaves izinler.csv
+empuno migrate advances avanslar.csv                   # devreden bakiye: deducted_amount
+empuno migrate expenses masraflar.csv
+empuno migrate payroll bordrolar.csv --decimal ,       # geçmiş bordro; 38.000,50 biçimi
+empuno migrate documents manifest.csv                  # file sütunu: dosya yolu
+```
+
+Geçmiş bordro tutarları yeniden hesaplanmaz, aynen saklanır; empuno sonraki ayı
+aktarılan kümülatif gelir vergisi matrahıyla devralır. Alanlar:
+`empuno describe data-migration.payroll.commit`.
+
 ## Talepler (empuno ekibine)
 
 Ajanınız yapamadığı bir işlemi, bir hatayı ya da geliştirme önerisini empuno

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.4.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,155 @@ 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 },
+  // Dönem sırasıyla gönderilir: aynı ayın bordroları aynı istekte kalır, kümülatif zincir aydan aya kurulur.
+  payroll: { path: '/manager/data-migration/payroll/commit', chunk: 300, sortBy: 'period' },
+};
+
+/** 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;
+  });
+}
+
+/** --decimal , : Türk dışa aktarımlarındaki 38.000,50 → 38000.50 (TC, tarih, sicil no dokunulmaz). */
+function commaDecimals(record) {
+  for (const [k, v] of Object.entries(record)) {
+    if (typeof v === 'string' && /^-?(\d{1,3}(\.\d{3})+|\d+)(,\d+)?$/.test(v) && /[.,]/.test(v)) record[k] = v.replace(/\./g, '').replace(',', '.');
+  }
+}
+
+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] [--decimal ,]
+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 raw = readRecordsFile(file);
+  if (opts.decimal === ',') raw.forEach(commaDecimals);
+  // Sıralanan türlerde sonuçtaki index yine dosyadaki sırayı gösterir.
+  const order = raw.map((_, i) => i);
+  if (spec.sortBy) order.sort((a, b) => String(raw[a][spec.sortBy] ?? '').localeCompare(String(raw[b][spec.sortBy] ?? '')) || a - b);
+  const records = order.map((i) => raw[i]);
+  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, indexes: order.slice(offset, offset + chunk.length), 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: order[offset + Number(row.index ?? 0)] });
+    if (r.periods) (summary.periods ??= []).push(...r.periods);
+    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 +1117,16 @@ 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
+  empuno migrate payroll bordrolar.csv                      # geçmiş bordro (müşavir değerleri aynen); kilitli 'ödendi' dönem + kümülatif GV matrahı
+  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 +1153,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 +1164,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 +1201,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.4.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": {