# praveenkumar123a/loan-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/praveenkumar123a/loan-management-system
- Repository: https://github.com/praveenkumar123a/loan-management-system

## Overview

This is a role-based loan-management system with a React frontend and a Spring backend. Applicants register, submit loan applications and documents, track decisions and repayment schedules, and pay EMIs; loan officers verify documents, while managers handle approval and disbursement. The frontend routes users to role-specific screens, and backend controllers delegate domain operations to services. The tree also shows product, recommendation, notification, profile, and payment capabilities, but their detailed runtime connections are not established by the excerpts. Dashed edges mark those unverified relationships.

Main entry points: [`frontend/loan-frontend/src/pages`](https://github.com/praveenkumar123a/loan-management-system/tree/main/frontend/loan-frontend/src/pages) (Applicant and staff screens), [`src/main/java/com/nexturn/lms/service/LoanApplicationService.java`](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/service/LoanApplicationService.java) (Application service), [`src/main/java/com/nexturn/lms/service/UserService.java`](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/service/UserService.java) (User service), [`src/main/java/com/nexturn/lms/controller/DocumentController.java`](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/DocumentController.java) (Document verification)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_web_routes["Role-based routes<br/>[App.js]"]
  node_web_pages["Applicant and staff screens"]
  node_api_client["API client<br/>[axiosConfig.js]"]
end

subgraph group_intake["Application intake"]
  node_auth["Authentication"]
  node_applications["Loan applications"]
  node_documents["Document verification"]
  node_profiles["Applicant profiles"]
  node_recommendations["Recommendations"]
end

subgraph group_servicing["Loan servicing"]
  node_approvals["Approval decisions"]
  node_disbursement["Loan disbursement"]
  node_repayment["EMI schedules"]
  node_payments["EMI payments"]
  node_notifications["Notifications"]
end

subgraph group_domain["Domain and persistence"]
  node_loan_service["Application service"]
  node_approval_service["Approval service"]
  node_document_service["Document service"]
  node_user_service["User service<br/>[UserService.java]"]
  node_records[("Loan records")]
  node_disbursement_record[("Disbursement record<br/>[Disbursement.java]")]
  node_user_record[("User record<br/>[User.java]")]
end

node_user(("User"))

node_user -->|"uses"| node_web_routes
node_web_routes -->|"routes to"| node_web_pages
node_web_pages -.->|"requests via"| node_api_client
node_api_client -.->|"calls API"| node_applications
node_web_pages -.->|"authenticates through"| node_auth
node_web_pages -.->|"submits and tracks"| node_applications
node_web_pages -.->|"uploads documents"| node_documents
node_web_pages -.->|"supports review"| node_approvals
node_web_pages -.->|"supports disbursement"| node_disbursement
node_web_pages -.->|"views schedule"| node_repayment
node_web_pages -.->|"pays installments"| node_payments
node_applications -->|"loads applicant"| node_user_service
node_applications -->|"submits or reads"| node_loan_service
node_documents -->|"loads application"| node_loan_service
node_documents -->|"loads officer"| node_user_service
node_documents -->|"uploads or verifies"| node_document_service
node_approvals -->|"decides"| node_approval_service
node_approvals -->|"loads application"| node_loan_service
node_approvals -->|"loads manager"| node_user_service
node_disbursement -->|"loads application"| node_loan_service
node_disbursement -->|"loads disburser"| node_user_service
node_disbursement -->|"reads record"| node_disbursement_record
node_loan_service -.->|"manages applications"| node_records
node_approval_service -.->|"updates decisions"| node_records
node_document_service -.->|"associates documents"| node_records
node_user_service -.->|"manages users"| node_user_record
node_repayment -.->|"uses disbursement"| node_disbursement_record

click node_web_routes "https://github.com/praveenkumar123a/loan-management-system/blob/main/frontend/loan-frontend/src/App.js"
click node_web_pages "https://github.com/praveenkumar123a/loan-management-system/tree/main/frontend/loan-frontend/src/pages"
click node_api_client "https://github.com/praveenkumar123a/loan-management-system/blob/main/frontend/loan-frontend/src/api/axiosConfig.js"
click node_auth "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/AuthController.java"
click node_applications "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/LoanApplicationController.java"
click node_documents "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/DocumentController.java"
click node_profiles "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/ApplicantProfileController.java"
click node_recommendations "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/RecommendationController.java"
click node_approvals "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/ApprovalController.java"
click node_disbursement "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/DisbursementController.java"
click node_repayment "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/EmiScheduleController.java"
click node_payments "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/PaymentController.java"
click node_notifications "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/NotificationController.java"
click node_loan_service "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/service/LoanApplicationService.java"
click node_approval_service "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/service/ApprovalService.java"
click node_document_service "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/service/DocumentService.java"
click node_user_service "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/service/UserService.java"
click node_records "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/entity/LoanApplication.java"
click node_disbursement_record "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/entity/Disbursement.java"
click node_user_record "https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/entity/User.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_web_routes,node_web_pages,node_api_client,node_user toneBlue
class node_auth,node_applications,node_documents,node_profiles,node_recommendations toneAmber
class node_approvals,node_disbursement,node_repayment,node_payments,node_notifications toneMint
class node_loan_service,node_approval_service,node_document_service,node_user_service,node_records,node_disbursement_record,node_user_record toneRose
```

## Components

### Web application

- [Role-based routes](https://github.com/praveenkumar123a/loan-management-system/blob/main/frontend/loan-frontend/src/App.js): `frontend/loan-frontend/src/App.js`
- [Applicant and staff screens](https://github.com/praveenkumar123a/loan-management-system/tree/main/frontend/loan-frontend/src/pages): `frontend/loan-frontend/src/pages`
- [API client](https://github.com/praveenkumar123a/loan-management-system/blob/main/frontend/loan-frontend/src/api/axiosConfig.js): `frontend/loan-frontend/src/api/axiosConfig.js`

### Application intake

- [Authentication](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/AuthController.java): `src/main/java/com/nexturn/lms/controller/AuthController.java`
- [Loan applications](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/LoanApplicationController.java): `src/main/java/com/nexturn/lms/controller/LoanApplicationController.java`
- [Document verification](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/DocumentController.java): `src/main/java/com/nexturn/lms/controller/DocumentController.java`
- [Applicant profiles](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/ApplicantProfileController.java): `src/main/java/com/nexturn/lms/controller/ApplicantProfileController.java`
- [Recommendations](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/RecommendationController.java): `src/main/java/com/nexturn/lms/controller/RecommendationController.java`

### Loan servicing

- [Approval decisions](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/ApprovalController.java): `src/main/java/com/nexturn/lms/controller/ApprovalController.java`
- [Loan disbursement](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/DisbursementController.java): `src/main/java/com/nexturn/lms/controller/DisbursementController.java`
- [EMI schedules](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/EmiScheduleController.java): `src/main/java/com/nexturn/lms/controller/EmiScheduleController.java`
- [EMI payments](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/PaymentController.java): `src/main/java/com/nexturn/lms/controller/PaymentController.java`
- [Notifications](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/controller/NotificationController.java): `src/main/java/com/nexturn/lms/controller/NotificationController.java`

### Domain and persistence

- [Application service](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/service/LoanApplicationService.java): `src/main/java/com/nexturn/lms/service/LoanApplicationService.java`
- [Approval service](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/service/ApprovalService.java): `src/main/java/com/nexturn/lms/service/ApprovalService.java`
- [Document service](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/service/DocumentService.java): `src/main/java/com/nexturn/lms/service/DocumentService.java`
- [User service](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/service/UserService.java): `src/main/java/com/nexturn/lms/service/UserService.java`
- [Loan records](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/entity/LoanApplication.java): `src/main/java/com/nexturn/lms/entity/LoanApplication.java`
- [Disbursement record](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/entity/Disbursement.java): `src/main/java/com/nexturn/lms/entity/Disbursement.java`
- [User record](https://github.com/praveenkumar123a/loan-management-system/blob/main/src/main/java/com/nexturn/lms/entity/User.java): `src/main/java/com/nexturn/lms/entity/User.java`

### Other components

- **User**

## Connections

- User → Role-based routes: uses (evidence: `frontend/loan-frontend/src/App.js`)
- Role-based routes → Applicant and staff screens: routes to (evidence: `frontend/loan-frontend/src/App.js`)
- Applicant and staff screens → API client: requests via (evidence: `frontend/loan-frontend/src/pages/officer/Dashboard.jsx`)
- API client → Loan applications: calls API
- Applicant and staff screens → Authentication: authenticates through
- Applicant and staff screens → Loan applications: submits and tracks
- Applicant and staff screens → Document verification: uploads documents
- Applicant and staff screens → Approval decisions: supports review
- Applicant and staff screens → Loan disbursement: supports disbursement
- Applicant and staff screens → EMI schedules: views schedule
- Applicant and staff screens → EMI payments: pays installments
- Loan applications → User service: loads applicant (evidence: `src/main/java/com/nexturn/lms/controller/LoanApplicationController.java`)
- Loan applications → Application service: submits or reads (evidence: `src/main/java/com/nexturn/lms/controller/LoanApplicationController.java`)
- Document verification → Application service: loads application (evidence: `src/main/java/com/nexturn/lms/controller/DocumentController.java`)
- Document verification → User service: loads officer (evidence: `src/main/java/com/nexturn/lms/controller/DocumentController.java`)
- Document verification → Document service: uploads or verifies (evidence: `src/main/java/com/nexturn/lms/controller/DocumentController.java`)
- Approval decisions → Approval service: decides (evidence: `src/main/java/com/nexturn/lms/controller/ApprovalController.java`)
- Approval decisions → Application service: loads application (evidence: `src/main/java/com/nexturn/lms/controller/ApprovalController.java`)
- Approval decisions → User service: loads manager (evidence: `src/main/java/com/nexturn/lms/controller/ApprovalController.java`)
- Loan disbursement → Application service: loads application (evidence: `src/main/java/com/nexturn/lms/controller/DisbursementController.java`)
- Loan disbursement → User service: loads disburser (evidence: `src/main/java/com/nexturn/lms/controller/DisbursementController.java`)
- Loan disbursement → Disbursement record: reads record (evidence: `src/main/java/com/nexturn/lms/controller/DisbursementController.java`)
- Application service → Loan records: manages applications (evidence: `src/main/java/com/nexturn/lms/service/LoanApplicationService.java`)
- Approval service → Loan records: updates decisions (evidence: `src/main/java/com/nexturn/lms/service/ApprovalService.java`)
- Document service → Loan records: associates documents (evidence: `src/main/java/com/nexturn/lms/service/DocumentService.java`)
- User service → User record: manages users (evidence: `src/main/java/com/nexturn/lms/service/UserService.java`)
- EMI schedules → Disbursement record: uses disbursement (evidence: `src/main/java/com/nexturn/lms/controller/EmiScheduleController.java`)
