README

Paquete para Laravel 10+ / 11+ / 12+ que permite generar módulos API completamente estructurados y autodescubribles (rutas, migraciones, providers, etc.), sin necesidad de vistas o rutas web.
Ideal para proyectos orientados 100% a APIs REST modulares.

🚀 Características

• Genera módulos API con estructura limpia (php artisan moduleapi:make User)
• Autoregistro de:
  • Rutas API (routes/api.php)
  • Migraciones
  • Configs
  • Traducciones
  • Providers personalizados
• Sin dependencias de vistas ni rutas web
• Compatible con PHP 8+ y Laravel 10–12
• Ligero y totalmente desacoplado

📦 Instalación

composer require rpvirtual/laravel-api-module

Laravel detectará automáticamente el ServiceProvider mediante Package Discovery.

Si deseas registrarlo manualmente, agrégalo en config/app.php:

'providers' => [
    Rpvirtual\LaravelApiModule\LaravelApiModuleServiceProvider::class,
],

⚙️ Inicializar el paquete

Antes de crear cualquier módulo, ejecuta:

php artisan moduleapi:install

Este comando:

• Crea la carpeta Modules/ en la raíz del proyecto
• Configura automáticamente el autoload de Composer para que los módulos sean reconocidos

🛠️ Crear un módulo API

Módulo básico:

php artisan moduleapi:make NombreModulo

Módulo con CRUD completo:

php artisan moduleapi:make NombreModulo --resource

Opciones:

• --force → Sobrescribe archivos existentes

📂 Estructura de un módulo

Ejemplo para un módulo User con CRUD completo:

Modules/
└── User/
    ├── app/
    │   ├── Controllers/UserController.php
    │   ├── Models/User.php
    │   ├── Services/UserService.php
    │   ├── Traits/UserModelTrait.php
    │   └── Providers/UserServiceProvider.php
    ├── database/
    │   ├── migrations/
    │   ├── seeders/
    │   └── factories/
    ├── routes/api.php
    ├── config/config.php
    └── tests/
        ├── Feature/UserControllerTest.php
        └── Unit/UserServiceTest.php


---

📝 Comandos disponibles

🔖 Licencia

MIT