# hsnkh12/secure-attendance-management-system architecture

> Architecture diagram of the GitHub repository hsnkh12/secure-attendance-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hsnkh12/secure-attendance-management-system
- Repository: https://github.com/hsnkh12/secure-attendance-management-system

## Overview

##### Project type and purpose
- This is a monolithic Node.js/Express REST API called “Attendance Management System” (AMS).
- It exposes endpoints for recording and querying student attendance, uses DES encryption for secure data at rest, and persists data in a relational database.

##### File structure
- Top-level entry: app.js (bootstraps Express, loads middleware, routes).
- routes/ → defines Express router endpoints for each entity (students, teachers, attendance, etc.).
- controllers/ → handler functions invoked by routes; they parse request data and delegate to managers.
- managers/ → core business-logic layer (“service layer”) that coordinates workflows (e.g., encrypting/decrypting attendance, verifying prerequisites).
- models/ → ORM definitions mapping JS objects to DB tables (Attendance, Student, Course, etc.).
- middlewares/auth.js → JWT/session authentication, protects secured endpoints.
- utils/
- db.config.js → database connection/ORM configuration
- des.js → DES encryption/decryption service
- password.js → password hashing/validation utilities

##### README for additional insights
- Confirms DES encryption is applied transparently on create/read operations.
- No UI code present—this is purely an API backend targeting clients such as web UIs or scripts.

## Diagram (Mermaid)

```mermaid
graph TB
    Client["Client (HTTP)"]
    subgraph "API Layer"
        API["API Gateway (app.js)"]
        Auth["Auth Middleware"]
        Routing["Routing Layer"]
    end
    subgraph "Controller Layer"
        Controller["Controller Layer"]
    end
    subgraph "Service/Manager Layer"
        Manager["Service/Manager Layer"]
        DES["Encryption Service (DES)"]
        PassUtil["Password Utils"]
    end
    subgraph "Data Access Layer"
        Models["ORM Models"]
        DBConfig["DB Config"]
    end
    DB[(Database)]

    Client --> API
    API --> Auth
    Auth --> Routing
    Routing --> Controller
    Controller --> Manager
    Manager --> Models
    Models --> DB
    Manager --> DES
    Manager --> PassUtil
    Models --> DBConfig

    click API "https://github.com/hsnkh12/secure-attendance-management-system/blob/main/app.js"
    click Auth "https://github.com/hsnkh12/secure-attendance-management-system/blob/main/middlewares/auth.js"
    click Routing "https://github.com/hsnkh12/secure-attendance-management-system/tree/main/routes/"
    click Controller "https://github.com/hsnkh12/secure-attendance-management-system/tree/main/controllers/"
    click Manager "https://github.com/hsnkh12/secure-attendance-management-system/tree/main/managers/"
    click DES "https://github.com/hsnkh12/secure-attendance-management-system/blob/main/utils/des.js"
    click PassUtil "https://github.com/hsnkh12/secure-attendance-management-system/blob/main/utils/password.js"
    click Models "https://github.com/hsnkh12/secure-attendance-management-system/tree/main/models/"
    click DBConfig "https://github.com/hsnkh12/secure-attendance-management-system/blob/main/utils/db.config.js"

    classDef api fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef controller fill:#E6FFE6,stroke:#28A745,color:#28A745
    classDef service fill:#FFF4E6,stroke:#E69500,color:#E69500
    classDef data fill:#F3E6FF,stroke:#6F42C1,color:#6F42C1
    classDef util fill:#FFF8CC,stroke:#E6C200,color:#E6C200
    classDef db fill:#EDEDED,stroke:#6C757D,color:#6C757D

    class API,Auth,Routing api
    class Controller controller
    class Manager service
    class DES,PassUtil,DBConfig util
    class Models data
    class DB db
```
