📘 Standarisasi Pendokumentasian Sistem ERP BUMDes

Nomor Pedoman: STD/BUMDES/DOC/001-MASTER Klasifikasi: Pedoman Tata Kelola Pengetahuan & Arsitektur Dokumentasi (Grand Standard) Tingkat Dokumen: Payung Hukum Tertinggi (Single Source of Truth) Sasaran Pengguna: Direksi, Dewan Pengawas, Kepala Unit Usaha, Tim Pengembang IT, Auditor Internal/Eksternal, dan AI Coding Assistant Tanggal Berlaku: 13 September 2026 Status Kepatuhan: Wajib (Mandatory) untuk seluruh modul, unit usaha, dan sub-holding

---

1. Visi, Landasan Yuridis & Filosofi Tata Kelola Pengetahuan#

1.1 Visi Dokumentasi Desa Kelas Dunia

Dokumentasi pada sistem ERP BUMDes bukan sekadar arsip statis pelengkap teknis, melainkan aset strategis pengetahuan (Knowledge Asset) dan instrumen pertanggungjawaban publik yang menjamin transparansi, transfer keahlian tanpa ketergantungan individu (no single point of failure), serta kelangsungan operasional lintas generasi kepengurusan desa.

1.2 Landasan Yuridis & Regulasi Nasional

Penyusunan standar dokumentasi ini bersandar pada:

1. Undang-Undang No. 6 Tahun 2014 tentang Desa (Transparansi & Akuntabilitas Aset Desa).
2. Peraturan Pemerintah (PP) No. 11 Tahun 2021 tentang Badan Usaha Milik Desa (Tata Kelola Korporasi Desa & Standar Laporan Pertanggungjawaban Musyawarah Desa).
3. Standar Akuntansi Keuangan Entitas Privat (SAK EP 2025/2026) (Standar Baku Pelaporan Keuangan dan Isolasi Transaksi Antar-Entitas).
4. Pedoman Standar Emas BUMDes ERP (docs/STANDAR_EMAS_BUMDES.md).

1.3 Empat Pilar Standar Dokumentasi

1. Ketunggalan Sumber Kebenaran (Single Source of Truth / SSOT): Satu konsep, proses bisnis, atau akun akuntansi hanya memiliki satu definisi otoritatif di sistem dokumentasi.
2. Keterbacaan Universal (Universal Readability): Dokumen operasional harus mudah dipahami oleh pengurus desa, kasir lapangan, peternak, auditor pemerintah, hingga mesin asisten kecerdasan buatan (AI Copilot).
3. Penyelarasan Finansial Presisi (Zero-Overlap Financial Mapping): Setiap proses operasional unit wajib terhubung langsung ke kode akun akuntansi SAK EP yang baku tanpa saling tumpang tindih.
4. Kesiapan Audit (Audit-Readiness): Setiap SOP dilengkapi formulir kendali mutu, rekaman verifikasi lapangan, lembar pengesahan formal tiga pihak, serta stiker verifikasi identitas fisik (QR Code).

---

2. Struktur Hierarki Direktori Dokumen#

Seluruh berkas dokumentasi sistem ERP disimpan dalam repositori docs/ dengan klasifikasi folder hierarkis yang ketat:

