START_SCRIPT_README.md

# 🚀 Melodix - Script de Inicio Automático

## 📁 Archivos Creados

| Archivo | Propósito |
|---------|-----------|
| `start_services.bat` | Script principal para Windows (CMD) |
| `start_services.ps1` | Script alternativo para PowerShell |
| `QUICK_START.md` | Documentación rápida |

---

## ⚡ Uso Rápido

### Iniciar Todo

**Doble clic** en `start_services.bat`

O desde consola:
```bash
cd c:\mfmm
start_services.bat
```

---

## 🎯 Qué Hace el Script

### Paso 1: Verificar Redis ✅
- Comprueba que Redis esté corriendo
- Si no, muestra instrucciones para iniciarlo

### Paso 2: Verificar Entorno ✅
- Valida que el entorno virtual exista
- Verifica FFmpeg (opcional)

### Paso 3: Mostrar Red ✅
- Obtiene tu IP local automáticamente
- Muestra URLs de acceso

### Paso 4: Iniciar API ✅
- Lanza FastAPI en puerto 8000
- Espera a que esté disponible
- Abre ventana "API Melodix"

### Paso 5: Iniciar Celery ✅
- Lanza worker de procesamiento
- Usa GPU para acelerar
- Abre ventana "Worker Celery"

### Paso 6: Túnel Cloudflare ❓
- Pregunta si deseas iniciarlo
- Opcional (recomendado para acceso remoto)
- Abre ventana "Tunel Cloudflare"

---

## 🖥️ Ventanas que se Abren

```
┌─────────────────────────────────────────┐
│  API Melodix                            │
│  - FastAPI en puerto 8000               │
│  - No cerrar mientras uses la app       │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────┐
│  Worker Celery (GPU)                    │
│  - Procesamiento de audio con IA        │
│  - Usa tu GPU para acelerar             │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────┐
│  Tunel Cloudflare                       │
│  - Expone tu API a internet             │
│  - Opcional, solo si necesitas acceso   │
│    remoto                               │
└─────────────────────────────────────────┘
```

---

## 🔧 Comandos Disponibles

### Iniciar Servicios
```bash
start_services.bat
```

### Detener Servicios
```bash
start_services.bat stop
```

### Ver Ayuda
```bash
start_services.bat help
```

---

## 📱 URLs Después de Iniciar

El script te mostrará:

```
IP Local: 192.168.1.10

URLs de acceso:
- Local:    http://localhost:8000
- Red:      http://192.168.1.10:8000
- Swagger:  http://localhost:8000/docs
```

---

## ✅ Checklist de Verificación

Después de ejecutar el script:

- [ ] Ventana "API Melodix" está abierta
- [ ] Ventana "Worker Celery" está abierta
- [ ] Ventana "Tunel Cloudflare" (si elegiste sí)
- [ ] Puedes acceder a http://localhost:8000/health
- [ ] Redis está corriendo (verificó el script)

---

## 🐛 Problemas Comunes

### "Redis NO está corriendo"

**Solución:**
```bash
redis-server
```

O inicia el servicio de Windows:
```bash
net start Redis
```

---

### "Ya hay algo corriendo en el puerto 8000"

**Opción A:** Detener el otro servicio
```bash
start_services.bat stop
```

**Opción B:** Matar proceso
```bash
netstat -ano | findstr :8000
taskkill /F /PID <NUMERO>
```

---

### "La API no respondió"

1. Revisa la ventana "API Melodix" por errores
2. Verifica logs: `logs\api.log`
3. Prueba manualmente: http://localhost:8000/health

---

## 📊 Flujo Completo

```
1. Ejecutar start_services.bat
   ↓
2. Script verifica Redis
   ↓
3. Script verifica entorno Python
   ↓
4. Script muestra IP local
   ↓
5. Inicia API FastAPI (ventana 1)
   ↓
6. Inicia Worker Celery (ventana 2)
   ↓
7. Pregunta por Cloudflare (ventana 3 opcional)
   ↓
8. ¡LISTO! Sistema operativo
```

---

## 🛑 Para Detener

### Método Recomendado
```bash
start_services.bat stop
```

### Método Manual
Cierra las 3 ventanas de consola

---

## 💡 Tips Pro

### 1. Acceso desde Android

1. Ejecuta `start_services.bat`
2. Anota la IP que muestra (ej: 192.168.1.10)
3. En tu Android, usa: `http://192.168.1.10:8000`

### 2. Acceso Remoto (Cloudflare)

1. Ejecuta `start_services.bat`
2. Responde "Y" cuando pregunte por Cloudflare
3. Espera a que se genere la URL en `tunnel_url.txt`
4. Usa esa URL desde cualquier lugar del mundo

### 3. Monitoreo

```bash
# Ver logs en tiempo real (PowerShell)
Get-Content logs\melodix.log -Wait -Tail 50

# Ver logs de API
Get-Content logs\api.log -Wait -Tail 50

# Ver logs de Celery
Get-Content logs\celery.log -Wait -Tail 50
```

### 4. Inicio Automático con Windows

Crea un acceso directo en la carpeta de Inicio:

1. `Win + R` → `shell:startup`
2. Crea acceso directo a `start_services.bat`
3. Edita el acceso directo → Propiedades
4. En "Ejecutar" selecciona: "Minimizada"

---

## 📝 Estructura de Archivos

```
c:\mfmm\
├── start_services.bat      # Script principal
├── start_services.ps1      # Script PowerShell
├── QUICK_START.md          # Guía rápida
├── logs\
│   ├── api.log            # Logs de API
│   ├── celery.log         # Logs de Celery
│   └── melodix.log        # Logs generales
└── tunnel_url.txt         # URL de Cloudflare (se crea al iniciar túnel)
```

---

## 🎯 Próximos Pasos

Después de iniciar los servicios:

1. **Verifica que la API responde:**
   ```bash
   curl http://localhost:8000/health
   ```

2. **Abre Swagger UI:**
   ```
   http://localhost:8000/docs
   ```

3. **Prueba la app MAUI:**
   - Abre Visual Studio
   - Compila y ejecuta Melodix
   - Inicia sesión y prueba

4. **Conecta desde Android:**
   - Mismo WiFi
   - Usa IP local mostrada por el script

---

**¡Todo listo! Tu servidor Melodix está operativo 🎵**