Shariah Governance and Compliance

Fatwa And Ruling Repository

isb-fatwa-and-ruling-repository · isb-governance

A Shariah-native BIAN service domain in Shariah Governance and Compliance. It applies the Catalog functional pattern to the Shariah Ruling, with the Shariah Ruling Directory Entry as its control record — one isolated Spring Boot microservice.

View repository ↗The 48-domain landscape ↗

Business DomainShariah Governance

Functional PatternCatalog

Asset TypeShariah Ruling

Control RecordShariah Ruling Directory Entry

USEWhat it is used for

Representative use cases for the Fatwa And Ruling Repository service domain within a Shariah-compliant core-banking landscape.

Maintain Shariah Ruling records as the authoritative Shariah-governance source
Evidence Shariah compliance for products, contracts, and campaigns before launch
Drive periodic Shariah audit cycles and remediation tracking
Compute/route obligatory religious dues with full auditability

APIBIAN semantic API

Each service domain exposes its control record (Shariah Ruling Directory Entry) 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/shariah-ruling-directory-entry/initiate`	Initiate
GET	`/v1/shariah-ruling-directory-entry/{crId}/retrieve`	Retrieve
PUT	`/v1/shariah-ruling-directory-entry/{crId}/update`	Update
PUT	`/v1/shariah-ruling-directory-entry/{crId}/control`	Control (suspend / resume / terminate)

INTBackend integrations

The systems and standards a real deployment of Fatwa And Ruling Repository would transact with.

Standards: AAOIFI Shariah & accounting standards, IFSB prudential standards
Screening data: Refinitiv/LSEG Islamic indices, IdealRatings
SSB workflow & fatwa management tooling; zakat authorities (e.g. national boards)

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-fatwa-and-ruling-repository
mvn -f isb-fatwa-and-ruling-repository spring-boot:run
curl localhost:8080/v1/service-domain

# or deploy onto Kubernetes (Cilium mesh)
helm upgrade --install isb-fatwa-and-ruling-repository ./helm -n isb-governance

FAQQuestions

What business area does Fatwa And Ruling Repository belong to?

Fatwa And Ruling Repository sits in the Shariah Governance and Compliance business area — the mandatory Shariah-governance layer that supervises, audits and evidences compliance across every Islamic banking line. It follows the BIAN Catalog functional pattern over the Shariah Ruling asset, with the Shariah Ruling Directory Entry 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-governance 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.