text
docs/
├── 00_Strategy_Roadmap/ # Visi jangka panjang, AD/ART, profil holding, master roadmap, audit tahunan
├── 01_Fundamentals/ # Pedoman dasar sistem, tata kelola umum, peran AI, dan standar penulisan ini
│ └── 01_Panduan_Peran_AI/ # Panduan operasional asisten AI untuk 6 profil pengguna desa
├── 02_Procurement/ # Tata kelola pengadaan barang/jasa, vendor, dan logistik gudang utama
├── 03_Operational/ # Master dokumen operasional 21+ unit usaha komersial mandiri
│ ├── 01_Peternakan/ # Unit Ayam Layer & Broiler (Komersial Holding)
│ ├── 02_Penggemukan_Sapi/ # Unit Ternak Sapi Potong
│ ├── 03_Pabrik_Pakan/ # Unit Pakan Mandiri BUMDes
│ ├── ... # Unit-unit usaha operasional lainnya
│ ├── 19_Unit_Kuliner/ # Unit Kuliner & Pujasera Desa
│ ├── 20_Penyewaan_Alat_Pesta/ # Unit Sewa Tenda & Peralatan Pesta
│ └── 21_Persampahan_TPS3R/ # Unit Pengolahan Sampah & TPS3R Sirkular
├── 04_Financial/ # Bagan Akun Standar (COA SAK EP), konsolidasi, audit foto kas kecil, pajak
│ ├── 01_Grand_Design/ # Arsitektur finansial, double-entry engine, anti-fraud 3-foto
│ ├── 02_Panduan_Operasional/# SOP pembukuan, buku besar, rekonsiliasi bank, dividen SHU
│ ├── 03_Laporan_Audit/ # Kertas kerja audit fisik kas kecil, stok, dan anggaran
│ ├── 04_LPJ_Tahunan/ # Dokumen pertanggungjawaban Musdes tahunan
│ └── 05_Perpajakan/ # Manual kepatuhan pajak (PPh 21 TER, PPh 23, PPN, PBJT)
├── 05_Technical/ # Spesifikasi arsitektur DDD, database RLS, performa CMS, UI system
├── 06_SubHolding_Ketapang/ # Klaster ekosistem agro-maritim khusus Ketahanan Pangan (20% Dana Desa)
├── 07_SaaS_Architecture/ # Multi-tenancy, isolasi data antar-desa (Khusus Tim Teknis / Super Admin)
└── _arsip/ # Berkas dokumen kadaluarsa/usang (OTOMATIS DIABAIKAN MESIN SISTEM)

[!CAUTION] Larangan Berkas Lepas di Root docs/: Dilarang keras membuat berkas dokumentasi baru langsung di dalam root docs/, kecuali berkas katalog master sistem: INDEX.md, STANDAR_EMAS_BUMDES.md, dan ONBOARDING.md. Semua berkas operasional dan teknis wajib masuk ke sub-direktori yang relevan.

---

3. Standar Penomoran & Nomenklatur Unit Operasional#

3.1 Aturan Penomoran Folder Unit (docs/03_Operational/)

Untuk memastikan urutan dokumen teratur dan tidak terjadi tabrakan nama, setiap folder unit usaha di dalam docs/03_Operational/ wajib mengikuti aturan berikut:

1. Format Penamaan Folder: [Nomor_Urut]_[Nama_Unit]

• Nomor urut terdiri dari 2 digit angka (01_, 02_, ..., 21_, 22_).
• Nama unit menggunakan huruf kapital di awal kata (PascalCase/CamelCase) dan dipisahkan garis bawah (_), tanpa spasi dan karakter simbolik.

2. Pengecekan Nomor Terakhir (Collision Prevention):

• Sebelum membuat unit baru, periksa seluruh folder yang ada di docs/03_Operational/.
• Lanjutkan nomor urut tertinggi berikutnya tanpa melompati angka.

3. Pemisahan Unit Usaha vs Dokumen Modul Sistem:

• Folder di 03_Operational dikhususkan bagi unit bisnis riil penghasil pendapatan (revenue center / cost center).
• Dokumen aktivitas sistemik non-unit (seperti pencatatan harian logistik umum) dilarang menggunakan nomor urut unit yang berpotensi bentrok. Contoh: Dokumen jurnal kegiatan ditempatkan sebagai sub-folder fungsional atau menggunakan penomoran khusus agar tidak bentrok dengan penomoran unit komersial.

3.2 Aturan Nama Berkas Markdown (File Naming)

1. Wajib menggunakan huruf kapital penuh dan pemisah garis bawah: NAMA_DOKUMEN_SPESIFIK.md.
2. Dilarang menggunakan spasi, tanda kurung (), titik ganda, atau simbol karakter seperti @, #, $, %, &.
3. Gunakan awalan jenis dokumen yang deskriptif:

