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-04-03

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 diarahkan menjadi add-on SC-BOS, dan runtime ownership sekarang sudah dipisah ke scola_bos_rkas_bridge, scola_bos_rkas_procurement_bridge, dan scola_bos_rkas_governance_bridge. Dead runtime duplicates di scola_account sudah dibersihkan, controller governance bridge juga tidak lagi mewarisi controller runtime dari scola_core, clean-DB install dan upgrade replay lokal sudah terkumpul, dan blocker yang tersisa adalah keputusan packaging/quoting final setelah boundary publik-sektor ini di-hardening lebih lanjut.
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_bridge`	BOS fund component, BOS allocation, RKAS plan/line/program, dan budget ledger kernel
`scola_bos_rkas_procurement_bridge`	Procurement realization bridge, purchase request workflow, stock-request budget linkage, dan inventory budget API
`scola_bos_rkas_governance_bridge`	Executive budget summary dan foundation finance read-model untuk rollup BOS/RKAS
`scola_account`	UI finance, budget approval generik, dan consumer accounting non-BOS
`scola_inventory`	UI inventory, assets, maintenance, dan shell launch-wave untuk consumer operasional non-BOS
`scola_core`	Surface principal/foundation umum, role gating, dan helper akses

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	Kernel RKAS sekarang sudah dimiliki `scola_bos_rkas_bridge`
Budget ledger untuk komitmen dan realisasi	✅ Done	`scola.budget.ledger` tersedia
Procurement linked to budget line	✅ Done	Ownership runtime sekarang ada di `scola_bos_rkas_procurement_bridge`
Packaging sebagai add-on independen	🟡 Controlled Rollout	`scola_bos_rkas_bridge`, `scola_bos_rkas_procurement_bridge`, `scola_bos_rkas_governance_bridge`, dan flag `scola_bos_rkas` sudah live; clean-DB install/upgrade replay lokal sudah lolos, dan `SC-BOS` kini diposisikan sebagai rollout publik-sektor terkontrol di atas `SC-FIN` + `SC-OPS`

4. Gap Analysis & Backlog¶

P1 — Important¶

Gap	Dampak	Solusi
Remote pilot evidence `SC-BOS` belum terkumpul	Harness lokal sudah hijau, tetapi controlled rollout belum punya bukti tenant publik-sektor yang hidup	Replay auth/session payload, BOS lifecycle, RKAS procurement trace, dan evidence budget rollup pada tenant pilot
Contract BOS, budget approval, dan procurement execution masih melibatkan consumer accounting/inventory	Risiko drift saat scope public-sector bertambah	Bekukan kontrak lintas bridge yang dipakai bersama sebelum membuka quote standalone lebih luas
Governance pages hanya membaca rollup	Bisa salah dianggap owner fitur BOS/RKAS	Tegaskan `SC-FOUND` hanya consumer, bukan source of truth BOS/RKAS

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 general availability hanya setelah remote pilot evidence stabil
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_bridge/models/bos_fund.py — BOS fund component/allocation
../scola-odoo-module/scola_account/models/account_budget.py — budget approval workflow
../scola-odoo-module/scola_bos_rkas_bridge/models/budget.py — budget line dan ledger kernel
../scola-odoo-module/scola_bos_rkas_bridge/models/budget_program.py — program RKAS dan ledger entry
../scola-odoo-module/scola_bos_rkas_procurement_bridge/models/purchase_order.py — pengaitan pengadaan ke budget line
../scola-odoo-module/scola_bos_rkas_procurement_bridge/controllers/budget_api.py — inventory budget API
../scola-odoo-module/scola_bos_rkas_governance_bridge/controllers/executive_budget_api.py — ringkasan anggaran principal/executive
../scola-odoo-module/scola_bos_rkas_governance_bridge/controllers/foundation_finance_api.py — rollup finance foundation
../scola-odoo-module/scola_bundle_bos_rkas/__manifest__.py — bundle controlled-rollout SC-BOS