# manishkandari9/manualattendancetrack-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/manishkandari9/manualattendancetrack-management-system
- Repository: https://github.com/manishkandari9/manualattendancetrack-management-system

## Overview

##### Project Type and Purpose
- This is a full-stack web application called “Manual-Attendance-System” with a responsive React-based UI and a Node.js/Express backend.
- It supports user authentication, attendance tracking (including face-recognition attendance), assignment management, and different dashboards for students and teachers.

##### File-Structure Analysis
- Top-level “backned” folder (typo of “backend”) holds both backend logic and the production build of the frontend.
- backend/config: database connection setup (db.js).
- backend/middleware: JWT-based auth middleware (authMiddleware.js).
- backend/models: Mongoose schema definitions for User, Assignment, Attendance, faceAttendance, etc.
- backend/controller: request handlers grouped by domain (authController, attendanceController, faceAttendanceController, etc.).
- backend/routes: Express routers that map HTTP endpoints to controllers.
- backend/server.js: main Express app, static-file serving (frontend/dist) and API routes mounting.
- backend/frontend: React/Vite/Tailwind project with source (src) and production “dist” containing static assets.

##### Key Insights from README
- Minimal description: focuses on manual attendance with attractive UI and additional features (face-based attendance, assignment tracking).

a. Components
- Browser / Client:
– React SPA (built by Vite, styled with Tailwind)
– Hosts pages: SignIn/SignUp, TeacherDashboard, StudentDashboard, AssignmentManager, FaceScan, CalendarSidebar
- API Server:
– Node.js + Express application (server.js)
– Static-file server for React’s /dist
– REST API endpoints (auth, attendance, faceAttendance, assignment, student)
- Business Logic Layer:
– Controllers (authController, attendanceController, faceAttendanceController, etc.)
– Middleware (authMiddleware for JWT verification)
- Data Access Layer:
– Mongoose Models interacting with MongoDB (User, Attendance, Assignment, faceAttendanceModel, faceStudentModel)
- Database:
– MongoDB instance (connection configured in config/db.js)
- External/Third-Party Services:
– (Optional) Face recognition library or service invoked by faceAttendanceController
– (Optional) Email/SMS service for notifications (if added later)

b. Relationships & Data Flow
1. User → Browser React UI
2. React UI → HTTP(S) → Express API (api/auth, api/attendance, etc.)
3. Express Routes → authMiddleware (for protected routes) → Controllers
4. Controllers ↔ Mongoose Models → MongoDB
5. faceAttendanceController ↔ Face-Recognition Module/Service
6. Controllers return JSON → React processes response → UI updates

c. Architectural Patterns & Principles
- Layered Architecture (Presentation → API Layer → Business Logic → Data Access → Database)
- MVC‐style separation: routes (C), controllers (C/B), models (M)
- Single Page Application (SPA) on the frontend
- JWT-based stateless authentication
- Static-asset serving of production React build from the same Node server

d. Key Technologies & Frameworks
- Frontend: React, Vite, Tailwind CSS
- Backend: Node.js, Express.js, Mongoose (MongoDB ODM)
- Auth: JSON Web Tokens (JWT)
- Build & Deploy: NPM scripts, GitHub Actions (build-deploy.yml)

## Diagram (Mermaid)

