How suraj6204/loanguard works
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: app.ts Express API · loanController.ts Loan lifecycle · AuditLog.ts Audit log · api.ts API client
Components 26
Web application
- Application portal
client/src/app/borrower/apply/page.tsx - Status portal
client/src/app/borrower/status/page.tsx - Operations dashboards
client/src/app/dashboard - Login and signup
client/src/app/login/page.tsx - Auth state
client/src/store/authSlice.ts - API client
client/src/services/api.ts
API and access
- Express API
server/src/app.ts - Auth routes
server/src/routes/authRoutes.ts - Borrower routes
server/src/routes/borrowerRoutes.ts - Document routes
server/src/routes/documentRoutes.ts - Loan routes
server/src/routes/loanRoutes.ts - Operations routes
server/src/routes/operationsRoutes.ts - JWT and RBAC
server/src/middleware/auth.ts
Borrower services
- Authentication
server/src/controllers/authController.ts - Profile and eligibility
server/src/controllers/borrowerController.ts - Document validation
server/src/controllers/documentController.ts
Loan operations
- Loan lifecycle
server/src/controllers/loanController.ts - Sales and admin
server/src/controllers/adminController.ts - Audit queries
server/src/controllers/auditController.ts
Persistent records
- User records
server/src/models/User.ts - Document records
server/src/models/Document.ts - Loan records
server/src/models/LoanApplication.ts - Payment records
server/src/models/Payment.ts - Audit log
server/src/models/AuditLog.ts
Other components
- Borrower
- Operations staff
Connections 38
- Borrower → Application portal: submits application
- Borrower → Status portal: tracks status
- Operations staff → Operations dashboards: works loan queues
- Login and signup → Auth state: dispatches auth
client/src/app/login/page.tsx - Auth state → API client: calls auth API
client/src/store/authSlice.ts - Application portal → API client: uses loan APIs
client/src/app/borrower/apply/page.tsx - Status portal → API client: uses loan APIs
client/src/app/borrower/status/page.tsx - Operations dashboards → API client: uses operations APIs
client/src/app/dashboard/collection/page.tsx - API client → Express API: sends API requests
- Express API → Auth routes: mounts auth
server/src/app.ts - Express API → Borrower routes: mounts borrower
server/src/app.ts - Express API → Document routes: mounts documents
server/src/app.ts - Express API → Loan routes: mounts loans
server/src/app.ts - Express API → Operations routes: mounts operations
server/src/app.ts - Auth routes → Authentication: routes to
server/src/routes/authRoutes.ts - Borrower routes → Profile and eligibility: routes to
server/src/routes/borrowerRoutes.ts - Document routes → Document validation: routes to
server/src/routes/documentRoutes.ts - Loan routes → Loan lifecycle: routes to
server/src/routes/loanRoutes.ts - Operations routes → Loan lifecycle: routes queues
server/src/routes/operationsRoutes.ts - Operations routes → Sales and admin: routes reports
server/src/routes/operationsRoutes.ts - Operations routes → Audit queries: routes audit queries
server/src/routes/operationsRoutes.ts - Auth routes → JWT and RBAC: applies access checks
server/src/routes/authRoutes.ts - Loan routes → JWT and RBAC: applies access checks
server/src/routes/loanRoutes.ts - Authentication → User records: reads and writes
server/src/controllers/authController.ts - Authentication → Audit log: records events
server/src/controllers/authController.ts - Profile and eligibility → User records: updates profile
server/src/controllers/borrowerController.ts - Profile and eligibility → Audit log: records eligibility
server/src/controllers/borrowerController.ts - Document validation → Document records: validates and stores
server/src/controllers/documentController.ts - Document validation → Audit log: records validation
server/src/controllers/documentController.ts - Loan lifecycle → Loan records: transitions loans
server/src/controllers/loanController.ts - Loan lifecycle → Document records: checks document
server/src/controllers/loanController.ts - Loan lifecycle → Payment records: records payments
server/src/controllers/loanController.ts - Loan lifecycle → Audit log: records lifecycle
server/src/controllers/loanController.ts - Sales and admin → User records: queries users
server/src/controllers/adminController.ts - Sales and admin → Loan records: queries loans
server/src/controllers/adminController.ts - Sales and admin → Payment records: queries payments
server/src/controllers/adminController.ts - Audit queries → Audit log: queries events
server/src/controllers/auditController.ts - JWT and RBAC → Audit log: logs denied access
server/src/middleware/auth.ts