# lilipoornima/knd_cdap_ds_09 architecture

> Architecture diagram of the GitHub repository lilipoornima/knd_cdap_ds_09, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lilipoornima/knd_cdap_ds_09
- Repository: https://github.com/lilipoornima/knd_cdap_ds_09

## Overview

This repository is a research dashboard for explainable financial inclusion and risk analysis. A user enters through the Streamlit app and explores component pages; the financial-inclusion workflow presents validated profiles, subgroup gaps, explanations, and individual decision support. Backend research code also covers credit scoring, market risk, and fraud detection. The README documents the financial-inclusion processing stages and broad capabilities; sampled imports support several UI and credit-assessment links. Other backend-to-dashboard wiring is not established by the available excerpts.

Main entry points: [`frontend/financial_inclusion/decision_support.py`](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/decision_support.py) (Decision Workflow), [`backend/src/credit_risk/home_credit/prediction.py`](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/credit_risk/home_credit/prediction.py) (Home Credit Scoring), [`frontend/app.py`](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/app.py) (Dashboard Entry), [`frontend/pages/2_Financial_Inclusion.py`](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/pages/2_Financial_Inclusion.py) (Inclusion Page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Research Dashboard"]
  node_streamlit["Dashboard Entry<br/>[app.py]"]
  node_fi_page["Inclusion Page"]
  node_fi_support_page["Decision Support Page"]
  node_credit_page["Credit Risk Page<br/>[1_Credit_Risk.py]"]
  node_credit_assessment["Applicant Assessment UI"]
end

subgraph group_inclusion["Financial Inclusion"]
  node_fi_preparation["Data Preparation"]
  node_fi_dimensions["Dimension Creation"]
  node_fi_clustering["Profile Clustering<br/>[fi_clustering.py]"]
  node_fi_supervised["Supervised Models"]
  node_fi_analysis["Analysis Outputs<br/>[fi_analysis.py]"]
  node_fi_loader["Validated Data Loader<br/>[data_loader.py]"]
  node_fi_decision["Decision Workflow"]
  node_fi_profiles["Profile Explorer<br/>[profiles.py]"]
  node_fi_distribution["Population Distribution<br/>[distribution.py]"]
  node_fi_comparison["Profile Comparison<br/>[comparison.py]"]
  node_fi_explainability["Model Explainability<br/>[explainability.py]"]
  node_fi_gaps["Gap Analysis<br/>[gaps.py]"]
  node_fi_subgroups["Subgroup Analysis<br/>[subgroups.py]"]
  node_fi_individual["Individual Assessment"]
end

subgraph group_credit["Credit Risk"]
  node_credit_home["Home Credit Scoring<br/>[prediction.py]"]
  node_credit_features["Credit Features"]
  node_credit_fairness["Fairness Evaluation<br/>[cr_fairness.py]"]
  node_credit_evaluation["Model Evaluation<br/>[cr_evaluation.py]"]
  node_credit_ablation["Ablation Experiments<br/>[cr_ablation.py]"]
end

subgraph group_market["Market Risk"]
  node_market_analysis["Market Risk Analysis<br/>[mr_forecasting.py]"]
end

subgraph group_fraud["Fraud Detection"]
  node_fraud_analysis["Fraud Detection<br/>[fd_detection.py]"]
end

node_researcher(("Researcher"))

node_researcher -->|"opens dashboard"| node_streamlit
node_streamlit -->|"offers research pages"| node_fi_page
node_streamlit -->|"offers research pages"| node_credit_page
node_fi_page -->|"loads data"| node_fi_loader
node_fi_support_page -->|"renders workflow"| node_fi_decision
node_fi_decision -->|"renders profiles"| node_fi_profiles
node_fi_decision -->|"renders distribution"| node_fi_distribution
node_fi_decision -->|"renders comparison"| node_fi_comparison
node_fi_decision -->|"renders explanations"| node_fi_explainability
node_fi_decision -->|"renders gaps"| node_fi_gaps
node_fi_decision -->|"renders subgroups"| node_fi_subgroups
node_fi_decision -->|"renders assessment"| node_fi_individual
node_fi_profiles -->|"calculates profiles"| node_fi_loader
node_fi_preparation -->|"precedes stage"| node_fi_dimensions
node_fi_dimensions -->|"precedes stage"| node_fi_clustering
node_fi_clustering -->|"precedes stage"| node_fi_supervised
node_credit_page -.->|"includes assessment"| node_credit_assessment
node_credit_assessment -->|"requests assessment"| node_credit_home
node_credit_home -->|"uses features"| node_credit_features
node_credit_home -->|"evaluates fairness"| node_credit_fairness
node_credit_home -->|"evaluates predictions"| node_credit_evaluation
node_researcher -.->|"researches markets"| node_market_analysis
node_researcher -.->|"researches fraud"| node_fraud_analysis

click node_streamlit "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/app.py"
click node_fi_page "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/pages/2_Financial_Inclusion.py"
click node_fi_support_page "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/pages/5_Financial_Inclusion_Decision_Support.py"
click node_credit_page "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/pages/1_Credit_Risk.py"
click node_credit_assessment "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/components/credit_risk_assessment.py"
click node_fi_preparation "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/financial_inclusion/01_data_preparation/fi_preprocessing.py"
click node_fi_dimensions "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/financial_inclusion/02_dimension_creation/fi_dimension_creation.py"
click node_fi_clustering "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/financial_inclusion/03_clustering/fi_clustering.py"
click node_fi_supervised "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/financial_inclusion/04_supervised_learning/fi_supervised_baseline_models.py"
click node_fi_analysis "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/financial_inclusion/05_analysis_visualisation/fi_analysis.py"
click node_fi_loader "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/data_loader.py"
click node_fi_decision "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/decision_support.py"
click node_fi_profiles "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/profiles.py"
click node_fi_distribution "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/distribution.py"
click node_fi_comparison "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/comparison.py"
click node_fi_explainability "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/explainability.py"
click node_fi_gaps "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/gaps.py"
click node_fi_subgroups "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/subgroups.py"
click node_fi_individual "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/individual_assessment.py"
click node_credit_home "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/credit_risk/home_credit/prediction.py"
click node_credit_features "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/credit_risk/home_credit/feature_engineering.py"
click node_credit_fairness "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/credit_risk/fairness/cr_fairness.py"
click node_credit_evaluation "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/credit_risk/common/cr_evaluation.py"
click node_credit_ablation "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/credit_risk/experiments/cr_ablation.py"
click node_market_analysis "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/market_risk/mr_forecasting.py"
click node_fraud_analysis "https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/fraud_detection/fd_detection.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_streamlit,node_fi_page,node_fi_support_page,node_credit_page,node_credit_assessment toneBlue
class node_fi_preparation,node_fi_dimensions,node_fi_clustering,node_fi_supervised,node_fi_analysis,node_fi_loader,node_fi_decision,node_fi_profiles,node_fi_distribution,node_fi_comparison,node_fi_explainability,node_fi_gaps,node_fi_subgroups,node_fi_individual toneAmber
class node_credit_home,node_credit_features,node_credit_fairness,node_credit_evaluation,node_credit_ablation toneMint
class node_market_analysis toneRose
class node_fraud_analysis,node_researcher toneIndigo
```

## Components

### Research Dashboard

- [Dashboard Entry](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/app.py): `frontend/app.py`
- [Inclusion Page](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/pages/2_Financial_Inclusion.py): `frontend/pages/2_Financial_Inclusion.py`
- [Decision Support Page](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/pages/5_Financial_Inclusion_Decision_Support.py): `frontend/pages/5_Financial_Inclusion_Decision_Support.py`
- [Credit Risk Page](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/pages/1_Credit_Risk.py): `frontend/pages/1_Credit_Risk.py`
- [Applicant Assessment UI](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/components/credit_risk_assessment.py): `frontend/components/credit_risk_assessment.py`

### Financial Inclusion

- [Data Preparation](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/financial_inclusion/01_data_preparation/fi_preprocessing.py): `backend/src/financial_inclusion/01_data_preparation/fi_preprocessing.py`
- [Dimension Creation](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/financial_inclusion/02_dimension_creation/fi_dimension_creation.py): `backend/src/financial_inclusion/02_dimension_creation/fi_dimension_creation.py`
- [Profile Clustering](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/financial_inclusion/03_clustering/fi_clustering.py): `backend/src/financial_inclusion/03_clustering/fi_clustering.py`
- [Supervised Models](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/financial_inclusion/04_supervised_learning/fi_supervised_baseline_models.py): `backend/src/financial_inclusion/04_supervised_learning/fi_supervised_baseline_models.py`
- [Analysis Outputs](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/financial_inclusion/05_analysis_visualisation/fi_analysis.py): `backend/src/financial_inclusion/05_analysis_visualisation/fi_analysis.py`
- [Validated Data Loader](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/data_loader.py): `frontend/financial_inclusion/data_loader.py`
- [Decision Workflow](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/decision_support.py): `frontend/financial_inclusion/decision_support.py`
- [Profile Explorer](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/profiles.py): `frontend/financial_inclusion/sections/profiles.py`
- [Population Distribution](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/distribution.py): `frontend/financial_inclusion/sections/distribution.py`
- [Profile Comparison](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/comparison.py): `frontend/financial_inclusion/sections/comparison.py`
- [Model Explainability](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/explainability.py): `frontend/financial_inclusion/sections/explainability.py`
- [Gap Analysis](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/gaps.py): `frontend/financial_inclusion/sections/gaps.py`
- [Subgroup Analysis](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/subgroups.py): `frontend/financial_inclusion/sections/subgroups.py`
- [Individual Assessment](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/frontend/financial_inclusion/sections/individual_assessment.py): `frontend/financial_inclusion/sections/individual_assessment.py`

### Credit Risk

- [Home Credit Scoring](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/credit_risk/home_credit/prediction.py): `backend/src/credit_risk/home_credit/prediction.py`
- [Credit Features](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/credit_risk/home_credit/feature_engineering.py): `backend/src/credit_risk/home_credit/feature_engineering.py`
- [Fairness Evaluation](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/credit_risk/fairness/cr_fairness.py): `backend/src/credit_risk/fairness/cr_fairness.py`
- [Model Evaluation](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/credit_risk/common/cr_evaluation.py): `backend/src/credit_risk/common/cr_evaluation.py`
- [Ablation Experiments](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/credit_risk/experiments/cr_ablation.py): `backend/src/credit_risk/experiments/cr_ablation.py`

### Market Risk

- [Market Risk Analysis](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/market_risk/mr_forecasting.py): `backend/src/market_risk/mr_forecasting.py`

### Fraud Detection

- [Fraud Detection](https://github.com/lilipoornima/knd_cdap_ds_09/blob/main/backend/src/fraud_detection/fd_detection.py): `backend/src/fraud_detection/fd_detection.py`

### Other components

- **Researcher**

## Connections

- Researcher → Dashboard Entry: opens dashboard (evidence: `README.md`)
- Dashboard Entry → Inclusion Page: offers research pages (evidence: `README.md`)
- Dashboard Entry → Credit Risk Page: offers research pages (evidence: `README.md`)
- Inclusion Page → Validated Data Loader: loads data (evidence: `frontend/pages/2_Financial_Inclusion.py`)
- Decision Support Page → Decision Workflow: renders workflow (evidence: `frontend/pages/5_Financial_Inclusion_Decision_Support.py`)
- Decision Workflow → Profile Explorer: renders profiles (evidence: `frontend/financial_inclusion/decision_support.py`)
- Decision Workflow → Population Distribution: renders distribution (evidence: `frontend/financial_inclusion/decision_support.py`)
- Decision Workflow → Profile Comparison: renders comparison (evidence: `frontend/financial_inclusion/decision_support.py`)
- Decision Workflow → Model Explainability: renders explanations (evidence: `frontend/financial_inclusion/decision_support.py`)
- Decision Workflow → Gap Analysis: renders gaps (evidence: `frontend/financial_inclusion/decision_support.py`)
- Decision Workflow → Subgroup Analysis: renders subgroups (evidence: `frontend/financial_inclusion/decision_support.py`)
- Decision Workflow → Individual Assessment: renders assessment (evidence: `frontend/financial_inclusion/decision_support.py`)
- Profile Explorer → Validated Data Loader: calculates profiles (evidence: `frontend/financial_inclusion/sections/profiles.py`)
- Data Preparation → Dimension Creation: precedes stage (evidence: `README.md`)
- Dimension Creation → Profile Clustering: precedes stage (evidence: `README.md`)
- Profile Clustering → Supervised Models: precedes stage (evidence: `README.md`)
- Credit Risk Page → Applicant Assessment UI: includes assessment
- Applicant Assessment UI → Home Credit Scoring: requests assessment (evidence: `frontend/components/credit_risk_assessment.py`)
- Home Credit Scoring → Credit Features: uses features (evidence: `backend/src/credit_risk/home_credit/prediction.py`)
- Home Credit Scoring → Fairness Evaluation: evaluates fairness (evidence: `backend/src/credit_risk/home_credit/prediction.py`)
- Home Credit Scoring → Model Evaluation: evaluates predictions (evidence: `backend/src/credit_risk/home_credit/prediction.py`)
- Researcher → Market Risk Analysis: researches markets (evidence: `README.md`)
- Researcher → Fraud Detection: researches fraud
