# mohan-sai-karthikeya101/waypoint architecture

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

- Interactive diagram: https://gitdiagram.com/mohan-sai-karthikeya101/waypoint
- Repository: https://github.com/mohan-sai-karthikeya101/waypoint

## Overview

WayPoint is a student academic-performance analysis system with a separate model-training workflow. Students provide six academic and behavioral inputs; the application predicts a score and learned risk category, explains influential factors, and offers practical recommendations and target-score planning. Training generates and retains data, evaluates fresh and compatible continued-training candidates, then saves versioned models and updates the current models used by the application. The graph follows the README’s documented workflow and the sampled source excerpts; several internal stages are described but not fully shown in source.

Main entry points: [`training.py`](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py) (Training Pipeline), [`WayPoint.py`](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py) (Student Application), [`data/training`](https://github.com/mohan-sai-karthikeya101/waypoint/tree/main/data/training) (Training Batches), [`data/testing`](https://github.com/mohan-sai-karthikeya101/waypoint/tree/main/data/testing) (Testing Batches)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_training["Model Training"]
  node_training_pipeline["Training Pipeline<br/>[training.py]"]
  node_data_generation["Data Generation<br/>[training.py]"]
  node_historical_data["Historical Data Loading<br/>[training.py]"]
  node_candidate_training["Candidate Training<br/>[training.py]"]
  node_model_evaluation["Model Evaluation<br/>[training.py]"]
  node_model_selection["Model Selection<br/>[training.py]"]
end

subgraph group_persistence["Persistent State"]
  node_training_batches[("Training Batches")]
  node_testing_batches[("Testing Batches")]
  node_model_versions[("Versioned Models")]
  node_current_models[("Current Models")]
  node_project_registry["Project Registry"]
end

subgraph group_student_app["Student Analysis"]
  node_student_application["Student Application<br/>[WayPoint.py]"]
  node_model_loading["Model Loading<br/>[WayPoint.py]"]
  node_prediction_risk["Score &amp; Risk Prediction<br/>[WayPoint.py]"]
  node_shap_explanations["SHAP Explanations<br/>[WayPoint.py]"]
end

subgraph group_guidance["Actionable Guidance"]
  node_recommendations["Recommendations<br/>[WayPoint.py]"]
  node_dream_score["Dream Score Planning<br/>[WayPoint.py]"]
  node_analysis_results["Analysis Results<br/>[WayPoint.py]"]
end

node_student(("Student"))

node_training_pipeline -->|"generates batches"| node_data_generation
node_data_generation -->|"writes batches"| node_training_batches
node_data_generation -->|"writes batches"| node_testing_batches
node_training_pipeline -->|"loads history"| node_historical_data
node_historical_data -->|"reads batches"| node_training_batches
node_historical_data -->|"reads batches"| node_testing_batches
node_training_pipeline -->|"trains candidates"| node_candidate_training
node_candidate_training -->|"uses prior models"| node_model_versions
node_training_pipeline -->|"evaluates candidates"| node_model_evaluation
node_model_evaluation -->|"ranks candidates"| node_model_selection
node_training_pipeline -->|"saves new version"| node_model_versions
node_training_pipeline -->|"updates selected models"| node_current_models
node_training_pipeline -->|"updates registry"| node_project_registry
node_student -->|"provides inputs"| node_student_application
node_student_application -->|"starts analysis"| node_model_loading
node_model_loading -->|"loads models"| node_current_models
node_model_loading -->|"supplies models"| node_prediction_risk
node_prediction_risk -->|"explains prediction"| node_shap_explanations
node_prediction_risk -->|"informs guidance"| node_recommendations
node_student_application -->|"offers target planning"| node_dream_score
node_dream_score -->|"presents plan"| node_analysis_results
node_shap_explanations -->|"presents factors"| node_analysis_results
node_recommendations -->|"presents advice"| node_analysis_results

click node_training_pipeline "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py"
click node_data_generation "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py"
click node_historical_data "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py"
click node_candidate_training "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py"
click node_model_evaluation "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py"
click node_model_selection "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py"
click node_training_batches "https://github.com/mohan-sai-karthikeya101/waypoint/tree/main/data/training"
click node_testing_batches "https://github.com/mohan-sai-karthikeya101/waypoint/tree/main/data/testing"
click node_model_versions "https://github.com/mohan-sai-karthikeya101/waypoint/tree/main/models/versions"
click node_current_models "https://github.com/mohan-sai-karthikeya101/waypoint/tree/main/models/current"
click node_project_registry "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/project_registry.json"
click node_student_application "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py"
click node_model_loading "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py"
click node_prediction_risk "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py"
click node_shap_explanations "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py"
click node_recommendations "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py"
click node_dream_score "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py"
click node_analysis_results "https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.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_training_pipeline,node_data_generation,node_historical_data,node_candidate_training,node_model_evaluation,node_model_selection toneBlue
class node_training_batches,node_testing_batches,node_model_versions,node_current_models,node_project_registry toneAmber
class node_student_application,node_model_loading,node_prediction_risk,node_shap_explanations toneMint
class node_recommendations,node_dream_score,node_analysis_results toneRose
class node_student toneIndigo
```

## Components

### Model Training

- [Training Pipeline](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py): `training.py`
- [Data Generation](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py): `training.py`
- [Historical Data Loading](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py): `training.py`
- [Candidate Training](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py): `training.py`
- [Model Evaluation](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py): `training.py`
- [Model Selection](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/training.py): `training.py`

### Persistent State

- [Training Batches](https://github.com/mohan-sai-karthikeya101/waypoint/tree/main/data/training): `data/training`
- [Testing Batches](https://github.com/mohan-sai-karthikeya101/waypoint/tree/main/data/testing): `data/testing`
- [Versioned Models](https://github.com/mohan-sai-karthikeya101/waypoint/tree/main/models/versions): `models/versions`
- [Current Models](https://github.com/mohan-sai-karthikeya101/waypoint/tree/main/models/current): `models/current`
- [Project Registry](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/project_registry.json): `project_registry.json`

### Student Analysis

- [Student Application](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py): `WayPoint.py`
- [Model Loading](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py): `WayPoint.py`
- [Score & Risk Prediction](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py): `WayPoint.py`
- [SHAP Explanations](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py): `WayPoint.py`

### Actionable Guidance

- [Recommendations](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py): `WayPoint.py`
- [Dream Score Planning](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py): `WayPoint.py`
- [Analysis Results](https://github.com/mohan-sai-karthikeya101/waypoint/blob/main/WayPoint.py): `WayPoint.py`

### Other components

- **Student**

## Connections

- Training Pipeline → Data Generation: generates batches (evidence: `README.md`)
- Data Generation → Training Batches: writes batches (evidence: `README.md`)
- Data Generation → Testing Batches: writes batches (evidence: `README.md`)
- Training Pipeline → Historical Data Loading: loads history (evidence: `README.md`)
- Historical Data Loading → Training Batches: reads batches (evidence: `training.py`)
- Historical Data Loading → Testing Batches: reads batches (evidence: `training.py`)
- Training Pipeline → Candidate Training: trains candidates (evidence: `README.md`)
- Candidate Training → Versioned Models: uses prior models (evidence: `README.md`)
- Training Pipeline → Model Evaluation: evaluates candidates (evidence: `README.md`)
- Model Evaluation → Model Selection: ranks candidates (evidence: `README.md`)
- Training Pipeline → Versioned Models: saves new version (evidence: `README.md`)
- Training Pipeline → Current Models: updates selected models (evidence: `README.md`)
- Training Pipeline → Project Registry: updates registry (evidence: `training.py`)
- Student → Student Application: provides inputs (evidence: `README.md`)
- Student Application → Model Loading: starts analysis (evidence: `WayPoint.py`)
- Model Loading → Current Models: loads models (evidence: `README.md`)
- Model Loading → Score & Risk Prediction: supplies models (evidence: `README.md`)
- Score & Risk Prediction → SHAP Explanations: explains prediction (evidence: `README.md`)
- Score & Risk Prediction → Recommendations: informs guidance (evidence: `README.md`)
- Student Application → Dream Score Planning: offers target planning (evidence: `README.md`)
- Dream Score Planning → Analysis Results: presents plan (evidence: `README.md`)
- SHAP Explanations → Analysis Results: presents factors (evidence: `README.md`)
- Recommendations → Analysis Results: presents advice (evidence: `README.md`)
