Monetra Core is die hart van die Monetra-ekosisteem. Dit is die afgestroopte, hoëprestasie-enjin wat uitsluitlik ontwerp is vir finansiële korrektheid.
Terwyl die volledige Monetra-raamwerk grootboeke, ouditspore en komplekse finansiële instrumente bied, doen Monetra Core een ding en doen dit perfek: veilige finansiële rekenkunde.
Dit bestaan vir ontwikkelaars wat die betroubaarheid van presiese geldhantering nodig het, maar hul eie abstraksies daarbo wil bou. Dit is die primitiewe laag - die "fisika-enjin" vir jou finansiële toepassing.
Die Missie: Nul Dubbelsinnigheid
In finansiële sagteware is dubbelsinnigheid 'n fout. 10 / 3 is nie 3.33 nie. Dit is 'n bewerking wat 'n kwosiënt en 'n res oplewer, en jou kode moet besluit wat om met daardie res te doen.
Monetra Core dwing hierdie besluite om eksplisiet te wees. Dit bied die noodsaaklike tipes en bewerkings om te verseker dat:
- Geld word nooit as 'n sweefpunt behandel nie.
- Geldeenhede word nooit implisiet gemeng nie.
- Afronding is nooit toevallig nie.
Wat Is Binne "Core"?
Monetra Core is ontwerp om liggewig en nul-afhanklikheid te wees. Dit sluit slegs die nie-onderhandelbare primitiewe vir finansiële ingenieurswese in.
1. Die Money-Tipe
'n Suiwer, onveranderlike voorstelling van monetêre waarde. Dit stoor die bedrag in kleiner eenhede (soos heelgetal sente) en dra die geldeenheidkode as deel van sy tipe-handtekening.
// Dit is onmoontlik om geldeenhede per ongeluk te meng
const prys = new Money(1000, "USD");
const versending = new Money(500, "EUR");
// Dit gooi onmiddellik 'n samestellingstyd- of looptyd-fout
const totaal = prys.add(versending);
2. Presiese Rekenkunde
Standaard wiskundige bewerkings (add, subtract, multiply, allocate) wat presisie waarborg.
- Toewysing: Verdeel 'n monetêre bedrag in dele sonder om 'n enkele sent te verloor.
- Skaal: Vermenigvuldig met 'n faktor (soos 'n belastingkoers) met eksplisiete afrondingstrategieë.
3. Geldeenheid-Register
'n Minimale, uitbreidbare register vir geldeenheid-definisies. Dit kom met standaard ISO 4217-geldeenhede, maar laat jou toe om pasgemaakte tokens, lojaliteitspunte of interne krediete te definieer.
Hoekom Core Gebruik?
Jy mag Monetra Core bo die volledige Monetra-raamwerk kies as:
- Jy 'n biblioteek bou: Jy wil finansiële tipes uitvoer sonder om 'n groot afhanklikheidsboom op jou gebruikers af te dwing.
- Jy het jou eie persistensielaag: Jy het nie Monetra se grootboek of ouditgeskiedenis nodig nie omdat jy data op 'n spesifieke manier stoor (bv. 'n pasgemaakte SQL-skema of 'n blokketting).
- Bondelgrootte is belangrik: Jy loop in 'n bedienerlose funksie of 'n randwerker en het die kleinste moontlike voetspoor nodig.
Die "Core"-Filosofie
Monetra Core volg die Unix-filosofie: doen een ding en doen dit goed.
Dit respekteer die feit dat finansiële stelsels divers is. 'n Kripto-beurs, 'n salarisverskafter en 'n e-handel-afrekening het baie verskillende behoeftes vir berging en verslagdoening. Maar hulle deel almal dieselfde behoefte aan korrekte wiskunde.
Monetra Core los die wiskunde op. Die res is aan jou.
Kenmerke in 'n Oogopslag
- Onveranderlik by Verstek: Waardes verander nooit; bewerkings gee nuwe instansies terug.
- Afrondingstrategieë: Volle ondersteuning vir "Rond Half Op", "Rond Half Ewe" (Bankiersafronding), en meer.
- Toewysingalgoritmes: Verdeel fondse (bv. die verdeling van 'n $100-rekening in 3 rigting) terwyl die totale waarde bewaar word ($33.33, $33.33, $33.34).
- Tipe-Veiligheid: Benut TypeScript om finansiële foute tydens samestellingstyd op te vang.
Voorbeeld: Die Toewysingsprobleem
Die klassieke toets van enige finansiële biblioteek is hoe dit verdeling hanteer.
import { Money, Currency } from "@zugobite/monetra-core";
const rekening = new Money(100, Currency.USD); // $1.00
const verdeling = rekening.allocate([1, 1, 1]);
// Resultaat:
// [34 sent, 33 sent, 33 sent]
// Totaal: 100 sent. Niks verlore nie.
Monetra Core hanteer die "resverdeling" outomaties en verseker dat die som van die dele altyd gelyk is aan die geheel.
Waar Kan Ek Meer Leer?
- Bewaarplek: GitHub-bewaarplek
- NPM-Pakket: Amptelike NPM-pakket
Monetra Core is die fondament. Bou daarop met vertroue.