# AI Chatbot dan Enterprise Messenger - Sintesis Cluster ev-ai

**Sistem:** ERP Everest (PT Everest Electronic) - CodeIgniter 3.1.8 HMVC, PHP 5.6, MariaDB/MySQL
**Cluster sumber:** `ev-ai` - 4 berkas
**Tanggal dokumen sumber:** Agustus 2026 (blueprint messenger), tanpa tanggal eksplisit (roadmap AI, referensi jurnal, arsitektur RabbitMQ)

Dokumen ini adalah sintesis terpadu dari empat berkas cluster `ev-ai`: spesifikasi fitur dan roadmap AI Copilot, blueprint arsitektur Enterprise Messenger & AI Copilot Hub, referensi jurnal Scopus untuk chatbot ERP, serta blueprint arsitektur asynchronous stock opname berbasis RabbitMQ. Keempatnya disatukan karena seluruhnya membentuk satu rantai nilai: data transaksi dan stok (diolah lewat antrean RabbitMQ) menjadi bahan grounding untuk asisten AI, dan hasil AI disajikan lewat messenger internal yang juga menjadi kanal komunikasi antar cabang.

---

## 1. Ringkasan Eksekutif

1. **Everest AI Copilot adalah produk produksi, bukan eksperimen.** Sumber menyebut fitur live: persona korporat, 8 tool grounding deterministik terhadap data ERP riil, RBAC berlapis, audit trail di tabel `sys_ai_audit_trail`, sesi persisten per pengguna, dan session recovery otomatis saat server OpenCode restart.
2. **Grounding memakai database replika read-only.** Host replika `192.168.5.17:3306`, user `app_admin`, database `run_everest_modul`, replikasi realtime dari `11.100`. Tujuannya eksplisit: melindungi beban kasir. AI tidak boleh mengunci tabel transaksi.
3. **Inference berada di LAN, bukan cloud.** Gateway internal `192.168.5.10:4096` dengan model alias `BP-MGK` (model riil `big-pickle` via OpenCode), plus fallback cloud Groq/Gemini/OpenRouter/OpenAI dan sanitized error guard untuk mencegah kebocoran raw JSON.
4. **Enterprise Messenger menyatukan tiga fungsi dalam satu widget.** Asisten AI, komunikasi antar cabang (`chat_type = 'branch'`), dan direct message antar user (`chat_type = 'direct'`), dengan satu tabel `sys_chat_message` ber-skema polimorfik dan self-healing migration.
5. **Konsistensi produksi dicapai lewat scale-out, bukan scale-up.** Polling 1,5 detik dipaksa aman oleh `session_write_close()`; dedup bubble pesan via ID DOM `ev-msg-{id}`; proteksi iframe; audio chime dibangkitkan Web Audio API agar tidak membebani server.
6. **Master data chat dibuat multi-tenant tanpa mengubah kode.** Semua branding, fitur, dan engine LLM dipusatkan di `application/config/ai_chat.php`, termasuk toggle `use_db_replica` dan `features`.
7. **Referensi akademik mencoret arah roadmap.** Empat jurnal Scopus menjadi justifikasi: RAG penuh untuk sisi karyawan, hybrid model untuk CS, human-in-the-loop, dan skalabilitas multi-nasional.
8. **Pipeline stok sedang dirombak dari sinkron ke antrean.** Modul `1119` (Stock Opname) dimigrasikan ke RabbitMQ dengan tiga zona, staging buffer, chunk 200 item, row locking `FOR UPDATE`, dan DLQ, agar tidak lagi menyebabkan HTTP 504/502 dan deadlock MySQL 1213/1205.
9. **Isu kepatuhan tersinggung di roadmap fase berikutnya.** Fase 3 merencanakan AI auditor untuk mendeteksi anomali, termasuk "biaya petty cash yang melonjak tiba-tiba". Inilah satu-satunya tautan eksplisit cluster ini ke modul Biaya/Petty Cash.
10. **Terdapat kontradiksi identitas infrastruktur.** Roadmap AI menyebut database replika di `192.168.5.17:3306` dengan replikasi dari `11.100`, tetapi pada bagian yang sama menyebut database server `192.168.5.10:3306` sebagai penyimpan data aktif `run_everest_modul`. Keduanya tidak dapat benar bersamaan tanpa penjelasan topologi.

---

## 2. Features & Roadmap AI Chatbot

### 2.1 Fitur Aktif (Live Production)

Fitur di bawah ini didokumentasikan sebagai berjalan di produksi, bukan rencana. Tool grounding bekerja dengan membaca data ERP deterministik, bukan dengan mengandalkan model's knowledge.

