# tsavou/boldy architecture

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

- Interactive diagram: https://gitdiagram.com/tsavou/boldy
- Repository: https://github.com/tsavou/boldy

## Overview

##### Project Type & Purpose
- Boldy is a monolithic full-stack web application built with Laravel 12 (backend) and Vue 3 + Inertia.js (frontend).
- Its goal is to let freelancers build/verifiy profiles, allow recruiters to search/filter them, and support paid features (boosts, subscriptions) via Stripe.

##### High-Level Architecture Components
a. Client (Browser)
- Vue 3 single-page‐app served via Inertia.js
- Tailwind CSS for styling
b. Web Server & App Container
- Nginx or built-in HTTP server in Docker Sail
- PHP-FPM running Laravel application
- Inertia bridges HTTP requests to Vue components for SSR/CSR
c. Backend (Laravel)
- Routes (routes/web.php, routes/api.php)
- Controllers (app/Http/Controllers) implementing MVC
- Models & Eloquent ORM (app/Models) interacting with MySQL
- Middleware (app/Http/Middleware) for auth, Inertia handling
- Policies (app/Policies) and Requests (app/Http/Requests) for validation/authorization
- Services & Providers (app/Providers) for bootstrapping features (Stripe, cache, queue)
d. Data Stores
- MySQL (database/migrations, factories, seeders)
- File storage (local & public disk via config/filesystems.php) for media uploads, identity documents
- Cache & session storage (Redis or file based via config/cache.php, config/session.php)
e. External Services
- Stripe API (payment processing & webhooks via Cashier)
- MailPit (local SMTP testing)
- Laravel Cloud (production hosting & CI/CD)

##### Relationships & Data Flow
- The Browser issues HTTP requests → Nginx/PHP-FPM
- Laravel handles routing: web vs API endpoints
- Controllers invoke Services, Policies, Eloquent Models → MySQL or file storage
- Responses wrapped by Inertia.js and delivered as HTML+props or JSON for the Vue frontend
- For payments, Laravel Cashier communicates with Stripe; webhooks return to Laravel for fulfillment
- Queued jobs (e.g., email notifications) are pushed to Laravel’s queue system and processed by workers

##### Architectural Patterns & Design Principles
- MVC on the server side
- Inertia.js for “server-driven SPA” pattern (no separate REST API)
- Eloquent ORM for Data Access Layer
- Repository/Factory pattern for test data (Seeders, Factories)
- Policy-based Authorization
- Docker Compose (Laravel Sail) for local environment standardization
- Service-oriented integration with Stripe, MailPit

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Browser["Browser"]
        AppJS["app.js"]:::frontend
        BootstrapJS["bootstrap.js"]:::frontend
        SSR["ssr.js"]:::frontend
        Pages["Pages/"]:::frontend
        Components["Components/"]:::frontend
        Layouts["Layouts/"]:::frontend
        Tailwind["tailwind.config.js"]:::frontend
    end

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        RoutesWeb["routes/web.php"]:::backend
        RoutesAPI["routes/api.php"]:::backend
        RoutesAuth["routes/auth.php"]:::backend
        RoutesConsole["routes/console.php"]:::backend
        Controllers["Controllers/"]:::backend
        Middleware["HandleInertiaRequests.php"]:::backend
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        Models["Models/"]:::backend
        Policies["Policies/"]:::backend
        Requests["Requests/"]:::backend
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
        direction TB
        MySQL["MySQL (3306)"]:::datastore
        Migrations["migrations/"]:::datastore
        Factories["factories/"]:::datastore
        Seeders["seeders/"]:::datastore
        FileStorage["File Storage"]:::datastore
        CacheSession["Cache & Session"]:::datastore
    end

    %% External Services
    subgraph "External Services"
        direction TB
        Stripe["Stripe API"]:::external
        MailPit["MailPit"]:::external
        LaravelCloud["Laravel Cloud"]:::external
    end

    %% Queue
    QueueProducer["Queue Producer"]:::backend
    QueueBroker["Queue Broker"]:::datastore
    QueueWorker["Queue Worker"]:::backend

    %% Connections
    Browser --> AppJS
    AppJS -->|Inertia| RoutesWeb
    AppJS -->|Inertia| RoutesAPI
    RoutesWeb --> Controllers
    RoutesAPI --> Controllers
    Controllers -->|uses| Middleware
    Controllers -->|calls| Models
    Controllers -->|validates| Requests
    Controllers -->|authorizes| Policies
    Models --> MySQL
    Migrations --> MySQL
    Factories --> MySQL
    Seeders --> MySQL
    Controllers -->|uploads/downloads| FileStorage
    Controllers -->|reads/writes| CacheSession
    Controllers -->|process payment| Stripe
    Controllers -->|send webhooks| Stripe
    Controllers -->|send emails| QueueProducer
    QueueProducer --> QueueBroker
    QueueBroker --> QueueWorker
    QueueWorker -->|exec jobs| Controllers
    Browser --- Tailwind
    LaravelCloud -->|hosts| Browser
    LaravelCloud -->|deploys| Controllers
    MailPit -->|SMTP| Controllers

    %% Click Events
    click AppJS "https://github.com/tsavou/boldy/blob/main/resources/js/app.js"
    click BootstrapJS "https://github.com/tsavou/boldy/blob/main/resources/js/bootstrap.js"
    click SSR "https://github.com/tsavou/boldy/blob/main/resources/js/ssr.js"
    click Pages "https://github.com/tsavou/boldy/tree/main/resources/js/Pages/"
    click Components "https://github.com/tsavou/boldy/tree/main/resources/js/Components/"
    click Layouts "https://github.com/tsavou/boldy/tree/main/resources/js/Layouts/"
    click Tailwind "https://github.com/tsavou/boldy/blob/main/tailwind.config.js"
    click RoutesWeb "https://github.com/tsavou/boldy/blob/main/routes/web.php"
    click RoutesAPI "https://github.com/tsavou/boldy/blob/main/routes/api.php"
    click RoutesAuth "https://github.com/tsavou/boldy/blob/main/routes/auth.php"
    click RoutesConsole "https://github.com/tsavou/boldy/blob/main/routes/console.php"
    click Middleware "https://github.com/tsavou/boldy/blob/main/app/Http/Middleware/HandleInertiaRequests.php"
    click Controllers "https://github.com/tsavou/boldy/tree/main/app/Http/Controllers/"
    click Models "https://github.com/tsavou/boldy/tree/main/app/Models/"
    click Policies "https://github.com/tsavou/boldy/tree/main/app/Policies/"
    click Requests "https://github.com/tsavou/boldy/tree/main/app/Http/Requests/"
    click Migrations "https://github.com/tsavou/boldy/tree/main/database/migrations/"
    click Factories "https://github.com/tsavou/boldy/tree/main/database/factories/"
    click Seeders "https://github.com/tsavou/boldy/tree/main/database/seeders/"
    click FileStorage "https://github.com/tsavou/boldy/tree/main/storage/app/public/"
    click CacheSession "https://github.com/tsavou/boldy/blob/main/config/cache.php"
    click Stripe "https://github.com/tsavou/boldy/blob/main/config/stripe.php"
    click MailPit "https://github.com/tsavou/boldy/blob/main/config/mail.php"
    click LaravelCloud "https://github.com/tsavou/boldy/blob/main/docker-compose.yml"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#004085
    classDef backend fill:#d4edda,stroke:#155724
    classDef datastore fill:#fff3cd,stroke:#856404
    classDef external fill:#f5c6cb,stroke:#721c24
```
