---
# Laravel Vuexy Admin para México
**Laravel Vuexy Admin para México** es un proyecto basado en Laravel optimizado para necesidades específicas del mercado mexicano. Incluye integración con los catálogos del SAT (CFDI 4.0), herramientas avanzadas y una interfaz moderna inspirada en el template premium Vuexy.
## Características destacadas
- **Optimización para México**:
- Uso de los catálogos oficiales del SAT (versión CFDI 4.0):
- Banco (`sat_banco`)
- Clave de Producto o Servicio (`sat_clave_prod_serv`)
- Clave de Unidad (`sat_clave_unidad`)
- Forma de Pago (`sat_forma_pago`)
- Moneda (`sat_moneda`)
- Código Postal (`sat_codigo_postal`)
- Régimen Fiscal (`sat_regimen_fiscal`)
- País (`sat_pais`)
- Uso CFDI (`sat_uso_cfdi`)
- Colonia (`sat_colonia`)
- Estado (`sat_estado`)
- Localidad (`sat_localidad`)
- Municipio (`sat_municipio`)
- Deducción (`sat_deduccion`)
- Percepción (`sat_percepcion`)
- Compatible con los lineamientos y formatos del Anexo 20 del SAT.
- Útil para generar comprobantes fiscales digitales (CFDI) y otros procesos administrativos locales.
- **Otras características avanzadas**:
- Autenticación y gestión de usuarios con Laravel Fortify.
- Gestión de roles y permisos usando Spatie Permission.
- Tablas dinámicas con Laravel Datatables y Yajra.
- Integración con Redis para caching eficiente.
- Exportación y manejo de Excel mediante Maatwebsite.
## Requisitos del Sistema
- **PHP**: >= 8.2
- **Composer**: >= 2.0
- **Node.js**: >= 16.x
- **MySQL** o cualquier base de datos compatible con Laravel.
---
## Instalación
Este proyecto ofrece dos métodos de instalación: mediante Composer o manualmente. A continuación, te explicamos ambos procesos.
### Opción 1: Usar Composer (Recomendado)
Para instalar el proyecto rápidamente usando Composer, ejecuta el siguiente comando:
```bash
composer create-project koneko/laravel-vuexy-admin
```
Este comando realizará automáticamente los siguientes pasos:
1. Configurará el archivo `.env` basado en `.env.example`.
2. Generará la clave de la aplicación.
Una vez completado, debes configurar una base de datos válida en el archivo `.env` y luego ejecutar:
```bash
php artisan migrate --seed
```
Finalmente, compila los activos iniciales:
```bash
npm install
npm run dev
```
Inicia el servidor local con:
```bash
php artisan serve
```
---
### Opción 2: Instalación manual
Si prefieres instalar el proyecto de forma manual, sigue estos pasos:
1. Clona el repositorio:
```bash
git clone https://git.koneko.mx/Koneko-ST/laravel-vuexy-admin.git
cd laravel-vuexy-admin
```
2. Instala las dependencias de Composer:
```bash
composer install
```
3. Instala las dependencias de npm:
```bash
npm install
```
4. Configura las variables de entorno:
```bash
cp .env.example .env
```
5. Configura una base de datos válida en el archivo `.env`.
6. Genera la clave de la aplicación:
```bash
php artisan key:generate
```
7. Migra y llena la base de datos:
```bash
php artisan migrate --seed
```
8. Compila los activos frontend:
```bash
npm run dev
```
9. Inicia el servidor de desarrollo:
```bash
php artisan serve
```
---
## Notas importantes
- Asegúrate de tener instalado:
- **PHP**: >= 8.2
- **Composer**: >= 2.0
- **Node.js**: >= 16.x
- Este proyecto utiliza los catálogos SAT de la versión CFDI 4.0. Si deseas más información, visita la documentación oficial del SAT en [Anexo 20](http://omawww.sat.gob.mx/tramitesyservicios/Paginas/anexo_20.htm).
---
## Uso del Template Vuexy
Este proyecto está diseñado para funcionar con el template premium [Vuexy](https://themeforest.net/item/vuexy-vuejs-html-laravel-admin-dashboard-template/23328599). Para utilizarlo:
1. Adquiere una licencia válida de Vuexy en [ThemeForest](https://themeforest.net/item/vuexy-vuejs-html-laravel-admin-dashboard-template/23328599).
2. Incluye los archivos necesarios en las carpetas correspondientes (`resources`, `public`, etc.) de este proyecto.
---
## Créditos
Este proyecto utiliza herramientas y recursos de código abierto, así como un template premium. Queremos agradecer a los desarrolladores y diseñadores que hacen posible esta implementación:
- [Laravel](https://laravel.com)
- [Vuexy Template](https://themeforest.net/item/vuexy-vuejs-html-laravel-admin-dashboard-template/23328599)
- [Spatie Permission](https://spatie.be/docs/laravel-permission)
- [Yajra Datatables](https://yajrabox.com/docs/laravel-datatables)
---
## Licencia
Este proyecto está licenciado bajo la licencia MIT. Consulta el archivo [LICENSE](LICENSE) para más detalles.
El template "Vuexy" debe adquirirse por separado y está sujeto a su propia licencia comercial.
---
Hecho con ❤️ por Koneko Soluciones Tecnológicas