# salaheddinedaghri/employee-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/salaheddinedaghri/employee-management-system
- Repository: https://github.com/salaheddinedaghri/employee-management-system

## Overview

##### Project type and purpose
- This is a full-stack web application built on the Laravel PHP framework.
- Purpose: an Employee Management System that handles HR tasks (leave requests, certificate generation, employee records).

##### File structure
- app/ ··· contains MVC components and business logic
– HTTP Controllers (app/Http/Controllers) implement request handling
– Models (app/Models) map to database tables
– Services (app/Services) encapsulate business rules (e.g., LeaveService)
– Console Commands (app/Console/Commands) handle scheduled tasks (annual leave reset, reactivation)
– Middleware (app/Http/Middleware) enforces auth, roles, CSRF, etc.
- routes/ ··· define web (routes/web.php), API (routes/api.php), console and broadcast channels
- resources/ ··· contains front-end assets and Blade templates (views, CSS, JS, Sass)
- public/ ··· serves static assets (CSS, JS, Bootstrap, Word templates) and is the web server’s document root
- config/, bootstrap/, storage/, database/ ··· Laravel core configuration, cache, logs, migrations, seeders
- package.json, vite.config.js, tailwind.config.js ··· front-end build and asset pipeline

##### README for additional insights
- Describes two user roles: Admin and Employee
- Admin manages data, approves requests, generates certificates
- Employee submits leave requests, views status, downloads certificates
- Tech stack: PHP ≥8.1, Laravel, MySQL, Composer, Git

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        BrowserAdmin["Admin UI (Web Browser)"]:::ui
        BrowserEmployee["Employee UI (Web Browser)"]:::ui
        BrowserAdmin -->|HTTP Request| WebServer
        BrowserEmployee -->|HTTP Request| WebServer
    end

    %% Web Server / Application Layer
    subgraph "Web Server & Laravel Core"
        direction TB
        WebServer["Nginx/Apache + PHP-FPM"]:::external
        WebServer --> KernelHTTP

        subgraph "HTTP Kernel"
            direction TB
            KernelHTTP["app/Http/Kernel.php"]:::logic
        end

        KernelHTTP --> Middleware
        subgraph "Middleware Pipeline"
            direction TB
            Middleware["Middleware"]:::logic
            AdminMiddleware["AdminMiddleware"]:::logic
        end
        click Middleware "https://github.com/salaheddinedaghri/employee-management-system/tree/master/app/Http/Middleware"
        click AdminMiddleware "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Http/Middleware/AdminMiddleware.php"

        Middleware --> Router

        subgraph "Routing"
            direction TB
            WebRoutes["routes/web.php"]:::logic
            ApiRoutes["routes/api.php"]:::logic
        end
        click WebRoutes "https://github.com/salaheddinedaghri/employee-management-system/blob/master/routes/web.php"
        click ApiRoutes "https://github.com/salaheddinedaghri/employee-management-system/blob/master/routes/api.php"
        Router["Router"]:::logic
        Router --> Controllers

        subgraph "Controllers"
            direction TB
            CertificateController["CertificateController"]:::logic
            LeaveRequestController["LeaveRequestController"]:::logic
            LeaveDecisionController["LeaveDecisionController"]:::logic
            EmployeeController["EmployeeController"]:::logic
            SalaryCertificateController["SalaryCertificateController"]:::logic
            WorkCertificateController["WorkCertificateController"]:::logic
            AuthController["AuthController"]:::logic
        end
        click CertificateController "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Http/Controllers/CertificateController.php"
        click LeaveRequestController "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Http/Controllers/LeaveRequestController.php"
        click LeaveDecisionController "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Http/Controllers/LeaveDecisionController.php"
        click EmployeeController "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Http/Controllers/EmployeeController.php"
        click SalaryCertificateController "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Http/Controllers/SalaryCertificateController.php"
        click WorkCertificateController "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Http/Controllers/WorkCertificateController.php"
        click AuthController "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Http/Controllers/auth/AuthController.php"
        click Controllers "https://github.com/salaheddinedaghri/employee-management-system/tree/master/app/Http/Controllers"

        Controllers --> Services

        subgraph "Services"
            direction TB
            LeaveService["LeaveService"]:::logic
        end
        click LeaveService "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Services/LeaveService.php"
        click Services "https://github.com/salaheddinedaghri/employee-management-system/tree/master/app/Services"

        Services --> Models

        subgraph "Models"
            direction TB
            PersonnelModel["Personnel"]:::data
            CongeModel["Conge"]:::data
            LigneCongeModel["LigneConge"]:::data
            RoleModel["Role"]:::data
        end
        click PersonnelModel "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Models/Personnel.php"
        click CongeModel "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Models/Conge.php"
        click LigneCongeModel "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Models/LigneConge.php"
        click RoleModel "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Models/Role.php"
        click Models "https://github.com/salaheddinedaghri/employee-management-system/tree/master/app/Models"

        Models --> Database
    end

    %% Data Storage & External Services
    subgraph "Storage & External"
        direction TB
        Database["MySQL Database"]:::storage
        Storage["File Storage"]:::storage
        Mail["Mail Server"]:::external
        Cache["Cache/Queue (Redis)"]:::external
        Database -->|migrations/seeders| Migrations
        Storage -->|public files| PublicAssets
    end
    click Migrations "https://github.com/salaheddinedaghri/employee-management-system/tree/master/database/migrations"
    click Database "https://github.com/salaheddinedaghri/employee-management-system/tree/master/database"
    click Storage "https://github.com/salaheddinedaghri/employee-management-system/tree/master/storage/app/public"
    click Mail "https://github.com/salaheddinedaghri/employee-management-system/tree/master/config"
    click Cache "https://github.com/salaheddinedaghri/employee-management-system/tree/master/config"

    %% Public assets
    PublicAssets["public/"]:::storage
    click PublicAssets "https://github.com/salaheddinedaghri/employee-management-system/tree/master/public/css"

    %% Frontend source
    subgraph "Frontend Build"
        direction TB
        ViteConfig["vite.config.js"]:::logic
        TailwindConfig["tailwind.config.js"]:::logic
        ResourcesCSS["resources/css"]:::logic
        ResourcesJS["resources/js"]:::logic
        ResourcesSASS["resources/sass"]:::logic
    end
    click ViteConfig "https://github.com/salaheddinedaghri/employee-management-system/blob/master/vite.config.js"
    click TailwindConfig "https://github.com/salaheddinedaghri/employee-management-system/blob/master/tailwind.config.js"
    click ResourcesCSS "https://github.com/salaheddinedaghri/employee-management-system/tree/master/resources/css"
    click ResourcesJS "https://github.com/salaheddinedaghri/employee-management-system/tree/master/resources/js"
    click ResourcesSASS "https://github.com/salaheddinedaghri/employee-management-system/tree/master/resources/sass"

    %% Console / Scheduled Tasks
    Cron["Cron"]:::external --> KernelConsole
    subgraph "Console Kernel & Commands"
        direction TB
        KernelConsole["app/Console/Kernel.php"]:::logic
        AnnualReset["AnnualLeaveReset"]:::logic
        ReactivateCmd["ReactivateEmployeesCommand"]:::logic
    end
    click KernelConsole "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Console/Kernel.php"
    click AnnualReset "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Console/Commands/AnnualLeaveReset.php"
    click ReactivateCmd "https://github.com/salaheddinedaghri/employee-management-system/blob/master/app/Console/Commands/ReactivateEmployeesCommand.php"
    KernelConsole --> AnnualReset
    KernelConsole --> ReactivateCmd
    AnnualReset --> Services
    ReactivateCmd --> Services

    %% Class Definitions
    classDef ui fill:#e0f7e9,stroke:#2e7d32,color:#2e7d32;
    classDef logic fill:#e3f2fd,stroke:#1565c0,color:#1565c0;
    classDef data fill:#fff3e0,stroke:#ef6c00,color:#e65100;
    classDef storage fill:#ffecb3,stroke:#ff8f00,color:#e65100;
    classDef external fill:#f3e5f5,stroke:#6a1b9a,color:#4a148c;
```
