🤖 Standar Operasional Prosedur (SOP) Penggunaan Kecerdasan Buatan (AI) BUMDes

Dokumen ini merupakan pedoman resmi operasional bagi seluruh jajaran Pengurus BUMDes, Direktur, Manajer Unit Usaha, Kepala Divisi, hingga Tenaga Kasir/Operator lapangan dalam berinteraksi dan memanfaatkan teknologi Kecerdasan Buatan (Artificial Intelligence / Google Gemini) di dalam ekosistem ERP BUMDes.

---

1. Tujuan dan Ruang Lingkup#

Sistem AI di ERP BUMDes dirancang sebagai Asisten Pendukung Keputusan (Advisor) dan Eksekutor Terkendali (Action Executor) untuk meningkatkan efisiensi operasional dan akurasi bisnis desa.

Prinsip Utama: Human-in-the-Loop

1. Bukan Pengambil Keputusan Mutlak: AI tidak menggantikan pertimbangan dan tanggung jawab manajerial manusia. AI bertindak memberikan analisis, kalkulasi peramalan (forecasting), dan saran rekomendasi.
2. Kewenangan Final di Tangan Pengurus: Setiap tindakan finansial dan operasional yang diinisiasi oleh AI membutuhkan konfirmasi dan otorisasi manusia sebelum dieksekusi ke dalam basis data riil.
3. Akuntabilitas Audit: Semua interaksi dan instruksi yang dijalankan oleh AI terekam secara permanen di dalam Audit Trail Log sistem BUMDes.

---

2. Etika, Kepatuhan, dan Privasi Data (Data Privacy)#

Seluruh operator wajib menjaga kerahasiaan data desa dan warga saat menggunakan fitur AI interaktif (AI Chatbot):

🚫 Yang Dilarang Keras Diinput ke AI:

• Nomor Induk Kependudukan (NIK), Nomor KK, atau informasi biometrik warga desa secara eksplisit tanpa disamarkan.
• Kata Sandi (Password), PIN Kasir, API Key, Token Pembayaran, atau kredensial perbankan BUMDes.
• Informasi Konflik Pribadi/SARA atau penilaian subjektif di luar konteks tata kelola profesional unit usaha.

🛡️ Standar Kerahasiaan Data:

• AI BUMDes diatur untuk membaca data keuangan, stok, dan log siklus ternak secara terenkripsi di dalam batas (scope) unit usaha masing-masing melalui aturan Row-Level Security (RLS).
• Data internal BUMDes tidak digunakan oleh model publik untuk pelatihan (training) pihak ketiga di luar batas sistem ERP.

---

3. Panduan Berinteraksi & Prompting Efektif#

Untuk mendapatkan hasil analisis dan wawasan bisnis yang akurat dari AI Chatbot (Widget Pojok Kanan Bawah):

Format Prompt yang Disarankan:

Gunakan formula: [Konteks Unit] + [Data yang Dicari] + [Tujuan/Permintaan Analisis]

---

4. Protokol Eksekusi Tindakan Otomatis (Action Automation SOP)#

Fitur AI Action Automation memungkinkan sistem membuat dokumen resmi (seperti Draft Purchase Order atau Tugas Kerja Shift) hanya dengan satu klik pada tombol rekomendasi AI.

Alur Wajib Sebelum Menekan Tombol "Konfirmasi & Eksekusi":

1. Verifikasi Kuantitas & Harga: Cek angka estimasi yang tertera di kotak dialog konfirmasi (apakah kuantitas pakan/material sudah sesuai kapasitas gudang).
2. Periksa Unit & Sumber Pemasok: Pastikan rekomendasi mitra (Grosir Internal atau Supplier Luar) tidak bertentangan dengan kebijakan BUMDes.
3. Eksekusi & Navigasi Lanjutan:

• Klik tombol "Konfirmasi & Eksekusi".
• Tunggu status berubah menjadi "Berhasil Dieksekusi".
• Klik tautan notifikasi ("Lihat Draft PO" atau "Lihat Jadwal") untuk memeriksa kebenaran dokumen yang baru dibuat.

4. Persetujuan Final di Modul Terkait: Draft PO yang dibuat AI tetap memerlukan persetujuan (Approval) dari Direktur/Manajer Keuangan sebelum transaksi dana dicairkan.

---

5. Mitigasi Kesalahan AI (Penanganan Halusinasi & Anomali)#

