# hfzhimn/student-dropout-prediction-app architecture

> Architecture diagram of the GitHub repository hfzhimn/student-dropout-prediction-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hfzhimn/student-dropout-prediction-app
- Repository: https://github.com/hfzhimn/student-dropout-prediction-app

## Overview

This project is an early-warning prototype for identifying students at risk of dropping out. Its interactive workflow collects five student attributes in a Streamlit app, passes them to a loaded Random Forest model, and displays a risk message. The repository also includes a data-science notebook and dataset; the README describes preprocessing, exploratory analysis, and model development, plus a separate Tableau monitoring dashboard. The notebook’s implementation and the dashboard itself were not inspected, so their internal behavior and connections beyond documented capabilities are not inferred.

Main entry points: [`app.py`](https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/app.py) (Prediction app), [`notebookDSAkhir.ipynb`](https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/notebookDSAkhir.ipynb) (Data preprocessing), [`data.csv`](https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/data.csv) (Student dataset), [`model.joblib`](https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/model.joblib) (Random Forest model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Data Analysis"]
  node_student_data["Student dataset<br/>[data.csv]"]
  node_preprocessing["Data preprocessing"]
  node_eda["Exploratory analysis"]
end

subgraph group_prediction["Risk Prediction"]
  node_model_development["Model development"]
  node_model["Random Forest model<br/>[model.joblib]"]
  node_streamlit_app["Prediction app<br/>[app.py]"]
  node_prediction_result["Risk prediction<br/>[app.py]"]
end

subgraph group_monitoring["Business Monitoring"]
  node_tableau["Tableau dashboard"]
end

node_staff(("Institute staff"))
node_student_user(("Staff app user"))

node_student_data -->|"provides data"| node_preprocessing
node_preprocessing -->|"prepares data"| node_eda
node_eda -->|"informs modeling"| node_model_development
node_student_user -->|"enters attributes"| node_streamlit_app
node_streamlit_app -->|"loads and predicts"| node_model
node_streamlit_app -->|"displays result"| node_prediction_result
node_staff -->|"monitors performance"| node_tableau

click node_student_data "https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/data.csv"
click node_preprocessing "https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/notebookDSAkhir.ipynb"
click node_eda "https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/notebookDSAkhir.ipynb"
click node_model_development "https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/notebookDSAkhir.ipynb"
click node_model "https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/model.joblib"
click node_streamlit_app "https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/app.py"
click node_prediction_result "https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/app.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_student_data,node_preprocessing,node_eda,node_student_user toneBlue
class node_model_development,node_model,node_streamlit_app,node_prediction_result toneAmber
class node_tableau toneMint
class node_staff toneIndigo
```

## Components

### Data Analysis

- [Student dataset](https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/data.csv): `data.csv`
- [Data preprocessing](https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/notebookDSAkhir.ipynb): `notebookDSAkhir.ipynb`
- [Exploratory analysis](https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/notebookDSAkhir.ipynb): `notebookDSAkhir.ipynb`

### Risk Prediction

- [Model development](https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/notebookDSAkhir.ipynb): `notebookDSAkhir.ipynb`
- [Random Forest model](https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/model.joblib): `model.joblib`
- [Prediction app](https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/app.py): `app.py`
- [Risk prediction](https://github.com/hfzhimn/student-dropout-prediction-app/blob/main/app.py): `app.py`

### Business Monitoring

- **Tableau dashboard**

### Other components

- **Institute staff**
- **Staff app user**

## Connections

- Student dataset → Data preprocessing: provides data (evidence: `README.md`)
- Data preprocessing → Exploratory analysis: prepares data (evidence: `README.md`)
- Exploratory analysis → Model development: informs modeling (evidence: `README.md`)
- Staff app user → Prediction app: enters attributes (evidence: `app.py`)
- Prediction app → Random Forest model: loads and predicts (evidence: `app.py`)
- Prediction app → Risk prediction: displays result (evidence: `app.py`)
- Institute staff → Tableau dashboard: monitors performance (evidence: `README.md`)