• 01_BLUEPRINT_OPERASIONAL.md
• 02_AKUNTANSI_[NAMA_UNIT].md
• SOP_[NAMA_PROSEDUR].md
• MANUAL_[NAMA_PANDUAN].md

---

4. Standar Metadata YAML Frontmatter Wajib#

Setiap berkas markdown di repositori ERP BUMDes wajib memiliki blok YAML Frontmatter pada baris pertama berkas:

yaml
---
title: SOP Penimbangan dan Grading Bahan Baku Pakan
description: Prosedur operasional penerimaan jagung, dedak, dan konsentrat dengan uji kadar air dan refraksi timbangan.
access: authenticated
allowedRoles: ['super_admin', 'admin_keuangan', 'kepala_unit', 'operator']
unit: Unit Pabrik Pakan
category: Panduan Operasional
lastUpdated: 2026-09-13
version: 2.1.0
---

4.1 Spesifikasi Atribut Frontmatter

4.2 Matriks Akses Keamanan Dokumen (Access Tier Matrix)

• access: public: Digunakan untuk dokumen transparansi desa, profil BUMDes, manual umum warga, dan regulasi publik (misal: 01_BLUEPRINT_OPERASIONAL.md, 06_PANDUAN_USER_MANUAL.md).
• access: authenticated: Digunakan untuk SOP operasional internal, job description, roadmap bisnis, dan kriteria evaluasi vendor yang dapat dibaca seluruh staf aktif BUMDes yang telah terotentikasi.
• access: private: Digunakan untuk arsitektur teknis mendalam, skema basis data inti, kode stored procedure perbankan atomik, mitigasi anti-fraud rahasia, dan kredensial sistem (hanya dapat dibuka oleh Super Admin).

---

5. Kebijakan Emas Bebas Notasi LaTeX (Zero-LaTeX Policy)#

5.1 Latar Belakang Teknis & Arsitektur

Portal dokumentasi web BUMDes dibangun di atas kerangka kerja modern (react-markdown + remark-gfm). Notasi matematika KaTeX/LaTeX membutuhkan pustaka parser pihak ketiga yang berat dan rentan memicu kegagalan hydration di sisi peramban pengguna. Selain itu, agen AI Copilot berbasis RAG memproses teks murni jauh lebih akurat tanpa interferensi karakter backslash \ matematika.

Oleh karena itu, DITERAPKAN KEBIJAKAN ZERO-LATEX SECARA MUTLAK (TOLERANSI NOL / ZERO-TOLERANCE) pada seluruh dokumen markdown.

5.2 Larangan Keras Notasi LaTeX

1. Dilarang Math Block: Dilarang menggunakan penanda pembungkus rumus matematika (tanda pembuka/penutup simbol dollar tunggal atau ganda).
2. Dilarang Font/Tag LaTeX: Dilarang menggunakan perintah ..., **...**, *...*, ....
3. Dilarang Pecahan LaTeX: Dilarang menulis pecahan dalam bentuk pembilang / penyebut.
4. Dilarang Simbol Operator LaTeX: Dilarang menggunakan x, x, /, <=, >=, ≈, !=, Total , Tak Terhingga (∞).
5. Dilarang Matriks/Tabel LaTeX: Dilarang menggunakan begin{array} ... end{array} atau begin{matrix}.
6. Dilarang Escape Karakter Umum: Cukup tulis simbol % murni (bukan %) dan simbol mata uang Rp atau (bukan).

5.3 Tabel Konversi Notasi Wajib (Plain Text UTF-8)

---

6. Standarisasi Akun Keuangan SAK EP & Matriks Suffix Unit#

6.1 Prinsip Zero-Overlap COA

Untuk memastikan konsolidasi keuangan BUMDes berjalan otomatis tanpa risiko salah posting atau pencampuran kas, setiap unit usaha beroperasi di bawah Bagan Akun Standar (docs/04_Financial/02_Panduan_Operasional/STANDAR_AKUNTANSI_COA.md) dengan alokasi Suffix Akun Terisolasi (.XX):

6.2 Matriks Alokasi Suffix Unit Usaha BUMDes

