# pranavjangam500-eng/los-backend architecture

> Architecture diagram of the GitHub repository pranavjangam500-eng/los-backend, 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/pranavjangam500-eng/los-backend
- Repository: https://github.com/pranavjangam500-eng/los-backend

## Overview

This is a multi-tenant Spring Boot Loan Origination System for bank staff, customers, and platform administrators. The principal business journey is lead capture, loan application, and approval, with authentication and tenant routing providing the shared access layer. The README also identifies hardened security, RBAC, and dynamic bank routing as platform capabilities. Most domain controllers and services are listed only in the tree, so their workflow links are shown as unverified; sampled source confirms selected authentication, dashboard, lookup, RBAC, and audit relationships.

Main entry points: [`src/main/java/com/bank/los/bank/loan`](https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/loan) (Loan applications), [`src/main/java/com/bank/los/security/UserPrincipal.java`](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/security/UserPrincipal.java) (User principal), [`src/main/java/com/bank/los/bank/auth/service/AuthenticationService.java`](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/auth/service/AuthenticationService.java) (Authentication), [`src/main/java/com/bank/los/bank/lead`](https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/lead) (Lead capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_origination["Loan origination"]
  node_lead["Lead capture"]
  node_loan["Loan applications"]
  node_approval["Loan approval"]
  node_customer["Customer records"]
  node_products["Loan products"]
  node_bureau["Credit bureau"]
  node_kyc["KYC verification"]
  node_lms["LMS disbursal sync"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication"]
  node_principal["User principal<br/>[UserPrincipal.java]"]
  node_rbac["Bank permissions"]
  node_users["Bank user management<br/>[UserService.java]"]
end

subgraph group_tenancy["Tenant administration"]
  node_organization["Organization provisioning"]
  node_bankadmin["Bank administration"]
  node_dashboard["Bank dashboards"]
end

subgraph group_platform["Shared platform"]
  node_audit["Bank audit log"]
  node_auditstore[("Audit persistence")]
  node_routing["Tenant routing context<br/>[BankContext.java]"]
  node_security["Request security"]
  node_lookups["Bank lookups"]
  node_lookupadmin["Lookup administration"]
end

node_user(("Bank user or customer"))

node_user -.->|"signs in"| node_auth
node_auth -->|"builds identity"| node_principal
node_user -.->|"submits lead"| node_lead
node_lead -.->|"may start"| node_loan
node_user -.->|"applies"| node_loan
node_loan -.->|"requests decision"| node_approval
node_loan -.->|"uses customer data"| node_customer
node_loan -.->|"selects product"| node_products
node_loan -.->|"checks credit"| node_bureau
node_loan -.->|"requests verification"| node_kyc
node_approval -.->|"syncs disbursal"| node_lms
node_principal -.->|"supplies identity"| node_rbac
node_principal -->|"supplies identity"| node_dashboard
node_user -.->|"manages users"| node_users
node_user -.->|"provisions bank"| node_organization
node_organization -.->|"selects tenant"| node_routing
node_security -.->|"protects endpoints"| node_auth
node_rbac -->|"records changes"| node_audit
node_audit -->|"saves log"| node_auditstore
node_lookupadmin -.->|"references service"| node_lookups

click node_lead "https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/lead"
click node_loan "https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/loan"
click node_approval "https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/approval"
click node_customer "https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/customer"
click node_products "https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/product"
click node_bureau "https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/integration/bureau"
click node_kyc "https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/integration/kyc"
click node_lms "https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/integration/lms"
click node_auth "https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/auth/service/AuthenticationService.java"
click node_principal "https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/security/UserPrincipal.java"
click node_rbac "https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/rbac/service/BankRbacService.java"
click node_users "https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/user/service/UserService.java"
click node_organization "https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/administration/organization"
click node_bankadmin "https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/administration"
click node_dashboard "https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/dashboard/service/BankDashboardService.java"
click node_audit "https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/audit/service/BankAuditService.java"
click node_auditstore "https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/audit/repository/BankAuditLogRepository.java"
click node_routing "https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/config/BankContext.java"
click node_security "https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/security/SecurityConfig.java"
click node_lookups "https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/lookup/service/BankLookupService.java"
click node_lookupadmin "https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/administration/lookup/service/AdministrationLookupService.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_lead,node_loan,node_approval,node_customer,node_products,node_bureau,node_kyc,node_lms,node_user toneBlue
class node_auth,node_principal,node_rbac,node_users toneAmber
class node_organization,node_bankadmin,node_dashboard toneMint
class node_audit,node_auditstore,node_routing,node_security,node_lookups,node_lookupadmin toneRose
```

## Components

### Loan origination

- [Lead capture](https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/lead): `src/main/java/com/bank/los/bank/lead`
- [Loan applications](https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/loan): `src/main/java/com/bank/los/bank/loan`
- [Loan approval](https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/approval): `src/main/java/com/bank/los/bank/approval`
- [Customer records](https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/customer): `src/main/java/com/bank/los/bank/customer`
- [Loan products](https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/product): `src/main/java/com/bank/los/bank/product`
- [Credit bureau](https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/integration/bureau): `src/main/java/com/bank/los/bank/integration/bureau`
- [KYC verification](https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/integration/kyc): `src/main/java/com/bank/los/bank/integration/kyc`
- [LMS disbursal sync](https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/bank/integration/lms): `src/main/java/com/bank/los/bank/integration/lms`

### Identity and access

- [Authentication](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/auth/service/AuthenticationService.java): `src/main/java/com/bank/los/bank/auth/service/AuthenticationService.java`
- [User principal](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/security/UserPrincipal.java): `src/main/java/com/bank/los/security/UserPrincipal.java`
- [Bank permissions](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/rbac/service/BankRbacService.java): `src/main/java/com/bank/los/bank/rbac/service/BankRbacService.java`
- [Bank user management](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/user/service/UserService.java): `src/main/java/com/bank/los/bank/user/service/UserService.java`

### Tenant administration

- [Organization provisioning](https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/administration/organization): `src/main/java/com/bank/los/administration/organization`
- [Bank administration](https://github.com/pranavjangam500-eng/los-backend/tree/main/src/main/java/com/bank/los/administration): `src/main/java/com/bank/los/administration`
- [Bank dashboards](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/dashboard/service/BankDashboardService.java): `src/main/java/com/bank/los/bank/dashboard/service/BankDashboardService.java`

### Shared platform

- [Bank audit log](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/audit/service/BankAuditService.java): `src/main/java/com/bank/los/bank/audit/service/BankAuditService.java`
- [Audit persistence](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/audit/repository/BankAuditLogRepository.java): `src/main/java/com/bank/los/bank/audit/repository/BankAuditLogRepository.java`
- [Tenant routing context](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/config/BankContext.java): `src/main/java/com/bank/los/config/BankContext.java`
- [Request security](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/security/SecurityConfig.java): `src/main/java/com/bank/los/security/SecurityConfig.java`
- [Bank lookups](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/bank/lookup/service/BankLookupService.java): `src/main/java/com/bank/los/bank/lookup/service/BankLookupService.java`
- [Lookup administration](https://github.com/pranavjangam500-eng/los-backend/blob/main/src/main/java/com/bank/los/administration/lookup/service/AdministrationLookupService.java): `src/main/java/com/bank/los/administration/lookup/service/AdministrationLookupService.java`

### Other components

- **Bank user or customer**

## Connections

- Bank user or customer → Authentication: signs in
- Authentication → User principal: builds identity (evidence: `src/main/java/com/bank/los/bank/auth/service/AuthenticationService.java`)
- Bank user or customer → Lead capture: submits lead
- Lead capture → Loan applications: may start
- Bank user or customer → Loan applications: applies
- Loan applications → Loan approval: requests decision (evidence: `src/main/java/com/bank/los/bank/approval/service/LoanApprovalService.java`)
- Loan applications → Customer records: uses customer data
- Loan applications → Loan products: selects product (evidence: `src/main/java/com/bank/los/bank/loan/service/LoanApplicationService.java`)
- Loan applications → Credit bureau: checks credit
- Loan applications → KYC verification: requests verification
- Loan approval → LMS disbursal sync: syncs disbursal
- User principal → Bank permissions: supplies identity (evidence: `src/main/java/com/bank/los/bank/rbac/service/BankRbacService.java`)
- User principal → Bank dashboards: supplies identity (evidence: `src/main/java/com/bank/los/bank/dashboard/service/BankDashboardService.java`)
- Bank user or customer → Bank user management: manages users
- Bank user or customer → Organization provisioning: provisions bank
- Organization provisioning → Tenant routing context: selects tenant (evidence: `src/main/java/com/bank/los/administration/organization/service/OrganizationProvisioningService.java`)
- Request security → Authentication: protects endpoints
- Bank permissions → Bank audit log: records changes (evidence: `src/main/java/com/bank/los/bank/rbac/service/BankRbacService.java`)
- Bank audit log → Audit persistence: saves log (evidence: `src/main/java/com/bank/los/bank/audit/service/BankAuditService.java`)
- Lookup administration → Bank lookups: references service (evidence: `src/main/java/com/bank/los/administration/lookup/service/AdministrationLookupService.java`)
