# laymont/patternrepositorylaravel architecture

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

- Interactive diagram: https://gitdiagram.com/laymont/patternrepositorylaravel
- Repository: https://github.com/laymont/patternrepositorylaravel

## Overview

Laravel Pattern Repository provides repository abstractions over Eloquent, with CRUD, querying, pagination, criteria, scopes, caching, and atomic CRUD actions. The principal workflow is an application caller using a repository to query or mutate model-backed records; a secondary capability generates repository classes and interfaces through Artisan. The graph includes the legacy abstract repository and package registration/factory. Relationships for unsampled action and generator internals are limited to what the README or excerpts establish.

Main entry points: [`src/Repositories/EloquentRepository.php`](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Repositories/EloquentRepository.php) (Eloquent Repository), [`src/AbstractRepository.php`](https://github.com/laymont/patternrepositorylaravel/blob/main/src/AbstractRepository.php) (Legacy Repository), [`src/Concerns/CacheableRepository.php`](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Concerns/CacheableRepository.php) (Repository Cache), [`src/Console/Providers/ConsoleServiceProvider.php`](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Console/Providers/ConsoleServiceProvider.php) (Console Provider)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_repository["Repository Runtime"]
  node_eloquent_repo["Eloquent Repository"]
  node_abstract_repo["Legacy Repository"]
  node_repo_contract["Repository Contract"]
  node_read_contract["Readable Contract"]
  node_write_contract["Writable Contract"]
  node_create_action["Create Action<br/>[CreateAction.php]"]
  node_update_action["Update Action<br/>[UpdateAction.php]"]
  node_delete_action["Delete Action<br/>[DeleteAction.php]"]
  node_exception["Repository Errors"]
end

subgraph group_query["Query Features"]
  node_criteria_trait["Criteria Application<br/>[HasCriteria.php]"]
  node_criteria_contract["Criteria Contract"]
  node_equals_criteria["Equals Criteria"]
  node_like_criteria["LIKE Search"]
  node_criteria_compat["Criteria Interface Alias"]
  node_pagination["Pagination Limits"]
  node_scopes["Eloquent Scopes"]
  node_cache_repo["Repository Cache"]
  node_cache_trait["Cacheable Trait<br/>[Cacheable.php]"]
end

subgraph group_integration["Laravel Integration"]
  node_config["Package Configuration"]
  node_provider["Package Provider"]
  node_factory["Repository Factory"]
  node_console_provider["Console Provider"]
  node_make_command["Repository Generator"]
  node_enhanced_command["Enhanced Generator"]
end

node_app(("Application Caller"))
node_eloquent[("Eloquent Models")]
node_cache_service[("Laravel Cache")]
node_artisan(("Artisan User"))
node_generated_code["Generated Repositories"]

node_app -->|"uses"| node_eloquent_repo
node_eloquent_repo -->|"implements"| node_repo_contract
node_eloquent_repo -->|"queries and mutates"| node_eloquent
node_abstract_repo -->|"queries and mutates"| node_eloquent
node_app -->|"invokes"| node_create_action
node_app -.->|"invokes"| node_update_action
node_app -.->|"invokes"| node_delete_action
node_create_action -->|"creates atomically"| node_eloquent
node_eloquent_repo -->|"applies criteria"| node_criteria_trait
node_abstract_repo -->|"applies criteria"| node_criteria_trait
node_criteria_trait -->|"calls apply"| node_criteria_contract
node_equals_criteria -->|"implements"| node_criteria_contract
node_like_criteria -->|"implements"| node_criteria_contract
node_app -->|"pushes criteria"| node_equals_criteria
node_eloquent_repo -->|"uses"| node_pagination
node_eloquent_repo -->|"uses"| node_scopes
node_abstract_repo -->|"uses"| node_cache_repo
node_cache_repo -->|"reads settings"| node_config
node_cache_repo -->|"caches results"| node_cache_service
node_provider -->|"registers singleton"| node_factory
node_factory -->|"resolves model"| node_eloquent
node_provider -->|"registers provider"| node_console_provider
node_console_provider -->|"registers command"| node_make_command
node_console_provider -->|"registers command"| node_enhanced_command
node_artisan -.->|"runs generator"| node_make_command
node_artisan -.->|"runs generator"| node_enhanced_command
node_make_command -.->|"generates"| node_generated_code
node_enhanced_command -->|"generates"| node_generated_code

click node_eloquent_repo "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Repositories/EloquentRepository.php"
click node_abstract_repo "https://github.com/laymont/patternrepositorylaravel/blob/main/src/AbstractRepository.php"
click node_repo_contract "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Contracts/RepositoryInterface.php"
click node_read_contract "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Contracts/ReadableRepositoryInterface.php"
click node_write_contract "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Contracts/WritableRepositoryInterface.php"
click node_create_action "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Actions/CreateAction.php"
click node_update_action "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Actions/UpdateAction.php"
click node_delete_action "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Actions/DeleteAction.php"
click node_criteria_trait "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Concerns/HasCriteria.php"
click node_criteria_contract "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Contracts/CriteriaInterface.php"
click node_equals_criteria "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Criteria/WhereEqualsCriteria.php"
click node_like_criteria "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Criteria/SearchWhereLikeCriteria.php"
click node_criteria_compat "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Criteria/CriteriaInterface.php"
click node_pagination "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Concerns/HandlePerPageTrait.php"
click node_scopes "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Concerns/HasEloquentScopes.php"
click node_cache_repo "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Concerns/CacheableRepository.php"
click node_cache_trait "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Concerns/Cacheable.php"
click node_config "https://github.com/laymont/patternrepositorylaravel/blob/main/src/config/pattern-repository.php"
click node_provider "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Providers/PatternRepositoryServiceProvider.php"
click node_factory "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Factories/RepositoryFactory.php"
click node_console_provider "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Console/Providers/ConsoleServiceProvider.php"
click node_make_command "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Console/Commands/MakeRepositoryCommand.php"
click node_enhanced_command "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Console/Commands/EnhancedMakeRepositoryCommand.php"
click node_exception "https://github.com/laymont/patternrepositorylaravel/blob/main/src/Exceptions/RepositoryException.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_eloquent_repo,node_abstract_repo,node_repo_contract,node_read_contract,node_write_contract,node_create_action,node_update_action,node_delete_action,node_exception,node_artisan toneBlue
class node_criteria_trait,node_criteria_contract,node_equals_criteria,node_like_criteria,node_criteria_compat,node_pagination,node_scopes,node_cache_repo,node_cache_trait,node_eloquent,node_cache_service toneAmber
class node_config,node_provider,node_factory,node_console_provider,node_make_command,node_enhanced_command toneMint
class node_app,node_generated_code toneIndigo
```

## Components

### Repository Runtime

- [Eloquent Repository](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Repositories/EloquentRepository.php): `src/Repositories/EloquentRepository.php`
- [Legacy Repository](https://github.com/laymont/patternrepositorylaravel/blob/main/src/AbstractRepository.php): `src/AbstractRepository.php`
- [Repository Contract](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Contracts/RepositoryInterface.php): `src/Contracts/RepositoryInterface.php`
- [Readable Contract](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Contracts/ReadableRepositoryInterface.php): `src/Contracts/ReadableRepositoryInterface.php`
- [Writable Contract](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Contracts/WritableRepositoryInterface.php): `src/Contracts/WritableRepositoryInterface.php`
- [Create Action](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Actions/CreateAction.php): `src/Actions/CreateAction.php`
- [Update Action](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Actions/UpdateAction.php): `src/Actions/UpdateAction.php`
- [Delete Action](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Actions/DeleteAction.php): `src/Actions/DeleteAction.php`
- [Repository Errors](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Exceptions/RepositoryException.php): `src/Exceptions/RepositoryException.php`

### Query Features

- [Criteria Application](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Concerns/HasCriteria.php): `src/Concerns/HasCriteria.php`
- [Criteria Contract](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Contracts/CriteriaInterface.php): `src/Contracts/CriteriaInterface.php`
- [Equals Criteria](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Criteria/WhereEqualsCriteria.php): `src/Criteria/WhereEqualsCriteria.php`
- [LIKE Search](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Criteria/SearchWhereLikeCriteria.php): `src/Criteria/SearchWhereLikeCriteria.php`
- [Criteria Interface Alias](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Criteria/CriteriaInterface.php): `src/Criteria/CriteriaInterface.php`
- [Pagination Limits](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Concerns/HandlePerPageTrait.php): `src/Concerns/HandlePerPageTrait.php`
- [Eloquent Scopes](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Concerns/HasEloquentScopes.php): `src/Concerns/HasEloquentScopes.php`
- [Repository Cache](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Concerns/CacheableRepository.php): `src/Concerns/CacheableRepository.php`
- [Cacheable Trait](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Concerns/Cacheable.php): `src/Concerns/Cacheable.php`

### Laravel Integration

- [Package Configuration](https://github.com/laymont/patternrepositorylaravel/blob/main/src/config/pattern-repository.php): `src/config/pattern-repository.php`
- [Package Provider](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Providers/PatternRepositoryServiceProvider.php): `src/Providers/PatternRepositoryServiceProvider.php`
- [Repository Factory](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Factories/RepositoryFactory.php): `src/Factories/RepositoryFactory.php`
- [Console Provider](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Console/Providers/ConsoleServiceProvider.php): `src/Console/Providers/ConsoleServiceProvider.php`
- [Repository Generator](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Console/Commands/MakeRepositoryCommand.php): `src/Console/Commands/MakeRepositoryCommand.php`
- [Enhanced Generator](https://github.com/laymont/patternrepositorylaravel/blob/main/src/Console/Commands/EnhancedMakeRepositoryCommand.php): `src/Console/Commands/EnhancedMakeRepositoryCommand.php`

### Other components

- **Application Caller**
- **Eloquent Models**
- **Laravel Cache**
- **Artisan User**
- **Generated Repositories**

## Connections

- Application Caller → Eloquent Repository: uses (evidence: `README.md`)
- Eloquent Repository → Repository Contract: implements (evidence: `src/Repositories/EloquentRepository.php`)
- Eloquent Repository → Eloquent Models: queries and mutates (evidence: `src/Repositories/EloquentRepository.php`)
- Legacy Repository → Eloquent Models: queries and mutates (evidence: `src/AbstractRepository.php`)
- Application Caller → Create Action: invokes (evidence: `README.md`)
- Application Caller → Update Action: invokes
- Application Caller → Delete Action: invokes
- Create Action → Eloquent Models: creates atomically (evidence: `README.md`)
- Eloquent Repository → Criteria Application: applies criteria (evidence: `src/Repositories/EloquentRepository.php`)
- Legacy Repository → Criteria Application: applies criteria (evidence: `src/AbstractRepository.php`)
- Criteria Application → Criteria Contract: calls apply (evidence: `src/Concerns/HasCriteria.php`)
- Equals Criteria → Criteria Contract: implements (evidence: `src/Criteria/WhereEqualsCriteria.php`)
- LIKE Search → Criteria Contract: implements (evidence: `src/Criteria/SearchWhereLikeCriteria.php`)
- Application Caller → Equals Criteria: pushes criteria (evidence: `README.md`)
- Eloquent Repository → Pagination Limits: uses (evidence: `src/Repositories/EloquentRepository.php`)
- Eloquent Repository → Eloquent Scopes: uses (evidence: `src/Repositories/EloquentRepository.php`)
- Legacy Repository → Repository Cache: uses (evidence: `src/AbstractRepository.php`)
- Repository Cache → Package Configuration: reads settings (evidence: `src/Concerns/CacheableRepository.php`)
- Repository Cache → Laravel Cache: caches results (evidence: `src/Concerns/CacheableRepository.php`)
- Package Provider → Repository Factory: registers singleton (evidence: `src/Providers/PatternRepositoryServiceProvider.php`)
- Repository Factory → Eloquent Models: resolves model (evidence: `src/Factories/RepositoryFactory.php`)
- Package Provider → Console Provider: registers provider (evidence: `src/Providers/PatternRepositoryServiceProvider.php`)
- Console Provider → Repository Generator: registers command (evidence: `src/Console/Providers/ConsoleServiceProvider.php`)
- Console Provider → Enhanced Generator: registers command (evidence: `src/Console/Providers/ConsoleServiceProvider.php`)
- Artisan User → Repository Generator: runs generator
- Artisan User → Enhanced Generator: runs generator
- Repository Generator → Generated Repositories: generates
- Enhanced Generator → Generated Repositories: generates (evidence: `src/Console/Commands/EnhancedMakeRepositoryCommand.php`)
