Lanjut ke konten
Samkarsa Logbook

MCP v1.0.0-034: Service-First Financial Summary & Real-World Procurement ROP Engine

Implementasi First-Class ReAct Tools untuk rekap finansial harian dan kalkulasi ROP riil operasional toko tanpa pelacakan stok unit di VibesChat.

1mnt baca

Pembaruan ini menuntaskan dua kelemahan krusial dalam penalaran VibesChat:

  1. Query Hijacking Fix: Menghapus manipulasi string kueri otomatis yang sebelumnya memaksa kueri umum seperti “berapa total pengeluaran belanja hari ini” menjadi terfokus sempit pada “beras” hanya karena riwayat obrolan sebelumnya menyebut beras.
  2. First-Class Deterministic Tools: Menyediakan dua tool deterministik tingkat pertama langsung di reactEngine.ts dan dynamicTools.ts yang selaras dengan arsitektur SEGR (Single Source of Truth) dan logika operasional toko sembako:

  • Menghitung pengeluaran riil harian dari mutasi jurnal PURCHASE, OPERATIONAL, EXPENSE berstatus POSTED.
  • Mengambil rincian faktur pembelian modal (kulakan) per supplier, metode bayar (Cash/Bank), total omset, surplus/defisit kas harian, dan posisi likuiditas kas & bank terkini.
  • Memahami ragam frasa informal/slang (seperti “duit keluar buat kulakan hari ini abis berapa ya” maupun “rekap belanja hari ini”).

  • Menghitung dinamika inventori untuk toko dengan mode is_maintenance_stock = false (tanpa pencatatan pengurang stok kasir eceran per unit).
  • Estimasi Stok & Kecepatan Konsumsi: Dihitung dari interval kulakan historis (Δt\Delta t), di mana pemesanan baru terjadi saat stok rak mencapai titik kritis 10% dari volume pembelian terakhir (Qbuffer=10%×QlastQ_{\text{buffer}} = 10\% \times Q_{\text{last}}).
  • Reorder Point (ROP) Riil: Dihitung dari: ROP=(Vharian×Lead Time)+Qbuffer\text{ROP} = (V_{\text{harian}} \times \text{Lead Time}) + Q_{\text{buffer}} Untuk Beras Premium Siip (ID 1), ROP riil menghasilkan 41 kg dengan buffer kritis 15 kg (lead time 1 hari dari supplier lokal Toko Beras Adi Rasa), bukan 120 kg dari rumus teoritis buta.
  • Tiered Pricing Resmi: Mengambil aturan harga bertingkat dari tabel tenant_pricing_rules (eceran <25kg vs partai ≥25kg) lengkap dengan persentase margin keuntungan terhadap HPP aktual.