Meskipun model AI BUMDes telah dilengkapi pagar pembatas (Guardrails), operator wajib mewaspadai potensi anomali (Hallucination):

Gejala Anomali AI:

• Saran angka pembelian yang melonjak tidak wajar (misal: merekomendasikan restock 100 ton padahal kapasitas gudang hanya 2 ton).
• Saran operasional yang bertentangan dengan Standar Teknis Peternakan / Pertanian (misal: menyarankan panen telur pada ayam yang belum cukup umur).

Prosedur Penanganan Jika Terjadi Anomali:

1. Batalkan Tindakan (Batal): Jangan menekan tombol konfirmasi jika saran mencurigakan.
2. Koreksi Data Master: Periksa apakah data inputan harian (log mortalitas, berat pakan, input kas) ada yang salah ketik (human error) yang menyebabkan AI salah menghitung.
3. Laporkan ke Tim Teknis/Admin: Tekan fitur pelaporan kendala atau hubungi Super Admin untuk menyegarkan memori analitik (cache purge).

---

6. Matriks Wewenang & Akses Fitur AI (RBAC 6 Klaster)#

ERP BUMDes menerapkan arsitektur otorisasi berbasis peran 6 klaster hierarkis (Role-Based Access Control):

• Mode Holding (Strategic & Audit Intelligence): Khusus Direktur, Dewan Pengawas (Kades & BPD), Bendahara Desa, dan Super Admin untuk memantau konsolidasi 25 unit usaha BUMDes.
• Mode Unit (Operational Intelligence): Khusus Manajer Unit & Kepala Sub-Unit yang secara otomatis terkunci (auto-scoped) pada unit usahanya masing-masing demi menjaga kerahasiaan dan integritas operasional.
• Mode Read-Only Audit: Khusus Dewan Pengawas dan Penasihat Desa untuk memeriksa kepatuhan tanpa merangkap sebagai eksekutor transaksi (Four-Eyes Principle).

6.1. Navigasi Buku Panduan Khusus Berdasarkan Peran (Field Manuals)

Untuk efektivitas dan kemudahan adopsi di lapangan, sistem menyediakan 6 modul panduan terpisah yang disesuaikan dengan wewenang masing-masing pihak:

1. 🛡️ Panduan AI Dewan Pengawas & Kepala Desa — Audit eksekutif, deteksi EWS, dan cetak Lembar Telaah Pengawasan Musdes (A4).
2. 🏛️ Panduan AI Bendahara Desa & Pendamping Desa — Pengawasan modal desa (akun 3-100), simulasi dividen PADes, analisis Altman Z-Score, dan draf jurnal penyesuaian audit.
3. 👑 Panduan AI Direksi & Pengurus Inti — Strategic Command Center 25 unit, simulasi Monte Carlo 1.000 iterasi, generator LPJ Musdes, dan otorisasi Action Cards.
4. 🏢 Panduan AI Manajer Unit Usaha — Asisten sektoral terisolasi (USP TrustScore, PAMSIMAS leak radar, Bio-safety peternakan, Retail dead stock, Sablon scrap reduksi).
5. 📱 Panduan Lapangan Praktis Operator & Kasir — Mobile-first & Hands-free: scan barcode POS, Smart Receipt OCR nota, AI Dokter Tanaman, AI Dokter Ternak (feses), dan dikte suara harian.
6. 👥 Panduan Layanan Publik Warga & Masyarakat — Akses Portal Warga, cek saldo wadiah, cek tagihan air PAMSIMAS, transparansi dividen desa, dan jaminan sensor PII privasi warga.

---

[!IMPORTANT] Peringatan Integritas & Isolasi Data: Manajer Unit dilarang mencoba mengakses atau meminta data unit bisnis lain melalui manipulasi parameter. AI telah diprogram dengan pengaman Row-Level Security (RLS) dan verifikasi sesi backend (resolveEnforcedUnitId) sehingga hanya menyajikan informasi yang relevan dengan unit tugas yang sah. Segala tindakan eksekusi data otomatis tercatat dalam Audit Trail sistem dan menjadi tanggung jawab pengguna akun.

---

7. SOP Penggunaan Global Floating AI Copilot & Interactive Action Cards#

7.1. Aksesibilitas Universal & Pintasan Keyboard