6.3 Aturan Rantai Pasok Internal Timbal Balik (At-Cost Intercompany Supply)

Setiap transaksi pasokan bahan antar-unit internal (misal: Jagung Petani -> Pabrik Pakan -> Pakan Ayam Layer -> Kuliner Pujasera):

1. Harga Transfer Wajib HPP Murni (At-Cost): Dilarang mengambil margin keuntungan di tingkat unit hulu agar laba holding tidak menggembung semu (unrealized phantom profit).
2. Rekening Koran Timbal Balik Simetris:

• Holding mencatat piutang RK pada akun aset: 1-60x (RK Sub-Holding / Unit Usaha).
• Unit penerima mencatat kewajiban RK pada akun liabilitas: 2-610 (RK BUMDes Holding Pusat).

3. Eliminasi Otomatis Konsolidasi: Saat penyusunan Neraca Konsolidasi untuk LPJ Musdes, akun 1-60x dan 2-610 wajib dieliminasi timbal balik hingga bersaldo nol (Rp 0).

---

7. Format Standar Paket Berkas Operasional (12 Berkas Baku) & Master SOP 8 Bab#

7.1 Paket Standar 12 Berkas Unit Operasional

Setiap unit usaha mandiri baru yang dikembangkan pada sistem ERP BUMDes wajib dilengkapi paket 12 berkas terstruktur:

1. 01_BLUEPRINT_OPERASIONAL.md : Model bisnis, alur kerja pelanggan, kapasitas produksi, dan zonasi fisik.
2. 02_AKUNTANSI_[UNIT].md : Pemetaan COA resmi SAK EP Suffix .XX, saldo normal, dan minimal 5 skenario jurnal otomatis.
3. 02_Panduan_Operasional/SOP_OPERASIONAL_[UNIT].md : Naskah resmi Master SOP 8 Bab untuk kendali harian.
4. 03_ROADMAP_PENGEMBANGAN.md : Tahapan digitalisasi 3 fase (Fondasi Manual, Digitalisasi POS/Mobile, Otomasi AI/GIS).
5. 04_ARSITEKTUR_TEKNIS.md : Skema tabel database PostgreSQL, server actions Next.js, dan state management.
6. 05_MITIGASI_RISIKO_SOP.md : Analisis titik rawan kebocoran (fraud), limit brankas, dan prosedur darurat insiden.
7. 06_PANDUAN_USER_MANUAL.md : Petunjuk operasional klik-demi-klik untuk kasir, operator, dan pengurus desa.
8. 07_SKENARIO_TESTING_QA.md : Matriks pengujian UAT (Skenario, Langkah Uji, Ekspektasi, Status Lolos).
9. 08_ANALISIS_BISNIS_PEMASARAN.md : Analisis kelayakan usaha, BEP, proyeksi margin kotor/bersih, dan bauran pemasaran (4P).
10. 09_INTEGRASI_PIHAK_KETIGA.md : Spesifikasi integrasi eksternal (QRIS Bank Indonesia, Timbangan Digital, WhatsApp API).
11. 10_KEPATUHAN_HUKUM_PAJAK.md : Izin legalitas (NIB, PIRT, Sertifikasi Halal BPJPH, Pajak Daerah PBJT/PPN).
12. 11_METRIK_KPI.md : Indikator kinerja utama kuantitatif per bulan (Target omzet, batas susut/waste, rasio laba).

7.2 Format Wajib Master SOP 8 Bab

Setiap naskah SOP operasional kerja wajib disusun dalam 8 Bab Terstandarisasi:

markdown
# 📋 Standar Operasional Prosedur: [Nama Prosedur]

**Nomor Dokumen:** SOP/BUMDES-BLG/[KODE_UNIT]/[TAHUN]/[NO_REG] 
**Unit Kerja:** [Nama Unit Usaha] 
**Tanggal Efektif:** [Tanggal Berlaku ISO] 
**Penanggung Jawab:** [Kepala Unit / Manajer Operasional] 

---

## 1. Tujuan
(3-4 butir sasaran utama prosedur: kendali mutu, pencegahan kebocoran, integritas data sistem)

