Lanjut ke konten
Samkarsa Logbook

Ketik untuk mencari…

↑↓untuk navigasi
Esc

Jualan v1.5.0-090: Structural Data Invariant Guardrail & Eliminasi Kerapuhan Keyword Parser

Refaktorisasi fundamental mesin parsing Sajen API & MCP Server: penerapan invarian struktural data item fisik untuk mengunci klasifikasi faktur pembelian tanpa hardcode.

1mnt baca

Pada versi sebelumnya, sistem parsing transaksi Smart Note dan OCR sering mengandalkan tumpukan frasa kata kunci (negative keyword lists / regex heuristics) untuk membedakan transaksi penjualan, operasional, dan uang muka (Customer Deposit). Pendekatan tersebut memiliki kelemahan arsitektural:

  1. Kerapuhan (Brittleness): Format nota baru atau variasi bahasa slang warung berisiko salah diklasifikasikan sebagai “Penerimaan” (Sales/Income) hanya karena terdeteksi kata umum seperti “Tanda Terima” atau “Kasir”.
  2. Benturan Aturan (Prompt Collision): Aturan Customer Deposit (DP) pada MCP Server terkadang menimpa nota faktur distributor yang mencantumkan nama varian produk yang mengandung singkatan tertentu.

Pembaruan v1.5.0-090 menggantikan ketergantungan kata kunci rapuh dengan Invarian Struktur Data (Structural Data Invariant) & Pemisahan Intent Bersih:

  • Prinsip Utama: Evaluasi keberadaan rincian barang fisik (len(items) > 0 dengan kuantitas dan harga satuan valid).
  • Deterministic Guardrail: Jika nota/teks memiliki rincian multi-item barang fisik dan bukan pengeluaran utilitas murni (seperti PLN/BBM), transaksi secara deterministik diklasifikasikan sebagai Pembelian Stok Dagangan (purchase), kebal terhadap bias kata pengantar penerimaan.

  • Aturan ke-16 disederhanakan: klasifikasi customer_deposit hanya diizinkan untuk transaksi setoran uang tunai/transfer tanpa rincian penyerahan fisik barang dagangan (items: []).

  • Alur antarmuka review interaktif tetap terjaga 100%. Pengguna tetap memiliki kontrol penuh untuk mengedit nama produk, kuantitas, harga, diskon, dan metode pembayaran sebelum menekan tombol simpan jurnal.

  • Service sajen-api dan sajen-worker telah di-rebuild dan di-deploy ke server VPS production.
  • Service mcp-backend-prod pada container mcp-server telah diperbarui dan berjalan normal (health: ok).