• Akses Fleksibel: Tombol AI Copilot melayang (floating button) tersedia di pojok kanan bawah pada seluruh halaman ERP BUMDes.
• Pintasan Keyboard (Alt + A): Pengguna dapat membuka dan menutup panel samping Copilot secara instan menggunakan kombinasi tombol keyboard Alt + A.
• Mode Expand (Perbesar Tampilan): Gunakan tombol maximize di header drawer untuk memperluas ruang baca hingga 720px ketika meninjau laporan keuangan atau inventori mendalam.

7.2. Pertanyaan Cepat Kontekstual (Ergonomic Quick Chips)

• Tombol pertanyaan cepat (Quick Chips) terletak tepat di atas kolom input teks dan otomatis beradaptasi dengan modul yang aktif:
• Modul Inventori: Rekomendasi restock barang kritis, estimasi habis stok, valuasi aset persediaan.
• Modul Jurnal & Kas: Posisi saldo kas & bank unit, arus kas harian, deteksi anomali biaya.
• Modul Peternakan: Analisis mortalitas siklus, FCR, evaluasi buffer pakan ternak.
• Modul Kasir/POS: Produk terlaris dan piutang pelanggan jatuh tempo.

7.3. Protokol Kartu Tindakan Interaktif (Interactive Action Cards v5.0)

AI Copilot v5.0 dapat menerbitkan kartu tindakan interaktif (Action Cards) di akhir responnya untuk mempermudah eksekusi operasional dengan prinsip Human-in-the-Loop:

• WhatsApp Sentinel ([ACTION:WA_SENTINEL]): Kartu hijau interaktif untuk mengirimkan pesan pengingat resmi WhatsApp 1-klik ke nomor nasabah pinjaman menunggak atau pelanggan iuran PAMSIMAS.
• Cetak Surat Peringatan Hukum ([ACTION:PRINT_LEGAL]): Kartu merah/oranye untuk membuka lembar siap cetak Surat Peringatan 1 (SP-1) bagi debitur berisiko kredit macet (Kol 2 s.d. Kol 5).
• Draf Jurnal Akuntansi Seimbang ([ACTION:DRAFT_JOURNAL]): Kartu indigo untuk menyusun draf baris debit dan kredit yang seimbang secara otomatis di modul jurnal umum.
• Draf Pengadaan Stok ([ACTION:DRAFT_PO]): Kartu amber untuk membuka formulir Purchase Order pengadaan barang inventori yang menyentuh ambang kritis safety stock.
• Cetak Lembar Telaah Eksekutif A4 ([ACTION:PRINT_REPORT]): Kartu emas resmi untuk membuka modal lembar telaah ber-kop surat BUMDes Bolulango (Desa Bandungan), lengkap dengan nomor registrasi dokumen resmi AI-EXP/..., butir rekomendasi strategis, dan blok tanda tangan formal 3 pihak (Pengkaji/Kepala Unit, Direktur Utama, Dewan Pengawas/Kades).
• Navigasi Modul Terpadu ([ACTION:NAVIGATE]): Kartu navigasi 1-klik untuk berpindah ke modul transaksi terkait (termasuk preservasi query path SOP di Pusat Bantuan).

[!NOTE] Menekan tombol pada Action Cards hanya mengarahkan ke form draf dan tidak melakukan mutasi database permanen secara otomatis tanpa persetujuan manual pengguna.

---

8. SOP Penggunaan Smart Receipt OCR & AI Auto-Journaling#

8.1. Alur Kerja Pemindaian Nota Fisik

1. Masuk ke halaman Keuangan → Jurnal Transaksi → Buat Jurnal Baru (/dashboard/keuangan/jurnal/buat).
2. Klik tombol "⚡ Pindai Nota AI (Smart OCR)" pada header form atau tautan cepat pada bagian lampiran bukti.
3. Unggah foto nota pengeluaran (format JPG/PNG/WEBP). Pastikan:

• Pencahayaan cukup terang dan teks tidak blur/buram.
• Nama toko/vendor, tanggal, rincian barang, dan nominal total terlihat utuh.

4. Sistem akan otomatis mengompres foto ke resolusi optimal dan mengirimkannya ke Gemini Vision Engine.

8.2. Verifikasi Hasil Ekstraksi & Akun COA (Double-Entry)

1. Periksa ringkasan hasil pembacaan AI di panel pratinjau:

