How pranavdhanabalan/fineract works
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 Fineract backend · DatabaseIndependentQueryService.java DB query routing · COBBusinessStepService.java Close of business · LoanAccountDomainService.java Loan servicing
Components 24
API and access
- Fineract backend
fineract-provider/src/main/java/org/apache/fineract - Tenant authentication
fineract-security/src/main/java/org/apache/fineract/infrastructure/security/service/AuthTenantDetailsService.java - Client search
fineract-provider/src/main/java/org/apache/fineract/portfolio/client/service/search/ClientSearchService.java - Ad hoc search
fineract-provider/src/main/java/org/apache/fineract/portfolio/search/service/SearchReadService.java
Banking operations
- Loan servicing
fineract-loan/src/main/java/org/apache/fineract/portfolio/loanaccount/domain/LoanAccountDomainService.java - Loan schedules
fineract-progressive-loan/src/main/java/org/apache/fineract/portfolio/loanaccount/service/ProgressiveLoanInterestScheduleModelParserService.java - Savings servicing
fineract-savings/src/main/java/org/apache/fineract/portfolio/savings/service/SavingsAccountWritePlatformService.java - Charges
fineract-charge/src/main/java/org/apache/fineract/portfolio/charge/service/ChargeReadPlatformService.java - Working capital
fineract-working-capital-loan/src/main/java/org/apache/fineract/portfolio/workingcapitalloan/domain/WorkingCapitalLoanWriteOffDomainService.java - Investor assets
fineract-investor/src/main/java/org/apache/fineract/investor/service/AccountingService.java
Accounting
- Journal entries
fineract-accounting/src/main/java/org/apache/fineract/accounting/journalentry/service/JournalEntryWritePlatformService.java - GL accounts
fineract-accounting/src/main/java/org/apache/fineract/accounting/glaccount/service/GLAccountWritePlatformServiceJpaRepositoryImpl.java - GL closures
fineract-accounting/src/main/java/org/apache/fineract/accounting/closure/service/GLClosureWritePlatformServiceJpaRepositoryImpl.java - Periodic accrual
fineract-accounting/src/main/java/org/apache/fineract/accounting/accrual/service/AccrualAccountingWritePlatformService.java - Provisioning entries
fineract-accounting/src/main/java/org/apache/fineract/accounting/provisioning/service/ProvisioningEntriesReadPlatformService.java
Platform services
- DB query routing
fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/DatabaseIndependentQueryService.java - MySQL metadata
fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/MySQLQueryService.java - PostgreSQL metadata
fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/PostgreSQLQueryService.java - File content store
fineract-document/src/main/java/org/apache/fineract/infrastructure/contentstore/service/FileContentStoreService.java - Reporting
fineract-report/src/main/java/org/apache/fineract/infrastructure/report/service/ReportingProcessService.java
Business processing
- Close of business
fineract-cob/src/main/java/org/apache/fineract/cob/COBBusinessStepService.java - Loan COB selection
fineract-cob/src/main/java/org/apache/fineract/cob/service/RetrieveIdService.java - Savings COB selection
fineract-savings/src/main/java/org/apache/fineract/cob/savings/RetrieveSavingsIdService.java
Other components
- API client
Connections 20
- API client → Fineract backend: sends API requests
README.md - API client → Tenant authentication: supplies credentials
README.md - Fineract backend → Client search: routes search
fineract-provider/src/main/java/org/apache/fineract/portfolio/client/service/search/ClientSearchService.java - Fineract backend → Ad hoc search: routes queries
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
fineract-core/src/main/java/org/apache/fineract/infrastructure/core/service/database/DatabaseIndependentQueryService.java - DB query routing → PostgreSQL metadata: selects supported driver
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