Schema & Semantic Layer

⬇ YAML ⬇ JSON

Loan Analytics Intelligence

loan-analytics v3.0

Analyze loan portfolio performance, delinquency, risk segmentation, pricing optimization, and cross-sell opportunities

Metric Definitions

17 metrics
total_loans
volume neutral

Count of active loans

Unit: count · Format: {value:,}
COUNT(loan_id) WHERE status = 'Active'
total_balance
volume neutral

Sum of all outstanding loan balances

Unit: currency_millions · Format: ${value:.1f}M
SUM(current_balance)
portfolio_yield
profitability ↑ higher

Weighted average interest rate

Unit: percent · Format: {value:.2f}%
Thresholds
warn low 4.5 target 5.5 stretch 6.0
SUM(balance * rate) / SUM(balance)
loan_growth_rate
growth ↑ higher

Year-over-year portfolio growth

Unit: percent · Format: {value:+.1f}%
Thresholds
warn low 4.0 target 8.0 stretch 12.0
(current_balance - prior_year_balance) / prior_year_balance * 100
delinquency_rate
credit_quality ↓ lower

Percentage of loans past due

Unit: percent · Format: {value:.2f}%
Thresholds
target 2.0 warn high 3.0 crit high 4.0 stretch 1.5
delinquent_loans / total_loans * 100
charge_off_rate
credit_quality ↓ lower

Annualized charge-offs as percentage of average loans

Unit: percent · Format: {value:.2f}%
Thresholds
target 0.75 warn high 1.0 crit high 1.5 stretch 0.5
(charge_offs / avg_loans) * 100
net_charge_off_rate
credit_quality ↓ lower

Charge-offs minus recoveries as percentage

Unit: percent · Format: {value:.2f}%
((charge_offs - recoveries) / avg_loans) * 100
early_delinquency_rate
credit_quality ↓ lower

Loans 30-59 days past due

Unit: percent · Format: {value:.2f}%
loans_30_59 / total_loans * 100
prime_concentration
risk ↑ higher

Percentage of portfolio in prime tier

Unit: percent · Format: {value:.1f}%
Thresholds
warn low 50 target 60 stretch 70
prime_balance / total_balance * 100
expected_loss
risk ↓ lower

PD × LGD × EAD across portfolio

Unit: currency_millions · Format: ${value:.2f}M
SUM(probability_default * loss_given_default * exposure)
monthly_originations
growth neutral

New loans originated this month

Unit: currency_millions · Format: ${value:.1f}M
SUM(original_amount) WHERE origination_date IN current_month
origination_count
growth neutral

Number of new loans originated

Unit: count · Format: {value:,}
COUNT(loan_id) WHERE origination_date IN current_month
rate_spread
pricing neutral

Average rate differential to market

Unit: basis_points · Format: {value:+.0f}bps
cu_rate - market_rate
lifetime_expected_loss
risk ↓ lower

CECL lifetime expected credit loss calculated as PD × LGD × EAD across the portfolio

Unit: $ · Format: ${value:,.0f}
Thresholds
target 500000 warn high 750000 crit high 1000000
SUM(probability_of_default * loss_given_default * exposure_at_default)
allowance_coverage_ratio
risk ↑ higher

Ratio of ALLL to lifetime expected losses, indicating provisioning adequacy

Unit: % · Format: {value:.1f}%
Thresholds
crit low 80.0 warn low 100.0 target 120.0 stretch 150.0
alll_balance / lifetime_expected_loss * 100
provision_expense_ratio
risk ↓ lower

Provision for loan losses as a percentage of average loans

Unit: % · Format: {value:.2f}%
Thresholds
target 0.5 warn high 0.75 crit high 1.0
provision_expense / avg_total_loans * 100
cecl_day1_impact
regulatory ↓ lower

Estimated adjustment to allowance upon CECL adoption

Unit: $ · Format: ${value:,.0f}
cecl_required_allowance - current_alll_balance

Portfolio & Risk Definitions

Loan Categories