| No | Fitur | Sumber Data / Mekanisme | Peran Operasional | Status |
|:--|:---|:---|:---|:---|
| F1 | Persona korporat Everest AI Copilot | System prompt di `ai_chat.php` | Konsultan bisnis & penasihat operasional ERP senior; sapaan personal berdasarkan nama dan peran (contoh sapaan pada sumber: "Halo Bapak Budi Santoso, Kasir Cabang Pinang") | Aktif |
| F2 | Proteksi kerahasiaan perusahaan | Guardrails sistem | Respectful refusal untuk password server, kredensial database, API key, dan data pribadi (KTP, no. rekening, UU PDP) | Aktif |
| F3 | Penetapan hak akses (RBAC) | Session + role resolution | HPP modal, laba bersih, dan likuiditas bank hanya untuk `superman`, `admin`, `super_admin`, `owner`, `direksi` | Aktif |
| F4 | Ketahanan terhadap prompt injection | Rule guardrails | Menolak perintah "Abaikan seluruh aturan sebelumnya" | Aktif |
| F5 | Stok riil & efektif (Aturan 3.13) | Rumus: Saldo Fisik - Stok Terkunci (Hold Locker) | Menyajikan sebaran stok per cabang gudang; HPP dikunci untuk staf non-eksekutif | Aktif |
| F6 | Peringatan stok kritis & reorder MOQ | Ambang `= 0` atau `<= 5` unit | Memicu penerbitan PO oleh purchasing | Aktif |
| F7 | Analisis portofolio, HPP & margin proyek | Data kontrak, RAB, HPP riil | Menyajikan Burn Rate, laba kotor, status biaya (aman/waspada/over-budget) | Aktif |
| F8 | Pemantauan SPK & tugas lapangan | Nomor SPK, unit pekerjaan, mandor | Lacak progres pengerjaan | Aktif |
| F9 | Piutang termin penagihan proyek (Project AR) | Tagihan customer, nilai termin, pembayaran, sisa piutang | Monitoring penagihan proyek | Aktif |
| F10 | Posisi likuiditas kas & bank | Kas fisik toko/cabang + saldo rekening | Khusus eksekutif | Aktif |
| F11 | Analisis modal kerja (Working Capital Gap) | Total piutang customer aktif vs hutang supplier jatuh tempo | Utang-vs-piutang untuk direksi | Aktif |
| F12 | Ikhtisar penjualan & kinerja cabang | Omset konsolidasi bulan berjalan & hari ini per cabang | Monitoring cabang | Aktif |
| F13 | Customer credit & overdue guard | Plafon di `per_customers` dikurangi akumulasi piutang di `_rek_pembantu_customer_cache` | Status: boleh kredit / mendekati limit / tahan order | Aktif |
| F14 | Deteksi stok macet (slow-moving & dead stock) | Inventori tanpa mutasi keluar `>= 90` hari | Estimasi modal tertahan (HPP) + saran promo/bundling | Aktif |
| F15 | Analisis transaksi aktif via `ref_transaksi` | Nomor/ID transaksi di layar staf | Evaluasi margin, cegah jual di bawah HPP | Aktif |
| F16 | Actionable deep-link transaksi | Tombol link cepat | `[Buat PO]`, `[Buka Master Customer]`, `[Buka Modul Stok]`, `[Buka Proyek]` | Aktif |
| F17 | Sesi persisten per pengguna | `$_SESSION['login']['ai_session_id']` + `opencode_native_session_id` | `POST /session/{id}/message` berulang; server OpenCode mengingat percakapan | Aktif |
| F18 | Auto-recovery & failover | Deteksi HTTP 404 sesi lama | Buat sesi baru, sematkan riwayat dari DB lokal agar konteks tidak terputus | Aktif |
| F19 | Multi-turn context (cloud provider) | `conversationTurns` dari `sys_chat_message` | OpenAI/Gemini mengingat topik sebelumnya | Aktif |
| F20 | Kontrol sesi pengguna | Tombol `[Sesi Baru]` dan slash command | `/reset`, `/new`, `/clear`, `/clearsession` | Aktif |
| F21 | Audit trail AI | Tabel `sys_ai_audit_trail` | Akuntabilitas penuh tiap interaksi | Aktif |
| F22 | Pengawasan audit via UI | Endpoint `Chat/ai_audit_trail` | Untuk Supervisor, Kantor Pusat, Admin, Eksekutif | Aktif |
| F23 | Prompt chips dinamis per role | Penyaringan server di `he_chat_helper.php` | Mencegah staf menerima tombol yang pasti Access Denied | Aktif |
| F24 | Mode senyap (stealth) eksekutif | `$_SESSION['login']['is_stealth']`, `per_employee.status_login` | Eksekutif bisa appear offline; tombol hanya dirender bila `cabang_id = -1` atau `is_admin = 1` | Aktif |

### 2.2 Matriks Prompt Chips Berdasarkan Peran

Sumber menyusun enam level. Ini adalah mekanisme "Zero Permission Denial UX": chip yang tidak sesuai role tidak pernah dirender, sehingga user tidak pernah melihat tombol yang pasti ditolak.

| Level | Peran | Prompt Chips yang Tersedia |
|:--|:---|:---|
| L1 | Eksekutif / Direksi / Owner / Super Admin | Kas & Bank, Omset Konsolidasi, Piutang vs Hutang, Cek Stok Barang, Stok Kritis, Stok Macet, Portofolio Proyek, SOP Batal/Retur |
| L2 | Supervisor / Manager / Kabag | Cek Stok Barang, Stok Kritis, Plafon Customer, Stok Macet, Rekap Penjualan, Status SPK Proyek (jika relevan), SOP Batal/Retur |
| L3 | Proyek & Mandor Lapangan | Status SPK Proyek, Cek Stok Material, Stok Kritis, SOP Distribusi Proyek |
| L4 | Gudang & Logistik / Purchasing | Cek Stok Barang, Stok Kritis (Reorder), Stok Macet (Dead Stock), SOP Batal/Retur, Penerimaan Barang |
| L5 | Keuangan & Pembukuan / Kasir | Plafon & Piutang, Cek Stok Barang, Stok Kritis, Stok Macet Gudang, SOP Batal/Retur, Alur Piutang |
| L6 | Sales & Staf Operasional | Cek Stok Barang, Plafon Customer, Stok Kritis, Stok Macet, SOP Batal/Retur, Ketentuan Diskon |

Resolusi peran bersifat multi-layer: tidak hanya kolom `jenis`, tetapi juga `employee_type`, `is_admin`, dan grup keanggotaan `membership` seperti `c_owner`, `root`, `superman`, `*_spv`, `*_mgr`, `c_finance`, `o_gudang`. Tujuannya sinkronisasi identitas antara audit trail dan sapaan personalisasi.

### 2.3 Skema Audit Trail `sys_ai_audit_trail`

Kolom yang didokumentasikan sebagai dicatat untuk setiap interaksi:

| Kolom | Isi | Nilai Diagnostik |
|:---|:---|:---|
| `session_id` | ID sesi percakapan unik per topik obrolan | Mengelompokkan percakapan |
| `user_id`, `user_name`, `user_jenis` | Identitas staf dan jabatannya | Keterlacakan aktor |
| `cabang_id`, `cabang_nama` | Lokasi unit kerja operasional | Pemisahan unit bisnis |
| `provider`, `model` | Mesin inferensi (BP-MGK, Groq, Gemini, dsb) | Menentukan engine pemanggil |
| `intent` | Kategori analisis bisnis terdeteksi (cek stok, plafon customer, likuiditas bank, dsb) | Klasifikasi query |
| `user_prompt` | Teks pertanyaan asli staf | Bukti audit |
| `ref_transaksi` | Dokumen transaksi ERP yang dilampirkan | Keterikatan ke dokumen riil |
| `grounding_data` | Rekaman data internal ERP yang diekstraksi dan diserahkan ke AI | Keterjujuran data |
| `ai_response` | Jawaban lengkap yang diberikan AI | Bukti output |
| `duration_seconds` | Kecepatan respons (dalam milidetik/detik) | SLA performa |
| `status`, `error_detail` | Status pemrosesan (success / error) | Deteksi kegagalan |
| `ip_address`, `user_agent` | Keamanan jaringan dan perangkat penanya | Forensik |
| `created_at` | Stempel waktu interaksi | Kronologi |