## 2. Ruang Lingkup
(Batasan personel pelaksana, lokasi fisik kerja, dan batasan proses dari titik awal hingga selesai)

## 3. Dokumen & Formulir Terkait
(Tautan aktif ke COA SAK EP, Berita Acara, Faktur Pengadaan, Tiket Timbangan)

## 4. Diagram Alur Prosedur (Workflow)
(Diagram alir menggunakan blok kode mermaid graph TD yang jelas)

## 5. Rincian Prosedur Kerja Lapangan
(Sub-bab 5.1 Persiapan & K3, 5.2 Eksekusi Operasional, 5.3 Validasi & Input Sistem ERP)

## 6. Checklist Kendali Mutu & Batas Ambang Kritis
(Tabel matriks parameter kontrol: Nilai Standar, Batas Deviasi Toleransi, Frekuensi, dan Petugas)

## 7. Kepatuhan Finansial & Auto-Journaling SAK EP
(Tabel pemetaan debit/kredit otomatis SAK EP Suffix unit terkait)

## 8. Lembar Pengesahan Formal Dokumen (3 Pihak)
(Tabel tanda tangan resmi: Penyusun/Kepala Unit, Pemeriksa/Manajer, Penyetujui/Direktur BUMDes)

---

8. Kebijakan Kerahasiaan Dapur Sistem (Zero Infrastructure Leakage Policy)#

Demi menjaga keamanan siber sistem desa, perlindungan data pribadi warga (UU PDP No. 27/2022), serta mematuhi etika profesional korporasi digital:

1. Larangan Penyebutan Nama Vendor Backend pada Dokumen Publik & Operasional:

• Dilarang keras menyebutkan nama merk penyedia hosting, vendor database komputasi awan, atau framework backend pihak ketiga pada judul berkas, deskripsi frontmatter, kartu navigasi, maupun teks pengantar yang dapat dibaca oleh Pengurus, Kasir, atau Warga Desa.

2. Terminologi Pengganti Standar Korporasi Desa:

• Framework Aplikasi Web → Kerangka Kerja Aplikasi Terintegrasi Enterprise / Portal Web Mandiri BUMDes
• Penyedia Database Cloud / RLS → Basis Data Terisolasi Tingkat Baris (Row-Level Security) / Penyimpanan Terenkripsi
• Penyedia Hosting Edge → Infrastruktur Jaringan Terdistribusi Kecepatan Tinggi
• Database Stored Procedures → Prosedur Transaksional Finansial Terpusat (Atomic Engine)
• PWA Offline → Protokol Sinkronisasi Data Offline-First Lapangan

3. Isolasi Berkas Arsitektur Mendalam:

• Seluruh berkas spesifikasi teknis mendalam yang membedah struktur internal sistem wajib diberi tanda access: private dan diisolasi khusus bagi Super Admin.

---

9. Standar Integrasi Portal Web & Bantuan Kontekstual In-App#

Dokumentasi yang ditulis wajib terintegrasi secara dinamis dengan aplikasi pengguna:

9.1 Registrasi Portal Web Navigasi (lib/docs.ts)

Setiap dokumen resmi yang dapat diakses pengguna wajib didaftarkan pada konfigurasi katalog di lib/docs.ts agar otomatis muncul di menu navigasi /dashboard/help dan /panduan.

9.2 Pemetaan Bantuan Kontekstual In-App (lib/constants/contextual-help-map.ts)

Setiap formulir kerja atau halaman modul wajib memiliki pasangan dokumen SOP yang dipetakan pada drawer bantuan kontekstual:

• Pintasan Keyboard Universal: Pengguna dapat menekan tombol F1 atau Alt + H pada modul kerja untuk membuka laci bantuan slide-over tanpa menutup form yang sedang diisi.
• Dukungan 4 Tab: Tab 1 (Ringkasan & Checklist Harian), Tab 2 (Naskah Dokumen SOP), Tab 3 (Pintasan Keyboard), Tab 4 (Pencarian Cepat & Pemindai Kamera QR).