• Nama Toko & Tanggal Transaksi
• Total Nominal Akhir
• Tingkat Keyakinan (Confidence Score) & Peringatan Anomali
• Usulan Baris Jurnal (Debit vs Kredit)

2. Klik tombol "Terapkan ke Formulir". AI akan otomatis mengisi kolom tanggal, deskripsi, baris akun debit/kredit yang seimbang (balance), serta menyematkan foto bukti.
3. Kewajiban Pengguna (Human-in-the-Loop):

• Pengguna wajib memeriksa kembali kesesuaian kode akun (misal: memastikan pengeluaran pakan masuk ke akun 5-1010 Beban Pakan Ternak).
• Pengguna menekan tombol "SIMPAN JURNAL" untuk mengesahkan transaksi ke buku besar.

[!WARNING] Larangan Nota Rekayasa / Fraud: Dilarang mengunggah nota palsu, nota ganda (duplicate claim), atau memanipulasi nominal. AI Vision dilengkapi algoritma Fraud & Anomaly Detection yang memverifikasi kesesuaian total belanja dengan rincian subtotal item. Segala data transaksi yang disimpan tercatat dalam Audit Trail dan dapat diaudit sewaktu-waktu oleh Tim Pengawas BUMDes & Inspektorat.

---

9. SOP Penggunaan Domain-Specific AI Operational Advisors#

BUMDes ERP menyediakan panel asisten operasional cerdas (AI Advisor) yang dipasang langsung di dashboard unit masing-masing. Setiap asisten terisolasi pada batas data unit yang bersangkutan (Row-Level Security).

9.1. Unit Konveksi & Sablon (Manufaktur)

• Akses Halaman: /dashboard/manufaktur
• Frekuensi Audit: Setiap kali ada penerbitan Work Order (SPK) baru atau pergantian shift produksi.
• Langkah Operasional:

1. Pantau kartu Estimasi Kain (Fabric Estimate) untuk mengetahui kebutuhan kilogram/meter bahan sebelum melakukan pemotongan (cutting).
2. Periksa Estimasi Pasta Tinta Sablon dan pastikan stok warna dasar (Putih, Hitam, Khusus) sudah dioplos minimal H-1 sebelum pencetakan.
3. Evaluasi Status Antrean & Bottleneck Station; alokasikan tenaga penjahit/penyablon tambahan jika stasiun kerja tertentu mengalami penumpukan.
4. Terapkan rekomendasi Reduksi Scrap (penyusunan marker digital) untuk menjaga efisiensi bahan di atas 95%.

9.2. Unit Pertanian & Ketahanan Pangan (Ketapang / Hortikultura Cabai)

• Akses Halaman: /dashboard/pertanian
• Frekuensi Audit: Rutin setiap awal pekan (Senin) atau pasca perubahan cuaca ekstrem (hujan lebat / kemarau panjang).
• Langkah Operasional:

1. Periksa Fase Tanam Terkini dan sesuaikan aplikasi pemupukan berimbang (dosis kocor NPK, KNO3, dan nutrisi organik cair/POC).
2. Tinjau Radar Risiko Hama & Penyakit; jika status menunjukkan MEDIUM atau HIGH, segera lakukan penyemprotan preventif (misal: pestisida nabati mimba/tembakau atau fungisida patek).
3. Lakukan inspeksi parit drainase bedengan sesuai Tips Cuaca & Irigasi untuk mencegah genangan air penyebab busuk akar.

9.3. Unit Air Bersih Desa (PAMSIMAS)

• Akses Halaman: /dashboard/layanan/pamsimas
• Frekuensi Audit: Setiap tanggal 1–5 saat pencatatan meteran air warga dan evaluasi penutupan buku bulanan.
• Langkah Operasional:

1. Periksa indikator Integritas Jaringan & Risiko Kebocoran Pipa (NORMAL, SUSPECT_LEAK, CRITICAL).
2. Telusuri daftar Anomali Konsumsi; jika ditemukan pelanggan dengan lonjakan >50% tidak wajar, tugaskan petugas lapangan mengecek kebocoran instalasi pipa rumah warga/toren air.
3. Tinjau Tingkat Kepatuhan Iuran (Billing Health); manfaatkan notifikasi reminder otomatis untuk menagih sisa tunggakan warga sebelum tanggal jatuh tempo (tanggal 20).

9.4. Unit Perdagangan & Retail (Toko Desa & POS)

