Early Salary Loan System

byMilan Ajudiya

Early Salary Loan (Phase 1) AI Model Design Principles All classification models across this engagement follow the same architectural pattern: • Algorithm: Random Forest / Gradient Boosting Decision Tree (GBDT) • Output: Continuous probability score in [0, 1] range — not a binary label • Threshold system: Double-threshold (approve / uncertain / reject zones) • Accuracy metric: AUC-ROC (Area Under the Receiver Operating Characteristic Curve) • Uncertainty quantification: Configurable uncertain band between two thresholds Double-Threshold Decision Framework Every model outputs a score S ∈ [0, 1]. Two configurable thresholds (T_low and T_high) divide outcomes into three zones: Zone Score Range Decision Action AUTO-APPROVE S ≥ T_high Automatically approved Loan disbursed without human review UNCERTAIN T_low ≤ S < T_high Escalate to admin Human reviews and makes final call AUTO-REJECT S < T_low Automatically rejected Loan declined; notification sent Admin Control Panel — Features A web-based admin panel is delivered across all products with the following controls: • Real-time score distribution histogram — shows how many applicants fall in each zone • Adjustable T_low and T_high sliders with live AUC / expected repayment-rate preview • Daily/monthly budget caps with configurable auto vs. manual split • Warning banner when threshold changes significantly alter projected repayment rate • Audit log of all threshold changes with timestamp and admin identity 2A.1 Background & Objective This is a new greenfield product. The concept — commonly known as Earned Wage Access or Early Salary — enables salaried employees to borrow against their upcoming salary when they face a cash shortfall before payday. Key characteristics: • Target borrowers: salaried individuals who run out of funds before salary credit (typically 25th–30th of month) • Loan amount: up to 100% of monthly salary • Repayment: auto-deducted from incoming salary upon credit (typically 5th–10th of next month) • Revenue model: interest-based (unlike the hospital product) • The client will use the same CRM (new account/module) for case management Objective: Build the complete product from scratch — user-facing portal, ML-powered approval model with interest rate prediction, and admin dashboard. 2A.2 Scope of Work 2A.2.1 User-Facing Application Portal (Frontend) • Responsive web application (mobile-first) for loan applications • Application form fields (minimum required; extensible): ◦ Full name, mobile number, email ◦ Employer name, employment type (permanent / contractual), designation ◦ Monthly net salary, salary credit date ◦ Bank account details (for disbursement and auto-debit setup) ◦ Loan amount requested and purpose ◦ CIBIL score (self-declared; verified separately) ◦ Bank statement upload (last 3 months, PDF) ◦ Aadhaar / PAN for KYC • Real-time form validation and document upload with virus scanning • Application status tracker (submitted / under review / approved / rejected) • Loan agreement display and e-sign integration (DigiLocker or similar) • Disbursement status and repayment schedule view 2A.2.2 ML Approval & Interest Rate Model • Data sources: application form fields, CIBIL score, bank statement analysis, salary verification • Bank statement parser: extract monthly credits, debits, EMI patterns, minimum balance trends, bounce history • Feature engineering: debt-to-income ratio, salary consistency score, loan-to-salary ratio, employment tenure proxy • Model 1 — Approval Classifier: Random Forest / GBDT outputting probability score [0,1] with double-threshold framework • Model 2 — Interest Rate Regressor: Gradient Boosting Regressor predicting optimal interest rate (%) conditional on approval; rate higher for riskier profiles • Both models trained on synthetic seed data initially; retrained when live data accumulates • AUC-ROC curve stored per model version; admin panel shows repayment-rate projection at any threshold • Uncertainty quantification: cases in uncertain band surfaced to human reviewer with model confidence score 2A.2.3 CRM Integration • New CRM module / account setup for Early Salary product • Application data from portal flows into CRM on submission • AI service writes approval score, interest rate recommendation, and decision (auto/uncertain/reject) back to CRM • Approved cases: trigger disbursement workflow in CRM • Auto-debit mandate registration workflow (NACH/eNACH) triggered post-approval 2A.2.4 Admin Dashboard • All features from shared architecture (threshold controls, budget caps, score distribution, AUC preview, audit log) • Additional panels specific to Early Salary: ◦ Interest rate distribution chart across approved cases ◦ Salary verification status tracker ◦ Repayment schedule calendar with expected inflows ◦ Early warning list: borrowers with salary credit overdue by >2 days 2A.2.5 Testing & Deployment • Backend API unit + integration tests • Frontend cross-browser and mobile UAT • Model validation report (AUC, precision-recall, feature importance) • Security review: OWASP top-10 checklist for financial application • Production deployment with CI/CD pipeline • Monitoring: model performance dashboards, API uptime, error rate alerting 2A.3 Deliverables # Deliverable Format When 1 Product Requirements Document (PRD) PDF End of Week 2 2 UI/UX Wireframes & Prototype Figma / PDF End of Week 4 3 User Application Portal (Frontend) Web application End of Week 9 4 Bank Statement Parser Module Python service + docs End of Week 8 5 Approval Classifier Model + Model Card Artefact + PDF End of Week 10 6 Interest Rate Regressor Model + Card Artefact + PDF End of Week 10 7 AI Inference Service Deployed microservice End of Week 11 8 CRM Integration Layer Source code + deployment End of Week 12 9 Admin Dashboard Web application End of Week 13 10 Security Review Report PDF End of Week 14 11 Production Deployment & Runbook Live system + docs End of Week 16 2A.4 Timeline & Milestones Phase Activity Duration Phase 1 Requirements Gathering & PRD Weeks 1–2 (10 working days) Phase 2 UI/UX Design & Wireframing Weeks 3–4 (10 working days) Phase 3 Frontend Development (Application Portal) Weeks 5–9 (25 working days) Phase 4 Bank Statement Parser + Feature Engineering Weeks 5–8 (concurrent, 20 days) Phase 5 ML Model Development (Approval + Interest Rate) Weeks 9–10 (10 working days) Phase 6 AI Service + CRM Integration Weeks 11–12 (10 working days) Phase 7 Admin Dashboard Development Weeks 12–13 (10 working days) Phase 8 QA, Security Review, UAT Weeks 14–15 (10 working days) Phase 9 Production Deployment & Handover Week 16 (5 working days) TOTAL End-to-end Phase 1 delivery 16 Weeks (~80 working days) 2A.5 Assumptions & Dependencies • Client provides CRM credentials and API access in Week 1 • Client confirms preferred KYC/e-sign vendor (DigiLocker, Aadhaar eKYC, etc.) by Week 2 • NACH/eNACH mandate registration partner identified and integrated by client by Week 10 • Seed/synthetic dataset for initial model training approved by client • CIBIL API access (if required for live score fetch) procured by client • Cloud hosting, domain, and SSL provisioned by client 2A.6 Out of Scope • Native iOS / Android mobile application • Payroll system integration with employer HR software • Collection / recovery workflows (covered in Phase 2) • Regulatory compliance filing (RBI NBFC guidelines compliance is client's responsibility)  

