Panduan Arsitektur Empat Pilar Plugin & Ekosistem Agentic AI

Entitas: BUMDes Bolulango, Desa Bandungan, Kecamatan Bulango Utara, Kabupaten Bone Bolango Nomor Dokumen: SOP/TECH/2026-11-07/001-AI-PLUGIN-ARCHITECTURE Klasifikasi Keamanan: Tier-2 (Internal Technical — Private)

---

1. Landasan Filosofis: Separation of Concerns (SoC) pada Kustomisasi AI#

Sistem ERP BUMDes Bolulango mengoperasikan arsitektur berskala besar yang mencakup 25 unit usaha terintegrasi, kepatuhan akuntansi regulasi SAK EP, isolasi dana kas/bank anti-commingling, tata letak visual antarmuka Enterprise Design System v2026.5, keamanan siber berlapis berbasis Row-Level Security (RLS) PostgreSQL, hingga ekosistem kecerdasan buatan internal (In-App AI) yang terdiri dari 18 Server Actions dan 12 Unit Advisors.

Pada tahap awal pengembangan, seluruh aturan dan skill AI terkumpul di dalam satu plugin monolitik (bumdes-accounting-auditor). Pendekatan monolitik tersebut memicu pencampuran domain (domain bleeding), beban konteks token berlebih (context overhead), dan ketidaksesuaian tanggung jawab agen.

Untuk menyelesaikan persoalan ini, ekosistem kustomisasi AI dipecah secara murni (Pure Separation of Concerns) menjadi Empat Pilar Plugin Spesialis Mandiri yang beroperasi secara independen namun saling melengkapi.

---

2. Peta Topologi Ekosistem Empat Pilar Plugin#

+-------------------------------------------------------------------------------------------------------------------------+
| ERP BUMDes Bolulango — Ekosistem Agentic AI 2026 |
+-------------------------------------------------------------------------------------------------------------------------+
 |
 +-----------------------------+-----------------------+-----------------------+-----------------------------+
 | | | |
+--------------------------+ +------------------------------------+ +--------------------------+ +--------------------------+
| 1. Akuntansi SAK EP | | 2. Design System v2026.5 | | 3. Database & Security | | 4. In-App AI Governance |
| bumdes-accounting-auditor| | bumdes-design-system | | bumdes-db-security | | bumdes-ai-governance |
| Versi: 1.7.0 | | Versi: 1.1.0 | | Versi: 1.0.0 | | Versi: 1.0.0 |
+--------------------------+ +------------------------------------+ +--------------------------+ +--------------------------+
| Subagent: | | Subagent: | | Subagent: | | Subagent: |
| - forensic-auditor | | - ui-architect | | - db-security-architect | | - ai-systems-auditor |
| | | | | | | |
| 8 Skills Spesialis: | | 3 Skills Spesialis: | | 3 Skills Spesialis: | | 3 Skills Spesialis: |
| 1. audit-coa | | 1. ui-design-inspector | | 1. audit-rls-catalog | | 1. audit-ai-guardrails |
| 2. reconcile-journals | | 2. audit-dark-mode-surface | | 2. safe-sql-migration | | 2. audit-ai-rag-knowledge|
| 3. reconcile-field-sheet | | 3. scaffold-erp-component | | 3. audit-backend-security| | 3. test-ai-advisors |
| 4. audit-budget | +------------------------------------+ +--------------------------+ +--------------------------+
| 5. audit-financial-close | | |
| 6. audit-livestock-inv | | |
| 7. audit-photo-evidence | | |
| 8. audit-usp-dual-bank | | |
+--------------------------+ | |
 | | |
 +---------------------------------------------+---------------------------+-----------------------------+
 |
 +---------------------+
 | Shared MCP Database |
 | bumdes-db-postgres |
 | (Role: Read-Only) |
 +---------------------+

---

3. Matriks Komparasi Empat Pilar Plugin#

---

4. Arsitektur Konektor Bersama MCP Database (Zero Duplicate Connection Pool)#

A. Tantangan Pool Koneksi

Dalam arsitektur Antigravity, setiap plugin yang mendeklarasikan mcp_config.json akan mengeksekusi child process mandiri untuk menjalankan server MCP (npx -y @modelcontextprotocol/server-postgres). Apabila setiap plugin mendeklarasikan server MCP database secara mandiri, Antigravity akan menyalakan empat instansi proses latar belakang yang membuka koneksi ganda ke Supabase Pooler (aws-1-ap-southeast-1.pooler.supabase.com:5432), memboroskan kuota koneksi concurrent pool.

B. Solusi: Single-Host Shared Consumer Pattern

• Host Tunggal: Berkas mcp_config.json dideklarasikan secara eksklusif satu kali di dalam direktori bumdes-accounting-auditor.
• Konsumen Lintas-Plugin: Subagent db-security-architect, ai-systems-auditor, dan skill audit-rls-catalog memanggil tool query pada server bersama bumdes-accounting-auditor_bumdes-db-postgres secara langsung melalui tool call_mcp_tool.
• Kredensial Aman: String koneksi dibaca secara dinamis dari variabel lingkungan sistem BUMDES_AUDITOR_DB_URL menggunakan role PostgreSQL terisolasi auditor_readonly tanpa hak mutasi data (SELECT-only).

---

