# 🎨 Laravel Vuexy Admin
---
## 📌 Descripción
**Laravel Vuexy Admin** es un módulo de administración optimizado para México, basado en Laravel 11 y diseñado para integrarse con **Vuexy Admin Template**. Incluye gestión avanzada de usuarios, roles, permisos y auditoría de acciones.
### ✨ Características
- 🔹 Sistema de autenticación con Laravel Fortify.
- 🔹 Gestión avanzada de usuarios con Livewire.
- 🔹 Control de roles y permisos con Spatie Permissions.
- 🔹 Auditoría de acciones con Laravel Auditing.
- 🔹 Publicación de configuraciones y vistas.
- 🔹 Soporte para cache y optimización de rendimiento.
---
## 📦 Instalación
Instalar vía **Composer**:
```bash
composer require koneko/laravel-vuexy-admin
```
Publicar archivos de configuración y migraciones:
```bash
php artisan vendor:publish --tag=vuexy-admin-config
php artisan migrate
```
---
## 🚀 Uso básico
```php
use Koneko\VuexyAdmin\Models\User;
$user = User::create([
'name' => 'Juan Pérez',
'email' => 'juan@example.com',
'password' => bcrypt('secret'),
]);
```
---
## 📚 Configuración adicional
Si necesitas personalizar la configuración del módulo, publica el archivo de configuración:
```bash
php artisan vendor:publish --tag=vuexy-admin-config
```
Esto generará `config/vuexy_menu.php`, donde puedes modificar valores predeterminados.
---
## 🛠 Dependencias
Este paquete requiere las siguientes dependencias:
- Laravel 11
- `laravel/fortify` (autenticación)
- `spatie/laravel-permission` (gestión de roles y permisos)
- `owen-it/laravel-auditing` (auditoría de usuarios)
- `livewire/livewire` (interfaz dinámica)
---
## 📦 Publicación de Assets y Configuraciones
Para publicar configuraciones y seeders:
```bash
php artisan vendor:publish --tag=vuexy-admin-config
php artisan vendor:publish --tag=vuexy-admin-seeders
php artisan migrate --seed
```
Para publicar imágenes del tema:
```bash
php artisan vendor:publish --tag=vuexy-admin-images
```
---
## 🌍 Repositorio Principal y Sincronización
Este repositorio es una **copia sincronizada** del repositorio principal alojado en **[Tea - Koneko Git](https://git.koneko.mx/koneko/laravel-vuexy-admin)**.
### 🔄 Sincronización con GitHub
- **Repositorio Principal:** [git.koneko.mx](https://git.koneko.mx/koneko/laravel-vuexy-admin)
- **Repositorio en GitHub:** [github.com/koneko-mx/laravel-vuexy-admin](https://github.com/koneko-mx/laravel-vuexy-admin)
- **Los cambios pueden reflejarse primero en Tea antes de GitHub.**
### 🤝 Contribuciones
Si deseas contribuir:
1. Puedes abrir un **Issue** en [GitHub Issues](https://github.com/koneko-mx/laravel-vuexy-admin/issues).
2. Para Pull Requests, **preferimos contribuciones en Tea**. Contacta a `admin@koneko.mx` para solicitar acceso.
⚠️ **Nota:** Algunos cambios pueden tardar en reflejarse en GitHub, ya que este repositorio se actualiza automáticamente desde Tea.
---
## 🏅 Licencia
Este paquete es de código abierto bajo la licencia [MIT](LICENSE).
---
Hecho con ❤️ por Koneko Soluciones Tecnológicas