limpieza
This commit is contained in:
Pablo
-195
@@ -1,195 +0,0 @@
|
|||||||
# Changelog - iTartanas
|
|
||||||
|
|
||||||
## Versión 1.0 - Implementación Completa
|
|
||||||
|
|
||||||
### 🎉 Funcionalidades Implementadas
|
|
||||||
|
|
||||||
#### ✅ Lectura NFC de Tarjeta Millennium
|
|
||||||
- **Comunicación ISO-DEP**: Implementado el protocolo completo de comunicación con tarjetas Calypso
|
|
||||||
- **Selección de red de transporte**: Comando APDU para inicializar la comunicación
|
|
||||||
- **Lectura de entorno y contrato**: Extracción de datos básicos de la tarjeta
|
|
||||||
- **Lectura de registros de eventos**: Obtención de los últimos 3 movimientos
|
|
||||||
|
|
||||||
#### 💳 Procesamiento de Datos de Tarjeta
|
|
||||||
|
|
||||||
##### Número de Tarjeta
|
|
||||||
- Decodificación BCD (Binary Coded Decimal) a decimal
|
|
||||||
- Conversión de PAN (Primary Account Number) a IEP según aplicación
|
|
||||||
- Cálculo y validación de dígito de verificación Luhn
|
|
||||||
- Enmascaramiento de primeros 8 dígitos por seguridad
|
|
||||||
- Formato visual en grupos de 4 dígitos
|
|
||||||
|
|
||||||
##### Saldo
|
|
||||||
- Lectura desde bytes 29-31 del contrato (3 bytes big-endian)
|
|
||||||
- Conversión de céntimos a euros
|
|
||||||
- Formato con 2 decimales
|
|
||||||
|
|
||||||
##### Últimos Movimientos (NUEVO)
|
|
||||||
- Lectura de registros de eventos (comando READ RECORD)
|
|
||||||
- Parseo de hasta 3 movimientos más recientes
|
|
||||||
- Extracción de información:
|
|
||||||
- **Fecha**: Días desde 01/01/1997 (formato Calypso)
|
|
||||||
- **Hora**: Minutos desde medianoche (convertido a HH:MM)
|
|
||||||
- **Tipo de evento**: Carga, Validación, Operación
|
|
||||||
- **Importe**: En euros (si aplica)
|
|
||||||
- **Ubicación**: Línea o parada (si está disponible)
|
|
||||||
|
|
||||||
#### 🎨 Interfaz de Usuario
|
|
||||||
|
|
||||||
##### Pantalla Principal
|
|
||||||
- Diseño Material 3 con Jetpack Compose
|
|
||||||
- Tema moderno y responsivo
|
|
||||||
- Edge-to-edge UI
|
|
||||||
|
|
||||||
##### Estados de la Aplicación
|
|
||||||
1. **Estado Inicial**: Instrucciones y icono NFC
|
|
||||||
2. **Leyendo**: Indicador de progreso circular
|
|
||||||
3. **Datos Leídos**: Card con toda la información
|
|
||||||
4. **Error**: Card roja con mensaje descriptivo
|
|
||||||
|
|
||||||
##### Visualización de Datos
|
|
||||||
- **Número de tarjeta**: Tipografía destacada, parcialmente enmascarado
|
|
||||||
- **Saldo**: Display prominente en color primario, tamaño grande
|
|
||||||
- **Movimientos**: Lista compacta con diseño tipo timeline
|
|
||||||
- Fecha y hora
|
|
||||||
- Tipo de operación con estilo diferenciado
|
|
||||||
- Importe con código de color (Cargas en azul, Validaciones en gris)
|
|
||||||
- Ubicación/línea cuando está disponible
|
|
||||||
|
|
||||||
#### 🔧 Características Técnicas
|
|
||||||
|
|
||||||
##### Arquitectura
|
|
||||||
- **Patrón Repository**: Separación de lógica de negocio
|
|
||||||
- **Coroutines**: Operaciones asíncronas sin bloqueo
|
|
||||||
- **Compose State Management**: Estado reactivo de UI
|
|
||||||
- **Manejo de errores robusto**: Try-catch en múltiples niveles
|
|
||||||
|
|
||||||
##### Comandos APDU Implementados
|
|
||||||
```
|
|
||||||
SELECT Transport Network: 0x80 0x26 0x4F 0x11 0x0A
|
|
||||||
READ Environment: 0x80 0x32 0x00 0x00 0x18
|
|
||||||
READ Contract: 0x80 0x2E 0x01 0x00 0x20
|
|
||||||
READ Event Log (1-3): 0x80 0x2B 0x0N 0x05 0x1D
|
|
||||||
```
|
|
||||||
|
|
||||||
##### Seguridad y Privacidad
|
|
||||||
- ✅ Sin conexión a Internet
|
|
||||||
- ✅ Sin almacenamiento persistente
|
|
||||||
- ✅ Solo lectura (no puede modificar datos)
|
|
||||||
- ✅ Enmascaramiento de información sensible
|
|
||||||
- ✅ Validación de datos antes de mostrar
|
|
||||||
|
|
||||||
### 📋 Archivos Creados/Modificados
|
|
||||||
|
|
||||||
#### Nuevos Archivos
|
|
||||||
```
|
|
||||||
app/src/main/java/com/pjpmosteiro/itartanas/nfc/
|
|
||||||
└── CardRepositoryImpl.kt (270 líneas)
|
|
||||||
|
|
||||||
app/src/main/res/xml/
|
|
||||||
└── nfc_tech_filter.xml
|
|
||||||
|
|
||||||
docs/
|
|
||||||
├── README.md
|
|
||||||
├── INSTALLATION_GUIDE.md
|
|
||||||
└── CHANGELOG.md (este archivo)
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Archivos Modificados
|
|
||||||
```
|
|
||||||
app/src/main/AndroidManifest.xml
|
|
||||||
- Añadidos permisos NFC
|
|
||||||
- Configurado intent-filter para NFC
|
|
||||||
- Añadido launchMode="singleTop"
|
|
||||||
|
|
||||||
app/src/main/java/com/pjpmosteiro/itartanas/MainActivity.kt
|
|
||||||
- Implementada gestión completa de NFC
|
|
||||||
- Añadida UI de lectura de tarjeta
|
|
||||||
- Implementado componente MovementItem
|
|
||||||
- Gestión de estados (leyendo, éxito, error)
|
|
||||||
```
|
|
||||||
|
|
||||||
### 🛠️ Dependencias
|
|
||||||
|
|
||||||
Todas las dependencias ya estaban presentes:
|
|
||||||
- Kotlin 2.1.0
|
|
||||||
- Jetpack Compose BOM
|
|
||||||
- Material 3
|
|
||||||
- Lifecycle Runtime KTX
|
|
||||||
- Android NFC API (incluida en SDK)
|
|
||||||
|
|
||||||
### ✅ Testing y Calidad
|
|
||||||
|
|
||||||
- ✅ Build exitoso sin errores
|
|
||||||
- ✅ Código sin warnings críticos
|
|
||||||
- ✅ Uso correcto de Locale para formateo
|
|
||||||
- ✅ Manejo apropiado de excepciones
|
|
||||||
- ✅ Compatibilidad con Android 7.0+ (API 24)
|
|
||||||
- ✅ Soporte para Android 13+ (API 33) con APIs actualizadas
|
|
||||||
|
|
||||||
### 📱 Cómo Probar
|
|
||||||
|
|
||||||
1. Compilar e instalar:
|
|
||||||
```bash
|
|
||||||
.\gradlew installDebug
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Abrir la aplicación en un dispositivo con NFC
|
|
||||||
|
|
||||||
3. Acercar una Tarjeta Millennium al lector NFC
|
|
||||||
|
|
||||||
4. Verificar que se muestran:
|
|
||||||
- Número de tarjeta enmascarado
|
|
||||||
- Saldo actual
|
|
||||||
- Últimos 3 movimientos con detalles
|
|
||||||
|
|
||||||
### 🎯 Objetivos Cumplidos
|
|
||||||
|
|
||||||
- ✅ Lectura de número de tarjeta
|
|
||||||
- ✅ Consulta de saldo
|
|
||||||
- ✅ Visualización de últimos movimientos (NUEVO)
|
|
||||||
- ✅ Interfaz moderna y usable
|
|
||||||
- ✅ Detección automática NFC
|
|
||||||
- ✅ Manejo robusto de errores
|
|
||||||
- ✅ Documentación completa
|
|
||||||
|
|
||||||
### 🔮 Posibles Mejoras Futuras
|
|
||||||
|
|
||||||
- Guardar historial de lecturas en base de datos local
|
|
||||||
- Gráficos de evolución de saldo
|
|
||||||
- Notificaciones de saldo bajo
|
|
||||||
- Múltiples tarjetas en una cuenta
|
|
||||||
- Exportar historial a PDF
|
|
||||||
- Widget de pantalla de inicio
|
|
||||||
- Modo oscuro/claro manual
|
|
||||||
- Soporte para otros sistemas de transporte
|
|
||||||
|
|
||||||
### 📝 Notas Técnicas
|
|
||||||
|
|
||||||
#### Formato de Fechas Calypso
|
|
||||||
Las fechas se almacenan como días transcurridos desde el 01/01/1997 (epoch Calypso).
|
|
||||||
|
|
||||||
#### Formato de Hora
|
|
||||||
Las horas se almacenan como minutos desde medianoche (0-1439).
|
|
||||||
|
|
||||||
#### Tipos de Evento
|
|
||||||
- `1`: Carga de saldo
|
|
||||||
- `2, 3`: Validación en transporte
|
|
||||||
- Otros: Operaciones diversas
|
|
||||||
|
|
||||||
#### Estructura de Registros
|
|
||||||
Cada registro de evento tiene 29 bytes útiles con la siguiente estructura aproximada:
|
|
||||||
- Bytes 0-1: Fecha (días desde epoch)
|
|
||||||
- Bytes 2-3: Hora (minutos desde medianoche)
|
|
||||||
- Byte 4: Tipo de evento
|
|
||||||
- Bytes 5-7: Importe (céntimos, big-endian)
|
|
||||||
- Bytes 8-11: Información adicional
|
|
||||||
- Bytes 10-11: Código de ubicación/línea
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**Desarrollado por**: Pablo Mosteiro
|
|
||||||
**Basado en**: Análisis de código decompilado de iTranvias
|
|
||||||
**Fecha**: Marzo 2026
|
|
||||||
**Versión**: 1.0
|
|
||||||
|
|
||||||
@@ -1,175 +0,0 @@
|
|||||||
# 🔧 Actualización - Debug de Movimientos
|
|
||||||
|
|
||||||
## Problema Reportado
|
|
||||||
Los movimientos no se estaban mostrando en la aplicación, solo el número de tarjeta y el saldo.
|
|
||||||
|
|
||||||
## ✅ Cambios Implementados
|
|
||||||
|
|
||||||
### 1. Mejorado el Manejo de Errores
|
|
||||||
- **Antes**: Los errores al leer movimientos se "tragaban" silenciosamente
|
|
||||||
- **Ahora**: Se capturan y muestran en la UI para debugging
|
|
||||||
|
|
||||||
### 2. Comandos APDU Múltiples
|
|
||||||
He implementado 3 intentos diferentes para leer los registros de eventos:
|
|
||||||
|
|
||||||
```kotlin
|
|
||||||
// Intento 1: SFI 0x08 (file 8)
|
|
||||||
0x80 0x2B [record] 0x45 0x1D
|
|
||||||
|
|
||||||
// Intento 2: SFI 0x07
|
|
||||||
0x80 0x2B [record] 0x3D 0x1D
|
|
||||||
|
|
||||||
// Intento 3: Comando simplificado
|
|
||||||
0x80 0x2B [record] 0x05 0x1D
|
|
||||||
```
|
|
||||||
|
|
||||||
Esto aumenta las posibilidades de éxito con diferentes implementaciones de tarjetas Calypso.
|
|
||||||
|
|
||||||
### 3. Status Words Flexibles
|
|
||||||
Ahora la app reconoce:
|
|
||||||
- `9000` - Éxito
|
|
||||||
- `6A83` - Registro no encontrado (normal si no hay movimientos)
|
|
||||||
- `6A82` - Archivo no encontrado (tarjeta sin historial)
|
|
||||||
|
|
||||||
### 4. UI con Información de Debug
|
|
||||||
|
|
||||||
Ahora verás uno de estos escenarios:
|
|
||||||
|
|
||||||
#### Caso A: Movimientos Encontrados ✅
|
|
||||||
```
|
|
||||||
┌─────────────────────────────┐
|
|
||||||
│ Últimos Movimientos │
|
|
||||||
│ │
|
|
||||||
│ Carga +10.00 € │
|
|
||||||
│ 15/03/2026 14:30 │
|
|
||||||
│ Línea 12 │
|
|
||||||
│ ... │
|
|
||||||
└─────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Caso B: Sin Movimientos (con debug) 🔍
|
|
||||||
```
|
|
||||||
┌─────────────────────────────┐
|
|
||||||
│ Últimos Movimientos │
|
|
||||||
│ │
|
|
||||||
│ No se pudieron leer los │
|
|
||||||
│ movimientos │
|
|
||||||
│ │
|
|
||||||
│ Debug: Registro no │
|
|
||||||
│ encontrado │
|
|
||||||
└─────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🧪 Qué Probar Ahora
|
|
||||||
|
|
||||||
1. **Reinstala la app** con el nuevo APK:
|
|
||||||
```
|
|
||||||
app\build\outputs\apk\debug\app-debug.apk
|
|
||||||
```
|
|
||||||
|
|
||||||
2. **Lee tu tarjeta nuevamente**
|
|
||||||
|
|
||||||
3. **Observa la sección "Últimos Movimientos"**:
|
|
||||||
- Si ves movimientos: ¡Perfecto! ✅
|
|
||||||
- Si ves "No se pudieron leer...": Lee el mensaje de debug
|
|
||||||
|
|
||||||
## 📊 Posibles Resultados
|
|
||||||
|
|
||||||
### Resultado 1: Funciona Ahora ✅
|
|
||||||
Si los movimientos aparecen, significa que uno de los nuevos comandos funcionó.
|
|
||||||
|
|
||||||
### Resultado 2: "Debug: Registro no encontrado" ⚠️
|
|
||||||
**Significado**: La tarjeta no tiene registros de eventos disponibles para leer.
|
|
||||||
|
|
||||||
**Posibles causas**:
|
|
||||||
- La tarjeta es nueva y no tiene movimientos todavía
|
|
||||||
- Los registros de eventos están en un archivo diferente
|
|
||||||
- La tarjeta Millennium usa un formato propietario diferente
|
|
||||||
|
|
||||||
**Solución**: Es normal. Algunas tarjetas no almacenan historial localmente.
|
|
||||||
|
|
||||||
### Resultado 3: Otro mensaje de error 🔍
|
|
||||||
Si ves otro error, por favor compártelo conmigo para investigar más.
|
|
||||||
|
|
||||||
## 🔬 Próximos Pasos según el Resultado
|
|
||||||
|
|
||||||
### Si Funciona:
|
|
||||||
- ✅ Ya está todo listo
|
|
||||||
- Puedes usar la app normalmente
|
|
||||||
- Los movimientos se mostrarán cuando estén disponibles
|
|
||||||
|
|
||||||
### Si No Funciona:
|
|
||||||
Necesitaré más información:
|
|
||||||
|
|
||||||
1. **¿Qué dice el mensaje de debug?**
|
|
||||||
- El texto exacto que aparece en rojo
|
|
||||||
|
|
||||||
2. **¿Es una tarjeta usada o nueva?**
|
|
||||||
- Si es nueva, puede no tener historial
|
|
||||||
|
|
||||||
3. **¿Puedes leer movimientos en la app oficial de iTranvias?**
|
|
||||||
- Esto confirmaría que los datos existen
|
|
||||||
|
|
||||||
## 💡 Información Técnica
|
|
||||||
|
|
||||||
### Por qué pueden faltar los movimientos:
|
|
||||||
|
|
||||||
1. **Formato Propietario**: Algunas ciudades usan extensiones propietarias del formato Calypso
|
|
||||||
|
|
||||||
2. **Archivo Diferente**: Los eventos pueden estar en un SFI (Short File Identifier) diferente
|
|
||||||
|
|
||||||
3. **Sin Historial Local**: Algunas tarjetas no almacenan historial en el chip, solo en servidores
|
|
||||||
|
|
||||||
4. **Encriptación**: Algunos campos pueden estar encriptados y requerir claves específicas
|
|
||||||
|
|
||||||
### Comandos que estamos probando:
|
|
||||||
|
|
||||||
Las tarjetas Calypso usan el comando READ RECORD (`0x2B`) con diferentes parámetros:
|
|
||||||
|
|
||||||
- **P1**: Número de registro (1, 2, 3)
|
|
||||||
- **P2**: SFI × 8 + modo (ej: `0x45` = SFI 8, modo 5)
|
|
||||||
- **Le**: Longitud esperada (`0x1D` = 29 bytes)
|
|
||||||
|
|
||||||
Estamos probando los SFI más comunes:
|
|
||||||
- SFI 7 (típico para eventos de validación)
|
|
||||||
- SFI 8 (típico para log de transacciones)
|
|
||||||
- Modo directo sin SFI
|
|
||||||
|
|
||||||
## 📱 Instalación del APK Actualizado
|
|
||||||
|
|
||||||
El nuevo APK está en:
|
|
||||||
```
|
|
||||||
app\build\outputs\apk\debug\app-debug.apk
|
|
||||||
```
|
|
||||||
|
|
||||||
Para instalar:
|
|
||||||
1. Transfiere el APK a tu teléfono
|
|
||||||
2. Abre el APK y permite la instalación
|
|
||||||
3. Si ya tenías la app instalada, se actualizará automáticamente
|
|
||||||
|
|
||||||
## ✅ Build Exitoso
|
|
||||||
|
|
||||||
```
|
|
||||||
BUILD SUCCESSFUL ✅
|
|
||||||
35 tareas ejecutadas
|
|
||||||
7 cambios aplicados
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🎯 Resumen
|
|
||||||
|
|
||||||
He mejorado significativamente la lectura de movimientos:
|
|
||||||
- ✅ Múltiples comandos APDU (3 intentos)
|
|
||||||
- ✅ Mejor manejo de errores
|
|
||||||
- ✅ Información de debug visible
|
|
||||||
- ✅ Status words más flexibles
|
|
||||||
|
|
||||||
**Próximo paso**: Prueba la app actualizada y cuéntame qué mensaje ves en la sección de movimientos.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**Actualización**: 9 de Marzo, 2026
|
|
||||||
**Versión**: 1.1 (Debug Build)
|
|
||||||
**Estado**: Listo para probar
|
|
||||||
|
|
||||||
Reference in New Issue
Block a user