laravel-vuexy-admin-old/README.md

# 🎨 Laravel Vuexy Admin

<p align="center">
    <a href="https://koneko.mx" target="_blank"> <img src="https://git.koneko.mx/Koneko-ST/koneko-st/raw/branch/main/logo-images/horizontal-05.png" width="400" alt="Koneko Soluciones Tecnológicas Logo"> </a> 
</p>
<p align="center">
    <a href="https://koneko.mx"><img src="https://img.shields.io/badge/Website-koneko.mx-blue" alt="Sitio Web"></a> 
    <a href="https://packagist.org/packages/koneko/laravel-vuexy-admin"><img src="https://img.shields.io/packagist/v/koneko/laravel-vuexy-admin" alt="Latest Stable Version"></a>
    <a href="https://packagist.org/packages/koneko/laravel-vuexy-admin"><img src="https://img.shields.io/packagist/l/koneko/laravel-vuexy-admin" alt="License"></a>
    <a href="https://git.koneko.mx/koneko"><img src="https://img.shields.io/badge/Git%20Server-Koneko%20Git-orange" alt="Servidor Git"></a> 
    <a href="https://github.com/koneko-mx/laravel-vuexy-admin/actions/workflows/tests.yml"><img src="https://github.com/koneko-mx/laravel-vuexy-admin/actions/workflows/tests.yml/badge.svg" alt="Build Status"></a> 
    <a href="https://github.com/koneko-mx/laravel-vuexy-admin/issues"><img src="https://img.shields.io/github/issues/koneko/laravel-vuexy-admin" alt="Issues"></a> 
</p>

---

## 📌 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).

---


<p align="center">
    Hecho con ❤️ por <a href="https://koneko.mx">Koneko Soluciones Tecnológicas</a>
</p>