• Akses Halaman: /dashboard/perdagangan
• Frekuensi Audit: 2 kali sepekan untuk rotasi stok dan setiap sebelum penerbitan Purchase Order (PO) belanja supplier.
• Langkah Operasional:

1. Pantau daftar Fast-Moving Products; buat draf Purchase Order segera jika stok telah menyentuh batas kritis (min stock alert).
2. Periksa daftar Dead Stock (>30 Hari); terapkan rekomendasi promo diskon atau bundling produk hemat untuk membebaskan modal kerja yang mengendap.
3. Susun penataan barang di rak toko sesuai saran Cross-Selling & Basket Affinity untuk mendongkrak nilai belanja rata-rata per transaksi warga.

---

10. SOP PENGGUNAAN COMPUTER VISION & AI DOKTER TANAMAN#

BUMDes ERP dilengkapi modul Computer Vision Suite yang mencakup pemindai kamera instan (Structured Barcode/QR Laser Scanner) dan kecerdasan visual multimodal (AI Plant Doctor).

10.1. Pemindai Barcode & QR Code Mobile

• Kasir POS (/dashboard/inventori/pos):

1. Klik ikon kamera barcode di sebelah bar pencarian atau gunakan scanner fisik.
2. Arahkan kamera HP ke barcode kemasan produk (EAN-13, UPC, Code-128).
3. Sistem memutar nada bip (Web Audio API) dan otomatis memasukkan produk ke keranjang kasir.

• Audit Stok Gudang (/dashboard/inventori/stok):

1. Klik tombol "📷 Scan Barcode" pada tabel stok.
2. Arahkan kamera ke label rak atau kemasan barang untuk memfilter dan memeriksa posisi fisik serta nilai aset.

• Pencatatan Meteran PAMSIMAS (/dashboard/layanan/pamsimas):

1. Petugas lapangan mengklik tombol "📷 Scan QR Pelanggan".
2. Arahkan kamera ke stiker kode QR di meteran air rumah warga.
3. Modal pencatatan konsumsi (Meter Capture) terbuka otomatis terisi nama dan ID pelanggan.

10.2. AI Dokter Tanaman & Diagnostik Hama Multimodal Vision

• Akses Halaman: /dashboard/pertanian dan /dashboard/pertanian/cabai
• Langkah Operasional:

1. Klik tombol "🩺 AI DOKTER TANAMAN (VISION)".
2. Arahkan kamera HP ke daun berbercak, buah busuk/patek, batang layu, atau serangga hama kebun.
3. Model multimodal Google Gemini 2.5 Flash Vision menganalisis pola lesi dan memberikan diagnosis klinis seketika:

• Tingkat Keparahan: LOW, MEDIUM, HIGH, atau CRITICAL.
• Resep Pengendalian Organik (Nabati): Bahan ramuan herbal (nimba, bawang putih, dll.), cara ekstraksi, dan jadwal semprot sore hari.
• Pengendalian Kimia Darurat: Bahan aktif terdaftar, dosis presisi, dan batas Pre-Harvest Interval (PHI).
• Langkah Pencegahan: Sanitasi kebun, perbaikan drainase, dan suplemen kalsium-boron.

4. Klik tombol "Catat ke Jurnal Perawatan Kebun" untuk mendokumentasikan tindakan ke buku log operasional unit.

---

11. SOP PENGGUNAAN FITUR VOICE AI (SPEECH-TO-TEXT & TEXT-TO-SPEECH)#

BUMDes ERP menyediakan fitur interaksi suara dua arah (Hands-free Voice AI Assistant) untuk memudahkan pengurus, petugas lapangan, dan petani berinteraksi dengan sistem tanpa perlu mengetik:

11.1. Voice Input (Dikte Suara / Speech-to-Text)

• Global AI Copilot (Alt + A):

1. Klik tombol mikrofon 🎙️ di samping kolom input chat AI Copilot.
2. Ucapkan pertanyaan Anda dalam bahasa Indonesia (misal: "Berapa laba bersih unit peternakan bulan ini?" atau "Apakah ada stok beras yang menipis?").
3. Suara akan otomatis dikonversi menjadi teks secara real-time.
4. Tekan Enter atau klik Kirim untuk menerima analisis AI.

• Jurnal Kegiatan Lapangan (/dashboard/jurnal-kegiatan/baru):

