# swymmm/adaptive-assessement-system architecture

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

- Interactive diagram: https://gitdiagram.com/swymmm/adaptive-assessement-system
- Repository: https://github.com/swymmm/adaptive-assessement-system

## Overview

Adaptive Assessment System is a PHP/MySQL learning application for students and administrators. Students register or log in, browse and search course material, then take chapter assessments that select questions by difficulty; answers are submitted for grading and feedback, with progress and weak-topic recommendations surfaced in analytics. Administrators manage courses, chapters, and MCQ/coding questions and review attempt logs. The excerpts show assessment selection, search, and authoring queries; some links between grading, results, and analytics are documented but their implementation details were not sampled.

Main entry points: [`public/assessment.php`](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/assessment.php) (Assessment Runner), [`public/submit_answer.php`](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/submit_answer.php) (Answer Grading), [`config/db.php`](https://github.com/swymmm/adaptive-assessement-system/blob/main/config/db.php) (Database Connector), [`public/search.php`](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/search.php) (Content Search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learner["Student Learning"]
  node_public_home["Home<br/>[index.php]"]
  node_accounts["Accounts<br/>[register.php]"]
  node_course_browse["Course Browser<br/>[course.php]"]
  node_search["Content Search<br/>[search.php]"]
  node_assessment["Assessment Runner<br/>[assessment.php]"]
  node_answer_submit["Answer Grading<br/>[submit_answer.php]"]
  node_assessment_result["Assessment Feedback"]
  node_analytics["Learning Analytics<br/>[dashboard.php]"]
  node_profile["Student Profile<br/>[profile.php]"]
end

subgraph group_admin["Admin Content"]
  node_admin_courses["Course Management<br/>[courses.php]"]
  node_admin_chapters["Chapter Management<br/>[chapters.php]"]
  node_admin_questions["Question Authoring<br/>[question_edit.php]"]
  node_admin_attempts["Attempt Logs<br/>[attempts.php]"]
end

subgraph group_runtime["Application Runtime"]
  node_public_runtime["Student Runtime<br/>[bootstrap.php]"]
  node_admin_runtime["Admin Runtime<br/>[bootstrap.php]"]
end

subgraph group_data["Data Services"]
  node_database_config["Database Connector<br/>[db.php]"]
  node_mysql[("MySQL Database")]
end

node_student(("Student"))
node_admin_user(("Administrator"))

node_student -->|"opens"| node_public_home
node_student -->|"registers or logs in"| node_accounts
node_student -->|"browses courses"| node_course_browse
node_student -->|"searches content"| node_search
node_student -->|"takes assessment"| node_assessment
node_assessment -->|"posts answer"| node_answer_submit
node_student -->|"reviews progress"| node_analytics
node_student -->|"manages profile"| node_profile
node_admin_user -->|"manages courses"| node_admin_courses
node_admin_courses -->|"manages chapters"| node_admin_chapters
node_admin_chapters -->|"authors questions"| node_admin_questions
node_admin_user -->|"reviews attempts"| node_admin_attempts
node_public_runtime -->|"loads connector"| node_database_config
node_admin_runtime -->|"loads connector"| node_database_config
node_database_config -->|"opens connection"| node_mysql
node_assessment -->|"reads questions and writes assessments"| node_mysql
node_search -->|"searches chapters and questions"| node_mysql
node_admin_questions -->|"reads and writes question data"| node_mysql
node_answer_submit -.->|"returns graded feedback"| node_assessment_result
node_answer_submit -.->|"records performance"| node_analytics
node_admin_attempts -.->|"reads attempt logs"| node_mysql

click node_public_home "https://github.com/swymmm/adaptive-assessement-system/blob/main/public/index.php"
click node_accounts "https://github.com/swymmm/adaptive-assessement-system/blob/main/public/register.php"
click node_course_browse "https://github.com/swymmm/adaptive-assessement-system/blob/main/public/course.php"
click node_search "https://github.com/swymmm/adaptive-assessement-system/blob/main/public/search.php"
click node_assessment "https://github.com/swymmm/adaptive-assessement-system/blob/main/public/assessment.php"
click node_answer_submit "https://github.com/swymmm/adaptive-assessement-system/blob/main/public/submit_answer.php"
click node_assessment_result "https://github.com/swymmm/adaptive-assessement-system/blob/main/public/assessment_done.php"
click node_analytics "https://github.com/swymmm/adaptive-assessement-system/blob/main/public/dashboard.php"
click node_profile "https://github.com/swymmm/adaptive-assessement-system/blob/main/public/profile.php"
click node_admin_courses "https://github.com/swymmm/adaptive-assessement-system/blob/main/admin/courses.php"
click node_admin_chapters "https://github.com/swymmm/adaptive-assessement-system/blob/main/admin/chapters.php"
click node_admin_questions "https://github.com/swymmm/adaptive-assessement-system/blob/main/admin/question_edit.php"
click node_admin_attempts "https://github.com/swymmm/adaptive-assessement-system/blob/main/admin/attempts.php"
click node_public_runtime "https://github.com/swymmm/adaptive-assessement-system/blob/main/public/bootstrap.php"
click node_admin_runtime "https://github.com/swymmm/adaptive-assessement-system/blob/main/admin/bootstrap.php"
click node_database_config "https://github.com/swymmm/adaptive-assessement-system/blob/main/config/db.php"

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_public_home,node_accounts,node_course_browse,node_search,node_assessment,node_answer_submit,node_assessment_result,node_analytics,node_profile toneBlue
class node_admin_courses,node_admin_chapters,node_admin_questions,node_admin_attempts toneAmber
class node_public_runtime,node_admin_runtime toneMint
class node_database_config,node_mysql toneRose
class node_student,node_admin_user toneIndigo
```

## Components

### Student Learning

- [Home](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/index.php): `public/index.php`
- [Accounts](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/register.php): `public/register.php`
- [Course Browser](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/course.php): `public/course.php`
- [Content Search](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/search.php): `public/search.php`
- [Assessment Runner](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/assessment.php): `public/assessment.php`
- [Answer Grading](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/submit_answer.php): `public/submit_answer.php`
- [Assessment Feedback](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/assessment_done.php): `public/assessment_done.php`
- [Learning Analytics](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/dashboard.php): `public/dashboard.php`
- [Student Profile](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/profile.php): `public/profile.php`

### Admin Content

- [Course Management](https://github.com/swymmm/adaptive-assessement-system/blob/main/admin/courses.php): `admin/courses.php`
- [Chapter Management](https://github.com/swymmm/adaptive-assessement-system/blob/main/admin/chapters.php): `admin/chapters.php`
- [Question Authoring](https://github.com/swymmm/adaptive-assessement-system/blob/main/admin/question_edit.php): `admin/question_edit.php`
- [Attempt Logs](https://github.com/swymmm/adaptive-assessement-system/blob/main/admin/attempts.php): `admin/attempts.php`

### Application Runtime

- [Student Runtime](https://github.com/swymmm/adaptive-assessement-system/blob/main/public/bootstrap.php): `public/bootstrap.php`
- [Admin Runtime](https://github.com/swymmm/adaptive-assessement-system/blob/main/admin/bootstrap.php): `admin/bootstrap.php`

### Data Services

- [Database Connector](https://github.com/swymmm/adaptive-assessement-system/blob/main/config/db.php): `config/db.php`
- **MySQL Database**

### Other components

- **Student**
- **Administrator**

## Connections

- Student → Home: opens (evidence: `public/index.php`)
- Student → Accounts: registers or logs in (evidence: `README.md`)
- Student → Course Browser: browses courses (evidence: `README.md`)
- Student → Content Search: searches content (evidence: `README.md`)
- Student → Assessment Runner: takes assessment (evidence: `README.md`)
- Assessment Runner → Answer Grading: posts answer (evidence: `public/assessment.php`)
- Student → Learning Analytics: reviews progress (evidence: `README.md`)
- Student → Student Profile: manages profile
- Administrator → Course Management: manages courses (evidence: `README.md`)
- Course Management → Chapter Management: manages chapters (evidence: `admin/chapters.php`)
- Chapter Management → Question Authoring: authors questions (evidence: `admin/chapters.php`)
- Administrator → Attempt Logs: reviews attempts (evidence: `README.md`)
- Student Runtime → Database Connector: loads connector (evidence: `public/bootstrap.php`)
- Admin Runtime → Database Connector: loads connector (evidence: `admin/bootstrap.php`)
- Database Connector → MySQL Database: opens connection (evidence: `config/db.php`)
- Assessment Runner → MySQL Database: reads questions and writes assessments (evidence: `public/assessment.php`)
- Content Search → MySQL Database: searches chapters and questions (evidence: `public/search.php`)
- Question Authoring → MySQL Database: reads and writes question data (evidence: `admin/question_edit.php`)
- Answer Grading → Assessment Feedback: returns graded feedback
- Answer Grading → Learning Analytics: records performance (evidence: `README.md`)
- Attempt Logs → MySQL Database: reads attempt logs (evidence: `README.md`)
