# vishnuteja-sangineni/skillsync-lms architecture

> Architecture diagram of the GitHub repository vishnuteja-sangineni/skillsync-lms, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vishnuteja-sangineni/skillsync-lms
- Repository: https://github.com/vishnuteja-sangineni/skillsync-lms

## Overview

SkillSync is an adaptive learning management platform. Learners use the browser SPA to authenticate, access courses and lessons, take adaptive quizzes, and view progress, predictions, and recommendations; teachers and admins have analytics and administration views. The backend exposes API routers over persistent learning records, with separate mastery, analytics, prediction, and recommendation capabilities. The README documents the wider capabilities; several router and ML implementations were not sampled, so uncertain internal links are omitted or marked unverified.

Main entry points: [`app/main.py`](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/main.py) (FastAPI application), [`frontend/js/app.js`](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/frontend/js/app.js) (View controllers), [`app/routers/analytics.py`](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/routers/analytics.py) (Analytics routes), [`app/routers/predictions.py`](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/routers/predictions.py) (Prediction routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_spa["View controllers<br/>[app.js]"]
  node_navigation["SPA navigation<br/>[router.js]"]
  node_authui["Sign-in forms<br/>[auth.js]"]
  node_charts["Analytics charts<br/>[charts.js]"]
  node_apiclient["API client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_application["FastAPI application<br/>[main.py]"]
  node_auth["Authentication routes<br/>[auth.py]"]
  node_courseapi["Course and lesson routes"]
  node_quizapi["Quiz and question routes"]
  node_progressapi["Progress routes<br/>[progress.py]"]
  node_analyticsapi["Analytics routes<br/>[analytics.py]"]
  node_predictionapi["Prediction routes<br/>[predictions.py]"]
  node_recommendationapi["Recommendation routes<br/>[recommendations.py]"]
end

subgraph group_learning["Learning domain"]
  node_adaptive["Adaptive question selection<br/>[adaptive.py]"]
  node_mastery["Mastery and forgetting<br/>[mastery.py]"]
end

subgraph group_insights["Learning insights"]
  node_analytics["Learning analytics<br/>[analytics.py]"]
  node_prediction["Score prediction<br/>[predict.py]"]
  node_features["Student features<br/>[features.py]"]
  node_training["Model training<br/>[train.py]"]
  node_modelstorage["Model storage<br/>[storage.py]"]
  node_recommendations["Hybrid recommendations<br/>[engine.py]"]
end

subgraph group_platform["Runtime and data"]
  node_records[("Learning records<br/>[progress.py]")]
  node_database[("Database sessions<br/>[database.py]")]
end

node_user(("Learner, teacher, admin"))

node_user -->|"uses"| node_spa
node_spa -->|"requests data"| node_apiclient
node_authui -->|"submits credentials"| node_apiclient
node_authui -->|"routes after login"| node_navigation
node_application -->|"registers"| node_auth
node_application -->|"registers"| node_courseapi
node_application -->|"registers"| node_quizapi
node_application -->|"registers"| node_progressapi
node_application -->|"registers"| node_analyticsapi
node_application -->|"registers"| node_predictionapi
node_application -->|"registers"| node_recommendationapi
node_application -->|"serves frontend"| node_spa
node_adaptive -->|"applies decay"| node_mastery
node_records -->|"uses base"| node_database
node_spa -->|"requests analytics"| node_analyticsapi
node_spa -->|"requests prediction"| node_predictionapi
node_spa -->|"requests recommendations"| node_recommendationapi
node_recommendationapi -.->|"dispatches to"| node_recommendations
node_predictionapi -.->|"dispatches to"| node_prediction
node_analyticsapi -.->|"dispatches to"| node_analytics
node_quizapi -.->|"uses selection"| node_adaptive
node_training -.->|"trains from"| node_features
node_prediction -.->|"loads model"| node_modelstorage
node_charts -.->|"visualizes results"| node_spa

click node_spa "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/frontend/js/app.js"
click node_navigation "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/frontend/js/router.js"
click node_authui "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/frontend/js/auth.js"
click node_charts "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/frontend/js/charts.js"
click node_apiclient "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/frontend/js/api.js"
click node_application "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/main.py"
click node_auth "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/routers/auth.py"
click node_courseapi "https://github.com/vishnuteja-sangineni/skillsync-lms/tree/main/app/routers"
click node_quizapi "https://github.com/vishnuteja-sangineni/skillsync-lms/tree/main/app/routers"
click node_progressapi "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/routers/progress.py"
click node_analyticsapi "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/routers/analytics.py"
click node_predictionapi "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/routers/predictions.py"
click node_recommendationapi "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/routers/recommendations.py"
click node_adaptive "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/services/adaptive.py"
click node_mastery "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/services/mastery.py"
click node_records "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/models/progress.py"
click node_analytics "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/services/analytics.py"
click node_prediction "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/ml/predict.py"
click node_features "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/ml/features.py"
click node_training "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/ml/train.py"
click node_modelstorage "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/ml/storage.py"
click node_recommendations "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/recommender/engine.py"
click node_database "https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/database.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_spa,node_navigation,node_authui,node_charts,node_apiclient toneBlue
class node_application,node_auth,node_courseapi,node_quizapi,node_progressapi,node_analyticsapi,node_predictionapi,node_recommendationapi toneAmber
class node_adaptive,node_mastery toneMint
class node_analytics,node_prediction,node_features,node_training,node_modelstorage,node_recommendations toneRose
class node_records,node_database,node_user toneIndigo
```

## Components

### Web experience

- [View controllers](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/frontend/js/app.js): `frontend/js/app.js`
- [SPA navigation](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/frontend/js/router.js): `frontend/js/router.js`
- [Sign-in forms](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/frontend/js/auth.js): `frontend/js/auth.js`
- [Analytics charts](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/frontend/js/charts.js): `frontend/js/charts.js`
- [API client](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/frontend/js/api.js): `frontend/js/api.js`

### API and access

- [FastAPI application](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/main.py): `app/main.py`
- [Authentication routes](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/routers/auth.py): `app/routers/auth.py`
- [Course and lesson routes](https://github.com/vishnuteja-sangineni/skillsync-lms/tree/main/app/routers): `app/routers`
- [Quiz and question routes](https://github.com/vishnuteja-sangineni/skillsync-lms/tree/main/app/routers): `app/routers`
- [Progress routes](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/routers/progress.py): `app/routers/progress.py`
- [Analytics routes](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/routers/analytics.py): `app/routers/analytics.py`
- [Prediction routes](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/routers/predictions.py): `app/routers/predictions.py`
- [Recommendation routes](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/routers/recommendations.py): `app/routers/recommendations.py`

### Learning domain

- [Adaptive question selection](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/services/adaptive.py): `app/services/adaptive.py`
- [Mastery and forgetting](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/services/mastery.py): `app/services/mastery.py`

### Learning insights

- [Learning analytics](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/services/analytics.py): `app/services/analytics.py`
- [Score prediction](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/ml/predict.py): `ml/predict.py`
- [Student features](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/ml/features.py): `ml/features.py`
- [Model training](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/ml/train.py): `ml/train.py`
- [Model storage](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/ml/storage.py): `ml/storage.py`
- [Hybrid recommendations](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/recommender/engine.py): `recommender/engine.py`

### Runtime and data

- [Learning records](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/models/progress.py): `app/models/progress.py`
- [Database sessions](https://github.com/vishnuteja-sangineni/skillsync-lms/blob/main/app/database.py): `app/database.py`

### Other components

- **Learner, teacher, admin**

## Connections

- Learner, teacher, admin → View controllers: uses
- View controllers → API client: requests data (evidence: `frontend/js/app.js`)
- Sign-in forms → API client: submits credentials (evidence: `frontend/js/auth.js`)
- Sign-in forms → SPA navigation: routes after login (evidence: `frontend/js/auth.js`)
- FastAPI application → Authentication routes: registers (evidence: `app/main.py`)
- FastAPI application → Course and lesson routes: registers (evidence: `app/main.py`)
- FastAPI application → Quiz and question routes: registers (evidence: `app/main.py`)
- FastAPI application → Progress routes: registers (evidence: `app/main.py`)
- FastAPI application → Analytics routes: registers (evidence: `app/main.py`)
- FastAPI application → Prediction routes: registers (evidence: `app/main.py`)
- FastAPI application → Recommendation routes: registers (evidence: `app/main.py`)
- FastAPI application → View controllers: serves frontend (evidence: `app/main.py`)
- Adaptive question selection → Mastery and forgetting: applies decay (evidence: `app/services/adaptive.py`)
- Learning records → Database sessions: uses base (evidence: `app/models/progress.py`)
- View controllers → Analytics routes: requests analytics (evidence: `frontend/js/app.js`)
- View controllers → Prediction routes: requests prediction (evidence: `frontend/js/app.js`)
- View controllers → Recommendation routes: requests recommendations (evidence: `frontend/js/app.js`)
- Recommendation routes → Hybrid recommendations: dispatches to
- Prediction routes → Score prediction: dispatches to
- Analytics routes → Learning analytics: dispatches to
- Quiz and question routes → Adaptive question selection: uses selection
- Model training → Student features: trains from
- Score prediction → Model storage: loads model
- Analytics charts → View controllers: visualizes results (evidence: `frontend/js/app.js`)
