# pavanch19/smart_exam_coordination_management_system architecture

> Architecture diagram of the GitHub repository pavanch19/smart_exam_coordination_management_system, 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/pavanch19/smart_exam_coordination_management_system
- Repository: https://github.com/pavanch19/smart_exam_coordination_management_system

## Overview

Smart Exam Coordination and Management System is a role-based exam-planning application: administrators configure academic entities and exams, coordinate timetables, rooms, staff duties and seating, then support attendance and admit cards; staff and students use their respective portals for assigned duties and exam information. The React client calls an Express API backed by Sequelize and MySQL. The README documents the server’s route-to-repository layering; sampled controllers confirm service delegation, but most backend module internals and server route wiring were not inspected.

Main entry points: [`server/src/server.js`](https://github.com/pavanch19/smart_exam_coordination_management_system/blob/main/server/src/server.js) (Express API), [`client/src/App.jsx`](https://github.com/pavanch19/smart_exam_coordination_management_system/blob/main/client/src/App.jsx) (Portal routing), [`server/src/modules/exam_mng`](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/exam_mng) (Exams and timetable), [`server/src/modules/allocation_mng`](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/allocation_mng) (Room allocation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Role Portals"]
  node_app["Portal routing<br/>[App.jsx]"]
  node_pages["Portal pages"]
  node_api_client["API clients"]
  node_axios["Axios configuration<br/>[axiosConfig.js]"]
end

subgraph group_coordination["Exam Coordination"]
  node_academic["Academic records"]
  node_students["Student management"]
  node_staff_mgmt["Staff management"]
  node_rooms["Rooms"]
  node_exams["Exams and timetable"]
  node_allocation["Room allocation"]
end

subgraph group_operations["Exam Operations"]
  node_duties["Staff duties"]
  node_seating["Seating"]
  node_attendance["Attendance"]
  node_admit["Admit cards"]
  node_comms["Issues and notifications"]
  node_reporting["Reports and audit"]
  node_dashboard["Dashboard summaries"]
end

subgraph group_backend["API Services"]
  node_identity["Authentication and users"]
  node_api["Express API<br/>[server.js]"]
end

subgraph group_support["Platform Support"]
  node_database[("MySQL database<br/>[database.js]")]
end

node_admin(("Administrator"))
node_staff(("Staff member"))
node_student(("Student"))

node_admin -->|"opens portal"| node_app
node_staff -->|"opens portal"| node_app
node_student -->|"opens portal"| node_app
node_app -->|"routes to"| node_pages
node_pages -.->|"requests data"| node_api_client
node_api_client -->|"uses"| node_axios
node_axios -->|"calls API"| node_api
node_api -->|"persists through ORM"| node_database
node_api -.->|"routes requests"| node_identity
node_api -.->|"routes requests"| node_academic
node_api -.->|"routes requests"| node_students
node_api -.->|"routes requests"| node_staff_mgmt
node_api -.->|"routes requests"| node_rooms
node_api -.->|"routes requests"| node_exams
node_api -.->|"routes requests"| node_allocation
node_api -.->|"routes requests"| node_duties
node_api -.->|"routes requests"| node_seating
node_api -.->|"routes requests"| node_attendance
node_api -.->|"routes requests"| node_admit
node_api -.->|"routes requests"| node_comms
node_api -.->|"routes requests"| node_reporting
node_api -.->|"routes requests"| node_dashboard
node_identity -.->|"reads and writes"| node_database
node_exams -.->|"coordinates"| node_allocation
node_allocation -.->|"informs placement"| node_seating
node_duties -.->|"records duty attendance"| node_attendance
node_exams -.->|"provides exam context"| node_admit

click node_app "https://github.com/pavanch19/smart_exam_coordination_management_system/blob/main/client/src/App.jsx"
click node_pages "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/client/src/pages"
click node_api_client "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/client/src/axiosRoutes"
click node_axios "https://github.com/pavanch19/smart_exam_coordination_management_system/blob/main/client/src/axiosRoutes/axiosConfig.js"
click node_identity "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/auth"
click node_academic "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/dept_mng"
click node_students "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/std_mng"
click node_staff_mgmt "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/staff_mng"
click node_rooms "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/room_mng"
click node_exams "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/exam_mng"
click node_allocation "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/allocation_mng"
click node_duties "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/duty_mng"
click node_seating "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/seating_mng"
click node_attendance "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/attendance_mng"
click node_admit "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/admitcard_mng"
click node_comms "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/issue_mng"
click node_reporting "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/report_mng"
click node_dashboard "https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/dashboard_mng"
click node_api "https://github.com/pavanch19/smart_exam_coordination_management_system/blob/main/server/src/server.js"
click node_database "https://github.com/pavanch19/smart_exam_coordination_management_system/blob/main/server/src/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_pages,node_api_client,node_axios toneBlue
class node_academic,node_students,node_staff_mgmt,node_rooms,node_exams,node_allocation toneAmber
class node_duties,node_seating,node_attendance,node_admit,node_comms,node_reporting,node_dashboard toneMint
class node_identity,node_api toneRose
class node_database,node_admin,node_staff,node_student toneIndigo
```

## Components

### Role Portals

- [Portal routing](https://github.com/pavanch19/smart_exam_coordination_management_system/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Portal pages](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/client/src/pages): `client/src/pages`
- [API clients](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/client/src/axiosRoutes): `client/src/axiosRoutes`
- [Axios configuration](https://github.com/pavanch19/smart_exam_coordination_management_system/blob/main/client/src/axiosRoutes/axiosConfig.js): `client/src/axiosRoutes/axiosConfig.js`

### Exam Coordination

- [Academic records](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/dept_mng): `server/src/modules/dept_mng`
- [Student management](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/std_mng): `server/src/modules/std_mng`
- [Staff management](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/staff_mng): `server/src/modules/staff_mng`
- [Rooms](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/room_mng): `server/src/modules/room_mng`
- [Exams and timetable](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/exam_mng): `server/src/modules/exam_mng`
- [Room allocation](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/allocation_mng): `server/src/modules/allocation_mng`

### Exam Operations

- [Staff duties](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/duty_mng): `server/src/modules/duty_mng`
- [Seating](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/seating_mng): `server/src/modules/seating_mng`
- [Attendance](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/attendance_mng): `server/src/modules/attendance_mng`
- [Admit cards](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/admitcard_mng): `server/src/modules/admitcard_mng`
- [Issues and notifications](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/issue_mng): `server/src/modules/issue_mng`
- [Reports and audit](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/report_mng): `server/src/modules/report_mng`
- [Dashboard summaries](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/dashboard_mng): `server/src/modules/dashboard_mng`

### API Services

- [Authentication and users](https://github.com/pavanch19/smart_exam_coordination_management_system/tree/main/server/src/modules/auth): `server/src/modules/auth`
- [Express API](https://github.com/pavanch19/smart_exam_coordination_management_system/blob/main/server/src/server.js): `server/src/server.js`

### Platform Support

- [MySQL database](https://github.com/pavanch19/smart_exam_coordination_management_system/blob/main/server/src/config/database.js): `server/src/config/database.js`

### Other components

- **Administrator**
- **Staff member**
- **Student**

## Connections

- Administrator → Portal routing: opens portal (evidence: `README.md`)
- Staff member → Portal routing: opens portal (evidence: `README.md`)
- Student → Portal routing: opens portal (evidence: `README.md`)
- Portal routing → Portal pages: routes to (evidence: `client/src/App.jsx`)
- Portal pages → API clients: requests data (evidence: `client/src/pages/AdminAuditLogs.jsx`)
- API clients → Axios configuration: uses (evidence: `client/src/axiosRoutes/admitCardRoutes.js`)
- Axios configuration → Express API: calls API (evidence: `README.md`)
- Express API → MySQL database: persists through ORM (evidence: `README.md`)
- Express API → Authentication and users: routes requests
- Express API → Academic records: routes requests
- Express API → Student management: routes requests
- Express API → Staff management: routes requests
- Express API → Rooms: routes requests
- Express API → Exams and timetable: routes requests
- Express API → Room allocation: routes requests
- Express API → Staff duties: routes requests
- Express API → Seating: routes requests
- Express API → Attendance: routes requests
- Express API → Admit cards: routes requests
- Express API → Issues and notifications: routes requests
- Express API → Reports and audit: routes requests
- Express API → Dashboard summaries: routes requests
- Authentication and users → MySQL database: reads and writes
- Exams and timetable → Room allocation: coordinates
- Room allocation → Seating: informs placement
- Staff duties → Attendance: records duty attendance
- Exams and timetable → Admit cards: provides exam context
