# saiteja8326/ai-powered-smart-study-planner architecture

> Architecture diagram of the GitHub repository saiteja8326/ai-powered-smart-study-planner, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saiteja8326/ai-powered-smart-study-planner
- Repository: https://github.com/saiteja8326/ai-powered-smart-study-planner

## Overview

This is a Streamlit student-performance tracker: students register or log in, enter weekly topic marks, review their history and visualizations, and receive insights or a focused study plan. The main dashboard delegates persistence, analysis, deep-learning inference, and scheduling to utility modules. The README also describes model training and multiple architectures; training scripts and preprocessing are represented, but their runtime wiring is not established by the excerpts. The repository contains alternate Streamlit interfaces with different database APIs, so their links are limited to imports shown in those files.

Main entry points: [`app/main.py`](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/app/main.py) (Main dashboard), [`models/train_models.py`](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/train_models.py) (NN and autoencoder training), [`utils/database.py`](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/utils/database.py) (SQLite records), [`utils/engine_dl.py`](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/utils/engine_dl.py) (DL inference)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Student interfaces"]
  node_dashboard["Main dashboard<br/>[main.py]"]
  node_alternate_ui["AI Scholar portal<br/>[ui.py]"]
  node_tracker_ui["Performance tracker<br/>[app_streamlit.py]"]
end

subgraph group_records["Academic records"]
  node_history_store[("SQLite records<br/>[database.py]")]
end

subgraph group_insights["Analysis and guidance"]
  node_topic_analysis["Topic analysis<br/>[analysis.py]"]
  node_deep_learning["DL inference<br/>[engine_dl.py]"]
  node_study_schedule["Smart schedule<br/>[schedule.py]"]
end

subgraph group_models["Model training"]
  node_preprocessing["Feature preprocessing<br/>[preprocessing.py]"]
  node_training_pipeline["NN and autoencoder training<br/>[train_models.py]"]
  node_nn_trainer["Neural network trainer<br/>[train_nn.py]"]
  node_lstm_trainer["LSTM trainer<br/>[train_lstm.py]"]
  node_autoencoder_trainer["Autoencoder trainer"]
  node_training_data["Student dataset"]
  node_nn_artifact["Neural network model<br/>[nn_model.h5]"]
  node_ae_artifact["Autoencoder model<br/>[autoencoder.h5]"]
end

node_student(("Student"))

node_student -->|"uses"| node_dashboard
node_dashboard -->|"reads and writes"| node_history_store
node_dashboard -->|"requests analysis"| node_topic_analysis
node_dashboard -->|"requests insights"| node_deep_learning
node_dashboard -->|"requests plan"| node_study_schedule
node_dashboard -->|"visualizes progress"| node_training_data
node_alternate_ui -->|"imports storage API"| node_history_store
node_alternate_ui -->|"requests plan"| node_study_schedule
node_tracker_ui -->|"reads and writes"| node_history_store
node_tracker_ui -->|"requests plan"| node_study_schedule
node_dashboard -->|"stores weekly marks"| node_history_store
node_training_pipeline -->|"loads"| node_training_data
node_training_pipeline -->|"saves"| node_nn_artifact
node_training_pipeline -->|"saves"| node_ae_artifact
node_deep_learning -->|"loads"| node_nn_artifact
node_deep_learning -->|"loads"| node_ae_artifact
node_training_data -.->|"supports feature preparation"| node_preprocessing
node_nn_trainer -.->|"training variant"| node_training_pipeline
node_lstm_trainer -.->|"sequential model variant"| node_training_pipeline
node_autoencoder_trainer -.->|"training variant"| node_training_pipeline

