# umutkarakas34/market-app-laravel-vuejs architecture

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

- Interactive diagram: https://gitdiagram.com/umutkarakas34/market-app-laravel-vuejs
- Repository: https://github.com/umutkarakas34/market-app-laravel-vuejs

## Overview

##### Project type and purpose
- This is a Laravel-powered full-stack web application exposing a RESTful API (“Market-App API”)
- It combines a Vue.js single-page frontend with a Laravel backend, handling user/admin authentication, product management, and order processing

##### File structure
- Top-level directories:
– app/ (Laravel MVC: Controllers, Models, Middleware, Console, Exceptions, Providers)
– routes/ (defines API routes – api.php – and web routes – web.php)
– resources/js/ (Vue.js app: components, router, bootstrap)
– public/ (compiled assets: app.js, app.css; entry point index.php)
– database/ (migrations, factories, seeders for MySQL)
– config/ (Laravel config for auth, database, services, cache, session, etc.)
- Key config/build: webpack.mix.js for asset compilation, .env for environment variables, composer.json & package.json for dependencies
- Middleware stack enforces authentication (Sanctum), role checks (AdminMiddleware, UserMiddleware), CSRF, cookie encryption, etc.

##### README for additional insights
- Confirms Laravel + Vue.js + Axios + Sanctum + MySQL
- Lists all API endpoints and their authorization requirements
- Emphasizes simple user vs. admin roles and typical HTTP status error codes

