📝 Standar & Template Baku Penulisan Dokumen SOP BUMDes Bolulango

Nomor Pedoman: STD/BUMDES/DOC/002 Klasifikasi: Standar Dokumentasi & Tata Kelola Pengetahuan Sasaran Pengguna: Direksi, Kepala Unit Usaha, Tim IT, dan Auditor Internal Versi: 2026.1 (Standar Emas BUMDes)

---

1. Pendahuluan#

Untuk memastikan seluruh dokumen di dalam Pusat Bantuan (Knowledge Hub) memiliki konsistensi tinggi, mudah dibaca, serta mematuhi Standar Emas BUMDes, setiap pembuatan atau revisi Standar Operasional Prosedur (SOP) wajib mengacu pada pedoman ini.

Dokumen SOP yang terstruktur rapi akan memudahkan:

1. Pencarian Cepat: Membantu mesin pencari ERP menemukan istilah teknis dengan akurat.
2. Keterbacaan Optimal: Mencegah kesalahan prosedur teknis di lapangan.
3. Kepatuhan Audit: Memenuhi persyaratan audit transparansi keuangan & operasional desa.

---

2. Aturan Nomenklatur & Penempatan Berkas#

2.1 Format Nama Berkas (File Naming)

• Wajib menggunakan huruf kapital dan garis bawah: NAMA_DOKUMEN_SPESIFIK.md
• Hindari spasi, simbol aneh (@, #, $, %), atau tanda kurung.
• Contoh Benar:
• SOP_PENERIMAAN_PAKAN_AYAM.md
• PANDUAN_AKAD_KREDIT_USP.md
• FORMULASI_KONSENTRAT_SAPI.md
• Contoh Salah:
• sop pakan ayam (revisi 2).md (Ada spasi & tanda kurung)
• panduan-baru.docx (Bukan ekstensi markdown)

2.2 Penempatan Direktori

Tempatkan berkas pada direktori yang tepat sesuai dengan unit atau topik pembahasannya:

• docs/01_Fundamentals/ : Dokumen kebijakan dasar, regulasi desa, dan panduan sistem umum.
• docs/02_Procurement/ : SOP pengadaan, vendor, dan logistik gudang utama.
• docs/03_Operational/<Unit_Folder>/ : SOP peternakan, perikanan, simpan pinjam, sablon, dll.
• docs/04_Financial/02_Panduan_Operasional/ : SOP jurnal, kas, rekonsiliasi bank, dan pajak.
• docs/06_SubHolding_Ketapang/ : Seluruh SOP khusus Pabrik Pakan Feedmill Ketapang.

---

3. Struktur Frontmatter Wajib#

Setiap berkas markdown wajib diawali dengan blok YAML Frontmatter di baris pertama:

yaml
---
title: Judul Lengkap SOP yang Jelas dan Deskriptif
description: Ringkasan singkat 1-2 kalimat mengenai tujuan dan cakupan prosedur ini.
access: authenticated
allowedRoles: ['super_admin', 'admin_keuangan', 'direktur', 'staff']
---

Parameter Frontmatter:

• title (String): Judul resmi SOP yang akan tampil di header dokumen.
• description (String): Deskripsi ringkas untuk pencarian dan pratinjau.
• access (String): authenticated (staf terdaftar) atau public (dapat dibaca warga).
• allowedRoles (Array): Peran yang diizinkan mengakses (super_admin, direktur, pengawas, admin_keuangan, staff, operator).

---

4. Standar Penulisan Konten Markdown#

4.1 Hirarki Judul (Headings)

Gunakan hirarki judul secara tertib untuk memastikan Table of Contents (TOC) terbentuk dengan rapi:

• # (H1) : Digunakan hanya satu kali di awal berkas untuk Judul Utama Dokumen.
• ## (H2) : Bab Utama (misal: ## 1. Tujuan, ## 2. Ruang Lingkup, ## 3. Prosedur Kerja).
• ### (H3) : Sub-Bab Prosedur (misal: ### 3.1 Prosedur Pagi Hari).
• #### (H4) : Rincian teknis kecil.

4.2 Kotak Peringatan Visual (Alert Boxes)

Gunakan alert standar GitHub untuk menandai informasi penting:

markdown
> [!NOTE]
> Gunakan ini untuk catatan latar belakang atau konteks regulasi.

> [!TIP]
> Gunakan ini untuk kiat praktis, efisiensi kerja, atau tips pemeliharaan.

> [!IMPORTANT]
> Gunakan ini untuk langkah wajib yang mutlak harus dipatuhi.

> [!WARNING]
> Gunakan ini untuk peringatan risiko kerugian finansial atau kerusakan aset.

> [!CAUTION]
> Gunakan ini untuk larangan keras atau tindakan fatal yang memicu sanksi hukum/audit.

4.3 Diagram Alur Proses (Mermaid.js)

Gunakan blok kode mermaid untuk menggambarkan alur operasional:

markdown
```mermaid
graph TD
 A[Mulai Prosedur] --> B{Pemeriksaan Mutu}
 B -->|Lolos| C[Terima & Masukkan Gudang]
 B -->|Tidak Lolos| D[Tolak & Kembalikan ke Vendor]

### 4.4 Format Rekening Akuntansi & Kode COA
Ketika mencantumkan kode akun COA atau formula keuangan, gunakan blok tabel atau inline code:
* Format kode: `1-101 (Kas Operasional)`
* Jurnal: Gunakan tabel dengan kolom No Akun, Nama Rekening, Debit, Kredit.

### 4.5 Standar Kerahasiaan Dapur Sistem & Infrastruktur (Zero Infrastructure Leakage Policy)
Demi integritas keamanan siber dan perlindungan aset sistem BUMDes:
* **Larangan Penyebutan Vendor & Stack**: Dilarang keras mencantumkan nama vendor teknologi backend atau infrastruktur pihak ketiga (misal: Next.js, Supabase, Vercel, PostgreSQL, AWS, dll.) pada judul, deskripsi frontmatter, kartu kategori, maupun teks pengantar yang dapat diakses oleh Pengurus, Auditor, Staf, maupun Publik.
* **Terminologi Baku Pengganti**:
 * *Next.js* → Kerangka Kerja Aplikasi Terintegrasi Enterprise / Portal Web Modern BUMDes
 * *Supabase / PostgreSQL / RLS* → Tata Kelola Basis Data Terisolasi (Row-Level Security) / Penyimpanan Terenkripsi
 * *Vercel / Cloudflare* → Infrastruktur Jaringan Edge Berkecepatan Tinggi
 * *Supabase RPC* → Prosedur Transaksional Finansial Terpusat (Atomic Stored Procedures)
 * *Offline Sync* → Protokol Sinkronisasi Data Offline-First
* **Akses Teknis Khusus**: Dokumen arsitektur teknis mendalam dan blueprint sistem mutlak dilindungi dengan `access: private` dan hanya dapat dibuka oleh Super Admin.

---

## 5. Template Siap Pakai (Boilerplate SOP)

Salin kode di bawah ini untuk membuat dokumen SOP baru Anda:

```markdown
---
title: SOP Nama Prosedur Operasional Unit
description: Standar prosedur pelaksanaan ... bagi unit usaha ... BUMDes Bolulango.
access: authenticated
allowedRoles: ['super_admin', 'direktur', 'staff', 'operator']
---

# 📋 Standar Operasional Prosedur: [Nama Prosedur]

**Nomor Dokumen:** `SOP/UNIT/2026/XXX` 
**Unit Kerja:** [Nama Unit Usaha, misal: Unit Peternakan Ayam] 
**Tanggal Berlaku:** [Tanggal Efektif, misal: 12 September 2026] 
**Penanggung Jawab:** [Jabatan, misal: Mandor Kandang / Kepala Unit] 

---

## 1. Tujuan

Menjelaskan sasaran dari prosedur ini, misalnya:
1. Memastikan setiap tahapan ... dilaksanakan sesuai standar teknis.
2. Meminimalkan risiko kerugian akibat ...
3. Menjamin akurasi pencatatan data ke sistem ERP BUMDes.

---

## 2. Ruang Lingkup

Menjelaskan batasan pemberlakuan prosedur:
* Prosedur ini berlaku untuk seluruh personel di lokasi [Lokasi Kerja].
* Prosedur ini mencakup tahapan sejak [Titik Awal] hingga [Titik Selesai].

---

## 3. Dokumen & Formulir Terkait

Daftar formulir atau dokumen rujukan:
* [Bagan Akun Standar (COA SAK EP)](04_Financial/02_Panduan_Operasional/STANDAR_AKUNTANSI_COA.md)
* [Standar Emas BUMDes ERP](STANDAR_EMAS_BUMDES.md)
* Formulir Berita Acara Penerimaan Barang (BAPB)

---

## 4. Diagram Alur Prosedur

```mermaid
graph TD
 A[Langkah 1: Persiapan] --> B[Langkah 2: Eksekusi Lapangan]
 B --> C{Pemeriksaan Kualitas}
 C -->|Memenuhi Syarat| D[Langkah 3: Input Sistem ERP]
 C -->|Tidak Memenuhi| E[Tindakan Koreksi]
 E --> B

---

5. Rincian Langkah Operasional#

5.1 Tahap Persiapan

1. Operator wajib memeriksa kelengkapan alat kerja dan APD sebelum memulai.
2. Pastikan area kerja dalam kondisi bersih dan aman.

[!IMPORTANT] Jangan pernah memulai operasional sebelum checklist keselamatan kerja terverifikasi.

5.2 Tahap Pelaksanaan

1. Lakukan penimbangan / pengukuran dengan toleransi deviasi maksimal ±0.5%.
2. Catat hasil fisik ke buku kerja harian atau langsung ke modul ERP BUMDes.

[!WARNING] Segala bentuk keterlambatan pelaporan melebihi 24 jam wajib dilaporkan tertulis kepada Kepala Unit.

5.3 Tahap Pencatatan Finansial & Input ERP

1. Buka modul /dashboard/[nama-modul] pada aplikasi ERP.
2. Input data mutasi barang / keuangan sesuai bukti fisik.
3. Lampirkan foto bukti transaksi (sesuai SOP Wajib 3 Foto).

---

6. Checklist Kendali Mutu (Quality Assurance)#

---

7. Pengesahan Dokumen#

---
*Dokumen ini merupakan panduan resmi tata kelola pengetahuan BUMDes Bolulango.*