Keterangan sumber tidak menypesifikasikan primary key, indeks, atau skema retention tabel ini.

### 2.4 Roadmap 5 Fase

| Fase | Inisiatif | Mekanisme Inti | Nilai Bisnis | Output Contoh dari Sumber | Prioritas |
|:--|:---|:---|:---|:---|:---|
| 1 | Predictive Stock Run-Out | Laju penjualan rata-rata 30 hari dibagi sisa stok | Cegah kehabisan barang di tengah lead-time | "Stok AC Daikin 1 PK diprediksi habis dalam 6 hari. Buat PO sekarang." | Tinggi |
| 2 | Smart Product Substitution & Cross-Branch Finder | Pencarian barang pengganti dan stok cabang lain dengan spesifikasi watt/PK setara | Cegah lost sales di retail | AC Panasonic 1/2 PK kosong di Cabang Pinang, AI tunjuk stok cabang lain atau tipe alternatif (Sharp/Daikin) | Tinggi |
| 3 | Smart Audit & Anomaly Detection | AI auditor untuk direksi/audit internal; pindai transaksi harian mencurigakan | Fraud prevention | Nota dengan diskon di luar batas wajar sales, retur mencurigakan, **biaya petty cash yang melonjak tiba-tiba** | Tinggi |
| 4 | Agentic Action (Text-to-Transaction) | AI dari read-only menjadi read-write terkontrol; draf SO/PO dari chat | Percepatan input sales | "Buatkan draf SO Toko Sinar Jaya: 2 unit Daikin 1 PK tempo 30 hari" -> draf tinggal di-approve supervisor | Sedang (tertunda kontrol) |
| 5 | Knowledge Base Teknis, Garansi & Manual (RAG) | RAG atas PDF dokumen teknis pabrikan | Dukungan teknisi & CS | Arti kedip lampu AC inverter, error code, ketentuan kartu garansi | Sedang |

Catatan risiko: Fase 4 mengubah sifat sistem dari read-only menjadi read-write. Sumber tidak menyediakan rancangan kontrol kompensasi, kecuali "tinggal di-approve supervisor".

### 2.5 Evaluasi Infrastruktur MCP

| Aspek | Pernyataan Sumber |
|:---|:---|
| Kebutuhan hardware baru | "BISA 100%" - tanpa beli perangkat keras baru dan tanpa sewa cloud berbayar |
| Server AI lokal | `192.168.5.10` port `4096`, menjalankan OpenCode v1.17.20 yang built-in mendukung protokol MCP sebagai MCP Client |
| Database server | `192.168.5.10:3306`, menyimpan data aktif Everest ERP `run_everest_modul` |
| Web application server | Apache/PHP 5.6 CodeIgniter 3 di jaringan lokal yang sama |
| Komponen baru | Skrip `everest-mcp-server` berbasis Node.js atau Python di `192.168.5.10`, memakai SDK resmi `@modelcontextprotocol/sdk` |
| Konfigurasi | Blok MCP pada `opencode.json` di `192.168.5.10` |
| Fungsi yang didaftarkan | `cek_stok`, `cek_plafon`, `analisis_transaksi` |
| Keunggulan diklaim | 100% di LAN, nol biaya langganan bulanan API eksternal |

---

## 3. Arsitektur Enterprise Messenger & AI Chat

### 3.1 Batasan Teknologi (Blueprint Messenger Versi 2.0)

| Aspek | Ketentuan |
|:---|:---|
| Bahasa | PHP 5.6 murni; array wajib `array()` bukan `[]` |
| Larangan sintaks | Null coalescing `??`, arrow function `fn()`, anonymous class, scalar type hint |
| Framework | CodeIgniter 3.1.8 + Wiredesignz HMVC Extension |
| Database | MySQL / MariaDB, database `run_everest_modul` |
| Larangan database | MongoDB TIDAK DIGUNAKAN sama sekali untuk modul ini |
| Frontend | AdminLTE 2.3.11, Bootstrap 3.3.7, jQuery 2.2.3, FontAwesome, Web Audio API native |

### 3.2 Komponen dan Berkas

| Berkas | Peran |
|:---|:---|
| `application/config/ai_chat.php` | Konfigurasi provider AI, endpoint, model, dan API Key terpusat |
| `application/models/Mdls/MdlChat.php` | Model query MySQL: isolasi pesan, update status baca, query unread, daftar kontak |
| `application/controllers/Chat.php` | Controller gerbang AJAX, pembebasan lock sesi PHP (`session_write_close`), integrasi cURL ke LLM |
| `application/helpers/he_chat_helper.php` | Helper UI: markup CSS, HTML multi-tab messenger, dedup DOM, audio chime |
| `application/libraries/Layout.php` | Menginjeksi widget secara global ke seluruh halaman modul sebelum tag `</body>` |

### 3.3 Skema Tabel `sys_chat_message`

DDL lengkap sesuai blueprint. Kolom ini adalah tulang punggung seluruh fitur messenger.

| Kolom | Tipe | Default / Keterangan |
|:---|:---|:---|
| `id` | INT(11) | Primary key auto increment |
| `chat_type` | VARCHAR(20) | Default `branch`; nilai: branch, direct, ai |
| `sender_id` | INT(11) | ID user pengirim; 0 jika AI |
| `sender_name` | VARCHAR(100) | Nama staf pengirim / "Everest AI" |
| `sender_cabang_id` | INT(11) | ID cabang pengirim; -1 jika Pusat/AI |
| `sender_cabang_nama` | VARCHAR(100) | Nama cabang pengirim |
| `target_id` | INT(11) | Default 0; cabang ID / user ID / AI target ID |
| `target_name` | VARCHAR(100) | Default kosong; nama cabang atau user target |
| `cabang_id` | INT(11) | Default 0; kolom backward-compatible cabang |
| `message` | TEXT | Isi pesan teks |
| `ref_transaksi` | VARCHAR(100) | Default NULL; nomor dokumen referensi opsional |
| `is_read` | TINYINT(1) | Default 0; 0 belum dibaca, 1 sudah dibaca |
| `created_at` | DATETIME | Waktu pengiriman pesan |

