# franciscopaz199/fp--laravel-full-route architecture

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

- Interactive diagram: https://gitdiagram.com/franciscopaz199/fp--laravel-full-route
- Repository: https://github.com/franciscopaz199/fp--laravel-full-route

## Overview

##### Project type and purpose
- This is a Laravel “FullRoute” package (not a standalone app).
- It extends Laravel’s routing system with OOP route definitions, dynamic hierarchies, breadcrumbs, permission validation, CRUD scaffolding, and a browser UI.

##### File structure
- src/FullRouteServiceProvider.php: Laravel ServiceProvider – entry point.
- src/Contracts: RouteRepositoryInterface, RouteServiceInterface – abstractions.
- src/Services: RouteService (business logic), RouteValidationService, FullRouteInteractive (CLI support).
- src/Commands/FpRouteCommand.php: registers an Artisan command.
- src/Clases: full-route entities (FullRoute, Route, Navbar).
- src/Helpers/CollectionSelector.php & src/routes/FullRoutesLoader.php: load & filter route definitions.
- src/config/*.php: default configs to publish/merge.
- test/: PHPUnit tests for repository and config.

##### README
- Confirms package purpose (custom route management, OOP, validators, breadcrumbs, UI, CRUD generation, tests).
- Shows install via Composer; no runtime UI files in repo but implies integration with Laravel views.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Laravel Core (Blue)
    subgraph "Laravel Core"
        direction TB
        HTTPKernel["HTTP Kernel"]:::core
        Router["Router"]:::core
        ConsoleKernel["Console Kernel"]:::core
        ConfigRepo[(Config Repository)]:::core
    end

    %% FullRoute Package (Green)
    subgraph "FullRoute Package"
        direction TB
        ServiceProvider["FullRouteServiceProvider"]:::package
        subgraph "Contracts"
            direction TB
            RouteRepoInterface["RouteRepositoryInterface"]:::package
            RouteServiceInterface["RouteServiceInterface"]:::package
        end
        subgraph "Services"
            direction TB
            RouteService["RouteService"]:::package
            RouteValidationService["RouteValidationService"]:::package
            FullRouteInteractive["FullRouteInteractive"]:::package
        end
        subgraph "Core Classes"
            direction TB
            FullRoute["FullRoute"]:::package
            RouteClass["Route"]:::package
            Navbar["Navbar"]:::package
        end
        subgraph "Helpers & Loader"
            direction TB
            CollectionSelector["CollectionSelector"]:::package
            FullRoutesLoader["FullRoutesLoader"]:::package
        end
        subgraph "Commands"
            direction TB
            FpRouteCommand["FpRouteCommand"]:::package
        end
    end

    %% Configuration (Orange)
    subgraph "Configuration"
        direction TB
        ConfigRoute[(Route.php)]:::config
        ConfigFullRoute[(fullroute_config.php)]:::config
    end

    %% Tests (Purple)
    subgraph "Tests"
        direction TB
        FileRouteRepositoryTest["FileRouteRepositoryTest"]:::tests
        RouteConfigTest["RouteConfigTest"]:::tests
    end

    %% Relationships
    ServiceProvider -->|"binds"| RouteRepoInterface
    ServiceProvider -->|"binds"| RouteServiceInterface
    ServiceProvider -->|"merges/publishes config"| ConfigRepo
    ServiceProvider -->|"registers commands"| ConsoleKernel
    ServiceProvider -->|"invokes loader"| FullRoutesLoader

    FullRoutesLoader -->|"registers routes"| Router

    HTTPKernel -->|"handles request"| Router
    Router -->|"calls"| RouteService
    RouteService -->|"invokes validation"| RouteValidationService
    RouteValidationService -->|"returns result"| Router
    Router -->|"dispatches to controller/404"| Controller404["Controller or 404"]:::core

    ConsoleKernel -->|"runs"| FpRouteCommand
    FpRouteCommand -->|"executes"| FullRouteInteractive
    FullRouteInteractive -->|"uses"| RouteService
    RouteService -->|"uses repository"| RouteRepoInterface
    RouteRepoInterface ---|"implements"| FileRouteRepositoryTest

    FileRouteRepositoryTest -->|"tests config & behavior"| RouteService
    RouteConfigTest -->|"tests config files"| ConfigRoute

    %% Click Events
    click ServiceProvider "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/FullRouteServiceProvider.php"
    click RouteRepoInterface "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/Contracts/RouteRepositoryInterface.php"
    click RouteServiceInterface "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/Contracts/RouteServiceInterface.php"
    click RouteService "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/Services/RouteService.php"
    click RouteValidationService "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/Services/RouteValidationService.php"
    click FullRouteInteractive "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/Services/FullRouteInteractive.php"
    click FpRouteCommand "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/Commands/FpRouteCommand.php"
    click FullRoute "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/Clases/FullRoute.php"
    click RouteClass "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/Clases/Route.php"
    click Navbar "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/Clases/Navbar.php"
    click CollectionSelector "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/Helpers/CollectionSelector.php"
    click FullRoutesLoader "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/routes/FullRoutesLoader.php"
    click ConfigRoute "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/config/Route.php"
    click ConfigFullRoute "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/src/config/fullroute_config.php"
    click FileRouteRepositoryTest "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/test/FileRouteRepositoryTest.php"
    click RouteConfigTest "https://github.com/franciscopaz199/fp--laravel-full-route/blob/main/test/RouteConfigTest.php"

    %% Styles
    classDef core fill:#cdefff,stroke:#0288d1,stroke-width:1px
    classDef package fill:#d0f0c0,stroke:#2e7d32,stroke-width:1px
    classDef config fill:#ffe0b2,stroke:#ef6c00,stroke-width:1px
    classDef tests fill:#e1bee7,stroke:#8e24aa,stroke-width:1px
```
