# vinay786-3009/student-prediction-system architecture

> Architecture diagram of the GitHub repository vinay786-3009/student-prediction-system, 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/vinay786-3009/student-prediction-system
- Repository: https://github.com/vinay786-3009/student-prediction-system

## Overview

This is a student performance analytics system with both a Streamlit interface and a command-line interface. Users view and manage student records, explore performance and attendance analytics, and request individual or cohort risk predictions or model evaluation. Both interfaces use a shared CSV-backed dataset; analytics and prediction code also read that file directly. The excerpts show the main module calls and core behavior, but not every UI or CLI branch in full.

Main entry points: [`app.py`](https://github.com/vinay786-3009/student-prediction-system/blob/main/app.py) (Streamlit app), [`main.py`](https://github.com/vinay786-3009/student-prediction-system/blob/main/main.py) (Command-line app), [`prediction.py`](https://github.com/vinay786-3009/student-prediction-system/blob/main/prediction.py) (Prediction functions), [`students.csv`](https://github.com/vinay786-3009/student-prediction-system/blob/main/students.csv) (Student records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_streamlit_app["Streamlit app<br/>[app.py]"]
  node_cli_app["Command-line app<br/>[main.py]"]
end

subgraph group_records["Student records"]
  node_student_csv[("Student records<br/>[students.csv]")]
end

subgraph group_analytics["Performance analytics"]
  node_analytics_module["Analytics functions<br/>[analytics.py]"]
end

subgraph group_prediction["Risk prediction"]
  node_prediction_module["Prediction functions<br/>[prediction.py]"]
  node_risk_model["Risk model training<br/>[prediction.py]"]
end

node_streamlit_user(("Dashboard user"))
node_cli_user(("CLI user"))

node_streamlit_user -->|"uses"| node_streamlit_app
node_cli_user -->|"uses"| node_cli_app
node_streamlit_app -->|"reads and writes"| node_student_csv
node_cli_app -->|"reads and writes"| node_student_csv
node_analytics_module -->|"reads"| node_student_csv
node_prediction_module -->|"reads"| node_student_csv
node_streamlit_app -->|"requests analytics"| node_analytics_module
node_cli_app -->|"requests analytics"| node_analytics_module
node_streamlit_app -->|"requests predictions"| node_prediction_module
node_cli_app -->|"requests predictions"| node_prediction_module
node_prediction_module -->|"trains model"| node_risk_model

click node_streamlit_app "https://github.com/vinay786-3009/student-prediction-system/blob/main/app.py"
click node_cli_app "https://github.com/vinay786-3009/student-prediction-system/blob/main/main.py"
click node_student_csv "https://github.com/vinay786-3009/student-prediction-system/blob/main/students.csv"
click node_analytics_module "https://github.com/vinay786-3009/student-prediction-system/blob/main/analytics.py"
click node_prediction_module "https://github.com/vinay786-3009/student-prediction-system/blob/main/prediction.py"
click node_risk_model "https://github.com/vinay786-3009/student-prediction-system/blob/main/prediction.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_app,node_cli_app,node_streamlit_user,node_cli_user toneBlue
class node_student_csv toneAmber
class node_analytics_module toneMint
class node_prediction_module,node_risk_model toneRose
```

## Components

### User interfaces

- [Streamlit app](https://github.com/vinay786-3009/student-prediction-system/blob/main/app.py): `app.py`
- [Command-line app](https://github.com/vinay786-3009/student-prediction-system/blob/main/main.py): `main.py`

### Student records

- [Student records](https://github.com/vinay786-3009/student-prediction-system/blob/main/students.csv): `students.csv`

### Performance analytics

- [Analytics functions](https://github.com/vinay786-3009/student-prediction-system/blob/main/analytics.py): `analytics.py`

### Risk prediction

- [Prediction functions](https://github.com/vinay786-3009/student-prediction-system/blob/main/prediction.py): `prediction.py`
- [Risk model training](https://github.com/vinay786-3009/student-prediction-system/blob/main/prediction.py): `prediction.py`

### Other components

- **Dashboard user**
- **CLI user**

## Connections

- Dashboard user → Streamlit app: uses (evidence: `app.py`)
- CLI user → Command-line app: uses (evidence: `main.py`)
- Streamlit app → Student records: reads and writes (evidence: `app.py`)
- Command-line app → Student records: reads and writes (evidence: `main.py`)
- Analytics functions → Student records: reads (evidence: `analytics.py`)
- Prediction functions → Student records: reads (evidence: `prediction.py`)
- Streamlit app → Analytics functions: requests analytics (evidence: `app.py`)
- Command-line app → Analytics functions: requests analytics (evidence: `main.py`)
- Streamlit app → Prediction functions: requests predictions (evidence: `app.py`)
- Command-line app → Prediction functions: requests predictions (evidence: `main.py`)
- Prediction functions → Risk model training: trains model (evidence: `prediction.py`)
