# nawras93/laraconf architecture

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

- Interactive diagram: https://gitdiagram.com/nawras93/laraconf
- Repository: https://github.com/nawras93/laraconf

## Overview

##### Project type and purpose
- This is a full-stack, monolithic web application built on the Laravel framework.
- Purpose: Manage conferences—CRUD for Conferences, Venues, Speakers, Talks, Attendees via an admin panel (Filament) and allow end-users to sign up for conferences (Livewire).

##### File structure
- Top-level directories:
- app/ contains business logic: Models, Http/Controllers, Enums, Livewire components, Filament admin resources & widgets, Service Providers
- resources/ holds Blade views, JS/CSS assets (built via Vite + Tailwind)
- public/ is the web root for index.php and compiled assets
- database/ has migrations, factories, seeders for Eloquent ORM
- config/, routes/, bootstrap/ for framework configuration and routing
- storage/ for uploaded files, cache, logs
- Key architectural indicators:
- MVC pattern: routes → controllers → views + models
- Livewire for reactive front-end components
- Eloquent ORM for database interactions

##### README for additional insights
- Generic Laravel README; confirms use of Laravel’s routing, service container, ORM, migrations, job queue, broadcasting

##### Elements
- Blue for user-facing (public)
- Green for admin (Filament)
- Orange for backend services (DB, Queues)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Clients
    BrowserPublic["Browser (Public UI)"]:::publicUI
    BrowserAdmin["Browser (Admin UI)"]:::adminUI

    %% Web Server Entry & Routing
    subgraph "Web Server (Laravel Application)"
        direction TB
        ServerEntry["public/index.php"]:::backend
        Router["Router<br/>(routes/web.php)"]:::backend
        ServiceProviders["Service Providers<br/>(app/Providers/)"]:::backend

        Controllers["Controllers<br/>(app/Http/Controllers/)"]:::backend

        subgraph "Public UI Layer"
            direction TB
            BladeTemplates["Blade Templates<br/>(resources/views/)"]:::publicUI
            LivewireComp["Livewire Class<br/>(ConferenceSignUp)"]:::publicUI
            LivewireView["Livewire View<br/>(resources/views/livewire/conference-sign-up.blade.php)"]:::publicUI
        end

        subgraph "Admin UI Layer"
            direction TB
            FilamentResources["Filament Resources<br/>(app/Filament/Resources/)"]:::adminUI
            FilamentWidget["Filament Widget Class<br/>(app/Filament/Widgets/TestChart.php)"]:::adminUI
            FilamentViews["Filament Widget Views<br/>(resources/views/filament/widgets/)"]:::adminUI
            FilamentAssetsCSS["Compiled Filament CSS<br/>(public/css/filament/)"]:::adminUI
            FilamentAssetsJS["Compiled Filament JS<br/>(public/js/filament/)"]:::adminUI
        end
    end

    %% Backend Services
    subgraph "Backend Services"
        direction TB
        DB["Database<br/>(Eloquent Models & Migrations)"]:::backend
        Storage["Storage Layer<br/>(config/filesystems.php & storage/app/)"]:::backend
        Queue["Queue System<br/>(config/queue.php)"]:::backend
        External["External Services<br/>(Mail, Cache, etc.)"]:::backend
    end

    %% Asset Bundling
    subgraph "Asset Bundling (Vite + Tailwind)"
        direction TB
        ResourcesJS["resources/js/app.js"]:::backend
        ResourcesCSS["resources/css/app.css"]:::backend
        ViteConfig["vite.config.js"]:::backend
        PublicJS["public/js/"]:::backend
        PublicCSS["public/css/"]:::backend
    end

    %% Connections
    BrowserPublic -->|"HTTP Request"| ServerEntry
    BrowserAdmin -->|"HTTP Request (Filament)"| ServerEntry

    ServerEntry --> Router
    Router --> Controllers
    Router --> LivewireComp
    Router --> FilamentResources

    ServiceProviders --> FilamentResources
    ServiceProviders --> FilamentWidget

    Controllers --> BladeTemplates
    Controllers --> LivewireComp
    Controllers --> FilamentResources

    LivewireComp --> LivewireView

    Controllers -->|"SQL Query"| DB
    LivewireComp -->|"SQL Query"| DB
    FilamentResources -->|"SQL Query"| DB

    Controllers -->|"File Store"| Storage
    LivewireComp -->|"File Store"| Storage
    FilamentWidget -->|"File Store"| Storage

    Controllers -->|"Dispatch Job"| Queue
    Queue -->|"Process Job"| External
    Controllers -->|"Send Email"| External

    ResourcesJS -->|"Build"| PublicJS
    ResourcesCSS -->|"Build"| PublicCSS
    ViteConfig --> PublicJS
    ViteConfig --> PublicCSS

    BrowserPublic -->|"Load Assets"| PublicJS
    BrowserPublic -->|"Load Assets"| PublicCSS
    BrowserAdmin -->|"Load Assets"| FilamentAssetsJS
    BrowserAdmin -->|"Load Assets"| FilamentAssetsCSS

    %% Click Events
    click BladeTemplates "https://github.com/nawras93/laraconf/tree/main/resources/views/"
    click LivewireComp "https://github.com/nawras93/laraconf/blob/main/app/Livewire/ConferenceSignUp.php"
    click LivewireView "https://github.com/nawras93/laraconf/blob/main/resources/views/livewire/conference-sign-up.blade.php"
    click FilamentResources "https://github.com/nawras93/laraconf/tree/main/app/Filament/Resources/"
    click FilamentWidget "https://github.com/nawras93/laraconf/blob/main/app/Filament/Widgets/TestChart.php"
    click FilamentViews "https://github.com/nawras93/laraconf/tree/main/resources/views/filament/widgets/"
    click ServerEntry "https://github.com/nawras93/laraconf/blob/main/public/index.php"
    click Router "https://github.com/nawras93/laraconf/blob/main/routes/web.php"
    click Controllers "https://github.com/nawras93/laraconf/tree/main/app/Http/Controllers/"
    click ServiceProviders "https://github.com/nawras93/laraconf/tree/main/app/Providers/"
    click DB "https://github.com/nawras93/laraconf/tree/main/app/Models/"
    click Storage "https://github.com/nawras93/laraconf/blob/main/config/filesystems.php"
    click Queue "https://github.com/nawras93/laraconf/blob/main/config/queue.php"
    click ResourcesJS "https://github.com/nawras93/laraconf/blob/main/resources/js/app.js"
    click ResourcesCSS "https://github.com/nawras93/laraconf/blob/main/resources/css/app.css"
    click ViteConfig "https://github.com/nawras93/laraconf/blob/main/vite.config.js"
    click PublicJS "https://github.com/nawras93/laraconf/tree/main/public/js/"
    click PublicCSS "https://github.com/nawras93/laraconf/tree/main/public/css/"
    click External "https://github.com/nawras93/laraconf/blob/main/config/services.php"

    %% Styles
    classDef publicUI fill:#D0E8FF,stroke:#333,stroke-width:1px
    classDef adminUI fill:#D0FFD8,stroke:#333,stroke-width:1px
    classDef backend fill:#FFE0B2,stroke:#333,stroke-width:1px
```
