Skip to content

Part 10 — System Blueprint

Module Map

The system blueprint is written for an Indian small and medium enterprise (SME) lender that may run branch, direct selling agent (DSA), digital, lending service provider (LSP), and co-lending channels. The design principle is strict state ownership: one module owns a record, other modules consume events or read models. This prevents the common failure where the loan origination system (LOS) says “disbursed”, the loan management system (LMS) has not booked the account, collections does not know the first repayment date, and the credit bureau file is wrong.

Regulatory constraints are module boundaries, not footnotes. Digital loans must route disbursement and repayment directly between the regulated entity (RE) and borrower or permitted end-beneficiary, with no LSP pool account, under the RBI Digital Lending Directions, 2025. KYC data, beneficial owners, ongoing due diligence and record retention belong to a controlled KYC domain under the RBI KYC Master Direction, 2016. Co-lending must maintain each RE’s share, escrow routing, blended borrower disclosure and borrower-level SMA/NPA alignment under the RBI Co-Lending Arrangements Directions, 2025. Income recognition, SMA/NPA tagging and NPA upgradation must be date-true under the RBI IRACP clarification, November 12, 2021 and current IRAC directions.

ModuleOwnsDoes not ownPrimary usersSystem of record tablesKey outbound events
Channel CRMRaw leads, source attribution, campaign, DSA/connector handoff, telecalling disposition before loginCredit decision, KYC verification, sanction, live loan duesSales, call centre, DSA manager, partner managerlead, source_attribution, channel_partner, campaign, lead_contact_eventlead_created, consent_captured, source_locked, lead_login_ready, lead_disqualified
DSA portalDSA lead submission, document upload, coarse status, payout visibilityBureau variables, credit memo, fraud signals, approval authorityDSA, connector, DSA opsdsa_user, dsa_lead_view, dsa_document_upload, payout_claimdsa_lead_submitted, dsa_document_uploaded, payout_hold_marked
Customer portal and DLABorrower self-service, consent capture, offer display, KFS acceptance, service requestsInternal underwriting, internal deviations, collections strategyBorrower, promoter, guarantorportal_session, customer_consent_action, offer_view, kfs_acceptance, service_requestborrower_consent_granted, offer_selected, kfs_accepted, service_request_created
Partner API gatewayAPI authentication, partner application intake, idempotency, partner callbacks, schema validationInternal policy decision, partner commercial settlementLSP, anchor, co-lender, marketplaceapi_client, api_request_log, partner_application_ref, webhook_deliverypartner_application_received, partner_status_delivered, webhook_failed
Consent and privacy serviceConsent artefacts, purpose, data scope, revocation, data-retention instructionParsed underwriting resultsBorrower, compliance, integrationsconsent_artifact, consent_scope, consent_revocation, data_retention_policyconsent_granted, consent_revoked, retention_expired
KYC and AML serviceParty master, customer due diligence (CDD), beneficial owners, CKYC, V-CIP, sanctions/adverse media, periodic KYCCredit approval, loan account accountingKYC ops, AML officer, complianceparty, natural_person, business_entity, kyc_profile, beneficial_owner, screening_hitkyc_verified, kyc_rejected, bo_added, sanctions_hit_cleared, rekyc_due
Document service and DMSDocument requirements, uploads, extraction, verification, executed document vault, versioningDeciding whether a waiver is credit-approvedOperations, sales ops, legal, borrowerdocument_requirement, document_instance, document_extraction, executed_document, vault_packetdocument_uploaded, document_verified, deficiency_raised, document_pack_locked, originals_vaulted
LOS workflowApplication lifecycle from login to loan booking handoff, queue assignment, SLA, conditions, audit trailLive dues, interest accrual, final accounting ledgerSales ops, credit, RCU, legal, valuation, opsapplication, application_party, workflow_task, condition, queue_assignmentapplication_submitted, docs_complete, credit_submitted, sanction_accepted, loan_booking_requested
BRE and decision serviceRule versions, eligibility, scorecards, pricing bands, deviations, automated decisionsHuman committee minute, post-booking repayment accountingCredit policy, risk analytics, credit managerrule_set, rule_version, rule_execution, scorecard_result, deviationbre_executed, rule_failed, deviation_raised, eligibility_approved, pricing_computed
Credit workbenchCredit appraisal memo (CAM), financial spreading, analyst recommendations, committee decisions, DoA resolutionDisbursement maker-checker, cash postingCredit analyst, credit manager, committeecredit_assessment, financial_spread, cam, approval_request, committee_decisioncam_submitted, authority_resolved, credit_approved, credit_rejected, condition_added
Collateral and security serviceCollateral assets, owners, title chain, legal opinion, valuation, insurance, CERSAI/ROC filingsRepayment collections, borrower service requests except releaseLegal, technical, ops, creditcollateral_asset, collateral_owner, legal_opinion, valuation_report, security_charge, cersai_filing, roc_charge_filingcollateral_approved, charge_created, cersai_filed, roc_srn_received, charge_satisfied
Documentation and execution serviceDocument checklist, generation, stamp duty, e-sign/wet-sign evidence, guarantee executionCredit term approval and pricingOperations, legal, borrowerdocument_checklist, stamp_certificate, signature_event, guarantee, documentation_exceptiondocument_generated, stamp_paid, esign_completed, wet_signature_verified, documents_executed
Disbursement serviceCP verification, bank account verification, mandate status, tranche instruction, payment instructionSanction approval, post-booking schedule recalculationOperations maker/checker, treasurydisbursement_request, condition_clearance, bank_account_verification, mandate, tranche, payment_instructioncp_cleared, mandate_activated, payment_initiated, disbursement_posted, disbursement_failed
LMS coreLoan account, facility, repayment schedule, demands, receipts, appropriation, interest, charges, DPD/SMA/NPA, closureNew application underwritingOperations, finance, servicing, collectionsloan_account, facility, schedule_version, repayment_due, loan_transaction, asset_classificationloan_booked, demand_generated, receipt_posted, dpd_changed, loan_closed
Collections platformDelinquency cases, allocation, PTP, tele/field/legal workflows, agency activity, settlement proposalRegulatory asset classification calculation source; it consumes LMS classificationCollections, recovery, agency manager, legaldelinquency_snapshot, collection_case, case_allocation, contact_attempt, ptp, settlement_proposalcase_opened, ptp_recorded, field_visit_completed, settlement_approved, case_closed
Finance and GL adapterAccounting event mapping, GL posting, suspense, reconciliation, DSA payout, tax splitsCustomer-facing statements unless sourced from LMSFinance, treasury, auditaccounting_event, gl_posting, bank_reconciliation, suspense_item, payout_ledgergl_posted, reconciliation_break_created, payout_accrued, payout_reversed
Co-lending and partner ledgerPartner shares, escrow split, blended rate, partner status exchange, DLG set and invocationBase loan schedule; LMS remains source for borrower duesPartner ops, finance, risk, co-lenderco_lending_arrangement, partner_share, escrow_movement, partner_ledger, dlg_set, partner_status_eventpartner_share_booked, escrow_reconciled, partner_dpd_sent, dlg_invoked
Compliance, audit and reportingAudit trail, regulatory evidence, CIC reporting extract, KFS archive, grievance control, access reviewOperational approval except compliance holdsCompliance, internal audit, statutory auditaudit_event, regulatory_report_run, cic_submission, kfs_version, complaint, access_reviewaudit_event_recorded, cic_file_generated, complaint_escalated, access_review_due

