Files
proxmox/docs/04-configuration/mifos-omnl-central-bank
defiQUG 95522d3bca
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
feat(omnl): HYBX-BATCH-001 package, rail scripts, regulatory docs, CI
- Add OMNL/CBK Indonesia submission and audit binder docs, manifests, attestations
- Add scripts/omnl transaction-package pipeline, LEI/PvP helpers, jq/lib fixtures
- Update entity master data, MASTER_INDEX, TODOS, dbis-rail docs and rulebook
- Add proof_package/regulatory skeleton and transaction package zip + snapshot JSON
- validate-omnl-rail workflow, forge-verification-proxy tweak, .gitignore hygiene
- Bump smom-dbis-138 (cronos verify docs/scripts) and explorer-monorepo (SPA + env report)

Made-with: Cursor
2026-03-24 18:11:36 -07:00
..

OMNL Central Bank Configuration (Master Plan 2)

Configuration documentation for Apache Fineract + Mifos X as the OMNL (Organisation Mondiale du Numérique) Central Bank core ledger and monetary operations platform. Aligned with the OMNL/Shamrayan Detail Sheet and Master Plan 2 scope.

Entity and scope

  • System owner / ledger authority: OMNL (Organisation Mondiale du Numérique L.P.B.C.).
  • Deployment: VMID 5800 (192.168.11.85), mifos.d-bis.org.
  • Scope: General Ledger (GL), currencies and special units (GRU, SDR, XAU), money supply layers (M00, M0, M1), FX and revaluation, regulatory reporting dimensions, audit trail.

Documents in this folder

Document Description
README.md This overview.
MIGRATION_AND_LEDGER_ALLOCATION_MEMORANDUM.md Migration & ledger allocation — Opening balance, Treasury Denomination Conversion (Option A), client registry, T-001T-001BT-008; compliance summary (§8.5).
LEDGER_ALLOCATION_GL_MAPPING.md GL mapping and implementation — Memo GL codes (1000, 1050, 2000, 2100, 3000) to Fineract; journal entry posting.
OMNL_JOURNAL_LEDGER_MATRIX.md Journal/ledger matrix — Head Office + all entities; full GL; IPSAS compliance; API posting to OMNL Hybx. Machine-readable omnl-journal-matrix.json.
LEDGER_ALLOCATION_POSTING_RUNBOOK.md One-page runbook — Pre-posting checklist, journal entry table, post-posting reconciliation, sign-off and audit.
FINERACT_API_REFERENCE.md Fineract REST API for currency, GL, exchange rates; GRU/SDR/XAU support.
CHART_OF_ACCOUNTS.md OMNL CoA structure, account codes, M00/M0/M1 mapping.
CURRENCY_AND_UNITS.md ISO-4217 plus GRU, SDR, XAU, XAG and rounding/tradability.
FX_AND_VALUATION.md XAU triangulation, rate matrix, revaluation, unrealized/realized accounts.
REGULATORY_AND_REPORTING.md Monetary aggregates, reserve adequacy, FX limits, audit.
POST_DEPLOYMENT_VALIDATION_CHECKLIST.md Post-deployment validation and sign-off.
SAMAMA_OFFICE_AND_5B_M1_TRANSFER.md Samama Group LLC (Azerbaijan) — Create office and transfer 5B USD M1 from Head Office (Phase C interoffice pattern). Script: scripts/omnl/omnl-office-create-samama.sh.
OMNL_OFFICES_POPULATE.md Populate entities as Offices (219 from OMNL_ENTITY_MASTER_DATA.json); remove as clients.
OMNL_PHASE_C_INTEROFFICE_DUE_TO_DUE_FROM.md Phase C interoffice (1410/2410/2100); T-Samama 5B.
OPERATING_RAILS.md Controls + reconciliation: Journal schema, guardrails, closures, idempotency, resolve_ids, audit packet, reversal, maker-checker, monitoring, CI.
OFFICE_20_AUDIT_PACKET.md Office 20 audit packet layout (snapshot, computed_balances, recent JEs, manifest).
OFFICE_20_DR_RUNBOOK.md Disaster recovery: backups, reversal by referenceNumber, recovery steps.
OMNL_PRODUCT_NAMESPACE_OFFICE20.md Product naming and accounting convention for Office 20 (B/C readiness).
OFFICE_2_SHAMRAYAN_RUNBOOK.md Office 2 (Shamrayan Enterprises) — Funding tranche Rail B (HO → Office 2), audit, closure, artifact packaging, upload; P2P settlement pointer.
CRUNCHYGALAXY_OFFICE_AND_1B_FUNDING.md Crunchygalaxy (Office 21) — Create office + 1.0B M1 funding (Rail B), audit, closure, packaging, upload.
P2P_SETTLEMENT_CRUNCHYGALAXY_RAIL.md P2P banking rail: HYBX → CrunchyGalaxy settlement (request/response/capture, mirror entry, close package).
OMNL_OFFICE_ADDRESS_BOOK.md Address book: Per-office API Banking Rail instructions and secrets reference (vault path only; no secrets in repo).
OMNL_OFFICE_MASTER_RUNBOOK_INDEX.md Master Runbook index: Every office has one Master Runbook and optional sub-runbooks (funding, P2P, audit, DR, upload).
BANK_KANAYA_OFFICE_RUNBOOK.md Bank Kanaya (OMNL office 22) — HYBX-BATCH-001 beneficiary; create office: omnl-office-create-bank-kanaya.sh; PvP JEs: omnl-pvp-post-clearing-bank-kanaya.sh.
INDONESIA_MASTER_PROOF_MANIFEST.md Indonesia submission — Master proof manifest for BI/MoF package (HYBX-BATCH-001).
INDONESIA_CENTRAL_BANK_SUBMISSION_BINDER.md Six-volume binder structure; build via scripts/omnl/build-transaction-package-zip.sh.
INDONESIA_SAMPLE_COVER_AND_TOC.md Transmission-ready cover letter + master TOC (metadata in YAML front matter).
OMNL_API_TRANSACTION_PACKAGE.md omnl_transaction_package_snapshot.json for regulator Section 2.
PvP_MULTILATERAL_NET_SETTLEMENT_BANK_KANAYA.md PvP / multilateral net narrative for Bank Kanaya batch.
INDONESIA_PACKAGE_4_995_EVIDENCE_STANDARD.md 4.995 per-category evidence standard + honesty clause.
INDONESIA_SUBMISSION_PACKAGE_GRADE_AND_SCORECARD.md Scorecard; targets 4.995 per row (not 5.0).
HYBX_BATCH_001_OPERATOR_CHECKLIST.md End-to-end operator checklist — Fineract, zip build, verify, 4.995 strict, transmission.
OMNL_BANKING_DIRECTORS_AND_LEI.md OMNL LEI + directors/officers roster; links lei.info/98450070C57395F6B906.

Scripts

Idempotent configuration scripts live in scripts/mifos/central-bank-config/. Run in order: setup-currencies.shsetup-coa.shsetup-fx-revaluation.shvalidate-config.sh.

Governance

Configurations are deterministic, auditable, and suitable for sovereign, regulatory, and institutional review. Shamrayan Enterprises is an authorized client (ISS, S2S) within defined access constraints.