# sghousiya886-crypto/concept2career architecture

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

- Interactive diagram: https://gitdiagram.com/sghousiya886-crypto/concept2career
- Repository: https://github.com/sghousiya886-crypto/concept2career

## Overview

Concept2Career is a student learning platform connecting curriculum concepts to interactive simulations, quizzes, career exploration, and progress tracking, with a teacher analytics view and AI tutor. The main flow starts in the React app, where learners navigate between learning activities; app state tracks student progress. Quiz generation also calls a local backend endpoint. The source index confirms several component-to-data imports, but many component implementations and the backend were not excerpted, so those relationships are limited to indexed references.

Main entry points: [`frontend/src/App.jsx`](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/App.jsx) (App and State), [`frontend/src/data/mockData.js`](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/data/mockData.js) (Learning Data), [`frontend/src/components/SimulationView.jsx`](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/SimulationView.jsx) (Interactive Simulations), [`frontend/src/components/ConceptsView.jsx`](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/ConceptsView.jsx) (Concept Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_app["App and State<br/>[App.jsx]"]
  node_navigation["Navigation<br/>[Sidebar.jsx]"]
  node_header["Learner Header<br/>[Header.jsx]"]
end

subgraph group_learning["Learning Activities"]
  node_dashboard["Student Dashboard<br/>[DashboardView.jsx]"]
  node_simulation["Interactive Simulations<br/>[SimulationView.jsx]"]
  node_concepts["Concept Catalog<br/>[ConceptsView.jsx]"]
  node_quiz["Quiz Activity<br/>[QuizView.jsx]"]
  node_voice["Voice Assistant<br/>[VoiceAssistant.jsx]"]
end

subgraph group_progress["Progress and Guidance"]
  node_careers["Career Roadmaps"]
  node_gamification["Gamification"]
  node_teacher["Teacher Analytics<br/>[TeacherView.jsx]"]
  node_tutor["AI Tutor<br/>[AITutorWidget.jsx]"]
end

subgraph group_services["Data and Services"]
  node_content["Learning Data<br/>[mockData.js]"]
  node_backend["Quiz Backend<br/>[main.py]"]
end

node_learner(("Learner"))
node_speech["Browser Speech API"]

node_learner -.->|"uses"| node_app
node_app -->|"renders"| node_navigation
node_app -->|"renders"| node_header
node_app -->|"renders"| node_dashboard
node_app -->|"renders"| node_simulation
node_app -->|"renders"| node_concepts
node_app -->|"renders"| node_quiz
node_app -->|"renders"| node_careers
node_app -->|"renders"| node_gamification
node_app -->|"renders"| node_teacher
node_app -->|"renders"| node_tutor
node_app -->|"reads"| node_content
node_dashboard -->|"reads"| node_content
node_simulation -->|"reads"| node_content
node_concepts -->|"reads"| node_content
node_concepts -->|"renders"| node_voice
node_simulation -.->|"uses"| node_voice
node_quiz -->|"requests quiz"| node_backend
node_voice -->|"speaks through"| node_speech
node_careers -->|"reads"| node_content
node_gamification -->|"reads"| node_content
node_teacher -->|"reads"| node_content

click node_app "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/App.jsx"
click node_navigation "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/Sidebar.jsx"
click node_header "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/Header.jsx"
click node_dashboard "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/DashboardView.jsx"
click node_simulation "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/SimulationView.jsx"
click node_concepts "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/ConceptsView.jsx"
click node_quiz "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/QuizView.jsx"
click node_voice "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/VoiceAssistant.jsx"
click node_careers "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/CareerRoadmapView.jsx"
click node_gamification "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/GamificationView.jsx"
click node_teacher "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/TeacherView.jsx"
click node_tutor "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/AITutorWidget.jsx"
click node_content "https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/data/mockData.js"
click node_backend "https://github.com/sghousiya886-crypto/concept2career/blob/main/backend/main.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_app,node_navigation,node_header,node_speech toneBlue
class node_dashboard,node_simulation,node_concepts,node_quiz,node_voice toneAmber
class node_careers,node_gamification,node_teacher,node_tutor toneMint
class node_content,node_backend toneRose
class node_learner toneIndigo
```

## Components

### Application Shell

- [App and State](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Navigation](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/Sidebar.jsx): `frontend/src/components/Sidebar.jsx`
- [Learner Header](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/Header.jsx): `frontend/src/components/Header.jsx`

### Learning Activities

- [Student Dashboard](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/DashboardView.jsx): `frontend/src/components/DashboardView.jsx`
- [Interactive Simulations](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/SimulationView.jsx): `frontend/src/components/SimulationView.jsx`
- [Concept Catalog](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/ConceptsView.jsx): `frontend/src/components/ConceptsView.jsx`
- [Quiz Activity](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/QuizView.jsx): `frontend/src/components/QuizView.jsx`
- [Voice Assistant](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/VoiceAssistant.jsx): `frontend/src/components/VoiceAssistant.jsx`

### Progress and Guidance

- [Career Roadmaps](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/CareerRoadmapView.jsx): `frontend/src/components/CareerRoadmapView.jsx`
- [Gamification](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/GamificationView.jsx): `frontend/src/components/GamificationView.jsx`
- [Teacher Analytics](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/TeacherView.jsx): `frontend/src/components/TeacherView.jsx`
- [AI Tutor](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/components/AITutorWidget.jsx): `frontend/src/components/AITutorWidget.jsx`

### Data and Services

- [Learning Data](https://github.com/sghousiya886-crypto/concept2career/blob/main/frontend/src/data/mockData.js): `frontend/src/data/mockData.js`
- [Quiz Backend](https://github.com/sghousiya886-crypto/concept2career/blob/main/backend/main.py): `backend/main.py`

### Other components

- **Learner**
- **Browser Speech API**

## Connections

- Learner → App and State: uses
- App and State → Navigation: renders (evidence: `frontend/src/App.jsx`)
- App and State → Learner Header: renders (evidence: `frontend/src/App.jsx`)
- App and State → Student Dashboard: renders (evidence: `frontend/src/App.jsx`)
- App and State → Interactive Simulations: renders (evidence: `frontend/src/App.jsx`)
- App and State → Concept Catalog: renders (evidence: `frontend/src/App.jsx`)
- App and State → Quiz Activity: renders (evidence: `frontend/src/App.jsx`)
- App and State → Career Roadmaps: renders (evidence: `frontend/src/App.jsx`)
- App and State → Gamification: renders (evidence: `frontend/src/App.jsx`)
- App and State → Teacher Analytics: renders (evidence: `frontend/src/App.jsx`)
- App and State → AI Tutor: renders (evidence: `frontend/src/App.jsx`)
- App and State → Learning Data: reads (evidence: `frontend/src/App.jsx`)
- Student Dashboard → Learning Data: reads (evidence: `frontend/src/components/DashboardView.jsx`)
- Interactive Simulations → Learning Data: reads (evidence: `frontend/src/components/SimulationView.jsx`)
- Concept Catalog → Learning Data: reads (evidence: `frontend/src/components/ConceptsView.jsx`)
- Concept Catalog → Voice Assistant: renders (evidence: `frontend/src/components/ConceptsView.jsx`)
- Interactive Simulations → Voice Assistant: uses (evidence: `frontend/src/components/SimulationView.jsx`)
- Quiz Activity → Quiz Backend: requests quiz (evidence: `frontend/src/components/QuizView.jsx`)
- Voice Assistant → Browser Speech API: speaks through (evidence: `frontend/src/components/VoiceAssistant.jsx`)
- Career Roadmaps → Learning Data: reads (evidence: `frontend/src/components/CareerRoadmapView.jsx`)
- Gamification → Learning Data: reads (evidence: `frontend/src/components/GamificationView.jsx`)
- Teacher Analytics → Learning Data: reads (evidence: `frontend/src/components/TeacherView.jsx`)
