# abhipraya-kusuma-dev/seragam-app architecture

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

- Interactive diagram: https://gitdiagram.com/abhipraya-kusuma-dev/seragam-app
- Repository: https://github.com/abhipraya-kusuma-dev/seragam-app

## Overview

##### Project type and purpose
- This is a full-stack Laravel web application (“Seragam App”) for managing uniform (seragam) orders, inventory, measurement (ukur), and reporting.
- It uses Blade templates and Tailwind CSS/Vite for the UI, a MySQL (or other SQL) database for persistence, a Node.js Socket.IO server for real-time updates, and Laravel Excel for import/export features.

##### File structure
- Top-level ‘app’ directory follows the Laravel MVC pattern:
- Controllers (app/Http/Controllers, including API‐specific controllers)
- Models (app/Models)
- Middleware (app/Http/Middleware)
- Console commands and scheduled tasks (app/Console)
- Exports/Imports (app/Exports, app/Imports)
- Service providers (app/Providers)
- ‘routes’ holds web, API, console, and broadcasting routes.
- ‘resources’ holds UI assets: Blade views (resources/views), CSS/JS modules (resources/css, resources/js) configured via tailwind.config.js and vite.config.js.
- ‘public’ serves the entry point (index.php), static assets, and an Excel template.
- ‘server.cjs’ at project root is a separate Node.js service running Socket.IO on port 3000.
- Configuration files under ‘config’, database migrations/seeders under ‘database’, and environment variables in ‘.env’.

##### Key insights from README
- PHP 8.2, Composer, NPM are required.
- Run `php artisan serve` for the Laravel app and `node server.cjs` for the real-time Socket.IO server.
- Database migrations set up users, orders, uniforms (seragam), statuses.
- Sanctum is configured (config/sanctum.php) for API authentication if needed.