```mermaid
graph TB
    %% Frontend Layer
    subgraph "Frontend (React SPA)" 
        direction TB
        SPA["React SPA"]:::frontend
        SPA -->|renders| SignIn["SignIn/SignUp Page"]:::frontend
        SPA -->|renders| TeacherDash["Teacher Dashboard"]:::frontend
        SPA -->|renders| StudentDash["Student Dashboard"]:::frontend
        SPA -->|renders| AssignMgr["Assignment Manager"]:::frontend
        SPA -->|renders| FaceScan["Face Scan Component"]:::frontend
        SPA -->|renders| CalSidebar["Calendar Sidebar"]:::frontend
        SPA -->|provides| AuthCtx["Auth Context Provider"]:::frontend
        click SPA "https://github.com/manishkandari9/manualattendancetrack-management-system/tree/vite/backned/frontend/src"
        click SignIn "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/frontend/src/SignInSignUp.jsx"
        click TeacherDash "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/frontend/src/TeacherDashboard.jsx"
        click StudentDash "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/frontend/src/StudentDashboard.jsx"
        click AssignMgr "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/frontend/src/AssignmentManager.jsx"
        click FaceScan "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/frontend/src/components/scan.jsx"
        click CalSidebar "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/frontend/src/Pages/CalendarSidebar.jsx"
        click AuthCtx "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/frontend/src/context/AuthProvider.jsx"
        SPA -->|static build| Dist["Production Build (/dist)"]:::frontend
        click Dist "https://github.com/manishkandari9/manualattendancetrack-management-system/tree/vite/backned/frontend/dist"
    end

    %% API Server Layer
    subgraph "API Server (Node/Express)" 
        direction TB
        Server["Express API Server\n(server.js)"]:::backend
        click Server "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/server.js"
        Server -->|uses| Static["Static Middleware → /dist"]:::backend
        Static --> SPA
        Server -->|mounts| Routes["Routes"]:::backend

        subgraph "Routes"
            direction TB
            AuthR["Auth Routes"]:::backend
            AttR["Attendance Routes"]:::backend
            FaceAttR["Face Attendance Routes"]:::backend
            FaceStudR["Face Student Routes"]:::backend
            AssignR["Assignment Routes"]:::backend
            StudR["Student Routes"]:::backend
            CumR["Cumulative Data Route"]:::backend
            click AuthR "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/routes/authRoutes.js"
            click AttR "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/routes/attendanceRoutes.js"
            click FaceAttR "https://github.com/manishkandari9/manualattendancetrack-management-system/tree/vite/backned/routes/faceAttendanceRoutes"
            click FaceStudR "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/routes/faceStudentRoutes.js"
            click AssignR "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/routes/assignmentRoutes.js"
            click StudR "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/routes/studentRoutes.js"
            click CumR "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/routes/CumulativeRoute.js"
        end

        Routes -->|protected by| AuthMW["JWT Auth Middleware"]:::backend
        click AuthMW "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/middleware/authMiddleware.js"

        subgraph "Controllers"
            direction TB
            AuthC["Auth Controller"]:::backend
            AttC["Attendance Controller"]:::backend
            FaceAttC["Face Attendance Controller"]:::backend
            FaceStudC["Face Student Controller"]:::backend
            AssignC["Assignment Controller"]:::backend
            StudC["Student Controller"]:::backend
            click AuthC "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/controller/authController.js"
            click AttC "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/controller/attendanceController.js"
            click FaceAttC "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/controller/faceAttendanceController.js"
            click FaceStudC "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/controller/faceStudentController.js"
            click AssignC "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/controller/assignmentController.js"
            click StudC "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/controller/studentController.js"
        end

        Routes -->|calls| AuthC
        Routes -->|calls| AttC
        Routes -->|calls| FaceAttC
        Routes -->|calls| FaceStudC
        Routes -->|calls| AssignC
        Routes -->|calls| StudC

        subgraph "Data Access (Mongoose Models)"
            direction TB
            UserM["User Model"]:::database
            AttM["Attendance Model"]:::database
            FaceAttM["Face Attendance Model"]:::database
            FaceStudM["Face Student Model"]:::database
            AssignM["Assignment Model"]:::database
            TotalSM["Total Student Model"]:::database
            click UserM "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/models/User.js"
            click AttM "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/models/Attendance.js"
            click FaceAttM "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/models/faceAttendanceModel.js"
            click FaceStudM "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/models/faceStudentModel.js"
            click AssignM "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/models/Assignment.js"
            click TotalSM "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/models/TotalStudent.js"
        end

        AuthC -->|reads/writes| UserM
        AttC -->|reads/writes| AttM
        FaceAttC -->|reads/writes| FaceAttM
        FaceStudC -->|reads/writes| FaceStudM
        AssignC -->|reads/writes| AssignM
        StudC -->|reads/writes| TotalSM

        %% DB Config
        Config["DB Config\n(config/db.js)"]:::backend
        click Config "https://github.com/manishkandari9/manualattendancetrack-management-system/blob/vite/backned/config/db.js"
        Config -->|connects| MongoDB
    end

    %% Database
    MongoDB["MongoDB\n(Cloud/On-Prem)"]:::database

    %% External Services
    subgraph "External Services"
        direction TB
        FR["Face Recognition Service"]:::external
        EM["Email/SMS Service"]:::external
    end

    FaceAttC -->|invokes| FR
    AssignC -->|optional notify| EM

    %% Client ↔ API interactions
    SignIn -->|HTTP/HTTPS JSON| Server
    TeacherDash -->|HTTP/HTTPS JSON| Server
    StudentDash -->|HTTP/HTTPS JSON| Server
    AssignMgr -->|HTTP/HTTPS JSON| Server
    FaceScan -->|HTTP/HTTPS JSON/image| Server
    CalSidebar -->|HTTP/HTTPS JSON| Server

    classDef frontend fill:#e0f7e9,stroke:#2d7d46,color:#000
    classDef backend fill:#ffe6cc,stroke:#c96, color:#000
    classDef database fill:#d0e7ff,stroke:#1e6fb5, color:#000
    classDef external fill:#f3e0ff,stroke:#9255a3, color:#000
```