a. Frontend (Vue.js SPA)
– Hosted under public/index.php and served by Laravel’s blade or directly as static assets
– Makes HTTP calls via Axios to /api/* endpoints
b. Backend API (Laravel)
– Public entry point: public/index.php → bootstrap/app.php → HTTP kernel
– Routes → Middleware → Controllers (AuthController, ProductController, OrderController, AdminAuthController)
– Business logic uses Models (User, Admin, Product, Order) and Services (via ServiceProviders)
– Authentication via Laravel Sanctum issuing/revoking tokens
c. Database (MySQL)
– Tables: users, admins, products, orders, personal_access_tokens
– Eloquent ORM handles CRUD from Models to database
d. External services & infrastructure
– File storage (local/public) for any uploads
– Caching, queues, mail services (configured in config/)
– Version control (Git) and build tools (npm, composer)

##### Architectural patterns and design principles
- MVC pattern in the backend (Controllers → Models → Views or API responses)
- RESTful API design for CRUD operations on Products & Orders
- Single-Page Application (SPA) pattern on the frontend (Vue.js router & components)
- Middleware chain for cross-cutting concerns (Security, Auth, CORS, CSRF)
- Dependency injection and service providers for decoupling

1. Presentation Layer (Client)
– Label “Browser (Vue.js SPA)”
2. Application Layer (Server/API)
– Label “Laravel API Server”
– Show Controllers mapping (AuthController, ProductController, OrderController, AdminAuthController)
– Indicate Laravel ServiceProviders and Eloquent Models
3. Data Layer (Database & Storage)
– Label “MySQL Database” with tables (users, admins, products, orders, tokens)
– Label “File Storage” (local/public)
– Browser → (HTTP/HTTPS) → Laravel API
– Laravel Controllers → (ORM Queries) → MySQL
– Laravel → (Read/Write) → Local Storage

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer (Client)" 
        direction TB
        Browser["Browser (Vue.js SPA)"]:::client
        subgraph "Vue.js Application"
            direction TB
            AppJS["app.js"]:::client
            Bootstrap["bootstrap.js"]:::client
            Router["router/index.js"]:::client
            Components["components/*.vue"]:::client
        end
        Webpack["webpack.mix.js"]:::tool
        PublicAssets["public/js/app.js\npublic/css/app.css"]:::client
    end

    %% Application Layer
    subgraph "Application Layer (Server/API)"
        direction TB
        API_Server["Laravel API Server"]:::server
        EntryPoint["public/index.php"]:::server
        BootstrapApp["bootstrap/app.php"]:::server
        Kernel["app/Http/Kernel.php"]:::server

        subgraph "Middleware"
            direction TB
            AuthMiddleware["Authenticate.php"]:::server
            AdminMiddleware["AdminMiddleware.php"]:::server
            UserMiddleware["UserMiddleware.php"]:::server
            CSRF["VerifyCsrfToken.php"]:::server
        end

        subgraph "Routing"
            direction TB
            APIRoutes["routes/api.php"]:::server
            WebRoutes["routes/web.php"]:::server
        end

        subgraph "Controllers"
            direction TB
            AuthController["AuthController.php"]:::server
            AdminAuthController["AdminAuthController.php"]:::server
            ProductController["ProductController.php"]:::server
            OrderController["OrderController.php"]:::server
            UserController["UserController.php"]:::server
        end

        subgraph "Service Providers & DI"
            direction TB
            AuthServiceProv["AuthServiceProvider.php"]:::server
            AppServiceProv["AppServiceProvider.php"]:::server
            EventServiceProv["EventServiceProvider.php"]:::server
            RouteServiceProv["RouteServiceProvider.php"]:::server
        end

        subgraph "Models"
            direction TB
            UserModel["User.php"]:::server
            AdminModel["Admin.php"]:::server
            ProductModel["Product.php"]:::server
            OrderModel["Order.php"]:::server
        end
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        MySQL["MySQL Database"]:::data
        Storage["File Storage (local/public)"]:::data
        subgraph "Migrations & Seeds"
            direction TB
            Migrations["database/migrations/*.php"]:::data
            FactoriesSeeders["factories & seeders"]:::data
        end
    end

    %% Connections
    Browser -->|HTTP/HTTPS| EntryPoint
    EntryPoint --> BootstrapApp
    BootstrapApp --> Kernel
    Kernel --> AuthMiddleware
    Kernel --> CSRF
    Kernel --> AdminMiddleware
    Kernel --> UserMiddleware
    Kernel --> APIRoutes
    Kernel --> WebRoutes
    APIRoutes --> AuthController
    APIRoutes --> AdminAuthController
    APIRoutes --> ProductController
    APIRoutes --> OrderController
    APIRoutes --> UserController
    AuthController --> UserModel
    AdminAuthController --> AdminModel
    ProductController --> ProductModel
    OrderController --> OrderModel
    AuthController -->|"sanctum tokens"| MySQL
    Controllers -->|ORM Queries| MySQL
    ProductController -->|file uploads| Storage
    ServiceProv --> Controllers
    ServiceProv --> Models

    %% Build & Tools
    Webpack --> AppJS
    Webpack --> PublicAssets

    %% Click Events
    click AppJS "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/resources/js/app.js"
    click Bootstrap "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/resources/js/bootstrap.js"
    click Router "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/resources/js/router/index.js"
    click Components "https://github.com/umutkarakas34/market-app-laravel-vuejs/tree/main/resources/js/components"
    click Webpack "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/webpack.mix.js"
    click PublicAssets "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/public/js/app.js"
    click PublicAssets "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/public/css/app.css"
    click EntryPoint "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/public/index.php"
    click BootstrapApp "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/bootstrap/app.php"
    click Kernel "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Http/Kernel.php"
    click APIRoutes "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/routes/api.php"
    click WebRoutes "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/routes/web.php"
    click AuthController "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Http/Controllers/AuthController.php"
    click AdminAuthController "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Http/Controllers/AdminAuthController.php"
    click ProductController "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Http/Controllers/ProductController.php"
    click OrderController "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Http/Controllers/OrderController.php"
    click UserController "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Http/Controllers/UserController.php"
    click AuthMiddleware "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Http/Middleware/Authenticate.php"
    click AdminMiddleware "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Http/Middleware/AdminMiddleware.php"
    click UserMiddleware "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Http/Middleware/UserMiddleware.php"
    click CSRF "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Http/Middleware/VerifyCsrfToken.php"
    click UserModel "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Models/User.php"
    click AdminModel "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Models/Admin.php"
    click ProductModel "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Models/Product.php"
    click OrderModel "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Models/Order.php"
    click AuthServiceProv "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Providers/AuthServiceProvider.php"
    click AppServiceProv "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Providers/AppServiceProvider.php"
    click EventServiceProv "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Providers/EventServiceProvider.php"
    click RouteServiceProv "https://github.com/umutkarakas34/market-app-laravel-vuejs/blob/main/app/Providers/RouteServiceProvider.php"
    click Migrations "https://github.com/umutkarakas34/market-app-laravel-vuejs/tree/main/database/migrations"
    click FactoriesSeeders "https://github.com/umutkarakas34/market-app-laravel-vuejs/tree/main/database/seeders"
    click Storage "https://github.com/umutkarakas34/market-app-laravel-vuejs/tree/main/storage/app/public"

    %% Styles
    classDef client fill:#cce5ff,stroke:#3399ff,color:#004085;
    classDef server fill:#d4edda,stroke:#28a745,color:#155724;
    classDef data fill:#fff3cd,stroke:#ffc107,color:#856404;
    classDef tool fill:#e2e3e5,stroke:#6c757d,color:#383d41;
```
