# diegopaez2/modamix architecture

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

- Interactive diagram: https://gitdiagram.com/diegopaez2/modamix
- Repository: https://github.com/diegopaez2/modamix

## Overview

##### Project Type & Purpose
- A monolithic full-stack web application (Laravel 10) serving as a clothing store (“Tienda de ropa”).
- It includes both a customer-facing storefront (Livewire, Blade) and an admin panel (Filament).

##### Top-Level Architecture Components
a. Client Tier
– Web browser (JS/CSS assets served via Vite)
– Mobile/Web apps (if present in future)
b. Presentation & HTTP Tier
– Nginx/Apache + PHP-FPM handling HTTP(S) requests
– Routes (web.php, api.php, auth.php) → Controllers & Livewire components
c. Application Tier
– Controllers (app/Http/Controllers)
– Livewire Components (app/Http/Livewire) for dynamic UI
– Filament Admin Resources (app/Filament/Resources)
– Service Layer (app/services/InvoiceService.php)
– Event‐Driven Modules
- Events (app/Events)
- Listeners (app/Listeners)
– Mailers (app/Mail)
– Middleware (app/Http/Middleware)
d. Domain/Data Tier
– Eloquent Models (app/Models)
– Migrations & Seeders (database/migrations, database/seeders)
– Factories (database/factories)
e. Infrastructure & Integrations
– Database (MySQL/PostgreSQL)
– Cache & Sessions (Redis/file)
– Queue (Redis/Database)
– Filesystem Storage (local/S3)
– External Services
- SMTP/Mailgun for transactional emails
- Payment gateways (e.g., Stripe)
- CDN (optional for assets)