Indeks: `idx_type_target` (`chat_type`, `target_id`, `id`), `idx_sender` (`sender_id`, `id`), `idx_created_at` (`created_at`). Engine InnoDB, charset utf8.

Mekanisme self-healing: `MdlChat.php` menjalankan `ensure_table_exists()` saat diinisialisasi, mengecek keberadaan tabel, dan otomatis menjalankan `ALTER TABLE` untuk menyuntikkan kolom `chat_type`, `target_id`, `target_name` bila tabel berasal dari rilis sebelumnya. Ini menghilangkan kebutuhan intervensi DBA.

### 3.4 Enam Solusi Masalah Teknis Inti

| No | Masalah | Solusi | Detail Teknis |
|:--|:---|:---|:---|
| 1 | Gelembung pesan muncul ganda | Deduplikasi mutlak | ID `id="ev-msg-" + m.id`; `appendMessageBubble()` return bila ID sudah ada di DOM; pelacakan kursor `lastMessageId = Math.max(lastMessageId, parseInt(m.id))` |
| 2 | Widget ter-render dua kali | Guard PHP | `static $is_rendered = false;` di `he_chat_helper.php` memastikan hanya satu output per siklus HTTP request |
| 3 | Widget muncul di dalam iframe | Guard JS | `if (window.self !== window.top)` menghapus elemen `#ev-chat-trigger` dan `#ev-chat-window` dari DOM iframe |
| 4 | Session lock contention pada polling cepat | Pembebasan lock sesi | `check_auth_ajax()` memanggil `session_write_close()` bila `session_status() === PHP_SESSION_ACTIVE`; polling berjalan paralel tanpa menghambat navigasi |
| 5 | Beban server untuk audio notifikasi | Web Audio API | Osilator native browser, frekuensi 880 Hz naik ke 1760 Hz dalam 0,12 detik (`exponentialRampToValueAtTime`) |
| 6 | Konteks transaksi hilang saat chat | Tombol klip | Scan URL atau input DOM untuk nomor transaksi format `xxxx.xxxxxxxx`; pesan memuat tautan aktif `renderCrossModulResumeLink()` |

Frekuensi polling: jendela terbuka 1,5 detik (1500 ms); jendela tertutup 3,0 detik (3000 ms) untuk refresh badge notifikasi.

### 3.5 Konfigurasi Provider AI

Skenario A (rekomendasi): Google Gemini, `model` = `gemini-1.5-flash` (sangat cepat dan hemat kuota), `endpoint` = `https://generativelanguage.googleapis.com/v1beta/models/`, `timeout` = 30.

Skenario B: OpenAI / ChatGPT, `model` = `gpt-4o-mini`, `openai_endpoint` = `https://api.openai.com/v1/chat/completions`, `timeout` = 30.

Perilaku degradasi: jika `api_key` kosong, bot memberikan panduan ramah untuk melengkapi konfigurasi tanpa galat atau crash.

Roadmap AI menambahkan opsi ketiga yang lebih maju: `provider` = `opencode`, `api_key` = `opencode:rahasia13`, `model` = `big-pickle` yang disajikan ke UI sebagai `BP-MGK`, `custom_endpoint` = `http://192.168.5.10:4096`.

### 3.6 Desain UI/UX Enterprise

| Aspek | Spesifikasi |
|:---|:---|
| Palet warna | Emerald & Slate, `#064e3b` hingga `#047857` |
| Latar | `#f8fafc`, sudut kartu 12px, kontras tipografi tinggi |
| Docking | Lebar awal 620px, tinggi 100vh |
| Resizer | Draggable left resizer, lebar 380px hingga 1200px / layar penuh |
| Expand | Dobel-klik atau tombol `[Expand]`: mode standar ~620px ke mode lebar ~55% lebar layar |
| Collapsible | Tombol `[Dock]` menyembunyikan daftar kontak memberi 100% lebar untuk baca dan ketik |
| Persistensi | Posisi dock, lebar, dan status ciut/buka tersimpan di `localStorage` per peramban |
| Quick actions | Hover pada bubble: `[Salin Pesan]` ke clipboard, `[Kutip Pesan]` menyematkan `> Pengirim: "teks"` ke input |
| Ekspor tabel AI | Tombol "Salin ke Excel" memakai format TSV agar paste sempurna ke Excel, Google Sheets, LibreOffice Calc |
| Urgent flagging | Tombol cepat lonceng atau `/urgent [pesan]`; nada dual-tone dan bingkai merah menyala |
| Smart Transaction Card | `ref_transaksi` dirender sebagai kartu interaktif dengan tombol "Resume Transaksi" membuka modal tanpa reload browser |

### 3.7 Multi-Tenant dan White-Label

Seluruh konfigurasi terpusat di `application/config/ai_chat.php`. Pemasangan ke klien baru tidak memerlukan perubahan kode PHP.

| Variabel | Default Pilot | Contoh Klien Baru (Logistik/FMCG) |
|:---|:---|:---|
| `company_name` | PT Everest Electronic | PT Nusantara Mandiri |
| `bot_name` | Everest AI Copilot | Nusantara AI Copilot |
| `bot_title` | Enterprise ERP Business Consultant | Senior ERP Supply Chain Consultant |
| `business_sector` | Perdagangan & Distribusi Elektronik | Distribusi Fast-Moving Consumer Goods (FMCG) |
| `greeting_salutation` | Bapak/Ibu | Bapak/Ibu / Rekan |

Infrastruktur:
- Klien dengan replika terpisah: `'use_db_replica' => true`, `'replica_db_group' => 'ai_replica'` yang dikonfigurasi di `application/config/database.php`.
- Klien single server: `'use_db_replica' => false`, AI membaca dari group `default` tanpa konfigurasi koneksi ganda.

