empuno 1.3.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.3.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;
@@ -848,6 +848,8 @@ const MIGRATE_KINDS = {
   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. */
@@ -893,6 +895,13 @@ function parseCsv(text) {
   });
 }
 
+/** --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');
@@ -908,14 +917,19 @@ 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]
+    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 records = readRecordsFile(file);
+  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));
@@ -954,11 +968,12 @@ alanlar: empuno describe data-migration.${kind && MIGRATE_KINDS[kind] ? kind : '
     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 });
+      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: offset + Number(row.index ?? 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`);
   }
 
@@ -1109,6 +1124,7 @@ GEÇİŞ (başka sistemden geçmiş veri — JSON ya da CSV; davet/e-posta/bildi
   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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "empuno",
-  "version": "1.3.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": {