# spidy20/attendace_management_system architecture

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

- Interactive diagram: https://gitdiagram.com/spidy20/attendace_management_system
- Repository: https://github.com/spidy20/attendace_management_system

## Overview

##### Project Type and Purpose
- This is a desktop “Attendance Management System” that uses face recognition
- It combines a GUI front-end (Tkinter) with image processing (OpenCV), data storage (CSV/DB), and a model training pipeline

##### Main Components
1. User Interface Layer
– AMS_Run.py: the entry point for the Tkinter GUI
– UI Modules:
- “Take Images” screen
- “Train Image” screen
- “Automatic Attendance” screen
- “Manually Fill Attendance” screen
2. Face Data Collection & Storage
– TrainingImage folder: stores raw face images
– StudentDetails.csv: maps IDs ↔ names
3. Model Training Pipeline
– training.py / retrain.py: scripts that read TrainingImage, train the recognizer, output Trainner.yml
– Haarcascade XML files: used by OpenCV for face detection
4. Recognition Engine
– testing.py / code within AMS_Run.py: loads Trainner.yml, uses OpenCV to detect & recognize faces in real time
5. Attendance Management
– Attendance folder: writes CSV files (with timestamp, subject) for each session
– Optional DB Module: MySQL/WAMP server connector in AMS_Run.py stores attendance & student details in a database
6. External Libraries & Resources
– OpenCV, PIL (Pillow), Pandas, Tkinter

##### Relationships & Data Flows
- User → GUI → triggers:
– “Take Images” → Face Detector → store raw images → update StudentDetails.csv
– “Train Image” → Training Pipeline → produces Trainner.yml
– “Automatic Attendance” → Recognition Engine → writes attendance CSV & updates DB
– “Manually Fill Attendance” → direct CSV/DB write without recognition
- TrainingImage → training.py → Trainner.yml
- Haarcascade XML → used by both data collection and recognition steps
- CSV files and DB: sink for attendance records and student metadata

##### Architectural Patterns & Principles
- Module Separation:
– UI layer (AMS_Run.py)
– Data layer (file storage, CSV, DB)
– Business logic layer (face detection, training, recognition)
- Resource Reuse: Haarcascade XML files shared by both data collection and recognition
- Extensibility Points:
– Swap recognizer algorithm (update training.py)
– Change DB backend in AMS_Run.py

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Top-level Application
    subgraph "AMS Desktop Application"
        direction TB

        %% UI Layer
        subgraph "GUI (Tkinter)"
            direction TB
            UI["AMS_Run.py"]:::ui
            TakeImages["Take Images Screen"]:::ui
            TrainImage["Train Image Screen"]:::ui
            AutoAttendance["Automatic Attendance Screen"]:::ui
            ManualAttendance["Manual Attendance Screen"]:::ui
        end

        %% Face Processing
        subgraph "Face Processing"
            direction TB
            FaceDetector["Face Detector\n(Haarcascade XML)"]:::proc
            TestingScript["testing.py"]:::proc
        end

        %% Training Module
        subgraph "Training Module"
            direction TB
            TrainingScript["training.py"]:::proc
            RetrainScript["retrain.py"]:::proc
            Notes["training code.txt"]:::proc
        end

        %% Data Storage
        subgraph "Data Storage"
            direction TB
            RawImages["TrainingImage Folder"]:::store
            StudentCSV["StudentDetails.csv"]:::store
            ModelFile["Trainner.yml"]:::store
            AttendanceFiles["Attendance CSV Files"]:::store
            DB["Database (MySQL/WAMP)"]:::store
        end
    end

    %% External Dependencies
    subgraph "External Dependencies"
        direction TB
        OpenCV["OpenCV"]:::ext
        PIL["PIL (Pillow)"]:::ext
        Pandas["Pandas"]:::ext
        TkLib["Tkinter"]:::ext
    end

    %% Relationships
    UI -->|triggers| TakeImages
    UI -->|triggers| TrainImage
    UI -->|triggers| AutoAttendance
    UI -->|triggers| ManualAttendance

    TakeImages -->|"capture raw images"| FaceDetector
    FaceDetector -->|"save images"| RawImages
    FaceDetector -->|"update ID↔name"| StudentCSV

    TrainImage -->|"invoke training"| TrainingScript
    TrainingScript -->|"reads images"| RawImages
    TrainingScript -->|"produce model"| ModelFile
    RetrainScript -->|"retrain model"| ModelFile
    Notes -->|"reference pipeline"| TrainingScript

    AutoAttendance -->|"recognize faces"| TestingScript
    TestingScript -->|"load model"| ModelFile
    TestingScript -->|"detect faces"| FaceDetector
    TestingScript -->|"write attendance"| AttendanceFiles
    TestingScript -->|"update DB"| DB

    ManualAttendance -->|"write attendance"| AttendanceFiles
    ManualAttendance -->|"update DB"| DB

    FaceDetector -->|"uses XML"| XML1
    FaceDetector -->|"uses XML"| XML2
    TestingScript -->|"uses XML"| XML1
    TestingScript -->|"uses XML"| XML2

    %% External dependencies usage
    FaceDetector --> OpenCV
    TestingScript --> OpenCV
    UI --> TkLib
    TrainingScript --> OpenCV
    TestingScript --> PIL
    StudentCSV --> Pandas

    %% XML Resources
    XML1["haarcascade_frontalface_alt.xml"]:::ext
    XML2["haarcascade_frontalface_default.xml"]:::ext

    %% Click Events
    click UI "https://github.com/spidy20/attendace_management_system/blob/master/AMS_Run.py"
    click StudentCSV "https://github.com/spidy20/attendace_management_system/blob/master/StudentDetails/StudentDetails.csv"
    click TrainingScript "https://github.com/spidy20/attendace_management_system/blob/master/training.py"
    click RetrainScript "https://github.com/spidy20/attendace_management_system/blob/master/retrain.py"
    click Notes "https://github.com/spidy20/attendace_management_system/blob/master/training code.txt"
    click ModelFile "https://github.com/spidy20/attendace_management_system/blob/master/TrainingImageLabel/Trainner.yml"
    click TestingScript "https://github.com/spidy20/attendace_management_system/blob/master/testing.py"
    click XML1 "https://github.com/spidy20/attendace_management_system/blob/master/haarcascade_frontalface_alt.xml"
    click XML2 "https://github.com/spidy20/attendace_management_system/blob/master/haarcascade_frontalface_default.xml"

    %% Styles
    classDef ui fill:#D0E1F9,stroke:#0366D6,color:#000
    classDef proc fill:#DFF2DD,stroke:#22863A,color:#000
    classDef store fill:#FFEFD5,stroke:#DB5A42,color:#000
    classDef ext fill:#EAECEF,stroke:#959DA5,color:#000
```