1. Klik tombol mikrofon pada kolom deskripsi aktivitas.
2. Diktekan laporan harian kandang/kebun (misal: "Pemberian pakan konsentrat 3 karung dan pembersihan kandang blok B selesai").

11.2. Audio Reader (Text-to-Speech / Narator AI)

• Dengarkan Jawaban AI Copilot:

1. Pada setiap kartu respons AI Copilot, klik ikon speaker 🔊 di samping waktu pesan.
2. AI akan membacakan rangkuman jawaban, analisis data, dan rekomendasi operasional dalam bahasa Indonesia yang bersih dan alami.
3. Klik ikon speaker merah ⏹️ untuk menghentikan narasi suara kapan saja.

• Dengarkan Resep AI Dokter Tanaman & Dokter Ternak:

1. Pada hasil diagnosis penyakit daun/buah atau feses unggas, klik tombol "🔊 Dengar Resep".
2. AI membacakan secara lisan nama patogen, ramuan herbal jamu probiotik, takaran dosis, jadwal pemberian, dan masa henti obat (withdrawal period) secara hands-free.

---

12. SOP AI DOKTER TERNAK & UNGGAS (MULTIMODAL VISION)#

12.1. Alur Pemeriksaan Klinis Feses & Unggas

1. Buka modul Sektor Peternakan (/dashboard/peternakan).
2. Klik tombol "🩺 AI Dokter Ternak (Vision)".
3. Ambil foto menggunakan kamera ponsel kandang atau unggah berkas foto:

• Sampel kotoran/feses ayam (feses berdarah koksidia, hijau kolera, putih kapur, berbusa).
• Kondisi fisik unggas (jengger pucat/kebiruan, mata berbusa snot, lendir hidung).

4. AI Gemini Multimodal Vision secara otomatis mengklasifikasikan patogen (Eimeria tenella, Avibacterium paragallinarum, dll.) dan tingkat keparahan.
5. Jalankan resep jamu temulawak kunyit probiotik atau pengobatan darurat, serta patuhi protokol karantina kandang jika berstatus CRITICAL.

---

13. SOP GENERATOR LPJ MUSDES & ARUS KAS PREDIKTIF#

13.1. Generator Laporan Pertanggungjawaban (LPJ Musdes)

1. Super Admin / Direktur Eksekutif membuka Kantor Pusat Holding (/dashboard).
2. Pilih Tahun Anggaran (TA) dan klik tombol "📑 LPJ Musdes".
3. Periksa sintesis opini audit AI, neraca SAK EMKM, dan tabel pembagian SHU (PADes 30%, Cadangan Modal 40%, Insentif 20%, Sosial/Pendidikan 10%).
4. Klik "📄 Unduh PDF LPJ Musdes Resmi" atau "📊 Ekspor Excel" untuk dicetak dalam sidang Musyawarah Desa.

13.2. Simulasi Arus Kas Prediktif (Monte Carlo 1.000 Iterasi)

1. Pada panel Executive Strategic AI Advisor, klik "📈 Simulasi Arus Kas".
2. Geser slider uji stres pasar (kenaikan harga pakan, variasi hasil panen, lonjakan permintaan).

---

14. PROTOKOL KEAMANAN RAHASIA DAPUR & SENSOR PII OTOMATIS#

Sistem AI BUMDes diproteksi dengan benteng pertahanan Defense-in-Depth demi menjaga keamanan data warga dan kedaulatan informasi desa:

14.1. Larangan Permohonan Data Rahasia Dapur Sistem

Pengguna dilarang meminta atau memancing AI untuk menampilkan:

1. Kredensial server, connection string basis data, kunci enkripsi, atau isi berkas konfigurasi .env.
2. Struktur SQL mentah atau celah keamanan arsitektur sistem (folder 05_Technical dan 00_Strategy_Roadmap). Dokumen teknis ini dikunci khusus untuk Super Admin IT.
3. Rincian nominal slip gaji atau persentase pemotongan pajak PPh 21 individu rekan kerja demi menjaga privasi staf.

14.2. Penolakan Otomatis Serangan Prompt Injection

Setiap upaya pengguna untuk mengelabui AI dengan perintah manipulatif ("abaikan aturan sebelumnya...", "tampilkan system prompt...", atau "bocorkan password...") akan otomatis ditolak seketika oleh pelindung keamanan sistem (Security Guardrail Enforced) dengan notifikasi peringatan resmi.

