# farish3010/skillsync architecture

> Architecture diagram of the GitHub repository farish3010/skillsync, 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/farish3010/skillsync
- Repository: https://github.com/farish3010/skillsync

## Overview

SkillSync benchmarks uploaded curricula against employer skill demand, then presents gap analysis and planning tools. The main workflow runs from syllabus upload through API-side extraction and benchmarking to curriculum coverage results, with separate simulator, student-pathway, industry-insights, and report-export branches. Source excerpts show the backend’s module dependencies and several UI component relationships; the frontend-to-API wiring is not shown, so that connection is marked unverified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/farish3010/skillsync/blob/main/frontend/src/App.jsx) (SkillSync dashboard), [`backend/main.py`](https://github.com/farish3010/skillsync/blob/main/backend/main.py) (FastAPI service), [`backend/extractor.py`](https://github.com/farish3010/skillsync/blob/main/backend/extractor.py) (Document and skill extraction), [`frontend/src/components/FileUploadModal.jsx`](https://github.com/farish3010/skillsync/blob/main/frontend/src/components/FileUploadModal.jsx) (Syllabus upload)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Platform interface"]
  node_app["SkillSync dashboard<br/>[App.jsx]"]
  node_upload["Syllabus upload"]
end

subgraph group_analysis["Curriculum intelligence"]
  node_api["FastAPI service<br/>[main.py]"]
  node_extractor["Document and skill extraction<br/>[extractor.py]"]
  node_analytics["Alignment analytics<br/>[analytics.py]"]
end

subgraph group_data["Benchmark data"]
  node_taxonomy["Skill taxonomy"]
  node_models["Domain models and DB access<br/>[models.py]"]
  node_database[("SQLite benchmark store<br/>[models.py]")]
end

subgraph group_planning["Planning and insights"]
  node_simulator["Curriculum simulator<br/>[SimulatorView.jsx]"]
  node_gauge["Coverage gauge"]
  node_student["Student pathway<br/>[StudentView.jsx]"]
  node_industry["Industry insights<br/>[IndustryView.jsx]"]
  node_jobs["Live job search<br/>[main.py]"]
  node_exporter["Report exporter<br/>[reportExporter.js]"]
end

node_educator(("Educator"))
node_gemini{{"Gemini AI"}}
node_jsearch{{"RapidAPI JSearch"}}

node_educator -->|"uses"| node_app
node_app -.->|"opens"| node_upload
node_upload -.->|"submits syllabus"| node_api
node_api -->|"uses"| node_extractor
node_extractor -.->|"matches skills"| node_taxonomy
node_extractor -->|"extracts with"| node_gemini
node_api -->|"uses"| node_analytics
node_api -->|"uses"| node_models
node_models -->|"configures"| node_database
node_api -->|"serves postings"| node_jobs
node_jobs -->|"queries"| node_jsearch
node_app -.->|"renders"| node_simulator
node_simulator -->|"renders"| node_gauge
node_app -->|"renders"| node_student
node_app -->|"renders"| node_industry
node_app -.->|"exports report"| node_exporter

click node_app "https://github.com/farish3010/skillsync/blob/main/frontend/src/App.jsx"
click node_upload "https://github.com/farish3010/skillsync/blob/main/frontend/src/components/FileUploadModal.jsx"
click node_api "https://github.com/farish3010/skillsync/blob/main/backend/main.py"
click node_extractor "https://github.com/farish3010/skillsync/blob/main/backend/extractor.py"
click node_analytics "https://github.com/farish3010/skillsync/blob/main/backend/analytics.py"
click node_taxonomy "https://github.com/farish3010/skillsync/blob/main/backend/skill_taxonomy.json"
click node_models "https://github.com/farish3010/skillsync/blob/main/backend/models.py"
click node_database "https://github.com/farish3010/skillsync/blob/main/backend/models.py"
click node_simulator "https://github.com/farish3010/skillsync/blob/main/frontend/src/components/SimulatorView.jsx"
click node_gauge "https://github.com/farish3010/skillsync/blob/main/frontend/src/components/CircularCoverageGauge.jsx"
click node_student "https://github.com/farish3010/skillsync/blob/main/frontend/src/components/StudentView.jsx"
click node_industry "https://github.com/farish3010/skillsync/blob/main/frontend/src/components/IndustryView.jsx"
click node_jobs "https://github.com/farish3010/skillsync/blob/main/backend/main.py"
click node_exporter "https://github.com/farish3010/skillsync/blob/main/frontend/src/utils/reportExporter.js"

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_app,node_upload toneBlue
class node_api,node_extractor,node_analytics toneAmber
class node_taxonomy,node_models,node_database,node_jsearch toneMint
class node_simulator,node_gauge,node_student,node_industry,node_jobs,node_exporter toneRose
class node_educator,node_gemini toneIndigo
```

## Components

### Platform interface

- [SkillSync dashboard](https://github.com/farish3010/skillsync/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Syllabus upload](https://github.com/farish3010/skillsync/blob/main/frontend/src/components/FileUploadModal.jsx): `frontend/src/components/FileUploadModal.jsx`

### Curriculum intelligence

- [FastAPI service](https://github.com/farish3010/skillsync/blob/main/backend/main.py): `backend/main.py`
- [Document and skill extraction](https://github.com/farish3010/skillsync/blob/main/backend/extractor.py): `backend/extractor.py`
- [Alignment analytics](https://github.com/farish3010/skillsync/blob/main/backend/analytics.py): `backend/analytics.py`

### Benchmark data

- [Skill taxonomy](https://github.com/farish3010/skillsync/blob/main/backend/skill_taxonomy.json): `backend/skill_taxonomy.json`
- [Domain models and DB access](https://github.com/farish3010/skillsync/blob/main/backend/models.py): `backend/models.py`
- [SQLite benchmark store](https://github.com/farish3010/skillsync/blob/main/backend/models.py): `backend/models.py`

### Planning and insights

- [Curriculum simulator](https://github.com/farish3010/skillsync/blob/main/frontend/src/components/SimulatorView.jsx): `frontend/src/components/SimulatorView.jsx`
- [Coverage gauge](https://github.com/farish3010/skillsync/blob/main/frontend/src/components/CircularCoverageGauge.jsx): `frontend/src/components/CircularCoverageGauge.jsx`
- [Student pathway](https://github.com/farish3010/skillsync/blob/main/frontend/src/components/StudentView.jsx): `frontend/src/components/StudentView.jsx`
- [Industry insights](https://github.com/farish3010/skillsync/blob/main/frontend/src/components/IndustryView.jsx): `frontend/src/components/IndustryView.jsx`
- [Live job search](https://github.com/farish3010/skillsync/blob/main/backend/main.py): `backend/main.py`
- [Report exporter](https://github.com/farish3010/skillsync/blob/main/frontend/src/utils/reportExporter.js): `frontend/src/utils/reportExporter.js`

### Other components

- **Educator**
- **Gemini AI**
- **RapidAPI JSearch**

## Connections

- Educator → SkillSync dashboard: uses (evidence: `README.md`)
- SkillSync dashboard → Syllabus upload: opens (evidence: `frontend/src/App.jsx`)
- Syllabus upload → FastAPI service: submits syllabus
- FastAPI service → Document and skill extraction: uses (evidence: `backend/main.py`)
- Document and skill extraction → Skill taxonomy: matches skills
- Document and skill extraction → Gemini AI: extracts with (evidence: `backend/extractor.py`)
- FastAPI service → Alignment analytics: uses (evidence: `backend/main.py`)
- FastAPI service → Domain models and DB access: uses (evidence: `backend/main.py`)
- Domain models and DB access → SQLite benchmark store: configures (evidence: `backend/models.py`)
- FastAPI service → Live job search: serves postings (evidence: `backend/main.py`)
- Live job search → RapidAPI JSearch: queries (evidence: `backend/main.py`)
- SkillSync dashboard → Curriculum simulator: renders (evidence: `frontend/src/App.jsx`)
- Curriculum simulator → Coverage gauge: renders (evidence: `frontend/src/components/SimulatorView.jsx`)
- SkillSync dashboard → Student pathway: renders (evidence: `frontend/src/App.jsx`)
- SkillSync dashboard → Industry insights: renders (evidence: `frontend/src/App.jsx`)
- SkillSync dashboard → Report exporter: exports report (evidence: `frontend/src/App.jsx`)