Toggle fitur bisnis (`features`): `stock_check`, `customer_credit`, `slow_moving_stock`, `active_transaction_check`, `project_management`, `cash_bank_liquidity`, `working_capital`, `deep_links`. Contoh default menyertakan `project_management => false` untuk klien non-proyek.

### 3.8 Studi Kasus SAN Group: Rekomendasi Hierarchical Hub-and-Spoke

Tiga subdomain anak perusahaan yang disebut: `sarana.mayagrahakencana.com`, `sdl.mayagrahakencana.com`, `ppu.mayagrahakencana.com`, masing-masing dengan domain dan database MySQL terpisah (full multi-tenant isolation).

| Aspek | Opsi A: Terpisah | Opsi B: Dihubungkan Penuh | Opsi C: Hybrid (Rekomendasi) |
|:---|:---|:---|:---|
| Isolasi data legal & privasi | Sangat aman, nol risiko kebocoran nota antar PT | Berisiko tinggi, staf bisa salah kirim nota/harga modal antar PT | Sangat aman, pemisahan ketat di level staf operasional |
| Beban & kompleksitas database | Nol kompleksitas | Tinggi, butuh federasi lintas database | Terkontrol, jembatan hanya untuk otorisasi tertentu |
| Audit & kepatuhan pajak | Sangat bersih | Bisa bermasalah, jejak komunikasi antar entitas hukum memicu temuan transfer pricing | Sangat bersih, dokumen dan chat tetap independen per PT |
| Kebutuhan holding/direksi | Kurang praktis, direksi login ke tiap domain | Praktis, satu layar | Paling efisien, akses khusus koordinasi lintas anak perusahaan |

Rekomendasi final: "Default Terisolasi di Level Operasional Cabang, Terhubung Terkendali di Level Holding & Manajemen". Fase awal biarkan tiap anak perusahaan mandiri; fase lanjutan opsional menambah satu tabel jembatan `Federated Holding Chat` khusus supervisor ke atas.

### 3.9 Tata Kelola Presensi dan Mode Senyap

| Jenjang | Mode Senyap? | Indikator | Alasan |
|:---|:---:|:---|:---|
| Eksekutif / Direksi / Owner | Boleh toggle | Offline atau Online | Hindari serbuan chat non-urgent saat memeriksa laporan keuangan, rapat, atau buka ERP di luar jam kantor; pimpinan tetap memantau semua orang |
| Kepala Cabang & SPV Bagian | Tidak boleh invisible penuh | Online siaga / Offline | Manajemen Pusat wajib memantau kedisiplinan pimpinan cabang secara transparan |
| Staf Operasional (Kasir, Gudang, Admin) | Dilarang keras | Online / Offline otomatis | Akuntabilitas tugas transparan selama jam kerja; mencegah alasan "saya tidak buka ERP" saat ada koordinasi faktur atau stok mendesak |

Implementasi: `$_SESSION['login']['is_stealth']` (0 Online, 1 Senyap). Saat aktif, heartbeat di `Chat::check_auth_ajax()` mempertahankan `per_employee.status_login = '0'`, sehingga profil eksekutif tampil Offline atau "Aktif [Jam Lalu]". Keamanan toggle: tombol hanya dirender bila `cabang_id = -1` atau `is_admin = 1`; staf operasional hanya read-only presence.

### 3.10 Pemeliharaan dan Skalabilitas

1. Housekeeping: retensi pesan usang via cron job, contoh `DELETE FROM sys_chat_message WHERE created_at < NOW() - INTERVAL 180 DAY`.
2. Ekspansi grup/divisi: kolom `chat_type` dan `target_id` memungkinkan grup chat per divisi (misal Grup Keuangan, Grup Gudang).

---

## 4. Referensi Chatbot ERP

### 4.1 Empat Jurnal Scopus dan Fokus Integrasi ERP

| No | Judul | Penerbit / Indeks | Intisari | Fokus Integrasi ERP |
|:--|:---|:---|:---|:---|
| 1 | The appropriation of conversational AI in the workplace | Elsevier / ScienceDirect (Scopus Q1) | Adopsi internal conversational AI untuk produktivitas; akses dokumen, kebijakan, dan proses bisnis biaya rendah | Terhubung ke DMS dan Knowledge Management; berfungsi sebagai semantic search engine untuk SOP, kebijakan, instruksi kerja multibahasa |
| 2 | The Role of AI-Driven HR Chatbots in Enhancing Employee Experience and Organizational Efficiency | ResearchGate / Academic Publication (Scopus) | Otomatisasi kueri HR instan di bawah 2 menit; pengajuan cuti, rekap payroll, FAQ internal | Terhubung langsung ke HRIS/HRM via API untuk eksekusi aksi (transactional bots) |
| 3 | AI-Powered Chatbots in Organizations: A Systematic Literature Review | Journal of Information Systems and E-Business Management (Scopus) | Chatbot menyelesaikan 70-80% kueri rutin pelanggan 24/7; transisi mulus bot ke manusia (human-in-the-loop); integrasi sistem legacy/ERP | Terhubung ke CRM dan Ticketing System untuk otomatisasi triage kasus |
| 4 | Chatbots for ERP User Support Using AI | IEEE / ResearchGate (Scopus) | Arsitektur chatbot berbasis NLP modern (Transformer) untuk mengatasi kompleksitas dan kelambatan dukungan ERP skala besar | Blueprint teknis interaksi middleware AI dengan struktur tabel data ERP yang kompleks |

### 4.2 Matriks Perbandingan Arsitektur

| Parameter | Chatbot Karyawan Internal (HR/Ops) | Chatbot Customer Service (CRM/Sales) |
|:---|:---|:---|
| Integrasi utama modul ERP | HRIS, DMS, IT Helpdesk, Asset Management | CRM, Sales & Distribution, Logistics/Supply Chain |
| Keamanan data & privasi | Sangat ketat (RBAC); pembatasan berbasis peran; on-premise / private cloud LLM | Compliance publik (GDPR/UU PDP); enkripsi data in-transit dan at-rest |
| Pendekatan core AI | RAG penuh berbasis pangkalan data internal dan dokumen konfidensial | Hybrid model: LLM untuk FAQ dan deterministic API call untuk pengecekan status/transaksi |
| Metrik keberhasilan (KPI) | Penurunan handling time tiket IT/HR; tingkat adopsi mandiri (self-service rate) | Penurunan Customer Effort Score (CES); peningkatan First Contact Resolution (FCR); reduksi biaya CS |

