# nick0221/breedliker-v2 architecture

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

- Interactive diagram: https://gitdiagram.com/nick0221/breedliker-v2
- Repository: https://github.com/nick0221/breedliker-v2

## Overview

##### Project type and purpose
- This is a full-stack monolithic Laravel 11 web application (“Breed Liker V2 WebApp”) that lets registered users browse and like dog breeds, manage profiles, and handle authentication (login, two-factor, API tokens).
- It uses Laravel Fortify for auth, Jetstream for user scaffolding, Livewire for dynamic UI, and MySQL (or another relational DB) for persistence.

##### File structure
- Top-level directories reflect the standard Laravel pattern:
- app/ – core code (Models, HTTP Controllers, Livewire components, Fortify/Jetstream Actions)
- config/ – environment-agnostic settings (auth, cache, database, mail, queue, services)
- database/ – migrations, factories, seeders
- public/ – entry-point (index.php) and static assets
- resources/ – front-end assets (CSS/JS via Vite), Blade views, Livewire templates, markdown policy/terms
- routes/ – web.php (HTML pages), api.php (token/API endpoints), console.php (artisan commands)
- storage/ – file caches, sessions, logs
- tests/ – feature & unit tests
- Build and deployment configs: composer.json, package.json, vite.config.js, artisan, .env.example

##### README for additional insights
- Confirms Laravel 11, PHP 8.2+
- Usage flow: clone, composer install, migrate, serve

##### Detailed breakdown
- User registration/login → Fortify Actions → users table
- Livewire DogBreeds component → dog_preferences table
- Personal_access_tokens management → Sanctum (config/sanctum.php)
- Email flows (password reset, verification) via Mail service
- Queue worker processing (jobs table or Redis)

## Diagram (Mermaid)

```mermaid
flowchart TD
  subgraph "Frontend Layer"
    Browser["Browser"]:::frontend
    Vite["Vite & Tailwind Build"]:::frontend
    LivewireView["Livewire View"]:::frontend
  end

  subgraph "Backend Layer"
    WebServer["Web Server (Nginx/Apache + PHP-FPM)"]:::backend

    subgraph "Routing Layer"
      WebRoutes["Web Routes"]:::backend
      ApiRoutes["API Routes"]:::backend
      ConsoleRoutes["Console Routes"]:::backend
    end

    subgraph "Controllers & Components"
      BaseController["Base Controller"]:::backend
      UserController["UserController"]:::backend
      LivewireComp["Livewire Component"]:::backend
    end

    subgraph "Fortify Actions"
      CreateNewUser["CreateNewUser"]:::backend
      ResetUserPassword["ResetUserPassword"]:::backend
      UpdateUserPassword["UpdateUserPassword"]:::backend
      UpdateUserProfileInformation["UpdateUserProfileInformation"]:::backend
      PasswordValidationRules["PasswordValidationRules"]:::backend
    end

    subgraph "Jetstream Actions"
      DeleteUser["DeleteUser"]:::backend
    end

    subgraph "Service Providers"
      AppProvider["AppServiceProvider"]:::backend
      FortifyProvider["FortifyServiceProvider"]:::backend
      JetstreamProvider["JetstreamServiceProvider"]:::backend
    end

    subgraph "Models"
      UserModel["User Model"]:::backend
      DogPrefModel["DogPreference Model"]:::backend
    end
  end

  subgraph "Data Layer"
    DB["Relational DB"]:::datastore
    Cache["Cache Store"]:::datastore
    Queue["Queue Store"]:::datastore
  end

  subgraph "External Services"
    Mail["Mail Service"]:::external
    Storage["Storage Service"]:::external
  end

  %% Relationships
  Browser -->|HTTPS Requests| WebServer
  Browser -->|AJAX/Livewire| LivewireComp
  Browser -->|Fetch Assets| Vite

  WebServer --> WebRoutes
  WebServer --> ApiRoutes
  WebServer --> ConsoleRoutes

  WebRoutes --> BaseController
  WebRoutes --> UserController
  ApiRoutes --> BaseController
  LivewireComp --> BaseController

  BaseController --> CreateNewUser
  BaseController --> ResetUserPassword
  BaseController --> UpdateUserPassword
  BaseController --> UpdateUserProfileInformation
  BaseController --> PasswordValidationRules
  BaseController --> DeleteUser

  CreateNewUser --> UserModel
  ResetUserPassword --> UserModel
  UpdateUserPassword --> UserModel
  UpdateUserProfileInformation --> UserModel
  DeleteUser --> UserModel

  LivewireComp --> DogPrefModel

  UserModel --> DB
  DogPrefModel --> DB
  BaseController --> DB

  BaseController -->|dispatch jobs| Queue
  Queue -->|process jobs| BaseController

  BaseController -->|cache| Cache
  BaseController -->|retrieve cache| Cache

  CreateNewUser -->|send email| Mail
  ResetUserPassword -->|send email| Mail

  BaseController -->|store files| Storage

  %% Click Events
  click WebRoutes "https://github.com/nick0221/breedliker-v2/blob/master/routes/web.php"
  click ApiRoutes "https://github.com/nick0221/breedliker-v2/blob/master/routes/api.php"
  click ConsoleRoutes "https://github.com/nick0221/breedliker-v2/blob/master/routes/console.php"
  click BaseController "https://github.com/nick0221/breedliker-v2/blob/master/app/Http/Controllers/Controller.php"
  click UserController "https://github.com/nick0221/breedliker-v2/blob/master/app/Http/Controllers/UserController.php"
  click LivewireComp "https://github.com/nick0221/breedliker-v2/blob/master/app/Livewire/DogBreeds.php"
  click LivewireView "https://github.com/nick0221/breedliker-v2/blob/master/resources/views/livewire/dog-breeds.blade.php"
  click CreateNewUser "https://github.com/nick0221/breedliker-v2/blob/master/app/Actions/Fortify/CreateNewUser.php"
  click ResetUserPassword "https://github.com/nick0221/breedliker-v2/blob/master/app/Actions/Fortify/ResetUserPassword.php"
  click UpdateUserPassword "https://github.com/nick0221/breedliker-v2/blob/master/app/Actions/Fortify/UpdateUserPassword.php"
  click UpdateUserProfileInformation "https://github.com/nick0221/breedliker-v2/blob/master/app/Actions/Fortify/UpdateUserProfileInformation.php"
  click PasswordValidationRules "https://github.com/nick0221/breedliker-v2/blob/master/app/Actions/Fortify/PasswordValidationRules.php"
  click DeleteUser "https://github.com/nick0221/breedliker-v2/blob/master/app/Actions/Jetstream/DeleteUser.php"
  click AppProvider "https://github.com/nick0221/breedliker-v2/blob/master/app/Providers/AppServiceProvider.php"
  click FortifyProvider "https://github.com/nick0221/breedliker-v2/blob/master/app/Providers/FortifyServiceProvider.php"
  click JetstreamProvider "https://github.com/nick0221/breedliker-v2/blob/master/app/Providers/JetstreamServiceProvider.php"
  click UserModel "https://github.com/nick0221/breedliker-v2/blob/master/app/Models/User.php"
  click DogPrefModel "https://github.com/nick0221/breedliker-v2/blob/master/app/Models/DogPreference.php"

  %% Styles
  classDef frontend fill:#e0f7fa,stroke:#006064,color:#006064
  classDef backend fill:#e8f5e9,stroke:#2e7d32,color:#2e7d32
  classDef datastore fill:#fff3e0,stroke:#ef6c00,color:#e65100
  classDef external fill:#eceff1,stroke:#607d8b,color:#455a64
```
