# 📦 Guía de Instalación Rápida - iTartanas

## 🎉 ¡La aplicación está lista!

El proyecto se ha compilado exitosamente. Tienes dos versiones de APK disponibles:

---

## 📱 APKs Generados

### 1️⃣ APK Debug (Desarrollo)
```
📍 Ubicación:
app\build\outputs\apk\debug\app-debug.apk

✅ Ideal para: Desarrollo y pruebas
✅ Tamaño: ~5-10 MB
✅ Firma: Debug keystore
```

### 2️⃣ APK Release (Producción)
```
📍 Ubicación:
app\build\outputs\apk\release\app-release-unsigned.apk

⚠️ Nota: Sin firmar (necesita firma para distribución pública)
✅ Ideal para: Uso personal
✅ Tamaño: ~5-10 MB (optimizado)
```

---

## 🚀 Instalación en Dispositivo Android

### Método 1: Transferencia Manual (Recomendado)

1. **Copia el APK** a tu dispositivo Android:
   - Por cable USB
   - Por Google Drive / Dropbox
   - Por correo electrónico
   - Por Bluetooth

2. **En tu dispositivo Android**:
   - Abre el **Explorador de Archivos**
   - Navega a la ubicación del APK
   - Toca el archivo `app-debug.apk`

3. **Permite instalación**:
   - Si es la primera vez: Ve a **Configuración** → **Seguridad**
   - Activa **"Fuentes desconocidas"** o **"Instalar apps desconocidas"**
   - Vuelve y toca el APK de nuevo

4. **Instala**:
   - Toca **"Instalar"**
   - Espera a que termine
   - Toca **"Abrir"**

### Método 2: Desde Android Studio

1. Conecta tu dispositivo Android por USB
2. En Android Studio, haz clic en **"Run"** (▶️)
3. Selecciona tu dispositivo
4. La app se instalará automáticamente

### Método 3: ADB (Para desarrolladores)

```bash
# Desde la raíz del proyecto
adb install app\build\outputs\apk\debug\app-debug.apk
```

---

## ✅ Verificación Post-Instalación

Después de instalar, verifica que:

1. ✅ El icono de **iTartanas** aparece en el cajón de aplicaciones
2. ✅ Al abrir, muestra la pantalla de "Lector de Tarjeta Millennium"
3. ✅ Tu dispositivo tiene **NFC activado**:
   - Ve a **Configuración** → **Conexiones** → **NFC**
   - Activa el interruptor

---

## 🧪 Primera Prueba

1. Abre la aplicación **iTartanas**
2. Verás la pantalla de instrucciones
3. Acerca tu **Tarjeta Millennium** al lector NFC
4. En 1-2 segundos verás:
   - ✅ Número de tarjeta (enmascarado)
   - ✅ Saldo actual
   - ✅ Últimos 3 movimientos

---

## 📍 Ubicación del Lector NFC

El lector NFC suele estar en la **parte trasera** del teléfono:

```
   ┌─────────────┐
   │             │
   │   [Cámara]  │ ← Cerca de aquí
   │             │
   │     NFC     │ ← Zona NFC
   │             │
   │             │
   └─────────────┘
```

**Tip**: Prueba moviendo la tarjeta lentamente por la parte trasera hasta que la app responda.

---

## ⚠️ Solución de Problemas Comunes

### "No se puede instalar la aplicación"
**Solución**: Activa la instalación de fuentes desconocidas en Configuración

### "Este dispositivo no tiene NFC"
**Solución**: Verifica que tu dispositivo tiene hardware NFC (busca en las especificaciones)

### "Por favor, activa el NFC"
**Solución**: Ve a Configuración → Conexiones → NFC y actívalo

### "Error al leer la tarjeta"
**Soluciones**:
- Mantén la tarjeta estable 2 segundos
- Limpia la tarjeta y el teléfono
- Quita la funda del teléfono si es metálica
- Intenta en otra zona del teléfono

---

## 🔄 Actualización de la App

Para actualizar a una nueva versión:

1. Desinstala la versión anterior (opcional)
2. Instala el nuevo APK
3. O simplemente instala sobre la versión existente

**Nota**: Como la app no guarda datos, no perderás información.

---

## 📊 Información del Build

```
✅ Estado: BUILD SUCCESSFUL
✅ Tareas ejecutadas: 95
✅ Errores: 0
✅ Warnings: 0 críticos
✅ Tiempo de compilación: ~1-2 minutos
```

---

## 🎯 Funcionalidades Disponibles

Una vez instalada, podrás:

1. ✅ **Leer número de tarjeta** - En formato seguro y enmascarado
2. ✅ **Consultar saldo** - En tiempo real desde el chip NFC
3. ✅ **Ver últimos 3 movimientos** con:
   - Fecha y hora exacta
   - Tipo de operación (Carga/Validación)
   - Importe de la operación
   - Ubicación o línea del transporte

---

## 📱 Requisitos del Dispositivo

Para usar iTartanas necesitas:

- ✅ **Android 7.0** o superior (API 24+)
- ✅ **Hardware NFC** en el dispositivo
- ✅ **NFC activado** en configuración
- ✅ **Tarjeta Millennium** válida

---

## 🔒 Privacidad

La aplicación:
- ✅ **NO** requiere conexión a Internet
- ✅ **NO** guarda tus datos
- ✅ **NO** envía información a servidores
- ✅ **Solo lee** la información pública del chip NFC
- ✅ **No puede modificar** el saldo o datos

---

## 📞 ¿Necesitas Ayuda?

Consulta estos documentos en el proyecto:

1. **README.md** - Documentación técnica completa
2. **INSTALLATION_GUIDE.md** - Guía detallada de uso
3. **CHANGELOG.md** - Cambios y características
4. **RESUMEN.md** - Resumen ejecutivo del proyecto

---

## 🎊 ¡Listo para Usar!

Tu aplicación **iTartanas** está completamente funcional y lista para leer tu Tarjeta Millennium.

**¡Disfruta de la app!** 🚇🚌🚋

---

**Última actualización**: 9 de Marzo, 2026  
**Versión**: 1.0  
**Build**: SUCCESSFUL ✅