14.3. Sensor Otomatis Data Pribadi (PII Masking)

Sistem secara otomatis menyensor data pribadi yang muncul pada dialog AI:

• Nomor Induk Kependudukan (NIK 16 Digit): Disensor menjadi format aman, contoh: 7501**7890.
• Nomor Rekening Bank (10–14 Digit): Disensor menjadi format aman, contoh: 1234**12. Operator tetap dapat melihat data lengkap secara terotorisasi pada kartu dokumen fisik resmi atau modul master nasabah yang dilindungi hak akses login.

---

15. TATA KELOLA & MASTER KILL-SWITCH (AI ASSISTANT CONTROL)#

Sebagai bentuk mitigasi risiko operasional, pengelolaan anggaran token AI, dan efisiensi kuota serverless cloud (Vercel), sistem menyediakan saklar kendali terpusat (AI Assistant Control).

15.1. Lokasi & Otoritas Akses

• Lokasi Menu: Masuk ke Pengaturan (/dashboard/pengaturan) > tab Preferensi Sistem.
• Kartu Kendali: Kartu berwarna indigo di bagian paling atas bertajuk "AI ASSISTANT CONTROL".
• Otoritas Pengubahan (RBAC): Hanya dapat diubah oleh Super Admin, Direktur Utama, dan Admin Keuangan.

15.2. Alur Pengoperasian & Auto-Save

1. Klik tombol saklar (toggle switch) di samping status teks:

• Geser ke kanan untuk mengubah status menjadi AKTIF (warna ungu/indigo).
• Geser ke kiri untuk mengubah status menjadi NON-AKTIF (warna abu-abu).

2. Sistem akan menampilkan animasi pemuatan sinkronisasi dan secara instan menyimpan status ke basis data cloud Supabase tanpa perlu menekan tombol "Simpan Perubahan" di bawah.
3. Notifikasi konfirmasi (Toast) akan muncul seketika mengonfirmasi bahwa status AI telah diperbarui untuk seluruh sistem BUMDes.

15.3. Kondisi Operasional Saat AI Berstatus "NON-AKTIF"

Saat saklar disetel ke NON-AKTIF, sistem menerapkan protokol penghematan dan proteksi kuota secara menyeluruh:

1. Pemberhentian Panggilan Eksternal (0 Token & 0ms CPU): Seluruh fungsi yang terhubung ke Google Gemini langsung memutus sambungan dan beralih ke teks statis.
2. Fallback Otomatis Laporan Keuangan: Laporan Neraca, Laba Rugi, dan Arus Kas tidak lagi memicu analisis AI dinamis, melainkan langsung menggunakan teks narasi akuntansi baku standar SAK EP.
3. Penyembunyian Komponen: Ikon melayang Global AI Copilot (Alt + A) dan kartu Executive Strategic Advisor pada Dashboard Utama disembunyikan secara otomatis.
4. Penguncian Fitur Interaktif: Layar AI Analytics Hub, CaLK Copilot Drawer, dan SOP Copilot Modal menampilkan pemberitahuan bahwa asisten AI sedang dalam mode non-aktif.
5. Sinkronisasi Serempak Seluruh Perangkat: Pengaturan berlaku serentak untuk seluruh staf, pengurus, manajer unit usaha, dan kasir di semua perangkat laptop, komputer kasir, dan ponsel pintar.
6. Pencatatan Riwayat (Audit Trail): Setiap tindakan aktivasi dan penonaktifan saklar dicatat secara permanen pada tabel audit_logs sistem dengan kode aksi UPDATE_AI_CONTROL.

15.4. Skenario Kapan AI Harus Dinonaktifkan

Pengurus disarankan menonaktifkan AI pada situasi berikut:

• Penghematan Kuota Komputasi Akhir Bulan: Menghindari lonjakan komputasi serverless ketika kuota bulanan mendekati batas wajar.
• Audit Finansial Independen: Memastikan laporan keuangan hanya dibaca murni berdasarkan angka pembukuan akuntansi SAK EP tanpa narasi sintetis.
• Konektivitas Internet Desa Darurat: Mempercepat waktu pemuatan halaman dashboard saat jaringan internet desa mengalami gangguan atau menggunakan modem seluler terbatas.

---

Dokumen ini merupakan standar operasional resmi yang disahkan oleh Direktur BUMDes dan Dewan Pengawas Desa.