5. Rincian 17 Skills Spesialis Ekosistem AI#

A. Pilar 1: Akuntansi SAK EP (8 Skills)

1. audit-coa: Audit master 260+ akun COA X-YZZ.SS, isolasi brankas kas/bank, deteksi pos salah kamar (rak karton 1-116, tali rafia 5-216, vitastress 5-103).
2. reconcile-journals: Rekonsiliasi keseimbangan Debit-Credit jurnal memorial, eliminasi cermin simetris RK (1-6xx vs 2-6xx), dan audit cut-off bulanan.
3. reconcile-field-sheet: Parser otomatis spreadsheet lapangan 2-panel (PTR-REG vs KTPG-TERNAK + volume Bak/Mika) terhadap basis data ERP.
4. audit-budget: Pengawasan pagu anggaran RKA SAK EP, deteksi dini overbudget belanja operasional dan belanja modal (CAPEX 1-2xx).
5. audit-financial-closing: Pre-Flight Checklist 8-Gerbang sebelum eksekusi penutupan buku periodik (financial_closings).
6. audit-livestock-inventory: Audit fisik-ke-buku besar persediaan telur WIP (1-107.05) ke Graded (1-107.06) dan amortisasi ternak PSAK 69 (1-204).
7. audit-photo-evidence: Pengawasan kepatuhan triangulasi bukti fisik 3-Foto (Nota, Fisik Barang, Petugas GeoTag) dan uji petik belanja material.
8. audit-usp-dual-banking: Audit pemisahan USP Konvensional (.01) vs USPPS Syariah (.13), rekonsiliasi sub-ledger kartu simpanan nasabah, dan CKPN.

B. Pilar 2: Enterprise Design System v2026.5 (3 Skills)

9. ui-design-inspector: Pemindaian statis 10-Gerbang otomatis (scan-ui-design.js --strict) dan protokol sinkronisasi dokumentasi desain.
10. audit-dark-mode-surface: Inspeksi live DOM computed styles via Chrome DevTools MCP untuk ritme 4-lapisan Neutral Charcoal (#202020 vs #2B2B2B) dan deteksi kartu bolong (sunken pits).
11. scaffold-erp-component: Cetakan blueprint kode siap pakai untuk kartu KPI interaktif, daftar bersarang Shared-Surface, dan kontainer dokumen laporan resmi (glowColor="none").

C. Pilar 3: Database & Keamanan Backend (3 Skills)

12. audit-rls-catalog: Kueri audit katalog sistem PostgreSQL via MCP (pg_tables, pg_policies, pg_proc, profiles) untuk deteksi tabel tanpa RLS dan kebijakan OR-Bypass.
13. safe-sql-migration: Protokol 6-Gerbang pembuatan migrasi SQL anti-bentrok, validasi idempotensi, eksekusi npx supabase db push --yes, dan sinkronisasi nomor urut.
14. audit-backend-security: Pemindai statis 11-Gerbang (scan-security-compliance.js --strict) untuk otorisasi Server Actions, SSR hygiene, anti-XSS, dan supply-chain hardening.

D. Pilar 4: In-App AI Governance & Safety (3 Skills)

15. audit-ai-guardrails: Pemindaian kepatuhan guardrail keselamatan AI, penegakan Kill-Switch global (isSystemAIEnabled), dan prinsip Zero Auto-Mutation (Human-in-the-Loop) pada 18 Server Actions lib/actions/ai-*.ts.
16. audit-ai-rag-knowledge: Audit mesin RAG Copilot Knowledge Hub, filter dokumen privat Tier-2 (filterDocsForUser), sensor data pribadi PII (maskSensitivePII), dan pembatasan anggaran token.
17. test-ai-advisors: Pengujian fungsionalitas, akurasi draf, dan ketahanan fallback pada 12 unit AI advisors (Smart Receipt OCR, Dokter Ternak, Dokter Tanaman, Peramal Arus Kas, Scoring Pinjaman USP, dan Legal Drafter).

---

6. Protokol Pemeliharaan & Definition of Done Pasca-Pemisahan#

Setiap kali melakukan pembaruan kode atau skema sistem, AI Agent dan pengembang wajib mematuhi matriks pemicu pembaruan berikut:

1. Perubahan Skema SQL / Migrasi: Wajib memperbarui nomor urut di ARCHITECTURE.md, SOP_MIGRASI_DATABASE_DAN_ANTI_BENTROK.md, .agents/rules/aturan_migrasi_database.md, dan bumdes-db-security/rules/AGENTS.md.
2. Perubahan Komponen UI / Styling: Wajib memvalidasi dengan node .agents/skills/audit-ui-design/scripts/scan-ui-design.js --strict (10/10 Lulus).
3. Perubahan Server Actions / Keamanan: Wajib memvalidasi dengan node .agents/skills/audit-security-rbac-rls/scripts/scan-security-compliance.js --strict (11/11 Lulus).
4. Perubahan Modul AI Runtime: Wajib memverifikasi sakelar isSystemAIEnabled() dan prinsip Human-in-the-Loop.
5. Verifikasi Akhir Sebelum Penutupan Tugas:

• node .agents/skills/sync-system-docs/scripts/scan-doc-drift.js --strict (7/7 Lulus)
• npm run verify:docs (50/50 Lulus)
• npx tsc --noEmit (0 errors)