ApplicationApplicationsDisbursementLoginRepaymentTrackerAuditLogDashboard
Application

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirement Document
Page 1 of 7

Early Salary Loan System

Introduction

The Early Salary Loan System is designed to provide salaried employees with access to loans against their upcoming salary. This document outlines the system requirements for the Early Salary Loan System, focusing on the functionalities and features necessary to support this service.

System Overview

The Early Salary Loan System is a greenfield project aimed at enabling salaried employees to borrow against their upcoming salary when they face a cash shortfall before payday. The system will include a user-facing portal for loan applications, an ML-powered approval model, and an admin dashboard for managing the loan process. The system will be restricted to employees only, ensuring that only salaried individuals can access and use the application.

Page 2 of 7

Functional Requirements

  • As an Employee, I should be able to apply for a loan through a responsive web application.
  • As an Employee, I should be able to fill out an application form with fields such as full name, mobile number, email, employer name, employment type, designation, monthly net salary, salary credit date, bank account details, loan amount requested, and purpose.
  • As an Employee, I should be able to upload necessary documents like bank statements and KYC documents.
  • As an Employee, I should be able to track the status of my loan application.
  • As an Employee, I should be able to view the loan agreement and sign it electronically.
  • As an Employee, I should be able to view the disbursement status and repayment schedule.
  • As an Admin, I should be able to view a real-time score distribution histogram.
  • As an Admin, I should be able to adjust T_low and T_high sliders and preview live AUC and expected repayment rates.
  • As an Admin, I should be able to set daily/monthly budget caps and configure auto vs. manual split.
  • As an Admin, I should be able to view an audit log of all threshold changes.
  • As an Admin, I should be able to access additional panels specific to Early Salary, such as interest rate distribution, salary verification status, and repayment schedule calendar.
  • As an Admin, I should be able to view and manage application details, including AI scoring, manual overrides, and document verification.
  • As an Admin, I should be able to control thresholds, view score distributions, and manage budget caps.
  • As an Employee, I should be able to view my active loan summary, repayment schedule, and loan history.
  • As an Admin, I should be able to manage the Application Detail Page with all specified UI components and functionality.
  • As an Admin, I should be able to manage the Threshold Control Page with all specified UI components and functionality.
  • As an Employee, I should be able to access the Borrower Dashboard with all specified UI components and functionality.

User Personas

  • Employee: A salaried individual who applies for a loan through the system.
  • Admin: A system administrator who manages the loan approval process and monitors system performance.
Page 3 of 7

Core User Flows

  • Employee submits loan application -> uploads documents -> tracks application status -> views and signs loan agreement -> views disbursement and repayment schedule.
  • Admin monitors score distribution -> adjusts thresholds -> reviews uncertain applications -> manages budget caps -> audits threshold changes.
  • Admin reviews application details -> uses AI scoring -> performs manual overrides if necessary -> verifies documents.
  • Employee views active loan summary -> checks repayment schedule -> accesses loan history.
  • Admin manages Application Detail Page -> adjusts AI Score Card -> performs manual overrides -> reviews personal and employment details.
  • Admin manages Threshold Control Page -> adjusts threshold sliders -> sets budget caps -> reviews impact preview.
  • Employee accesses Borrower Dashboard -> views active loan summary -> checks repayment schedule -> performs quick actions.