##### Implementation notes for maximum detail
- Middleware chain upstream of controllers.
- Console Kernel if scheduled jobs (migrations, exports) are significant.
- Explicitly show the Excel template in public/excel and the import workflow via SeragamImport.
- Link the Laravel BroadcastServiceProvider to the Socket.IO server to illustrate real-time event flow.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Zone
    subgraph "Frontend Layer"
        direction TB
        Browser["Client Browser"]:::frontend
        HTML["Blade Templates"]:::frontend
        CSS["resources/css/app.css"]:::frontend
        JS["resources/js/app.js"]:::frontend
        WSClient["resources/js/bootstrap.js\n(WebSocket Client)"]:::frontend
    end

    Browser -->|"renders"| HTML
    Browser -->|"loads"| CSS
    Browser -->|"loads"| JS
    Browser -->|"initializes"| WSClient

    %% Backend Zone
    subgraph "Backend Layer (Laravel)"
        direction TB
        Kernel["HTTP Kernel\n(app/Http/Kernel.php)"]:::backend
        Middleware["Middleware\n(app/Http/Middleware/)"]:::backend
        Routing["Routing\n(routes/web.php\nroutes/api.php\nroutes/channels.php)"]:::backend
        subgraph "Controllers"
            direction TB
            GudangController["GudangController"]:::backend
            UkurController["UkurController"]:::backend
            LaporanController["LaporanController"]:::backend
            UserController["UserController"]:::backend
            GetGudangDataController["GetGudangDataController"]:::backend
            GetUkurDataController["GetUkurDataController"]:::backend
        end
        subgraph "Domain & Persistence"
            direction TB
            UserModel["User\n(app/Models/User.php)"]:::backend
            SeragamModel["Seragam\n(app/Models/Seragam.php)"]:::backend
            OrderModel["Order\n(app/Models/Order.php)"]:::backend
            StatusModel["Status\n(app/Models/Status.php)"]:::backend
        end
        subgraph "Import/Export Module"
            direction TB
            SeragamImport["SeragamImport\n(app/Imports/SeragamImport.php)"]:::backend
            LaporanExport["LaporanExport\n(app/Exports/LaporanExport.php)"]:::backend
            ExcelTemplate["TEMPLATE DATA BAJU SWK.xlsx"]:::infra
        end
        Console["Console Kernel\n(app/Console/Kernel.php)"]:::backend
        subgraph "Service Providers"
            direction TB
            AppServiceProvider["AppServiceProvider"]:::backend
            AuthServiceProvider["AuthServiceProvider"]:::backend
            BroadcastServiceProvider["BroadcastServiceProvider"]:::backend
            EventServiceProvider["EventServiceProvider"]:::backend
            RouteServiceProvider["RouteServiceProvider"]:::backend
        end
    end

    %% Microservice and Infrastructure
    NodeSOCKET["Node.js Socket.IO Server\n(server.cjs)"]:::micro
    DB[(MySQL Database)]:::infra
    Storage[(File Storage)]:::infra

    %% Relationships
    Browser -->|"HTTP(S) Request"| Kernel
    Kernel --> Middleware
    Middleware --> Routing
    Routing --> Controllers
    Controllers --> Domain
    Domain --> DB
    Controllers --> SeragamImport
    Controllers --> LaporanExport
    SeragamImport --> ExcelTemplate
    LaporanExport --> Storage
    Console --> SeragamImport
    Console --> LaporanExport
    BroadcastServiceProvider -->|"broadcast events"| NodeSOCKET
    Kernel --> AppServiceProvider
    Kernel --> AuthServiceProvider
    Kernel --> EventServiceProvider
    Kernel --> RouteServiceProvider

    Browser -.->|"WebSocket"| NodeSOCKET
    NodeSOCKET -->|"push events"| WSClient

    Controllers -->|"CRUD via Eloquent"| DB

    %% Click Events
    click HTML "https://github.com/abhipraya-kusuma-dev/seragam-app/tree/main/resources/views"
    click CSS "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/resources/css/app.css"
    click JS "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/resources/js/app.js"
    click WSClient "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/resources/js/bootstrap.js"
    click Kernel "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Http/Kernel.php"
    click Middleware "https://github.com/abhipraya-kusuma-dev/seragam-app/tree/main/app/Http/Middleware/"
    click Routing "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/routes/web.php"
    click Routing "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/routes/api.php"
    click Routing "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/routes/channels.php"
    click GudangController "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Http/Controllers/GudangController.php"
    click UkurController "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Http/Controllers/UkurController.php"
    click LaporanController "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Http/Controllers/LaporanController.php"
    click UserController "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Http/Controllers/UserController.php"
    click GetGudangDataController "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Http/Controllers/Api/GetGudangDataController.php"
    click GetUkurDataController "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Http/Controllers/Api/GetUkurDataController.php"
    click UserModel "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Models/User.php"
    click SeragamModel "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Models/Seragam.php"
    click OrderModel "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Models/Order.php"
    click StatusModel "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Models/Status.php"
    click SeragamImport "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Imports/SeragamImport.php"
    click LaporanExport "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Exports/LaporanExport.php"
    click ExcelTemplate "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/public/excel/TEMPLATE DATA BAJU SWK.xlsx"
    click AppServiceProvider "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Providers/AppServiceProvider.php"
    click AuthServiceProvider "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Providers/AuthServiceProvider.php"
    click BroadcastServiceProvider "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Providers/BroadcastServiceProvider.php"
    click EventServiceProvider "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Providers/EventServiceProvider.php"
    click RouteServiceProvider "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Providers/RouteServiceProvider.php"
    click Console "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/app/Console/Kernel.php"
    click NodeSOCKET "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/server.cjs"
    click DB "https://github.com/abhipraya-kusuma-dev/seragam-app/blob/main/config/database.php"
    click Storage "https://github.com/abhipraya-kusuma-dev/seragam-app/tree/main/storage/app/public/"
    click ExcelTemplate "https://github.com/abhipraya-kusuma-dev/seragam-app/tree/main/public/excel/"
    
    %% Styles
    classDef frontend fill:#CFE2FF,stroke:#0366d6,color:#0366d6;
    classDef backend fill:#D1E7DD,stroke:#116611,color:#116611;
    classDef micro fill:#FFE5D9,stroke:#d6591a,color:#d6591a;
    classDef infra fill:#E2E3E5,stroke:#6a737d,color:#6a737d;
```