### 4.3 Empat Pertanyaan Arsitektur untuk Agent AI

1. Desain pipeline RAG internal: bagaimana merancang RAG aman dengan perbandingan embedding (misal pgvector di PostgreSQL) agar data HRIS tidak bocor antar tingkatan jabatan.
2. Strategi integrasi API ERP: bagaimana membuat middleware API yang menjembatani LLM dengan modul CRM/Logistik untuk pelacakan status pesanan real-time tanpa membebani database utama ERP.
3. Mekanisme human-in-the-loop: arsitektur fallback dan state management ideal untuk mengalihkan chat dari bot CS ke agen manusia saat LLM mendeteksi sentimen negatif.
4. Strategi skalabilitas multinasional: satu LLM multibahasa global (misal GPT-4o) atau model lokal kecil (SLM) yang di-fine-tune per wilayah operasional negara.

Penerapan pada roadmap AI: Jurnal 1 dan 3 menjadi argumen untuk Fase 5 (RAG knowledge base) dan Fase 3 (smart audit). Jurnal 2 mendukung matriks RBAC dan transactional bot yang sudah aktif. Jurnal 4 paling dekat dengan implementasi blueprint.

---

## 5. Integrasi dengan RabbitMQ / Opname

Blueprint RabbitMQ mengubah proses penjurnalan dan pembaruan kartu stok modul Stock Opname `1119` dari model synchronous fat controller menjadi asynchronous message queue.

### 5.1 Masalah yang Diselesaikan

| Gejala | Detail Teknis |
|:---|:---|
| HTTP timeout | Nginx/Apache memutus koneksi (error 504/502) sebelum kalkulasi selesai |
| Deadlock database | MySQL error 1213 / 1205; transaksi database yang menggantung mengunci tabel persediaan sehingga kasir toko lain macet total |
| Data pincang | User menutup browser di tengah loading, sebagian data masuk sebagian gagal |

Beban lama pada `FollowUp.php` saat Approve 2 (transisi `1119ro` -> `1119`): menghitung mutasi saldo stok dan HPP untuk ribuan produk; transaksi `$this->db->trans_start()` berlangsung hingga ratusan detik; menulis jurnal, rekening, rekening_pembantu_produk; validasi neraca sinkron via `validateJurnal()` dan `validateAllBalances()`.

### 5.2 Tiga Zona Terisolasi

| Zona | Isi | Perilaku |
|:---|:---|:---|
| Zona 1: HTTP Browser | Klik Approve 2 -> `FollowUp.php doFollowup` -> simpan `transaksi` & `transaksi_data` -> `MdlOpnameStaging` tulis `so_headers_staging` & `so_items_staging` -> `Rabbitmq_publisher.php` publish event -> respon 200 OK | Respon kilat, kurang dari 1 detik |
| Zona 2: RabbitMQ Broker `192.168.5.14:5672` | Exchange `inventory.opname.x` (direct) routing key `opname.submitted` -> queue `inventory.opname.process.q` durable; gagal -> DLX `inventory.opname.dlx` -> DLQ `inventory.opname.failed.q` | Pesan persistent; DLX butuh durable |
| Zona 3: Worker Engine Daemon | `OpnameWorker.php` CLI daemon, prefetch 1; idempotency check; update status `PROCESSING`; loop batch 200 item dengan `trans_start` / `FOR UPDATE` / commit; finalisasi `status_next = complete` dan `so_headers_staging` = COMPLETED; `basic_ack` sukses, `basic_nack` gagal | Memo rendah, tidak mudah mati lampu |

### 5.3 Topologi RabbitMQ

| Parameter | Nilai |
|:---|:---|
| Host | `192.168.5.14`, port `5672` |
| Virtual Host | `/inventory` (terisolasi dari lalu lintas CRM/Sales) |
| Exchange | `inventory.opname.x`, tipe direct, durable |
| Routing Key | `opname.submitted` |
| Main Queue | `inventory.opname.process.q`, durable true |
| Dead Letter Exchange | `inventory.opname.dlx`, tipe direct, durable |
| Dead Letter Routing Key | `opname.failed` |
| Dead Letter Queue | `inventory.opname.failed.q`, durable true |
| Quality of Service | `prefetch_count = 1` agar server tidak kehabisan RAM |

Penjalankan daemon: `cd W:\rabbit_server` lalu `php index.php OpnameWorker start`. Log eksekusi dicatat ke console dan file log sistem.

### 5.4 Skema Database Staging

`so_headers_staging`: `id`, `transaksi_id` (indexed, unique), `booking_number`, `nomer_nota`, `cabang_id` dan `gudang_id`, `jenis_transaksi` (default `1119`), `status` (PENDING -> PROCESSING -> COMPLETED/FAILED), `retry_count`, `total_items`, `payload_checksum` (MD5 hash untuk validasi integritas payload), `created_at` dan `updated_at`.

`so_items_staging`: `id`, `header_staging_id`, `transaksi_id`, `produk_id` dan `produk_nama`, `qty_sistem`, `qty_fisik`, `qty_debet` (selisih lebih), `qty_kredit` (selisih kurang), `hpp_satuan`, `nilai_total`, `serial_numbers_json`, `status` (PENDING/PROCESSED/FAILED).

`so_audit_logs` (jejak audit kepatuhan ISO 27001): `id`, `header_staging_id` dan `transaksi_id`, `event_type` (SUBMITTED, WORKER_START, CHUNK_DONE, COMPLETED, DLQ_FAILED), `actor_type` (USER atau SYSTEM_WORKER), `actor_id`, `details`, `created_at`.

### 5.5 Aturan Jurnal Akuntansi Worker

Aturan jurnal Everest dipertahankan 100%; yang berubah adalah waktu dan konteks eksekusi.

