# msaisabarish24-spec/salvo_studysense architecture

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

- Interactive diagram: https://gitdiagram.com/msaisabarish24-spec/salvo_studysense
- Repository: https://github.com/msaisabarish24-spec/salvo_studysense

## Overview

STUDYSENSE is a Tkinter desktop app for predicting student final marks from an active Excel dataset. Users load data, enter academic and engagement values, and receive a prediction; the app also supports exact-match results and confirmed-feedback updates to the dataset. The main implementation is a single Python file, so nodes represent responsibilities within that file rather than separate modules. Some prediction and persistence details are documented in the README but fall in omitted source excerpts; those links cite the README.

Main entry points: [`salvo_studysense.py`](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py) (Dataset analytics), [`raw_data.xlsx`](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/raw_data.xlsx) (Active Excel dataset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop workflow"]
  node_desktop["Tkinter interface"]
  node_input_validation["Input validation"]
end

subgraph group_data["Dataset analysis"]
  node_dataset_load["Dataset loading"]
  node_column_map["Column mapping"]
  node_data_analysis["Dataset analytics"]
  node_imputer["Median imputation"]
  node_dataset[("Active Excel dataset<br/>[raw_data.xlsx]")]
end

subgraph group_models["Prediction logic"]
  node_linear_formula["Formula derivation"]
  node_forest_model["Random forest"]
  node_exact_match["Exact-match lookup"]
  node_priority_rules["Priority override"]
  node_prediction["Mark prediction"]
end

subgraph group_feedback["Results and feedback"]
  node_result_display["Prediction display"]
  node_feedback_prompt["Feedback confirmation"]
  node_feedback_append["Confirmed-result append"]
end

node_student(("Student user"))

node_student -->|"uses"| node_desktop
node_desktop -->|"loads data"| node_dataset_load
node_dataset_load -.->|"reads"| node_dataset
node_dataset_load -->|"analyzes"| node_data_analysis
node_data_analysis -->|"detects columns"| node_column_map
node_data_analysis -->|"imputes values"| node_imputer
node_data_analysis -->|"fits regression"| node_linear_formula
node_data_analysis -->|"fits forest"| node_forest_model
node_student -->|"enters values"| node_input_validation
node_desktop -->|"validates input"| node_input_validation
node_input_validation -->|"checks dataset"| node_exact_match
node_input_validation -->|"applies override"| node_priority_rules
node_input_validation -.->|"requests prediction"| node_prediction
node_prediction -.->|"uses model"| node_forest_model
node_prediction -.->|"uses formula"| node_linear_formula
node_prediction -->|"returns result"| node_result_display
node_exact_match -->|"returns match"| node_result_display
node_result_display -->|"requests confirmation"| node_feedback_prompt
node_feedback_prompt -->|"appends if confirmed"| node_feedback_append
node_feedback_append -->|"updates data"| node_dataset
node_feedback_append -.->|"refines model"| node_data_analysis

click node_desktop "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_dataset_load "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_column_map "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_data_analysis "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_imputer "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_linear_formula "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_forest_model "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_input_validation "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_exact_match "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_priority_rules "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_prediction "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_result_display "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_feedback_prompt "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py"
click node_dataset "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/raw_data.xlsx"
click node_feedback_append "https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.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_desktop,node_input_validation,node_student toneBlue
class node_dataset_load,node_column_map,node_data_analysis,node_imputer,node_dataset toneAmber
class node_linear_formula,node_forest_model,node_exact_match,node_priority_rules,node_prediction toneMint
class node_result_display,node_feedback_prompt,node_feedback_append toneRose
```

## Components

### Desktop workflow

- [Tkinter interface](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`
- [Input validation](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`

### Dataset analysis

- [Dataset loading](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`
- [Column mapping](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`
- [Dataset analytics](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`
- [Median imputation](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`
- [Active Excel dataset](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/raw_data.xlsx): `raw_data.xlsx`

### Prediction logic

- [Formula derivation](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`
- [Random forest](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`
- [Exact-match lookup](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`
- [Priority override](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`
- [Mark prediction](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`

### Results and feedback

- [Prediction display](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`
- [Feedback confirmation](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`
- [Confirmed-result append](https://github.com/msaisabarish24-spec/salvo_studysense/blob/main/salvo_studysense.py): `salvo_studysense.py`

### Other components

- **Student user**

## Connections

- Student user → Tkinter interface: uses (evidence: `README.md`)
- Tkinter interface → Dataset loading: loads data (evidence: `salvo_studysense.py`)
- Dataset loading → Active Excel dataset: reads
- Dataset loading → Dataset analytics: analyzes (evidence: `salvo_studysense.py`)
- Dataset analytics → Column mapping: detects columns (evidence: `salvo_studysense.py`)
- Dataset analytics → Median imputation: imputes values (evidence: `salvo_studysense.py`)
- Dataset analytics → Formula derivation: fits regression (evidence: `salvo_studysense.py`)
- Dataset analytics → Random forest: fits forest (evidence: `salvo_studysense.py`)
- Student user → Input validation: enters values (evidence: `README.md`)
- Tkinter interface → Input validation: validates input (evidence: `salvo_studysense.py`)
- Input validation → Exact-match lookup: checks dataset (evidence: `README.md`)
- Input validation → Priority override: applies override (evidence: `salvo_studysense.py`)
- Input validation → Mark prediction: requests prediction (evidence: `salvo_studysense.py`)
- Mark prediction → Random forest: uses model (evidence: `salvo_studysense.py`)
- Mark prediction → Formula derivation: uses formula (evidence: `salvo_studysense.py`)
- Mark prediction → Prediction display: returns result (evidence: `README.md`)
- Exact-match lookup → Prediction display: returns match (evidence: `README.md`)
- Prediction display → Feedback confirmation: requests confirmation (evidence: `salvo_studysense.py`)
- Feedback confirmation → Confirmed-result append: appends if confirmed (evidence: `README.md`)
- Confirmed-result append → Active Excel dataset: updates data (evidence: `README.md`)
- Confirmed-result append → Dataset analytics: refines model (evidence: `salvo_studysense.py`)
