# hmnthy/credit-risk-scoring-hmeq architecture

> Architecture diagram of the GitHub repository hmnthy/credit-risk-scoring-hmeq, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hmnthy/credit-risk-scoring-hmeq
- Repository: https://github.com/hmnthy/credit-risk-scoring-hmeq

## Overview

This is a credit-risk scoring project delivered primarily as a Google Colab notebook. Its main workflow takes HMEQ loan data through exploration and model selection, compares logistic regression with boosted-tree models, evaluates default predictions and decision thresholds, then produces a business-profile score grid. The README also identifies a profiling report and exported grid as deliverables. Notebook stages are represented separately but share the notebook path; the source excerpts contain no notebook code, so relationships are based on documented workflow statements rather than inspected calls.

Main entry points: [`Scoring.ipynb`](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb) (Model Preselection), [`grille_de_score_weight.xlsx`](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/grille_de_score_weight.xlsx) (Score Grid), [`hmeq_report.html`](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/hmeq_report.html) (Data Profiling), [`Rapport_Scoring.docx`](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Rapport_Scoring.docx) (Project Report)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Data Analysis"]
  node_exploration["Exploratory Analysis<br/>[Scoring.ipynb]"]
  node_profiling["Data Profiling<br/>[hmeq_report.html]"]
end

subgraph group_modeling["Risk Modeling"]
  node_preselection["Model Preselection<br/>[Scoring.ipynb]"]
  node_logistic["Logistic Regression<br/>[Scoring.ipynb]"]
  node_boosting["Gradient Boosting<br/>[Scoring.ipynb]"]
  node_evaluation["Model Evaluation<br/>[Scoring.ipynb]"]
  node_threshold["Threshold Analysis<br/>[Scoring.ipynb]"]
end

subgraph group_deliverables["Risk Deliverables"]
  node_segmentation["Risk Segmentation<br/>[Scoring.ipynb]"]
  node_scoregrid["Score Grid"]
  node_project_report["Project Report"]
end

node_hmeq[("HMEQ Dataset")]
node_credit_team(("Credit Team"))

node_hmeq -->|"loads data"| node_exploration
node_hmeq -->|"profiles data"| node_profiling
node_exploration -->|"informs selection"| node_preselection
node_preselection -->|"compares models"| node_logistic
node_preselection -->|"compares models"| node_boosting
node_logistic -->|"evaluated on test"| node_evaluation
node_boosting -->|"evaluated on test"| node_evaluation
node_evaluation -->|"sets operating point"| node_threshold
node_hmeq -->|"segments training data"| node_segmentation
node_segmentation -->|"exports grid"| node_scoregrid
node_credit_team -.->|"uses for policy"| node_scoregrid
node_credit_team -.->|"reviews results"| node_project_report

click node_exploration "https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb"
click node_profiling "https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/hmeq_report.html"
click node_preselection "https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb"
click node_logistic "https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb"
click node_boosting "https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb"
click node_evaluation "https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb"
click node_threshold "https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb"
click node_segmentation "https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb"
click node_scoregrid "https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/grille_de_score_weight.xlsx"
click node_project_report "https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Rapport_Scoring.docx"

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_exploration,node_profiling toneBlue
class node_preselection,node_logistic,node_boosting,node_evaluation,node_threshold,node_hmeq toneAmber
class node_segmentation,node_scoregrid,node_project_report toneMint
class node_credit_team toneIndigo
```

## Components

### Data Analysis

- [Exploratory Analysis](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb): `Scoring.ipynb`
- [Data Profiling](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/hmeq_report.html): `hmeq_report.html`

### Risk Modeling

- [Model Preselection](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb): `Scoring.ipynb`
- [Logistic Regression](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb): `Scoring.ipynb`
- [Gradient Boosting](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb): `Scoring.ipynb`
- [Model Evaluation](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb): `Scoring.ipynb`
- [Threshold Analysis](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb): `Scoring.ipynb`

### Risk Deliverables

- [Risk Segmentation](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Scoring.ipynb): `Scoring.ipynb`
- [Score Grid](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/grille_de_score_weight.xlsx): `grille_de_score_weight.xlsx`
- [Project Report](https://github.com/hmnthy/credit-risk-scoring-hmeq/blob/main/Rapport_Scoring.docx): `Rapport_Scoring.docx`

### Other components

- **HMEQ Dataset**
- **Credit Team**

## Connections

- HMEQ Dataset → Exploratory Analysis: loads data (evidence: `README.md`)
- HMEQ Dataset → Data Profiling: profiles data (evidence: `README.md`)
- Exploratory Analysis → Model Preselection: informs selection (evidence: `README.md`)
- Model Preselection → Logistic Regression: compares models (evidence: `README.md`)
- Model Preselection → Gradient Boosting: compares models (evidence: `README.md`)
- Logistic Regression → Model Evaluation: evaluated on test (evidence: `README.md`)
- Gradient Boosting → Model Evaluation: evaluated on test (evidence: `README.md`)
- Model Evaluation → Threshold Analysis: sets operating point (evidence: `README.md`)
- HMEQ Dataset → Risk Segmentation: segments training data (evidence: `README.md`)
- Risk Segmentation → Score Grid: exports grid (evidence: `README.md`)
- Credit Team → Score Grid: uses for policy
- Credit Team → Project Report: reviews results