| Kondisi | Debet | Kredit | Kartu Stok | Buku Pembantu |
|:---|:---|:---|:---|:---|
| Selisih lebih (+) | `1010030030` Persediaan Produk | `7010150` Laba Selisih Persediaan | Tambah saldo fisik di `locker_stock`, mutasi di `locker_stock_mutasi` | Debet ke `rekening_pembantu_produk` |
| Selisih kurang (-) | `7020020` Beban/Kerugian Selisih Persediaan | `1010030030` Persediaan Produk | Kurang saldo fisik di `locker_stock`, mutasi di `locker_stock_mutasi` | Kredit ke `rekening_pembantu_produk` |

Pola row-level locking:
```sql
SELECT id, jumlah FROM locker_stock
WHERE cabang_id = ? AND gudang_id = ? AND produk_id = ? AND state = 'active'
FOR UPDATE;
```
Tujuannya mencegah tabrakan saldo jika kasir POS menjual barang yang sedang disesuaikan.

### 5.6 Perbandingan Sebelum dan Sesudah

| Parameter | Sebelum (Synchronous HTTP) | Sesudah (RabbitMQ Asynchronous) |
|:---|:---|:---|
| Waktu tunggu browser | 30 s/d 180 detik, sering freeze/timeout | < 1 detik, respon instan |
| Beban memori HTTP | Rawan OOM (> 128MB per request) | Sangat ringan, hanya simpan staging |
| Risiko deadlock (1213) | Tinggi sekali, lock tabel puluhan detik | Nol/rendah, chunking batch 200 item |
| Ketahanan data mati lampu | Rawan rusak jika browser ditutup paksa | Aman, queue durable plus manual ACK |
| Kesiapan skalabilitas | Tidak bisa menangani opname multi-cabang serentak | Sangat siap, antrean otomatis terjadwal rapi |

### 5.7 Titik Temu Integrasi AI dan RabbitMQ

Blueprint RabbitMQ tidak menyebut AI. Namun secara arsitektural keduanya bertemu di dua titik: (a) `serial_numbers_json` pada `so_items_staging` adalah sumber data yang dapat di-query oleh dialog AI untuk validasi kelengkapan nomor seri; (b) Fase 1 roadmap AI (predictive stock run-out) akan menghasilkan sinyal permintaan yang berlawanan secara temporal dengan worker opname yang sedang mengurangi stok. Keduanya harus membaca dari database replika read-only, bukan dari master, untuk mencegah heartbeat AI memperlambat worker. Sumber tidak mendokumentasikan mekanisme koordinasi ini; statusnya "tidak dispesifikasikan di sumber".

---

## 6. Integrasi dengan Modul Biaya / Petty Cash

Cluster `ev-ai` hanya menyentuh modul Biaya/Petty Cash pada satu titik eksplisit. Tidak ada blueprint, konfigurasi, tabel, atau controller petty cash yang ditampilkan dalam empat berkas sumber. Ringkasan berikut secara jujur memisahkan apa yang ada dari apa yang tidak.

### 6.1 Satu-satunya Tautan Eksplisit

Roadmap Fase 3 (Smart Audit & Anomaly Detection) menyebut salah satu objek deteksi anomali adalah "biaya petty cash yang melonjak tiba-tiba". Konteksnya adalah AI auditor otomatis untuk direksi atau audit internal yang memindai transaksi harian mencurigakan, bersama diskon di luar batas wajar sales dan retur barang mencurigakan.

Implikasi arsitektural yang dapat ditarik secara aman: agar AI dapat mendeteksi anomali petty cash, data pengeluaran kas kecil harus dapat diakses grounding tool. Sumber tidak menentukan tabel mana yang menjadi sumber (kandidat yang tidak disebut adalah `komponen_biaya_details` atau tabel cache kas, yang tidak ada dalam cluster ini).

### 6.2 Aspek Kepatuhan Biaya pada Roadmap

| Aspek | Status dalam Sumber |
|:---|:---|
| Tabel petty cash | tidak dispesifikasikan di sumber |
| Controller petty cash | tidak dispesifikasikan di sumber |
| Nomor dokumen petty cash | tidak dispesifikasikan di sumber |
| Ambang batas lonjakan yang dipakai AI | tidak dispesifikasikan di sumber (tidak ada angka ambang dalam sumber) |
| Mekanisme persetujuan / budget petty cash | tidak dispesifikasikan di sumber |
| Keterkaitan dengan GL | tidak dispesifikasikan di sumber |

### 6.3 Keterkaitan Tidak Langsung yang Dapat Dibuktikan

1. **Jejak audit.** Tabel `so_audit_logs` yang dirancang untuk kepatuhan ISO 27001 pada alur opname menunjukkan pola yang bisa direplikasi untuk petty cash, namun tidak ada tabel audit log petty cash yang dispesifikasikan di sumber.
2. **Feature toggle.** `ai_chat.php` menyediakan pola `features` untuk mematikan kemampuan analitik sesuai modul yang dibeli klien. Saat ini tidak ada key `petty_cash` di daftar toggle yang terdokumentasi (`stock_check`, `customer_credit`, `slow_moving_stock`, `active_transaction_check`, `project_management`, `cash_bank_liquidity`, `working_capital`, `deep_links`).
3. **Rekomendasi umum yang berlaku.** Mempertahankan audit trail `sys_ai_audit_trail` dengan kolom `intent`, `grounding_data`, dan `status` memberi jejak yang dapat diaudit untuk setiap pertanyaan petty cash, memenuhi kebutuhan pembuktian internal mirip argumen yang dipakai pada cluster audit untuk serah terima barang.

---

## 7. Temuan Lintas-Dokumen dan Kontradiksi

### 7.1 Kontradiksi dan Inkonsistensi

