# 🎓 TUTORIAL PASO A PASO - IMPORTAR DEPORTISTAS

## Paso 1️⃣: Acceder al Sistema

1. Abre tu navegador
2. Ve a: `http://localhost/admin/importar-deportistas` (o tu dominio)
3. Si no estás logueado, inicia sesión como administrador

**Resultado esperado:** Verás el formulario de importación

---

## Paso 2️⃣: Descargar Plantilla (Opcional pero Recomendado)

1. Haz clic en el botón **"Descargar Plantilla"** (arriba a la derecha)
2. Se descargará un archivo `plantilla_deportistas_YYYY-MM-DD.csv`
3. Guárdalo en tu computadora

**¿Por qué descargarla?**
- Asegura que tengas el formato correcto
- Evita errores de estructura
- Facilita la organización de datos

---

## Paso 3️⃣: Preparar los Datos

### Opción A: Usar la plantilla descargada

1. Abre la plantilla con Excel o un editor de texto (Notepad++)
2. Completa las columnas con los datos de los deportistas:

| Campo | Ejemplo |
|-------|---------|
| Nombre Deportista | Juan Carlos García |
| Email Deportista | juan.carlos@email.com |
| Fecha Nacimiento | 15/06/2010 |
| Género | Masculino |
| Nombre Acudiente | María García López |
| Email Acudiente | maria.garcia@email.com |
| Teléfono Acudiente | 3001234567 |
| Relación Acudiente | Madre |

3. Agrega tantas filas como deportistas necesites

### Opción B: Crear el archivo desde cero

Crea un archivo CSV (con punto y coma como separador) con este formato:

```
Nombre Deportista;Email Deportista;Fecha Nacimiento (DD/MM/YYYY);Género (Masculino/Femenino);Nombre Acudiente;Email Acudiente;Teléfono Acudiente;Relación Acudiente
Juan Carlos;juan@email.com;15/06/2010;Masculino;María García;maria@email.com;3001234567;Madre
Sofia Martínez;sofia@email.com;22/05/2012;Femenino;Pedro Martínez;pedro@email.com;3009876543;Padre
```

### ⚠️ Reglas Importantes

✅ **Nombres:** Máximo 255 caracteres
✅ **Emails:** Deben ser válidos y únicos (no repetidos)
✅ **Fechas:** Formato DD/MM/YYYY (día/mes/año)
✅ **Género:** Exactamente "Masculino" o "Femenino"
✅ **Teléfono:** Opcional, máximo 20 caracteres
✅ **Relación:** Padre, Madre, Tío, Abuelo, etc.

❌ **No hacer:**
- Dejar campos requeridos vacíos
- Usar formatos de fecha diferentes
- Espacio en blanco al inicio/final de campos
- Emails duplicados
- Género diferente a Masculino/Femenino

---

## Paso 4️⃣: Guardar el Archivo

1. Guarda el archivo con extensión **.csv** o **.xlsx**
   - En Excel: Archivo → Guardar Como → Formato CSV (Delimitado por comas)
   - En Notepad: Archivo → Guardar Como → `miarchivo.csv`

2. Ubicación recomendada: Tu carpeta de Descargas

**Ejemplo:** `deportistas_enero_2026.csv`

---

## Paso 5️⃣: Subir el Archivo

1. Vuelve a la pantalla de importación
2. Haz clic en **"Seleccionar archivo"**
3. Busca y selecciona tu archivo CSV o Excel
4. Verás un mensaje: "✓ Archivo seleccionado: [nombre]"
5. Haz clic en el botón **"Importar"**

**Lo que pasa:**
- Se mostrará un indicador de progreso
- El sistema procesará cada fila
- Esto puede tardar algunos segundos (depende de la cantidad)

---

## Paso 6️⃣: Revisar Resultados

### Si TODO salió bien ✅

Verás:
- **Filas Procesadas:** Número de filas leídas
- **Importados Exitosamente:** Deportistas registrados ✓
- **Errores:** 0

**Acciones:**
- Haz clic en **"Importar más deportistas"** para subir otro archivo
- Haz clic en **"Ver todos los deportistas"** para ver la lista
- Haz clic en **"Volver al Dashboard"** para ir al inicio

### Si hay errores ⚠️

Verás una tabla con los errores encontrados:

| Ejemplo de Error | Solución |
|------------------|----------|
| Fila 2: Email del deportista inválido | Verifica el formato del email (debe tener @) |
| Fila 3: El email del deportista ya está registrado | Usa un email diferente |
| Fila 4: Formato de fecha inválido. Use DD/MM/YYYY | Cambia la fecha a día/mes/año |
| Fila 5: Género debe ser "Masculino" o "Femenino" | Escribe exactamente esos valores |

