How syed-mohsin-raza/meridian-lms works
Meridian LMS is a loan-management platform with customer and staff portals backed by a Spring Boot API. Customers register or sign in, apply for loans, track repayment schedules and make payments; staff review applications, manage employees and permissions, and monitor analytics. The backend also provides audit views and AI-generated credit-risk narratives, with template fallback when AI is unavailable. The graph emphasizes documented workflows and sampled call ownership; several controller, service, and analytics internals are represented at their tree paths because their source was not sampled.
Main entry points: client.ts HTTP API client · LoanService.java Loan application and review · PaymentService.java Payment processing · SpringAiCreditRiskNarrativeService.java Risk narrative generation
Components 33
Web portals
- Customer loan pages
frontend/src/app/(customer)/loans/apply/page.tsx - Staff loan pages
frontend/src/app/admin/loans/page.tsx - Payment pages
frontend/src/app/(customer)/payments/page.tsx - Login and registration
frontend/src/app/(auth)/login/page.tsx - HTTP API client
frontend/src/lib/api/client.ts - Loan API calls
frontend/src/lib/api/loans.ts - Payment API calls
frontend/src/lib/api/payments.ts - Authentication API calls
frontend/src/lib/api/auth.ts
API and identity
- Loan endpoints
backend/src/main/java/com/meridian/lms/controller/LoanController.java - Payment endpoints
backend/src/main/java/com/meridian/lms/controller/PaymentController.java - Authentication endpoints
backend/src/main/java/com/meridian/lms/controller/AuthController.java - Authentication service
backend/src/main/java/com/meridian/lms/service/AuthService.java - JWT service
backend/src/main/java/com/meridian/lms/security/JwtService.java - User repository
backend/src/main/java/com/meridian/lms/repository/UserRepository.java - Employee and permission management
backend/src/main/java/com/meridian/lms/service/EmployeeService.java
Lending operations
- Loan application and review
backend/src/main/java/com/meridian/lms/service/LoanService.java - Payment processing
backend/src/main/java/com/meridian/lms/service/PaymentService.java - Loan repository
backend/src/main/java/com/meridian/lms/repository/LoanRepository.java - Payment repository
backend/src/main/java/com/meridian/lms/repository/PaymentRepository.java - Loan type rules
backend/src/main/java/com/meridian/lms/service/LoanTypeService.java - Credit score updates
backend/src/main/java/com/meridian/lms/service/CreditScoreService.java - PostgreSQL
Insights and oversight
- Analytics
backend/src/main/java/com/meridian/lms/service/AnalyticsService.java - Audit history
backend/src/main/java/com/meridian/lms/service/AuditService.java - Risk narrative endpoint
backend/src/main/java/com/meridian/lms/controller/AiController.java - Risk narrative generation
backend/src/main/java/com/meridian/lms/ai/SpringAiCreditRiskNarrativeService.java - Credit profile aggregation
backend/src/main/java/com/meridian/lms/ai/CreditProfileAggregator.java - Narrative cache
backend/src/main/java/com/meridian/lms/ai/CreditRiskNarrativeCache.java - Template fallback
backend/src/main/java/com/meridian/lms/ai/FallbackNarrativeBuilder.java
Other components
- Customer
- Admin or employee
- AI model provider
- Redis cache
Connections 38
- Customer → Customer loan pages: uses
- Admin or employee → Staff loan pages: uses
- Customer loan pages → Loan API calls: requests
- Staff loan pages → Loan API calls: requests
- Payment pages → Payment API calls: requests
- Login and registration → Authentication API calls: submits credentials
- Loan API calls → HTTP API client: calls
- Payment API calls → HTTP API client: calls
- Authentication API calls → HTTP API client: calls
- HTTP API client → Loan endpoints: HTTP requests
- HTTP API client → Payment endpoints: HTTP requests
- HTTP API client → Authentication endpoints: HTTP requests
- Loan endpoints → Loan application and review: dispatches
- Payment endpoints → Payment processing: dispatches
- Authentication endpoints → Authentication service: dispatches
- Authentication service → User repository: reads and writes
- Authentication service → JWT service: issues token
- Loan application and review → Loan repository: reads and writes
- Loan application and review → Loan type rules: loads loan rules
- Loan application and review → Payment repository: saves schedule
- Loan application and review → Credit score updates: updates score
- Payment processing → Payment repository: reads and writes
- Payment processing → Loan repository: loads loan
- Payment processing → Credit score updates: updates score
- Loan repository → PostgreSQL: persists loan data
- Payment repository → PostgreSQL: persists payment data
- User repository → PostgreSQL: persists user data
- Admin or employee → Employee and permission management: manages staff
- Employee and permission management → User repository: reads and writes
- Admin or employee → Analytics: views metrics
- Admin or employee → Audit history: views audit history
- Customer → Risk narrative endpoint: requests risk narrative
- Risk narrative endpoint → Credit profile aggregation: builds credit profile
- Risk narrative endpoint → Risk narrative generation: requests narrative
- Risk narrative generation → Narrative cache: checks and stores
- Narrative cache → Redis cache: cache access
- Risk narrative generation → AI model provider: generates narrative
- Risk narrative generation → Template fallback: builds fallback