# 🚀 GUÍA RÁPIDA DE INICIO

## ⚡ 5 Pasos para Poner en Marcha

### PASO 1: Crear Base de Datos
```sql
mysql -u root -p

CREATE DATABASE vampire_ChaturbateStats CHARACTER SET utf8mb4;
```

### PASO 2: Importar Esquemas
```bash
mysql -u vampire_stats -p vampire_ChaturbateStats < schema.sql
mysql -u vampire_stats -p vampire_ChaturbateStats < schema-studios.sql
```

### PASO 3: Configurar Credenciales
Editar `php/config.php`:
```php
define('DB_USER', 'vampire_stats');
define('DB_PASS', 'tu_password_aqui');
define('DB_NAME', 'vampire_ChaturbateStats');
```

### PASO 4: Subir a Servidor
```bash
scp -r /home/claude/chaturbate-stats username@tudominio.com:public_html/
```

### PASO 5: Acceder
```
https://tudominio.com/chaturbate-stats/pages/search.php
```

---

## 📍 RUTAS PRINCIPALES

| Función | URL |
|---------|-----|
| 🔍 Buscar Modelos | `/pages/search.php` |
| 📡 Monitoreo Real-Time | `/pages/realtime.php` |
| 🏢 Gestión Studios | `/pages/studios.php` |

---

## 🎯 WORKFLOW TÍPICO

```
1. BUSCAR MODELO
   ↓
2. CREAR STUDIO
   ↓
3. AGREGAR MODELO AL STUDIO
   ↓
4. REGISTRAR GANANCIAS (en tokens)
   ↓
5. GENERAR NÓMINA
   ↓
6. VER CÁLCULOS:
   - Tokens × $0.05 = USD
   - USD × Tasa COP = Total COP
   - Total COP × % Comisión = Corte Studio
   - Total COP - Corte = Pago Modelo
   ↓
7. APROBAR Y MARCAR COMO PAGADA
```

---

## 💰 CÁLCULO AUTOMÁTICO

### Ejemplo Real:
```
Modelo: Rosa
Tokens ganados: 800
Tasa: $3,900 COP
Comisión studio: 40%

CÁLCULO:
├─ 800 tokens × $0.05 = $40 USD
├─ $40 × $3,900 = $156,000 COP (Total)
├─ $156,000 × 40% = $62,400 (Comisión Studio)
└─ $156,000 - $62,400 = $93,600 (Pago Rosa)
```

---

## 📊 FUNCIONALIDADES POR PÁGINA

### 🔍 SEARCH.PHP
✅ Buscar modelo por username
✅ Ver información completa
✅ Gráficos de viewers
✅ Agregar a monitoreo

### 📡 REALTIME.PHP
✅ Monitorear múltiples modelos
✅ Ver estado en tiempo real
✅ Actualizar cada 30 segundos
✅ Filtrar por estado
✅ Buscar modelos

### 🏢 STUDIOS.PHP
```
Tab Studios:
  ✅ Crear nuevo studio
  ✅ Ver comisión
  ✅ Ver cantidad de modelos

Tab Modelos:
  ✅ Agregar modelo al studio
  ✅ Ver estado del modelo
  ✅ Comisión por modelo
  ✅ Remover modelo

Tab Ganancias:
  ✅ Registrar tokens ganados
  ✅ Ver histórico
  ✅ Filtrar por fecha
  ✅ Ver USD y COP

Tab Nómina:
  ✅ Generar nómina automática
  ✅ Ver todos los cálculos
  ✅ Detalles por modelo
  ✅ Aprobar nómina
  ✅ Marcar como pagada

Tab Tasa:
  ✅ Ver tasa actual
  ✅ Actualizar tasa USD→COP
```

---

## 🔌 API ENDPOINTS

### Búsqueda
```
POST /php/handlers-api.php?action=search
username=rosa
→ Retorna: datos modelo
```

### Agregar Modelo
```
POST /php/handlers-studios.php?action=add_model
studio_id=1
username=rosa
stage_name=Rosa
→ Retorna: success
```

### Registrar Ganancias
```
POST /php/handlers-studios.php?action=log_earning
studio_model_id=5
tokens=800
date=2026-07-01
→ Retorna: success
```

### Generar Nómina
```
POST /php/handlers-studios.php?action=generate_payroll
studio_id=1
period_start=2026-07-01
period_end=2026-07-31
→ Retorna: totales, detalles, payroll_id
```

---

## 📈 TABLA DE MODELOS DE EJEMPLO

| Usuario | Studio | Comisión | Estado | Tokens Mes |
|---------|--------|----------|--------|-----------|
| rosa | Mi Studio | 40% | Online | 2,500 |
| karla | Mi Studio | 40% | Offline | 1,800 |
| sofia | Studio 2 | 35% | Online | 3,200 |

---

## 💵 NÓMINA EJEMPLO (Mes Julio)

**Studio: "Mi Studio" - Comisión 40%**

| Modelo | Tokens | USD | COP | Comisión | Pago |
|--------|--------|-----|-----|----------|------|
| Rosa | 2,500 | $125 | $487,500 | $195,000 | $292,500 |
| Karla | 1,800 | $90 | $351,000 | $140,400 | $210,600 |
| **TOTAL** | **4,300** | **$215** | **$838,500** | **$335,400** | **$503,100** |

---

## 🔐 ARCHIVOS IMPORTANTES

```
✅ php/config.php           → Credenciales BD
✅ php/handlers-api.php    → API Chaturbate
✅ php/handlers-studios.php → Lógica nómina
✅ schema.sql              → Tabla modelos
✅ schema-studios.sql      → Tablas studio/nómina
```

---

## ⚠️ CHECKLIST PRE-PRODUCCIÓN

- [ ] Credenciales DB correctas
- [ ] Bases de datos creadas
- [ ] .htaccess protege carpeta php/
- [ ] HTTPS habilitado
- [ ] Backup automático BD configurado
- [ ] Tasa de cambio actualizada
- [ ] Comisión studio configura
- [ ] Modelos agregados al studio

---

## 📱 ACCESO MÓVIL

Sistema completamente responsive:
- ✅ Búsqueda en móvil
- ✅ Monitoreo en tablets
- ✅ Nómina en teléfono
- ✅ Interfaz touch-friendly

---

## 🆘 ERRORES COMUNES

**Error: "Database connection error"**
→ Verificar `php/config.php` credenciales

**Error: "Model not found"**
→ Username no existe o está baneado

**Nómina muestra $0**
→ No hay ganancias registradas en el período

**Gráficos no cargan**
→ Verificar que Chart.js está incluido

---

## 📞 AYUDA RÁPIDA

Si algo no funciona:
1. Abre consola del navegador (F12)
2. Mira si hay errores en JavaScript
3. Revisa `error_log` de Apache
4. Verifica credenciales en `config.php`
5. Comprueba que BD tiene tablas

---

## 🎓 PRÓXIMOS PASOS

1. Familiarizarte con interfaz
2. Crear primer studio
3. Agregar primer modelo
4. Registrar ganancias de prueba
5. Generar primera nómina
6. Exportar/imprimir reporte

---

**¡Listo para usar! 🚀**

Cualquier pregunta, revisa el README.md completo.