9.3 Standar Naskah Cetak Resmi A4 & Label Stiker Fisik QR

1. Layout Cetak A4: Menggunakan kop surat resmi Pemerintah Kabupaten Bone Bolango & BUMDes Bolulango, nomor register deterministik, garis ganda hijau emerald/emas, dan lembar pengesahan 3 pihak berstempel digital resmi.
2. Stiker Fisik QR Lapangan:

• Ukuran S (70 x 50 mm) : Ditempel pada monitor kasir POS, mesin timbangan digital.
• Ukuran M (100 x 70 mm) : Ditempel pada pintu kandang ayam/sapi, tangki pakan, kolam bioflok.
• Ukuran L / A6 (148 x 105 mm): Ditempel pada papan instruksi kerja mading hanggar TPS3R/pabrik pakan.

---

10. Protokol Penjaminan Mutu & Validator Otomatis#

Setiap penambahan atau revisi dokumen dokumentasi pada repositori ERP BUMDes wajib melalui tahapan verifikasi kualitas sistem:

10.1 Skrip Validator Otomatis (scripts/sync-*-docs.js)

Setiap pembuatan unit atau dokumen master wajib disertai skrip validator otomatis di folder scripts/ yang memverifikasi:

1. Keberadaan fisik berkas dokumen (fs.existsSync).
2. Kepatuhan Zero-LaTeX (0 kemunculan simbol math LaTeX).
3. Kelengkapan kata kunci bisnis wajib (misal: SAK EP, Suffix Akun, Alur Kerja).
4. Kepatuhan YAML Frontmatter valid (title, access, allowedRoles).

10.2 Checklist QA Pra-Rilis Dokumentasi

Sebelum melakukan commit atau rilis modul baru, pengembang wajib memastikan:

• Seluruh berkas markdown baru mematuhi Zero-LaTeX Policy (tidak ada rumus yang rusak saat dirender).
• Suffix akun akuntansi tidak bentrok dengan 25 unit usaha yang sudah ada.
• Dokumen telah didaftarkan pada docs/INDEX.md dan lib/docs.ts.
• Modul operasional telah terhubung ke lib/constants/contextual-help-map.ts.
• Perintah npm run lint menghasilkan exit code 0 tanpa galat.

---

11. Siklus Hidup Dokumen, Manajemen Status & Semantic Versioning#

Setiap dokumen panduan, spesifikasi teknis, dan SOP unit usaha memiliki siklus hidup formal agar tidak terjadi kebingungan operasional antara draf pengujian dengan naskah yang sah secara hukum:

11.1 Enam Status Siklus Hidup Dokumen

Memuat diagram alur...

1. DRAFT: Naskah dalam proses perancangan awal oleh kepala unit atau tim teknis. Belum memiliki kekuatan hukum operasional.
2. IN_REVIEW: Naskah sedang ditelaah oleh Manajer Operasional dan Auditor Internal untuk menguji kesesuaian SOP terhadap praktik riil lapangan dan kepatuhan SAK EP.
3. APPROVED: Naskah telah disahkan oleh Direktur Utama BUMDes Bolulango dan siap diimplementasikan.
4. ACTIVE: Naskah resmi yang berlaku aktif di lapangan, terpublikasi di portal /dashboard/help, dan wajib dipatuhi seluruh staf operasional.
5. DEPRECATED: Naskah yang sedang dalam masa transisi penggantian oleh revisi baru (maksimal masa transisi 30 hari kalender).
6. ARCHIVED: Naskah usang yang dipindahkan ke sub-folder docs/_arsip/ demi integritas rekam jejak audit sejarah desa.

11.2 Standar Penomoran Rilis Versi Semantik (Doc SemVer)

Dokumen wajib menggunakan format penomoran semantik vMAJOR.MINOR.PATCH:

• MAJOR (Perubahan Besar): Diberlakukan saat terjadi restrukturisasi Bagan Akun Standar (COA SAK EP), perubahan mendasar model bisnis unit, perubahan Peraturan Desa (Perdes) mengenai alokasi dividen SHU, atau perombakan total arsitektur aplikasi.
• MINOR (Penyempurnaan Fitur/SOP): Diberlakukan saat ada penambahan langkah prosedur baru, penambahan mesin atau fasilitas unit, penambahan skenario jurnal otomatis, atau integrasi gateway baru.
• PATCH (Koreksi Ringan): Diberlakukan saat ada perbaikan saltik (typo), penyesuaian nomor kontak pengurus, perbaikan format tabel, atau klarifikasi istilah.

11.3 Blok Riwayat Revisi Wajib (Change Log Table)

Setiap naskah SOP operasional diwajibkan menyertakan tabel riwayat revisi pada bagian penutup naskah dengan format baku:

---

12. Standar Penulisan Ramah AI Copilot & Optimasi RAG Vector Search#

Sistem ERP BUMDes mengintegrasikan asisten kecerdasan buatan (Global AI Copilot dan DocAiChatbot berbasis Google Gemini 2.5 Flash). Agar dokumen dapat diproses secara akurat oleh mesin Retrieval-Augmented Generation (RAG), seluruh penyusun dokumen wajib mematuhi panduan optimasi berikut:

12.1 Batas Ukuran Chunking Semantik Ideal

