# suraj6204/loanguard architecture

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

- Interactive diagram: https://gitdiagram.com/suraj6204/loanguard
- Repository: https://github.com/suraj6204/loanguard

## Overview

LoanGuard is a loan lifecycle management system with a Next.js borrower and staff interface backed by an Express API and MongoDB. Borrowers register, maintain a profile, pass eligibility checks, upload validated salary documents, and submit applications; operations staff then sanction or reject, disburse, and collect payments through role-specific queues. The backend enforces loan transitions and records audit events. The README documents capabilities beyond the sampled implementation; connections for those are included only where the README or source index supports them.

Main entry points: [`server/src/app.ts`](https://github.com/suraj6204/loanguard/blob/main/server/src/app.ts) (Express API), [`server/src/controllers/loanController.ts`](https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/loanController.ts) (Loan lifecycle), [`server/src/models/AuditLog.ts`](https://github.com/suraj6204/loanguard/blob/main/server/src/models/AuditLog.ts) (Audit log), [`client/src/services/api.ts`](https://github.com/suraj6204/loanguard/blob/main/client/src/services/api.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_apply_page["Application portal<br/>[page.tsx]"]
  node_status_page["Status portal<br/>[page.tsx]"]
  node_ops_pages["Operations dashboards"]
  node_auth_pages["Login and signup<br/>[page.tsx]"]
  node_auth_state["Auth state<br/>[authSlice.ts]"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_api["API and access"]
  node_express_app["Express API<br/>[app.ts]"]
  node_auth_routes["Auth routes<br/>[authRoutes.ts]"]
  node_borrower_routes["Borrower routes<br/>[borrowerRoutes.ts]"]
  node_document_routes["Document routes<br/>[documentRoutes.ts]"]
  node_loan_routes["Loan routes<br/>[loanRoutes.ts]"]
  node_operations_routes["Operations routes"]
  node_auth_middleware["JWT and RBAC<br/>[auth.ts]"]
end

subgraph group_borrower["Borrower services"]
  node_auth_controller["Authentication<br/>[authController.ts]"]
  node_borrower_controller["Profile and eligibility"]
  node_document_controller["Document validation"]
end

subgraph group_lifecycle["Loan operations"]
  node_loan_controller["Loan lifecycle<br/>[loanController.ts]"]
  node_admin_controller["Sales and admin<br/>[adminController.ts]"]
  node_audit_controller["Audit queries<br/>[auditController.ts]"]
end

subgraph group_records["Persistent records"]
  node_user_store[("User records<br/>[User.ts]")]
  node_document_store[("Document records<br/>[Document.ts]")]
  node_loan_store[("Loan records<br/>[LoanApplication.ts]")]
  node_payment_store[("Payment records<br/>[Payment.ts]")]
  node_audit_store[("Audit log<br/>[AuditLog.ts]")]
end

node_borrower_actor(("Borrower"))
node_staff_actor(("Operations staff"))

node_borrower_actor -->|"submits application"| node_apply_page
node_borrower_actor -->|"tracks status"| node_status_page
node_staff_actor -->|"works loan queues"| node_ops_pages
node_auth_pages -->|"dispatches auth"| node_auth_state
node_auth_state -->|"calls auth API"| node_api_client
node_apply_page -->|"uses loan APIs"| node_api_client
node_status_page -->|"uses loan APIs"| node_api_client
node_ops_pages -->|"uses operations APIs"| node_api_client
node_api_client -->|"sends API requests"| node_express_app
node_express_app -->|"mounts auth"| node_auth_routes
node_express_app -->|"mounts borrower"| node_borrower_routes
node_express_app -->|"mounts documents"| node_document_routes
node_express_app -->|"mounts loans"| node_loan_routes
node_express_app -->|"mounts operations"| node_operations_routes
node_auth_routes -->|"routes to"| node_auth_controller
node_borrower_routes -->|"routes to"| node_borrower_controller
node_document_routes -->|"routes to"| node_document_controller
node_loan_routes -->|"routes to"| node_loan_controller
node_operations_routes -->|"routes queues"| node_loan_controller
node_operations_routes -->|"routes reports"| node_admin_controller
node_operations_routes -->|"routes audit queries"| node_audit_controller
node_auth_routes -->|"applies access checks"| node_auth_middleware
node_loan_routes -->|"applies access checks"| node_auth_middleware
node_auth_controller -->|"reads and writes"| node_user_store
node_auth_controller -->|"records events"| node_audit_store
node_borrower_controller -->|"updates profile"| node_user_store
node_borrower_controller -->|"records eligibility"| node_audit_store
node_document_controller -->|"validates and stores"| node_document_store
node_document_controller -->|"records validation"| node_audit_store
node_loan_controller -->|"transitions loans"| node_loan_store
node_loan_controller -->|"checks document"| node_document_store
node_loan_controller -->|"records payments"| node_payment_store
node_loan_controller -->|"records lifecycle"| node_audit_store
node_admin_controller -->|"queries users"| node_user_store
node_admin_controller -->|"queries loans"| node_loan_store
node_admin_controller -->|"queries payments"| node_payment_store
node_audit_controller -->|"queries events"| node_audit_store
node_auth_middleware -->|"logs denied access"| node_audit_store

click node_apply_page "https://github.com/suraj6204/loanguard/blob/main/client/src/app/borrower/apply/page.tsx"
click node_status_page "https://github.com/suraj6204/loanguard/blob/main/client/src/app/borrower/status/page.tsx"
click node_ops_pages "https://github.com/suraj6204/loanguard/tree/main/client/src/app/dashboard"
click node_auth_pages "https://github.com/suraj6204/loanguard/blob/main/client/src/app/login/page.tsx"
click node_auth_state "https://github.com/suraj6204/loanguard/blob/main/client/src/store/authSlice.ts"
click node_api_client "https://github.com/suraj6204/loanguard/blob/main/client/src/services/api.ts"
click node_express_app "https://github.com/suraj6204/loanguard/blob/main/server/src/app.ts"
click node_auth_routes "https://github.com/suraj6204/loanguard/blob/main/server/src/routes/authRoutes.ts"
click node_borrower_routes "https://github.com/suraj6204/loanguard/blob/main/server/src/routes/borrowerRoutes.ts"
click node_document_routes "https://github.com/suraj6204/loanguard/blob/main/server/src/routes/documentRoutes.ts"
click node_loan_routes "https://github.com/suraj6204/loanguard/blob/main/server/src/routes/loanRoutes.ts"
click node_operations_routes "https://github.com/suraj6204/loanguard/blob/main/server/src/routes/operationsRoutes.ts"
click node_auth_middleware "https://github.com/suraj6204/loanguard/blob/main/server/src/middleware/auth.ts"
click node_auth_controller "https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/authController.ts"
click node_borrower_controller "https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/borrowerController.ts"
click node_document_controller "https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/documentController.ts"
click node_loan_controller "https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/loanController.ts"
click node_admin_controller "https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/adminController.ts"
click node_audit_controller "https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/auditController.ts"
click node_user_store "https://github.com/suraj6204/loanguard/blob/main/server/src/models/User.ts"
click node_document_store "https://github.com/suraj6204/loanguard/blob/main/server/src/models/Document.ts"
click node_loan_store "https://github.com/suraj6204/loanguard/blob/main/server/src/models/LoanApplication.ts"
click node_payment_store "https://github.com/suraj6204/loanguard/blob/main/server/src/models/Payment.ts"
click node_audit_store "https://github.com/suraj6204/loanguard/blob/main/server/src/models/AuditLog.ts"

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_apply_page,node_status_page,node_ops_pages,node_auth_pages,node_auth_state,node_api_client toneBlue
class node_express_app,node_auth_routes,node_borrower_routes,node_document_routes,node_loan_routes,node_operations_routes,node_auth_middleware toneAmber
class node_auth_controller,node_borrower_controller,node_document_controller toneMint
class node_loan_controller,node_admin_controller,node_audit_controller toneRose
class node_user_store,node_document_store,node_loan_store,node_payment_store,node_audit_store,node_borrower_actor,node_staff_actor toneIndigo
```

## Components

### Web application

- [Application portal](https://github.com/suraj6204/loanguard/blob/main/client/src/app/borrower/apply/page.tsx): `client/src/app/borrower/apply/page.tsx`
- [Status portal](https://github.com/suraj6204/loanguard/blob/main/client/src/app/borrower/status/page.tsx): `client/src/app/borrower/status/page.tsx`
- [Operations dashboards](https://github.com/suraj6204/loanguard/tree/main/client/src/app/dashboard): `client/src/app/dashboard`
- [Login and signup](https://github.com/suraj6204/loanguard/blob/main/client/src/app/login/page.tsx): `client/src/app/login/page.tsx`
- [Auth state](https://github.com/suraj6204/loanguard/blob/main/client/src/store/authSlice.ts): `client/src/store/authSlice.ts`
- [API client](https://github.com/suraj6204/loanguard/blob/main/client/src/services/api.ts): `client/src/services/api.ts`

### API and access

- [Express API](https://github.com/suraj6204/loanguard/blob/main/server/src/app.ts): `server/src/app.ts`
- [Auth routes](https://github.com/suraj6204/loanguard/blob/main/server/src/routes/authRoutes.ts): `server/src/routes/authRoutes.ts`
- [Borrower routes](https://github.com/suraj6204/loanguard/blob/main/server/src/routes/borrowerRoutes.ts): `server/src/routes/borrowerRoutes.ts`
- [Document routes](https://github.com/suraj6204/loanguard/blob/main/server/src/routes/documentRoutes.ts): `server/src/routes/documentRoutes.ts`
- [Loan routes](https://github.com/suraj6204/loanguard/blob/main/server/src/routes/loanRoutes.ts): `server/src/routes/loanRoutes.ts`
- [Operations routes](https://github.com/suraj6204/loanguard/blob/main/server/src/routes/operationsRoutes.ts): `server/src/routes/operationsRoutes.ts`
- [JWT and RBAC](https://github.com/suraj6204/loanguard/blob/main/server/src/middleware/auth.ts): `server/src/middleware/auth.ts`

### Borrower services

- [Authentication](https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/authController.ts): `server/src/controllers/authController.ts`
- [Profile and eligibility](https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/borrowerController.ts): `server/src/controllers/borrowerController.ts`
- [Document validation](https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/documentController.ts): `server/src/controllers/documentController.ts`

### Loan operations

- [Loan lifecycle](https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/loanController.ts): `server/src/controllers/loanController.ts`
- [Sales and admin](https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/adminController.ts): `server/src/controllers/adminController.ts`
- [Audit queries](https://github.com/suraj6204/loanguard/blob/main/server/src/controllers/auditController.ts): `server/src/controllers/auditController.ts`

### Persistent records

- [User records](https://github.com/suraj6204/loanguard/blob/main/server/src/models/User.ts): `server/src/models/User.ts`
- [Document records](https://github.com/suraj6204/loanguard/blob/main/server/src/models/Document.ts): `server/src/models/Document.ts`
- [Loan records](https://github.com/suraj6204/loanguard/blob/main/server/src/models/LoanApplication.ts): `server/src/models/LoanApplication.ts`
- [Payment records](https://github.com/suraj6204/loanguard/blob/main/server/src/models/Payment.ts): `server/src/models/Payment.ts`
- [Audit log](https://github.com/suraj6204/loanguard/blob/main/server/src/models/AuditLog.ts): `server/src/models/AuditLog.ts`

### Other components

- **Borrower**
- **Operations staff**

## Connections

- Borrower → Application portal: submits application
- Borrower → Status portal: tracks status
- Operations staff → Operations dashboards: works loan queues
- Login and signup → Auth state: dispatches auth (evidence: `client/src/app/login/page.tsx`)
- Auth state → API client: calls auth API (evidence: `client/src/store/authSlice.ts`)
- Application portal → API client: uses loan APIs (evidence: `client/src/app/borrower/apply/page.tsx`)
- Status portal → API client: uses loan APIs (evidence: `client/src/app/borrower/status/page.tsx`)
- Operations dashboards → API client: uses operations APIs (evidence: `client/src/app/dashboard/collection/page.tsx`)
- API client → Express API: sends API requests
- Express API → Auth routes: mounts auth (evidence: `server/src/app.ts`)
- Express API → Borrower routes: mounts borrower (evidence: `server/src/app.ts`)
- Express API → Document routes: mounts documents (evidence: `server/src/app.ts`)
- Express API → Loan routes: mounts loans (evidence: `server/src/app.ts`)
- Express API → Operations routes: mounts operations (evidence: `server/src/app.ts`)
- Auth routes → Authentication: routes to (evidence: `server/src/routes/authRoutes.ts`)
- Borrower routes → Profile and eligibility: routes to (evidence: `server/src/routes/borrowerRoutes.ts`)
- Document routes → Document validation: routes to (evidence: `server/src/routes/documentRoutes.ts`)
- Loan routes → Loan lifecycle: routes to (evidence: `server/src/routes/loanRoutes.ts`)
- Operations routes → Loan lifecycle: routes queues (evidence: `server/src/routes/operationsRoutes.ts`)
- Operations routes → Sales and admin: routes reports (evidence: `server/src/routes/operationsRoutes.ts`)
- Operations routes → Audit queries: routes audit queries (evidence: `server/src/routes/operationsRoutes.ts`)
- Auth routes → JWT and RBAC: applies access checks (evidence: `server/src/routes/authRoutes.ts`)
- Loan routes → JWT and RBAC: applies access checks (evidence: `server/src/routes/loanRoutes.ts`)
- Authentication → User records: reads and writes (evidence: `server/src/controllers/authController.ts`)
- Authentication → Audit log: records events (evidence: `server/src/controllers/authController.ts`)
- Profile and eligibility → User records: updates profile (evidence: `server/src/controllers/borrowerController.ts`)
- Profile and eligibility → Audit log: records eligibility (evidence: `server/src/controllers/borrowerController.ts`)
- Document validation → Document records: validates and stores (evidence: `server/src/controllers/documentController.ts`)
- Document validation → Audit log: records validation (evidence: `server/src/controllers/documentController.ts`)
- Loan lifecycle → Loan records: transitions loans (evidence: `server/src/controllers/loanController.ts`)
- Loan lifecycle → Document records: checks document (evidence: `server/src/controllers/loanController.ts`)
- Loan lifecycle → Payment records: records payments (evidence: `server/src/controllers/loanController.ts`)
- Loan lifecycle → Audit log: records lifecycle (evidence: `server/src/controllers/loanController.ts`)
- Sales and admin → User records: queries users (evidence: `server/src/controllers/adminController.ts`)
- Sales and admin → Loan records: queries loans (evidence: `server/src/controllers/adminController.ts`)
- Sales and admin → Payment records: queries payments (evidence: `server/src/controllers/adminController.ts`)
- Audit queries → Audit log: queries events (evidence: `server/src/controllers/auditController.ts`)
- JWT and RBAC → Audit log: logs denied access (evidence: `server/src/middleware/auth.ts`)
