# umartolba/digital-attendance-system architecture

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

- Interactive diagram: https://gitdiagram.com/umartolba/digital-attendance-system
- Repository: https://github.com/umartolba/digital-attendance-system

## Overview

This is a campus attendance and session-management application with a React client and Express/Mongoose backend. Users enter through routed pages for login, session viewing, QR attendance, and administration; the backend exposes user, session, attendance, and session-password API mounts, with sampled controllers accessing MongoDB models. Admin dashboards, reports, and attendance-status controls are represented as distinct client capabilities. The excerpts establish client routing and backend wiring, but do not show client API calls, so no client-to-backend links are asserted.

Main entry points: [`client/src/App.jsx`](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/App.jsx) (Route application), [`backend/server.js`](https://github.com/umartolba/digital-attendance-system/blob/main/backend/server.js) (Express server), [`backend/routes/UserRouter.js`](https://github.com/umartolba/digital-attendance-system/blob/main/backend/routes/UserRouter.js) (User API routes), [`backend/routes/SessionRouter.js`](https://github.com/umartolba/digital-attendance-system/blob/main/backend/routes/SessionRouter.js) (Session API routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Route application<br/>[App.jsx]"]
end

subgraph group_sessions["Sessions and QR"]
  node_session_view["Session viewer<br/>[SessionViewer.jsx]"]
  node_session_create["Create session<br/>[CreateSession.jsx]"]
  node_qr_generate["QR generator<br/>[QrCodeGen.jsx]"]
  node_qr_redirect["QR redirect"]
  node_admin_sessions["Admin sessions<br/>[AdminSessions.jsx]"]
end

subgraph group_attendance["Attendance operations"]
  node_attendance_admin["Attendance admin"]
  node_attendance_mark["Mark attendance"]
  node_attendance_status["Status controls<br/>[AbsentButton.jsx]"]
  node_attendance_reports["Attendance reports<br/>[AdminDashboard.jsx]"]
end

subgraph group_identity["Users and access"]
  node_auth_context["Auth state<br/>[AuthContext.jsx]"]
  node_login_page["Login page<br/>[Login.jsx]"]
  node_admin_guard["Admin route guard<br/>[AdminProtected.jsx]"]
  node_admin_users["Admin users<br/>[AdminUsers.jsx]"]
end

subgraph group_backend["API and persistence"]
  node_server["Express server<br/>[server.js]"]
  node_user_routes["User API routes<br/>[UserRouter.js]"]
  node_session_routes["Session API routes<br/>[SessionRouter.js]"]
  node_attendance_routes["Attendance API routes"]
  node_password_routes["Session password routes"]
  node_user_controller["User operations<br/>[userController.js]"]
  node_session_controller["Session operations"]
  node_attendance_controller["Attendance operations"]
  node_password_controller["Session password operations"]
  node_user_model[("User records<br/>[userModel.js]")]
  node_session_model[("Session records<br/>[sessionModel.js]")]
  node_attendance_model[("Attendance records<br/>[attendanceModel.js]")]
  node_password_model[("Session password records")]
  node_db_connector["Mongo connector"]
end

node_campus_user(("Campus user"))
node_mongo[("MongoDB")]

node_campus_user -->|"opens routes"| node_app
node_app -->|"routes to"| node_session_view
node_app -->|"routes to"| node_session_create
node_app -->|"routes to"| node_qr_generate
node_app -->|"routes to"| node_qr_redirect
node_app -->|"routes to"| node_admin_sessions
node_app -->|"routes to"| node_attendance_admin
node_app -->|"routes to"| node_attendance_mark
node_app -->|"routes to"| node_attendance_status
node_app -->|"routes to"| node_attendance_reports
node_app -->|"routes to"| node_login_page
node_app -->|"guards admin routes"| node_admin_guard
node_app -->|"routes to"| node_admin_users
node_server -->|"connects database"| node_db_connector
node_db_connector -->|"connects"| node_mongo
node_server -->|"mounts API"| node_user_routes
node_server -->|"mounts API"| node_session_routes
node_server -->|"mounts API"| node_attendance_routes
node_server -->|"mounts API"| node_password_routes
node_user_routes -->|"dispatches to"| node_user_controller
node_session_routes -->|"dispatches to"| node_session_controller
node_attendance_routes -->|"dispatches to"| node_attendance_controller
node_password_routes -.->|"dispatches to"| node_password_controller
node_user_controller -->|"queries"| node_user_model
node_session_controller -->|"queries"| node_session_model
node_attendance_controller -->|"queries"| node_attendance_model

click node_app "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/App.jsx"
click node_auth_context "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/AuthContext.jsx"
click node_session_view "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/SessionViewer.jsx"
click node_session_create "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/components/sessions/CreateSession.jsx"
click node_qr_generate "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/components/QrCodeGen.jsx"
click node_qr_redirect "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/QrCodeRedirectionPage.jsx"
click node_admin_sessions "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/AdminSessions.jsx"
click node_attendance_admin "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/AdminAttendance.jsx"
click node_attendance_mark "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/components/SetAttendancePres.jsx"
click node_attendance_status "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/components/AbsentButton.jsx"
click node_attendance_reports "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/AdminDashboard.jsx"
click node_login_page "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/Login.jsx"
click node_admin_guard "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/components/AdminProtected.jsx"
click node_admin_users "https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/AdminUsers.jsx"
click node_server "https://github.com/umartolba/digital-attendance-system/blob/main/backend/server.js"
click node_user_routes "https://github.com/umartolba/digital-attendance-system/blob/main/backend/routes/UserRouter.js"
click node_session_routes "https://github.com/umartolba/digital-attendance-system/blob/main/backend/routes/SessionRouter.js"
click node_attendance_routes "https://github.com/umartolba/digital-attendance-system/blob/main/backend/routes/AttendanceRouter.js"
click node_password_routes "https://github.com/umartolba/digital-attendance-system/blob/main/backend/routes/SessionPasswordRouter.js"
click node_user_controller "https://github.com/umartolba/digital-attendance-system/blob/main/backend/controllers/userController.js"
click node_session_controller "https://github.com/umartolba/digital-attendance-system/blob/main/backend/controllers/sessionController.js"
click node_attendance_controller "https://github.com/umartolba/digital-attendance-system/blob/main/backend/controllers/attendanceController.js"
click node_password_controller "https://github.com/umartolba/digital-attendance-system/blob/main/backend/controllers/sessionPasswordController.js"
click node_user_model "https://github.com/umartolba/digital-attendance-system/blob/main/backend/models/userModel.js"
click node_session_model "https://github.com/umartolba/digital-attendance-system/blob/main/backend/models/sessionModel.js"
click node_attendance_model "https://github.com/umartolba/digital-attendance-system/blob/main/backend/models/attendanceModel.js"
click node_password_model "https://github.com/umartolba/digital-attendance-system/blob/main/backend/models/sessionPasswordModel.js"
click node_db_connector "https://github.com/umartolba/digital-attendance-system/blob/main/backend/config/DatabaseConncection.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_campus_user toneBlue
class node_session_view,node_session_create,node_qr_generate,node_qr_redirect,node_admin_sessions,node_mongo toneAmber
class node_attendance_admin,node_attendance_mark,node_attendance_status,node_attendance_reports toneMint
class node_auth_context,node_login_page,node_admin_guard,node_admin_users toneRose
class node_server,node_user_routes,node_session_routes,node_attendance_routes,node_password_routes,node_user_controller,node_session_controller,node_attendance_controller,node_password_controller,node_user_model,node_session_model,node_attendance_model,node_password_model,node_db_connector toneIndigo
```

## Components

### React client

- [Route application](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/App.jsx): `client/src/App.jsx`

### Sessions and QR

- [Session viewer](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/SessionViewer.jsx): `client/src/assets/pages/SessionViewer.jsx`
- [Create session](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/components/sessions/CreateSession.jsx): `client/src/assets/components/sessions/CreateSession.jsx`
- [QR generator](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/components/QrCodeGen.jsx): `client/src/assets/components/QrCodeGen.jsx`
- [QR redirect](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/QrCodeRedirectionPage.jsx): `client/src/assets/pages/QrCodeRedirectionPage.jsx`
- [Admin sessions](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/AdminSessions.jsx): `client/src/assets/pages/AdminSessions.jsx`

### Attendance operations

- [Attendance admin](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/AdminAttendance.jsx): `client/src/assets/pages/AdminAttendance.jsx`
- [Mark attendance](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/components/SetAttendancePres.jsx): `client/src/assets/components/SetAttendancePres.jsx`
- [Status controls](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/components/AbsentButton.jsx): `client/src/assets/components/AbsentButton.jsx`
- [Attendance reports](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/AdminDashboard.jsx): `client/src/assets/pages/AdminDashboard.jsx`

### Users and access

- [Auth state](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/AuthContext.jsx): `client/src/AuthContext.jsx`
- [Login page](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/Login.jsx): `client/src/assets/pages/Login.jsx`
- [Admin route guard](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/components/AdminProtected.jsx): `client/src/assets/components/AdminProtected.jsx`
- [Admin users](https://github.com/umartolba/digital-attendance-system/blob/main/client/src/assets/pages/AdminUsers.jsx): `client/src/assets/pages/AdminUsers.jsx`

### API and persistence

- [Express server](https://github.com/umartolba/digital-attendance-system/blob/main/backend/server.js): `backend/server.js`
- [User API routes](https://github.com/umartolba/digital-attendance-system/blob/main/backend/routes/UserRouter.js): `backend/routes/UserRouter.js`
- [Session API routes](https://github.com/umartolba/digital-attendance-system/blob/main/backend/routes/SessionRouter.js): `backend/routes/SessionRouter.js`
- [Attendance API routes](https://github.com/umartolba/digital-attendance-system/blob/main/backend/routes/AttendanceRouter.js): `backend/routes/AttendanceRouter.js`
- [Session password routes](https://github.com/umartolba/digital-attendance-system/blob/main/backend/routes/SessionPasswordRouter.js): `backend/routes/SessionPasswordRouter.js`
- [User operations](https://github.com/umartolba/digital-attendance-system/blob/main/backend/controllers/userController.js): `backend/controllers/userController.js`
- [Session operations](https://github.com/umartolba/digital-attendance-system/blob/main/backend/controllers/sessionController.js): `backend/controllers/sessionController.js`
- [Attendance operations](https://github.com/umartolba/digital-attendance-system/blob/main/backend/controllers/attendanceController.js): `backend/controllers/attendanceController.js`
- [Session password operations](https://github.com/umartolba/digital-attendance-system/blob/main/backend/controllers/sessionPasswordController.js): `backend/controllers/sessionPasswordController.js`
- [User records](https://github.com/umartolba/digital-attendance-system/blob/main/backend/models/userModel.js): `backend/models/userModel.js`
- [Session records](https://github.com/umartolba/digital-attendance-system/blob/main/backend/models/sessionModel.js): `backend/models/sessionModel.js`
- [Attendance records](https://github.com/umartolba/digital-attendance-system/blob/main/backend/models/attendanceModel.js): `backend/models/attendanceModel.js`
- [Session password records](https://github.com/umartolba/digital-attendance-system/blob/main/backend/models/sessionPasswordModel.js): `backend/models/sessionPasswordModel.js`
- [Mongo connector](https://github.com/umartolba/digital-attendance-system/blob/main/backend/config/DatabaseConncection.js): `backend/config/DatabaseConncection.js`

### Other components

- **Campus user**
- **MongoDB**

## Connections

- Campus user → Route application: opens routes (evidence: `client/src/App.jsx`)
- Route application → Session viewer: routes to (evidence: `client/src/App.jsx`)
- Route application → Create session: routes to (evidence: `client/src/App.jsx`)
- Route application → QR generator: routes to (evidence: `client/src/App.jsx`)
- Route application → QR redirect: routes to (evidence: `client/src/App.jsx`)
- Route application → Admin sessions: routes to (evidence: `client/src/App.jsx`)
- Route application → Attendance admin: routes to (evidence: `client/src/App.jsx`)
- Route application → Mark attendance: routes to (evidence: `client/src/App.jsx`)
- Route application → Status controls: routes to (evidence: `client/src/App.jsx`)
- Route application → Attendance reports: routes to (evidence: `client/src/App.jsx`)
- Route application → Login page: routes to (evidence: `client/src/App.jsx`)
- Route application → Admin route guard: guards admin routes (evidence: `client/src/App.jsx`)
- Route application → Admin users: routes to (evidence: `client/src/App.jsx`)
- Express server → Mongo connector: connects database (evidence: `backend/server.js`)
- Mongo connector → MongoDB: connects (evidence: `backend/config/DatabaseConncection.js`)
- Express server → User API routes: mounts API (evidence: `backend/server.js`)
- Express server → Session API routes: mounts API (evidence: `backend/server.js`)
- Express server → Attendance API routes: mounts API (evidence: `backend/server.js`)
- Express server → Session password routes: mounts API (evidence: `backend/server.js`)
- User API routes → User operations: dispatches to (evidence: `backend/routes/UserRouter.js`)
- Session API routes → Session operations: dispatches to (evidence: `backend/routes/SessionRouter.js`)
- Attendance API routes → Attendance operations: dispatches to (evidence: `backend/routes/AttendanceRouter.js`)
- Session password routes → Session password operations: dispatches to
- User operations → User records: queries (evidence: `backend/controllers/userController.js`)
- Session operations → Session records: queries (evidence: `backend/controllers/sessionController.js`)
- Attendance operations → Attendance records: queries (evidence: `backend/controllers/attendanceController.js`)
