Deposits and Investment Accounts

Profit Calculation And Distribution

isb-profit-calculation-and-distribution · isb-deposits

A Shariah-native BIAN service domain in Deposits and Investment Accounts. It applies the Process functional pattern to the Profit Distribution Run, with the Profit Distribution Run Procedure as its control record — one isolated Spring Boot microservice.

View repository ↗The 48-domain landscape ↗

Business DomainProfit Management

Functional PatternProcess

Asset TypeProfit Distribution Run

Control RecordProfit Distribution Run Procedure

USEWhat it is used for

Representative use cases for the Profit Calculation And Distribution service domain within a Shariah-compliant core-banking landscape.

Run month-end distribution: pool income → weighted balances → Mudarib share → holder credits
Apply Profit Equalization Reserve smoothing with AAOIFI-compliant disclosure
Publish calculation lineage for SSB review and customer queries
Re-run hypothetical scenarios before changing weightings or fees

APIBIAN semantic API

Each service domain exposes its control record (Profit Distribution Run Procedure) through uniform BIAN action terms. Java 21 · Spring Boot 3, with OpenAPI at /swagger-ui.html.

Method	Path	BIAN action
GET	`/v1/service-domain`	Service metadata
POST	`/v1/profit-distribution-run-procedure/initiate`	Initiate
GET	`/v1/profit-distribution-run-procedure/{crId}/retrieve`	Retrieve
PUT	`/v1/profit-distribution-run-procedure/{crId}/update`	Update
PUT	`/v1/profit-distribution-run-procedure/{crId}/control`	Control (suspend / resume / terminate)

INTBackend integrations

The systems and standards a real deployment of Profit Calculation And Distribution would transact with.

Islamic core profit engines (iMAL, FLEXCUBE Islamic)
AAOIFI FAS-aligned accounting; actuarial/reserve tooling

RUNRun it yourself

Each domain is its own standalone Spring Boot repository — clone and run in seconds, or deploy onto Kubernetes with the bundled Helm chart.

# run this domain standalone
git clone https://github.com/Sreenivas-Sadhu-Prabhakara/isb-profit-calculation-and-distribution
mvn -f isb-profit-calculation-and-distribution spring-boot:run
curl localhost:8080/v1/service-domain

# or deploy onto Kubernetes (Cilium mesh)
helm upgrade --install isb-profit-calculation-and-distribution ./helm -n isb-deposits

FAQQuestions

What business area does Profit Calculation And Distribution belong to?

Profit Calculation And Distribution sits in the Deposits and Investment Accounts business area — Shariah-compliant deposit and investment accounts, where returns come from profit-sharing and safekeeping rather than interest. It follows the BIAN Process functional pattern over the Profit Distribution Run asset, with the Profit Distribution Run Procedure as its control record.

How is this isolated from conventional banking?

Completely. The Islamic landscape shares no code, repositories, namespaces or events with the conventional platform. This domain lives in the isb-deposits namespace with an isb-* repository and com.bank.islamic package, so the two can never mix by accident.

Is this a certified Shariah-compliant product?

No. It is an educational reference implementation in the BIAN service-domain style. Actual Shariah compliance of any real deployment requires certification by a qualified Shariah Supervisory Board. Standards referenced: AAOIFI, IFSB, IIFM.