# pranavdhanabalan/fineract architecture

> Architecture diagram of the GitHub repository pranavdhanabalan/fineract, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pranavdhanabalan/fineract
- Repository: https://github.com/pranavdhanabalan/fineract

## Overview

Apache Fineract is a modular core-banking platform exposed over HTTP. The principal user workflow is an authenticated client request to the running backend, which handles banking operations and returns API results; the README confirms the API and tenant/authentication headers, but sampled source does not show the full request-routing chain. The tree documents distinct loan, savings, accounting, reporting, and related domains. Database-query selection, content storage, and searches provide useful internal examples. Some major domain connections are shown as unverified because their callers were not sampled.

Main entry points: [`fineract-provider/src/main/java/org/apache/fineract`](https://github.com/pranavdhanabalan/fineract/tree/develop/fineract-provider/src/main/java/org/apache/fineract) (Fineract backend), [`fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/DatabaseIndependentQueryService.java`](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/DatabaseIndependentQueryService.java) (DB query routing), [`fineract-cob/src/main/java/org/apache/fineract/cob/COBBusinessStepService.java`](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-cob/src/main/java/org/apache/fineract/cob/COBBusinessStepService.java) (Close of business), [`fineract-loan/src/main/java/org/apache/fineract/portfolio/loanaccount/domain/LoanAccountDomainService.java`](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-loan/src/main/java/org/apache/fineract/portfolio/loanaccount/domain/LoanAccountDomainService.java) (Loan servicing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_backend["Fineract backend"]
  node_auth["Tenant authentication"]
  node_clientsearch["Client search"]
  node_adhocsearch["Ad hoc search"]
end

subgraph group_banking["Banking operations"]
  node_loan["Loan servicing"]
  node_schedule["Loan schedules"]
  node_savings["Savings servicing"]
  node_charges["Charges"]
  node_workingcapital["Working capital"]
  node_investor["Investor assets"]
end

subgraph group_accounting["Accounting"]
  node_journal["Journal entries"]
  node_gl["GL accounts"]
  node_closures["GL closures"]
  node_accrual["Periodic accrual"]
  node_provisioning["Provisioning entries"]
end

subgraph group_platform["Platform services"]
  node_dbquery["DB query routing"]
  node_mysql["MySQL metadata"]
  node_postgres["PostgreSQL metadata"]
  node_content["File content store"]
  node_reporting["Reporting"]
end

subgraph group_batch["Business processing"]
  node_cob["Close of business"]
  node_loanids["Loan COB selection"]
  node_savingsids["Savings COB selection"]
end

node_user(("API client"))

node_user -->|"sends API requests"| node_backend
node_user -->|"supplies credentials"| node_auth
node_backend -.->|"routes search"| node_clientsearch
node_backend -.->|"routes queries"| node_adhocsearch
node_backend -.->|"dispatches banking"| node_loan
node_backend -.->|"dispatches banking"| node_savings
node_backend -.->|"dispatches banking"| node_charges
node_backend -.->|"dispatches banking"| node_workingcapital
node_backend -.->|"dispatches banking"| node_investor
node_backend -.->|"dispatches accounting"| node_gl
node_backend -.->|"dispatches accounting"| node_closures
node_backend -.->|"dispatches accounting"| node_accrual
node_backend -.->|"dispatches accounting"| node_provisioning
node_loan -.->|"uses schedule model"| node_schedule
node_backend -.->|"dispatches accounting"| node_journal
node_backend -.->|"dispatches reports"| node_reporting
node_dbquery -->|"selects supported driver"| node_mysql
node_dbquery -->|"selects supported driver"| node_postgres
node_cob -.->|"selects loan partitions"| node_loanids
node_cob -.->|"selects savings partitions"| node_savingsids

click node_backend "https://github.com/pranavdhanabalan/fineract/tree/develop/fineract-provider/src/main/java/org/apache/fineract"
click node_auth "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-security/src/main/java/org/apache/fineract/infrastructure/security/service/AuthTenantDetailsService.java"
click node_clientsearch "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-provider/src/main/java/org/apache/fineract/portfolio/client/service/search/ClientSearchService.java"
click node_adhocsearch "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-provider/src/main/java/org/apache/fineract/portfolio/search/service/SearchReadService.java"
click node_loan "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-loan/src/main/java/org/apache/fineract/portfolio/loanaccount/domain/LoanAccountDomainService.java"
click node_schedule "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-progressive-loan/src/main/java/org/apache/fineract/portfolio/loanaccount/service/ProgressiveLoanInterestScheduleModelParserService.java"
click node_savings "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-savings/src/main/java/org/apache/fineract/portfolio/savings/service/SavingsAccountWritePlatformService.java"
click node_charges "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-charge/src/main/java/org/apache/fineract/portfolio/charge/service/ChargeReadPlatformService.java"
click node_workingcapital "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-working-capital-loan/src/main/java/org/apache/fineract/portfolio/workingcapitalloan/domain/WorkingCapitalLoanWriteOffDomainService.java"
click node_investor "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-investor/src/main/java/org/apache/fineract/investor/service/AccountingService.java"
click node_journal "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-accounting/src/main/java/org/apache/fineract/accounting/journalentry/service/JournalEntryWritePlatformService.java"
click node_gl "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-accounting/src/main/java/org/apache/fineract/accounting/glaccount/service/GLAccountWritePlatformServiceJpaRepositoryImpl.java"
click node_closures "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-accounting/src/main/java/org/apache/fineract/accounting/closure/service/GLClosureWritePlatformServiceJpaRepositoryImpl.java"
click node_accrual "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-accounting/src/main/java/org/apache/fineract/accounting/accrual/service/AccrualAccountingWritePlatformService.java"
click node_provisioning "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-accounting/src/main/java/org/apache/fineract/accounting/provisioning/service/ProvisioningEntriesReadPlatformService.java"
click node_dbquery "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/DatabaseIndependentQueryService.java"
click node_mysql "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/MySQLQueryService.java"
click node_postgres "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/PostgreSQLQueryService.java"
click node_content "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-document/src/main/java/org/apache/fineract/infrastructure/contentstore/service/FileContentStoreService.java"
click node_reporting "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-report/src/main/java/org/apache/fineract/infrastructure/report/service/ReportingProcessService.java"
click node_cob "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-cob/src/main/java/org/apache/fineract/cob/COBBusinessStepService.java"
click node_loanids "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-cob/src/main/java/org/apache/fineract/cob/service/RetrieveIdService.java"
click node_savingsids "https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-savings/src/main/java/org/apache/fineract/cob/savings/RetrieveSavingsIdService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_backend,node_auth,node_clientsearch,node_adhocsearch,node_user toneBlue
class node_loan,node_schedule,node_savings,node_charges,node_workingcapital,node_investor toneAmber
class node_journal,node_gl,node_closures,node_accrual,node_provisioning toneMint
class node_dbquery,node_mysql,node_postgres,node_content,node_reporting toneRose
class node_cob,node_loanids,node_savingsids toneIndigo
```

## Components

### API and access

- [Fineract backend](https://github.com/pranavdhanabalan/fineract/tree/develop/fineract-provider/src/main/java/org/apache/fineract): `fineract-provider/src/main/java/org/apache/fineract`
- [Tenant authentication](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-security/src/main/java/org/apache/fineract/infrastructure/security/service/AuthTenantDetailsService.java): `fineract-security/src/main/java/org/apache/fineract/infrastructure/security/service/AuthTenantDetailsService.java`
- [Client search](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-provider/src/main/java/org/apache/fineract/portfolio/client/service/search/ClientSearchService.java): `fineract-provider/src/main/java/org/apache/fineract/portfolio/client/service/search/ClientSearchService.java`
- [Ad hoc search](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-provider/src/main/java/org/apache/fineract/portfolio/search/service/SearchReadService.java): `fineract-provider/src/main/java/org/apache/fineract/portfolio/search/service/SearchReadService.java`

### Banking operations

- [Loan servicing](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-loan/src/main/java/org/apache/fineract/portfolio/loanaccount/domain/LoanAccountDomainService.java): `fineract-loan/src/main/java/org/apache/fineract/portfolio/loanaccount/domain/LoanAccountDomainService.java`
- [Loan schedules](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-progressive-loan/src/main/java/org/apache/fineract/portfolio/loanaccount/service/ProgressiveLoanInterestScheduleModelParserService.java): `fineract-progressive-loan/src/main/java/org/apache/fineract/portfolio/loanaccount/service/ProgressiveLoanInterestScheduleModelParserService.java`
- [Savings servicing](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-savings/src/main/java/org/apache/fineract/portfolio/savings/service/SavingsAccountWritePlatformService.java): `fineract-savings/src/main/java/org/apache/fineract/portfolio/savings/service/SavingsAccountWritePlatformService.java`
- [Charges](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-charge/src/main/java/org/apache/fineract/portfolio/charge/service/ChargeReadPlatformService.java): `fineract-charge/src/main/java/org/apache/fineract/portfolio/charge/service/ChargeReadPlatformService.java`
- [Working capital](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-working-capital-loan/src/main/java/org/apache/fineract/portfolio/workingcapitalloan/domain/WorkingCapitalLoanWriteOffDomainService.java): `fineract-working-capital-loan/src/main/java/org/apache/fineract/portfolio/workingcapitalloan/domain/WorkingCapitalLoanWriteOffDomainService.java`
- [Investor assets](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-investor/src/main/java/org/apache/fineract/investor/service/AccountingService.java): `fineract-investor/src/main/java/org/apache/fineract/investor/service/AccountingService.java`

### Accounting

- [Journal entries](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-accounting/src/main/java/org/apache/fineract/accounting/journalentry/service/JournalEntryWritePlatformService.java): `fineract-accounting/src/main/java/org/apache/fineract/accounting/journalentry/service/JournalEntryWritePlatformService.java`
- [GL accounts](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-accounting/src/main/java/org/apache/fineract/accounting/glaccount/service/GLAccountWritePlatformServiceJpaRepositoryImpl.java): `fineract-accounting/src/main/java/org/apache/fineract/accounting/glaccount/service/GLAccountWritePlatformServiceJpaRepositoryImpl.java`
- [GL closures](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-accounting/src/main/java/org/apache/fineract/accounting/closure/service/GLClosureWritePlatformServiceJpaRepositoryImpl.java): `fineract-accounting/src/main/java/org/apache/fineract/accounting/closure/service/GLClosureWritePlatformServiceJpaRepositoryImpl.java`
- [Periodic accrual](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-accounting/src/main/java/org/apache/fineract/accounting/accrual/service/AccrualAccountingWritePlatformService.java): `fineract-accounting/src/main/java/org/apache/fineract/accounting/accrual/service/AccrualAccountingWritePlatformService.java`
- [Provisioning entries](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-accounting/src/main/java/org/apache/fineract/accounting/provisioning/service/ProvisioningEntriesReadPlatformService.java): `fineract-accounting/src/main/java/org/apache/fineract/accounting/provisioning/service/ProvisioningEntriesReadPlatformService.java`

### Platform services

- [DB query routing](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/DatabaseIndependentQueryService.java): `fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/DatabaseIndependentQueryService.java`
- [MySQL metadata](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/MySQLQueryService.java): `fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/MySQLQueryService.java`
- [PostgreSQL metadata](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/PostgreSQLQueryService.java): `fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/PostgreSQLQueryService.java`
- [File content store](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-document/src/main/java/org/apache/fineract/infrastructure/contentstore/service/FileContentStoreService.java): `fineract-document/src/main/java/org/apache/fineract/infrastructure/contentstore/service/FileContentStoreService.java`
- [Reporting](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-report/src/main/java/org/apache/fineract/infrastructure/report/service/ReportingProcessService.java): `fineract-report/src/main/java/org/apache/fineract/infrastructure/report/service/ReportingProcessService.java`

### Business processing

- [Close of business](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-cob/src/main/java/org/apache/fineract/cob/COBBusinessStepService.java): `fineract-cob/src/main/java/org/apache/fineract/cob/COBBusinessStepService.java`
- [Loan COB selection](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-cob/src/main/java/org/apache/fineract/cob/service/RetrieveIdService.java): `fineract-cob/src/main/java/org/apache/fineract/cob/service/RetrieveIdService.java`
- [Savings COB selection](https://github.com/pranavdhanabalan/fineract/blob/develop/fineract-savings/src/main/java/org/apache/fineract/cob/savings/RetrieveSavingsIdService.java): `fineract-savings/src/main/java/org/apache/fineract/cob/savings/RetrieveSavingsIdService.java`

### Other components

- **API client**

## Connections

- API client → Fineract backend: sends API requests (evidence: `README.md`)
- API client → Tenant authentication: supplies credentials (evidence: `README.md`)
- Fineract backend → Client search: routes search (evidence: `fineract-provider/src/main/java/org/apache/fineract/portfolio/client/service/search/ClientSearchService.java`)
- Fineract backend → Ad hoc search: routes queries (evidence: `fineract-provider/src/main/java/org/apache/fineract/portfolio/search/service/SearchReadService.java`)
- Fineract backend → Loan servicing: dispatches banking
- Fineract backend → Savings servicing: dispatches banking
- Fineract backend → Charges: dispatches banking
- Fineract backend → Working capital: dispatches banking
- Fineract backend → Investor assets: dispatches banking
- Fineract backend → GL accounts: dispatches accounting
- Fineract backend → GL closures: dispatches accounting
- Fineract backend → Periodic accrual: dispatches accounting
- Fineract backend → Provisioning entries: dispatches accounting
- Loan servicing → Loan schedules: uses schedule model
- Fineract backend → Journal entries: dispatches accounting
- Fineract backend → Reporting: dispatches reports
- DB query routing → MySQL metadata: selects supported driver (evidence: `fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/DatabaseIndependentQueryService.java`)
- DB query routing → PostgreSQL metadata: selects supported driver (evidence: `fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/DatabaseIndependentQueryService.java`)
- Close of business → Loan COB selection: selects loan partitions
- Close of business → Savings COB selection: selects savings partitions