##### Architectural Patterns & Design Principles
- MVC Pattern (Models, Views, Controllers)
- Component-Based UIs (Livewire, Blade components)
- Admin-as-Code (Filament Resources)
- Service Layer (InvoiceService) to encapsulate business logic
- Event-Driven (OrderStatusChanged → OrderCompletedListener)
- Dependency Injection via Laravel’s service container
- Configuration-as-code (config/*.php) for 12-factor compliance

##### Technologies & Frameworks
– Laravel 10 (PHP 8)
– Livewire (real-time front-end without SPA framework)
– Filament (admin panel scaffolding)
– MySQL/PostgreSQL (RDBMS)
– Redis (cache, queue)
– Vite (asset bundler: JS & CSS)
– Tailwind CSS (styles)
– PHPUnit (tests)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Tier
    subgraph "Client Tier"
        direction TB
        Browser["Web Browser"]:::ui
        Assets["Public Assets"]:::ui
        JSBundle["JS Entry (app.js)"]:::ui
        CSSBundle["CSS Entry (app.css)"]:::ui
        ViteConfig["Vite Config"]:::ui
    end

    %% Presentation & HTTP Tier
    subgraph "Presentation & HTTP Tier"
        direction TB
        WebServer["Nginx/Apache + PHP-FPM"]:::core
        EntryPoint["public/index.php"]:::core
        HTTPKernel["HTTP Kernel"]:::core
        Routes["Routes"]:::core
    end

    %% Application Tier
    subgraph "Application Tier"
        direction TB
        Controllers["Controllers"]:::core
        Livewire["Livewire Components"]:::core
        Filament["Filament Admin Resources"]:::core
        Services["Service Layer"]:::core
        Events["Events"]:::core
        Listeners["Listeners"]:::core
        Mailers["Mailers"]:::core
        Middleware["Middleware"]:::core
    end

    %% Domain/Data Tier
    subgraph "Domain/Data Tier"
        direction TB
        Models["Eloquent Models"]:::data
        Migrations["Migrations"]:::data
        Seeders["Seeders"]:::data
        Factories["Factories"]:::data
    end

    %% Infrastructure & Integrations
    subgraph "Infrastructure & Integrations"
        direction TB
        Database["Relational Database"]:::data
        Cache["Cache (Redis/File)"]:::data
        Queue["Queue (Redis/Database)"]:::data
        Storage["Filesystem Storage"]:::data
        SMTP["SMTP/Mailgun"]:::external
        Payment["Payment Gateway"]:::external
        CDN["CDN (Assets)"]:::external
    end

    %% Connections
    Browser -->|"HTTP(S)"| WebServer
    WebServer --> EntryPoint
    EntryPoint --> HTTPKernel
    HTTPKernel --> Routes
    Routes --> Controllers
    Routes --> Livewire
    Routes --> Filament
    Controllers --> Services
    Controllers --> Models
    Livewire --> Models
    Filament --> Models
    Services --> Events
    Services --> Models
    Events --> Listeners
    Listeners --> Mailers
    Mailers --> SMTP
    Models --> Database
    Models --> Queue
    Models --> Cache
    Models --> Storage
    CDN --> Browser
    JSBundle --> Browser
    CSSBundle --> Browser
    Assets --> Browser

    %% Build & Assets Pipeline
    subgraph "Build & Pipeline"
        direction TB
        Bootstrap["resources/js/bootstrap.js"]:::core
        PackageJSON["package.json"]:::core
        PostCSS["postcss.config.js"]:::core
        Tailwind["tailwind.config.js"]:::core
    end
    Bootstrap --> JSBundle
    PackageJSON --> JSBundle
    PostCSS --> CSSBundle
    Tailwind --> CSSBundle

    Assets --> CDN

    %% Click Events
    click Assets "https://github.com/diegopaez2/modamix/tree/main/public/assets"
    click JSBundle "https://github.com/diegopaez2/modamix/blob/main/resources/js/app.js"
    click CSSBundle "https://github.com/diegopaez2/modamix/blob/main/resources/css/app.css"
    click ViteConfig "https://github.com/diegopaez2/modamix/blob/main/vite.config.js"
    click Routes "https://github.com/diegopaez2/modamix/blob/main/routes/web.php"
    click Routes "https://github.com/diegopaez2/modamix/blob/main/routes/api.php"
    click Routes "https://github.com/diegopaez2/modamix/blob/main/routes/auth.php"
    click WebServer "https://github.com/diegopaez2/modamix/blob/main/app/Http/Kernel.php"
    click Controllers "https://github.com/diegopaez2/modamix/tree/main/app/Http/Controllers"
    click Livewire "https://github.com/diegopaez2/modamix/blob/main/app/Http/Livewire/Cart.php"
    click Livewire "https://github.com/diegopaez2/modamix/blob/main/app/Http/Livewire/Checkout.php"
    click Livewire "https://github.com/diegopaez2/modamix/blob/main/app/Http/Livewire/Home.php"
    click Livewire "https://github.com/diegopaez2/modamix/blob/main/app/Http/Livewire/Dashboard.php"
    click Livewire "https://github.com/diegopaez2/modamix/blob/main/app/Http/Livewire/ProductDetails.php"
    click Filament "https://github.com/diegopaez2/modamix/blob/main/app/Filament/Resources/OrderResource.php"
    click Filament "https://github.com/diegopaez2/modamix/blob/main/app/Filament/Resources/ProductResource.php"
    click Filament "https://github.com/diegopaez2/modamix/blob/main/app/Filament/Resources/CategoryResource.php"
    click Filament "https://github.com/diegopaez2/modamix/blob/main/app/Filament/Resources/UserResource.php"
    click Filament "https://github.com/diegopaez2/modamix/blob/main/app/Filament/Resources/BillingDetailResource.php"
    click Filament "https://github.com/diegopaez2/modamix/blob/main/app/Filament/Resources/OrderItemResource.php"
    click Services "https://github.com/diegopaez2/modamix/blob/main/app/services/InvoiceService.php"
    click Events "https://github.com/diegopaez2/modamix/blob/main/app/Events/OrderStatusChanged.php"
    click Listeners "https://github.com/diegopaez2/modamix/blob/main/app/Listeners/OrderCompletedListener.php"
    click Mailers "https://github.com/diegopaez2/modamix/blob/main/app/Mail/OrderCompletedMail.php"
    click Mailers "https://github.com/diegopaez2/modamix/blob/main/app/Mail/OrderReceived.php"
    click Middleware "https://github.com/diegopaez2/modamix/tree/main/app/Http/Middleware"
    click Models "https://github.com/diegopaez2/modamix/tree/main/app/Models"
    click Migrations "https://github.com/diegopaez2/modamix/tree/main/database/migrations"
    click Seeders "https://github.com/diegopaez2/modamix/blob/main/database/seeders/DatabaseSeeder.php"
    click Factories "https://github.com/diegopaez2/modamix/tree/main/database/factories"
    click EntryPoint "https://github.com/diegopaez2/modamix/blob/main/public/index.php"
    click Bootstrap "https://github.com/diegopaez2/modamix/blob/main/resources/js/bootstrap.js"
    click PackageJSON "https://github.com/diegopaez2/modamix/blob/main/package.json"
    click PostCSS "https://github.com/diegopaez2/modamix/blob/main/postcss.config.js"
    click Tailwind "https://github.com/diegopaez2/modamix/blob/main/tailwind.config.js"

    %% Styles
    classDef ui fill:#add8e6,stroke:#333,stroke-width:1px
    classDef core fill:#90ee90,stroke:#333,stroke-width:1px
    classDef data fill:#ffa500,stroke:#333,stroke-width:1px
    classDef external fill:#d3d3d3,stroke:#333,stroke-width:1px
```