The BRE module is detailed in BRE functional specification for decision contracts and BRE runtime architecture for deterministic evaluation, scaling, replay and observability.

ContractProducerConsumersRequired payloadIdempotency keyFailure handling
Lead to applicationChannel CRMLOS, consent servicelead_id, source, product, requested amount, identifiers, consent reflead_idDuplicate creates a dedupe_match, not a second application.
KYC resultKYC serviceLOS, LMS, complianceparty_id, KYC status, risk category, BO status, expiry/re-KYC dateparty_id plus kyc_profile_versionFailed screening places application on compliance hold.
BRE decisionBRELOS, credit workbenchRule version, pass/fail tree, score, limit, tenor, price band, deviationsapplication_id plus rule_version_idExternal dependency failure retries; policy hard fail cannot be suppressed without deviation approval.
Document pack lockDocument serviceLOS, documentation service, creditRequirement status, verified documents, waivers, deficienciesapplication_id plus checklist_versionNew upload after lock creates a new version and reopens verification.
Sanction acceptedCredit workbenchLOS, documentation, KFS archive, co-lendingSanction id, terms, conditions, KFS version, acceptance timestampsanction_idExpired sanction blocks documentation and routes to revalidation.
Loan booking requestDisbursement serviceLMS, finance, co-lendingAccepted sanction, cleared CPs, tranche, mandate, disbursement instructiondisbursement_request_idLMS booking failure rolls LOS to booking_failed; no collections record is opened.
Repayment eventLMSCollections, finance, co-lending, CIC reportingLoan id, receipt, reversal, appropriation, DPD before/afterloan_transaction_idReversal creates compensating event; DPD recomputes from due ledger.
Asset classification eventLMSCollections, finance, risk, co-lendingBorrower id, facility ids, SMA/NPA status, effective date, reasonborrower_id plus classification_dateManual override requires maker-checker because it affects IRAC and CIC reporting.
Recovery agent assignmentCollectionsCustomer portal, notification service, complianceCase id, agency, agent, valid dates, contact channelcase_allocation_idBorrower notification must precede first recovery contact under RBI digital-lending and recovery-agent conduct requirements.
Data objectSource of truthRead-only mirrors allowed inRationale
Party identity and KYC statusKYC and AML serviceLOS, LMS, collections, partner moduleKYC/beneficial-owner duties are regulated under the RBI KYC Master Direction.
Application stateLOS workflow until loan_bookedChannel CRM, portals, partner APIsOrigination queues and pre-booking conditions need one owner.
Credit decision and DoA evidenceCredit workbenchLOS, compliance, auditApproval authority must remain immutable after sanction.
KFS and borrower acceptanceKFS archive with LOS referenceCustomer portal, document service, LMSKFS must preserve APR, charges and schedule disclosure for covered MSME loans under RBI’s KFS circular.
Live dues, DPD and asset classLMSCollections, customer portal, co-lending, financeIRAC classification must be computed from dues, receipts, reversals and waivers, not edited in collections.
Collection strategy and PTPCollections platformLMS, risk dashboardCollections strategy changes daily and should not pollute accounting ledgers.
GL posting and reconciliationFinance and GL adapterLMS, co-lending, reportingAccounting events must reconcile to bank and GL independently of UI status.
Partner share and DLGCo-lending moduleLMS, finance, complianceCo-lending needs partner-wise books, escrow movements and DLG cap tracking.
SliceIncludeExclude until laterExit criteria
Origination MVPCRM lead, LOS, consent, KYC, document checklist, BRE policy gates, credit approval, sanctionCo-lending, advanced scorecards, automated valuationA policy-compliant unsecured loan can reach accepted sanction with audit trail.
Booking MVPDocumentation checklist, e-sign evidence, mandate, disbursement maker-checker, LMS booking, repayment schedule, GL eventTranches, supplier financing, CERSAI filing automationA booked loan has account number, schedule, first due date, accounting event and borrower communication.
Servicing and delinquency MVPDemand generation, receipts, appropriation, DPD/SMA/NPA, collections case opening, PTP, payment linkLegal recovery, repossession, OTSMissed EMI creates correct bucket and collections task from LMS event.
Secured SME extensionCollateral, valuation, legal opinion, security charge, insurance, CERSAI/ROC tracking, vaultComplex consortium security trustee workflowsA loan against property cannot disburse without approved charge or approved exception.
Partner/co-lending extensionPartner APIs, CLA config, partner share, escrow reconciliation, partner DPD exchange, DLG setPortfolio sale/securitisationBoth RE shares reconcile within the 15-calendar-day rule in RBI CLA directions.