# dkarzky/absendpmptsp architecture

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

- Interactive diagram: https://gitdiagram.com/dkarzky/absendpmptsp
- Repository: https://github.com/dkarzky/absendpmptsp

## Overview

##### Project type and purpose
- This is a full-stack, role-based web application built on the Laravel PHP framework.
- Purpose: track employee attendance (“absensi”) and leave (“izin”), provide admin dashboards, generate monthly/aggregate reports, and export data to spreadsheets.

##### File structure
- Top‐level “app” directory follows Laravel’s MVC pattern:
- Controllers (app/Http/Controllers) handle HTTP requests for Absensi, Izin, Rekap, Profile, Admin, and Auth.
- Models (app/Models) represent Absensi, Izin, and User domain entities.
- Middleware enforces role checks (AdminMiddleware, PegawaiMiddleware).
- Exports (app/Exports) house classes for generating spreadsheet exports.
- “resources/views” contains Blade templates organized by feature (absensi, admin, pegawai, rekap, auth).
- “routes/web.php” and “routes/auth.php” define public/web routes and auth endpoints.
- Configuration, bootstrap, and package files (composer.json, .env) set up framework, database, mail, cache, session, and queue.
- “database” holds migrations and seeders for schema evolution and initial data.
- “public” is the web root (index.php entry point, assets, images).
- Supporting files: Tailwind & Vite for frontend assets, PHPUnit for tests.

