# it26100988/student-course-registration-system architecture

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

- Interactive diagram: https://gitdiagram.com/it26100988/student-course-registration-system
- Repository: https://github.com/it26100988/student-course-registration-system

## Overview

This is a student course-registration application with account management, course scheduling and prerequisites, registration requests and enrollment, and payments. The visible user workflow is browser pages making authenticated API requests: students can register or sign in, submit course requests, and view registrations, enrollments, prerequisites, and timetables; administrators can manage students, review the request queue, and manage scheduling. The tree shows service, controller, and text-file repository layers. Backend relationships are omitted because their source was not sampled; payment behavior is represented by the tree only.

Main entry points: [`src/main/resources/static/js/accounts.js`](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/resources/static/js/accounts.js) (Account screens), [`src/main/resources/static/js/registration.js`](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/resources/static/js/registration.js) (Registration screens), [`src/main/resources/static/js/admin.js`](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/resources/static/js/admin.js) (Admin screens), [`src/main/resources/static/js/scheduling.js`](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/resources/static/js/scheduling.js) (Scheduling screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Browser interface"]
  node_accounts_ui["Account screens<br/>[accounts.js]"]
  node_registration_ui["Registration screens<br/>[registration.js]"]
  node_admin_ui["Admin screens<br/>[admin.js]"]
  node_scheduling_ui["Scheduling screens<br/>[scheduling.js]"]
end

subgraph group_identity["Accounts"]
  node_auth["Authentication"]
  node_student_accounts["Student accounts"]
  node_account_access["Account controllers"]
end

subgraph group_academics["Courses and scheduling"]
  node_course_catalog["Course catalog"]
  node_course_access["Course controller"]
  node_timetable["Timetable service"]
  node_prerequisites["Prerequisite rules"]
  node_scheduling_access["Scheduling controllers"]
end

subgraph group_enrollment["Registration and payments"]
  node_requests["Registration requests"]
  node_enrollment_lifecycle["Enrollment lifecycle"]
  node_request_queue["Request queue"]
  node_registration_access["Registration controllers"]
  node_payments["Payment services"]
end

subgraph group_storage["File storage"]
  node_txt_store[("Text file store<br/>[TxtFileStore.java]")]
  node_txt_codec["Text codec<br/>[TxtCodec.java]"]
  node_storage_locks["Storage locks"]
end

node_api{{"Application API"}}

node_accounts_ui -->|"sends requests"| node_api
node_registration_ui -->|"sends requests"| node_api
node_admin_ui -->|"sends requests"| node_api
node_scheduling_ui -->|"sends requests"| node_api

click node_accounts_ui "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/resources/static/js/accounts.js"
click node_registration_ui "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/resources/static/js/registration.js"
click node_admin_ui "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/resources/static/js/admin.js"
click node_scheduling_ui "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/resources/static/js/scheduling.js"
click node_auth "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/accounts/service/AuthenticationService.java"
click node_student_accounts "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/accounts/service/StudentService.java"
click node_account_access "https://github.com/it26100988/student-course-registration-system/tree/main/src/main/java/com/example/studentregistration/accounts/controller"
click node_course_catalog "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/Course/service/CourseCatalogService.java"
click node_course_access "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/Course/controller/CourseController.java"
click node_timetable "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/scheduling/service/TimetableService.java"
click node_prerequisites "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/scheduling/service/PrerequisiteService.java"
click node_scheduling_access "https://github.com/it26100988/student-course-registration-system/tree/main/src/main/java/com/example/studentregistration/scheduling/controller"
click node_requests "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/registration/service/RegistrationRequestService.java"
click node_enrollment_lifecycle "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/registration/service/EnrollmentLifecycleService.java"
click node_request_queue "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/registration/datastructure/RegistrationQueue.java"
click node_registration_access "https://github.com/it26100988/student-course-registration-system/tree/main/src/main/java/com/example/studentregistration/registration/controller"
click node_payments "https://github.com/it26100988/student-course-registration-system/tree/main/src/main/java/com/example/studentregistration/payments/service"
click node_txt_store "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/shared/filehandling/TxtFileStore.java"
click node_txt_codec "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/shared/filehandling/TxtCodec.java"
click node_storage_locks "https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/shared/filehandling/StorageLockManager.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_accounts_ui,node_registration_ui,node_admin_ui,node_scheduling_ui toneBlue
class node_auth,node_student_accounts,node_account_access toneAmber
class node_course_catalog,node_course_access,node_timetable,node_prerequisites,node_scheduling_access,node_api toneMint
class node_requests,node_enrollment_lifecycle,node_request_queue,node_registration_access,node_payments toneRose
class node_txt_store,node_txt_codec,node_storage_locks toneIndigo
```

## Components

### Browser interface

- [Account screens](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/resources/static/js/accounts.js): `src/main/resources/static/js/accounts.js`
- [Registration screens](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/resources/static/js/registration.js): `src/main/resources/static/js/registration.js`
- [Admin screens](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/resources/static/js/admin.js): `src/main/resources/static/js/admin.js`
- [Scheduling screens](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/resources/static/js/scheduling.js): `src/main/resources/static/js/scheduling.js`

### Accounts

- [Authentication](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/accounts/service/AuthenticationService.java): `src/main/java/com/example/studentregistration/accounts/service/AuthenticationService.java`
- [Student accounts](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/accounts/service/StudentService.java): `src/main/java/com/example/studentregistration/accounts/service/StudentService.java`
- [Account controllers](https://github.com/it26100988/student-course-registration-system/tree/main/src/main/java/com/example/studentregistration/accounts/controller): `src/main/java/com/example/studentregistration/accounts/controller`

### Courses and scheduling

- [Course catalog](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/Course/service/CourseCatalogService.java): `src/main/java/com/example/studentregistration/Course/service/CourseCatalogService.java`
- [Course controller](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/Course/controller/CourseController.java): `src/main/java/com/example/studentregistration/Course/controller/CourseController.java`
- [Timetable service](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/scheduling/service/TimetableService.java): `src/main/java/com/example/studentregistration/scheduling/service/TimetableService.java`
- [Prerequisite rules](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/scheduling/service/PrerequisiteService.java): `src/main/java/com/example/studentregistration/scheduling/service/PrerequisiteService.java`
- [Scheduling controllers](https://github.com/it26100988/student-course-registration-system/tree/main/src/main/java/com/example/studentregistration/scheduling/controller): `src/main/java/com/example/studentregistration/scheduling/controller`

### Registration and payments

- [Registration requests](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/registration/service/RegistrationRequestService.java): `src/main/java/com/example/studentregistration/registration/service/RegistrationRequestService.java`
- [Enrollment lifecycle](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/registration/service/EnrollmentLifecycleService.java): `src/main/java/com/example/studentregistration/registration/service/EnrollmentLifecycleService.java`
- [Request queue](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/registration/datastructure/RegistrationQueue.java): `src/main/java/com/example/studentregistration/registration/datastructure/RegistrationQueue.java`
- [Registration controllers](https://github.com/it26100988/student-course-registration-system/tree/main/src/main/java/com/example/studentregistration/registration/controller): `src/main/java/com/example/studentregistration/registration/controller`
- [Payment services](https://github.com/it26100988/student-course-registration-system/tree/main/src/main/java/com/example/studentregistration/payments/service): `src/main/java/com/example/studentregistration/payments/service`

### File storage

- [Text file store](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/shared/filehandling/TxtFileStore.java): `src/main/java/com/example/studentregistration/shared/filehandling/TxtFileStore.java`
- [Text codec](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/shared/filehandling/TxtCodec.java): `src/main/java/com/example/studentregistration/shared/filehandling/TxtCodec.java`
- [Storage locks](https://github.com/it26100988/student-course-registration-system/blob/main/src/main/java/com/example/studentregistration/shared/filehandling/StorageLockManager.java): `src/main/java/com/example/studentregistration/shared/filehandling/StorageLockManager.java`

### Other components

- **Application API**

## Connections

- Account screens → Application API: sends requests (evidence: `src/main/resources/static/js/accounts.js`)
- Registration screens → Application API: sends requests (evidence: `src/main/resources/static/js/registration.js`)
- Admin screens → Application API: sends requests (evidence: `src/main/resources/static/js/admin.js`)
- Scheduling screens → Application API: sends requests (evidence: `src/main/resources/static/js/scheduling.js`)