Product categories for portfolio segmentation and analysis.

🚗
Auto Loans
Vehicle financing
Typical term: 60 months
🏠
Mortgage
First mortgage home loans
Typical term: 360 months
👤
Personal Loans
Unsecured personal loans
Typical term: 48 months
💳
Credit Cards
Revolving credit lines
Revolving
🔑
Home Equity
HELOC and HE loans
Typical term: 180 months
💼
Business Loans
Commercial and business loans
Typical term: 84 months

Risk Tiers

Credit score-based risk classification with typical default rates.

Prime (720+)
Score: 720 - 850
Default rate: 0.8%
Near Prime (660-719)
Score: 660 - 719
Default rate: 2.1%
Subprime (620-659)
Score: 620 - 659
Default rate: 4.5%
Deep Subprime (<620)
Score: 300 - 619
Default rate: 8.2%

Delinquency Buckets

Days past due classification for delinquency tracking.

Current 0 days
30-59 Days 30-59 days
60-89 Days 60-89 days
90+ Days 90+ days

Credit Score Bands

superprime weight: 0.5x
Super-Prime

Lowest risk borrowers with excellent credit history

Range: 740 – 850
prime weight: 1.0x
Prime

Good credit borrowers meeting standard underwriting criteria

Range: 670 – 739
near_prime weight: 2.0x
Near-Prime

Borderline borrowers requiring enhanced monitoring

Range: 580 – 669
subprime weight: 4.0x
Sub-Prime

Higher risk borrowers requiring additional collateral or guarantees

Range: 300 – 579

Segment Definitions

Loan Type

IDName / CharacteristicsFilterDecision Types
auto Auto Loans loan_type = 'auto'
mortgage Mortgage loan_type = 'mortgage'
personal Personal Loans loan_type = 'personal'
credit_card Credit Cards loan_type = 'credit_card'
home_equity Home Equity loan_type = 'home_equity'
business Business Loans loan_type = 'business'

Delinquency Status

IDName / CharacteristicsFilterDecision Types
current Current days_delinquent = 0
early_delinquent Early Delinquent (30-59) days_delinquent BETWEEN 30 AND 59
late_delinquent Late Delinquent (60-89) days_delinquent BETWEEN 60 AND 89
severely_delinquent Severely Delinquent (90+) days_delinquent >= 90

Decision Type Definitions

5 types
delinquency_intervention
credit_quality immediate

Actions to address rising delinquency and prevent charge-offs

delinquency_rate > 2.5 — Delinquency rate above threshold
early_delinquency_rate > 3.0 — Early delinquency trending up
90_plus_balance > 3M — Severely delinquent balance elevated
Available Actions
Enhanced Collection Efforts collections_manager
Loan Workout Program lending_manager
Early Intervention Campaign collections_manager
Skip Tracing Enhancement collections_manager
Outcome Metrics
delinquency_rate charge_off_rate collection_effectiveness
pricing_optimization
pricing monthly

Rate adjustments based on competitive position and margin goals

rate_spread > 50bps — Rates significantly above market
origination_volume < target — Loan production below target
portfolio_yield < 5.0 — Portfolio yield compression
Available Actions
Decrease Loan Rates alco
Increase Loan Rates alco
Promotional Rate Campaign lending_manager
Adjust Risk-Based Pricing alco
Outcome Metrics
portfolio_yield origination_volume market_share
credit_policy_adjustment
risk quarterly

Changes to underwriting standards and risk appetite

charge_off_rate > 1.0 — Charge-offs exceeding threshold
subprime_concentration > 20 — Risk concentration too high
approval_rate anomaly — Approval rate significantly changed
Available Actions
Tighten Underwriting Standards clo
Relax Underwriting Standards clo
Product-Specific Restrictions lending_manager
Implement Concentration Limits clo
Outcome Metrics
charge_off_rate risk_distribution approval_rate
portfolio_growth
growth quarterly

Actions to grow loan portfolio and market share

