# nguyenthiphuongchi05/ttnt architecture

> Architecture diagram of the GitHub repository nguyenthiphuongchi05/ttnt, 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/nguyenthiphuongchi05/ttnt
- Repository: https://github.com/nguyenthiphuongchi05/ttnt

## Overview

This repository is a diabetes-risk prediction web app backed by a separately trained Random Forest model. The principal workflow is user-entered health measurements → validation and preprocessing → probability-based risk classification and explanation → rendered result. A training workflow reads the Pima dataset, prepares features, compares and tunes models, selects a recall-oriented threshold, and saves artifacts for inference. The training excerpts omit some intermediate code; links below follow the visible main workflow and documented preprocessing behavior.

Main entry points: [`diabetes_prediction/app.py`](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/app.py) (Flask prediction handler), [`diabetes_prediction/train.py`](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/train.py) (Training workflow), [`diabetes_prediction/src/utils.py`](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/src/utils.py) (Artifact persistence), [`diabetes_prediction/src/preprocessing.py`](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/src/preprocessing.py) (Feature preprocessing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_training["Model training"]
  node_dataset["Diabetes dataset<br/>[diabetes.csv]"]
  node_train["Training workflow<br/>[train.py]"]
  node_preprocess["Feature preprocessing<br/>[preprocessing.py]"]
  node_evaluation["Model evaluation<br/>[train.py]"]
  node_reports["Training reports"]
end

subgraph group_inference["Risk inference"]
  node_webapp["Flask prediction handler<br/>[app.py]"]
  node_validation["Input validation<br/>[app.py]"]
  node_transform["Sample transformation<br/>[preprocessing.py]"]
  node_risk["Risk and factors<br/>[app.py]"]
end

subgraph group_presentation["Web interface"]
  node_page["Result page<br/>[index.html]"]
  node_browser["Browser interactions<br/>[script.js]"]
  node_styles["Page styling<br/>[style.css]"]
end

subgraph group_persistence["Model artifacts"]
  node_modelstore["Trained model<br/>[diabetes_model.pkl]"]
  node_artifactstore["Preprocessing artifacts<br/>[artifacts.pkl]"]
  node_artifactio["Artifact persistence<br/>[utils.py]"]
end

node_user(("User"))

node_user -->|"submits measurements"| node_webapp
node_dataset -->|"provides data"| node_train
node_train -->|"fits transforms"| node_preprocess
node_train -->|"transforms test data"| node_preprocess
node_train -->|"compares models"| node_evaluation
node_train -->|"writes metrics"| node_reports
node_train -->|"saves artifacts"| node_artifactio
node_artifactio -->|"writes model"| node_modelstore
node_artifactio -->|"writes transforms"| node_artifactstore
node_webapp -->|"loads artifacts"| node_artifactio
node_webapp -->|"validates fields"| node_validation
node_webapp -->|"transforms sample"| node_transform
node_webapp -->|"predicts probability"| node_modelstore
node_webapp -->|"classifies and explains"| node_risk
node_webapp -->|"renders result"| node_page
node_browser -.->|"submits form"| node_webapp
node_styles -.->|"styles page"| node_page

click node_dataset "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/data/diabetes.csv"
click node_train "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/train.py"
click node_preprocess "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/src/preprocessing.py"
click node_evaluation "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/train.py"
click node_reports "https://github.com/nguyenthiphuongchi05/ttnt/tree/main/diabetes_prediction/reports"
click node_modelstore "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/model/diabetes_model.pkl"
click node_artifactstore "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/model/artifacts.pkl"
click node_artifactio "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/src/utils.py"
click node_webapp "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/app.py"
click node_validation "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/app.py"
click node_transform "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/src/preprocessing.py"
click node_risk "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/app.py"
click node_page "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/templates/index.html"
click node_browser "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/static/script.js"
click node_styles "https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/static/style.css"

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_dataset,node_train,node_preprocess,node_evaluation,node_reports,node_user toneBlue
class node_webapp,node_validation,node_transform,node_risk toneAmber
class node_page,node_browser,node_styles toneMint
class node_modelstore,node_artifactstore,node_artifactio toneRose
```

## Components

### Model training

- [Diabetes dataset](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/data/diabetes.csv): `diabetes_prediction/data/diabetes.csv`
- [Training workflow](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/train.py): `diabetes_prediction/train.py`
- [Feature preprocessing](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/src/preprocessing.py): `diabetes_prediction/src/preprocessing.py`
- [Model evaluation](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/train.py): `diabetes_prediction/train.py`
- [Training reports](https://github.com/nguyenthiphuongchi05/ttnt/tree/main/diabetes_prediction/reports): `diabetes_prediction/reports`

### Risk inference

- [Flask prediction handler](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/app.py): `diabetes_prediction/app.py`
- [Input validation](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/app.py): `diabetes_prediction/app.py`
- [Sample transformation](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/src/preprocessing.py): `diabetes_prediction/src/preprocessing.py`
- [Risk and factors](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/app.py): `diabetes_prediction/app.py`

### Web interface

- [Result page](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/templates/index.html): `diabetes_prediction/templates/index.html`
- [Browser interactions](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/static/script.js): `diabetes_prediction/static/script.js`
- [Page styling](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/static/style.css): `diabetes_prediction/static/style.css`

### Model artifacts

- [Trained model](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/model/diabetes_model.pkl): `diabetes_prediction/model/diabetes_model.pkl`
- [Preprocessing artifacts](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/model/artifacts.pkl): `diabetes_prediction/model/artifacts.pkl`
- [Artifact persistence](https://github.com/nguyenthiphuongchi05/ttnt/blob/main/diabetes_prediction/src/utils.py): `diabetes_prediction/src/utils.py`

### Other components

- **User**

## Connections

- User → Flask prediction handler: submits measurements (evidence: `diabetes_prediction/app.py`)
- Diabetes dataset → Training workflow: provides data (evidence: `diabetes_prediction/train.py`)
- Training workflow → Feature preprocessing: fits transforms (evidence: `diabetes_prediction/train.py`)
- Training workflow → Feature preprocessing: transforms test data (evidence: `diabetes_prediction/train.py`)
- Training workflow → Model evaluation: compares models (evidence: `diabetes_prediction/train.py`)
- Training workflow → Training reports: writes metrics (evidence: `diabetes_prediction/train.py`)
- Training workflow → Artifact persistence: saves artifacts (evidence: `diabetes_prediction/train.py`)
- Artifact persistence → Trained model: writes model (evidence: `diabetes_prediction/src/utils.py`)
- Artifact persistence → Preprocessing artifacts: writes transforms (evidence: `diabetes_prediction/src/utils.py`)
- Flask prediction handler → Artifact persistence: loads artifacts (evidence: `diabetes_prediction/app.py`)
- Flask prediction handler → Input validation: validates fields (evidence: `diabetes_prediction/app.py`)
- Flask prediction handler → Sample transformation: transforms sample (evidence: `diabetes_prediction/app.py`)
- Flask prediction handler → Trained model: predicts probability (evidence: `diabetes_prediction/app.py`)
- Flask prediction handler → Risk and factors: classifies and explains (evidence: `diabetes_prediction/app.py`)
- Flask prediction handler → Result page: renders result (evidence: `diabetes_prediction/app.py`)
- Browser interactions → Flask prediction handler: submits form
- Page styling → Result page: styles page
