Domain: BOS & RKAS¶

SSOT untuk alur BOS, RKAS, budget approval, ledger, dan realisasi anggaran yang saat ini tersebar di finance, inventory, dan governance.

Last verified: 2026-06-11 (Phase 6A audit SC-BOS)

1. Visi & Best Practice¶

1.1 Regulasi / Standar Acuan¶

Regulasi / standar	Relevansi
Juknis BOS	Menentukan komponen BOS, batas penggunaan, dan pelaporan
RKAS / ARKAS practice	Perencanaan, approval, dan monitoring realisasi anggaran sekolah
Audit trail pengadaan pemerintah/sekolah	Memastikan jejak komitmen dan realisasi anggaran terlihat
Prinsip pemisahan approval vs execution	Bendahara/approver berbeda dari operator pengadaan

1.2 Kondisi Ideal¶

Sekolah dapat merencanakan RKAS, mengalokasikan BOS, lalu menelusuri komitmen dan realisasi sampai ke pengadaan.
BOS component master, budget approval, dan budget ledger memakai kontrak data yang sama.
Packaging produk: add-on SC-BOS dengan owner kanonik scola_bos_rkas, scola_bos_rkas_procurement, scola_bos_rkas_executive_bridge; bridge lama hanya shim upgrade (GAP-05 closed 2026-06-11).
Governance/foundation hanya membaca rollup dari domain sumber, bukan menjadi owner logika BOS/RKAS.

2. Arsitektur & Data Model¶

2.1 Backend Modules¶

Module	Deskripsi
`scola_bos_rkas`	Owner kanonik — BOS fund, RKAS plan/line/program, budget ledger, bos fund API
`scola_bos_rkas_procurement`	Owner kanonik — procurement realization, purchase request, inventory budget API
`scola_bos_rkas_executive_bridge`	Executive budget summary API
`scola_bos_rkas_governance_bridge`	Foundation finance read-model rollup
`scola_bos_rkas_bridge`	Shim upgrade-only (delegates to `scola_bos_rkas`)
`scola_bos_rkas_procurement_bridge`	Shim upgrade-only
`scola_account`	UI finance, budget approval generik, consumer accounting
`scola_inventory`	UI inventory, consumer operasional SC-OPS
`scola_bundle_bos_rkas`	Bundle entitlement SC-BOS

2.2 Frontend Structure¶

src/services/finance/bosFund.service.js

src/views/AdminViews/Budget/
├── BudgetPlanningPage.vue
└── BudgetLedgerPage.vue

src/views/Principal/
├── PrincipalBudget.vue
├── PrincipalFinance.vue
└── PrincipalInventoryApprovals.vue

2.3 Kapabilitas & Akses¶

Area	Catatan
BOS fund management	Saat ini berada di surface finance/treasurer
RKAS planning & ledger	Saat ini berada di surface inventory/budget
Principal / foundation budget oversight	Saat ini membaca agregat dari finance + inventory

2.4 API / Model Evidence¶

Evidence	Lokasi
BOS fund endpoints	`src/services/finance/bosFund.service.js`
BOS allocation models	`../scola-odoo-module/scola_bos_rkas_bridge/models/bos_fund.py`
Budget approval models	`../scola-odoo-module/scola_account/models/account_budget.py`
RKAS planning + budget ledger	`../scola-odoo-module/scola_bos_rkas_bridge/models/budget.py`, `budget_program.py`
Procurement linkage to budget line	`../scola-odoo-module/scola_bos_rkas_procurement_bridge/models/purchase_order.py`
Inventory budget API	`../scola-odoo-module/scola_bos_rkas_procurement_bridge/controllers/budget_api.py`
Governance finance + budget rollups	`../scola-odoo-module/scola_bos_rkas_governance_bridge/controllers/*.py`

3. Fitur & Status Implementasi¶

Fitur	Status	Catatan
BOS component master	✅ Done	Ada model dan view dedicated di `scola_bos_rkas_bridge`
BOS allocation per period	✅ Done	Workflow confirm/approve tersedia
Budget approval workflow	✅ Done	`account.budget` punya approver dan state machine
RKAS planning per program	✅ Done	Owner `scola_bos_rkas`
Budget ledger untuk komitmen dan realisasi	✅ Done	`scola.budget.ledger` tersedia
Procurement linked to budget line	✅ Done	Owner `scola_bos_rkas_procurement`
Seam extraction GAP-05	✅ Done	Canonical owners + bridge shims
Pilot scoladev API smoke	✅ Done	SC-BOS evidence
Phase 6A formal audit	✅ Done	bos-rkas-audit-2026-06-11.md
Packaging controlled rollout	🟡 Kuning	SC-FIN + SC-OPS + UAT E2E Phase 6B

4. Gap Analysis & Backlog¶

P1 — Important¶

Gap	Dampak	Solusi
Remote pilot evidence `SC-BOS`	—	Closed (Phase 6A) — pilot + audit formal
End-to-end RKAS→pengadaan UAT	Belum bukti operasional	Phase 6B API chain proven; operator UAT pending
Legacy DB `scola_bos_rkas_account_bridge`	Noise upgrade state	Cleanup DB
Ketergantungan SC-FIN + SC-OPS	—	Closed — Phase 6B audit SC-FIN + SC-OPS

P2 — Nice to Have¶

Backlog	Konteks	Catatan
Perluasan rollout `SC-BOS` di luar controlled public-sector pilot	Bundle scaffold, kernel, procurement bridge, governance bridge, quote rule `SC-FIN` + `SC-OPS`, dan harness lokal sudah live	Buka GA setelah UAT E2E Phase 6B (BOS-M2)
Mapping Juknis BOS yang lebih eksplisit ke UI approval	Memudahkan audit	Cocok dikerjakan saat extraction add-on
Export/report pack BOS-RKAS	Kebutuhan pelaporan bendahara dan kepala sekolah	Setelah boundary modul lebih stabil

5. File References¶

Frontend¶

src/services/finance/bosFund.service.js — service utama BOS fund
src/views/AdminViews/Budget/BudgetPlanningPage.vue — perencanaan RKAS
src/views/AdminViews/Budget/BudgetLedgerPage.vue — audit trail anggaran
src/views/Principal/PrincipalBudget.vue — ringkasan budget kepala sekolah

Backend¶

../scola-odoo-module/scola_bos_rkas/models/bos_fund.py — BOS fund (canonical)
../scola-odoo-module/scola_bos_rkas/models/budget.py — budget line dan ledger
../scola-odoo-module/scola_bos_rkas_procurement/models/purchase_order.py — pengadaan
../scola-odoo-module/scola_bundle_bos_rkas/__manifest__.py — bundle SC-BOS

7. Panduan Konfigurasi Implementor¶

Lihat configuration-guides/bos-rkas.md.

Ringkas: provision SC-FIN + SC-OPS + SC-BOS → komponen BOS → RKAS → ledger → pengadaan.

8. Panduan End User¶

Role	Surface
Bendahara	`/accounting/bos-fund`, budget approval
Staff TU / gudang	Inventory + purchase request (SC-OPS)
Kepala sekolah	`/principal/budget`

Quick reference keuangan: keuangan quick-start (SPP terpisah dari BOS full).