# Mariachis Serenatas Admin

Plataforma Laravel para administrar la operacion de mariachis y serenatas:
clientes, cotizaciones, paquetes, grupos, pagos, rutas, externos cedidos y paneles
separados para administracion y propietarios.

## Identidad del proyecto

- Carpeta local recomendada: `mariachis-serenatas-admin`
- Repositorio recomendado: `mariachis-serenatas-admin`
- Nombre funcional: `Mariachis Serenatas Admin`
- Nombre visible actual en app: `Mariachis`

## Stack

- Laravel 12
- PHP 8.2
- MySQL
- Vite
- Vuexy assets + JavaScript modular

## Modulos principales

- Panel admin
- Panel propietario
- Serenatas y detalle operativo
- Cotizador
- Planificador de rutas
- Clientes
- Pagos y reembolsos
- Externos cedidos y movimientos
- Catalogos por grupo mariachi

## Desarrollo local

```bash
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
yarn install
yarn dev
```

Build local:

```bash
yarn build
```

## Reglas del repositorio

- Si se versiona: codigo fuente, migraciones, vistas, configuracion ejemplo, assets fuente y documentacion.
- No se versiona: `.env`, dumps SQL, ZIPs de respaldo, caches compiladas, logs y `package-lock.json`.
- El proyecto usa `yarn.lock` como lockfile principal.

## Documentacion

- `docs/ANALISIS_PROYECTO.md`
- `docs/API_INTEGRACION_SERENATAS.md`
- `docs/DEPLOY_SERVIDOR.md`
- `docs/RESPALDOS.md`

## Backups

Para generar copia de codigo y base de datos:

```bash
./scripts/create_backup_bundle.sh
```

El resultado se guarda en `storage/app/backups/`.