| No | Topik | Klaim A | Klaim B | Dampak |
|:--|:---|:---|:---|:---|
| K1 | Host database aktif | Roadmap AI: replika read-only di `192.168.5.17:3306`, replikasi realtime dari `11.100`, user `app_admin` | Roadmap AI bagian MCP: database server `192.168.5.10:3306` menyimpan data aktif `run_everest_modul` | Konfigurasi `ai_chat.php` tidak punya satu host tunggal yang jelas; harus ditentukan mana master dan mana replika |
| K2 | Sumber data rincian item (`item_fields`) | Blueprint messenger: MongoDB TIDAK DIGUNAKAN sama sekali untuk modul ini | Blueprint migrasi history (cluster lain): rincian item diambil dari MongoDB / `transaksi_data_registry` step 9 | Bila engine `DatatablesHistory` dan engine chat sama-sama membaca `item_fields`, perbedaan sumber data dapat menimbulkan ketidakkonsistenan tampilan |
| K3 | Path codebase | Blueprint messenger dan roadmap AI: `W:\everest_13agus` | Dokumen lain dalam korpus: `W:\everest_10jul` (serial number issue) dan `Z:\everest_27jul` (audit score) | Versi kode yang dirujuk berbeda; status server pada blueprint bisa tidak berlaku pada checkout lain |
| K4 | Kolom status antrean opname | Blueprint RabbitMQ: `PENDING` sebagai status awal `so_headers_staging` | RANGKUMAN_QUERY (cluster audit): enum `QUEUED` sebagai status awal | Dua istilah untuk status yang sama pada tabel yang sama; worker harus tahu istilah mana yang dipakai |
| K5 | Checksum payload | Blueprint RabbitMQ: `payload_checksum` berisi MD5 | RANGKUMAN_QUERY: `payload_checksum` CHAR(64) dengan komentar SHA256 untuk idempotensi | MD5 (32 hex) tidak muat di CHAR(64) dengan asumsi SHA256 (64 hex); implementasi tidak konsisten |
| K6 | Nama kolom qty pada `so_items_staging` | Blueprint RabbitMQ: `qty_sistem`, `nilai_total`, `total_items` di header | RANGKUMAN_QUERY: `stok_sistem`, `total_nilai_selisih`, `total_item` | Nama kolom berbeda meskipun sama secara semantik; query worker harus memilih satu |
| K7 | Default toggle fitur | `features` memuat `project_management => false` | Fitur aktif F7, F8, F9 adalah analisis portofolio proyek, SPK, dan piutang termin proyek | Ada ketidakkonsistenan antara config default dan daftar fitur yang diklaim aktif |
| K8 | Skema audit trail AI | Tabel `sys_ai_audit_trail` disebut lengkap dengan 13 kolom | Tabel `sys_chat_message` juga menyimpan percakapan; tidak ada FK atau kolom pengait antara keduanya | Catatan privasi: penghapusan pesan (retensi 180 hari) tidak menghapus jejak di audit trail; ini mungkin disengaja untuk kepatuhan, tetapi retensi audit trail tidak dispesifikasikan |

### 7.2 Ketegangan Desain yang Tidak Bersifat Bug

1. **Read-only AI vs read-write roadmap.** Guardrails RBAC (F3) hanya berlaku pada operasi baca; Fase 4 mengubah AI menjadi read-write terkontrol. Diperlukan audit eksplisit "AI Action Audit" yang menandai setiap draf transaksi.
2. **Pemeliharaan vs pertumbuhan data.** Polling 1,5 detik dengan tabel durable akan cepat menjadi mahal. Housekeeping 180 hari membantu, tetapi pertumbuhan `sys_chat_message` per user aktif per detik perlu capacity planning yang tidak ada di sumber.
3. **Keamanan vs privasi.** Mode stealth kompatibel dengan tata kelola, tetapi heartbeat yang menahan `per_employee.status_login = '0'` membuat metrik realtime untuk UMP tidak kompatibel dengan audit aktual. Sumber tidak menjelaskan pengecualian ini.
4. **RabbitMQ prefetch=1 vs multi-cabang.** Prefetch 1 berarti satu worker memproses satu dokumen penuh sebelum berikutnya. Untuk skenario multi-cabang dengan banyak opname simultan, antrean akan menumpuk; sumber menyebut "sangat siap" tanpa menyebut kebutuhan scaling horizontal worker.

---

## 8. Lampiran Daftar File Sumber

| Nama File | Ukuran (byte) | Topik H1 | Peran |
|:---|---:|:---|:---|
| `AI_CHATBOT_FEATURES_AND_ROADMAP.md` | 34459 | EVEREST AI COPILOT: SPESIFIKASI FITUR & ROADMAP MASA DEPAN | Sumber utama. Mendefinisikan arsitektur infrastruktur AI (replika DB `192.168.5.17:3306`, gateway `192.168.5.10:4096`, alias `BP-MGK`), 24 fitur live production, matriks prompt chips 6 level, skema audit trail `sys_ai_audit_trail`, roadmap 5 fase, evaluasi MCP, panduan multi-tenant `ai_chat.php`, desain UI/UX, studi kasus SAN Group, dan tata kelola mode stealth. |
| `BLUEPRINT_ENTERPRISE_MESSENGER_AI_CHAT.md` | 10172 | BLUEPRINT ARSITEKTUR: ENTERPRISE MESSENGER & AI COPILOT HUB | Sumber arsitektur messenger. Menyertakan DDL lengkap `sys_chat_message` (15 kolom, 3 indeks), 5 berkas komponen, 6 solusi masalah teknis (dedup DOM, guard iframe, `session_write_close`, Web Audio API, konteks transaksi), konfigurasi provider Gemini/OpenAI, dan rencana housekeeping 180 hari. |
| `referensi_chatbot_erp.md` | 5106 | Blueprint & Referensi Jurnal Scopus: AI Chatbot untuk ERP Enterprise | Sumber literatur. Empat jurnal Scopus (Elsevier Q1, ResearchGate, Journal of Information Systems and E-Business Management, IEEE), matriks perbandingan arsitektur internal vs eksternal, dan empat pertanyaan diskusi arsitektur untuk agent AI. |
| `ARSITEKTUR_RABBITMQ_OPNAME.md` | 10302 | BLUEPRINT & BAGAN ARSITEKTUR: ASYNCHRONOUS STOCK OPNAME DENGAN RABBITMQ | Sumber infrastruktur antrean. Memindahkan modul `1119` dari fat controller sinkron ke RabbitMQ: tiga zona, topologi lengkap (`192.168.5.14:5672`, vhost `/inventory`, DLX/DLQ), skema tiga tabel staging, aturan jurnal selisih lebih/kurang dengan akun `1010030030`, `7010150`, `7020020`, dan tabel perbandingan sebelum-sesudah. |

Total: 4 berkas, 60.039 byte.