fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com>
48 lines
2.5 KiB
Markdown
48 lines
2.5 KiB
Markdown
# OMNL Central Bank Configuration — Fineract/Mifos (VMID 5800)
|
|
|
|
Idempotent scripts and data for Master Plan 2: Apache Fineract + Mifos X Central Bank configuration for **OMNL** (Organisation Mondiale du Numérique). Target: VMID 5800 (192.168.11.85), reachable at `mifos.d-bis.org` or `http://192.168.11.85`.
|
|
|
|
## Required environment variables
|
|
|
|
Set in project root `.env` (do not commit). Used by the scripts when calling the Fineract API:
|
|
|
|
| Variable | Description | Example |
|
|
|----------|-------------|---------|
|
|
| `MIFOS_BASE_URL` | Base URL of Fineract API | `https://mifos.d-bis.org` or `http://192.168.11.85` |
|
|
| `MIFOS_TENANT` | Fineract tenant identifier | `default` |
|
|
| `MIFOS_USER` | API user (admin) | `mifos` |
|
|
| `MIFOS_PASSWORD` | API password | *(set after first login)* |
|
|
|
|
Optional:
|
|
|
|
| Variable | Description |
|
|
|----------|-------------|
|
|
| `MIFOS_INSECURE` | Set to `1` to allow self-signed or invalid TLS (e.g. local/dev) |
|
|
|
|
## Scripts
|
|
|
|
| Script | Purpose |
|
|
|--------|---------|
|
|
| `setup-currencies.sh` | Create/update currencies and special units (ISO-4217 subset + GRU, SDR, XAU, XAG). Idempotent (GET before POST). |
|
|
| `setup-coa.sh` | Create OMNL Chart of Accounts (GL accounts: Assets, Liabilities, Equity, Income, Expenses; M00/M0/M1 tagging in codes/names). Idempotent. |
|
|
| `setup-fx-revaluation.sh` | Create exchange-rate definitions (XAU as reference where applicable) and GL accounts for unrealized/realized FX P&L. Idempotent. |
|
|
| `validate-config.sh` | Verify currencies, CoA structure, and key mappings exist (GET-based checks). |
|
|
|
|
## Execution order
|
|
|
|
1. `./scripts/mifos/central-bank-config/setup-currencies.sh`
|
|
2. `./scripts/mifos/central-bank-config/setup-coa.sh`
|
|
3. `./scripts/mifos/central-bank-config/setup-fx-revaluation.sh`
|
|
4. `./scripts/mifos/central-bank-config/validate-config.sh`
|
|
|
|
Run from **project root** so that `config/ip-addresses.conf` and `.env` are available. Scripts source `config/ip-addresses.conf` and optionally `.env`.
|
|
|
|
## Documentation
|
|
|
|
- Configuration overview, CoA mapping, and validation checklist: [docs/04-configuration/mifos-omnl-central-bank/](../../docs/04-configuration/mifos-omnl-central-bank/).
|
|
- Deployment runbook for VMID 5800: [docs/04-configuration/MIFOS_R630_02_DEPLOYMENT.md](../../docs/04-configuration/MIFOS_R630_02_DEPLOYMENT.md).
|
|
|
|
## Governance
|
|
|
|
OMNL is system owner and ledger authority. Configurations are deterministic, auditable, and suitable for sovereign/regulatory review. See Master Plan 2 and OMNL/Shamrayan Detail Sheet.
|