# adminarchitect/core architecture

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

- Interactive diagram: https://gitdiagram.com/adminarchitect/core
- Repository: https://github.com/adminarchitect/core

## Overview

Admin Architect is a Laravel administration framework: administrators enter through routed, authenticated admin screens, operate configured resources, and receive rendered lists or forms and CRUD outcomes. Resource behavior is divided among module definitions, query and persistence services, fields, filters, and actions. Separate capabilities include media management, dashboard panels, and translations. The graph uses documented route and provider wiring plus indexed source references; unsampled implementation details and UI-to-server calls are not inferred.

Main entry points: [`src/Controllers/ScaffoldController.php`](https://github.com/adminarchitect/core/blob/2.0/src/Controllers/ScaffoldController.php) (Resource controller), [`src/ArchitectRoutes.php`](https://github.com/adminarchitect/core/blob/2.0/src/ArchitectRoutes.php) (Admin routes), [`src/Controllers/MediaController.php`](https://github.com/adminarchitect/core/blob/2.0/src/Controllers/MediaController.php) (Media controller), [`src/Controllers/AdminController.php`](https://github.com/adminarchitect/core/blob/2.0/src/Controllers/AdminController.php) (Admin controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Admin entry"]
  node_routes["Admin routes"]
  node_admin_controller["Admin controller"]
  node_auth["Authentication<br/>[AuthController.php]"]
  node_middleware["Access middleware"]
end

subgraph group_resources["Resource operations"]
  node_scaffold["Resource controller"]
  node_module["Resource module<br/>[Module.php]"]
  node_finder["Resource queries<br/>[Finder.php]"]
  node_saver["Resource persistence<br/>[Saver.php]"]
  node_fields["Form fields"]
  node_filters["Filters and scopes<br/>[Assembler.php]"]
  node_actions["Resource actions<br/>[ActionsManager.php]"]
end

subgraph group_presentation["Admin interface"]
  node_views["Admin views"]
end

subgraph group_media["Media management"]
  node_media_controller["Media controller"]
  node_media_ui["Media manager UI<br/>[MediaManager.vue]"]
  node_media_api["Media API client<br/>[Api.js]"]
  node_storage[("File storage<br/>[FileStorage.php]")]
end

subgraph group_extensions["Admin extensions"]
  node_dashboard["Dashboard panels<br/>[Manager.php]"]
  node_translations["Translations"]
end

node_admin(("Administrator"))
node_filesystem[("Laravel filesystem")]

node_admin -->|"opens admin"| node_routes
node_routes -->|"routes to"| node_auth
node_routes -->|"routes to"| node_media_controller
node_routes -->|"routes to"| node_scaffold
node_admin_controller -->|"applies"| node_middleware
node_scaffold -->|"resolves resource"| node_module
node_scaffold -->|"queries through"| node_finder
node_scaffold -.->|"persists through"| node_saver
node_scaffold -.->|"renders forms"| node_fields
node_scaffold -.->|"uses filters"| node_filters
node_scaffold -.->|"executes actions"| node_actions
node_admin_controller -->|"authorizes through"| node_module
node_scaffold -.->|"renders"| node_views
node_media_ui -->|"calls client"| node_media_api
node_media_api -.->|"requests media"| node_filesystem
node_media_controller -->|"manages files"| node_storage
node_storage -->|"reads and writes"| node_filesystem
node_media_controller -->|"receives routed requests"| node_routes
node_dashboard -.->|"supplies panels"| node_views
node_translations -.->|"serves admin translations"| node_scaffold

click node_routes "https://github.com/adminarchitect/core/blob/2.0/src/ArchitectRoutes.php"
click node_admin_controller "https://github.com/adminarchitect/core/blob/2.0/src/Controllers/AdminController.php"
click node_auth "https://github.com/adminarchitect/core/blob/2.0/src/Controllers/AuthController.php"
click node_middleware "https://github.com/adminarchitect/core/tree/2.0/src/Middleware"
click node_scaffold "https://github.com/adminarchitect/core/blob/2.0/src/Controllers/ScaffoldController.php"
click node_module "https://github.com/adminarchitect/core/blob/2.0/src/Contracts/Module.php"
click node_finder "https://github.com/adminarchitect/core/blob/2.0/src/Services/Finder.php"
click node_saver "https://github.com/adminarchitect/core/blob/2.0/src/Services/Saver.php"
click node_fields "https://github.com/adminarchitect/core/tree/2.0/src/Field"
click node_filters "https://github.com/adminarchitect/core/blob/2.0/src/Filters/Assembler.php"
click node_actions "https://github.com/adminarchitect/core/blob/2.0/src/ActionsManager.php"
click node_views "https://github.com/adminarchitect/core/tree/2.0/publishes/views"
click node_media_controller "https://github.com/adminarchitect/core/blob/2.0/src/Controllers/MediaController.php"
click node_media_ui "https://github.com/adminarchitect/core/blob/2.0/publishes/mix/resources/js/components/MediaManager.vue"
click node_media_api "https://github.com/adminarchitect/core/blob/2.0/publishes/mix/resources/js/media/Api.js"
click node_storage "https://github.com/adminarchitect/core/blob/2.0/src/Services/FileStorage.php"
click node_dashboard "https://github.com/adminarchitect/core/blob/2.0/src/Dashboard/Manager.php"
click node_translations "https://github.com/adminarchitect/core/blob/2.0/src/Services/TranslationsManager.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_routes,node_admin_controller,node_auth,node_middleware toneBlue
class node_scaffold,node_module,node_finder,node_saver,node_fields,node_filters,node_actions,node_filesystem toneAmber
class node_views toneMint
class node_media_controller,node_media_ui,node_media_api,node_storage toneRose
class node_dashboard,node_translations,node_admin toneIndigo
```

## Components

### Admin entry

- [Admin routes](https://github.com/adminarchitect/core/blob/2.0/src/ArchitectRoutes.php): `src/ArchitectRoutes.php`
- [Admin controller](https://github.com/adminarchitect/core/blob/2.0/src/Controllers/AdminController.php): `src/Controllers/AdminController.php`
- [Authentication](https://github.com/adminarchitect/core/blob/2.0/src/Controllers/AuthController.php): `src/Controllers/AuthController.php`
- [Access middleware](https://github.com/adminarchitect/core/tree/2.0/src/Middleware): `src/Middleware`

### Resource operations

- [Resource controller](https://github.com/adminarchitect/core/blob/2.0/src/Controllers/ScaffoldController.php): `src/Controllers/ScaffoldController.php`
- [Resource module](https://github.com/adminarchitect/core/blob/2.0/src/Contracts/Module.php): `src/Contracts/Module.php`
- [Resource queries](https://github.com/adminarchitect/core/blob/2.0/src/Services/Finder.php): `src/Services/Finder.php`
- [Resource persistence](https://github.com/adminarchitect/core/blob/2.0/src/Services/Saver.php): `src/Services/Saver.php`
- [Form fields](https://github.com/adminarchitect/core/tree/2.0/src/Field): `src/Field`
- [Filters and scopes](https://github.com/adminarchitect/core/blob/2.0/src/Filters/Assembler.php): `src/Filters/Assembler.php`
- [Resource actions](https://github.com/adminarchitect/core/blob/2.0/src/ActionsManager.php): `src/ActionsManager.php`

### Admin interface

- [Admin views](https://github.com/adminarchitect/core/tree/2.0/publishes/views): `publishes/views`

### Media management

- [Media controller](https://github.com/adminarchitect/core/blob/2.0/src/Controllers/MediaController.php): `src/Controllers/MediaController.php`
- [Media manager UI](https://github.com/adminarchitect/core/blob/2.0/publishes/mix/resources/js/components/MediaManager.vue): `publishes/mix/resources/js/components/MediaManager.vue`
- [Media API client](https://github.com/adminarchitect/core/blob/2.0/publishes/mix/resources/js/media/Api.js): `publishes/mix/resources/js/media/Api.js`
- [File storage](https://github.com/adminarchitect/core/blob/2.0/src/Services/FileStorage.php): `src/Services/FileStorage.php`

### Admin extensions

- [Dashboard panels](https://github.com/adminarchitect/core/blob/2.0/src/Dashboard/Manager.php): `src/Dashboard/Manager.php`
- [Translations](https://github.com/adminarchitect/core/blob/2.0/src/Services/TranslationsManager.php): `src/Services/TranslationsManager.php`

### Other components

- **Administrator**
- **Laravel filesystem**

## Connections

- Administrator → Admin routes: opens admin
- Admin routes → Authentication: routes to (evidence: `src/ArchitectRoutes.php`)
- Admin routes → Media controller: routes to (evidence: `src/ArchitectRoutes.php`)
- Admin routes → Resource controller: routes to
- Admin controller → Access middleware: applies (evidence: `src/Controllers/AdminController.php`)
- Resource controller → Resource module: resolves resource (evidence: `src/Controllers/ScaffoldController.php`)
- Resource controller → Resource queries: queries through (evidence: `src/Controllers/ScaffoldController.php`)
- Resource controller → Resource persistence: persists through
- Resource controller → Form fields: renders forms
- Resource controller → Filters and scopes: uses filters
- Resource controller → Resource actions: executes actions
- Admin controller → Resource module: authorizes through (evidence: `src/Controllers/AdminController.php`)
- Resource controller → Admin views: renders
- Media manager UI → Media API client: calls client (evidence: `publishes/mix/resources/js/components/MediaManager.vue`)
- Media API client → Laravel filesystem: requests media
- Media controller → File storage: manages files (evidence: `src/Controllers/MediaController.php`)
- File storage → Laravel filesystem: reads and writes (evidence: `src/Services/FileStorage.php`)
- Media controller → Admin routes: receives routed requests (evidence: `src/ArchitectRoutes.php`)
- Dashboard panels → Admin views: supplies panels
- Translations → Resource controller: serves admin translations
