# skillspherefyp-ui/skill-sphere-cpanel architecture

> Architecture diagram of the GitHub repository skillspherefyp-ui/skill-sphere-cpanel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skillspherefyp-ui/skill-sphere-cpanel
- Repository: https://github.com/skillspherefyp-ui/skill-sphere-cpanel

## Overview

SkillSphere is a cross-platform learning management system. A student discovers a course, enrolls, studies its materials, completes quizzes, and tracks progress; course completion can lead to a certificate. The mobile/web client also supports role-specific administration and AI-assisted learning. Its Express API routes requests through authentication and domain controllers to Sequelize models backed by MySQL. The README documents the broad LMS capabilities; source excerpts and the source index support the specific wiring shown. Other unsampled domain routes are represented at subsystem level rather than with inferred call chains.

Main entry points: [`backend/server.js`](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/server.js) (Express server), [`backend/services/aiTutorService.js`](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/services/aiTutorService.js) (AI teaching engine), [`AppAndroidSS/src/services/apiClient.js`](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/src/services/apiClient.js) (API client), [`backend/models/index.js`](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/models/index.js) (Domain models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_app["App shell<br/>[App.js]"]
  node_role_nav["Role navigation<br/>[AppNavigator.js]"]
  node_auth_state["Auth state<br/>[AuthContext.js]"]
  node_data_state["Learning state<br/>[DataContext.js]"]
  node_student_ui["Student learning"]
  node_ai_ui["AI classroom UI"]
  node_staff_ui["Staff tools"]
  node_api_client["API client<br/>[apiClient.js]"]
end

subgraph group_api["API and access"]
  node_api_server["Express server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_auth_controller["Authentication<br/>[authController.js]"]
  node_auth_middleware["Access control<br/>[auth.js]"]
  node_enrollment_routes["Enrollment routes"]
  node_enrollment_controller["Enrollment logic"]
  node_email["Email delivery<br/>[emailService.js]"]
end

subgraph group_learning["Learning services"]
  node_ai_routes["AI tutor routes<br/>[aiTutorRoutes.js]"]
  node_ai_controller["AI tutor controller"]
  node_ai_service["AI teaching engine<br/>[aiTutorService.js]"]
  node_ai_support["AI support services"]
  node_ai_content["AI content tools"]
  node_certificate["Certificates"]
end

subgraph group_persistence["Persistence and delivery"]
  node_models["Domain models<br/>[index.js]"]
  node_database_config["Database connection<br/>[database.js]"]
  node_mysql[("MySQL")]
end

node_learner(("Learner"))
node_ai_provider(("AI provider"))

node_learner -->|"uses"| node_app
node_app -->|"provides auth"| node_auth_state
node_app -->|"provides data"| node_data_state
node_app -->|"renders"| node_role_nav
node_role_nav -->|"checks identity"| node_auth_state
node_auth_state -->|"requests API"| node_api_client
node_data_state -->|"requests API"| node_api_client
node_learner -->|"browses and learns"| node_student_ui
node_student_ui -.->|"loads course data"| node_api_client
node_learner -->|"uses AI learning"| node_ai_ui
node_staff_ui -.->|"manages LMS"| node_api_client
node_api_client -->|"calls API"| node_api_server
node_api_server -->|"mounts routes"| node_auth_routes
node_api_server -->|"mounts routes"| node_enrollment_routes
node_auth_routes -->|"guards requests"| node_auth_middleware
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_controller -->|"reads users"| node_models
node_auth_controller -->|"sends OTP email"| node_email
node_enrollment_routes -->|"requires login"| node_auth_middleware
node_enrollment_routes -->|"dispatches"| node_enrollment_controller
node_enrollment_controller -->|"reads enrollment data"| node_models
node_enrollment_controller -->|"sends confirmation"| node_email
node_api_server -->|"mounts AI API"| node_ai_routes
node_ai_routes -->|"dispatches"| node_ai_controller
node_ai_controller -->|"delegates teaching"| node_ai_service
node_ai_service -->|"uses memory"| node_ai_support
node_ai_service -->|"uses guided steps"| node_ai_content
node_ai_service -->|"reads and writes"| node_models
node_ai_service -.->|"requests generation"| node_ai_provider
node_api_server -->|"initializes"| node_database_config
node_database_config -->|"connects"| node_mysql
node_models -.->|"uses Sequelize"| node_database_config
node_certificate -.->|"uses certificate data"| node_models
node_learner -->|"earns certificate"| node_certificate

click node_app "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/App.js"
click node_role_nav "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/src/navigation/AppNavigator.js"
click node_auth_state "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/src/context/AuthContext.js"
click node_data_state "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/src/context/DataContext.js"
click node_student_ui "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/tree/main/AppAndroidSS/src/screens/student"
click node_ai_ui "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/src/screens/student/AIVirtualClassroomScreen.js"
click node_staff_ui "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/tree/main/AppAndroidSS/src/screens/instructor"
click node_api_client "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/src/services/apiClient.js"
click node_api_server "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/server.js"
click node_auth_routes "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/routes/authRoutes.js"
click node_auth_controller "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/controllers/authController.js"
click node_auth_middleware "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/middleware/auth.js"
click node_enrollment_routes "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/routes/enrollmentRoutes.js"
click node_enrollment_controller "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/controllers/enrollmentController.js"
click node_ai_routes "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/routes/aiTutorRoutes.js"
click node_ai_controller "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/controllers/aiTutorController.js"
click node_ai_service "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/services/aiTutorService.js"
click node_ai_support "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/services/aiStudentMemoryService.js"
click node_ai_content "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/services/guidedStepsService.js"
click node_certificate "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/services/certificateService.js"
click node_email "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/services/emailService.js"
click node_models "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/models/index.js"
click node_database_config "https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/config/database.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_role_nav,node_auth_state,node_data_state,node_student_ui,node_ai_ui,node_staff_ui,node_api_client toneBlue
class node_api_server,node_auth_routes,node_auth_controller,node_auth_middleware,node_enrollment_routes,node_enrollment_controller,node_email toneAmber
class node_ai_routes,node_ai_controller,node_ai_service,node_ai_support,node_ai_content,node_certificate toneMint
class node_models,node_database_config,node_mysql toneRose
class node_learner,node_ai_provider toneIndigo
```

## Components

### Client experience

- [App shell](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/App.js): `AppAndroidSS/App.js`
- [Role navigation](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/src/navigation/AppNavigator.js): `AppAndroidSS/src/navigation/AppNavigator.js`
- [Auth state](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/src/context/AuthContext.js): `AppAndroidSS/src/context/AuthContext.js`
- [Learning state](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/src/context/DataContext.js): `AppAndroidSS/src/context/DataContext.js`
- [Student learning](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/tree/main/AppAndroidSS/src/screens/student): `AppAndroidSS/src/screens/student`
- [AI classroom UI](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/src/screens/student/AIVirtualClassroomScreen.js): `AppAndroidSS/src/screens/student/AIVirtualClassroomScreen.js`
- [Staff tools](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/tree/main/AppAndroidSS/src/screens/instructor): `AppAndroidSS/src/screens/instructor`
- [API client](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/AppAndroidSS/src/services/apiClient.js): `AppAndroidSS/src/services/apiClient.js`

### API and access

- [Express server](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Authentication](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Access control](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Enrollment routes](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/routes/enrollmentRoutes.js): `backend/routes/enrollmentRoutes.js`
- [Enrollment logic](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/controllers/enrollmentController.js): `backend/controllers/enrollmentController.js`
- [Email delivery](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/services/emailService.js): `backend/services/emailService.js`

### Learning services

- [AI tutor routes](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/routes/aiTutorRoutes.js): `backend/routes/aiTutorRoutes.js`
- [AI tutor controller](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/controllers/aiTutorController.js): `backend/controllers/aiTutorController.js`
- [AI teaching engine](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/services/aiTutorService.js): `backend/services/aiTutorService.js`
- [AI support services](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/services/aiStudentMemoryService.js): `backend/services/aiStudentMemoryService.js`
- [AI content tools](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/services/guidedStepsService.js): `backend/services/guidedStepsService.js`
- [Certificates](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/services/certificateService.js): `backend/services/certificateService.js`

### Persistence and delivery

- [Domain models](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/models/index.js): `backend/models/index.js`
- [Database connection](https://github.com/skillspherefyp-ui/skill-sphere-cpanel/blob/main/backend/config/database.js): `backend/config/database.js`
- **MySQL**

### Other components

- **Learner**
- **AI provider**

## Connections

- Learner → App shell: uses (evidence: `README.md`)
- App shell → Auth state: provides auth (evidence: `AppAndroidSS/App.js`)
- App shell → Learning state: provides data (evidence: `AppAndroidSS/App.js`)
- App shell → Role navigation: renders (evidence: `AppAndroidSS/App.js`)
- Role navigation → Auth state: checks identity (evidence: `AppAndroidSS/src/navigation/AppNavigator.js`)
- Auth state → API client: requests API (evidence: `AppAndroidSS/src/context/AuthContext.js`)
- Learning state → API client: requests API (evidence: `AppAndroidSS/src/context/DataContext.js`)
- Learner → Student learning: browses and learns (evidence: `README.md`)
- Student learning → API client: loads course data
- Learner → AI classroom UI: uses AI learning (evidence: `README.md`)
- Staff tools → API client: manages LMS
- API client → Express server: calls API (evidence: `README.md`)
- Express server → Auth routes: mounts routes (evidence: `backend/server.js`)
- Express server → Enrollment routes: mounts routes (evidence: `backend/server.js`)
- Auth routes → Access control: guards requests (evidence: `backend/routes/authRoutes.js`)
- Auth routes → Authentication: dispatches (evidence: `backend/routes/authRoutes.js`)
- Authentication → Domain models: reads users (evidence: `backend/controllers/authController.js`)
- Authentication → Email delivery: sends OTP email (evidence: `backend/controllers/authController.js`)
- Enrollment routes → Access control: requires login (evidence: `backend/routes/enrollmentRoutes.js`)
- Enrollment routes → Enrollment logic: dispatches (evidence: `backend/routes/enrollmentRoutes.js`)
- Enrollment logic → Domain models: reads enrollment data (evidence: `backend/controllers/enrollmentController.js`)
- Enrollment logic → Email delivery: sends confirmation (evidence: `backend/controllers/enrollmentController.js`)
- Express server → AI tutor routes: mounts AI API (evidence: `backend/server.js`)
- AI tutor routes → AI tutor controller: dispatches (evidence: `backend/routes/aiTutorRoutes.js`)
- AI tutor controller → AI teaching engine: delegates teaching (evidence: `backend/controllers/aiTutorController.js`)
- AI teaching engine → AI support services: uses memory (evidence: `backend/services/aiTutorService.js`)
- AI teaching engine → AI content tools: uses guided steps (evidence: `backend/services/aiTutorService.js`)
- AI teaching engine → Domain models: reads and writes (evidence: `backend/services/aiTutorService.js`)
- AI teaching engine → AI provider: requests generation
- Express server → Database connection: initializes (evidence: `backend/server.js`)
- Database connection → MySQL: connects (evidence: `backend/config/database.js`)
- Domain models → Database connection: uses Sequelize (evidence: `backend/models/index.js`)
- Certificates → Domain models: uses certificate data
- Learner → Certificates: earns certificate (evidence: `README.md`)
