PHPackages makroz/director-laravel - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Admin Panels](/categories/admin) 4. / 5. makroz/director-laravel ActiveLibrary[Admin Panels](/categories/admin) makroz/director-laravel ======================= MK-Director: Laravel Core Framework for rapid application development. Admin module scaffolding with MME (MVC Modular Encapsulated) structure. Part of the @makroz/\* suite. v1.8.0(4w ago)041↓50%proprietaryHTMLPHP ^8.4 Since Jun 12Pushed 6d agoCompare [ Source](https://github.com/makroz/mk-director-laravel)[ Packagist](https://packagist.org/packages/makroz/director-laravel)[ RSS](/packages/makroz-director-laravel/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependencies (13)Versions (110)Used By (0) makroz/director-laravel ======================= [](#makrozdirector-laravel) > **Part of the [@makroz/\* suite](https://github.com/makroz/MK-Director)** — Laravel 13+ core framework for rapid application development with MME (MVC Modular Encapsulated) structure. [![Packagist](https://camo.githubusercontent.com/f245c720ff6717aedd49521d95a4f251a832c3ce57f042143c5423461d99adf2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d616b726f7a2f6469726563746f722d6c61726176656c)](https://packagist.org/packages/makroz/director-laravel)[![License](https://camo.githubusercontent.com/794347bec64bb06501658552e564c604e66704bed88f4fcd473a7d4847e40054/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d70726f70726965746172792d626c75652e737667)](LICENSE)[![PHP](https://camo.githubusercontent.com/8954266cf3bb41de3961bc203636a79d9ab4299cf0d15590042cf148ae556fc6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342d626c75652e737667)](https://php.net)[![Laravel](https://camo.githubusercontent.com/e21705b122464126356e6d7ab91532e4067ae57cb05b04535dbcdbe240fe2909/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31332d7265642e737667)](https://laravel.com) El motor de backend de MK-Director. Ofrece una capa de abstracción potente para APIs CRUD con estructura MME nativa (cada módulo es autocontenido y se comunica solo vía API pública). > 📖 **[Guía Completa del Desarrollador](DEVELOPER_GUIDE.md)**: Instalación, Configuración, CRUD, ListManager, Plugins y MME. Características Core -------------------- [](#características-core) - **Model & Builder**: Soporte nativo para `cacheGet()`, `cacheFirst()` y `cacheFind()`. - **Auto-Cache Plugin**: Flushing automático de tags de cache al detectar operaciones de escritura en la DB. - **Magic CRUD (SmartController)**: ABM declarativo extendiendo `Mk\Director\Controllers\SmartController` y configurando `$mkConfig`. Los plugins (`MkAuditLoggerPlugin`, `MkMultiTenantPlugin`) hookan automáticamente. El scaffolder `mk:module` lo genera por default. **`CRUDSmart::show/update/destroy` aceptan `string|int $id`** (v1.6.0-rc6) para soporte nativo de consumers con `HasUuids`. **`HasRoles::pivotExtras()` / `HasAbilities::abilityPivotExtras()` ahora son `public`** (v1.6.0-rc7) — el Repository scaffoldeado los consume directamente sin hardcodear el FQCN de la pivot polimórfica. - **RBAC scaffolder (`mk:module --with-rbac`)**: genera un trío RBAC completo (User + Role + Ability + 2 pivots con FK + 3 Policies + RbacService + ServiceProvider con Gate bindings) en un solo comando. Por-módulo, scope-aislated. Ver [DEVELOPER\_GUIDE.md § 3.5](DEVELOPER_GUIDE.md#-35-scaffolding-modules-with-rbac---with-rbac). - **Auth-user scaffolder (`mk:make:auth-user`)**: scope de autenticación autocontenido con `AuthUser`, `AuthController`, tokens Sanctum. Soporta `--login-field=`, `--with-auth-rbac`, `--profile-fields=` (con tipos custom y constraint `unique` vía prefijo `!`), `--verify-email`, y `--with-crud` (CRUD completo + RBAC triada + DDD artifacts en una corrida). Ver [DEVELOPER\_GUIDE.md § 3.6-3.13](DEVELOPER_GUIDE.md). - **Single-level envelope response shape (R-PKG-024 v1.7.0 GA — OBLIGATORIO)**: `BaseController::sendResponse()` SIEMPRE emite `{success, message, data, __extraData, debugMsg}` con `data` como array directo de items (NO paginator nested) y `__extraData` como **sibling top-level de `data`**. Forma canónica que matchea `@makroz/core` `MkResponse` y que consume `@makroz/web` `useMkList` + `@makroz/mobile` `useMkInfiniteList`. **PROHIBIDO `data.data` en cualquier endpoint, scaffolder, stub o DTO**. El flag opt-in `mk_director.response.top_level_extra_data` (rc12) está **ELIMINADO** post-v1.7.0. Auditoría con `php artisan mk:status --response-shape` (reporte `error` post-GA, no warning). Para paginadores, `BaseController::extractPaginationMetadata()` emite snake\_case keys (`current_page`, `last_page`, `per_page`, `total`, `has_more_pages` para LengthAwarePaginator; `per_page`, `next_cursor`, `prev_cursor` para CursorPaginator) en `__extraData.pagination` agrupado (R-PKG-032 v1.8.0 — ver bullet siguiente). - **Pagination envelope grouping (R-PKG-032 v1.8.0 MAJOR — OBLIGATORIO)**: post-v1.8.0, las 5 (LengthAwarePaginator) / 3 (CursorPaginator) snake\_case keys de paginación se agrupan bajo `__extraData.pagination` (NO flat al top-level). Custom keys del consumer (`audit_checked`, `request_id`, etc.) siguen planas en `__extraData` — el grouping es SOLO para el contrato del paquete. **BC break clean** sin flag opt-in (siguiendo política R-PKG-024). Consumers en v1.7.x que lean `response.__extraData.last_page` flat deben migrar a `response.__extraData.pagination.last_page` (1 línea). Ver `docs/UPGRADE_1.7_1.8.md` para migration guide completo. - **Auto-discover abilities seguro con `php artisan serve` (R-PKG-031 BUG-NEW-auto-discover-serve v1.7.1+)**: `MK_AUTO_DISCOVER_ABILITIES=true` ya NO bricked dev servers con HTTP 500 `Call to undefined function DiscoverAbilitiesCommand()`. El boot hook ahora skipa cuando `$_SERVER['argv']` incluye long-running CLI contexts (`serve`, `octane:start`, `horizon`, `queue:work|listen`, `schedule:work|run`) + usa `Artisan::call('mk:discover-abilities', [...])` en lugar del malformed `$this->app->call(Class, params)`. Se puede pinear el flag con seguridad en sandbox/dev. - **RETO fase 14 feedback fixes (v1.8.1-rc0 — acumula al lote RELEASE\_AT\_END)**: 6 hallazgos pineados como fixes aditivos/BC-safe. (a) **`Schema::hasTable()` guard pre-`Artisan::call()` en auto-discover** (HALLAZGO-NEW-FASE14-01) — testing con `RefreshDatabase` ya NO rompe con `RuntimeException: Ninguna tabla de abilities existe`. (b) **`\Auth::forgetGuards()` post-logout** (HALLAZGO-NEW-FASE14-03) — testing Pest/PHPUnit ya NO cachea el user en el guard entre requests del mismo test. (c) Tabla `__extraData` opt-in para paginators en `DEVELOPER_GUIDE.md §1.4` (HALLAZGO-NEW-FASE14-02). (d) REST conventions DELETE 200+body en `§1.5` (HALLAZGO-NEW-FASE14-04). (e) Models per-scope vs globales en `§1.6` (HALLAZGO-NEW-FASE14-05). (f) `canMk()` vs `can()` vs `hasAbility()` en `§3.8.3` (HALLAZGO-NEW-FASE14-06). Sin cross-stack changes — `@makroz/core/web/mobile` NO requieren update. - **Refresh + reset + forgot implementación completa** (v1.6.0-rc4): `RefreshTokenParser` (Sanctum v4 `id|plaintext`), `TokenIssuer::rotateRefreshToken()` con defense-in-depth contra escalación de scope, persistencia en `{scope}_password_reset_tokens`. - **List & Search Managers**: Parsing de strings complejos para búsquedas relacionales y joins dinámicos. - **MME (MVC Modular Encapsulated)**: ModuleLoader auto-registra módulos, comunicación inter-módulo solo vía API pública. - **Auth + RBAC**: Sistema completo con abilities, roles, scopes y middleware `MkAbility`. Instalación ----------- [](#instalación) ``` composer require makroz/director-laravel ``` Publica la configuración y migraciones: ``` php artisan vendor:publish --tag=mk-config php artisan vendor:publish --tag=mk-migrations php artisan migrate ``` Comandos Artisan ---------------- [](#comandos-artisan) ComandoDescripción`php artisan mk:module {Name}`Scaffolding de módulo CRUD estándar (Controller, Model, Service, Repository, DTO, etc.).`php artisan mk:module {Name} --with-rbac`Scaffolding de módulo **con trío RBAC completo** (User + Role + Ability + 2 pivots + 3 Policies + RbacService + ServiceProvider con Gate bindings). Genera 20 archivos. **Nuevo en v1.5.0**.`php artisan mk:discover-abilities {--module=*} {--force}`Auto-pobla `{scope}_abilities` desde el provider del módulo (preferred), atributos PHP 8.4 (`#[\Mk\Director\Auth\Attributes\Ability]`), o docblock (`@mk-ability`). UPSERT idempotente. **Nuevo en v1.5.0-rc2**.`php artisan mk:make:auth-user {Scope}`Scaffolding de scope de autenticación con `AuthUser`, `AuthController`, tokens Sanctum.`php artisan mk:make:auth-user {Scope} --login-field=`Variante con campo de login configurable (default `email`). Casos: `ci` (Bolivia), `phone`, `username`, `documento`. **Nuevo en v1.5.0-rc3**.`php artisan mk:make:auth-user {Scope} --with-auth-rbac`Variante con RBAC integration: ability checks en `/me` y `/logout`, rate limit en `/login`/`/forgot`/`/reset`, audit events vía `AuthEvent`. Default BC: idéntico a v1.5.0-rc3 sin flag. **Nuevo en v1.5.0-rc4**.`php artisan mk:make:auth-user {Scope} --profile-fields=name,dni,phone`Variante con columnas adicionales para el scope (per-scope, no compartidas). Cada field se expone vía `GET /me`, `PATCH /me` y `POST /register`. Ortogonal con `--login-field` y `--with-auth-rbac`. **Nuevo en v1.5.0-rc5**.`php artisan mk:make:auth-user {Scope} --profile-fields=name:string,birthdate:date,age:int`Extensión con tipos custom: cada field puede ser `string`, `text`, `int`, `decimal`, `bool`, `date`, `datetime` o `json`. Sintaxis `key:type` (sin `:` = `string`, BC). Ortogonal con `--login-field`, `--with-auth-rbac` y `--verify-email`. **Nuevo en v1.6.0-rc1**.`php artisan mk:make:auth-user {Scope} --profile-fields-required=name,email`Override del validation default `nullable` a `required` para profile fields específicos. Default BC: todos los profile fields son nullable (consistente con migration `-->`). **Nuevo en v1.6.0-rc4** (BUG-03 fix).`php artisan mk:make:auth-user {Scope} --profile-fields=name,!ci,phone`Prefijo `!` marca el field como `unique` en la migration (`!ci` → `$table->string('ci')->unique()->nullable()`). Ortogonal con `--profile-fields-types`. **Nuevo en v1.6.0-rc4** (BUG-09 fix).`php artisan mk:make:auth-user {Scope} --with-crud`Genera CRUD completo del scope + RBAC triada: `AdminController` + `RoleController` + `AbilityController` (SmartController) + 4 FormRequests + 3 JsonResources + 2 DTOs readonly + Repository + Interface + Service + Factory DDD + Seeder con 4 roles predefinidos. ServiceProvider extendido con binding. **Nuevo en v1.6.0-rc4** (MEJORA-02) — **hardened en v1.6.0-rc5** (R-PKG-015 BUG-NEW-05/06 fixes: import statements en routes, FK overrides en el modelo).`php artisan mk:fix:sanctum-uuids`Parchea automáticamente la migration `create_personal_access_tokens_table` cambiando `$table->morphs('tokenable')` por `$table->uuidMorphs('tokenable')`. Necesario cuando el consumer usa `HasUuids` en sus modelos `AuthUser`. Idempotente. Soporta `--dry-run`. **Nuevo en v1.6.0-rc5** (R-PKG-015 BUG-NEW-09).`php artisan mk:make:auth-user {Scope} --verify-email`Variante con verificación por email: columna `email_verified_at`, endpoints `/email/verify/{id}/{hash}` (signed URL) y `/email/resend`, dispatch de `Illuminate\Auth\Notifications\VerifyEmail` en `/register`. Default BC: idéntico a v1.5.0-rc4 sin flag. Solo aplica si `--login-field=email`. **Nuevo en v1.5.0-rc5**.`php artisan mk:auth:create-super-admin --roles=super-admin,admin,editor,viewer`Siembra los 4 roles predefinidos con abilities específicas (`*`, CRUD completo, view+update, view-only) en una sola corrida. Default BC: solo super-admin. **Nuevo en v1.6.0-rc4** (MEJORA-04). Soporta `--name="..."` flag y fallback chain que autogenera `name` del email local-part en modo `--no-interaction` (v1.6.0-rc6).`php artisan mk:lint:boundaries`Linter de R-MK-001: detecta imports cross-module en código de apps que usan el paquete. Required CI check.`php artisan mk:discover-abilities`Auto-descubre abilities de las Policies de un módulo y las inserta en la tabla `{scope}_abilities`. Companion de `--with-rbac`.`php artisan mk:security-lint`Auditoría de seguridad: secrets, RBAC, tenant isolation, etc.Configuración ------------- [](#configuración) Habilita features en `config/mk_director.php`: ``` 'features' => [ 'auto_cache' => true, 'dynamic_joins' => true, 'mme_enforcement' => true, ], ``` Stack ----- [](#stack) - PHP 8.4+ (PHP 8.5-clean: `MkBelongsToMany::from()` y accessors de `HasTenantScope` no emiten deprecation warnings) - Laravel 13+ - Illuminate components (Support, Database, HTTP) Ecosistema @makroz/\* --------------------- [](#ecosistema-makroz) PackageDescription[`@makroz/core`](https://www.npmjs.com/package/@makroz/core)Tipos compartidos y validadores cross-stack[`@makroz/web`](https://www.npmjs.com/package/@makroz/web)Next.js 16 + shadcn/ui module layer[`@makroz/mobile`](https://www.npmjs.com/package/@makroz/mobile)Expo SDK 56 + expo-router 6 module layer`makroz/director-laravel` (este)Laravel 13 backend con MME`create-makroz-director`CLI para scaffolding de apps nuevasLicencia -------- [](#licencia) Proprietary — © Mario Guzmán. Ver [LICENSE](LICENSE) si está disponible. ### Health Score 49 — FairBetter than 94% of packages Maintenance97 Actively maintained with recent releases Popularity11 Limited adoption so far Community6 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 37 Last Release 29d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/594039?v=4)[Mario Gzman](/maintainers/Makroz)[@makroz](https://github.com/makroz) --- Top Contributors [![mariogfos](https://avatars.githubusercontent.com/u/162817645?v=4)](https://github.com/mariogfos "mariogfos (209 commits)") --- Tags laravelscaffoldingadminmodularmk-directorMME ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/makroz-director-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/makroz-director-laravel/health.svg)](https://phpackages.com/packages/makroz-director-laravel) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3345.3M348](/packages/psalm-plugin-laravel)[api-platform/laravel API Platform support for Laravel 58174.6k17](/packages/api-platform-laravel)[simplestats-io/laravel-client Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof. 5022.6k](/packages/simplestats-io-laravel-client) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)