# krusty86/sora-learning-management-system architecture

> Architecture diagram of the GitHub repository krusty86/sora-learning-management-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/krusty86/sora-learning-management-system
- Repository: https://github.com/krusty86/sora-learning-management-system

## Overview

This JavaFX LMS manages student and instructor records, courses, grades, assignments, and schedules. Users enter through role-specific screens; controllers coordinate the relevant records and DAO operations, while DAOs use a shared JDBC connection to the local MySQL database. The graph highlights documented grade, assignment, and schedule workflows, alongside account/course administration. README capabilities and the source index establish additional screens, but several controller implementations were not sampled, so their links are omitted rather than inferred.

Main entry points: [`src/application/DBConnection.java`](https://github.com/krusty86/sora-learning-management-system/blob/main/src/application/DBConnection.java) (JDBC connection), [`src/application/UserControl.java`](https://github.com/krusty86/sora-learning-management-system/blob/main/src/application/UserControl.java) (Active user state), [`src/models/CourseDAO.java`](https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/CourseDAO.java) (Course records), [`src/controllers/GradeController.java`](https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/GradeController.java) (Grade workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interfaces"]
  node_login["Login"]
end

subgraph group_school["School administration"]
  node_admin_accounts["Account management"]
  node_admin_courses["Course management"]
  node_admin_schedule["Schedule management"]
  node_admin_grades["Grade administration"]
end

subgraph group_learning["Learning workflows"]
  node_assignments["Assignments"]
  node_student_assignments["Student assignments"]
  node_grades["Grade workflows"]
  node_student_grades["Student grades"]
  node_schedules["Instructor schedule"]
  node_student_schedule["Student schedule"]
end

subgraph group_data["Records and persistence"]
  node_session["Active user state<br/>[UserControl.java]"]
  node_course_records["Course records<br/>[CourseDAO.java]"]
  node_assignment_records["Assignment records<br/>[AssignmentDAO.java]"]
  node_grade_records["Grade records<br/>[GradeDAO.java]"]
  node_exam_records["Exam records<br/>[ExamDAO.java]"]
  node_schedule_records["Slot records<br/>[SlotDAO.java]"]
  node_enrollment_records["Enrollment records<br/>[EnrollmentDAO.java]"]
  node_db_connection["JDBC connection<br/>[DBConnection.java]"]
  node_admin_records["Admin records<br/>[AdminDAO.java]"]
  node_instructor_records["Instructor records<br/>[InstructorDAO.java]"]
  node_student_records["Student records<br/>[StudentDAO.java]"]
end

node_admin(("Administrator"))
node_instructor(("Instructor"))
node_student(("Student"))
node_mysql[("MySQL database")]

node_admin -.->|"signs in"| node_login
node_instructor -.->|"signs in"| node_login
node_student -.->|"signs in"| node_login
node_admin_accounts -->|"manages"| node_admin_records
node_admin_accounts -->|"manages"| node_instructor_records
node_admin_accounts -->|"manages"| node_student_records
node_admin_courses -->|"manages"| node_course_records
node_admin_grades -->|"loads grades"| node_grade_records
node_admin_grades -->|"manages exams"| node_exam_records
node_assignments -->|"reads user"| node_session
node_assignments -->|"loads courses"| node_course_records
node_assignments -->|"manages"| node_assignment_records
node_student_assignments -->|"reads user"| node_session
node_student_assignments -->|"loads assignments"| node_assignment_records
node_grades -->|"reads user"| node_session
node_grades -->|"loads courses"| node_course_records
node_grades -->|"loads exams"| node_exam_records
node_grades -->|"manages grades"| node_grade_records
node_student_grades -->|"reads user"| node_session
node_student_grades -->|"loads grades"| node_grade_records
node_schedules -->|"reads user"| node_session
node_schedules -->|"loads courses"| node_course_records
node_schedules -->|"loads slots"| node_schedule_records
node_student_schedule -->|"reads user"| node_session
node_student_schedule -->|"loads enrollment"| node_enrollment_records
node_student_schedule -->|"loads slots"| node_schedule_records
node_assignment_records -->|"opens connection"| node_db_connection
node_course_records -->|"opens connection"| node_db_connection
node_grade_records -->|"opens connection"| node_db_connection
node_exam_records -->|"opens connection"| node_db_connection
node_schedule_records -->|"opens connection"| node_db_connection
node_enrollment_records -->|"opens connection"| node_db_connection
node_db_connection -->|"connects to"| node_mysql

click node_login "https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/LoginFormController.java"
click node_admin_accounts "https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/AdminAccountController.java"
click node_admin_courses "https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/AdminCourseController.java"
click node_admin_schedule "https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/AdminScheduleController.java"
click node_admin_grades "https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/AdminGradeController.java"
click node_assignments "https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/AssignmentController.java"
click node_student_assignments "https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/StudentAssignmentController.java"
click node_grades "https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/GradeController.java"
click node_student_grades "https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/StudentGradeController.java"
click node_schedules "https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/ScheduleController.java"
click node_student_schedule "https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/StudentScheduleController.java"
click node_session "https://github.com/krusty86/sora-learning-management-system/blob/main/src/application/UserControl.java"
click node_course_records "https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/CourseDAO.java"
click node_assignment_records "https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/AssignmentDAO.java"
click node_grade_records "https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/GradeDAO.java"
click node_exam_records "https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/ExamDAO.java"
click node_schedule_records "https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/SlotDAO.java"
click node_enrollment_records "https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/EnrollmentDAO.java"
click node_db_connection "https://github.com/krusty86/sora-learning-management-system/blob/main/src/application/DBConnection.java"
click node_admin_records "https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/AdminDAO.java"
click node_instructor_records "https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/InstructorDAO.java"
click node_student_records "https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/StudentDAO.java"

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_login toneBlue
class node_admin_accounts,node_admin_courses,node_admin_schedule,node_admin_grades,node_mysql toneAmber
class node_assignments,node_student_assignments,node_grades,node_student_grades,node_schedules,node_student_schedule toneMint
class node_session,node_course_records,node_assignment_records,node_grade_records,node_exam_records,node_schedule_records,node_enrollment_records,node_db_connection,node_admin_records,node_instructor_records,node_student_records toneRose
class node_admin,node_instructor,node_student toneIndigo
```

## Components

### User interfaces

- [Login](https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/LoginFormController.java): `src/controllers/LoginFormController.java`

### School administration

- [Account management](https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/AdminAccountController.java): `src/controllers/AdminAccountController.java`
- [Course management](https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/AdminCourseController.java): `src/controllers/AdminCourseController.java`
- [Schedule management](https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/AdminScheduleController.java): `src/controllers/AdminScheduleController.java`
- [Grade administration](https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/AdminGradeController.java): `src/controllers/AdminGradeController.java`

### Learning workflows

- [Assignments](https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/AssignmentController.java): `src/controllers/AssignmentController.java`
- [Student assignments](https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/StudentAssignmentController.java): `src/controllers/StudentAssignmentController.java`
- [Grade workflows](https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/GradeController.java): `src/controllers/GradeController.java`
- [Student grades](https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/StudentGradeController.java): `src/controllers/StudentGradeController.java`
- [Instructor schedule](https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/ScheduleController.java): `src/controllers/ScheduleController.java`
- [Student schedule](https://github.com/krusty86/sora-learning-management-system/blob/main/src/controllers/StudentScheduleController.java): `src/controllers/StudentScheduleController.java`

### Records and persistence

- [Active user state](https://github.com/krusty86/sora-learning-management-system/blob/main/src/application/UserControl.java): `src/application/UserControl.java`
- [Course records](https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/CourseDAO.java): `src/models/CourseDAO.java`
- [Assignment records](https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/AssignmentDAO.java): `src/models/AssignmentDAO.java`
- [Grade records](https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/GradeDAO.java): `src/models/GradeDAO.java`
- [Exam records](https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/ExamDAO.java): `src/models/ExamDAO.java`
- [Slot records](https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/SlotDAO.java): `src/models/SlotDAO.java`
- [Enrollment records](https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/EnrollmentDAO.java): `src/models/EnrollmentDAO.java`
- [JDBC connection](https://github.com/krusty86/sora-learning-management-system/blob/main/src/application/DBConnection.java): `src/application/DBConnection.java`
- [Admin records](https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/AdminDAO.java): `src/models/AdminDAO.java`
- [Instructor records](https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/InstructorDAO.java): `src/models/InstructorDAO.java`
- [Student records](https://github.com/krusty86/sora-learning-management-system/blob/main/src/models/StudentDAO.java): `src/models/StudentDAO.java`

### Other components

- **Administrator**
- **Instructor**
- **Student**
- **MySQL database**

## Connections

- Administrator → Login: signs in
- Instructor → Login: signs in
- Student → Login: signs in
- Account management → Admin records: manages (evidence: `src/controllers/AdminAccountController.java`)
- Account management → Instructor records: manages (evidence: `src/controllers/AdminAccountController.java`)
- Account management → Student records: manages (evidence: `src/controllers/AdminAccountController.java`)
- Course management → Course records: manages (evidence: `src/controllers/AdminCourseController.java`)
- Grade administration → Grade records: loads grades (evidence: `src/controllers/AdminGradeController.java`)
- Grade administration → Exam records: manages exams (evidence: `src/controllers/AdminGradeController.java`)
- Assignments → Active user state: reads user (evidence: `src/controllers/AssignmentController.java`)
- Assignments → Course records: loads courses (evidence: `src/controllers/AssignmentController.java`)
- Assignments → Assignment records: manages (evidence: `src/controllers/AssignmentController.java`)
- Student assignments → Active user state: reads user (evidence: `src/controllers/StudentAssignmentController.java`)
- Student assignments → Assignment records: loads assignments (evidence: `src/controllers/StudentAssignmentController.java`)
- Grade workflows → Active user state: reads user (evidence: `src/controllers/GradeController.java`)
- Grade workflows → Course records: loads courses (evidence: `src/controllers/GradeController.java`)
- Grade workflows → Exam records: loads exams (evidence: `src/controllers/GradeController.java`)
- Grade workflows → Grade records: manages grades (evidence: `src/controllers/GradeController.java`)
- Student grades → Active user state: reads user (evidence: `src/controllers/StudentGradeController.java`)
- Student grades → Grade records: loads grades (evidence: `src/controllers/StudentGradeController.java`)
- Instructor schedule → Active user state: reads user (evidence: `src/controllers/ScheduleController.java`)
- Instructor schedule → Course records: loads courses (evidence: `src/controllers/ScheduleController.java`)
- Instructor schedule → Slot records: loads slots (evidence: `src/controllers/ScheduleController.java`)
- Student schedule → Active user state: reads user (evidence: `src/controllers/StudentScheduleController.java`)
- Student schedule → Enrollment records: loads enrollment (evidence: `src/controllers/StudentScheduleController.java`)
- Student schedule → Slot records: loads slots (evidence: `src/controllers/StudentScheduleController.java`)
- Assignment records → JDBC connection: opens connection (evidence: `src/models/AssignmentDAO.java`)
- Course records → JDBC connection: opens connection (evidence: `src/models/CourseDAO.java`)
- Grade records → JDBC connection: opens connection (evidence: `src/models/GradeDAO.java`)
- Exam records → JDBC connection: opens connection (evidence: `src/models/ExamDAO.java`)
- Slot records → JDBC connection: opens connection (evidence: `src/models/SlotDAO.java`)
- Enrollment records → JDBC connection: opens connection (evidence: `src/models/EnrollmentDAO.java`)
- JDBC connection → MySQL database: connects to (evidence: `src/application/DBConnection.java`)
