# msmicha200/diploma architecture

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

- Interactive diagram: https://gitdiagram.com/msmicha200/diploma
- Repository: https://github.com/msmicha200/diploma

## Overview

This is a web-based academic administration and gradebook application, with role-specific workflows for administrators, operators, teachers, students, and general user access. The visible workflow is HTTP routing into role controllers, which validate/session-check requests and coordinate academic models; those models query the shared MySQL connection. Teacher and student grade viewing and operator management are visible in sampled code. Other role capabilities are represented by their indexed modules, but unsampled behavior and browser-to-server links are not inferred.

Main entry points: [`controllers/teacherController.js`](https://github.com/msmicha200/diploma/blob/master/controllers/teacherController.js) (Teacher gradebook), [`controllers/adminController.js`](https://github.com/msmicha200/diploma/blob/master/controllers/adminController.js) (Admin gradebook), [`controllers/studentController.js`](https://github.com/msmicha200/diploma/blob/master/controllers/studentController.js) (Student gradebook), [`index.js`](https://github.com/msmicha200/diploma/blob/master/index.js) (Application entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_server["Application entry<br/>[index.js]"]
  node_user_routes["User routes<br/>[userRouter.js]"]
  node_admin_routes["Admin routes<br/>[adminRouter.js]"]
  node_operator_routes["Operator routes<br/>[operatorRouter.js]"]
  node_teacher_routes["Teacher routes<br/>[teacherRouter.js]"]
  node_student_routes["Student routes<br/>[studentRouter.js]"]
end

subgraph group_roles["Role workflows"]
  node_user_controller["Account access<br/>[userController.js]"]
  node_admin_controller["Admin gradebook<br/>[adminController.js]"]
  node_operator_controller["Academic setup"]
  node_teacher_controller["Teacher gradebook"]
  node_student_controller["Student gradebook"]
end

subgraph group_domain["Academic data"]
  node_user_model["Accounts<br/>[User.js]"]
  node_group_model["Groups<br/>[Group.js]"]
  node_discipline_model["Disciplines<br/>[Discipline.js]"]
  node_program_model["Working programs<br/>[Program.js]"]
  node_grade_model["Grades and reports<br/>[Grade.js]"]
  node_lesson_model["Lessons<br/>[Lesson.js]"]
  node_notification_model["Notifications<br/>[Notification.js]"]
end

subgraph group_infra["Shared services"]
  node_database[("MySQL connection<br/>[Database.js]")]
  node_tools["Input validation<br/>[Tools.js]"]
  node_mail["Mail service<br/>[Mail.js]"]
end

node_actor(("Web user"))

node_actor -->|"uses"| node_server
node_server -->|"mounts routes"| node_user_routes
node_server -->|"mounts routes"| node_admin_routes
node_server -->|"mounts routes"| node_operator_routes
node_server -->|"mounts routes"| node_teacher_routes
node_server -->|"mounts routes"| node_student_routes
node_user_routes -->|"dispatches"| node_user_controller
node_admin_routes -->|"dispatches"| node_admin_controller
node_operator_routes -->|"dispatches"| node_operator_controller
node_teacher_routes -->|"dispatches"| node_teacher_controller
node_student_routes -->|"dispatches"| node_student_controller
node_user_controller -->|"uses accounts"| node_user_model
node_admin_controller -->|"checks status"| node_user_model
node_admin_controller -->|"loads groups"| node_group_model
node_admin_controller -->|"loads disciplines"| node_discipline_model
node_admin_controller -->|"loads grades"| node_grade_model
node_admin_controller -->|"loads lessons"| node_lesson_model
node_admin_controller -->|"sends notices"| node_notification_model
node_operator_controller -->|"manages users"| node_user_model
node_operator_controller -->|"manages groups"| node_group_model
node_operator_controller -->|"manages themes"| node_program_model
node_operator_controller -->|"manages disciplines"| node_discipline_model
node_operator_controller -->|"validates input"| node_tools
node_teacher_controller -->|"checks status"| node_user_model
node_teacher_controller -->|"loads groups"| node_group_model
node_teacher_controller -->|"uses programs"| node_program_model
node_teacher_controller -->|"loads disciplines"| node_discipline_model
node_teacher_controller -->|"reads and sets grades"| node_grade_model
node_teacher_controller -->|"adds and reads lessons"| node_lesson_model
node_teacher_controller -->|"loads notices"| node_notification_model
node_student_controller -->|"checks status"| node_user_model
node_student_controller -->|"uses groups"| node_group_model
node_student_controller -->|"uses programs"| node_program_model
node_student_controller -->|"loads disciplines"| node_discipline_model
node_student_controller -->|"loads grades"| node_grade_model
node_student_controller -->|"loads lessons"| node_lesson_model
node_user_model -->|"queries"| node_database
node_group_model -->|"queries"| node_database
node_discipline_model -->|"queries"| node_database
node_program_model -->|"queries"| node_database
node_grade_model -->|"queries"| node_database
node_lesson_model -->|"queries"| node_database
node_notification_model -->|"queries"| node_database

click node_server "https://github.com/msmicha200/diploma/blob/master/index.js"
click node_user_routes "https://github.com/msmicha200/diploma/blob/master/routes/userRouter.js"
click node_admin_routes "https://github.com/msmicha200/diploma/blob/master/routes/adminRouter.js"
click node_operator_routes "https://github.com/msmicha200/diploma/blob/master/routes/operatorRouter.js"
click node_teacher_routes "https://github.com/msmicha200/diploma/blob/master/routes/teacherRouter.js"
click node_student_routes "https://github.com/msmicha200/diploma/blob/master/routes/studentRouter.js"
click node_user_controller "https://github.com/msmicha200/diploma/blob/master/controllers/userController.js"
click node_admin_controller "https://github.com/msmicha200/diploma/blob/master/controllers/adminController.js"
click node_operator_controller "https://github.com/msmicha200/diploma/blob/master/controllers/operatorController.js"
click node_teacher_controller "https://github.com/msmicha200/diploma/blob/master/controllers/teacherController.js"
click node_student_controller "https://github.com/msmicha200/diploma/blob/master/controllers/studentController.js"
click node_user_model "https://github.com/msmicha200/diploma/blob/master/models/User.js"
click node_group_model "https://github.com/msmicha200/diploma/blob/master/models/Group.js"
click node_discipline_model "https://github.com/msmicha200/diploma/blob/master/models/Discipline.js"
click node_program_model "https://github.com/msmicha200/diploma/blob/master/models/Program.js"
click node_grade_model "https://github.com/msmicha200/diploma/blob/master/models/Grade.js"
click node_lesson_model "https://github.com/msmicha200/diploma/blob/master/models/Lesson.js"
click node_notification_model "https://github.com/msmicha200/diploma/blob/master/models/Notification.js"
click node_database "https://github.com/msmicha200/diploma/blob/master/components/Database.js"
click node_tools "https://github.com/msmicha200/diploma/blob/master/components/Tools.js"
click node_mail "https://github.com/msmicha200/diploma/blob/master/components/Mail.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_server,node_user_routes,node_admin_routes,node_operator_routes,node_teacher_routes,node_student_routes,node_actor toneBlue
class node_user_controller,node_admin_controller,node_operator_controller,node_teacher_controller,node_student_controller toneAmber
class node_user_model,node_group_model,node_discipline_model,node_program_model,node_grade_model,node_lesson_model,node_notification_model toneMint
class node_database,node_tools,node_mail toneRose
```

## Components

### Web entry

- [Application entry](https://github.com/msmicha200/diploma/blob/master/index.js): `index.js`
- [User routes](https://github.com/msmicha200/diploma/blob/master/routes/userRouter.js): `routes/userRouter.js`
- [Admin routes](https://github.com/msmicha200/diploma/blob/master/routes/adminRouter.js): `routes/adminRouter.js`
- [Operator routes](https://github.com/msmicha200/diploma/blob/master/routes/operatorRouter.js): `routes/operatorRouter.js`
- [Teacher routes](https://github.com/msmicha200/diploma/blob/master/routes/teacherRouter.js): `routes/teacherRouter.js`
- [Student routes](https://github.com/msmicha200/diploma/blob/master/routes/studentRouter.js): `routes/studentRouter.js`

### Role workflows

- [Account access](https://github.com/msmicha200/diploma/blob/master/controllers/userController.js): `controllers/userController.js`
- [Admin gradebook](https://github.com/msmicha200/diploma/blob/master/controllers/adminController.js): `controllers/adminController.js`
- [Academic setup](https://github.com/msmicha200/diploma/blob/master/controllers/operatorController.js): `controllers/operatorController.js`
- [Teacher gradebook](https://github.com/msmicha200/diploma/blob/master/controllers/teacherController.js): `controllers/teacherController.js`
- [Student gradebook](https://github.com/msmicha200/diploma/blob/master/controllers/studentController.js): `controllers/studentController.js`

### Academic data

- [Accounts](https://github.com/msmicha200/diploma/blob/master/models/User.js): `models/User.js`
- [Groups](https://github.com/msmicha200/diploma/blob/master/models/Group.js): `models/Group.js`
- [Disciplines](https://github.com/msmicha200/diploma/blob/master/models/Discipline.js): `models/Discipline.js`
- [Working programs](https://github.com/msmicha200/diploma/blob/master/models/Program.js): `models/Program.js`
- [Grades and reports](https://github.com/msmicha200/diploma/blob/master/models/Grade.js): `models/Grade.js`
- [Lessons](https://github.com/msmicha200/diploma/blob/master/models/Lesson.js): `models/Lesson.js`
- [Notifications](https://github.com/msmicha200/diploma/blob/master/models/Notification.js): `models/Notification.js`

### Shared services

- [MySQL connection](https://github.com/msmicha200/diploma/blob/master/components/Database.js): `components/Database.js`
- [Input validation](https://github.com/msmicha200/diploma/blob/master/components/Tools.js): `components/Tools.js`
- [Mail service](https://github.com/msmicha200/diploma/blob/master/components/Mail.js): `components/Mail.js`

### Other components

- **Web user**

## Connections

- Web user → Application entry: uses
- Application entry → User routes: mounts routes (evidence: `index.js`)
- Application entry → Admin routes: mounts routes (evidence: `index.js`)
- Application entry → Operator routes: mounts routes (evidence: `index.js`)
- Application entry → Teacher routes: mounts routes (evidence: `index.js`)
- Application entry → Student routes: mounts routes (evidence: `index.js`)
- User routes → Account access: dispatches (evidence: `routes/userRouter.js`)
- Admin routes → Admin gradebook: dispatches (evidence: `routes/adminRouter.js`)
- Operator routes → Academic setup: dispatches (evidence: `routes/operatorRouter.js`)
- Teacher routes → Teacher gradebook: dispatches (evidence: `routes/teacherRouter.js`)
- Student routes → Student gradebook: dispatches (evidence: `routes/studentRouter.js`)
- Account access → Accounts: uses accounts (evidence: `controllers/userController.js`)
- Admin gradebook → Accounts: checks status (evidence: `controllers/adminController.js`)
- Admin gradebook → Groups: loads groups (evidence: `controllers/adminController.js`)
- Admin gradebook → Disciplines: loads disciplines (evidence: `controllers/adminController.js`)
- Admin gradebook → Grades and reports: loads grades (evidence: `controllers/adminController.js`)
- Admin gradebook → Lessons: loads lessons (evidence: `controllers/adminController.js`)
- Admin gradebook → Notifications: sends notices (evidence: `controllers/adminController.js`)
- Academic setup → Accounts: manages users (evidence: `controllers/operatorController.js`)
- Academic setup → Groups: manages groups (evidence: `controllers/operatorController.js`)
- Academic setup → Working programs: manages themes (evidence: `controllers/operatorController.js`)
- Academic setup → Disciplines: manages disciplines (evidence: `controllers/operatorController.js`)
- Academic setup → Input validation: validates input (evidence: `controllers/operatorController.js`)
- Teacher gradebook → Accounts: checks status (evidence: `controllers/teacherController.js`)
- Teacher gradebook → Groups: loads groups (evidence: `controllers/teacherController.js`)
- Teacher gradebook → Working programs: uses programs (evidence: `controllers/teacherController.js`)
- Teacher gradebook → Disciplines: loads disciplines (evidence: `controllers/teacherController.js`)
- Teacher gradebook → Grades and reports: reads and sets grades (evidence: `controllers/teacherController.js`)
- Teacher gradebook → Lessons: adds and reads lessons (evidence: `controllers/teacherController.js`)
- Teacher gradebook → Notifications: loads notices (evidence: `controllers/teacherController.js`)
- Student gradebook → Accounts: checks status (evidence: `controllers/studentController.js`)
- Student gradebook → Groups: uses groups (evidence: `controllers/studentController.js`)
- Student gradebook → Working programs: uses programs (evidence: `controllers/studentController.js`)
- Student gradebook → Disciplines: loads disciplines (evidence: `controllers/studentController.js`)
- Student gradebook → Grades and reports: loads grades (evidence: `controllers/studentController.js`)
- Student gradebook → Lessons: loads lessons (evidence: `controllers/studentController.js`)
- Accounts → MySQL connection: queries (evidence: `models/User.js`)
- Groups → MySQL connection: queries (evidence: `models/Group.js`)
- Disciplines → MySQL connection: queries (evidence: `models/Discipline.js`)
- Working programs → MySQL connection: queries (evidence: `models/Program.js`)
- Grades and reports → MySQL connection: queries (evidence: `models/Grade.js`)
- Lessons → MySQL connection: queries (evidence: `models/Lesson.js`)
- Notifications → MySQL connection: queries (evidence: `models/Notification.js`)