##### README
- Generic Laravel README: confirms use of Laravel’s routing, DI container, Eloquent ORM, migrations, queuing, and broadcasting—even if not all are used here.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Browser["Browser"]:::frontend
        WebServer["Web Server\n(public/index.php)"]:::frontend
        RouterWeb["Router\n(routes/web.php)"]:::frontend
        RouterAuth["Router\n(routes/auth.php)"]:::frontend
        Views["Blade Views\n(resources/views/)"]:::frontend
    end

    %% Middleware Layer
    subgraph "Middleware Layer"
        direction TB
        AdminMW["AdminMiddleware"]:::logic
        PegawaiMW["PegawaiMiddleware"]:::logic
    end

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        subgraph "Controllers"
            direction TB
            AbsensiCtrl["AbsensiController"]:::logic
            IzinCtrl["IzinController"]:::logic
            RekapCtrl["RekapController"]:::logic
            ProfileCtrl["ProfileController"]:::logic
            AdminDashCtrl["AdminController"]:::logic
            AdminIzinCtrl["Admin/IzinController"]:::logic
            AdminPegawaiCtrl["Admin/PegawaiController"]:::logic
            subgraph "Auth Controllers"
                direction TB
                RegUserCtrl["RegisteredUserController"]:::logic
                SessCtrl["AuthenticatedSessionController"]:::logic
                PassResetLinkCtrl["PasswordResetLinkController"]:::logic
                NewPassCtrl["NewPasswordController"]:::logic
                ConfirmPassCtrl["ConfirmablePasswordController"]:::logic
                PassCtrl["PasswordController"]:::logic
                EmailPromptCtrl["EmailVerificationPromptController"]:::logic
                EmailNotifCtrl["EmailVerificationNotificationController"]:::logic
                VerifyEmailCtrl["VerifyEmailController"]:::logic
            end
        end
        subgraph "Services & Exports"
            direction TB
            RekapBulananExp["RekapBulananExport"]:::logic
            RekapSemuaBulananExp["RekapSemuaBulananExport"]:::logic
            RekapSemuaPegawaiExp["RekapSemuaPegawaiExport"]:::logic
        end
        subgraph "Models"
            direction TB
            AbsensiModel["Model: Absensi"]:::data
            IzinModel["Model: Izin"]:::data
            UserModel["Model: User"]:::data
        end
    end

    %% Data Layer
    subgraph "Data & Storage Layer"
        direction TB
        Database["Relational Database\n(MySQL/PostgreSQL)"]:::data
        Storage["Filesystem\n(storage/app/)"]:::data
        Cache["Cache/Session Store\n(Redis or file)"]:::external
        MailSvc["Mail Service\n(SMTP)"]:::external
        QueueWorker["Queue Worker"]:::external
    end

    %% Flow Connections
    Browser -->|"HTTP request"| WebServer
    WebServer -->|"entry point"| RouterWeb
    WebServer -->|"entry point"| RouterAuth
    RouterWeb -->|"apply AdminMW"| AdminMW
    RouterWeb -->|"apply PegawaiMW"| PegawaiMW
    RouterAuth -->|"apply Auth Middleware"| AdminMW
    AdminMW --> AbsensiCtrl
    AdminMW --> IzinCtrl
    AdminMW --> RekapCtrl
    AdminMW --> AdminDashCtrl
    AdminMW --> AdminIzinCtrl
    AdminMW --> AdminPegawaiCtrl
    PegawaiMW --> AbsensiCtrl
    PegawaiMW --> IzinCtrl
    RegUserCtrl --> UserModel
    SessCtrl --> Cache
    AbsensiCtrl -->|uses| AbsensiModel
    IzinCtrl -->|uses| IzinModel
    RekapCtrl -->|uses| RekapBulananExp
    RekapCtrl -->|uses| RekapSemuaBulananExp
    RekapCtrl -->|uses| RekapSemuaPegawaiExp
    Controllers --> Views
    Views -->|render HTML| Browser
    AbsensiModel --> Database
    IzinModel --> Database
    UserModel --> Database
    RekapBulananExp --> Storage
    RekapSemuaBulananExp --> Storage
    RekapSemuaPegawaiExp --> Storage
    AbsensiCtrl --> MailSvc
    IzinCtrl --> MailSvc
    Controllers --> QueueWorker
    QueueWorker --> Database

    %% Click Events
    click Browser "https://github.com/dkarzky/absendpmptsp/blob/main/public/index.php"
    click WebServer "https://github.com/dkarzky/absendpmptsp/blob/main/public/index.php"
    click RouterWeb "https://github.com/dkarzky/absendpmptsp/blob/main/routes/web.php"
    click RouterAuth "https://github.com/dkarzky/absendpmptsp/blob/main/routes/auth.php"
    click AdminMW "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Middleware/AdminMiddleware.php"
    click PegawaiMW "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Middleware/PegawaiMiddleware.php"
    click AbsensiCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/AbsensiController.php"
    click IzinCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/IzinController.php"
    click RekapCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/RekapController.php"
    click ProfileCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/ProfileController.php"
    click AdminDashCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/AdminController.php"
    click AdminIzinCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/Admin/IzinController.php"
    click AdminPegawaiCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/Admin/PegawaiController.php"
    click RegUserCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php"
    click SessCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
    click PassResetLinkCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/Auth/PasswordResetLinkController.php"
    click NewPassCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/Auth/NewPasswordController.php"
    click ConfirmPassCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/Auth/ConfirmablePasswordController.php"
    click PassCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/Auth/PasswordController.php"
    click EmailPromptCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/Auth/EmailVerificationPromptController.php"
    click EmailNotifCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/Auth/EmailVerificationNotificationController.php"
    click VerifyEmailCtrl "https://github.com/dkarzky/absendpmptsp/blob/main/app/Http/Controllers/Auth/VerifyEmailController.php"
    click AbsensiModel "https://github.com/dkarzky/absendpmptsp/blob/main/app/Models/Absensi.php"
    click IzinModel "https://github.com/dkarzky/absendpmptsp/blob/main/app/Models/Izin.php"
    click UserModel "https://github.com/dkarzky/absendpmptsp/blob/main/app/Models/User.php"
    click RekapBulananExp "https://github.com/dkarzky/absendpmptsp/blob/main/app/Exports/RekapBulananExport.php"
    click RekapSemuaBulananExp "https://github.com/dkarzky/absendpmptsp/blob/main/app/Exports/RekapSemuaBulananExport.php"
    click RekapSemuaPegawaiExp "https://github.com/dkarzky/absendpmptsp/blob/main/app/Exports/RekapSemuaPegawaiExport.php"
    click Views "https://github.com/dkarzky/absendpmptsp/tree/main/resources/views/"
    click Storage "https://github.com/dkarzky/absendpmptsp/tree/main/storage/app/"
    click MailSvc "https://github.com/dkarzky/absendpmptsp/blob/main/config/mail.php"
    click Cache "https://github.com/dkarzky/absendpmptsp/blob/main/config/cache.php"
    click QueueWorker "https://github.com/dkarzky/absendpmptsp/blob/main/config/queue.php"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#004085,color:#004085
    classDef logic fill:#d4edda,stroke:#155724,color:#155724
    classDef data fill:#fff3cd,stroke:#856404,color:#856404
    classDef external fill:#e2e3e5,stroke:#6c757d,color:#6c757d
```