• Ambang Batas Kata: Setiap sub-bab heading (## H2 atau ### H3) dirancang berbobot 800 hingga 1.200 kata.
• Kepadatan Informasi: Hindari sub-bab yang terlalu gemuk (> 1.500 kata) karena akan terpotong secara paksa oleh jendela pemotong teks (chunker) mesin pencari vektor, yang mengakibatkan hilangnya kesatuan makna.

12.2 Larangan Referensi Mengambang (Self-Contained Rule)

AI RAG mengambil potongan dokumen secara independen. Oleh karena itu:

• Dilarang Frasa Mengambang: Dilarang menggunakan frasa seperti "sebagaimana dijelaskan di bab atas", "prosedur yang telah disebutkan sebelumnya", atau "langkah berikut ini".
• Wajib Subjek Eksplisit: Selalu sebutkan nama entitas, nama akun, dan nomor langkah secara lengkap pada setiap paragraf. Contoh: "Operator Unit Pakan wajib memverifikasi akun 1-140.03 (Bahan Baku Pakan) sebelum..." alih-alih "Operator wajib memverifikasi persediaan tersebut...".

12.3 Kamus Istilah Lokal & Tag Padanan Kata (Glossary Tags)

Di awal berkas dokumen atau pada bagian pendahuluan, cantumkan tabel padanan istilah teknis terhadap istilah bahasa daerah/lapangan agar AI dapat mengenali sinonim pertanyaan warga/operator:

---

13. Standarisasi Media Digital, Aset Visual WebP & Protokol 3-Foto Anti-Fraud#

13.1 Standar Penyimpanan & Optimasi Gambar

1. Lokasi Penyimpanan: Seluruh aset gambar dan diagram dokumentasi wajib ditempatkan di direktori: public/docs/images/[unit]/[NAMA_ASET].webp
2. Format Wajib WebP Terkompresi: Dilarang menggunakan file PNG atau JPEG mentah berukuran besar. Seluruh gambar wajib dikonversi ke format .webp dengan ukuran maksimal 250 KB per gambar.
3. Rasio Tampilan Standar: Gunakan rasio aspek 16:9 (untuk foto lanskap/perkandangan/hanggar) atau 4:3 (untuk foto dokumen/timbangan).

13.2 Palet Warna Baku Diagram Alur (Mermaid.js)

Diagram alur proses wajib menggunakan palet identitas resmi korporasi BUMDes Bolulango:

13.3 Protokol Triangulasi Bukti Visual 3-Foto Anti-Fraud

Setiap SOP pengeluaran kas, penerimaan logistik bernilai > Rp 1.000.000, atau pencatatan aset wajib mencantumkan instruksi wajib 3-Foto:

1. Foto 1 (Bukti Legalitas): Foto fisik nota/kuitansi bermeterai atau tiket timbangan digital asli.
2. Foto 2 (Bukti Fisik Komoditas): Foto fisik barang, kendaraan, atau ternak di titik serah-terima.
3. Foto 3 (Bukti Integritas Personel): Foto petugas pemeriksa BUMDes bersama pihak penyerang/mitra di lokasi fisik dengan kamera ber-GeoTagging dan penanda waktu (timestamp).

---

14. Arsitektur Dokumentasi Multi-Tenancy SaaS & Parameterisasi Desa#

ERP BUMDes dirancang untuk dapat direplikasi oleh ratusan BUMDes di seluruh Indonesia melalui arsitektur Multi-Tenancy SaaS. Standarisasi dokumentasi memisahkan antara standar platform global dengan regulasi lokal desa:

14.1 Pemisahan Lapisan Dokumen Platform Core vs Tenant Local

1. Lapisan Platform Core (Global Standards):

• Dokumen arsitektur teknis, standar Bagan Akun SAK EP, prosedur rekonsiliasi bank otomatis, dan aturan Zero-LaTeX. Bersifat terpusat dan berlaku bagi seluruh penyewa (tenant).

2. Lapisan Tenant Local (Desa Khusus):

• Dokumen SOP unit usaha spesifik yang mengikat nama unit lokal, nomor Peraturan Desa (Perdes), dan susunan pengurus setempat.

14.2 Standar Variabel Parameterisasi Dinamis (Placeholder Tokens)

Dalam menulis template SOP yang ditujukan untuk deployment multi-desa, gunakan token variabel kurung ganda:

• {{NAMA_BUMDES}} : Nama resmi BUMDes (contoh: BUMDes Bolulango).
• {{NAMA_DESA}} : Nama desa yurisdiksi (contoh: Desa Bandungan).
• {{KECAMATAN}} : Nama kecamatan yurisdiksi (contoh: Bulango Utara).
• {{KABUPATEN}} : Nama kabupaten yurisdiksi (contoh: Bone Bolango).
• {{PERDES_PENDIRIAN}}: Nomor dan tahun Perdes pendirian BUMDes.
• {{BANK_OPERASIONAL}}: Rekening perbankan operasional utama (contoh: Bank SulutGo / BPD).

---

15. Matriks Penyelarasan SKKNI & Kepatuhan Regulasi Kementerian#

Seluruh struktur Standar Operasional Prosedur BUMDes diselaraskan secara formal dengan regulasi pemerintah dan standar kompetensi nasional:

15.1 Penyelarasan Standar Kompetensi Kerja Nasional Indonesia (SKKNI Pengelola BUMDes)

Penyusunan tugas, wewenang, dan checklist harian pada SOP unit usaha mengacu pada Keputusan Menteri Ketenagakerjaan RI tentang SKKNI Bidang Pengelolaan BUMDes:

15.2 Kepatuhan Pelaporan Kemendesa PDTT & Audit BPKP

1. Laporan Pertanggungjawaban Musdes (PP No. 11/2021): Naskah SOP wajib menghasilkan data pembukuan yang siap disajikan pada Laporan Evaluasi Kinerja Tahunan di hadapan Badan Permusyawaratan Desa (BPD) dan Musyawarah Desa.
2. Kesiapan Audit Inspektorat & BPKP: Setiap jurnal otomatis, penghapusan piutang macet, dan amortisasi aset biologis wajib memiliki kertas kerja pendukung (supporting work papers) yang memenuhi standar audit keuangan negara.

---

16. Lembar Pengesahan Regulasi Dokumentasi (Edisi 2026.2)#

Dokumen induk standarisasi pendokumentasian sistem edisi pemutakhiran komprehensif 2026.2 ini disahkan dan mengikat secara hukum operasional bagi seluruh jajaran pengurus BUMDes Bolulango, Sub-Holding Ketapang, unit usaha komersial, auditor internal, serta tim arsitektur pengembang perangkat lunak:

---

Dokumen ini merupakan Dokumen Induk Resmi Tata Kelola Pengetahuan dan Dokumentasi Sistem ERP BUMDes Bolulango (Grand Standard v2026.2).