click node_dashboard "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/app/main.py"
click node_alternate_ui "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/app/ui.py"
click node_tracker_ui "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/app/app_streamlit.py"
click node_history_store "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/utils/database.py"
click node_topic_analysis "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/utils/analysis.py"
click node_deep_learning "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/utils/engine_dl.py"
click node_study_schedule "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/utils/schedule.py"
click node_preprocessing "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/utils/preprocessing.py"
click node_training_pipeline "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/train_models.py"
click node_nn_trainer "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/train_nn.py"
click node_lstm_trainer "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/train_lstm.py"
click node_autoencoder_trainer "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/train_autoencoder.py"
click node_training_data "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/dataset/student_dataset_25000%20(1).xlsx"
click node_nn_artifact "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/saved_models/nn_model.h5"
click node_ae_artifact "https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/saved_models/autoencoder.h5"

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_dashboard,node_alternate_ui,node_tracker_ui toneBlue
class node_history_store toneAmber
class node_topic_analysis,node_deep_learning,node_study_schedule toneMint
class node_preprocessing,node_training_pipeline,node_nn_trainer,node_lstm_trainer,node_autoencoder_trainer,node_training_data,node_nn_artifact,node_ae_artifact toneRose
class node_student toneIndigo
```

## Components

### Student interfaces

- [Main dashboard](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/app/main.py): `app/main.py`
- [AI Scholar portal](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/app/ui.py): `app/ui.py`
- [Performance tracker](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/app/app_streamlit.py): `app/app_streamlit.py`

### Academic records

- [SQLite records](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/utils/database.py): `utils/database.py`

### Analysis and guidance

- [Topic analysis](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/utils/analysis.py): `utils/analysis.py`
- [DL inference](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/utils/engine_dl.py): `utils/engine_dl.py`
- [Smart schedule](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/utils/schedule.py): `utils/schedule.py`

### Model training

- [Feature preprocessing](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/utils/preprocessing.py): `utils/preprocessing.py`
- [NN and autoencoder training](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/train_models.py): `models/train_models.py`
- [Neural network trainer](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/train_nn.py): `models/train_nn.py`
- [LSTM trainer](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/train_lstm.py): `models/train_lstm.py`
- [Autoencoder trainer](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/train_autoencoder.py): `models/train_autoencoder.py`
- [Student dataset](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/dataset/student_dataset_25000%20(1).xlsx): `dataset/student_dataset_25000 (1).xlsx`
- [Neural network model](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/saved_models/nn_model.h5): `models/saved_models/nn_model.h5`
- [Autoencoder model](https://github.com/saiteja8326/ai-powered-smart-study-planner/blob/main/models/saved_models/autoencoder.h5): `models/saved_models/autoencoder.h5`

### Other components

- **Student**

## Connections

- Student → Main dashboard: uses (evidence: `README.md`)
- Main dashboard → SQLite records: reads and writes (evidence: `app/main.py`)
- Main dashboard → Topic analysis: requests analysis (evidence: `app/main.py`)
- Main dashboard → DL inference: requests insights (evidence: `app/main.py`)
- Main dashboard → Smart schedule: requests plan (evidence: `app/main.py`)
- Main dashboard → Student dataset: visualizes progress (evidence: `README.md`)
- AI Scholar portal → SQLite records: imports storage API (evidence: `app/ui.py`)
- AI Scholar portal → Smart schedule: requests plan (evidence: `app/ui.py`)
- Performance tracker → SQLite records: reads and writes (evidence: `app/app_streamlit.py`)
- Performance tracker → Smart schedule: requests plan (evidence: `app/app_streamlit.py`)
- Main dashboard → SQLite records: stores weekly marks (evidence: `README.md`)
- NN and autoencoder training → Student dataset: loads (evidence: `models/train_models.py`)
- NN and autoencoder training → Neural network model: saves (evidence: `models/train_models.py`)
- NN and autoencoder training → Autoencoder model: saves (evidence: `models/train_models.py`)
- DL inference → Neural network model: loads (evidence: `utils/engine_dl.py`)
- DL inference → Autoencoder model: loads (evidence: `utils/engine_dl.py`)
- Student dataset → Feature preprocessing: supports feature preparation
- Neural network trainer → NN and autoencoder training: training variant
- LSTM trainer → NN and autoencoder training: sequential model variant
- Autoencoder trainer → NN and autoencoder training: training variant
