# wani-chetan-999/quickattend architecture

> Architecture diagram of the GitHub repository wani-chetan-999/quickattend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wani-chetan-999/quickattend
- Repository: https://github.com/wani-chetan-999/quickattend

## Overview

##### Project type and purpose
- This is a Python-based desktop attendance system with a Tkinter GUI and OpenCV face-recognition backend. It optionally exposes a Flask web interface and persists data in MySQL. Its main goal is to let admins register faces, train models, and automatically log attendance as students present themselves to the camera.

##### File structure
- Top-level scripts:
- login.py, register.py, main.py – GUI entrypoints
- student.py, timeTable.py, helpFaq.py – additional GUI modules
- camera.py, face_recognition.py, train.py – core vision and model logic
- attendance.py, databaseTest.py – database interaction & record-keeping
- Data folders and files:
- data_img/ – raw face images for training
- clf.xml, haarcascade_frontalface_default.xml – pretrained cascade and classifier
- attendance.csv – backup or export of attendance logs
- Config & requirements:
- Requirmets.txt – Python dependencies
- .gitignore, .vscode – project settings

##### README insights
- Technology stack: Tkinter (GUI), OpenCV (CV), MySQL (DB), Flask (optional web layer)
- Functional flow described: register faces → train model → detect faces in real time → save attendance → export reports

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Actors
    User["User"]:::actor

    %% Presentation Layer
    subgraph "Presentation Layer"
        Login["login.py"]:::frontend
        Register["register.py"]:::frontend
        Main["main.py"]:::frontend
        Student["student.py"]:::frontend
        TimeTable["timeTable.py"]:::frontend
        HelpFaq["helpFaq.py"]:::frontend
        ImagesGUI["Images_GUI/"]:::frontend
    end

    %% Hardware Layer
    subgraph "Hardware Layer"
        Camera["Camera (Webcam)"]:::hardware
    end

    %% Logic Layer
    subgraph "Logic Layer"
        Recognition["Face-Recognition Engine"]:::logic
        Haar["haarcascade_frontalface_default.xml"]:::storage
        Model["clf.xml"]:::storage
        Training["Training Module"]:::logic
        DataImg["data_img/"]:::storage
    end

    %% Web API Optional Layer
    subgraph "Web API (Optional)"
        API["Flask API"]:::api
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        DB["MySQL Database"]:::db
        AttendanceMod["attendance.py"]:::db
        DatabaseTest["databaseTest.py"]:::db
        CSV["attendance.csv"]:::doc
    end

    %% Config & Docs
    subgraph "Configuration & Documentation"
        Requirements["Requirmets.txt"]:::doc
        GitIgnore[".gitignore"]:::doc
        VSCode[".vscode"]:::doc
        README["README.md"]:::doc
        Screenshots["Screenshots/"]:::doc
    end

    %% Relationships
    User --> Login
    Login --> Register
    Register --> Main
    Main --> Student
    Main --> TimeTable
    Main --> HelpFaq
    Main --> ImagesGUI

    Main --> Camera
    Camera --> Recognition
    Recognition --> AttendanceMod
    AttendanceMod --> DB
    Recognition --> DB

    Main --> Training
    Training --> DataImg
    Training --> Haar
    Training --> Model

    Main -.-> API
    API --> DB

    Main --> DatabaseTest
    Main --> CSV

    %% Click events
    click Login "https://github.com/wani-chetan-999/quickattend/blob/main/login.py"
    click Register "https://github.com/wani-chetan-999/quickattend/blob/main/register.py"
    click Main "https://github.com/wani-chetan-999/quickattend/blob/main/main.py"
    click Student "https://github.com/wani-chetan-999/quickattend/blob/main/student.py"
    click TimeTable "https://github.com/wani-chetan-999/quickattend/blob/main/timeTable.py"
    click HelpFaq "https://github.com/wani-chetan-999/quickattend/blob/main/helpFaq.py"
    click ImagesGUI "https://github.com/wani-chetan-999/quickattend/tree/main/Images_GUI/"
    click Camera "https://github.com/wani-chetan-999/quickattend/blob/main/camera.py"
    click Recognition "https://github.com/wani-chetan-999/quickattend/blob/main/face_recognition.py"
    click Haar "https://github.com/wani-chetan-999/quickattend/blob/main/haarcascade_frontalface_default.xml"
    click Model "https://github.com/wani-chetan-999/quickattend/blob/main/clf.xml"
    click Training "https://github.com/wani-chetan-999/quickattend/blob/main/train.py"
    click DataImg "https://github.com/wani-chetan-999/quickattend/tree/main/data_img/"
    click AttendanceMod "https://github.com/wani-chetan-999/quickattend/blob/main/attendance.py"
    click DatabaseTest "https://github.com/wani-chetan-999/quickattend/blob/main/databaseTest.py"
    click CSV "https://github.com/wani-chetan-999/quickattend/blob/main/attendance.csv"
    click Requirements "https://github.com/wani-chetan-999/quickattend/blob/main/Requirmets.txt"
    click GitIgnore "https://github.com/wani-chetan-999/quickattend/blob/main/.gitignore"
    click VSCode "https://github.com/wani-chetan-999/quickattend/blob/main/.vscode"
    click README "https://github.com/wani-chetan-999/quickattend/blob/main/README.md"
    click Screenshots "https://github.com/wani-chetan-999/quickattend/tree/main/Screenshots/"

    %% Styles
    classDef frontend fill:#D6E9FC,stroke:#4A90E2,color:#000
    classDef logic fill:#DFF0D8,stroke:#3C763D,color:#000
    classDef hardware fill:#FCF8E3,stroke:#8A6D3B,color:#000
    classDef db fill:#F2DEDE,stroke:#A94442,color:#000
    classDef storage fill:#E2E2E2,stroke:#999,color:#000
    classDef api fill:#F5F5F5,stroke:#333,color:#000,stroke-dasharray: 5 5
    classDef actor fill:#FFFFFF,stroke:#000,stroke-width:2
    classDef doc fill:#F8F8FF,stroke:#666,color:#000
```