loan_growth_rate < 5 — Growth rate below target
origination_count < prior_period — Originations declining
market_share declining — Losing competitive position
Available Actions
Loan Marketing Campaign marketing_manager
Indirect Lending Expansion indirect_manager
Digital Lending Enhancement digital_manager
Member Referral Program marketing_manager
Outcome Metrics
loan_growth_rate origination_count market_share
cross_sell_execution
relationship monthly

Actions to deepen member relationships through lending

cross_sell_opportunities > threshold — Significant cross-sell pipeline
single_product_members > 40 — High single-product concentration
relationship_depth < benchmark — Products per member below target
Available Actions
Pre-Approved Loan Campaign marketing_manager
Branch Referral Program retail_manager
Digital Cross-Sell digital_manager
Relationship Pricing lending_manager
Outcome Metrics
cross_sell_conversion products_per_member relationship_revenue

Authority Levels

LevelRoleCan Approve
1 Loan Analyst
2 Collections Manager enhanced_collectionsearly_interventionskip_tracing
3 Lending Manager workout_programpromotional_rateproduct_restrictionsrelationship_pricing
3 Marketing Manager marketing_campaignreferral_programpre_approved_campaign
3 Indirect Lending Manager dealer_expansion
4 Credit Risk Manager risk_based_pricing
5 Chief Financial Officer
5 Chief Lending Officer tighten_standardsloosen_standardsconcentration_limits
5 ALCO Committee rate_decreaserate_increase
6 Executive Team major_policy_changes

Decision States & Workflow

8 states
stateDiagram-v2


    [*] --> surfaced




    [*] --> acknowledged




    [*] --> analyzing




    [*] --> action_planned




    [*] --> action_taken





    outcome_measured --> [*]




    deferred --> [*]




    dismissed --> [*]


                
Primary Workflow Path
Surfaced
Acknowledged
Analyzing
Action Planned
Action Taken
Terminal States:
Outcome Measured (terminal)
Deferred (terminal) req. rationale
Dismissed (terminal) req. rationale

State Definitions

StateIDDescriptionTerminal
Surfaced
surfaced Loan insight identified, awaiting review No
Acknowledged
acknowledged Responsible party has reviewed No
Analyzing
analyzing Impact and root cause analysis in progress No
Action Planned
action_planned Response strategy defined No
Action Taken
action_taken Policy or program implemented No
Outcome Measured
outcome_measured Results tracked and documented Yes
Deferred
deferred Postponed with rationale Yes (requires rationale)
Dismissed
dismissed Not actionable with rationale Yes (requires rationale)

SLA Definitions

Decision TypeResponse WindowEscalation Path
delinquency_intervention 48_hours collections_manager (12_hours)lending_manager (24_hours)clo (48_hours)
pricing_optimization 14_days lending_manager (3_days)cfo (7_days)alco (14_days)
credit_policy_adjustment 30_days credit_risk_manager (7_days)clo (14_days)ceo (30_days)
portfolio_growth 14_days lending_manager (3_days)clo (7_days)ceo (14_days)
cross_sell_execution 7_days marketing_manager (2_days)lending_manager (5_days)clo (7_days)

Entity-Relationship Model

erDiagram
    LOAN {
        string loan_id
        enum loan_type
        currency current_balance
        decimal interest_rate
        integer days_delinquent
        integer credit_score
    }
    DELINQUENCY {
        enum bucket
        currency delinquent_amount
        integer days_past_due
    }
    RISK_SEGMENT {
        enum risk_tier
        decimal probability_of_default
        currency expected_loss
    }
                

Entity Details

Loan
Individual loan accounts
6 attrs
Attribute Type Key
loan_id string
loan_type enum
current_balance currency
interest_rate decimal
days_delinquent integer
credit_score integer
Delinquency
Loan delinquency tracking
3 attrs
Attribute Type Key
bucket enum
delinquent_amount currency
days_past_due integer
Risk Segment
Credit risk classification
3 attrs
Attribute Type Key
risk_tier enum
probability_of_default decimal
expected_loss currency