Visuals Colors and Theme

  • primary: #1E3A8A (Deep Blue)
  • primary_light: #3B82F6 (Light Blue)
  • secondary: #F59E0B (Amber)
  • accent: #EF4444 (Red)
  • highlight: #FBBF24 (Gold)
  • bg: #F3F4F6 (Light Gray)
  • surface: rgba(255, 255, 255, 0.8) (White)
  • text: #111827 (Dark Gray)
  • text_muted: #6B7280 (Muted Gray)
  • border: rgba(209, 213, 219, 0.2) (Light Gray)
Page 4 of 7

Signature Design Concept

The homepage of the Early Salary Loan System will feature an interactive 3D cityscape where each building represents a different section of the application. Users can navigate through the city by clicking on buildings, which will expand to reveal detailed information and interactive forms. This concept will be implemented using @react-three/fiber and @react-three/drei for a seamless 3D experience. The cityscape will dynamically change based on the time of day, providing a unique and engaging user experience.

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, providing a layered depth effect as users scroll through the page. Decorative elements will move at different speeds to create a visually rich first impression, while real content will scroll naturally. Internal pages will adopt a "static" interaction model to prioritize layout clarity and reading speed.

Non-Functional Requirements

  • The system must ensure secure access control, restricting access to employees only.
  • The application should support real-time form validation and document upload with virus scanning.
  • The system should provide high availability and uptime, with monitoring for model performance and API errors.
Page 5 of 7

Tech Stack

  • Frontend: React for Web
  • Backend: Python, FastAPI
  • Database: MySQL
  • AI Models: Random Forest, Gradient Boosting Decision Tree (GBDT)
  • AI Tools: Litellm, Langchain
  • Orchestration: Docker, Kubernetes

Assumptions and Constraints

  • The client will provide CRM credentials and API access.
  • The client will confirm the preferred KYC/e-sign vendor by Week 2.
  • The client will identify and integrate the NACH/eNACH mandate registration partner by Week 10.
  • The client will procure CIBIL API access if required for live score fetch.
  • Cloud hosting, domain, and SSL will be provisioned by the client.

Glossary

  • AUC-ROC: Area Under the Receiver Operating Characteristic Curve
  • CIBIL: Credit Information Bureau (India) Limited
  • KYC: Know Your Customer
  • NACH/eNACH: National Automated Clearing House
  • UAT: User Acceptance Testing
Page 6 of 7

Application Detail Page (Admin)

  • Header Bar: Displays applicant name, avatar initials, application ID, submission date, status badge, assigned officer, and back button.
  • AI Score Card: Shows score gauge, zone label, confidence level, top 5 feature importance factors, model's recommended action, and recommended interest rate.
  • Manual Override Panel: Includes Approve/Reject/Request More Info buttons, editable interest rate, loan amount, and mandatory notes.
  • Personal Details: Displays name, DOB, gender, PAN, Aadhaar, address, mobile, email, and KYC status.
  • Employment Details: Shows employer name, type, designation, tenure, official email, and office address.
  • Loan Request: Details amount, purpose, disbursement date, repayment date, recommended interest rate, and total repayable.
  • Bank Statement Analysis: Provides average monthly credit/debit, net savings rate, salary credit consistency, EMI obligations, bounce count, and minimum balance trend.
  • CIBIL Summary: Displays score, report date, active loans count, total outstanding, and overdue accounts flag.
  • Document Viewer: Inline PDF viewer for uploaded documents with status and reject reason input.
  • Communication Log: Timeline of all emails/SMS sent to applicant with timestamp and content preview.

Threshold Control Page (Admin)

  • Score Distribution Panel: Histogram of today's applicants with color bands and count labels per zone.
  • Threshold Sliders: T_low and T_high sliders with live preview and warning banner for significant changes.
  • Budget Cap Controls: Daily/monthly auto-approval cap inputs, auto vs manual split, and current utilization bar.
  • Impact Preview Panel: Table showing current vs proposed thresholds with approval rate, expected repayment rate, and estimated disbursement.
  • Save Controls: Save Changes button with confirmation modal and Cancel/Revert options.
  • Threshold History Log: Table of changes with timestamp, admin identity, and optional notes.
Page 7 of 7

Borrower Dashboard

  • Active Loan Summary Card: Displays amount borrowed, interest rate, total repayable, remaining amount, due date, and progress bar.
  • NACH Alert Banner: Warning for auto-debit setup with CTA button.
  • Repayment Schedule: Table of instalment details with status.
  • Quick Actions: Options to download loan agreement, repayment receipt, contact support, and early repayment.
  • Loan History: List of past loans with detail view.
  • Apply for New Loan CTA: Shown if no active loan and conditions met.
  • Profile Snapshot: Displays name, mobile, employer, NACH status, and KYC status.
Login: Sign In
Dashboard: View Overview
Applications: Browse List
Application: Review Details
Application: AI Score Review
Application: Manual Override
Application: Verify Documents
AuditLog: View Changes
AuditLog: Adjust Thresholds
AuditLog: Set Budget Caps
AuditLog: Preview Impact