**Qué hacer con los errores:**
1. Nota el número de la fila
2. Abre tu archivo CSV
3. Corrije el error en esa fila
4. Vuelve a subir el archivo

---

## Paso 7️⃣: Verificar en el Sistema

1. Ve a **Admin → Matrículas → Ver Deportistas**
2. Busca a los deportistas que acabas de importar
3. Verifica que los datos sean correctos

---

## 🔍 Verificación Rápida

Después de importar, comprueba que:

✅ Los deportistas aparecen en la lista de matrículas
✅ Los acudientes están vinculados correctamente
✅ Las fechas de nacimiento son correctas
✅ Los correos están activos

---

## 📱 Ejemplo Completo Paso a Paso

### Datos a importar (3 deportistas):

```
Nombre Deportista;Email Deportista;Fecha Nacimiento (DD/MM/YYYY);Género (Masculino/Femenino);Nombre Acudiente;Email Acudiente;Teléfono Acudiente;Relación Acudiente
Carlos Rodríguez;carlos.rodriguez@email.com;10/05/2010;Masculino;Ana Rodríguez;ana.rodriguez@email.com;3001234567;Madre
Lucia Fernández;lucia.fernandez@email.com;20/08/2011;Femenino;José Fernández;jose.fernandez@email.com;3009876543;Padre
Miguel López;miguel.lopez@email.com;15/03/2012;Masculino;Rosa López;rosa.lopez@email.com;3005551234;Madre
```

### Pasos:
1. Copia el texto anterior
2. Abre Notepad o Excel
3. Pega el texto
4. Guarda como `deportistas.csv`
5. Ve a `/admin/importar-deportistas`
6. Selecciona el archivo
7. Haz clic en Importar
8. ¡Listo! 3 deportistas importados

---

## ❓ Preguntas Frecuentes

**P: ¿Puedo editar los datos después de importar?**
→ Sí, ve a la lista de deportistas y edita cada uno individualmente

**P: ¿Puedo importar fotos?**
→ No en esta versión, pero puedes agregarlas después manualmente

**P: ¿Qué pasa si importo el mismo archivo dos veces?**
→ Fallará porque los emails ya estarán registrados

**P: ¿Puedo importar solo acudientes?**
→ No, los acudientes se crean automáticamente con los deportistas

**P: ¿Cuál es la contraseña inicial de los usuarios?**
→ password123 (deben cambiarla en el primer acceso)

**P: ¿Qué pasa si un acudiente es el de varios deportistas?**
→ El sistema lo reutiliza automáticamente (por email)

**P: ¿Hay límite de deportistas por importación?**
→ No, pero máximo 5MB de archivo

---

## ⚡ Consejos Útiles

💡 **Usa Excel si no te sientes cómodo con CSV**
- Excel es más visual y fácil de revisar
- El sistema lo leerá correctamente

💡 **Valida los datos antes de importar**
- Busca duplicados de emails
- Revisa que las fechas sean válidas
- Verifica que no haya espacios extra

💡 **Importa en pequeños lotes**
- 50-100 deportistas por archivo es lo ideal
- Facilita encontrar errores si los hay

💡 **Crea una plantilla maestra**
- Una vez que descargues la plantilla, cópiala
- Úsala como base para futuras importaciones

---

## 🆘 Solución de Problemas

### Problema: "El archivo debe ser Excel, CSV o TXT"
→ Guarda el archivo con extensión .csv o .xlsx

### Problema: "No se seleccionó ningún archivo"
→ Haz clic en "Seleccionar archivo" y elige uno

### Problema: "El archivo no debe exceder 5MB"
→ Divide el archivo en partes más pequeñas

### Problema: "El email del deportista ya está registrado"
→ Ese email ya existe. Usa uno diferente

### Problema: "La fila se vería vacía"
→ Segúramente no hay datos o están mal formateados

---

## ✅ Checklist Final

Antes de importar, verifica:

- [ ] El archivo está en formato CSV o Excel
- [ ] La primera fila tiene los encabezados
- [ ] Los emails son válidos (con @)
- [ ] Los emails no están repetidos
- [ ] Las fechas están en formato DD/MM/YYYY
- [ ] El género es "Masculino" o "Femenino"
- [ ] No hay espacios al inicio/final de campos
- [ ] El archivo no excede 5MB

---

## 🎉 ¡Listo!

¡Ya sabes cómo importar deportistas! 

**Siguiente paso:** Ve a `/admin/importar-deportistas` y comienza a importar deportistas.

---

**¿Necesitas ayuda?** 
Revisa la documentación en:
- `GUIA_IMPORTACION_DEPORTISTAS.md` - Completa
- `ACCESO_RAPIDO_IMPORTACION.md` - Referencia rápida